--- /tmp/grub2-2.04-20hp8a4w0y/debian/grub2-common_2.04-20_amd64.deb +++ grub2-common_2.04-20_amd64.deb ├── file list │ @@ -1,3 +1,3 @@ │ -rw-r--r-- 0 0 0 4 2021-07-10 23:37:36.000000 debian-binary │ --rw-r--r-- 0 0 0 1380 2021-07-10 23:37:36.000000 control.tar.xz │ +-rw-r--r-- 0 0 0 1376 2021-07-10 23:37:36.000000 control.tar.xz │ -rw-r--r-- 0 0 0 595580 2021-07-10 23:37:36.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 2021-07-10 23:37:36.000000 ./usr/share/bug/grub2-common/script │ │ │ drwxr-xr-x 0 root (0) root (0) 0 2021-07-10 23:37:36.000000 ./usr/share/doc/ │ │ │ drwxr-xr-x 0 root (0) root (0) 0 2021-07-10 23:37:36.000000 ./usr/share/grub/ │ │ │ drwxr-xr-x 0 root (0) root (0) 0 2021-07-10 23:37:36.000000 ./usr/share/grub/default/ │ │ │ -rw-r--r-- 0 root (0) root (0) 1176 2021-07-10 23:37:36.000000 ./usr/share/grub/default/grub │ │ │ -rw-r--r-- 0 root (0) root (0) 186 2021-07-10 23:37:36.000000 ./usr/share/grub/default/grub.md5sum │ │ │ drwxr-xr-x 0 root (0) root (0) 0 2021-07-10 23:37:36.000000 ./usr/share/info/ │ │ │ --rw-r--r-- 0 root (0) root (0) 32680 2021-07-10 23:37:36.000000 ./usr/share/info/grub-dev.info.gz │ │ │ --rw-r--r-- 0 root (0) root (0) 87859 2021-07-10 23:37:36.000000 ./usr/share/info/grub.info-1.gz │ │ │ --rw-r--r-- 0 root (0) root (0) 1695 2021-07-10 23:37:36.000000 ./usr/share/info/grub.info-2.gz │ │ │ --rw-r--r-- 0 root (0) root (0) 3361 2021-07-10 23:37:36.000000 ./usr/share/info/grub.info.gz │ │ │ +-rw-r--r-- 0 root (0) root (0) 32676 2021-07-10 23:37:36.000000 ./usr/share/info/grub-dev.info.gz │ │ │ +-rw-r--r-- 0 root (0) root (0) 87860 2021-07-10 23:37:36.000000 ./usr/share/info/grub.info-1.gz │ │ │ +-rw-r--r-- 0 root (0) root (0) 1696 2021-07-10 23:37:36.000000 ./usr/share/info/grub.info-2.gz │ │ │ +-rw-r--r-- 0 root (0) root (0) 3371 2021-07-10 23:37:36.000000 ./usr/share/info/grub.info.gz │ │ │ drwxr-xr-x 0 root (0) root (0) 0 2021-07-10 23:37:36.000000 ./usr/share/man/ │ │ │ drwxr-xr-x 0 root (0) root (0) 0 2021-07-10 23:37:36.000000 ./usr/share/man/man8/ │ │ │ -rw-r--r-- 0 root (0) root (0) 1922 2021-07-10 23:37:36.000000 ./usr/share/man/man8/grub-install.8.gz │ │ │ -rw-r--r-- 0 root (0) root (0) 922 2021-07-10 23:37:36.000000 ./usr/share/man/man8/grub-reboot.8.gz │ │ │ -rw-r--r-- 0 root (0) root (0) 655 2021-07-10 23:37:36.000000 ./usr/share/man/man8/grub-set-default.8.gz │ │ │ -rw-r--r-- 0 root (0) root (0) 248 2021-07-10 23:37:36.000000 ./usr/share/man/man8/update-grub.8.gz │ │ │ lrwxrwxrwx 0 root (0) root (0) 0 2021-07-10 23:37:36.000000 ./usr/sbin/update-grub2 -> update-grub │ │ ├── ./usr/share/info/grub-dev.info.gz │ │ │ ├── grub-dev.info │ │ │ │ @@ -2,6703 +2,6703 @@ │ │ │ │ 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 3720 6672 6f6d 0a67 7275 ion 6.7 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 3034 UB (version 2.04 │ │ │ │ -00000080: 2c20 3130 204a 756c 7920 3230 3231 292e , 10 July 2021). │ │ │ │ -00000090: 0a0a 2020 2043 6f70 7972 6967 6874 2028 .. Copyright ( │ │ │ │ -000000a0: 4329 2031 3939 392c 3230 3030 2c32 3030 C) 1999,2000,200 │ │ │ │ -000000b0: 312c 3230 3032 2c32 3030 342c 3230 3035 1,2002,2004,2005 │ │ │ │ -000000c0: 2c32 3030 362c 3230 3038 2c32 3030 392c ,2006,2008,2009, │ │ │ │ -000000d0: 3230 3130 2c32 3031 310a 4672 6565 2053 2010,2011.Free S │ │ │ │ -000000e0: 6f66 7477 6172 6520 466f 756e 6461 7469 oftware Foundati │ │ │ │ -000000f0: 6f6e 2c20 496e 632e 0a0a 2020 2020 2050 on, Inc... P │ │ │ │ -00000100: 6572 6d69 7373 696f 6e20 6973 2067 7261 ermission is gra │ │ │ │ -00000110: 6e74 6564 2074 6f20 636f 7079 2c20 6469 nted to copy, di │ │ │ │ -00000120: 7374 7269 6275 7465 2061 6e64 2f6f 7220 stribute and/or │ │ │ │ -00000130: 6d6f 6469 6679 2074 6869 730a 2020 2020 modify this. │ │ │ │ -00000140: 2064 6f63 756d 656e 7420 756e 6465 7220 document under │ │ │ │ -00000150: 7468 6520 7465 726d 7320 6f66 2074 6865 the terms of the │ │ │ │ -00000160: 2047 4e55 2046 7265 6520 446f 6375 6d65 GNU Free Docume │ │ │ │ -00000170: 6e74 6174 696f 6e20 4c69 6365 6e73 652c ntation License, │ │ │ │ -00000180: 0a20 2020 2020 5665 7273 696f 6e20 312e . Version 1. │ │ │ │ -00000190: 3220 6f72 2061 6e79 206c 6174 6572 2076 2 or any later v │ │ │ │ -000001a0: 6572 7369 6f6e 2070 7562 6c69 7368 6564 ersion published │ │ │ │ -000001b0: 2062 7920 7468 6520 4672 6565 2053 6f66 by the Free Sof │ │ │ │ -000001c0: 7477 6172 650a 2020 2020 2046 6f75 6e64 tware. Found │ │ │ │ -000001d0: 6174 696f 6e3b 2077 6974 6820 6e6f 2049 ation; with no I │ │ │ │ -000001e0: 6e76 6172 6961 6e74 2053 6563 7469 6f6e nvariant Section │ │ │ │ -000001f0: 732e 0a49 4e46 4f2d 4449 522d 5345 4354 s..INFO-DIR-SECT │ │ │ │ -00000200: 494f 4e20 4b65 726e 656c 0a53 5441 5254 ION Kernel.START │ │ │ │ -00000210: 2d49 4e46 4f2d 4449 522d 454e 5452 590a -INFO-DIR-ENTRY. │ │ │ │ -00000220: 2a20 6772 7562 2d64 6576 3a20 2867 7275 * grub-dev: (gru │ │ │ │ -00000230: 622d 6465 7629 2e20 2020 2020 2020 2020 b-dev). │ │ │ │ -00000240: 2020 2020 2020 2020 5468 6520 4752 616e The GRan │ │ │ │ -00000250: 6420 556e 6966 6965 6420 426f 6f74 6c6f d Unified Bootlo │ │ │ │ -00000260: 6164 6572 2044 6576 0a45 4e44 2d49 4e46 ader Dev.END-INF │ │ │ │ -00000270: 4f2d 4449 522d 454e 5452 590a 0a1f 0a46 O-DIR-ENTRY....F │ │ │ │ -00000280: 696c 653a 2067 7275 622d 6465 762e 696e ile: grub-dev.in │ │ │ │ -00000290: 666f 2c20 204e 6f64 653a 2054 6f70 2c20 fo, Node: Top, │ │ │ │ -000002a0: 204e 6578 743a 2047 6574 7469 6e67 2074 Next: Getting t │ │ │ │ -000002b0: 6865 2073 6f75 7263 6520 636f 6465 2c20 he source code, │ │ │ │ -000002c0: 2055 703a 2028 6469 7229 0a0a 474e 5520 Up: (dir)..GNU │ │ │ │ -000002d0: 4752 5542 2064 6576 656c 6f70 6572 206d GRUB developer m │ │ │ │ -000002e0: 616e 7561 6c0a 2a2a 2a2a 2a2a 2a2a 2a2a anual.********** │ │ │ │ -000002f0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a0a ***************. │ │ │ │ -00000300: 0a54 6869 7320 6973 2074 6865 2064 6576 .This is the dev │ │ │ │ -00000310: 656c 6f70 6572 2064 6f63 756d 656e 7461 eloper documenta │ │ │ │ -00000320: 7469 6f6e 206f 6620 474e 5520 4752 5542 tion of GNU GRUB │ │ │ │ -00000330: 2c20 7468 6520 4752 616e 6420 556e 6966 , the GRand Unif │ │ │ │ -00000340: 6965 640a 426f 6f74 6c6f 6164 6572 2c20 ied.Bootloader, │ │ │ │ -00000350: 6120 666c 6578 6962 6c65 2061 6e64 2070 a flexible and p │ │ │ │ -00000360: 6f77 6572 6675 6c20 626f 6f74 206c 6f61 owerful boot loa │ │ │ │ -00000370: 6465 7220 7072 6f67 7261 6d20 666f 7220 der program for │ │ │ │ -00000380: 6120 7769 6465 2072 616e 6765 0a6f 6620 a wide range.of │ │ │ │ -00000390: 6172 6368 6974 6563 7475 7265 732e 0a0a architectures... │ │ │ │ -000003a0: 2020 2054 6869 7320 6564 6974 696f 6e20 This edition │ │ │ │ -000003b0: 646f 6375 6d65 6e74 7320 7665 7273 696f documents versio │ │ │ │ -000003c0: 6e20 322e 3034 2e0a 0a20 2020 5468 6973 n 2.04... This │ │ │ │ -000003d0: 2064 6576 656c 6f70 6572 206d 616e 7561 developer manua │ │ │ │ -000003e0: 6c20 6973 2066 6f72 2047 4e55 2047 5255 l is for GNU GRU │ │ │ │ -000003f0: 4220 2876 6572 7369 6f6e 2032 2e30 342c B (version 2.04, │ │ │ │ -00000400: 2031 3020 4a75 6c79 2032 3032 3129 2e0a 10 July 2021).. │ │ │ │ -00000410: 0a20 2020 436f 7079 7269 6768 7420 2843 . Copyright (C │ │ │ │ -00000420: 2920 3139 3939 2c32 3030 302c 3230 3031 ) 1999,2000,2001 │ │ │ │ -00000430: 2c32 3030 322c 3230 3034 2c32 3030 352c ,2002,2004,2005, │ │ │ │ -00000440: 3230 3036 2c32 3030 382c 3230 3039 2c32 2006,2008,2009,2 │ │ │ │ -00000450: 3031 302c 3230 3131 0a46 7265 6520 536f 010,2011.Free So │ │ │ │ -00000460: 6674 7761 7265 2046 6f75 6e64 6174 696f ftware Foundatio │ │ │ │ -00000470: 6e2c 2049 6e63 2e0a 0a20 2020 2020 5065 n, Inc... Pe │ │ │ │ -00000480: 726d 6973 7369 6f6e 2069 7320 6772 616e rmission is gran │ │ │ │ -00000490: 7465 6420 746f 2063 6f70 792c 2064 6973 ted to copy, dis │ │ │ │ -000004a0: 7472 6962 7574 6520 616e 642f 6f72 206d tribute and/or m │ │ │ │ -000004b0: 6f64 6966 7920 7468 6973 0a20 2020 2020 odify this. │ │ │ │ -000004c0: 646f 6375 6d65 6e74 2075 6e64 6572 2074 document under t │ │ │ │ -000004d0: 6865 2074 6572 6d73 206f 6620 7468 6520 he terms of the │ │ │ │ -000004e0: 474e 5520 4672 6565 2044 6f63 756d 656e GNU Free Documen │ │ │ │ -000004f0: 7461 7469 6f6e 204c 6963 656e 7365 2c0a tation License,. │ │ │ │ -00000500: 2020 2020 2056 6572 7369 6f6e 2031 2e32 Version 1.2 │ │ │ │ -00000510: 206f 7220 616e 7920 6c61 7465 7220 7665 or any later ve │ │ │ │ -00000520: 7273 696f 6e20 7075 626c 6973 6865 6420 rsion published │ │ │ │ -00000530: 6279 2074 6865 2046 7265 6520 536f 6674 by the Free Soft │ │ │ │ -00000540: 7761 7265 0a20 2020 2020 466f 756e 6461 ware. Founda │ │ │ │ -00000550: 7469 6f6e 3b20 7769 7468 206e 6f20 496e tion; with no In │ │ │ │ -00000560: 7661 7269 616e 7420 5365 6374 696f 6e73 variant Sections │ │ │ │ -00000570: 2e0a 0a2a 204d 656e 753a 0a0a 2a20 4765 ...* Menu:..* Ge │ │ │ │ -00000580: 7474 696e 6720 7468 6520 736f 7572 6365 tting the source │ │ │ │ -00000590: 2063 6f64 653a 3a0a 2a20 436f 6469 6e67 code::.* Coding │ │ │ │ -000005a0: 2073 7479 6c65 3a3a 0a2a 2046 696e 6469 style::.* Findi │ │ │ │ -000005b0: 6e67 2079 6f75 7220 7761 7920 6172 6f75 ng your way arou │ │ │ │ -000005c0: 6e64 3a3a 0a2a 2043 6f6e 7472 6962 7574 nd::.* Contribut │ │ │ │ -000005d0: 696e 6720 4368 616e 6765 733a 3a0a 2a20 ing Changes::.* │ │ │ │ -000005e0: 5570 6461 7469 6e67 2045 7874 6572 6e61 Updating Externa │ │ │ │ -000005f0: 6c20 436f 6465 3a3a 0a2a 2050 6f72 7469 l Code::.* Porti │ │ │ │ -00000600: 6e67 3a3a 0a2a 2045 7272 6f72 2048 616e ng::.* Error Han │ │ │ │ -00000610: 646c 696e 673a 3a0a 2a20 5374 6163 6b20 dling::.* Stack │ │ │ │ -00000620: 616e 6420 6865 6170 2073 697a 653a 3a0a and heap size::. │ │ │ │ -00000630: 2a20 4249 4f53 2070 6f72 7420 6d65 6d6f * BIOS port memo │ │ │ │ -00000640: 7279 206d 6170 3a3a 0a2a 2056 6964 656f ry map::.* Video │ │ │ │ -00000650: 2053 7562 7379 7374 656d 3a3a 0a2a 2050 Subsystem::.* P │ │ │ │ -00000660: 4646 3220 466f 6e74 2046 696c 6520 466f FF2 Font File Fo │ │ │ │ -00000670: 726d 6174 3a3a 0a2a 2047 7261 7068 6963 rmat::.* Graphic │ │ │ │ -00000680: 616c 204d 656e 7520 536f 6674 7761 7265 al Menu Software │ │ │ │ -00000690: 2044 6573 6967 6e3a 3a0a 2a20 5665 7269 Design::.* Veri │ │ │ │ -000006a0: 6669 6572 7320 6672 616d 6577 6f72 6b3a fiers framework: │ │ │ │ -000006b0: 3a0a 2a20 4c6f 636b 646f 776e 2066 7261 :.* Lockdown fra │ │ │ │ -000006c0: 6d65 776f 726b 3a3a 0a2a 2043 6f70 7969 mework::.* Copyi │ │ │ │ -000006d0: 6e67 2054 6869 7320 4d61 6e75 616c 3a3a ng This Manual:: │ │ │ │ -000006e0: 2020 2020 2020 2020 2043 6f70 7969 6e67 Copying │ │ │ │ -000006f0: 2054 6869 7320 4d61 6e75 616c 0a2a 2049 This Manual.* I │ │ │ │ -00000700: 6e64 6578 3a3a 0a0a 1f0a 4669 6c65 3a20 ndex::....File: │ │ │ │ -00000710: 6772 7562 2d64 6576 2e69 6e66 6f2c 2020 grub-dev.info, │ │ │ │ -00000720: 4e6f 6465 3a20 4765 7474 696e 6720 7468 Node: Getting th │ │ │ │ -00000730: 6520 736f 7572 6365 2063 6f64 652c 2020 e source code, │ │ │ │ -00000740: 4e65 7874 3a20 436f 6469 6e67 2073 7479 Next: Coding sty │ │ │ │ -00000750: 6c65 2c20 2050 7265 763a 2054 6f70 2c20 le, Prev: Top, │ │ │ │ -00000760: 2055 703a 2054 6f70 0a0a 3120 4765 7474 Up: Top..1 Gett │ │ │ │ -00000770: 696e 6720 7468 6520 736f 7572 6365 2063 ing the source c │ │ │ │ -00000780: 6f64 650a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a ode.************ │ │ │ │ -00000790: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a0a 0a47 *************..G │ │ │ │ -000007a0: 5255 4220 6973 206d 6169 6e74 6169 6e65 RUB is maintaine │ │ │ │ -000007b0: 6420 7573 696e 6720 7468 6520 3c47 4954 d using the . To f │ │ │ │ -000007e0: 6574 6368 3a0a 0a20 2020 2020 6769 7420 etch:.. git │ │ │ │ -000007f0: 636c 6f6e 6520 6769 743a 2f2f 6769 742e clone git://git. │ │ │ │ -00000800: 7376 2e67 6e75 2e6f 7267 2f67 7275 622e sv.gnu.org/grub. │ │ │ │ -00000810: 6769 740a 0a20 2020 5765 6220 6163 6365 git.. Web acce │ │ │ │ -00000820: 7373 2069 7320 6176 6169 6c61 626c 6520 ss is available │ │ │ │ -00000830: 756e 6465 720a 2020 2020 2068 7474 703a under. http: │ │ │ │ -00000840: 2f2f 6769 742e 7361 7661 6e6e 6168 2e67 //git.savannah.g │ │ │ │ -00000850: 6e75 2e6f 7267 2f63 6769 742f 6772 7562 nu.org/cgit/grub │ │ │ │ -00000860: 2e67 6974 2f0a 0a20 2020 5468 6520 6272 .git/.. The br │ │ │ │ -00000870: 616e 6368 6573 2061 7661 696c 6162 6c65 anches available │ │ │ │ -00000880: 2061 7265 3a0a 0a27 6d61 7374 6572 270a are:..'master'. │ │ │ │ -00000890: 2020 2020 204d 6169 6e20 6465 7665 6c6f Main develo │ │ │ │ -000008a0: 706d 656e 7420 6272 616e 6368 2e0a 2767 pment branch..'g │ │ │ │ -000008b0: 7275 622d 6c65 6761 6379 270a 2020 2020 rub-legacy'. │ │ │ │ -000008c0: 2047 5255 4220 302e 3937 2063 6f64 6562 GRUB 0.97 codeb │ │ │ │ -000008d0: 6173 652e 2020 4b65 7074 2066 6f72 2072 ase. Kept for r │ │ │ │ -000008e0: 6566 6572 656e 6365 2061 6e64 206c 6567 eference and leg │ │ │ │ -000008f0: 616c 2072 6561 736f 6e73 0a27 6d75 6c74 al reasons.'mult │ │ │ │ -00000900: 6962 6f6f 7427 0a20 2020 2020 4d75 6c74 iboot'. Mult │ │ │ │ -00000910: 6962 6f6f 7420 7370 6563 6669 6361 7469 iboot specficati │ │ │ │ -00000920: 6f6e 0a27 6d75 6c74 6962 6f6f 7432 270a on.'multiboot2'. │ │ │ │ -00000930: 2020 2020 204d 756c 7469 626f 6f74 3220 Multiboot2 │ │ │ │ -00000940: 7370 6563 6669 6361 7469 6f6e 0a27 6465 specfication.'de │ │ │ │ -00000950: 7665 6c6f 7065 7220 6272 616e 6368 6573 veloper branches │ │ │ │ -00000960: 270a 2020 2020 2050 7265 6669 7865 6420 '. Prefixed │ │ │ │ -00000970: 7769 7468 2064 6576 656c 6f70 6572 206e with developer n │ │ │ │ -00000980: 616d 652e 2020 4576 6572 7920 6465 7665 ame. Every deve │ │ │ │ -00000990: 6c6f 7065 7220 6f66 2061 2074 6561 6d20 loper of a team │ │ │ │ -000009a0: 6d61 6e61 6765 730a 2020 2020 2068 6973 manages. his │ │ │ │ -000009b0: 206f 776e 2062 7261 6e63 6865 732e 2020 own branches. │ │ │ │ -000009c0: 4465 7665 6c6f 7065 7220 6272 616e 6368 Developer branch │ │ │ │ -000009d0: 6573 2064 6f20 6e6f 7420 6e65 6564 2063 es do not need c │ │ │ │ -000009e0: 6861 6e67 656c 6f67 0a20 2020 2020 656e hangelog. en │ │ │ │ -000009f0: 7472 6965 732e 0a0a 2020 204f 6e63 6520 tries... Once │ │ │ │ -00000a00: 796f 7520 6861 7665 2075 7365 6420 2767 you have used 'g │ │ │ │ -00000a10: 6974 2063 6c6f 6e65 2720 746f 2066 6574 it clone' to fet │ │ │ │ -00000a20: 6368 2061 6e20 696e 6974 6961 6c20 636f ch an initial co │ │ │ │ -00000a30: 7079 206f 6620 6120 6272 616e 6368 2c0a py of a branch,. │ │ │ │ -00000a40: 796f 7520 6361 6e20 7573 6520 2767 6974 you can use 'git │ │ │ │ -00000a50: 2070 756c 6c27 2074 6f20 6b65 6570 2069 pull' to keep i │ │ │ │ -00000a60: 7420 7570 2074 6f20 6461 7465 2e20 2049 t up to date. I │ │ │ │ -00000a70: 6620 796f 7520 6861 7665 206d 6f64 6966 f you have modif │ │ │ │ -00000a80: 6965 6420 796f 7572 0a6c 6f63 616c 2076 ied your.local v │ │ │ │ -00000a90: 6572 7369 6f6e 2c20 796f 7520 6d61 7920 ersion, you may │ │ │ │ -00000aa0: 6e65 6564 2074 6f20 7265 736f 6c76 6520 need to resolve │ │ │ │ -00000ab0: 636f 6e66 6c69 6374 7320 7768 656e 2070 conflicts when p │ │ │ │ -00000ac0: 756c 6c69 6e67 2e0a 0a1f 0a46 696c 653a ulling.....File: │ │ │ │ -00000ad0: 2067 7275 622d 6465 762e 696e 666f 2c20 grub-dev.info, │ │ │ │ -00000ae0: 204e 6f64 653a 2043 6f64 696e 6720 7374 Node: Coding st │ │ │ │ -00000af0: 796c 652c 2020 4e65 7874 3a20 4669 6e64 yle, Next: Find │ │ │ │ -00000b00: 696e 6720 796f 7572 2077 6179 2061 726f ing your way aro │ │ │ │ -00000b10: 756e 642c 2020 5072 6576 3a20 4765 7474 und, Prev: Gett │ │ │ │ -00000b20: 696e 6720 7468 6520 736f 7572 6365 2063 ing the source c │ │ │ │ -00000b30: 6f64 652c 2020 5570 3a20 546f 700a 0a32 ode, Up: Top..2 │ │ │ │ -00000b40: 2043 6f64 696e 6720 7374 796c 650a 2a2a Coding style.** │ │ │ │ -00000b50: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 0a0a 4261 ************..Ba │ │ │ │ -00000b60: 7369 6361 6c6c 7920 7765 2066 6f6c 6c6f sically we follo │ │ │ │ -00000b70: 7720 7468 6520 474e 5520 436f 6469 6e67 w the GNU Coding │ │ │ │ -00000b80: 2053 7461 6e64 6172 6473 0a28 6874 7470 Standards.(http │ │ │ │ -00000b90: 3a2f 2f77 7777 2e67 6e75 2e6f 7267 2f70 ://www.gnu.org/p │ │ │ │ -00000ba0: 7265 702f 7374 616e 6461 7264 735f 746f rep/standards_to │ │ │ │ -00000bb0: 632e 6874 6d6c 292e 2020 5765 2064 6566 c.html). We def │ │ │ │ -00000bc0: 696e 6520 6164 6469 7469 6f6e 616c 0a63 ine additional.c │ │ │ │ -00000bd0: 6f6e 7665 6e74 696f 6e73 2066 6f72 2047 onventions for G │ │ │ │ -00000be0: 5255 4220 6865 7265 2e0a 0a2a 204d 656e RUB here...* Men │ │ │ │ -00000bf0: 753a 0a0a 2a20 4e61 6d69 6e67 2043 6f6e u:..* Naming Con │ │ │ │ -00000c00: 7665 6e74 696f 6e73 3a3a 0a2a 2046 756e ventions::.* Fun │ │ │ │ -00000c10: 6374 696f 6e73 3a3a 0a2a 2056 6172 6961 ctions::.* Varia │ │ │ │ -00000c20: 626c 6573 3a3a 0a2a 2054 7970 6573 3a3a bles::.* Types:: │ │ │ │ -00000c30: 0a2a 204d 6163 726f 733a 3a0a 2a20 436f .* Macros::.* Co │ │ │ │ -00000c40: 6d6d 656e 7473 3a3a 0a2a 204d 756c 7469 mments::.* Multi │ │ │ │ -00000c50: 2d4c 696e 6520 436f 6d6d 656e 7473 3a3a -Line Comments:: │ │ │ │ -00000c60: 0a0a 1f0a 4669 6c65 3a20 6772 7562 2d64 ....File: grub-d │ │ │ │ -00000c70: 6576 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ev.info, Node: │ │ │ │ -00000c80: 4e61 6d69 6e67 2043 6f6e 7665 6e74 696f Naming Conventio │ │ │ │ -00000c90: 6e73 2c20 204e 6578 743a 2046 756e 6374 ns, Next: Funct │ │ │ │ -00000ca0: 696f 6e73 2c20 2055 703a 2043 6f64 696e ions, Up: Codin │ │ │ │ -00000cb0: 6720 7374 796c 650a 0a32 2e31 204e 616d g style..2.1 Nam │ │ │ │ -00000cc0: 696e 6720 436f 6e76 656e 7469 6f6e 730a ing Conventions. │ │ │ │ -00000cd0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ -00000ce0: 3d3d 3d3d 3d3d 0a0a 416c 6c20 676c 6f62 ======..All glob │ │ │ │ -00000cf0: 616c 2073 796d 626f 6c73 2028 692e 652e al symbols (i.e. │ │ │ │ -00000d00: 2020 6675 6e63 7469 6f6e 732c 2076 6172 functions, var │ │ │ │ -00000d10: 6961 626c 6573 2c20 7479 7065 732c 2061 iables, types, a │ │ │ │ -00000d20: 6e64 206d 6163 726f 7329 206d 7573 740a nd macros) must. │ │ │ │ -00000d30: 6861 7665 2074 6865 2070 7265 6669 7820 have the prefix │ │ │ │ -00000d40: 6772 7562 5f20 6f72 2047 5255 425f 2e20 grub_ or GRUB_. │ │ │ │ -00000d50: 2054 6865 2061 6c6c 2063 6170 6974 616c The all capital │ │ │ │ -00000d60: 2066 6f72 6d20 6973 2075 7365 6420 6f6e form is used on │ │ │ │ -00000d70: 6c79 2062 790a 6d61 6372 6f73 2e0a 0a1f ly by.macros.... │ │ │ │ -00000d80: 0a46 696c 653a 2067 7275 622d 6465 762e .File: grub-dev. │ │ │ │ -00000d90: 696e 666f 2c20 204e 6f64 653a 2046 756e info, Node: Fun │ │ │ │ -00000da0: 6374 696f 6e73 2c20 204e 6578 743a 2056 ctions, Next: V │ │ │ │ -00000db0: 6172 6961 626c 6573 2c20 2050 7265 763a ariables, Prev: │ │ │ │ -00000dc0: 204e 616d 696e 6720 436f 6e76 656e 7469 Naming Conventi │ │ │ │ -00000dd0: 6f6e 732c 2020 5570 3a20 436f 6469 6e67 ons, Up: Coding │ │ │ │ -00000de0: 2073 7479 6c65 0a0a 322e 3220 4675 6e63 style..2.2 Func │ │ │ │ -00000df0: 7469 6f6e 730a 3d3d 3d3d 3d3d 3d3d 3d3d tions.========== │ │ │ │ -00000e00: 3d3d 3d0a 0a49 6620 6120 6675 6e63 7469 ===..If a functi │ │ │ │ -00000e10: 6f6e 2069 7320 676c 6f62 616c 2c20 6974 on is global, it │ │ │ │ -00000e20: 7320 6e61 6d65 206d 7573 7420 6265 2070 s name must be p │ │ │ │ -00000e30: 7265 6669 7865 6420 7769 7468 2067 7275 refixed with gru │ │ │ │ -00000e40: 625f 2061 6e64 206d 7573 740a 636f 6e73 b_ and must.cons │ │ │ │ -00000e50: 6973 7420 6f66 206f 6e6c 7920 736d 616c ist of only smal │ │ │ │ -00000e60: 6c20 6c65 7474 6572 732e 2020 4966 2074 l letters. If t │ │ │ │ -00000e70: 6865 2066 756e 6374 696f 6e20 6265 6c6f he function belo │ │ │ │ -00000e80: 6e67 7320 746f 2061 2073 7065 6369 6669 ngs to a specifi │ │ │ │ -00000e90: 630a 6675 6e63 7469 6f6e 206d 6f64 756c c.function modul │ │ │ │ -00000ea0: 652c 2074 6865 206e 616d 6520 6d75 7374 e, the name must │ │ │ │ -00000eb0: 2061 6c73 6f20 6265 2070 7265 6669 7865 also be prefixe │ │ │ │ -00000ec0: 6420 7769 7468 2074 6865 206d 6f64 756c d with the modul │ │ │ │ -00000ed0: 6520 6e61 6d65 2e0a 466f 7220 6578 616d e name..For exam │ │ │ │ -00000ee0: 706c 652c 2069 6620 6120 6675 6e63 7469 ple, if a functi │ │ │ │ -00000ef0: 6f6e 2069 7320 666f 7220 6669 6c65 2073 on is for file s │ │ │ │ -00000f00: 7973 7465 6d73 2c20 6974 7320 6e61 6d65 ystems, its name │ │ │ │ -00000f10: 2069 7320 7072 6566 6978 6564 0a77 6974 is prefixed.wit │ │ │ │ -00000f20: 6820 6772 7562 5f66 735f 2e20 2049 6620 h grub_fs_. If │ │ │ │ -00000f30: 6120 6675 6e63 7469 6f6e 2069 7320 666f a function is fo │ │ │ │ -00000f40: 7220 4641 5420 6669 6c65 2073 7973 7465 r FAT file syste │ │ │ │ -00000f50: 6d20 6275 7420 6e6f 7420 666f 7220 616c m but not for al │ │ │ │ -00000f60: 6c0a 6669 6c65 2073 7973 7465 6d73 2c20 l.file systems, │ │ │ │ -00000f70: 6974 7320 6e61 6d65 2069 7320 7072 6566 its name is pref │ │ │ │ -00000f80: 6978 6564 2077 6974 6820 6772 7562 5f66 ixed with grub_f │ │ │ │ -00000f90: 735f 6661 745f 2e20 2054 6865 2068 6965 s_fat_. The hie │ │ │ │ -00000fa0: 7261 7263 6879 2069 730a 6e6f 7465 6420 rarchy is.noted │ │ │ │ -00000fb0: 7468 6973 2077 6179 2e0a 0a20 2020 4166 this way... Af │ │ │ │ -00000fc0: 7465 7220 6120 7072 6566 6978 2c20 6120 ter a prefix, a │ │ │ │ -00000fd0: 6675 6e63 7469 6f6e 206e 616d 6520 6d75 function name mu │ │ │ │ -00000fe0: 7374 2073 7461 7274 2077 6974 6820 6120 st start with a │ │ │ │ -00000ff0: 7665 7262 2028 7375 6368 2061 7320 6765 verb (such as ge │ │ │ │ -00001000: 740a 6f72 2069 7329 2e20 2049 7420 6d75 t.or is). It mu │ │ │ │ -00001010: 7374 206e 6f74 2062 6520 6120 6e6f 756e st not be a noun │ │ │ │ -00001020: 2e20 2053 6f6d 6520 6b69 6e64 206f 6620 . Some kind of │ │ │ │ -00001030: 6162 6272 6576 6961 7469 6f6e 2069 7320 abbreviation is │ │ │ │ -00001040: 7065 726d 6974 7465 642c 0a61 7320 6c6f permitted,.as lo │ │ │ │ -00001050: 6e67 2061 7320 6974 2077 6f75 6c64 6e27 ng as it wouldn' │ │ │ │ -00001060: 7420 6d61 6b65 2063 6f64 6520 6c65 7373 t make code less │ │ │ │ -00001070: 2072 6561 6461 626c 6520 2865 2e67 2e20 readable (e.g. │ │ │ │ -00001080: 2069 6e69 7429 2e0a 0a20 2020 4966 2061 init)... If a │ │ │ │ -00001090: 2066 756e 6374 696f 6e20 6973 206c 6f63 function is loc │ │ │ │ -000010a0: 616c 2c20 6974 7320 6e61 6d65 206d 6179 al, its name may │ │ │ │ -000010b0: 206e 6f74 2073 7461 7274 2077 6974 6820 not start with │ │ │ │ -000010c0: 616e 7920 7072 6566 6978 2e20 2049 740a any prefix. It. │ │ │ │ -000010d0: 6d75 7374 2073 7461 7274 2077 6974 6820 must start with │ │ │ │ -000010e0: 6120 7665 7262 2e0a 0a1f 0a46 696c 653a a verb.....File: │ │ │ │ -000010f0: 2067 7275 622d 6465 762e 696e 666f 2c20 grub-dev.info, │ │ │ │ -00001100: 204e 6f64 653a 2056 6172 6961 626c 6573 Node: Variables │ │ │ │ -00001110: 2c20 204e 6578 743a 2054 7970 6573 2c20 , Next: Types, │ │ │ │ -00001120: 2050 7265 763a 2046 756e 6374 696f 6e73 Prev: Functions │ │ │ │ -00001130: 2c20 2055 703a 2043 6f64 696e 6720 7374 , Up: Coding st │ │ │ │ -00001140: 796c 650a 0a32 2e33 2056 6172 6961 626c yle..2.3 Variabl │ │ │ │ -00001150: 6573 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d es.============= │ │ │ │ -00001160: 0a0a 5468 6520 7275 6c65 2069 7320 6d6f ..The rule is mo │ │ │ │ -00001170: 7374 6c79 2074 6865 2073 616d 6520 6173 stly the same as │ │ │ │ -00001180: 2066 756e 6374 696f 6e73 2c20 6173 206e functions, as n │ │ │ │ -00001190: 6f74 6564 2061 626f 7665 2e20 2049 6620 oted above. If │ │ │ │ -000011a0: 6120 7661 7269 6162 6c65 0a69 7320 676c a variable.is gl │ │ │ │ -000011b0: 6f62 616c 2c20 6974 7320 6e61 6d65 206d obal, its name m │ │ │ │ -000011c0: 7573 7420 6265 2070 7265 6669 7865 6420 ust be prefixed │ │ │ │ -000011d0: 7769 7468 2067 7275 625f 2061 6e64 206d with grub_ and m │ │ │ │ -000011e0: 7573 7420 636f 6e73 6973 7420 6f66 206f ust consist of o │ │ │ │ -000011f0: 6e6c 790a 736d 616c 6c20 6c65 7474 6572 nly.small letter │ │ │ │ -00001200: 732e 2020 4966 2074 6865 2076 6172 6961 s. If the varia │ │ │ │ -00001210: 626c 6520 6265 6c6f 6e67 7320 746f 2061 ble belongs to a │ │ │ │ -00001220: 2073 7065 6369 6669 6320 6675 6e63 7469 specific functi │ │ │ │ -00001230: 6f6e 206d 6f64 756c 652c 0a74 6865 206e on module,.the n │ │ │ │ -00001240: 616d 6520 6d75 7374 2061 6c73 6f20 6265 ame must also be │ │ │ │ -00001250: 2070 7265 6669 7865 6420 7769 7468 2074 prefixed with t │ │ │ │ -00001260: 6865 206d 6f64 756c 6520 6e61 6d65 2e20 he module name. │ │ │ │ -00001270: 2046 6f72 2065 7861 6d70 6c65 2c20 6966 For example, if │ │ │ │ -00001280: 2061 0a66 756e 6374 696f 6e20 6973 2066 a.function is f │ │ │ │ -00001290: 6f72 2064 796e 616d 6963 206c 6f61 6469 or dynamic loadi │ │ │ │ -000012a0: 6e67 2c20 6974 7320 6e61 6d65 2069 7320 ng, its name is │ │ │ │ -000012b0: 7072 6566 6978 6564 2077 6974 6820 6772 prefixed with gr │ │ │ │ -000012c0: 7562 5f64 6c5f 2e20 2049 660a 6120 7661 ub_dl_. If.a va │ │ │ │ -000012d0: 7269 6162 6c65 2069 7320 666f 7220 454c riable is for EL │ │ │ │ -000012e0: 4620 6275 7420 6e6f 7420 666f 7220 616c F but not for al │ │ │ │ -000012f0: 6c20 6479 6e61 6d69 6320 6c6f 6164 696e l dynamic loadin │ │ │ │ -00001300: 6720 7379 7374 656d 732c 2069 7473 206e g systems, its n │ │ │ │ -00001310: 616d 650a 6973 2070 7265 6669 7865 6420 ame.is prefixed │ │ │ │ -00001320: 7769 7468 2067 7275 625f 646c 5f65 6c66 with grub_dl_elf │ │ │ │ -00001330: 5f2e 0a0a 2020 2041 6674 6572 2061 2070 _... After a p │ │ │ │ -00001340: 7265 6669 782c 2061 2076 6172 6961 626c refix, a variabl │ │ │ │ -00001350: 6520 6e61 6d65 206d 7573 7420 7374 6172 e name must star │ │ │ │ -00001360: 7420 7769 7468 2061 206e 6f75 6e20 6f72 t with a noun or │ │ │ │ -00001370: 2061 6e0a 6164 6a65 6374 6976 6520 2873 an.adjective (s │ │ │ │ -00001380: 7563 6820 6173 206e 616d 6520 6f72 206c uch as name or l │ │ │ │ -00001390: 6f6e 6729 2061 6e64 2069 7420 7368 6f75 ong) and it shou │ │ │ │ -000013a0: 6c64 2065 6e64 2077 6974 6820 6120 6e6f ld end with a no │ │ │ │ -000013b0: 756e 2e20 2053 6f6d 650a 6b69 6e64 206f un. Some.kind o │ │ │ │ -000013c0: 6620 6162 6272 6576 6961 7469 6f6e 2069 f abbreviation i │ │ │ │ -000013d0: 7320 7065 726d 6974 7465 642c 2061 7320 s permitted, as │ │ │ │ -000013e0: 6c6f 6e67 2061 7320 6974 2077 6f75 6c64 long as it would │ │ │ │ -000013f0: 6e27 7420 6d61 6b65 2063 6f64 6520 6c65 n't make code le │ │ │ │ -00001400: 7373 0a72 6561 6461 626c 6520 2865 2e67 ss.readable (e.g │ │ │ │ -00001410: 2e20 2069 3138 6e29 2e0a 0a20 2020 4966 . i18n)... If │ │ │ │ -00001420: 2061 2076 6172 6961 626c 6520 6973 2067 a variable is g │ │ │ │ -00001430: 6c6f 6261 6c20 696e 2074 6865 2073 636f lobal in the sco │ │ │ │ -00001440: 7065 206f 6620 6120 7369 6e67 6c65 2066 pe of a single f │ │ │ │ -00001450: 696c 6520 2869 2e65 2e20 2069 7420 6973 ile (i.e. it is │ │ │ │ -00001460: 0a64 6563 6c61 7265 6420 7769 7468 2073 .declared with s │ │ │ │ -00001470: 7461 7469 6329 2c20 6974 7320 6e61 6d65 tatic), its name │ │ │ │ -00001480: 206d 6179 206e 6f74 2073 7461 7274 2077 may not start w │ │ │ │ -00001490: 6974 6820 616e 7920 7072 6566 6978 2e20 ith any prefix. │ │ │ │ -000014a0: 2049 7420 6d75 7374 0a73 7461 7274 2077 It must.start w │ │ │ │ -000014b0: 6974 6820 6120 6e6f 756e 206f 7220 616e ith a noun or an │ │ │ │ -000014c0: 2061 646a 6563 7469 7665 2e0a 0a20 2020 adjective... │ │ │ │ -000014d0: 4966 2061 2076 6172 6961 626c 6520 6973 If a variable is │ │ │ │ -000014e0: 206c 6f63 616c 2c20 796f 7520 6d61 7920 local, you may │ │ │ │ -000014f0: 6368 6f6f 7365 2061 6e79 2073 686f 7274 choose any short │ │ │ │ -00001500: 6572 206e 616d 652c 2061 7320 6c6f 6e67 er name, as long │ │ │ │ -00001510: 2061 730a 6974 2077 6f75 6c64 6e27 7420 as.it wouldn't │ │ │ │ -00001520: 6d61 6b65 2063 6f64 6520 6c65 7373 2072 make code less r │ │ │ │ -00001530: 6561 6461 626c 6520 2865 2e67 2e20 2069 eadable (e.g. i │ │ │ │ -00001540: 292e 0a0a 1f0a 4669 6c65 3a20 6772 7562 ).....File: grub │ │ │ │ -00001550: 2d64 6576 2e69 6e66 6f2c 2020 4e6f 6465 -dev.info, Node │ │ │ │ -00001560: 3a20 5479 7065 732c 2020 4e65 7874 3a20 : Types, Next: │ │ │ │ -00001570: 4d61 6372 6f73 2c20 2050 7265 763a 2056 Macros, Prev: V │ │ │ │ -00001580: 6172 6961 626c 6573 2c20 2055 703a 2043 ariables, Up: C │ │ │ │ -00001590: 6f64 696e 6720 7374 796c 650a 0a32 2e34 oding style..2.4 │ │ │ │ -000015a0: 2054 7970 6573 0a3d 3d3d 3d3d 3d3d 3d3d Types.========= │ │ │ │ -000015b0: 0a0a 5468 6520 6e61 6d65 206f 6620 6120 ..The name of a │ │ │ │ -000015c0: 7479 7065 206d 7573 7420 6265 2070 7265 type must be pre │ │ │ │ -000015d0: 6669 7865 6420 7769 7468 2067 7275 625f fixed with grub_ │ │ │ │ -000015e0: 2061 6e64 206d 7573 7420 636f 6e73 6973 and must consis │ │ │ │ -000015f0: 7420 6f66 206f 6e6c 790a 736d 616c 6c20 t of only.small │ │ │ │ -00001600: 6c65 7474 6572 732e 2020 4966 2074 6865 letters. If the │ │ │ │ -00001610: 2074 7970 6520 6265 6c6f 6e67 7320 746f type belongs to │ │ │ │ -00001620: 2061 2073 7065 6369 6669 6320 6675 6e63 a specific func │ │ │ │ -00001630: 7469 6f6e 206d 6f64 756c 652c 2074 6865 tion module, the │ │ │ │ -00001640: 0a6e 616d 6520 6d75 7374 2061 6c73 6f20 .name must also │ │ │ │ -00001650: 6265 2070 7265 6669 7865 6420 7769 7468 be prefixed with │ │ │ │ -00001660: 2074 6865 206d 6f64 756c 6520 6e61 6d65 the module name │ │ │ │ -00001670: 2e20 2046 6f72 2065 7861 6d70 6c65 2c20 . For example, │ │ │ │ -00001680: 6966 2061 2074 7970 650a 6973 2066 6f72 if a type.is for │ │ │ │ -00001690: 204f 5320 6c6f 6164 6572 732c 2069 7473 OS loaders, its │ │ │ │ -000016a0: 206e 616d 6520 6973 2070 7265 6669 7865 name is prefixe │ │ │ │ -000016b0: 6420 7769 7468 2067 7275 625f 6c6f 6164 d with grub_load │ │ │ │ -000016c0: 6572 5f2e 2020 4966 2061 2074 7970 6520 er_. If a type │ │ │ │ -000016d0: 6973 0a66 6f72 204d 756c 7469 626f 6f74 is.for Multiboot │ │ │ │ -000016e0: 2062 7574 206e 6f74 2066 6f72 2061 6c6c but not for all │ │ │ │ -000016f0: 204f 5320 6c6f 6164 6572 732c 2069 7473 OS loaders, its │ │ │ │ -00001700: 206e 616d 6520 6973 2070 7265 6669 7865 name is prefixe │ │ │ │ -00001710: 6420 7769 7468 0a67 7275 625f 6c6f 6164 d with.grub_load │ │ │ │ -00001720: 6572 5f6c 696e 7578 5f2e 0a0a 2020 2054 er_linux_... T │ │ │ │ -00001730: 6865 206e 616d 6520 6d75 7374 2062 6520 he name must be │ │ │ │ -00001740: 7375 6666 6978 6564 2077 6974 6820 5f74 suffixed with _t │ │ │ │ -00001750: 2c20 746f 2065 6d70 6861 7369 7a65 2074 , to emphasize t │ │ │ │ -00001760: 6865 2066 6163 7420 7468 6174 2069 7420 he fact that it │ │ │ │ -00001770: 6973 2061 0a74 7970 6520 6275 7420 6e6f is a.type but no │ │ │ │ -00001780: 7420 6120 7661 7269 6162 6c65 206f 7220 t a variable or │ │ │ │ -00001790: 6120 6675 6e63 7469 6f6e 2e0a 0a1f 0a46 a function.....F │ │ │ │ -000017a0: 696c 653a 2067 7275 622d 6465 762e 696e ile: grub-dev.in │ │ │ │ -000017b0: 666f 2c20 204e 6f64 653a 204d 6163 726f fo, Node: Macro │ │ │ │ -000017c0: 732c 2020 4e65 7874 3a20 436f 6d6d 656e s, Next: Commen │ │ │ │ -000017d0: 7473 2c20 2050 7265 763a 2054 7970 6573 ts, Prev: Types │ │ │ │ -000017e0: 2c20 2055 703a 2043 6f64 696e 6720 7374 , Up: Coding st │ │ │ │ -000017f0: 796c 650a 0a32 2e35 204d 6163 726f 730a yle..2.5 Macros. │ │ │ │ -00001800: 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a 4966 2061 ==========..If a │ │ │ │ -00001810: 206d 6163 726f 2069 7320 676c 6f62 616c macro is global │ │ │ │ -00001820: 2c20 6974 7320 6e61 6d65 206d 7573 7420 , its name must │ │ │ │ -00001830: 6265 2070 7265 6669 7865 6420 7769 7468 be prefixed with │ │ │ │ -00001840: 2047 5255 425f 2061 6e64 206d 7573 740a GRUB_ and must. │ │ │ │ -00001850: 636f 6e73 6973 7420 6f66 206f 6e6c 7920 consist of only │ │ │ │ -00001860: 6c61 7267 6520 6c65 7474 6572 732e 2020 large letters. │ │ │ │ -00001870: 4f74 6865 7220 7275 6c65 7320 6172 6520 Other rules are │ │ │ │ -00001880: 7468 6520 7361 6d65 2061 7320 6675 6e63 the same as func │ │ │ │ -00001890: 7469 6f6e 7320 6f72 0a76 6172 6961 626c tions or.variabl │ │ │ │ -000018a0: 6573 2c20 6465 7065 6e64 696e 6720 6f6e es, depending on │ │ │ │ -000018b0: 2077 6865 7468 6572 2061 206d 6163 726f whether a macro │ │ │ │ -000018c0: 2069 7320 7573 6564 206c 696b 6520 6120 is used like a │ │ │ │ -000018d0: 6675 6e63 7469 6f6e 206f 7220 610a 7661 function or a.va │ │ │ │ -000018e0: 7269 6162 6c65 2e0a 0a1f 0a46 696c 653a riable.....File: │ │ │ │ -000018f0: 2067 7275 622d 6465 762e 696e 666f 2c20 grub-dev.info, │ │ │ │ -00001900: 204e 6f64 653a 2043 6f6d 6d65 6e74 732c Node: Comments, │ │ │ │ -00001910: 2020 4e65 7874 3a20 4d75 6c74 692d 4c69 Next: Multi-Li │ │ │ │ -00001920: 6e65 2043 6f6d 6d65 6e74 732c 2020 5072 ne Comments, Pr │ │ │ │ -00001930: 6576 3a20 4d61 6372 6f73 2c20 2055 703a ev: Macros, Up: │ │ │ │ -00001940: 2043 6f64 696e 6720 7374 796c 650a 0a32 Coding style..2 │ │ │ │ -00001950: 2e36 2043 6f6d 6d65 6e74 730a 3d3d 3d3d .6 Comments.==== │ │ │ │ -00001960: 3d3d 3d3d 3d3d 3d3d 0a0a 416c 6c20 636f ========..All co │ │ │ │ -00001970: 6d6d 656e 7473 2073 6861 6c6c 2062 6520 mments shall be │ │ │ │ -00001980: 432d 7374 796c 6520 636f 6d6d 656e 7473 C-style comments │ │ │ │ -00001990: 2c20 6f66 2074 6865 2066 6f72 6d20 272f , of the form '/ │ │ │ │ -000019a0: 2a20 2e2e 2e20 2a2f 272e 2020 410a 636f * ... */'. A.co │ │ │ │ -000019b0: 6d6d 656e 7420 6361 6e20 6265 2070 6c61 mment can be pla │ │ │ │ -000019c0: 6365 6420 696d 6d65 6469 6174 656c 7920 ced immediately │ │ │ │ -000019d0: 7072 6563 6564 696e 6720 7468 6520 656e preceding the en │ │ │ │ -000019e0: 7469 7479 2069 7420 6465 7363 7269 6265 tity it describe │ │ │ │ -000019f0: 7320 6f72 0a69 7420 6361 6e20 6265 2070 s or.it can be p │ │ │ │ -00001a00: 6c61 6365 6420 746f 6765 7468 6572 2077 laced together w │ │ │ │ -00001a10: 6974 6820 636f 6465 2c20 7661 7269 6162 ith code, variab │ │ │ │ -00001a20: 6c65 2064 6563 6c61 7261 7469 6f6e 732c le declarations, │ │ │ │ -00001a30: 206f 7220 6f74 6865 720a 6e6f 6e2d 636f or other.non-co │ │ │ │ -00001a40: 6d6d 656e 7420 656e 7469 7469 6573 2e20 mment entities. │ │ │ │ -00001a50: 2048 6f77 6576 6572 2c20 6974 2069 7320 However, it is │ │ │ │ -00001a60: 7265 636f 6d6d 656e 6465 6420 746f 206e recommended to n │ │ │ │ -00001a70: 6f74 206d 6978 2076 6172 696f 7573 0a66 ot mix various.f │ │ │ │ -00001a80: 6f72 6d73 2065 7370 6563 6961 6c6c 7920 orms especially │ │ │ │ -00001a90: 696e 2074 7970 6573 2f73 7472 7563 7473 in types/structs │ │ │ │ -00001aa0: 2064 6573 6372 6970 7469 6f6e 732e 0a0a descriptions... │ │ │ │ -00001ab0: 2020 2041 6363 6570 7461 626c 653a 0a20 Acceptable:. │ │ │ │ -00001ac0: 2020 2020 2f2a 2054 6865 2070 6167 6520 /* The page │ │ │ │ -00001ad0: 2320 7468 6174 2069 7320 7468 6520 6672 # that is the fr │ │ │ │ -00001ae0: 6f6e 7420 6275 6666 6572 2e20 2a2f 0a20 ont buffer. */. │ │ │ │ -00001af0: 2020 2020 696e 7420 6469 7370 6c61 7965 int displaye │ │ │ │ -00001b00: 645f 7061 6765 3b0a 0a20 2020 2020 696e d_page;.. in │ │ │ │ -00001b10: 7420 7265 6e64 6572 5f70 6167 653b 202f t render_page; / │ │ │ │ -00001b20: 2a20 5468 6520 7061 6765 2023 2074 6861 * The page # tha │ │ │ │ -00001b30: 7420 6973 2074 6865 2062 6163 6b20 6275 t is the back bu │ │ │ │ -00001b40: 6666 6572 2e20 2a2f 0a0a 1f0a 4669 6c65 ffer. */....File │ │ │ │ -00001b50: 3a20 6772 7562 2d64 6576 2e69 6e66 6f2c : grub-dev.info, │ │ │ │ -00001b60: 2020 4e6f 6465 3a20 4d75 6c74 692d 4c69 Node: Multi-Li │ │ │ │ -00001b70: 6e65 2043 6f6d 6d65 6e74 732c 2020 5072 ne Comments, Pr │ │ │ │ -00001b80: 6576 3a20 436f 6d6d 656e 7473 2c20 2055 ev: Comments, U │ │ │ │ -00001b90: 703a 2043 6f64 696e 6720 7374 796c 650a p: Coding style. │ │ │ │ -00001ba0: 0a32 2e37 204d 756c 7469 2d4c 696e 6520 .2.7 Multi-Line │ │ │ │ -00001bb0: 436f 6d6d 656e 7473 0a3d 3d3d 3d3d 3d3d Comments.======= │ │ │ │ +00000080: 2c20 3320 4f63 746f 6265 7220 3230 3231 , 3 October 2021 │ │ │ │ +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.******** │ │ │ │ +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 3034 2e0a 0a20 2020 5468 ion 2.04... 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: 342c 2033 204f 6374 6f62 6572 2032 3032 4, 3 October 202 │ │ │ │ +00000410: 3129 2e0a 0a20 2020 436f 7079 7269 6768 1)... 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.******** │ │ │ │ +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.=== │ │ │ │ 00001bc0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ -00001bd0: 0a0a 436f 6d6d 656e 7473 2073 7061 6e6e ..Comments spann │ │ │ │ -00001be0: 696e 6720 6d75 6c74 6970 6c65 206c 696e ing multiple lin │ │ │ │ -00001bf0: 6573 2073 6861 6c6c 2062 6520 666f 726d es shall be form │ │ │ │ -00001c00: 6174 7465 6420 7769 7468 2061 6c6c 206c atted with all l │ │ │ │ -00001c10: 696e 6573 2061 6674 6572 0a74 6865 2066 ines after.the f │ │ │ │ -00001c20: 6972 7374 2061 6c69 676e 6564 2077 6974 irst aligned wit │ │ │ │ -00001c30: 6820 7468 6520 6669 7273 7420 6c69 6e65 h the first line │ │ │ │ -00001c40: 2e20 2041 7374 6572 6973 6b20 6368 6172 . Asterisk char │ │ │ │ -00001c50: 6163 7465 7273 2073 686f 756c 6420 6265 acters should be │ │ │ │ -00001c60: 0a72 6570 6561 7465 6420 6174 2074 6865 .repeated at the │ │ │ │ -00001c70: 2073 7461 7274 206f 6620 6561 6368 2073 start of each s │ │ │ │ -00001c80: 7562 7365 7175 656e 7420 6c69 6e65 2e0a ubsequent line.. │ │ │ │ -00001c90: 0a20 2020 4163 6365 7074 6162 6c65 3a0a . Acceptable:. │ │ │ │ -00001ca0: 2020 2020 202f 2a0a 2020 2020 2020 2a20 /*. * │ │ │ │ -00001cb0: 5468 6973 2069 7320 6120 636f 6d6d 656e This is a commen │ │ │ │ -00001cc0: 740a 2020 2020 2020 2a20 7768 6963 6820 t. * which │ │ │ │ -00001cd0: 7370 616e 7320 6d75 6c74 6970 6c65 206c spans multiple l │ │ │ │ -00001ce0: 696e 6573 2e0a 2020 2020 2020 2a20 4974 ines.. * It │ │ │ │ -00001cf0: 2069 7320 6c6f 6e67 2e0a 2020 2020 2020 is long.. │ │ │ │ -00001d00: 2a2f 0a0a 2020 2055 6e61 6363 6570 7461 */.. Unaccepta │ │ │ │ -00001d10: 626c 653a 0a20 2020 2020 2f2a 2054 6869 ble:. /* Thi │ │ │ │ -00001d20: 7320 6973 2061 2063 6f6d 6d65 6e74 0a20 s is a comment. │ │ │ │ -00001d30: 2020 2020 2020 2077 6869 6368 2073 7061 which spa │ │ │ │ -00001d40: 6e73 206d 756c 7469 706c 6520 6c69 6e65 ns multiple line │ │ │ │ -00001d50: 732e 0a20 2020 2020 2020 2049 7420 6973 s.. It is │ │ │ │ -00001d60: 206c 6f6e 672e 202a 2f0a 0a20 2020 2020 long. */.. │ │ │ │ -00001d70: 2f2a 0a20 2020 2020 202a 2054 6869 7320 /*. * This │ │ │ │ -00001d80: 6973 2061 2063 6f6d 6d65 6e74 0a20 2020 is a comment. │ │ │ │ -00001d90: 2020 202a 2077 6869 6368 2073 7061 6e73 * which spans │ │ │ │ -00001da0: 206d 756c 7469 706c 6520 6c69 6e65 732e multiple lines. │ │ │ │ -00001db0: 0a20 2020 2020 202a 2049 7420 6973 206c . * It is l │ │ │ │ -00001dc0: 6f6e 672e 202a 2f0a 0a20 2020 2020 2f2a ong. */.. /* │ │ │ │ -00001dd0: 2054 6869 7320 6973 2061 2063 6f6d 6d65 This is a comme │ │ │ │ -00001de0: 6e74 0a20 2020 2020 202a 2077 6869 6368 nt. * which │ │ │ │ -00001df0: 2073 7061 6e73 206d 756c 7469 706c 6520 spans multiple │ │ │ │ -00001e00: 6c69 6e65 732e 0a20 2020 2020 202a 2049 lines.. * I │ │ │ │ -00001e10: 7420 6973 206c 6f6e 672e 0a20 2020 2020 t is long.. │ │ │ │ -00001e20: 202a 2f0a 0a20 2020 496e 2070 6172 7469 */.. In parti │ │ │ │ -00001e30: 6375 6c61 7220 6669 7273 7420 756e 6163 cular first unac │ │ │ │ -00001e40: 6365 7074 6162 6c65 2066 6f72 6d20 6d61 ceptable form ma │ │ │ │ -00001e50: 6b65 7320 636f 6d6d 656e 7420 6469 6666 kes comment diff │ │ │ │ -00001e60: 6963 756c 7420 746f 0a64 6973 7469 6e67 icult to.disting │ │ │ │ -00001e70: 7569 7368 2066 726f 6d20 7468 6520 636f uish from the co │ │ │ │ -00001e80: 6465 2069 7473 656c 662e 2020 4573 7065 de itself. Espe │ │ │ │ -00001e90: 6369 616c 6c79 2069 6620 6974 2063 6f6e cially if it con │ │ │ │ -00001ea0: 7461 696e 7320 7468 6520 636f 6465 0a73 tains the code.s │ │ │ │ -00001eb0: 6e69 7070 6574 7320 616e 642f 6f72 2069 nippets and/or i │ │ │ │ -00001ec0: 7320 6c6f 6e67 2e20 2053 6f2c 2069 7473 s long. So, its │ │ │ │ -00001ed0: 2075 7361 6765 2069 7320 6469 7361 6c6c usage is disall │ │ │ │ -00001ee0: 6f77 6564 2e0a 0a1f 0a46 696c 653a 2067 owed.....File: g │ │ │ │ -00001ef0: 7275 622d 6465 762e 696e 666f 2c20 204e rub-dev.info, N │ │ │ │ -00001f00: 6f64 653a 2046 696e 6469 6e67 2079 6f75 ode: Finding you │ │ │ │ -00001f10: 7220 7761 7920 6172 6f75 6e64 2c20 204e r way around, N │ │ │ │ -00001f20: 6578 743a 2043 6f6e 7472 6962 7574 696e ext: Contributin │ │ │ │ -00001f30: 6720 4368 616e 6765 732c 2020 5072 6576 g Changes, Prev │ │ │ │ -00001f40: 3a20 436f 6469 6e67 2073 7479 6c65 2c20 : Coding style, │ │ │ │ -00001f50: 2055 703a 2054 6f70 0a0a 3320 4669 6e64 Up: Top..3 Find │ │ │ │ -00001f60: 696e 6720 796f 7572 2077 6179 2061 726f ing your way aro │ │ │ │ -00001f70: 756e 640a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a und.************ │ │ │ │ -00001f80: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a0a 0a48 *************..H │ │ │ │ -00001f90: 6572 6520 6973 2061 2062 7269 6566 206d ere is a brief m │ │ │ │ -00001fa0: 6170 206f 6620 7468 6520 4752 5542 2063 ap of the GRUB c │ │ │ │ -00001fb0: 6f64 6520 6261 7365 2e0a 0a20 2020 4752 ode base... GR │ │ │ │ -00001fc0: 5542 2075 7365 7320 4175 746f 636f 6e66 UB uses Autoconf │ │ │ │ -00001fd0: 2061 6e64 2041 7574 6f6d 616b 652c 2077 and Automake, w │ │ │ │ -00001fe0: 6974 6820 6d6f 7374 206f 6620 7468 6520 ith most of the │ │ │ │ -00001ff0: 4175 746f 6d61 6b65 2069 6e70 7574 0a67 Automake input.g │ │ │ │ -00002000: 656e 6572 6174 6564 2062 7920 6120 5079 enerated by a Py │ │ │ │ -00002010: 7468 6f6e 2073 6372 6970 742e 2020 5468 thon script. Th │ │ │ │ -00002020: 6520 746f 702d 6c65 7665 6c20 6275 696c e top-level buil │ │ │ │ -00002030: 6420 7275 6c65 7320 6172 6520 696e 0a27 d rules are in.' │ │ │ │ -00002040: 636f 6e66 6967 7572 652e 6163 272c 2027 configure.ac', ' │ │ │ │ -00002050: 6772 7562 2d63 6f72 652f 4d61 6b65 6669 grub-core/Makefi │ │ │ │ -00002060: 6c65 2e63 6f72 652e 6465 6627 2c20 616e le.core.def', an │ │ │ │ -00002070: 6420 274d 616b 6566 696c 652e 7574 696c d 'Makefile.util │ │ │ │ -00002080: 2e64 6566 272e 0a45 6163 6820 626c 6f63 .def'..Each bloc │ │ │ │ -00002090: 6b20 696e 2061 2027 2a2e 6465 6627 2066 k in a '*.def' f │ │ │ │ -000020a0: 696c 6520 7265 7072 6573 656e 7473 2061 ile represents a │ │ │ │ -000020b0: 2062 7569 6c64 2074 6172 6765 742c 2061 build target, a │ │ │ │ -000020c0: 6e64 2073 7065 6369 6669 6573 0a74 6865 nd specifies.the │ │ │ │ -000020d0: 2073 6f75 7263 6520 6669 6c65 7320 7573 source files us │ │ │ │ -000020e0: 6564 2074 6f20 6275 696c 6420 6974 206f ed to build it o │ │ │ │ -000020f0: 6e20 7661 7269 6f75 7320 706c 6174 666f n various platfo │ │ │ │ -00002100: 726d 732e 2020 5468 6520 272a 2e64 6566 rms. The '*.def │ │ │ │ -00002110: 270a 6669 6c65 7320 6172 6520 7072 6f63 '.files are proc │ │ │ │ -00002120: 6573 7365 6420 696e 746f 2041 7574 6f6d essed into Autom │ │ │ │ -00002130: 616b 6520 696e 7075 7420 6279 2027 6765 ake input by 'ge │ │ │ │ -00002140: 6e74 706c 2e70 7927 2028 7768 6963 6820 ntpl.py' (which │ │ │ │ -00002150: 796f 7520 6f6e 6c79 0a6e 6565 6420 746f you only.need to │ │ │ │ -00002160: 206c 6f6f 6b20 6174 2069 6620 796f 7520 look at if you │ │ │ │ -00002170: 6172 6520 6578 7465 6e64 696e 6720 7468 are extending th │ │ │ │ -00002180: 6520 6275 696c 6420 7379 7374 656d 292e e build system). │ │ │ │ -00002190: 2020 4966 2079 6f75 2061 7265 0a61 6464 If you are.add │ │ │ │ -000021a0: 696e 6720 6120 6e65 7720 6d6f 6475 6c65 ing a new module │ │ │ │ -000021b0: 2077 6869 6368 2066 6f6c 6c6f 7773 2061 which follows a │ │ │ │ -000021c0: 6e20 6578 6973 7469 6e67 2070 6174 7465 n existing patte │ │ │ │ -000021d0: 726e 2c20 7375 6368 2061 7320 6120 6e65 rn, such as a ne │ │ │ │ -000021e0: 770a 636f 6d6d 616e 6420 6f72 2061 206e w.command or a n │ │ │ │ -000021f0: 6577 2066 696c 6573 7973 7465 6d20 696d ew filesystem im │ │ │ │ -00002200: 706c 656d 656e 7461 7469 6f6e 2c20 6974 plementation, it │ │ │ │ -00002210: 2069 7320 7573 7561 6c6c 7920 6561 7369 is usually easi │ │ │ │ -00002220: 6573 7420 746f 0a67 7265 7020 2767 7275 est to.grep 'gru │ │ │ │ -00002230: 622d 636f 7265 2f4d 616b 6566 696c 652e b-core/Makefile. │ │ │ │ -00002240: 636f 7265 2e64 6566 2720 616e 6420 274d core.def' and 'M │ │ │ │ -00002250: 616b 6566 696c 652e 7574 696c 2e64 6566 akefile.util.def │ │ │ │ -00002260: 2720 666f 7220 616e 0a65 7869 7374 696e ' for an.existin │ │ │ │ -00002270: 6720 6578 616d 706c 6520 6f66 2074 6861 g example of tha │ │ │ │ -00002280: 7420 7061 7474 6572 6e20 746f 2066 696e t pattern to fin │ │ │ │ -00002290: 6420 6f75 7420 7768 6572 6520 6974 2073 d out where it s │ │ │ │ -000022a0: 686f 756c 6420 6265 2061 6464 6564 2e0a hould be added.. │ │ │ │ -000022b0: 0a20 2020 496e 2067 656e 6572 616c 2c20 . In general, │ │ │ │ -000022c0: 636f 6465 2074 6861 7420 6d61 7920 6265 code that may be │ │ │ │ -000022d0: 2072 756e 2061 7420 626f 6f74 2074 696d run at boot tim │ │ │ │ -000022e0: 6520 6973 2069 6e20 6120 7375 6264 6972 e is in a subdir │ │ │ │ -000022f0: 6563 746f 7279 206f 660a 2767 7275 622d ectory of.'grub- │ │ │ │ -00002300: 636f 7265 272c 2077 6869 6c65 2063 6f64 core', while cod │ │ │ │ -00002310: 6520 7468 6174 2069 7320 6f6e 6c79 2072 e that is only r │ │ │ │ -00002320: 756e 2066 726f 6d20 7769 7468 696e 2061 un from within a │ │ │ │ -00002330: 2066 756c 6c20 6f70 6572 6174 696e 670a full operating. │ │ │ │ -00002340: 7379 7374 656d 2069 7320 696e 2061 2073 system is in a s │ │ │ │ -00002350: 7562 6469 7265 6374 6f72 7920 6f66 2074 ubdirectory of t │ │ │ │ -00002360: 6865 2074 6f70 206c 6576 656c 2e0a 0a20 he top level... │ │ │ │ -00002370: 2020 4c6f 772d 6c65 7665 6c20 626f 6f74 Low-level boot │ │ │ │ -00002380: 2063 6f64 652c 2073 7563 6820 6173 2074 code, such as t │ │ │ │ -00002390: 6865 204d 4252 2069 6d70 6c65 6d65 6e74 he MBR implement │ │ │ │ -000023a0: 6174 696f 6e20 6f6e 2050 4320 4249 4f53 ation on PC BIOS │ │ │ │ -000023b0: 0a73 7973 7465 6d73 2c20 6973 2069 6e20 .systems, is in │ │ │ │ -000023c0: 7468 6520 2767 7275 622d 636f 7265 2f62 the 'grub-core/b │ │ │ │ -000023d0: 6f6f 742f 2720 6469 7265 6374 6f72 792e oot/' directory. │ │ │ │ -000023e0: 0a0a 2020 2054 6865 2047 5255 4220 6b65 .. The GRUB ke │ │ │ │ -000023f0: 726e 656c 2069 7320 696e 2027 6772 7562 rnel is in 'grub │ │ │ │ -00002400: 2d63 6f72 652f 6b65 726e 2f27 2e20 2054 -core/kern/'. T │ │ │ │ -00002410: 6869 7320 636f 6e74 6169 6e73 2063 6f72 his contains cor │ │ │ │ -00002420: 650a 6661 6369 6c69 7469 6573 2073 7563 e.facilities suc │ │ │ │ -00002430: 6820 6173 2074 6865 2064 6576 6963 652c h as the device, │ │ │ │ -00002440: 2064 6973 6b2c 2061 6e64 2066 696c 6520 disk, and file │ │ │ │ -00002450: 6672 616d 6577 6f72 6b73 2c20 656e 7669 frameworks, envi │ │ │ │ -00002460: 726f 6e6d 656e 740a 7661 7269 6162 6c65 ronment.variable │ │ │ │ -00002470: 2068 616e 646c 696e 672c 206c 6973 7420 handling, list │ │ │ │ -00002480: 7072 6f63 6573 7369 6e67 2c20 616e 6420 processing, and │ │ │ │ -00002490: 736f 206f 6e2e 2020 5468 6520 6b65 726e so on. The kern │ │ │ │ -000024a0: 656c 2073 686f 756c 640a 636f 6e74 6169 el should.contai │ │ │ │ -000024b0: 6e20 656e 6f75 6768 2074 6f20 6765 7420 n enough to get │ │ │ │ -000024c0: 7570 2074 6f20 6120 7265 7363 7565 2070 up to a rescue p │ │ │ │ -000024d0: 726f 6d70 742e 2020 4865 6164 6572 2066 rompt. Header f │ │ │ │ -000024e0: 696c 6573 2066 6f72 206b 6572 6e65 6c0a iles for kernel. │ │ │ │ -000024f0: 6661 6369 6c69 7469 6573 2c20 616d 6f6e facilities, amon │ │ │ │ -00002500: 6720 6f74 6865 7273 2c20 6172 6520 696e g others, are in │ │ │ │ -00002510: 2027 696e 636c 7564 652f 272e 0a0a 2020 'include/'... │ │ │ │ -00002520: 2054 6572 6d69 6e61 6c20 696d 706c 656d Terminal implem │ │ │ │ -00002530: 656e 7461 7469 6f6e 7320 6172 6520 696e entations are in │ │ │ │ -00002540: 2027 6772 7562 2d63 6f72 652f 7465 726d 'grub-core/term │ │ │ │ -00002550: 2f27 2e0a 0a20 2020 4469 736b 2061 6363 /'... Disk acc │ │ │ │ -00002560: 6573 7320 636f 6465 2069 7320 7370 7265 ess code is spre │ │ │ │ -00002570: 6164 2061 6372 6f73 7320 2767 7275 622d ad across 'grub- │ │ │ │ -00002580: 636f 7265 2f64 6973 6b2f 2720 2866 6f72 core/disk/' (for │ │ │ │ -00002590: 2061 6363 6573 7369 6e67 0a74 6865 2064 accessing.the d │ │ │ │ -000025a0: 6973 6b20 6465 7669 6365 7320 7468 656d isk devices them │ │ │ │ -000025b0: 7365 6c76 6573 292c 2027 6772 7562 2d63 selves), 'grub-c │ │ │ │ -000025c0: 6f72 652f 7061 7274 6d61 702f 2720 2866 ore/partmap/' (f │ │ │ │ -000025d0: 6f72 2069 6e74 6572 7072 6574 696e 670a or interpreting. │ │ │ │ -000025e0: 7061 7274 6974 696f 6e20 7461 626c 6520 partition table │ │ │ │ -000025f0: 6461 7461 292c 2061 6e64 2027 6772 7562 data), and 'grub │ │ │ │ -00002600: 2d63 6f72 652f 6673 2f27 2028 666f 7220 -core/fs/' (for │ │ │ │ -00002610: 6163 6365 7373 696e 6720 6669 6c65 7379 accessing filesy │ │ │ │ -00002620: 7374 656d 7329 2e0a 4e6f 7465 2074 6861 stems)..Note tha │ │ │ │ -00002630: 742c 2077 6974 6820 7468 6520 6f64 6420 t, with the odd │ │ │ │ -00002640: 7370 6563 6961 6c69 7365 6420 6578 6365 specialised exce │ │ │ │ -00002650: 7074 696f 6e2c 2047 5255 4220 6f6e 6c79 ption, GRUB only │ │ │ │ -00002660: 2063 6f6e 7461 696e 7320 636f 6465 0a74 contains code.t │ │ │ │ -00002670: 6f20 5f72 6561 645f 2066 726f 6d20 6669 o _read_ from fi │ │ │ │ -00002680: 6c65 7379 7374 656d 7320 616e 6420 7472 lesystems and tr │ │ │ │ -00002690: 6965 7320 746f 2061 766f 6964 2063 6f6e ies to avoid con │ │ │ │ -000026a0: 7461 696e 696e 6720 616e 7920 636f 6465 taining any code │ │ │ │ -000026b0: 2074 6f0a 5f77 7269 7465 5f20 746f 2066 to._write_ to f │ │ │ │ -000026c0: 696c 6573 7973 7465 6d73 3b20 7468 6973 ilesystems; this │ │ │ │ -000026d0: 206c 6574 7320 7573 2063 6f6e 6669 6465 lets us confide │ │ │ │ -000026e0: 6e74 6c79 2061 7373 7572 6520 7573 6572 ntly assure user │ │ │ │ -000026f0: 7320 7468 6174 2047 5255 420a 6361 6e6e s that GRUB.cann │ │ │ │ -00002700: 6f74 2062 6520 7265 7370 6f6e 7369 626c ot be responsibl │ │ │ │ -00002710: 6520 666f 7220 6669 6c65 7379 7374 656d e for filesystem │ │ │ │ -00002720: 2063 6f72 7275 7074 696f 6e2e 0a0a 2020 corruption... │ │ │ │ -00002730: 2050 4349 2061 6e64 2055 5342 2062 7573 PCI and USB bus │ │ │ │ -00002740: 2068 616e 646c 696e 6720 6973 2069 6e20 handling is in │ │ │ │ -00002750: 2767 7275 622d 636f 7265 2f62 7573 2f27 'grub-core/bus/' │ │ │ │ -00002760: 2e0a 0a20 2020 5669 6465 6f20 6861 6e64 ... Video hand │ │ │ │ -00002770: 6c69 6e67 2063 6f64 6520 6973 2069 6e20 ling code is in │ │ │ │ -00002780: 2767 7275 622d 636f 7265 2f76 6964 656f 'grub-core/video │ │ │ │ -00002790: 2f27 2e20 2054 6865 2067 7261 7068 6963 /'. The graphic │ │ │ │ -000027a0: 616c 206d 656e 750a 7379 7374 656d 2075 al menu.system u │ │ │ │ -000027b0: 7365 7320 7468 6973 2068 6561 7669 6c79 ses this heavily │ │ │ │ -000027c0: 2c20 6275 7420 6973 2069 6e20 6120 7365 , but is in a se │ │ │ │ -000027d0: 7061 7261 7465 2064 6972 6563 746f 7279 parate directory │ │ │ │ -000027e0: 2c0a 2767 7275 622d 636f 7265 2f67 6678 ,.'grub-core/gfx │ │ │ │ -000027f0: 6d65 6e75 2f27 2e0a 0a20 2020 4d6f 7374 menu/'... Most │ │ │ │ -00002800: 2063 6f6d 6d61 6e64 7320 6172 6520 696d commands are im │ │ │ │ -00002810: 706c 656d 656e 7465 6420 6279 2066 696c plemented by fil │ │ │ │ -00002820: 6573 2069 6e20 2767 7275 622d 636f 7265 es in 'grub-core │ │ │ │ -00002830: 2f63 6f6d 6d61 6e64 732f 272c 2077 6974 /commands/', wit │ │ │ │ -00002840: 680a 7468 6520 666f 6c6c 6f77 696e 6720 h.the following │ │ │ │ -00002850: 6578 6365 7074 696f 6e73 3a0a 0a20 2020 exceptions:.. │ │ │ │ -00002860: 2a20 4120 6665 7720 636f 7265 2063 6f6d * A few core com │ │ │ │ -00002870: 6d61 6e64 7320 6c69 7665 2069 6e20 2767 mands live in 'g │ │ │ │ -00002880: 7275 622d 636f 7265 2f6b 6572 6e2f 636f rub-core/kern/co │ │ │ │ -00002890: 7265 636d 642e 6327 2e0a 0a20 2020 2a20 recmd.c'... * │ │ │ │ -000028a0: 436f 6d6d 616e 6473 2072 656c 6174 6564 Commands related │ │ │ │ -000028b0: 2074 6f20 6e6f 726d 616c 206d 6f64 6520 to normal mode │ │ │ │ -000028c0: 6c69 7665 2075 6e64 6572 2027 6772 7562 live under 'grub │ │ │ │ -000028d0: 2d63 6f72 652f 6e6f 726d 616c 2f27 2e0a -core/normal/'.. │ │ │ │ -000028e0: 0a20 2020 2a20 436f 6d6d 616e 6473 2074 . * Commands t │ │ │ │ -000028f0: 6861 7420 6c6f 6164 2061 6e64 2062 6f6f hat load and boo │ │ │ │ -00002900: 7420 6b65 726e 656c 7320 6c69 7665 2075 t kernels live u │ │ │ │ -00002910: 6e64 6572 2027 6772 7562 2d63 6f72 652f nder 'grub-core/ │ │ │ │ -00002920: 6c6f 6164 6572 2f27 2e0a 0a20 2020 2a20 loader/'... * │ │ │ │ -00002930: 5468 6520 276c 6f6f 7062 6163 6b27 2063 The 'loopback' c │ │ │ │ -00002940: 6f6d 6d61 6e64 2069 7320 7265 616c 6c79 ommand is really │ │ │ │ -00002950: 2061 2064 6973 6b20 6465 7669 6365 2c20 a disk device, │ │ │ │ -00002960: 616e 6420 736f 206c 6976 6573 2069 6e0a and so lives in. │ │ │ │ -00002970: 2020 2020 2027 6772 7562 2d63 6f72 652f 'grub-core/ │ │ │ │ -00002980: 6469 736b 2f6c 6f6f 7062 6163 6b2e 6327 disk/loopback.c' │ │ │ │ -00002990: 2e0a 0a20 2020 2a20 5468 6520 2767 6574 ... * The 'get │ │ │ │ -000029a0: 7465 7874 2720 636f 6d6d 616e 6420 6c69 text' command li │ │ │ │ -000029b0: 7665 7320 756e 6465 7220 2767 7275 622d ves under 'grub- │ │ │ │ -000029c0: 636f 7265 2f67 6574 7465 7874 2f27 2e0a core/gettext/'.. │ │ │ │ -000029d0: 0a20 2020 2a20 5468 6520 276c 6f61 6466 . * The 'loadf │ │ │ │ -000029e0: 6f6e 7427 2061 6e64 2027 6c73 666f 6e74 ont' and 'lsfont │ │ │ │ -000029f0: 7327 2063 6f6d 6d61 6e64 7320 6c69 7665 s' commands live │ │ │ │ -00002a00: 2075 6e64 6572 2027 6772 7562 2d63 6f72 under 'grub-cor │ │ │ │ -00002a10: 652f 666f 6e74 2f27 2e0a 0a20 2020 2a20 e/font/'... * │ │ │ │ -00002a20: 5468 6520 2773 6572 6961 6c27 2c20 2774 The 'serial', 't │ │ │ │ -00002a30: 6572 6d69 6e66 6f27 2c20 616e 6420 2762 erminfo', and 'b │ │ │ │ -00002a40: 6163 6b67 726f 756e 645f 696d 6167 6527 ackground_image' │ │ │ │ -00002a50: 2063 6f6d 6d61 6e64 7320 6c69 7665 0a20 commands live. │ │ │ │ -00002a60: 2020 2020 756e 6465 7220 2767 7275 622d under 'grub- │ │ │ │ -00002a70: 636f 7265 2f74 6572 6d2f 272e 0a0a 2020 core/term/'... │ │ │ │ -00002a80: 202a 2054 6865 2027 6566 6965 6d75 5f2a * The 'efiemu_* │ │ │ │ -00002a90: 2720 636f 6d6d 616e 6473 206c 6976 6520 ' commands live │ │ │ │ -00002aa0: 756e 6465 7220 2767 7275 622d 636f 7265 under 'grub-core │ │ │ │ -00002ab0: 2f65 6669 656d 752f 272e 0a0a 2020 202a /efiemu/'... * │ │ │ │ -00002ac0: 204f 532d 6465 7065 6e64 656e 7420 636f OS-dependent co │ │ │ │ -00002ad0: 6465 2073 686f 756c 6420 6265 2075 6e64 de should be und │ │ │ │ -00002ae0: 6572 2027 6772 7562 2d63 6f72 652f 6f73 er 'grub-core/os │ │ │ │ -00002af0: 6465 702f 270a 0a20 2020 2a20 5574 696c dep/'.. * Util │ │ │ │ -00002b00: 6974 7920 7072 6f67 7261 6d73 206d 6561 ity programs mea │ │ │ │ -00002b10: 6e74 2074 6f20 6265 2072 756e 2066 726f nt to be run fro │ │ │ │ -00002b20: 6d20 6120 6675 6c6c 206f 7065 7261 7469 m a full operati │ │ │ │ -00002b30: 6e67 2073 7973 7465 6d0a 2020 2020 2028 ng system. ( │ │ │ │ -00002b40: 6578 6365 7074 204f 532d 6465 7065 6e64 except OS-depend │ │ │ │ -00002b50: 656e 7420 636f 6465 206d 656e 7469 6f6e ent code mention │ │ │ │ -00002b60: 6564 2070 7265 7669 6f75 736c 7929 2061 ed previously) a │ │ │ │ -00002b70: 7265 2069 6e20 2775 7469 6c2f 272e 0a0a re in 'util/'... │ │ │ │ -00002b80: 2020 2054 6865 7265 2061 7265 2061 2066 There are a f │ │ │ │ -00002b90: 6577 206f 7468 6572 2073 7065 6369 616c ew other special │ │ │ │ -00002ba0: 2d70 7572 706f 7365 2065 7863 6570 7469 -purpose excepti │ │ │ │ -00002bb0: 6f6e 733b 2067 7265 7020 666f 7220 7468 ons; grep for th │ │ │ │ -00002bc0: 656d 2069 660a 7468 6579 206d 6174 7465 em if.they matte │ │ │ │ -00002bd0: 7220 746f 2079 6f75 2e0a 0a1f 0a46 696c r to you.....Fil │ │ │ │ -00002be0: 653a 2067 7275 622d 6465 762e 696e 666f e: grub-dev.info │ │ │ │ -00002bf0: 2c20 204e 6f64 653a 2043 6f6e 7472 6962 , Node: Contrib │ │ │ │ -00002c00: 7574 696e 6720 4368 616e 6765 732c 2020 uting Changes, │ │ │ │ -00002c10: 4e65 7874 3a20 5570 6461 7469 6e67 2045 Next: Updating E │ │ │ │ -00002c20: 7874 6572 6e61 6c20 436f 6465 2c20 2050 xternal Code, P │ │ │ │ -00002c30: 7265 763a 2046 696e 6469 6e67 2079 6f75 rev: Finding you │ │ │ │ -00002c40: 7220 7761 7920 6172 6f75 6e64 2c20 2055 r way around, U │ │ │ │ -00002c50: 703a 2054 6f70 0a0a 3420 436f 6e74 7269 p: Top..4 Contri │ │ │ │ -00002c60: 6275 7469 6e67 2063 6861 6e67 6573 0a2a buting changes.* │ │ │ │ -00002c70: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ -00002c80: 2a2a 2a2a 2a0a 0a43 6f6e 7472 6962 7574 *****..Contribut │ │ │ │ -00002c90: 696e 6720 6368 616e 6765 7320 746f 2047 ing changes to G │ │ │ │ -00002ca0: 5255 4220 3220 6973 2077 656c 636f 6d65 RUB 2 is welcome │ │ │ │ -00002cb0: 6420 6163 7469 7669 7479 2e20 2048 6f77 d activity. How │ │ │ │ -00002cc0: 6576 6572 2077 6520 6861 7665 2061 0a62 ever we have a.b │ │ │ │ -00002cd0: 6974 206f 6620 636f 6e74 726f 6c20 7768 it of control wh │ │ │ │ -00002ce0: 6174 206b 696e 6420 6f66 2063 6861 6e67 at kind of chang │ │ │ │ -00002cf0: 6573 2077 696c 6c20 6265 2061 6363 6570 es will be accep │ │ │ │ -00002d00: 7465 6420 746f 2047 5255 4220 322e 0a54 ted to GRUB 2..T │ │ │ │ -00002d10: 6865 7265 666f 7265 2069 7420 6973 2069 herefore it is i │ │ │ │ -00002d20: 6d70 6f72 7461 6e74 2074 6f20 6469 7363 mportant to disc │ │ │ │ -00002d30: 7573 7320 796f 7572 2063 6861 6e67 6573 uss your changes │ │ │ │ -00002d40: 206f 6e20 6772 7562 2d64 6576 656c 206d on grub-devel m │ │ │ │ -00002d50: 6169 6c69 6e67 0a6c 6973 7420 2873 6565 ailing.list (see │ │ │ │ -00002d60: 204d 6169 6c69 6e67 4c69 7374 7329 2e20 MailingLists). │ │ │ │ -00002d70: 204f 6e20 7468 6973 2070 6167 6520 7468 On this page th │ │ │ │ -00002d80: 6572 6520 6172 6520 736f 6d65 2062 6173 ere are some bas │ │ │ │ -00002d90: 6963 2064 6574 6169 6c73 206f 6e0a 7468 ic details on.th │ │ │ │ -00002da0: 6520 6465 7665 6c6f 706d 656e 7420 7072 e development pr │ │ │ │ -00002db0: 6f63 6573 7320 616e 6420 6163 7469 7669 ocess and activi │ │ │ │ -00002dc0: 7469 6573 2e0a 0a20 2020 4669 7273 7420 ties... First │ │ │ │ -00002dd0: 6f66 2061 6c6c 2079 6f75 2073 686f 756c of all you shoul │ │ │ │ -00002de0: 6420 636f 6d65 2075 7020 7769 7468 2074 d come up with t │ │ │ │ -00002df0: 6865 2069 6465 6120 796f 7572 7365 6c66 he idea yourself │ │ │ │ -00002e00: 2077 6861 7420 796f 7520 7761 6e74 0a74 what you want.t │ │ │ │ -00002e10: 6f20 636f 6e74 7269 6275 7465 2e20 2049 o contribute. I │ │ │ │ -00002e20: 6620 796f 7520 646f 206e 6f74 2068 6176 f you do not hav │ │ │ │ -00002e30: 6520 7468 6174 2062 6566 6f72 6568 616e e that beforehan │ │ │ │ -00002e40: 6420 796f 7520 6172 6520 6164 7669 7365 d you are advise │ │ │ │ -00002e50: 6420 746f 0a73 7475 6479 2074 6869 7320 d to.study this │ │ │ │ -00002e60: 6d61 6e75 616c 2061 6e64 2074 7279 2047 manual and try G │ │ │ │ -00002e70: 5255 4220 3220 6f75 7420 746f 2073 6565 RUB 2 out to see │ │ │ │ -00002e80: 2077 6861 7420 796f 7520 7468 696e 6b20 what you think │ │ │ │ -00002e90: 6973 206d 6973 7369 6e67 0a66 726f 6d20 is missing.from │ │ │ │ -00002ea0: 7468 6572 652e 0a0a 2020 2048 6572 6520 there... Here │ │ │ │ -00002eb0: 6172 6520 6164 6469 7469 6f6e 616c 2070 are additional p │ │ │ │ -00002ec0: 6f69 6e74 6572 733a 0a20 2020 2a20 3c68 ointers:. * . │ │ │ │ -00002f10: 202a 203c 6874 7470 733a 2f2f 7361 7661 * .. If you int │ │ │ │ -00002f60: 656e 6465 6420 746f 206d 616b 6520 6368 ended to make ch │ │ │ │ -00002f70: 616e 6765 7320 746f 2047 5255 4220 4c65 anges to GRUB Le │ │ │ │ -00002f80: 6761 6379 2028 3c3d 302e 3937 2920 7468 gacy (<=0.97) th │ │ │ │ -00002f90: 6f73 6520 6172 6520 6e6f 740a 6163 6365 ose are not.acce │ │ │ │ -00002fa0: 7074 6564 2061 6e79 6d6f 7265 2e0a 0a2a pted anymore...* │ │ │ │ -00002fb0: 204d 656e 753a 0a0a 2a20 4765 7474 696e Menu:..* Gettin │ │ │ │ -00002fc0: 6720 7374 6172 7465 643a 3a0a 2a20 5479 g started::.* Ty │ │ │ │ -00002fd0: 7069 6361 6c20 4465 7665 6c6f 7065 7220 pical Developer │ │ │ │ -00002fe0: 4578 7065 7269 656e 6365 3a3a 0a2a 2057 Experience::.* W │ │ │ │ -00002ff0: 6865 6e20 796f 7520 6172 6520 6170 7072 hen you are appr │ │ │ │ -00003000: 6f76 6564 2066 6f72 2077 7269 7465 2061 oved for write a │ │ │ │ -00003010: 6363 6573 7320 746f 2070 726f 6a65 6374 ccess to project │ │ │ │ -00003020: 2773 2066 696c 6573 3a3a 0a0a 1f0a 4669 's files::....Fi │ │ │ │ -00003030: 6c65 3a20 6772 7562 2d64 6576 2e69 6e66 le: grub-dev.inf │ │ │ │ -00003040: 6f2c 2020 4e6f 6465 3a20 4765 7474 696e o, Node: Gettin │ │ │ │ -00003050: 6720 7374 6172 7465 642c 2020 4e65 7874 g started, Next │ │ │ │ -00003060: 3a20 5479 7069 6361 6c20 4465 7665 6c6f : Typical Develo │ │ │ │ -00003070: 7065 7220 4578 7065 7269 656e 6365 2c20 per Experience, │ │ │ │ -00003080: 2055 703a 2043 6f6e 7472 6962 7574 696e Up: Contributin │ │ │ │ -00003090: 6720 4368 616e 6765 730a 0a34 2e31 2047 g Changes..4.1 G │ │ │ │ -000030a0: 6574 7469 6e67 2073 7461 7274 6564 0a3d etting started.= │ │ │ │ -000030b0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ -000030c0: 3d3d 0a0a 2020 202a 2041 6c77 6179 7320 ==.. * Always │ │ │ │ -000030d0: 7573 6520 6c61 7465 7374 2047 5255 4220 use latest GRUB │ │ │ │ -000030e0: 3220 736f 7572 6365 2063 6f64 652e 2020 2 source code. │ │ │ │ -000030f0: 536f 2067 6574 2074 6861 7420 6669 7273 So get that firs │ │ │ │ -00003100: 742e 0a0a 2020 2020 2046 6f72 2064 6576 t... For dev │ │ │ │ -00003110: 656c 6f70 6572 7320 6974 2069 7320 7265 elopers it is re │ │ │ │ -00003120: 636f 6d6d 656e 6465 6420 616c 7761 7973 commended always │ │ │ │ -00003130: 2074 6f20 7573 6520 7468 6520 6e65 7765 to use the newe │ │ │ │ -00003140: 7374 0a20 2020 2020 6465 7665 6c6f 706d st. developm │ │ │ │ -00003150: 656e 7420 7665 7273 696f 6e20 6f66 2047 ent version of G │ │ │ │ -00003160: 5255 4220 322e 2020 4966 2064 6576 656c RUB 2. If devel │ │ │ │ -00003170: 6f70 6d65 6e74 2074 616b 6573 2061 206c opment takes a l │ │ │ │ -00003180: 6f6e 6720 7065 7269 6f64 0a20 2020 2020 ong period. │ │ │ │ -00003190: 6f66 2074 696d 652c 2070 6c65 6173 6520 of time, please │ │ │ │ -000031a0: 7265 6d65 6d62 6572 2074 6f20 6b65 6570 remember to keep │ │ │ │ -000031b0: 2069 6e20 7379 6e63 2077 6974 6820 6e65 in sync with ne │ │ │ │ -000031c0: 7765 7374 2064 6576 656c 6f70 6d65 6e74 west development │ │ │ │ -000031d0: 730a 2020 2020 2072 6567 756c 6172 6c79 s. regularly │ │ │ │ -000031e0: 2073 6f20 6974 2069 7320 6d75 6368 2065 so it is much e │ │ │ │ -000031f0: 6173 6965 7220 746f 2069 6e74 6567 7261 asier to integra │ │ │ │ -00003200: 7465 2079 6f75 7220 6368 616e 6765 2069 te your change i │ │ │ │ -00003210: 6e20 7468 650a 2020 2020 2066 7574 7572 n the. futur │ │ │ │ -00003220: 652e 2020 4752 5542 2032 2069 7320 6265 e. GRUB 2 is be │ │ │ │ -00003230: 696e 6720 6465 7665 6c6f 7065 6420 696e ing developed in │ │ │ │ -00003240: 2061 2047 4954 2072 6570 6f73 6974 6f72 a GIT repositor │ │ │ │ -00003250: 792e 0a0a 2020 2020 2050 6c65 6173 6520 y... Please │ │ │ │ -00003260: 6368 6563 6b20 5361 7661 6e6e 6168 2773 check Savannah's │ │ │ │ -00003270: 2047 5255 4220 7072 6f6a 6563 7420 7061 GRUB project pa │ │ │ │ -00003280: 6765 2066 6f72 2064 6574 6169 6c73 2068 ge for details h │ │ │ │ -00003290: 6f77 2074 6f20 6765 740a 2020 2020 206e ow to get. n │ │ │ │ -000032a0: 6577 6573 7420 6769 743a 2047 5255 4220 ewest git: GRUB │ │ │ │ -000032b0: 3220 6769 7420 5265 706f 7369 746f 7279 2 git Repository │ │ │ │ -000032c0: 0a20 2020 2020 2868 7474 7073 3a2f 2f73 . (https://s │ │ │ │ -000032d0: 6176 616e 6e61 682e 676e 752e 6f72 672f avannah.gnu.org/ │ │ │ │ -000032e0: 6769 742f 3f67 726f 7570 3d67 7275 6229 git/?group=grub) │ │ │ │ -000032f0: 0a0a 2020 202a 2043 6f6d 7069 6c65 2069 .. * Compile i │ │ │ │ -00003300: 7420 616e 6420 7472 7920 6974 206f 7574 t and try it out │ │ │ │ -00003310: 2e0a 0a20 2020 2020 4974 2069 7320 616c ... It is al │ │ │ │ -00003320: 7761 7973 2067 6f6f 6420 6964 6561 2074 ways good idea t │ │ │ │ -00003330: 6f20 6669 7273 7420 7365 6520 7468 6174 o first see that │ │ │ │ -00003340: 2074 6869 6e67 7320 776f 726b 2073 6f6d things work som │ │ │ │ -00003350: 6568 6f77 2061 6e64 0a20 2020 2020 6166 ehow and. af │ │ │ │ -00003360: 7465 7220 7468 6174 2074 6f20 7374 6172 ter that to star │ │ │ │ -00003370: 7420 746f 2069 6d70 6c65 6d65 6e74 206e t to implement n │ │ │ │ -00003380: 6577 2066 6561 7475 7265 7320 6f72 2064 ew features or d │ │ │ │ -00003390: 6576 656c 6f70 2066 6978 6573 2074 6f0a evelop fixes to. │ │ │ │ -000033a0: 2020 2020 2062 7567 732e 0a0a 2020 202a bugs... * │ │ │ │ -000033b0: 2053 7475 6479 2074 6865 2063 6f64 652e Study the code. │ │ │ │ -000033c0: 0a0a 2020 2020 2054 6865 7265 2061 7265 .. There are │ │ │ │ -000033d0: 2073 6f6d 6574 696d 6573 206f 6464 2077 sometimes odd w │ │ │ │ -000033e0: 6179 7320 746f 2064 6f20 7468 696e 6773 ays to do things │ │ │ │ -000033f0: 2069 6e20 4752 5542 2032 2063 6f64 6520 in GRUB 2 code │ │ │ │ -00003400: 6261 7365 2e0a 2020 2020 2054 6869 7320 base.. This │ │ │ │ -00003410: 6973 206d 6169 6e6c 7920 7265 6c61 7465 is mainly relate │ │ │ │ -00003420: 6420 746f 206c 696d 6974 6564 2065 6e76 d to limited env │ │ │ │ -00003430: 6972 6f6e 6d65 6e74 2077 6865 7265 2047 ironment where G │ │ │ │ -00003440: 5255 4220 3220 6973 2062 6569 6e67 0a20 RUB 2 is being. │ │ │ │ -00003450: 2020 2020 6578 6563 7574 6564 2e20 2059 executed. Y │ │ │ │ -00003460: 6f75 2075 7375 616c 6c79 2064 6f20 6e6f ou usually do no │ │ │ │ -00003470: 7420 6e65 6564 2074 6f20 756e 6465 7273 t need to unders │ │ │ │ -00003480: 7461 6e64 2069 7420 616c 6c20 736f 2069 tand it all so i │ │ │ │ -00003490: 7420 6973 0a20 2020 2020 6265 7474 6572 t is. better │ │ │ │ -000034a0: 2074 6f20 6f6e 6c79 2074 7279 2074 6f20 to only try to │ │ │ │ -000034b0: 6c6f 6f6b 2061 7420 706c 6163 6573 2074 look at places t │ │ │ │ -000034c0: 6861 7420 7265 6c61 7465 7320 746f 2079 hat relates to y │ │ │ │ -000034d0: 6f75 7220 776f 726b 2e0a 2020 2020 2050 our work.. P │ │ │ │ -000034e0: 6c65 6173 6520 646f 206e 6f74 2068 6573 lease do not hes │ │ │ │ -000034f0: 6974 6174 6520 746f 2061 736b 2066 6f72 itate to ask for │ │ │ │ -00003500: 2068 656c 7020 6966 2074 6865 7265 2069 help if there i │ │ │ │ -00003510: 7320 736f 6d65 7468 696e 6720 7468 6174 s something that │ │ │ │ -00003520: 0a20 2020 2020 796f 7520 646f 206e 6f74 . you do not │ │ │ │ -00003530: 2075 6e64 6572 7374 616e 642e 0a0a 2020 understand... │ │ │ │ -00003540: 202a 2044 6576 656c 6f70 2061 206e 6577 * Develop a new │ │ │ │ -00003550: 2066 6561 7475 7265 2e0a 0a20 2020 2020 feature... │ │ │ │ -00003560: 4e6f 7720 7468 6174 2079 6f75 206b 6e6f Now that you kno │ │ │ │ -00003570: 7720 7768 6174 2074 6f20 646f 2061 6e64 w what to do and │ │ │ │ -00003580: 2068 6f77 2069 7420 7368 6f75 6c64 2077 how it should w │ │ │ │ -00003590: 6f72 6b20 696e 2047 5255 4220 3220 636f ork in GRUB 2 co │ │ │ │ -000035a0: 6465 0a20 2020 2020 6261 7365 2c20 706c de. base, pl │ │ │ │ -000035b0: 6561 7365 2062 6520 6672 6565 2074 6f20 ease be free to │ │ │ │ -000035c0: 6465 7665 6c6f 7020 6974 2e20 2049 6620 develop it. If │ │ │ │ -000035d0: 796f 7520 6861 7665 206e 6f74 2073 6f20 you have not so │ │ │ │ -000035e0: 6661 720a 2020 2020 2061 6e6e 6f75 6e63 far. announc │ │ │ │ -000035f0: 6564 2079 6f75 7220 6964 6561 206f 6e20 ed your idea on │ │ │ │ -00003600: 6772 7562 2d64 6576 656c 206d 6169 6c69 grub-devel maili │ │ │ │ -00003610: 6e67 206c 6973 742c 2070 6c65 6173 6520 ng list, please │ │ │ │ -00003620: 646f 2069 7420 6e6f 772e 0a20 2020 2020 do it now.. │ │ │ │ -00003630: 5468 6973 2069 7320 746f 206d 616b 6520 This is to make │ │ │ │ -00003640: 7375 7265 2079 6f75 2061 7265 206e 6f74 sure you are not │ │ │ │ -00003650: 2077 6173 7469 6e67 2079 6f75 7220 7469 wasting your ti │ │ │ │ -00003660: 6d65 2077 6f72 6b69 6e67 206f 6e20 7468 me working on th │ │ │ │ -00003670: 650a 2020 2020 2073 6f6c 7574 696f 6e20 e. solution │ │ │ │ -00003680: 7468 6174 2077 696c 6c20 6e6f 7420 6265 that will not be │ │ │ │ -00003690: 2069 6e74 6567 7261 7465 6420 746f 2047 integrated to G │ │ │ │ -000036a0: 5255 4220 3220 636f 6465 2062 6173 652e RUB 2 code base. │ │ │ │ -000036b0: 0a0a 2020 2020 2059 6f75 206d 6967 6874 .. You might │ │ │ │ -000036c0: 2077 616e 7420 746f 2073 7475 6479 206f want to study o │ │ │ │ -000036d0: 7572 2063 6f64 696e 6720 7374 796c 6520 ur coding style │ │ │ │ -000036e0: 6265 666f 7265 2073 7461 7274 696e 670a before starting. │ │ │ │ -000036f0: 2020 2020 2064 6576 656c 6f70 6d65 6e74 development │ │ │ │ -00003700: 2073 6f20 796f 7520 646f 206e 6f74 206e so you do not n │ │ │ │ -00003710: 6565 6420 746f 2063 6861 6e67 6520 6d75 eed to change mu │ │ │ │ -00003720: 6368 206f 6620 7468 6520 636f 6465 2077 ch of the code w │ │ │ │ -00003730: 6865 6e20 796f 7572 0a20 2020 2020 7061 hen your. pa │ │ │ │ -00003740: 7463 6820 6973 2062 6569 6e67 2072 6576 tch is being rev │ │ │ │ -00003750: 6965 7765 642e 2020 2873 6565 202a 6e6f iewed. (see *no │ │ │ │ -00003760: 7465 2043 6f64 696e 6720 7374 796c 653a te Coding style: │ │ │ │ -00003770: 3a29 0a0a 2020 2020 2046 6f72 2065 7665 :).. For eve │ │ │ │ -00003780: 7279 2061 6363 6570 7465 6420 7061 7463 ry accepted patc │ │ │ │ -00003790: 6820 7468 6572 6520 6861 7320 746f 2065 h there has to e │ │ │ │ -000037a0: 7869 7374 2061 2043 6861 6e67 654c 6f67 xist a ChangeLog │ │ │ │ -000037b0: 2065 6e74 7279 2e20 204f 7572 0a20 2020 entry. Our. │ │ │ │ -000037c0: 2020 4368 616e 6765 4c6f 6720 636f 6e73 ChangeLog cons │ │ │ │ -000037d0: 6973 7420 6f66 2063 6861 6e67 6573 2077 ist of changes w │ │ │ │ -000037e0: 6974 6869 6e20 736f 7572 6365 2063 6f64 ithin source cod │ │ │ │ -000037f0: 6520 616e 6420 6172 6520 6e6f 740a 2020 e and are not. │ │ │ │ -00003800: 2020 2064 6573 6372 6962 696e 6720 6162 describing ab │ │ │ │ -00003810: 6f75 7420 7768 6174 2074 6865 2063 6861 out what the cha │ │ │ │ -00003820: 6e67 6520 6c6f 6769 6361 6c6c 7920 646f nge logically do │ │ │ │ -00003830: 6573 2e20 2050 6c65 6173 6520 7365 650a es. Please see. │ │ │ │ -00003840: 2020 2020 2065 7861 6d70 6c65 7320 6672 examples fr │ │ │ │ -00003850: 6f6d 2070 7265 7669 6f75 7320 656e 7472 om previous entr │ │ │ │ -00003860: 6965 732e 0a0a 2020 2020 2041 6c73 6f20 ies... Also │ │ │ │ -00003870: 7265 6d65 6d62 6572 2074 6861 7420 4752 remember that GR │ │ │ │ -00003880: 5542 2032 2069 7320 6c69 6365 6e73 6564 UB 2 is licensed │ │ │ │ -00003890: 2075 6e64 6572 2047 504c 7633 206c 6963 under GPLv3 lic │ │ │ │ -000038a0: 656e 7365 2061 6e64 2074 6861 740a 2020 ense and that. │ │ │ │ -000038b0: 2020 2075 7375 616c 6c79 206d 6561 6e73 usually means │ │ │ │ -000038c0: 2074 6861 7420 796f 7520 6172 6520 6e6f that you are no │ │ │ │ -000038d0: 7420 616c 6c6f 7765 6420 746f 2063 6f70 t allowed to cop │ │ │ │ -000038e0: 7920 7069 6563 6573 206f 6620 636f 6465 y pieces of code │ │ │ │ -000038f0: 2066 726f 6d0a 2020 2020 206f 7468 6572 from. other │ │ │ │ -00003900: 2070 726f 6a65 6374 732e 2020 4576 656e projects. Even │ │ │ │ -00003910: 2069 6620 7468 6520 736f 7572 6365 2070 if the source p │ │ │ │ -00003920: 726f 6a65 6374 2773 206c 6963 656e 7365 roject's license │ │ │ │ -00003930: 2077 6f75 6c64 2062 650a 2020 2020 2063 would be. c │ │ │ │ -00003940: 6f6d 7061 7469 626c 6520 7769 7468 2047 ompatible with G │ │ │ │ -00003950: 504c 7633 2c20 706c 6561 7365 2064 6973 PLv3, please dis │ │ │ │ -00003960: 6375 7373 2069 7420 6265 666f 7265 6861 cuss it beforeha │ │ │ │ -00003970: 6e64 206f 6e20 6772 7562 2d64 6576 656c nd on grub-devel │ │ │ │ -00003980: 0a20 2020 2020 6d61 696c 696e 6720 6c69 . mailing li │ │ │ │ -00003990: 7374 2e0a 0a20 2020 2a20 5465 7374 2079 st... * Test y │ │ │ │ -000039a0: 6f75 7220 6368 616e 6765 2e0a 0a20 2020 our change... │ │ │ │ -000039b0: 2020 5465 7374 2074 6861 7420 796f 7572 Test that your │ │ │ │ -000039c0: 2063 6861 6e67 6520 776f 726b 7320 7072 change works pr │ │ │ │ -000039d0: 6f70 6572 6c79 2e20 2054 7279 2069 7420 operly. Try it │ │ │ │ -000039e0: 6f75 7420 6120 636f 7570 6c65 206f 660a out a couple of. │ │ │ │ -000039f0: 2020 2020 2074 696d 6573 2c20 7072 6566 times, pref │ │ │ │ -00003a00: 6572 6162 6c79 206f 6e20 6469 6666 6572 erably on differ │ │ │ │ -00003a10: 656e 7420 7379 7374 656d 732c 2061 6e64 ent systems, and │ │ │ │ -00003a20: 2074 7279 2074 6f20 6669 6e64 2070 726f try to find pro │ │ │ │ -00003a30: 626c 656d 730a 2020 2020 2077 6974 6820 blems. with │ │ │ │ -00003a40: 6974 2e0a 0a20 2020 2a20 5075 626c 6973 it... * Publis │ │ │ │ -00003a50: 6820 796f 7572 2063 6861 6e67 652e 0a0a h your change... │ │ │ │ -00003a60: 2020 2020 2057 6865 6e20 796f 7520 6172 When you ar │ │ │ │ -00003a70: 6520 6861 7070 7920 7769 7468 2079 6f75 e happy with you │ │ │ │ -00003a80: 7220 6368 616e 6765 2c20 6669 7273 7420 r change, first │ │ │ │ -00003a90: 6d61 6b65 2073 7572 6520 6974 2069 730a make sure it is. │ │ │ │ -00003aa0: 2020 2020 2063 6f6d 7069 6c61 626c 6520 compilable │ │ │ │ -00003ab0: 7769 7468 206c 6174 6573 7420 6465 7665 with latest deve │ │ │ │ -00003ac0: 6c6f 706d 656e 7420 7665 7273 696f 6e20 lopment version │ │ │ │ -00003ad0: 6f66 2047 5255 4220 322e 2020 4166 7465 of GRUB 2. Afte │ │ │ │ -00003ae0: 7220 7468 6174 0a20 2020 2020 706c 6561 r that. plea │ │ │ │ -00003af0: 7365 2073 656e 6420 6120 7061 7463 6820 se send a patch │ │ │ │ -00003b00: 746f 2067 7275 622d 6465 7665 6c20 666f to grub-devel fo │ │ │ │ -00003b10: 7220 7265 7669 6577 2e20 2050 6c65 6173 r review. Pleas │ │ │ │ -00003b20: 6520 6465 7363 7269 6265 2069 6e0a 2020 e describe in. │ │ │ │ -00003b30: 2020 2079 6f75 7220 656d 6169 6c20 7768 your email wh │ │ │ │ -00003b40: 7920 796f 7520 6d61 6465 2074 6865 2063 y you made the c │ │ │ │ -00003b50: 6861 6e67 652c 2077 6861 7420 6974 2063 hange, what it c │ │ │ │ -00003b60: 6861 6e67 6573 2061 6e64 2073 6f20 6f6e hanges and so on │ │ │ │ -00003b70: 2e0a 2020 2020 2050 6c65 6173 6520 6265 .. Please be │ │ │ │ -00003b80: 2070 7265 7061 7265 6420 746f 2072 6563 prepared to rec │ │ │ │ -00003b90: 6569 7665 2065 7665 6e20 6469 7363 6f75 eive even discou │ │ │ │ -00003ba0: 7261 6769 6e67 2063 6f6d 6d65 6e74 7320 raging comments │ │ │ │ -00003bb0: 6162 6f75 7420 796f 7572 0a20 2020 2020 about your. │ │ │ │ -00003bc0: 7061 7463 682e 2020 5468 6572 6520 6973 patch. There is │ │ │ │ -00003bd0: 2075 7375 616c 6c79 2061 7420 6c65 6173 usually at leas │ │ │ │ -00003be0: 7420 736f 6d65 7468 696e 6720 7468 6174 t something that │ │ │ │ -00003bf0: 206e 6565 6473 2074 6f20 6265 0a20 2020 needs to be. │ │ │ │ -00003c00: 2020 696d 7072 6f76 6564 2069 6e20 6576 improved in ev │ │ │ │ -00003c10: 6572 7920 7061 7463 682e 0a0a 2020 2020 ery patch... │ │ │ │ -00003c20: 2050 6c65 6173 6520 7573 6520 756e 6966 Please use unif │ │ │ │ -00003c30: 6965 6420 6469 6666 2074 6f20 6d61 6b65 ied diff to make │ │ │ │ -00003c40: 2079 6f75 7220 7061 7463 6820 2867 6f6f your patch (goo │ │ │ │ -00003c50: 6420 6d61 7463 6820 6f66 2061 7267 756d d match of argum │ │ │ │ -00003c60: 656e 7473 0a20 2020 2020 666f 7220 6469 ents. for di │ │ │ │ -00003c70: 6666 2069 7320 272d 7072 754e 2729 2e0a ff is '-pruN').. │ │ │ │ -00003c80: 0a20 2020 2a20 5265 7370 6f6e 6420 746f . * Respond to │ │ │ │ -00003c90: 2072 6563 6569 7665 6420 6665 6564 6261 received feedba │ │ │ │ -00003ca0: 636b 2e0a 0a20 2020 2020 4966 2079 6f75 ck... If you │ │ │ │ -00003cb0: 2061 7265 2061 736b 6564 2074 6f20 6d6f are asked to mo │ │ │ │ -00003cc0: 6469 6679 2079 6f75 7220 7061 7463 682c dify your patch, │ │ │ │ -00003cd0: 2070 6c65 6173 6520 646f 2074 6861 7420 please do that │ │ │ │ -00003ce0: 616e 6420 7265 7375 626d 6974 0a20 2020 and resubmit. │ │ │ │ -00003cf0: 2020 6974 2066 6f72 2072 6576 6965 772e it for review. │ │ │ │ -00003d00: 2020 4966 2079 6f75 7220 6368 616e 6765 If your change │ │ │ │ -00003d10: 2069 7320 6c61 7267 6520 796f 7520 6172 is large you ar │ │ │ │ -00003d20: 6520 7265 7175 6972 6564 2074 6f20 7375 e required to su │ │ │ │ -00003d30: 626d 6974 0a20 2020 2020 6120 636f 7079 bmit. a copy │ │ │ │ -00003d40: 7269 6768 7420 6167 7265 656d 656e 7420 right agreement │ │ │ │ -00003d50: 746f 2046 5346 2e20 506c 6561 7365 206b to FSF. Please k │ │ │ │ -00003d60: 6565 7020 696e 206d 696e 6420 7468 6174 eep in mind that │ │ │ │ -00003d70: 2069 6620 796f 7520 6172 650a 2020 2020 if you are. │ │ │ │ -00003d80: 2061 736b 6564 2074 6f20 7375 626d 6974 asked to submit │ │ │ │ -00003d90: 2066 6f72 2063 6f70 7972 6967 6874 2061 for copyright a │ │ │ │ -00003da0: 6772 6565 6d65 6e74 2c20 7072 6f63 6573 greement, proces │ │ │ │ -00003db0: 7320 6361 6e20 7461 6b65 2073 6f6d 6520 s can take some │ │ │ │ -00003dc0: 7469 6d65 0a20 2020 2020 616e 6420 6973 time. and is │ │ │ │ -00003dd0: 206d 616e 6461 746f 7279 2069 6e20 6f72 mandatory in or │ │ │ │ -00003de0: 6465 7220 746f 2067 6574 2079 6f75 7220 der to get your │ │ │ │ -00003df0: 6368 616e 6765 7320 696e 7465 6772 6174 changes integrat │ │ │ │ -00003e00: 6564 2e0a 0a20 2020 2020 4966 2079 6f75 ed... If you │ │ │ │ -00003e10: 2061 7265 206e 6f74 206f 6e20 6772 7562 are not on grub │ │ │ │ -00003e20: 2d64 6576 656c 2074 6f20 7265 7370 6f6e -devel to respon │ │ │ │ -00003e30: 6420 746f 2071 7565 7374 696f 6e73 2c20 d to questions, │ │ │ │ -00003e40: 6d6f 7374 206c 696b 656c 790a 2020 2020 most likely. │ │ │ │ -00003e50: 2079 6f75 7220 7061 7463 6820 7769 6c6c your patch will │ │ │ │ -00003e60: 206e 6f74 2062 6520 6163 6365 7074 6564 not be accepted │ │ │ │ -00003e70: 2e20 2041 6c73 6f20 6966 2070 726f 626c . Also if probl │ │ │ │ -00003e80: 656d 7320 6172 6973 6520 6672 6f6d 2079 ems arise from y │ │ │ │ -00003e90: 6f75 720a 2020 2020 2063 6861 6e67 6573 our. changes │ │ │ │ -00003ea0: 206c 6174 6572 206f 6e2c 2069 7420 776f later on, it wo │ │ │ │ -00003eb0: 756c 6420 6265 2070 7265 6665 7261 626c uld be preferabl │ │ │ │ -00003ec0: 6520 7468 6174 2079 6f75 2061 6c73 6f20 e that you also │ │ │ │ -00003ed0: 6669 7820 7468 650a 2020 2020 2070 726f fix the. pro │ │ │ │ -00003ee0: 626c 656d 2e20 2053 6f20 7374 6179 2061 blem. So stay a │ │ │ │ -00003ef0: 726f 756e 6420 666f 7220 6120 7768 696c round for a whil │ │ │ │ -00003f00: 652e 0a0a 2020 202a 2059 6f75 7220 7061 e... * Your pa │ │ │ │ -00003f10: 7463 6820 6973 2061 6363 6570 7465 642e tch is accepted. │ │ │ │ -00003f20: 0a0a 2020 2020 2047 6f6f 6420 6a6f 6221 .. Good job! │ │ │ │ -00003f30: 2020 596f 7572 2070 6174 6368 2077 696c Your patch wil │ │ │ │ -00003f40: 6c20 6e6f 7720 6265 2069 6e74 6567 7261 l now be integra │ │ │ │ -00003f50: 7465 6420 696e 746f 2047 5255 4220 3220 ted into GRUB 2 │ │ │ │ -00003f60: 6d61 696e 6c69 6e65 2c0a 2020 2020 2061 mainline,. a │ │ │ │ -00003f70: 6e64 2069 6620 6974 2064 6964 6e27 7420 nd if it didn't │ │ │ │ -00003f80: 6272 6561 6b20 616e 7974 6869 6e67 2069 break anything i │ │ │ │ -00003f90: 7420 7769 6c6c 2062 6520 7075 626c 6963 t will be public │ │ │ │ -00003fa0: 6c79 2061 7661 696c 6162 6c65 2069 6e0a ly available in. │ │ │ │ -00003fb0: 2020 2020 2074 6865 206e 6578 7420 7265 the next re │ │ │ │ -00003fc0: 6c65 6173 652e 0a0a 2020 2020 204e 6f77 lease... Now │ │ │ │ -00003fd0: 2079 6f75 2061 7265 2077 656c 636f 6d65 you are welcome │ │ │ │ -00003fe0: 2074 6f20 646f 2066 7572 7468 6572 2069 to do further i │ │ │ │ -00003ff0: 6d70 726f 7665 6d65 6e74 7320 3a29 0a0a mprovements :).. │ │ │ │ -00004000: 1f0a 4669 6c65 3a20 6772 7562 2d64 6576 ..File: grub-dev │ │ │ │ -00004010: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 5479 .info, Node: Ty │ │ │ │ -00004020: 7069 6361 6c20 4465 7665 6c6f 7065 7220 pical Developer │ │ │ │ -00004030: 4578 7065 7269 656e 6365 2c20 204e 6578 Experience, Nex │ │ │ │ -00004040: 743a 2057 6865 6e20 796f 7520 6172 6520 t: When you are │ │ │ │ -00004050: 6170 7072 6f76 6564 2066 6f72 2077 7269 approved for wri │ │ │ │ -00004060: 7465 2061 6363 6573 7320 746f 2070 726f te access to pro │ │ │ │ -00004070: 6a65 6374 2773 2066 696c 6573 2c20 2050 ject's files, P │ │ │ │ -00004080: 7265 763a 2047 6574 7469 6e67 2073 7461 rev: Getting sta │ │ │ │ -00004090: 7274 6564 2c20 2055 703a 2043 6f6e 7472 rted, Up: Contr │ │ │ │ -000040a0: 6962 7574 696e 6720 4368 616e 6765 730a ibuting Changes. │ │ │ │ -000040b0: 0a34 2e32 2054 7970 6963 616c 2044 6576 .4.2 Typical Dev │ │ │ │ -000040c0: 656c 6f70 6572 2045 7870 6572 6965 6e63 eloper Experienc │ │ │ │ -000040d0: 650a 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d e.============== │ │ │ │ +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.******** │ │ │ │ +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.========== │ │ │ │ 000040e0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ -000040f0: 3d3d 0a0a 5468 6520 7479 7069 6361 6c20 ==..The typical │ │ │ │ -00004100: 6578 7065 7269 656e 6365 2066 6f72 2061 experience for a │ │ │ │ -00004110: 2064 6576 656c 6f70 6572 2069 6e20 7468 developer in th │ │ │ │ -00004120: 6973 2070 726f 6a65 6374 2069 7320 7468 is project is th │ │ │ │ -00004130: 6520 666f 6c6c 6f77 696e 673a 0a0a 2020 e following:.. │ │ │ │ -00004140: 312e 2059 6f75 2066 696e 6420 796f 7572 1. You find your │ │ │ │ -00004150: 7365 6c66 2077 616e 7469 6e67 2074 6f20 self wanting to │ │ │ │ -00004160: 646f 2073 6f6d 6574 6869 6e67 2028 652e do something (e. │ │ │ │ -00004170: 672e 2020 6669 7869 6e67 2061 2062 7567 g. fixing a bug │ │ │ │ -00004180: 292e 0a20 2032 2e20 596f 7520 7368 6f77 ).. 2. You show │ │ │ │ -00004190: 2073 6f6d 6520 7265 7375 6c74 2069 6e20 some result in │ │ │ │ -000041a0: 7468 6520 6d61 696c 696e 6720 6c69 7374 the mailing list │ │ │ │ -000041b0: 206f 7220 7468 6520 4952 432e 0a20 2033 or the IRC.. 3 │ │ │ │ -000041c0: 2e20 596f 7520 6172 6520 6765 7474 696e . You are gettin │ │ │ │ -000041d0: 6720 746f 2062 6520 6b6e 6f77 6e20 746f g to be known to │ │ │ │ -000041e0: 206f 7468 6572 2064 6576 656c 6f70 6572 other developer │ │ │ │ -000041f0: 732e 0a20 2034 2e20 596f 7520 6163 6375 s.. 4. You accu │ │ │ │ -00004200: 6d75 6c61 7465 2073 6967 6e69 6669 6361 mulate significa │ │ │ │ -00004210: 6e74 2061 6d6f 756e 7420 6f66 2063 6f6e nt amount of con │ │ │ │ -00004220: 7472 6962 7574 696f 6e2c 2073 6f20 636f tribution, so co │ │ │ │ -00004230: 7079 7269 6768 740a 2020 2020 2061 7373 pyright. ass │ │ │ │ -00004240: 6967 6e6d 656e 7420 6973 2070 726f 6365 ignment is proce │ │ │ │ -00004250: 7373 6564 2e0a 2020 352e 2059 6f75 2061 ssed.. 5. You a │ │ │ │ -00004260: 7265 2066 7265 6520 746f 2063 6865 636b re free to check │ │ │ │ -00004270: 2069 6e20 796f 7572 2063 6861 6e67 6573 in your changes │ │ │ │ -00004280: 206f 6e20 796f 7572 206f 776e 2c20 6c65 on your own, le │ │ │ │ -00004290: 6761 6c6c 790a 2020 2020 2073 7065 616b gally. speak │ │ │ │ -000042a0: 696e 672e 0a0a 2020 2041 7420 7468 6973 ing... At this │ │ │ │ -000042b0: 2070 6f69 6e74 2c20 6974 2069 7320 7261 point, it is ra │ │ │ │ -000042c0: 7468 6572 2061 6e6e 6f79 696e 6720 7468 ther annoying th │ │ │ │ -000042d0: 6174 2079 6f75 206f 7567 6874 2074 6f20 at you ought to │ │ │ │ -000042e0: 6173 6b20 736f 6d65 626f 6479 0a65 6c73 ask somebody.els │ │ │ │ -000042f0: 6520 6576 6572 7920 6368 616e 6765 2074 e every change t │ │ │ │ -00004300: 6f20 6265 2063 6865 636b 6564 2069 6e2e o be checked in. │ │ │ │ -00004310: 2020 466f 7220 6566 6669 6369 656e 6379 For efficiency │ │ │ │ -00004320: 2c20 6974 2069 7320 6661 7220 6265 7474 , it is far bett │ │ │ │ -00004330: 6572 2c0a 6966 2079 6f75 2063 616e 2063 er,.if you can c │ │ │ │ -00004340: 6f6d 6d69 7420 6974 2079 6f75 7273 656c ommit it yoursel │ │ │ │ -00004350: 662e 2020 5468 6572 6566 6f72 652c 206f f. Therefore, o │ │ │ │ -00004360: 7572 2070 6f6c 6963 7920 6973 2074 6f20 ur policy is to │ │ │ │ -00004370: 6769 7665 2079 6f75 2074 6865 0a77 7269 give you the.wri │ │ │ │ -00004380: 7465 2070 6572 6d69 7373 696f 6e20 746f te permission to │ │ │ │ -00004390: 206f 7572 206f 6666 6963 6961 6c20 7265 our official re │ │ │ │ -000043a0: 706f 7369 746f 7279 2c20 6f6e 6365 2079 pository, once y │ │ │ │ -000043b0: 6f75 2068 6176 6520 7368 6f77 6e20 796f ou have shown yo │ │ │ │ -000043c0: 7572 0a73 6b69 6c6c 2061 6e64 2077 696c ur.skill and wil │ │ │ │ -000043d0: 6c2c 2061 6e64 2074 6865 2046 5346 2063 l, and the FSF c │ │ │ │ -000043e0: 6c65 726b 7320 6861 7665 2064 6561 6c74 lerks have dealt │ │ │ │ -000043f0: 2077 6974 6820 796f 7572 2063 6f70 7972 with your copyr │ │ │ │ -00004400: 6967 6874 0a61 7373 6967 6e6d 656e 742e ight.assignment. │ │ │ │ -00004410: 0a0a 1f0a 4669 6c65 3a20 6772 7562 2d64 ....File: grub-d │ │ │ │ -00004420: 6576 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ev.info, Node: │ │ │ │ -00004430: 5768 656e 2079 6f75 2061 7265 2061 7070 When you are app │ │ │ │ -00004440: 726f 7665 6420 666f 7220 7772 6974 6520 roved for write │ │ │ │ -00004450: 6163 6365 7373 2074 6f20 7072 6f6a 6563 access to projec │ │ │ │ -00004460: 7427 7320 6669 6c65 732c 2020 5072 6576 t's files, Prev │ │ │ │ -00004470: 3a20 5479 7069 6361 6c20 4465 7665 6c6f : Typical Develo │ │ │ │ -00004480: 7065 7220 4578 7065 7269 656e 6365 2c20 per Experience, │ │ │ │ -00004490: 2055 703a 2043 6f6e 7472 6962 7574 696e Up: Contributin │ │ │ │ -000044a0: 6720 4368 616e 6765 730a 0a34 2e33 2057 g Changes..4.3 W │ │ │ │ -000044b0: 6865 6e20 796f 7520 6172 6520 6170 7072 hen you are appr │ │ │ │ -000044c0: 6f76 6564 2066 6f72 2077 7269 7465 2061 oved for write a │ │ │ │ -000044d0: 6363 6573 7320 746f 2070 726f 6a65 6374 ccess to project │ │ │ │ -000044e0: 2773 2066 696c 6573 0a3d 3d3d 3d3d 3d3d 's files.======= │ │ │ │ +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.=== │ │ │ │ 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 0a0a 4173 2079 6f75 206d ======..As you m │ │ │ │ -00004530: 6967 6874 206b 6e6f 772c 2047 5255 4220 ight know, GRUB │ │ │ │ -00004540: 6973 2068 6f73 7465 6420 6f6e 0a3c 6874 is hosted on., │ │ │ │ -00004580: 7468 7573 2074 6865 206d 656d 6265 7273 thus the members │ │ │ │ -00004590: 6869 700a 6973 206d 616e 6167 6564 2062 hip.is managed b │ │ │ │ -000045a0: 7920 5361 7661 6e6e 6168 2e20 2054 6869 y Savannah. Thi │ │ │ │ -000045b0: 7320 6d65 616e 7320 7468 6174 2c20 6966 s means that, if │ │ │ │ -000045c0: 2079 6f75 2077 616e 7420 746f 2062 6520 you want to be │ │ │ │ -000045d0: 6120 6d65 6d62 6572 206f 660a 7468 6973 a member of.this │ │ │ │ -000045e0: 2070 726f 6a65 6374 3a0a 0a20 2031 2e20 project:.. 1. │ │ │ │ -000045f0: 596f 7520 6e65 6564 2074 6f20 6372 6561 You need to crea │ │ │ │ -00004600: 7465 2079 6f75 7220 6f77 6e20 6163 636f te your own acco │ │ │ │ -00004610: 756e 7420 6f6e 2053 6176 616e 6e61 682e unt on Savannah. │ │ │ │ -00004620: 0a20 2032 2e20 596f 7520 6361 6e20 7375 . 2. You can su │ │ │ │ -00004630: 626d 6974 2022 5265 7175 6573 7420 666f bmit "Request fo │ │ │ │ -00004640: 7220 496e 636c 7573 696f 6e22 2066 726f r Inclusion" fro │ │ │ │ -00004650: 6d20 224d 7920 4772 6f75 7073 2220 6f6e m "My Groups" on │ │ │ │ -00004660: 0a20 2020 2020 5361 7661 6e6e 6168 2e0a . Savannah.. │ │ │ │ -00004670: 0a20 2020 5468 656e 2c20 6f6e 6520 6f66 . Then, one of │ │ │ │ -00004680: 2074 6865 2061 646d 696e 7320 6361 6e20 the admins can │ │ │ │ -00004690: 6170 7072 6f76 6520 796f 7572 2072 6571 approve your req │ │ │ │ -000046a0: 7565 7374 2c20 616e 6420 796f 7520 7769 uest, and you wi │ │ │ │ -000046b0: 6c6c 2062 6520 610a 6d65 6d62 6572 2e20 ll be a.member. │ │ │ │ -000046c0: 2049 6620 796f 7520 646f 6e27 7420 7761 If you don't wa │ │ │ │ -000046d0: 6e74 2074 6f20 7573 6520 7468 6520 5361 nt to use the Sa │ │ │ │ -000046e0: 7661 6e6e 6168 2069 6e74 6572 6661 6365 vannah interface │ │ │ │ -000046f0: 2074 6f20 7375 626d 6974 2061 0a72 6571 to submit a.req │ │ │ │ -00004700: 7565 7374 2c20 796f 7520 6361 6e20 7369 uest, you can si │ │ │ │ -00004710: 6d70 6c79 206e 6f74 6966 7920 7468 6520 mply notify the │ │ │ │ -00004720: 6164 6d69 6e73 2062 7920 656d 6169 6c20 admins by email │ │ │ │ -00004730: 6f72 2073 6f6d 6574 6869 6e67 2065 6c73 or something els │ │ │ │ -00004740: 652c 0a61 6c74 6572 6e61 7469 7665 6c79 e,.alternatively │ │ │ │ -00004750: 2e20 2042 7574 2079 6f75 2073 7469 6c6c . But you still │ │ │ │ -00004760: 206e 6565 6420 746f 2063 7265 6174 6520 need to create │ │ │ │ -00004770: 616e 2061 6363 6f75 6e74 2062 6566 6f72 an account befor │ │ │ │ -00004780: 6568 616e 642e 0a0a 2020 204e 4f54 453a ehand... NOTE: │ │ │ │ -00004790: 2077 6520 736f 6d65 7469 6d65 7320 7265 we sometimes re │ │ │ │ -000047a0: 6365 6976 6520 6120 2252 6571 7565 7374 ceive a "Request │ │ │ │ -000047b0: 2066 6f72 2049 6e63 6c75 7369 6f6e 2220 for Inclusion" │ │ │ │ -000047c0: 6672 6f6d 2061 6e20 756e 6b6e 6f77 6e0a from an unknown. │ │ │ │ -000047d0: 7065 7273 6f6e 2e20 2049 6e20 7468 6973 person. In this │ │ │ │ -000047e0: 2063 6173 652c 2074 6865 2072 6571 7565 case, the reque │ │ │ │ -000047f0: 7374 2077 6f75 6c64 2062 6520 6a75 7374 st would be just │ │ │ │ -00004800: 2064 6973 6361 7264 6564 2c20 7369 6e63 discarded, sinc │ │ │ │ -00004810: 6520 6974 2069 730a 746f 6f20 6461 6e67 e it is.too dang │ │ │ │ -00004820: 6572 6f75 7320 746f 2061 6c6c 6f77 2061 erous to allow a │ │ │ │ -00004830: 2073 7472 616e 6765 7220 746f 2062 6520 stranger to be │ │ │ │ -00004840: 6120 6d65 6d62 6572 2c20 7768 6963 6820 a member, which │ │ │ │ -00004850: 6175 746f 6d61 7469 6361 6c6c 790a 6769 automatically.gi │ │ │ │ -00004860: 7665 7320 6869 6d20 6120 636f 6d6d 6974 ves him a commit │ │ │ │ -00004870: 2072 6967 6874 2074 6f20 7468 6520 7265 right to the re │ │ │ │ -00004880: 706f 7369 746f 7279 2c20 626f 7468 2066 pository, both f │ │ │ │ -00004890: 6f72 2061 206c 6567 616c 2072 6561 736f or a legal reaso │ │ │ │ -000048a0: 6e20 616e 640a 666f 7220 6120 7465 6368 n and.for a tech │ │ │ │ -000048b0: 6e69 6361 6c20 7265 6173 6f6e 2e0a 0a20 nical reason... │ │ │ │ -000048c0: 2020 4966 2079 6f75 7220 696e 7465 6e74 If your intent │ │ │ │ -000048d0: 696f 6e20 6973 2074 6f20 6a75 7374 2067 ion is to just g │ │ │ │ -000048e0: 6574 2073 7461 7274 6564 2c20 706c 6561 et started, plea │ │ │ │ -000048f0: 7365 2064 6f20 6e6f 7420 7375 626d 6974 se do not submit │ │ │ │ -00004900: 2061 0a69 6e63 6c75 7369 6f6e 2072 6571 a.inclusion req │ │ │ │ -00004910: 7565 7374 2e20 2049 6e73 7465 6164 2c20 uest. Instead, │ │ │ │ -00004920: 706c 6561 7365 2073 7562 7363 7269 6265 please subscribe │ │ │ │ -00004930: 2074 6f20 7468 6520 6d61 696c 696e 6720 to the mailing │ │ │ │ -00004940: 6c69 7374 2c20 616e 640a 636f 6d6d 756e list, and.commun │ │ │ │ -00004950: 6963 6174 6520 6669 7273 7420 2865 2e67 icate first (e.g │ │ │ │ -00004960: 2e20 2073 656e 6469 6e67 2061 2070 6174 . sending a pat │ │ │ │ -00004970: 6368 2c20 6173 6b69 6e67 2061 2071 7565 ch, asking a que │ │ │ │ -00004980: 7374 696f 6e2c 2063 6f6d 6d65 6e74 696e stion, commentin │ │ │ │ -00004990: 670a 6f6e 2061 6e6f 7468 6572 206d 6573 g.on another mes │ │ │ │ -000049a0: 7361 6765 2e2e 2e29 2e0a 0a1f 0a46 696c sage...).....Fil │ │ │ │ -000049b0: 653a 2067 7275 622d 6465 762e 696e 666f e: grub-dev.info │ │ │ │ -000049c0: 2c20 204e 6f64 653a 2055 7064 6174 696e , Node: Updatin │ │ │ │ -000049d0: 6720 4578 7465 726e 616c 2043 6f64 652c g External Code, │ │ │ │ -000049e0: 2020 4e65 7874 3a20 506f 7274 696e 672c Next: Porting, │ │ │ │ -000049f0: 2020 5072 6576 3a20 436f 6e74 7269 6275 Prev: Contribu │ │ │ │ -00004a00: 7469 6e67 2043 6861 6e67 6573 2c20 2055 ting Changes, U │ │ │ │ -00004a10: 703a 2054 6f70 0a0a 3520 5570 6461 7469 p: Top..5 Updati │ │ │ │ -00004a20: 6e67 2065 7874 6572 6e61 6c20 636f 6465 ng external code │ │ │ │ -00004a30: 0a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a .*************** │ │ │ │ -00004a40: 2a2a 2a2a 2a2a 2a2a 2a0a 0a47 5255 4220 *********..GRUB │ │ │ │ -00004a50: 696e 636c 7564 6573 2073 6f6d 6520 636f includes some co │ │ │ │ -00004a60: 6465 2066 726f 6d20 6f74 6865 7220 7072 de from other pr │ │ │ │ -00004a70: 6f6a 6563 7473 2c20 616e 6420 6974 2069 ojects, and it i │ │ │ │ -00004a80: 7320 736f 6d65 7469 6d65 730a 6e65 6365 s sometimes.nece │ │ │ │ -00004a90: 7373 6172 7920 746f 2075 7064 6174 6520 ssary to update │ │ │ │ -00004aa0: 6974 2e0a 0a2a 204d 656e 753a 0a0a 2a20 it...* Menu:..* │ │ │ │ -00004ab0: 476e 756c 6962 3a3a 0a0a 1f0a 4669 6c65 Gnulib::....File │ │ │ │ -00004ac0: 3a20 6772 7562 2d64 6576 2e69 6e66 6f2c : grub-dev.info, │ │ │ │ -00004ad0: 2020 4e6f 6465 3a20 476e 756c 6962 2c20 Node: Gnulib, │ │ │ │ -00004ae0: 2055 703a 2055 7064 6174 696e 6720 4578 Up: Updating Ex │ │ │ │ -00004af0: 7465 726e 616c 2043 6f64 650a 0a35 2e31 ternal Code..5.1 │ │ │ │ -00004b00: 2047 6e75 6c69 620a 3d3d 3d3d 3d3d 3d3d Gnulib.======== │ │ │ │ -00004b10: 3d3d 0a0a 476e 756c 6962 2069 7320 6120 ==..Gnulib is a │ │ │ │ -00004b20: 736f 7572 6365 2063 6f64 6520 6c69 6272 source code libr │ │ │ │ -00004b30: 6172 7920 7468 6174 2070 726f 7669 6465 ary that provide │ │ │ │ -00004b40: 7320 6261 7369 6320 6675 6e63 7469 6f6e s basic function │ │ │ │ -00004b50: 616c 6974 7920 746f 0a70 726f 6772 616d ality to.program │ │ │ │ -00004b60: 7320 616e 6420 6c69 6272 6172 6965 732e s and libraries. │ │ │ │ -00004b70: 2020 4d61 6e79 2073 6f66 7477 6172 6520 Many software │ │ │ │ -00004b80: 7061 636b 6167 6573 206d 616b 6520 7573 packages make us │ │ │ │ -00004b90: 6520 6f66 2047 6e75 6c69 6220 746f 0a61 e of Gnulib to.a │ │ │ │ -00004ba0: 766f 6964 2072 6569 6e76 656e 7469 6e67 void reinventing │ │ │ │ -00004bb0: 2074 6865 2070 6f72 7461 6269 6c69 7479 the portability │ │ │ │ -00004bc0: 2077 6865 656c 2e0a 0a20 2020 4752 5542 wheel... GRUB │ │ │ │ -00004bd0: 2069 6d70 6f72 7473 2047 6e75 6c69 6220 imports Gnulib │ │ │ │ -00004be0: 7573 696e 6720 6974 7320 2762 6f6f 7473 using its 'boots │ │ │ │ -00004bf0: 7472 6170 2720 7574 696c 6974 792c 2069 trap' utility, i │ │ │ │ -00004c00: 6465 6e74 6966 7969 6e67 2061 0a70 6172 dentifying a.par │ │ │ │ -00004c10: 7469 6375 6c61 7220 4769 7420 636f 6d6d ticular Git comm │ │ │ │ -00004c20: 6974 2069 6e20 2762 6f6f 7473 7472 6170 it in 'bootstrap │ │ │ │ -00004c30: 2e63 6f6e 6627 2e20 2054 6f20 7570 6772 .conf'. To upgr │ │ │ │ -00004c40: 6164 6520 746f 2061 206e 6577 2047 6e75 ade to a new Gnu │ │ │ │ -00004c50: 6c69 620a 636f 6d6d 6974 2c20 7365 7420 lib.commit, set │ │ │ │ -00004c60: 2747 4e55 4c49 425f 5245 5649 5349 4f4e 'GNULIB_REVISION │ │ │ │ -00004c70: 2720 696e 2027 626f 6f74 7374 7261 702e ' in 'bootstrap. │ │ │ │ -00004c80: 636f 6e66 2720 746f 2074 6865 206e 6577 conf' to the new │ │ │ │ -00004c90: 2063 6f6d 6d69 7420 4944 2c0a 7468 656e commit ID,.then │ │ │ │ -00004ca0: 2072 756e 2027 2e2f 626f 6f74 7374 7261 run './bootstra │ │ │ │ -00004cb0: 7027 2061 6e64 2077 6861 7465 7665 7220 p' and whatever │ │ │ │ -00004cc0: 656c 7365 2079 6f75 206e 6565 6420 746f else you need to │ │ │ │ -00004cd0: 206d 616b 6520 7375 7265 2069 7420 776f make sure it wo │ │ │ │ -00004ce0: 726b 732e 0a43 6865 636b 2066 6f72 2063 rks..Check for c │ │ │ │ -00004cf0: 6861 6e67 6573 2074 6f20 476e 756c 6962 hanges to Gnulib │ │ │ │ -00004d00: 2773 2027 4e45 5753 2720 6669 6c65 2062 's 'NEWS' file b │ │ │ │ -00004d10: 6574 7765 656e 2074 6865 206f 6c64 2061 etween the old a │ │ │ │ -00004d20: 6e64 206e 6577 0a63 6f6d 6d69 7473 3b20 nd new.commits; │ │ │ │ -00004d30: 696e 2073 6f6d 6520 6361 7365 7320 6974 in some cases it │ │ │ │ -00004d40: 2077 696c 6c20 6265 206e 6563 6573 7361 will be necessa │ │ │ │ -00004d50: 7279 2074 6f20 6164 6a75 7374 2047 5255 ry to adjust GRU │ │ │ │ -00004d60: 4220 746f 206d 6174 6368 2e0a 596f 7520 B to match..You │ │ │ │ -00004d70: 6d61 7920 616c 736f 206e 6565 6420 746f may also need to │ │ │ │ -00004d80: 2075 7064 6174 6520 7468 6520 7061 7463 update the patc │ │ │ │ -00004d90: 6865 7320 696e 0a27 6772 7562 2d63 6f72 hes in.'grub-cor │ │ │ │ -00004da0: 652f 6c69 622f 676e 756c 6962 2d70 6174 e/lib/gnulib-pat │ │ │ │ -00004db0: 6368 6573 2f27 2e0a 0a20 2020 546f 2061 ches/'... To a │ │ │ │ -00004dc0: 6464 2061 206e 6577 2047 6e75 6c69 6220 dd a new Gnulib │ │ │ │ -00004dd0: 6d6f 6475 6c65 206f 7220 7265 6d6f 7665 module or remove │ │ │ │ -00004de0: 206f 6e65 2074 6861 7420 6973 206e 6f20 one that is no │ │ │ │ -00004df0: 6c6f 6e67 6572 206e 6565 6465 642c 0a63 longer needed,.c │ │ │ │ -00004e00: 6861 6e67 6520 2767 6e75 6c69 625f 6d6f hange 'gnulib_mo │ │ │ │ -00004e10: 6475 6c65 7327 2069 6e20 2762 6f6f 7473 dules' in 'boots │ │ │ │ -00004e20: 7472 6170 2e63 6f6e 6627 2e20 2041 6761 trap.conf'. Aga │ │ │ │ -00004e30: 696e 2c20 7275 6e20 272e 2f62 6f6f 7473 in, run './boots │ │ │ │ -00004e40: 7472 6170 270a 616e 6420 7768 6174 6576 trap'.and whatev │ │ │ │ -00004e50: 6572 2065 6c73 6520 796f 7520 6e65 6564 er else you need │ │ │ │ -00004e60: 2074 6f20 6d61 6b65 2073 7572 6520 6974 to make sure it │ │ │ │ -00004e70: 2077 6f72 6b73 2e0a 0a20 2020 426f 6f74 works... Boot │ │ │ │ -00004e80: 7374 7261 7070 696e 6720 6672 6f6d 2061 strapping from a │ │ │ │ -00004e90: 6e20 6f6c 6465 7220 6469 7374 7269 6275 n older distribu │ │ │ │ -00004ea0: 7469 6f6e 2063 6f6e 7461 696e 696e 6720 tion containing │ │ │ │ -00004eb0: 6765 7474 6578 7420 7665 7273 696f 6e20 gettext version │ │ │ │ -00004ec0: 3c0a 302e 3138 2e33 2c20 7769 6c6c 2072 <.0.18.3, will r │ │ │ │ -00004ed0: 6571 7569 7265 2061 2070 6174 6368 2073 equire a patch s │ │ │ │ -00004ee0: 696d 696c 6172 2074 6f20 7468 6973 2074 imilar to this t │ │ │ │ -00004ef0: 6f20 6265 2061 7070 6c69 6564 2066 6972 o be applied fir │ │ │ │ -00004f00: 7374 2062 6566 6f72 650a 7275 6e6e 696e st before.runnin │ │ │ │ -00004f10: 6720 7468 6520 272e 2f62 6f6f 7473 7472 g the './bootstr │ │ │ │ -00004f20: 6170 2720 7574 696c 6974 793a 0a0a 2020 ap' utility:.. │ │ │ │ -00004f30: 2020 2064 6966 6620 2d2d 6769 7420 612f diff --git a/ │ │ │ │ -00004f40: 626f 6f74 7374 7261 702e 636f 6e66 2062 bootstrap.conf b │ │ │ │ -00004f50: 2f62 6f6f 7473 7472 6170 2e63 6f6e 660a /bootstrap.conf. │ │ │ │ -00004f60: 2020 2020 2069 6e64 6578 2039 3838 6464 index 988dd │ │ │ │ -00004f70: 6130 2e2e 6133 3139 3361 3920 3130 3036 a0..a3193a9 1006 │ │ │ │ -00004f80: 3434 0a20 2020 2020 2d2d 2d20 612f 626f 44. --- a/bo │ │ │ │ -00004f90: 6f74 7374 7261 702e 636f 6e66 0a20 2020 otstrap.conf. │ │ │ │ -00004fa0: 2020 2b2b 2b20 622f 626f 6f74 7374 7261 +++ b/bootstra │ │ │ │ -00004fb0: 702e 636f 6e66 0a20 2020 2020 4020 2d36 p.conf. @ -6 │ │ │ │ -00004fc0: 372c 3720 2b36 372c 3720 4020 534b 4950 7,7 +67,7 @ SKIP │ │ │ │ -00004fd0: 5f50 4f3d 740a 2020 2020 2062 7569 6c64 _PO=t. build │ │ │ │ -00004fe0: 7265 713d 225c 0a20 2020 2020 6175 746f req="\. auto │ │ │ │ -00004ff0: 636f 6e66 2020 2032 2e36 330a 2020 2020 conf 2.63. │ │ │ │ -00005000: 2061 7574 6f6d 616b 6520 2020 312e 3131 automake 1.11 │ │ │ │ -00005010: 0a20 2020 2020 2d67 6574 7465 7874 2020 . -gettext │ │ │ │ -00005020: 2020 302e 3138 2e33 0a20 2020 2020 2b67 0.18.3. +g │ │ │ │ -00005030: 6574 7465 7874 2020 2020 302e 3137 0a20 ettext 0.17. │ │ │ │ -00005040: 2020 2020 6769 7420 2020 2020 2020 2031 git 1 │ │ │ │ -00005050: 2e35 2e35 0a20 2020 2020 7461 7220 2020 .5.5. tar │ │ │ │ -00005060: 2020 2020 202d 0a20 2020 2020 220a 2020 -. ". │ │ │ │ -00005070: 2020 2064 6966 6620 2d2d 6769 7420 612f diff --git a/ │ │ │ │ -00005080: 636f 6e66 6967 7572 652e 6163 2062 2f63 configure.ac b/c │ │ │ │ -00005090: 6f6e 6669 6775 7265 2e61 630a 2020 2020 onfigure.ac. │ │ │ │ -000050a0: 2069 6e64 6578 2030 3862 3531 3866 2e2e index 08b518f.. │ │ │ │ -000050b0: 3939 6635 6233 3620 3130 3036 3434 0a20 99f5b36 100644. │ │ │ │ -000050c0: 2020 2020 2d2d 2d20 612f 636f 6e66 6967 --- a/config │ │ │ │ -000050d0: 7572 652e 6163 0a20 2020 2020 2b2b 2b20 ure.ac. +++ │ │ │ │ -000050e0: 622f 636f 6e66 6967 7572 652e 6163 0a20 b/configure.ac. │ │ │ │ -000050f0: 2020 2020 4020 2d33 3632 2c37 202b 3336 @ -362,7 +36 │ │ │ │ -00005100: 322c 3720 4020 4143 5f43 4845 434b 5f50 2,7 @ AC_CHECK_P │ │ │ │ -00005110: 524f 4728 4841 5645 5f43 5858 2c20 2443 ROG(HAVE_CXX, $C │ │ │ │ -00005120: 5858 2c20 7965 732c 206e 6f29 0a0a 2020 XX, yes, no).. │ │ │ │ -00005130: 2020 2041 435f 474e 555f 534f 5552 4345 AC_GNU_SOURCE │ │ │ │ -00005140: 0a20 2020 2020 414d 5f47 4e55 5f47 4554 . AM_GNU_GET │ │ │ │ -00005150: 5445 5854 285b 6578 7465 726e 616c 5d29 TEXT([external]) │ │ │ │ -00005160: 0a20 2020 2020 2d41 4d5f 474e 555f 4745 . -AM_GNU_GE │ │ │ │ -00005170: 5454 4558 545f 5645 5253 494f 4e28 5b30 TTEXT_VERSION([0 │ │ │ │ -00005180: 2e31 382e 335d 290a 2020 2020 202b 414d .18.3]). +AM │ │ │ │ -00005190: 5f47 4e55 5f47 4554 5445 5854 5f56 4552 _GNU_GETTEXT_VER │ │ │ │ -000051a0: 5349 4f4e 285b 302e 3137 5d29 0a20 2020 SION([0.17]). │ │ │ │ -000051b0: 2020 4143 5f53 5953 5f4c 4152 4745 4649 AC_SYS_LARGEFI │ │ │ │ -000051c0: 4c45 0a0a 2020 2020 2023 2049 6465 6e74 LE.. # Ident │ │ │ │ -000051d0: 6966 7920 6368 6172 6163 7465 7269 7374 ify characterist │ │ │ │ -000051e0: 6963 7320 6f66 2074 6865 2068 6f73 7420 ics of the host │ │ │ │ -000051f0: 6172 6368 6974 6563 7475 7265 2e0a 0a0a architecture.... │ │ │ │ -00005200: 1f0a 4669 6c65 3a20 6772 7562 2d64 6576 ..File: grub-dev │ │ │ │ -00005210: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 506f .info, Node: Po │ │ │ │ -00005220: 7274 696e 672c 2020 4e65 7874 3a20 4572 rting, Next: Er │ │ │ │ -00005230: 726f 7220 4861 6e64 6c69 6e67 2c20 2050 ror Handling, P │ │ │ │ -00005240: 7265 763a 2055 7064 6174 696e 6720 4578 rev: Updating Ex │ │ │ │ -00005250: 7465 726e 616c 2043 6f64 652c 2020 5570 ternal Code, Up │ │ │ │ -00005260: 3a20 546f 700a 0a36 2050 6f72 7469 6e67 : Top..6 Porting │ │ │ │ -00005270: 0a2a 2a2a 2a2a 2a2a 2a2a 0a0a 4752 5542 .*********..GRUB │ │ │ │ -00005280: 3220 6973 2064 6573 6967 6e65 6420 746f 2 is designed to │ │ │ │ -00005290: 2062 6520 6561 7369 6c79 2070 6f72 7461 be easily porta │ │ │ │ -000052a0: 626c 6520 6163 6372 6f73 7320 706c 6174 ble accross plat │ │ │ │ -000052b0: 666f 726d 732e 2020 4275 7420 6265 6361 forms. But beca │ │ │ │ -000052c0: 7573 650a 6f66 2074 6865 206e 6174 7572 use.of the natur │ │ │ │ -000052d0: 6520 6f66 2062 6f6f 746c 6f61 6465 7220 e of bootloader │ │ │ │ -000052e0: 6576 6572 7920 6e65 7720 706f 7274 206d every new port m │ │ │ │ -000052f0: 7573 7420 6265 2064 6f6e 6520 7365 7061 ust be done sepa │ │ │ │ -00005300: 7261 7465 6c79 2e0a 4865 7265 2069 7320 rately..Here is │ │ │ │ -00005310: 686f 7720 4920 6469 6420 4d49 5053 2028 how I did MIPS ( │ │ │ │ -00005320: 6c6f 6f6e 6773 6f6e 2061 6e64 2041 5243 loongson and ARC │ │ │ │ -00005330: 2920 616e 6420 5865 6e20 706f 7274 732e ) and Xen ports. │ │ │ │ -00005340: 2020 4e6f 7465 2074 6861 6e20 7468 6973 Note than this │ │ │ │ -00005350: 0a69 7320 6d6f 7265 206f 6620 7375 6767 .is more of sugg │ │ │ │ -00005360: 6573 7469 6f6e 732c 206e 6f74 2061 6273 estions, not abs │ │ │ │ -00005370: 6f6c 7574 6520 7472 7574 682e 0a0a 2020 olute truth... │ │ │ │ -00005380: 2046 6972 7374 206f 6620 616c 6c20 6772 First of all gr │ │ │ │ -00005390: 6162 2061 6e79 2061 7263 6869 7465 6374 ab any architect │ │ │ │ -000053a0: 7572 6520 7370 6563 6966 6963 6174 696f ure specificatio │ │ │ │ -000053b0: 6e73 2079 6f75 2063 616e 2066 696e 6420 ns you can find │ │ │ │ -000053c0: 696e 0a70 7562 6c69 6320 2870 6c65 6173 in.public (pleas │ │ │ │ -000053d0: 6520 6176 6f69 6420 4e44 4129 2e0a 0a20 e avoid NDA)... │ │ │ │ -000053e0: 2020 4669 7273 7420 7374 6167 6520 6973 First stage is │ │ │ │ -000053f0: 2022 4865 6c6c 6f20 776f 726c 6422 2e20 "Hello world". │ │ │ │ -00005400: 2049 2776 6520 646f 6e65 2069 7420 6f75 I've done it ou │ │ │ │ -00005410: 7473 6964 6520 6f66 2047 5255 4220 666f tside of GRUB fo │ │ │ │ -00005420: 720a 7369 6d70 6c69 6369 7479 2e20 2059 r.simplicity. Y │ │ │ │ -00005430: 6f75 7220 7461 736b 2069 7320 746f 2068 our task is to h │ │ │ │ -00005440: 6176 6520 6120 736d 616c 6c20 7072 6f67 ave a small prog │ │ │ │ -00005450: 7261 6d20 7768 6963 6820 6973 206c 6f61 ram which is loa │ │ │ │ -00005460: 6461 626c 6520 6173 0a62 6f6f 746c 6f61 dable as.bootloa │ │ │ │ -00005470: 6465 7220 616e 6420 636c 6561 726c 7920 der and clearly │ │ │ │ -00005480: 7368 6f77 7320 6974 7320 7072 6573 656e shows its presen │ │ │ │ -00005490: 6365 2074 6f20 796f 752e 2020 4966 2079 ce to you. If y │ │ │ │ -000054a0: 6f75 2068 6176 6520 6561 7369 6c79 0a61 ou have easily.a │ │ │ │ -000054b0: 6363 6573 7369 626c 6520 636f 6e73 6f6c ccessible consol │ │ │ │ -000054c0: 6520 796f 7520 6361 6e20 6a75 7374 2070 e you can just p │ │ │ │ -000054d0: 7269 6e74 2061 206d 6573 7361 6765 2e20 rint a message. │ │ │ │ -000054e0: 2049 6620 796f 7520 6861 7665 2061 206d If you have a m │ │ │ │ -000054f0: 6170 7065 640a 6672 616d 6562 7566 6665 apped.framebuffe │ │ │ │ -00005500: 7220 796f 7520 6b6e 6f77 2061 6464 7265 r you know addre │ │ │ │ -00005510: 7373 206f 662c 2079 6f75 2063 616e 2064 ss of, you can d │ │ │ │ -00005520: 7261 7720 6120 7371 7561 7265 2e20 2049 raw a square. I │ │ │ │ -00005530: 6620 796f 7520 6861 7665 2061 0a64 6562 f you have a.deb │ │ │ │ -00005540: 7567 2066 6163 696c 6974 792c 206a 7573 ug facility, jus │ │ │ │ -00005550: 7420 6861 6e67 696e 6720 7769 7468 6f75 t hanging withou │ │ │ │ -00005560: 7420 6372 6173 6869 6e67 206d 6967 6874 t crashing might │ │ │ │ -00005570: 2062 6520 656e 6f75 6768 2e20 2046 6f72 be enough. For │ │ │ │ -00005580: 2074 6865 0a66 6972 7374 2073 7461 6765 the.first stage │ │ │ │ -00005590: 2079 6f75 2063 616e 2063 686f 6f73 6520 you can choose │ │ │ │ -000055a0: 746f 206c 6f61 6420 7468 6520 626f 6f74 to load the boot │ │ │ │ -000055b0: 6c6f 6164 6572 2061 6372 6f73 7320 7468 loader across th │ │ │ │ -000055c0: 6520 6e65 7477 6f72 6b0a 7369 6e63 6520 e network.since │ │ │ │ -000055d0: 666f 726d 6174 2066 6f72 206e 6574 776f format for netwo │ │ │ │ -000055e0: 726b 2069 6d61 6765 2069 7320 6f66 7465 rk image is ofte │ │ │ │ -000055f0: 6e20 6561 7369 6572 2074 6861 6e20 666f n easier than fo │ │ │ │ -00005600: 7220 6c6f 6361 6c20 626f 6f74 2061 6e64 r local boot and │ │ │ │ -00005610: 0a69 7420 736b 6970 7320 7468 6520 6e65 .it skips the ne │ │ │ │ -00005620: 6564 206f 6620 736d 616c 6c20 696e 7465 ed of small inte │ │ │ │ -00005630: 726d 6564 6961 7279 2073 7461 6765 7320 rmediary stages │ │ │ │ -00005640: 616e 6420 6e76 7261 6d20 6861 6e64 6c69 and nvram handli │ │ │ │ -00005650: 6e67 2e0a 4164 6469 7469 6f6e 616c 6c79 ng..Additionally │ │ │ │ -00005660: 2079 6f75 2063 616e 206f 6674 656e 2068 you can often h │ │ │ │ -00005670: 6176 6520 6120 676f 6f64 2069 6465 6120 ave a good idea │ │ │ │ -00005680: 6f66 2074 6865 206e 6565 6465 6420 666f of the needed fo │ │ │ │ -00005690: 726d 6174 2062 790a 7275 6e6e 696e 6720 rmat by.running │ │ │ │ -000056a0: 2266 696c 6522 206f 6e20 616e 7920 6e65 "file" on any ne │ │ │ │ -000056b0: 7462 6f6f 7461 626c 6520 6578 6563 7574 tbootable execut │ │ │ │ -000056c0: 6162 6c65 2066 6f72 2067 6976 656e 2070 able for given p │ │ │ │ -000056d0: 6c61 7466 6f72 6d2e 0a0a 2020 2054 6869 latform... Thi │ │ │ │ -000056e0: 7320 7072 6f67 7261 6d20 7368 6f75 6c64 s program should │ │ │ │ -000056f0: 2070 726f 6261 626c 7920 6861 7665 2032 probably have 2 │ │ │ │ -00005700: 2070 6172 7473 3a20 616e 2061 7373 656d parts: an assem │ │ │ │ -00005710: 626c 6572 2061 6e64 2043 206f 6e65 2e0a bler and C one.. │ │ │ │ -00005720: 4173 7365 6d62 6c65 7220 6f6e 6520 6861 Assembler one ha │ │ │ │ -00005730: 6e64 6c65 7320 4253 5320 636c 6561 6e69 ndles BSS cleani │ │ │ │ -00005740: 6e67 2061 6e64 206f 7468 6572 206e 6565 ng and other nee │ │ │ │ -00005750: 6465 6420 7365 7475 7020 286f 6e20 736f ded setup (on so │ │ │ │ -00005760: 6d65 0a70 6c61 7466 6f72 6d73 2079 6f75 me.platforms you │ │ │ │ -00005770: 206d 6179 206e 6565 6420 746f 2073 7769 may need to swi │ │ │ │ -00005780: 7463 6820 6d6f 6465 7320 6f72 2063 6f70 tch modes or cop │ │ │ │ -00005790: 7920 7468 6520 6578 6563 7574 6162 6c65 y the executable │ │ │ │ -000057a0: 2074 6f20 6974 730a 6465 6669 6e69 7469 to its.definiti │ │ │ │ -000057b0: 7665 2070 6f73 6974 696f 6e29 2e20 2053 ve position). S │ │ │ │ -000057c0: 6f20 796f 7572 2063 6f64 6520 6d61 7920 o your code may │ │ │ │ -000057d0: 6c6f 6f6b 206c 696b 6520 2878 3836 2061 look like (x86 a │ │ │ │ -000057e0: 7373 656d 626c 7920 666f 720a 696c 6c75 ssembly for.illu │ │ │ │ -000057f0: 7374 7261 7469 6f6e 2070 7572 706f 7365 stration purpose │ │ │ │ -00005800: 7329 0a0a 2020 2020 2020 2020 2020 2020 s).. │ │ │ │ -00005810: 202e 676c 6f62 6c20 5f73 7461 7274 0a20 .globl _start. │ │ │ │ -00005820: 2020 2020 5f73 7461 7274 3a0a 2020 2020 _start:. │ │ │ │ -00005830: 2009 6d6f 766c 0924 5f62 7373 5f73 7461 .movl.$_bss_sta │ │ │ │ -00005840: 7274 2c20 2565 6469 0a20 2020 2020 096d rt, %edi. .m │ │ │ │ -00005850: 6f76 6c09 245f 656e 642c 2025 6563 780a ovl.$_end, %ecx. │ │ │ │ -00005860: 2020 2020 2009 7375 626c 0925 6564 692c .subl.%edi, │ │ │ │ -00005870: 2025 6563 780a 2020 2020 2009 786f 726c %ecx. .xorl │ │ │ │ -00005880: 0925 6561 782c 2025 6561 780a 2020 2020 .%eax, %eax. │ │ │ │ -00005890: 2009 636c 640a 2020 2020 2009 7265 700a .cld. .rep. │ │ │ │ -000058a0: 2020 2020 2009 7374 6f73 620a 2020 2020 .stosb. │ │ │ │ -000058b0: 2020 2020 2020 2020 2063 616c 6c20 6d61 call ma │ │ │ │ -000058c0: 696e 0a0a 0a20 2020 2020 7374 6174 6963 in... static │ │ │ │ -000058d0: 2063 6f6e 7374 2063 6861 7220 6d73 675b const char msg[ │ │ │ │ -000058e0: 5d20 3d20 2248 656c 6c6f 2c20 776f 726c ] = "Hello, worl │ │ │ │ -000058f0: 6422 3b0a 0a20 2020 2020 766f 6964 0a20 d";.. void. │ │ │ │ -00005900: 2020 2020 7075 7463 6861 7220 2869 6e74 putchar (int │ │ │ │ -00005910: 2063 290a 2020 2020 207b 0a20 2020 2020 c). {. │ │ │ │ -00005920: 2020 2e2e 2e0a 2020 2020 207d 0a0a 2020 .... }.. │ │ │ │ -00005930: 2020 2076 6f69 640a 2020 2020 206d 6169 void. mai │ │ │ │ -00005940: 6e20 2876 6f69 6429 0a20 2020 2020 7b0a n (void). {. │ │ │ │ -00005950: 2020 2020 2020 2063 6f6e 7374 2063 6861 const cha │ │ │ │ -00005960: 7220 2a70 7472 203d 206d 7367 3b0a 2020 r *ptr = msg;. │ │ │ │ -00005970: 2020 2020 2077 6869 6c65 2028 2a70 7472 while (*ptr │ │ │ │ -00005980: 290a 2020 2020 2020 2020 2070 7574 6368 ). putch │ │ │ │ -00005990: 6172 2028 2a70 7472 2b2b 293b 0a20 2020 ar (*ptr++);. │ │ │ │ -000059a0: 2020 2020 7768 696c 6520 2831 293b 0a20 while (1);. │ │ │ │ -000059b0: 2020 2020 7d0a 0a20 2020 536f 6d65 7469 }.. Someti │ │ │ │ -000059c0: 6d65 7320 796f 7520 6e65 6564 2061 2074 mes you need a t │ │ │ │ -000059d0: 6869 7264 2066 696c 653a 2061 7373 656d hird file: assem │ │ │ │ -000059e0: 626c 7920 7374 7562 7320 666f 720a 4142 bly stubs for.AB │ │ │ │ -000059f0: 492d 636f 6d70 6174 6962 696c 6974 792e I-compatibility. │ │ │ │ -00005a00: 0a0a 2020 204f 6e63 6520 7468 6973 2066 .. Once this f │ │ │ │ -00005a10: 696c 6520 6973 2066 756e 6374 696f 6e61 ile is functiona │ │ │ │ -00005a20: 6c20 6974 2773 2074 696d 6520 746f 206d l it's time to m │ │ │ │ -00005a30: 6f76 6520 6974 2069 6e74 6f20 4752 5542 ove it into GRUB │ │ │ │ -00005a40: 322e 2020 5468 650a 7374 6172 7475 7020 2. The.startup │ │ │ │ -00005a50: 6173 7365 6d62 6c79 2066 696c 6520 676f assembly file go │ │ │ │ -00005a60: 6573 2074 6f20 6772 7562 2d63 6f72 652f es to grub-core/ │ │ │ │ -00005a70: 6b65 726e 2f24 6370 752f 2470 6c61 7466 kern/$cpu/$platf │ │ │ │ -00005a80: 6f72 6d2f 7374 6172 7475 702e 532e 0a59 orm/startup.S..Y │ │ │ │ -00005a90: 6f75 2073 686f 756c 6420 616c 736f 2069 ou should also i │ │ │ │ -00005aa0: 6e63 6c75 6465 2067 7275 622f 7379 6d62 nclude grub/symb │ │ │ │ -00005ab0: 6f6c 2e68 2061 6e64 2072 6570 6c61 6365 ol.h and replace │ │ │ │ -00005ac0: 2063 616c 6c20 746f 2065 6e74 7279 2070 call to entry p │ │ │ │ -00005ad0: 6f69 6e74 0a77 6974 6820 6361 6c6c 2074 oint.with call t │ │ │ │ -00005ae0: 6f20 4558 545f 4328 6772 7562 5f6d 6169 o EXT_C(grub_mai │ │ │ │ -00005af0: 6e29 2e20 2054 6865 2043 2066 696c 6520 n). The C file │ │ │ │ -00005b00: 676f 6573 2074 6f0a 6772 7562 2d63 6f72 goes to.grub-cor │ │ │ │ -00005b10: 652f 6b65 726e 2f24 6370 752f 2470 6c61 e/kern/$cpu/$pla │ │ │ │ -00005b20: 7466 6f72 6d2f 696e 6974 2e63 2061 6e64 tform/init.c and │ │ │ │ -00005b30: 2069 7473 2065 6e74 7279 2070 6f69 6e74 its entry point │ │ │ │ -00005b40: 2069 7320 7265 6e61 6d65 6420 746f 0a76 is renamed to.v │ │ │ │ -00005b50: 6f69 6420 6772 7562 5f6d 6163 6869 6e65 oid grub_machine │ │ │ │ -00005b60: 5f69 6e69 7420 2876 6f69 6429 2e20 204b _init (void). K │ │ │ │ -00005b70: 6565 7020 6669 6e61 6c20 696e 6669 6e69 eep final infini │ │ │ │ -00005b80: 7465 206c 6f6f 7020 666f 7220 6e6f 772e te loop for now. │ │ │ │ -00005b90: 2020 5374 7562 730a 6669 6c65 2069 6620 Stubs.file if │ │ │ │ -00005ba0: 616e 7920 676f 6573 2074 6f20 6772 7562 any goes to grub │ │ │ │ -00005bb0: 2d63 6f72 652f 6b65 726e 2f24 6370 752f -core/kern/$cpu/ │ │ │ │ -00005bc0: 2470 6c61 7466 6f72 6d2f 6361 6c6c 7772 $platform/callwr │ │ │ │ -00005bd0: 6170 2e53 2e20 536f 6d65 7469 6d65 730a ap.S. Sometimes. │ │ │ │ -00005be0: 6569 7468 6572 2024 6370 7520 6f72 2024 either $cpu or $ │ │ │ │ -00005bf0: 706c 6174 666f 726d 2069 7320 6472 6f70 platform is drop │ │ │ │ -00005c00: 7065 6420 6966 2066 696c 6520 6973 2075 ped if file is u │ │ │ │ -00005c10: 7365 6420 6f6e 2073 6576 6572 616c 2063 sed on several c │ │ │ │ -00005c20: 7075 730a 7265 7370 6563 7469 7665 6c79 pus.respectively │ │ │ │ -00005c30: 706c 6174 666f 726d 732e 2020 4368 6563 platforms. Chec │ │ │ │ -00005c40: 6b20 7468 6f73 6520 6c6f 6361 7469 6f6e k those location │ │ │ │ -00005c50: 7320 6966 2074 6865 7920 616c 7265 6164 s if they alread │ │ │ │ -00005c60: 7920 6861 7665 2077 6861 740a 796f 7527 y have what.you' │ │ │ │ -00005c70: 7265 206c 6f6f 6b69 6e67 2066 6f72 2e0a re looking for.. │ │ │ │ -00005c80: 0a20 2020 5468 656e 206d 6f64 6966 7920 . Then modify │ │ │ │ -00005c90: 696e 2063 6f6e 6669 6775 7265 2e61 6320 in configure.ac │ │ │ │ -00005ca0: 7468 6520 666f 6c6c 6f77 696e 6720 7061 the following pa │ │ │ │ -00005cb0: 7274 733a 0a0a 2020 2043 5055 206e 616d rts:.. CPU nam │ │ │ │ -00005cc0: 6573 3a0a 0a20 2020 2020 6361 7365 2022 es:.. case " │ │ │ │ -00005cd0: 2474 6172 6765 745f 6370 7522 2069 6e0a $target_cpu" in. │ │ │ │ -00005ce0: 2020 2020 2020 2069 5b5b 3334 3536 5d5d i[[3456]] │ │ │ │ -00005cf0: 3836 2909 7461 7267 6574 5f63 7075 3d69 86).target_cpu=i │ │ │ │ -00005d00: 3338 3620 3b3b 0a20 2020 2020 2020 616d 386 ;;. am │ │ │ │ -00005d10: 6436 3429 0974 6172 6765 745f 6370 753d d64).target_cpu= │ │ │ │ -00005d20: 7838 365f 3634 203b 3b0a 2020 2020 2020 x86_64 ;;. │ │ │ │ -00005d30: 2073 7061 7263 2909 7461 7267 6574 5f63 sparc).target_c │ │ │ │ -00005d40: 7075 3d73 7061 7263 3634 203b 3b0a 2020 pu=sparc64 ;;. │ │ │ │ -00005d50: 2020 2020 2073 3339 3078 2909 7461 7267 s390x).targ │ │ │ │ -00005d60: 6574 5f63 7075 3d73 3339 3020 3b3b 0a20 et_cpu=s390 ;;. │ │ │ │ -00005d70: 2020 2020 2020 2e2e 2e0a 2020 2020 2065 .... e │ │ │ │ -00005d80: 7361 630a 0a20 2020 536f 6d65 7469 6d65 sac.. Sometime │ │ │ │ -00005d90: 7320 4350 5520 6861 7665 2061 6464 6974 s CPU have addit │ │ │ │ -00005da0: 696f 6e61 6c20 6172 6368 6974 6563 7475 ional architectu │ │ │ │ -00005db0: 7265 206e 616d 6573 2077 6869 6368 2064 re names which d │ │ │ │ -00005dc0: 6f6e 2774 0a69 6e66 6c75 656e 6365 2062 on't.influence b │ │ │ │ -00005dd0: 6f6f 7469 6e67 2e20 2059 6f75 206d 6967 ooting. You mig │ │ │ │ -00005de0: 6874 2077 616e 7420 746f 2068 6176 6520 ht want to have │ │ │ │ -00005df0: 736f 6d65 2063 616e 6f6e 6963 616c 206e some canonical n │ │ │ │ -00005e00: 616d 6520 746f 2061 766f 6964 0a68 6176 ame to avoid.hav │ │ │ │ -00005e10: 696e 6720 6275 6e63 6820 6f66 2069 6465 ing bunch of ide │ │ │ │ -00005e20: 6e74 6963 616c 2070 6c61 7466 6f72 6d73 ntical platforms │ │ │ │ -00005e30: 2077 6974 6820 6469 6666 6572 656e 7420 with different │ │ │ │ -00005e40: 6e61 6d65 732e 0a0a 2020 204e 4f54 453a names... NOTE: │ │ │ │ -00005e50: 2069 7420 646f 6573 6e27 7420 696e 666c it doesn't infl │ │ │ │ -00005e60: 7565 6e63 6520 636f 6d70 696c 6520 6f70 uence compile op │ │ │ │ -00005e70: 7469 6d69 7361 7469 6f6e 7320 7768 6963 timisations whic │ │ │ │ -00005e80: 6820 6465 7065 6e64 2073 6f6c 656c 790a h depend solely. │ │ │ │ -00005e90: 6f6e 2063 686f 7365 6e20 636f 6d70 696c on chosen compil │ │ │ │ -00005ea0: 6572 2061 6e64 2063 6f6d 7069 6c65 206f er and compile o │ │ │ │ -00005eb0: 7074 696f 6e73 2e0a 0a20 2020 2020 6966 ptions... if │ │ │ │ -00005ec0: 2074 6573 7420 2278 2477 6974 685f 706c test "x$with_pl │ │ │ │ -00005ed0: 6174 666f 726d 2220 3d20 783b 2074 6865 atform" = x; the │ │ │ │ -00005ee0: 6e0a 2020 2020 2020 2063 6173 6520 2224 n. case "$ │ │ │ │ -00005ef0: 7461 7267 6574 5f63 7075 222d 2224 7461 target_cpu"-"$ta │ │ │ │ -00005f00: 7267 6574 5f76 656e 646f 7222 2069 6e0a rget_vendor" in. │ │ │ │ -00005f10: 2020 2020 2020 2020 2069 3338 362d 6170 i386-ap │ │ │ │ -00005f20: 706c 6529 2070 6c61 7466 6f72 6d3d 6566 ple) platform=ef │ │ │ │ -00005f30: 6920 3b3b 0a20 2020 2020 2020 2020 6933 i ;;. i3 │ │ │ │ -00005f40: 3836 2d2a 2920 706c 6174 666f 726d 3d70 86-*) platform=p │ │ │ │ -00005f50: 6320 3b3b 0a20 2020 2020 2020 2020 7838 c ;;. x8 │ │ │ │ -00005f60: 365f 3634 2d61 7070 6c65 2920 706c 6174 6_64-apple) plat │ │ │ │ -00005f70: 666f 726d 3d65 6669 203b 3b0a 2020 2020 form=efi ;;. │ │ │ │ -00005f80: 2020 2020 2078 3836 5f36 342d 2a29 2070 x86_64-*) p │ │ │ │ -00005f90: 6c61 7466 6f72 6d3d 7063 203b 3b0a 2020 latform=pc ;;. │ │ │ │ -00005fa0: 2020 2020 2020 2070 6f77 6572 7063 2d2a powerpc-* │ │ │ │ -00005fb0: 2920 706c 6174 666f 726d 3d69 6565 6531 ) platform=ieee1 │ │ │ │ -00005fc0: 3237 3520 3b3b 0a20 2020 2020 2020 2020 275 ;;. │ │ │ │ -00005fd0: 2e2e 2e0a 2020 2020 2020 2065 7361 630a .... esac. │ │ │ │ -00005fe0: 2020 2020 2065 6c73 650a 2020 2020 2020 else. │ │ │ │ -00005ff0: 202e 2e2e 0a20 2020 2020 6669 0a0a 2020 .... fi.. │ │ │ │ -00006000: 2054 6869 7320 7061 7274 2064 6561 6c73 This part deals │ │ │ │ -00006010: 2077 6974 6820 6775 6573 7369 6e67 2074 with guessing t │ │ │ │ -00006020: 6865 2070 6c61 7466 6f72 6d20 6672 6f6d he platform from │ │ │ │ -00006030: 2043 5055 2061 6e64 2076 656e 646f 722e CPU and vendor. │ │ │ │ -00006040: 0a53 6f6d 6574 696d 6573 2079 6f75 206e .Sometimes you n │ │ │ │ -00006050: 6565 6420 746f 2075 7365 2033 322d 6269 eed to use 32-bi │ │ │ │ -00006060: 7420 6d6f 6465 2066 6f72 2062 6f6f 7469 t mode for booti │ │ │ │ -00006070: 6e67 2065 7665 6e20 6966 204f 5320 7275 ng even if OS ru │ │ │ │ -00006080: 6e73 2069 6e0a 3634 2d62 6974 206f 6e65 ns in.64-bit one │ │ │ │ -00006090: 2e20 2049 6620 736f 2061 6464 2079 6f75 . If so add you │ │ │ │ -000060a0: 7220 706c 6174 666f 726d 2074 6f3a 0a0a r platform to:.. │ │ │ │ -000060b0: 2020 2020 2063 6173 6520 2224 7461 7267 case "$targ │ │ │ │ -000060c0: 6574 5f63 7075 222d 2224 706c 6174 666f et_cpu"-"$platfo │ │ │ │ -000060d0: 726d 2220 696e 0a20 2020 2020 2020 7838 rm" in. x8 │ │ │ │ -000060e0: 365f 3634 2d65 6669 2920 3b3b 0a20 2020 6_64-efi) ;;. │ │ │ │ -000060f0: 2020 2020 7838 365f 3634 2d65 6d75 2920 x86_64-emu) │ │ │ │ -00006100: 3b3b 0a20 2020 2020 2020 7838 365f 3634 ;;. x86_64 │ │ │ │ -00006110: 2d2a 2920 7461 7267 6574 5f63 7075 3d69 -*) target_cpu=i │ │ │ │ -00006120: 3338 3620 3b3b 0a20 2020 2020 2020 706f 386 ;;. po │ │ │ │ -00006130: 7765 7270 6336 342d 6965 6565 3132 3735 werpc64-ieee1275 │ │ │ │ -00006140: 2920 7461 7267 6574 5f63 7075 3d70 6f77 ) target_cpu=pow │ │ │ │ -00006150: 6572 7063 203b 3b0a 2020 2020 2065 7361 erpc ;;. esa │ │ │ │ -00006160: 630a 0a20 2020 4164 6420 796f 7572 2070 c.. Add your p │ │ │ │ -00006170: 6c61 7466 6f72 6d20 746f 2074 6865 206c latform to the l │ │ │ │ -00006180: 6973 7420 6f66 2073 7570 706f 7274 6564 ist of supported │ │ │ │ -00006190: 206f 6e65 733a 0a0a 2020 2020 2063 6173 ones:.. cas │ │ │ │ -000061a0: 6520 2224 7461 7267 6574 5f63 7075 222d e "$target_cpu"- │ │ │ │ -000061b0: 2224 706c 6174 666f 726d 2220 696e 0a20 "$platform" in. │ │ │ │ -000061c0: 2020 2020 2020 6933 3836 2d65 6669 2920 i386-efi) │ │ │ │ -000061d0: 3b3b 0a20 2020 2020 2020 7838 365f 3634 ;;. x86_64 │ │ │ │ -000061e0: 2d65 6669 2920 3b3b 0a20 2020 2020 2020 -efi) ;;. │ │ │ │ -000061f0: 6933 3836 2d70 6329 203b 3b0a 2020 2020 i386-pc) ;;. │ │ │ │ -00006200: 2020 2069 3338 362d 6d75 6c74 6962 6f6f i386-multiboo │ │ │ │ -00006210: 7429 203b 3b0a 2020 2020 2020 2069 3338 t) ;;. i38 │ │ │ │ -00006220: 362d 636f 7265 626f 6f74 2920 3b3b 0a20 6-coreboot) ;;. │ │ │ │ -00006230: 2020 2020 2020 2e2e 2e0a 2020 2020 2065 .... e │ │ │ │ -00006240: 7361 630a 0a20 2020 4966 2065 7870 6c69 sac.. If expli │ │ │ │ -00006250: 6369 7420 2d6d 3332 206f 7220 2d6d 3634 cit -m32 or -m64 │ │ │ │ -00006260: 2069 7320 6e65 6564 6564 2061 6464 2069 is needed add i │ │ │ │ -00006270: 7420 746f 3a0a 0a20 2020 2020 6361 7365 t to:.. case │ │ │ │ -00006280: 2022 2474 6172 6765 745f 6370 7522 2069 "$target_cpu" i │ │ │ │ -00006290: 6e0a 2020 2020 2020 2069 3338 3620 7c20 n. i386 | │ │ │ │ -000062a0: 706f 7765 7270 6329 2074 6172 6765 745f powerpc) target_ │ │ │ │ -000062b0: 6d33 323d 3120 3b3b 0a20 2020 2020 2020 m32=1 ;;. │ │ │ │ -000062c0: 7838 365f 3634 207c 2073 7061 7263 3634 x86_64 | sparc64 │ │ │ │ -000062d0: 2920 7461 7267 6574 5f6d 3634 3d31 203b ) target_m64=1 ; │ │ │ │ -000062e0: 3b0a 2020 2020 2065 7361 630a 0a20 2020 ;. esac.. │ │ │ │ -000062f0: 4669 6e61 6c6c 7920 796f 7520 6e65 6564 Finally you need │ │ │ │ -00006300: 2074 6f20 6164 6420 6120 636f 6e64 6974 to add a condit │ │ │ │ -00006310: 696f 6e61 6c20 746f 2074 6865 2066 6f6c ional to the fol │ │ │ │ -00006320: 6c6f 7769 6e67 2062 6c6f 636b 3a0a 0a20 lowing block:.. │ │ │ │ -00006330: 2020 2020 414d 5f43 4f4e 4449 5449 4f4e AM_CONDITION │ │ │ │ -00006340: 414c 285b 434f 4e44 5f6d 6970 735f 6172 AL([COND_mips_ar │ │ │ │ -00006350: 635d 2c20 5b74 6573 7420 7824 7461 7267 c], [test x$targ │ │ │ │ -00006360: 6574 5f63 7075 203d 2078 6d69 7073 202d et_cpu = xmips - │ │ │ │ -00006370: 6120 7824 706c 6174 666f 726d 203d 2078 a x$platform = x │ │ │ │ -00006380: 6172 635d 290a 2020 2020 2041 4d5f 434f arc]). AM_CO │ │ │ │ -00006390: 4e44 4954 494f 4e41 4c28 5b43 4f4e 445f NDITIONAL([COND_ │ │ │ │ -000063a0: 7370 6172 6336 345f 6965 6565 3132 3735 sparc64_ieee1275 │ │ │ │ -000063b0: 5d2c 205b 7465 7374 2078 2474 6172 6765 ], [test x$targe │ │ │ │ -000063c0: 745f 6370 7520 3d20 7873 7061 7263 3634 t_cpu = xsparc64 │ │ │ │ -000063d0: 202d 6120 7824 706c 6174 666f 726d 203d -a x$platform = │ │ │ │ -000063e0: 2078 6965 6565 3132 3735 5d29 0a20 2020 xieee1275]). │ │ │ │ -000063f0: 2020 414d 5f43 4f4e 4449 5449 4f4e 414c AM_CONDITIONAL │ │ │ │ -00006400: 285b 434f 4e44 5f70 6f77 6572 7063 5f69 ([COND_powerpc_i │ │ │ │ -00006410: 6565 6531 3237 355d 2c20 5b74 6573 7420 eee1275], [test │ │ │ │ -00006420: 7824 7461 7267 6574 5f63 7075 203d 2078 x$target_cpu = x │ │ │ │ -00006430: 706f 7765 7270 6320 2d61 2078 2470 6c61 powerpc -a x$pla │ │ │ │ -00006440: 7466 6f72 6d20 3d20 7869 6565 6531 3237 tform = xieee127 │ │ │ │ -00006450: 355d 290a 0a20 2020 4e65 7874 2073 746f 5]).. Next sto │ │ │ │ -00006460: 7020 6973 2067 656e 7470 6c2e 7079 2e20 p is gentpl.py. │ │ │ │ -00006470: 2059 6f75 206e 6565 6420 746f 2061 6464 You need to add │ │ │ │ -00006480: 2079 6f75 7220 706c 6174 666f 726d 2074 your platform t │ │ │ │ -00006490: 6f20 7468 6520 6c69 7374 206f 660a 7375 o the list of.su │ │ │ │ -000064a0: 7070 6f72 7465 6420 6f6e 6573 2028 736f pported ones (so │ │ │ │ -000064b0: 7272 7920 7468 6174 2074 6869 7320 6c69 rry that this li │ │ │ │ -000064c0: 7374 2069 7320 6475 706c 6963 6174 6564 st is duplicated │ │ │ │ -000064d0: 293a 0a0a 2020 2020 2047 5255 425f 504c ):.. GRUB_PL │ │ │ │ -000064e0: 4154 464f 524d 5320 3d20 5b20 2265 6d75 ATFORMS = [ "emu │ │ │ │ -000064f0: 222c 2022 6933 3836 5f70 6322 2c20 2269 ", "i386_pc", "i │ │ │ │ -00006500: 3338 365f 6566 6922 2c20 2269 3338 365f 386_efi", "i386_ │ │ │ │ -00006510: 7165 6d75 222c 2022 6933 3836 5f63 6f72 qemu", "i386_cor │ │ │ │ -00006520: 6562 6f6f 7422 2c0a 2020 2020 2020 2020 eboot",. │ │ │ │ +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 0a0a 1f0a ..* Gnulib::.... │ │ │ │ +00004ac0: 4669 6c65 3a20 6772 7562 2d64 6576 2e69 File: grub-dev.i │ │ │ │ +00004ad0: 6e66 6f2c 2020 4e6f 6465 3a20 476e 756c nfo, Node: Gnul │ │ │ │ +00004ae0: 6962 2c20 2055 703a 2055 7064 6174 696e ib, Up: Updatin │ │ │ │ +00004af0: 6720 4578 7465 726e 616c 2043 6f64 650a g External Code. │ │ │ │ +00004b00: 0a35 2e31 2047 6e75 6c69 620a 3d3d 3d3d .5.1 Gnulib.==== │ │ │ │ +00004b10: 3d3d 3d3d 3d3d 0a0a 476e 756c 6962 2069 ======..Gnulib i │ │ │ │ +00004b20: 7320 6120 736f 7572 6365 2063 6f64 6520 s a source code │ │ │ │ +00004b30: 6c69 6272 6172 7920 7468 6174 2070 726f library that pro │ │ │ │ +00004b40: 7669 6465 7320 6261 7369 6320 6675 6e63 vides basic func │ │ │ │ +00004b50: 7469 6f6e 616c 6974 7920 746f 0a70 726f tionality to.pro │ │ │ │ +00004b60: 6772 616d 7320 616e 6420 6c69 6272 6172 grams and librar │ │ │ │ +00004b70: 6965 732e 2020 4d61 6e79 2073 6f66 7477 ies. Many softw │ │ │ │ +00004b80: 6172 6520 7061 636b 6167 6573 206d 616b are packages mak │ │ │ │ +00004b90: 6520 7573 6520 6f66 2047 6e75 6c69 6220 e use of Gnulib │ │ │ │ +00004ba0: 746f 0a61 766f 6964 2072 6569 6e76 656e to.avoid reinven │ │ │ │ +00004bb0: 7469 6e67 2074 6865 2070 6f72 7461 6269 ting the portabi │ │ │ │ +00004bc0: 6c69 7479 2077 6865 656c 2e0a 0a20 2020 lity wheel... │ │ │ │ +00004bd0: 4752 5542 2069 6d70 6f72 7473 2047 6e75 GRUB imports Gnu │ │ │ │ +00004be0: 6c69 6220 7573 696e 6720 6974 7320 2762 lib using its 'b │ │ │ │ +00004bf0: 6f6f 7473 7472 6170 2720 7574 696c 6974 ootstrap' utilit │ │ │ │ +00004c00: 792c 2069 6465 6e74 6966 7969 6e67 2061 y, identifying a │ │ │ │ +00004c10: 0a70 6172 7469 6375 6c61 7220 4769 7420 .particular Git │ │ │ │ +00004c20: 636f 6d6d 6974 2069 6e20 2762 6f6f 7473 commit in 'boots │ │ │ │ +00004c30: 7472 6170 2e63 6f6e 6627 2e20 2054 6f20 trap.conf'. To │ │ │ │ +00004c40: 7570 6772 6164 6520 746f 2061 206e 6577 upgrade to a new │ │ │ │ +00004c50: 2047 6e75 6c69 620a 636f 6d6d 6974 2c20 Gnulib.commit, │ │ │ │ +00004c60: 7365 7420 2747 4e55 4c49 425f 5245 5649 set 'GNULIB_REVI │ │ │ │ +00004c70: 5349 4f4e 2720 696e 2027 626f 6f74 7374 SION' in 'bootst │ │ │ │ +00004c80: 7261 702e 636f 6e66 2720 746f 2074 6865 rap.conf' to the │ │ │ │ +00004c90: 206e 6577 2063 6f6d 6d69 7420 4944 2c0a new commit ID,. │ │ │ │ +00004ca0: 7468 656e 2072 756e 2027 2e2f 626f 6f74 then run './boot │ │ │ │ +00004cb0: 7374 7261 7027 2061 6e64 2077 6861 7465 strap' and whate │ │ │ │ +00004cc0: 7665 7220 656c 7365 2079 6f75 206e 6565 ver else you nee │ │ │ │ +00004cd0: 6420 746f 206d 616b 6520 7375 7265 2069 d to make sure i │ │ │ │ +00004ce0: 7420 776f 726b 732e 0a43 6865 636b 2066 t works..Check f │ │ │ │ +00004cf0: 6f72 2063 6861 6e67 6573 2074 6f20 476e or changes to Gn │ │ │ │ +00004d00: 756c 6962 2773 2027 4e45 5753 2720 6669 ulib's 'NEWS' fi │ │ │ │ +00004d10: 6c65 2062 6574 7765 656e 2074 6865 206f le between the o │ │ │ │ +00004d20: 6c64 2061 6e64 206e 6577 0a63 6f6d 6d69 ld and new.commi │ │ │ │ +00004d30: 7473 3b20 696e 2073 6f6d 6520 6361 7365 ts; in some case │ │ │ │ +00004d40: 7320 6974 2077 696c 6c20 6265 206e 6563 s it will be nec │ │ │ │ +00004d50: 6573 7361 7279 2074 6f20 6164 6a75 7374 essary to adjust │ │ │ │ +00004d60: 2047 5255 4220 746f 206d 6174 6368 2e0a GRUB to match.. │ │ │ │ +00004d70: 596f 7520 6d61 7920 616c 736f 206e 6565 You may also nee │ │ │ │ +00004d80: 6420 746f 2075 7064 6174 6520 7468 6520 d to update the │ │ │ │ +00004d90: 7061 7463 6865 7320 696e 0a27 6772 7562 patches in.'grub │ │ │ │ +00004da0: 2d63 6f72 652f 6c69 622f 676e 756c 6962 -core/lib/gnulib │ │ │ │ +00004db0: 2d70 6174 6368 6573 2f27 2e0a 0a20 2020 -patches/'... │ │ │ │ +00004dc0: 546f 2061 6464 2061 206e 6577 2047 6e75 To add a new Gnu │ │ │ │ +00004dd0: 6c69 6220 6d6f 6475 6c65 206f 7220 7265 lib module or re │ │ │ │ +00004de0: 6d6f 7665 206f 6e65 2074 6861 7420 6973 move one that is │ │ │ │ +00004df0: 206e 6f20 6c6f 6e67 6572 206e 6565 6465 no longer neede │ │ │ │ +00004e00: 642c 0a63 6861 6e67 6520 2767 6e75 6c69 d,.change 'gnuli │ │ │ │ +00004e10: 625f 6d6f 6475 6c65 7327 2069 6e20 2762 b_modules' in 'b │ │ │ │ +00004e20: 6f6f 7473 7472 6170 2e63 6f6e 6627 2e20 ootstrap.conf'. │ │ │ │ +00004e30: 2041 6761 696e 2c20 7275 6e20 272e 2f62 Again, run './b │ │ │ │ +00004e40: 6f6f 7473 7472 6170 270a 616e 6420 7768 ootstrap'.and wh │ │ │ │ +00004e50: 6174 6576 6572 2065 6c73 6520 796f 7520 atever else you │ │ │ │ +00004e60: 6e65 6564 2074 6f20 6d61 6b65 2073 7572 need to make sur │ │ │ │ +00004e70: 6520 6974 2077 6f72 6b73 2e0a 0a20 2020 e it works... │ │ │ │ +00004e80: 426f 6f74 7374 7261 7070 696e 6720 6672 Bootstrapping fr │ │ │ │ +00004e90: 6f6d 2061 6e20 6f6c 6465 7220 6469 7374 om an older dist │ │ │ │ +00004ea0: 7269 6275 7469 6f6e 2063 6f6e 7461 696e ribution contain │ │ │ │ +00004eb0: 696e 6720 6765 7474 6578 7420 7665 7273 ing gettext vers │ │ │ │ +00004ec0: 696f 6e20 3c0a 302e 3138 2e33 2c20 7769 ion <.0.18.3, wi │ │ │ │ +00004ed0: 6c6c 2072 6571 7569 7265 2061 2070 6174 ll require a pat │ │ │ │ +00004ee0: 6368 2073 696d 696c 6172 2074 6f20 7468 ch similar to th │ │ │ │ +00004ef0: 6973 2074 6f20 6265 2061 7070 6c69 6564 is to be applied │ │ │ │ +00004f00: 2066 6972 7374 2062 6566 6f72 650a 7275 first before.ru │ │ │ │ +00004f10: 6e6e 696e 6720 7468 6520 272e 2f62 6f6f nning the './boo │ │ │ │ +00004f20: 7473 7472 6170 2720 7574 696c 6974 793a tstrap' utility: │ │ │ │ +00004f30: 0a0a 2020 2020 2064 6966 6620 2d2d 6769 .. diff --gi │ │ │ │ +00004f40: 7420 612f 626f 6f74 7374 7261 702e 636f t a/bootstrap.co │ │ │ │ +00004f50: 6e66 2062 2f62 6f6f 7473 7472 6170 2e63 nf b/bootstrap.c │ │ │ │ +00004f60: 6f6e 660a 2020 2020 2069 6e64 6578 2039 onf. index 9 │ │ │ │ +00004f70: 3838 6464 6130 2e2e 6133 3139 3361 3920 88dda0..a3193a9 │ │ │ │ +00004f80: 3130 3036 3434 0a20 2020 2020 2d2d 2d20 100644. --- │ │ │ │ +00004f90: 612f 626f 6f74 7374 7261 702e 636f 6e66 a/bootstrap.conf │ │ │ │ +00004fa0: 0a20 2020 2020 2b2b 2b20 622f 626f 6f74 . +++ b/boot │ │ │ │ +00004fb0: 7374 7261 702e 636f 6e66 0a20 2020 2020 strap.conf. │ │ │ │ +00004fc0: 4020 2d36 372c 3720 2b36 372c 3720 4020 @ -67,7 +67,7 @ │ │ │ │ +00004fd0: 534b 4950 5f50 4f3d 740a 2020 2020 2062 SKIP_PO=t. b │ │ │ │ +00004fe0: 7569 6c64 7265 713d 225c 0a20 2020 2020 uildreq="\. │ │ │ │ +00004ff0: 6175 746f 636f 6e66 2020 2032 2e36 330a autoconf 2.63. │ │ │ │ +00005000: 2020 2020 2061 7574 6f6d 616b 6520 2020 automake │ │ │ │ +00005010: 312e 3131 0a20 2020 2020 2d67 6574 7465 1.11. -gette │ │ │ │ +00005020: 7874 2020 2020 302e 3138 2e33 0a20 2020 xt 0.18.3. │ │ │ │ +00005030: 2020 2b67 6574 7465 7874 2020 2020 302e +gettext 0. │ │ │ │ +00005040: 3137 0a20 2020 2020 6769 7420 2020 2020 17. git │ │ │ │ +00005050: 2020 2031 2e35 2e35 0a20 2020 2020 7461 1.5.5. ta │ │ │ │ +00005060: 7220 2020 2020 2020 202d 0a20 2020 2020 r -. │ │ │ │ +00005070: 220a 2020 2020 2064 6966 6620 2d2d 6769 ". diff --gi │ │ │ │ +00005080: 7420 612f 636f 6e66 6967 7572 652e 6163 t a/configure.ac │ │ │ │ +00005090: 2062 2f63 6f6e 6669 6775 7265 2e61 630a b/configure.ac. │ │ │ │ +000050a0: 2020 2020 2069 6e64 6578 2030 3862 3531 index 08b51 │ │ │ │ +000050b0: 3866 2e2e 3939 6635 6233 3620 3130 3036 8f..99f5b36 1006 │ │ │ │ +000050c0: 3434 0a20 2020 2020 2d2d 2d20 612f 636f 44. --- a/co │ │ │ │ +000050d0: 6e66 6967 7572 652e 6163 0a20 2020 2020 nfigure.ac. │ │ │ │ +000050e0: 2b2b 2b20 622f 636f 6e66 6967 7572 652e +++ b/configure. │ │ │ │ +000050f0: 6163 0a20 2020 2020 4020 2d33 3632 2c37 ac. @ -362,7 │ │ │ │ +00005100: 202b 3336 322c 3720 4020 4143 5f43 4845 +362,7 @ AC_CHE │ │ │ │ +00005110: 434b 5f50 524f 4728 4841 5645 5f43 5858 CK_PROG(HAVE_CXX │ │ │ │ +00005120: 2c20 2443 5858 2c20 7965 732c 206e 6f29 , $CXX, yes, no) │ │ │ │ +00005130: 0a0a 2020 2020 2041 435f 474e 555f 534f .. AC_GNU_SO │ │ │ │ +00005140: 5552 4345 0a20 2020 2020 414d 5f47 4e55 URCE. AM_GNU │ │ │ │ +00005150: 5f47 4554 5445 5854 285b 6578 7465 726e _GETTEXT([extern │ │ │ │ +00005160: 616c 5d29 0a20 2020 2020 2d41 4d5f 474e al]). -AM_GN │ │ │ │ +00005170: 555f 4745 5454 4558 545f 5645 5253 494f U_GETTEXT_VERSIO │ │ │ │ +00005180: 4e28 5b30 2e31 382e 335d 290a 2020 2020 N([0.18.3]). │ │ │ │ +00005190: 202b 414d 5f47 4e55 5f47 4554 5445 5854 +AM_GNU_GETTEXT │ │ │ │ +000051a0: 5f56 4552 5349 4f4e 285b 302e 3137 5d29 _VERSION([0.17]) │ │ │ │ +000051b0: 0a20 2020 2020 4143 5f53 5953 5f4c 4152 . AC_SYS_LAR │ │ │ │ +000051c0: 4745 4649 4c45 0a0a 2020 2020 2023 2049 GEFILE.. # I │ │ │ │ +000051d0: 6465 6e74 6966 7920 6368 6172 6163 7465 dentify characte │ │ │ │ +000051e0: 7269 7374 6963 7320 6f66 2074 6865 2068 ristics of the h │ │ │ │ +000051f0: 6f73 7420 6172 6368 6974 6563 7475 7265 ost architecture │ │ │ │ +00005200: 2e0a 0a0a 1f0a 4669 6c65 3a20 6772 7562 ......File: grub │ │ │ │ +00005210: 2d64 6576 2e69 6e66 6f2c 2020 4e6f 6465 -dev.info, Node │ │ │ │ +00005220: 3a20 506f 7274 696e 672c 2020 4e65 7874 : Porting, Next │ │ │ │ +00005230: 3a20 4572 726f 7220 4861 6e64 6c69 6e67 : Error Handling │ │ │ │ +00005240: 2c20 2050 7265 763a 2055 7064 6174 696e , Prev: Updatin │ │ │ │ +00005250: 6720 4578 7465 726e 616c 2043 6f64 652c g External Code, │ │ │ │ +00005260: 2020 5570 3a20 546f 700a 0a36 2050 6f72 Up: Top..6 Por │ │ │ │ +00005270: 7469 6e67 0a2a 2a2a 2a2a 2a2a 2a2a 0a0a ting.*********.. │ │ │ │ +00005280: 4752 5542 3220 6973 2064 6573 6967 6e65 GRUB2 is designe │ │ │ │ +00005290: 6420 746f 2062 6520 6561 7369 6c79 2070 d to be easily p │ │ │ │ +000052a0: 6f72 7461 626c 6520 6163 6372 6f73 7320 ortable accross │ │ │ │ +000052b0: 706c 6174 666f 726d 732e 2020 4275 7420 platforms. But │ │ │ │ +000052c0: 6265 6361 7573 650a 6f66 2074 6865 206e because.of the n │ │ │ │ +000052d0: 6174 7572 6520 6f66 2062 6f6f 746c 6f61 ature of bootloa │ │ │ │ +000052e0: 6465 7220 6576 6572 7920 6e65 7720 706f der every new po │ │ │ │ +000052f0: 7274 206d 7573 7420 6265 2064 6f6e 6520 rt must be done │ │ │ │ +00005300: 7365 7061 7261 7465 6c79 2e0a 4865 7265 separately..Here │ │ │ │ +00005310: 2069 7320 686f 7720 4920 6469 6420 4d49 is how I did MI │ │ │ │ +00005320: 5053 2028 6c6f 6f6e 6773 6f6e 2061 6e64 PS (loongson and │ │ │ │ +00005330: 2041 5243 2920 616e 6420 5865 6e20 706f ARC) and Xen po │ │ │ │ +00005340: 7274 732e 2020 4e6f 7465 2074 6861 6e20 rts. Note than │ │ │ │ +00005350: 7468 6973 0a69 7320 6d6f 7265 206f 6620 this.is more of │ │ │ │ +00005360: 7375 6767 6573 7469 6f6e 732c 206e 6f74 suggestions, not │ │ │ │ +00005370: 2061 6273 6f6c 7574 6520 7472 7574 682e absolute truth. │ │ │ │ +00005380: 0a0a 2020 2046 6972 7374 206f 6620 616c .. First of al │ │ │ │ +00005390: 6c20 6772 6162 2061 6e79 2061 7263 6869 l grab any archi │ │ │ │ +000053a0: 7465 6374 7572 6520 7370 6563 6966 6963 tecture specific │ │ │ │ +000053b0: 6174 696f 6e73 2079 6f75 2063 616e 2066 ations you can f │ │ │ │ +000053c0: 696e 6420 696e 0a70 7562 6c69 6320 2870 ind in.public (p │ │ │ │ +000053d0: 6c65 6173 6520 6176 6f69 6420 4e44 4129 lease avoid NDA) │ │ │ │ +000053e0: 2e0a 0a20 2020 4669 7273 7420 7374 6167 ... First stag │ │ │ │ +000053f0: 6520 6973 2022 4865 6c6c 6f20 776f 726c e is "Hello worl │ │ │ │ +00005400: 6422 2e20 2049 2776 6520 646f 6e65 2069 d". I've done i │ │ │ │ +00005410: 7420 6f75 7473 6964 6520 6f66 2047 5255 t outside of GRU │ │ │ │ +00005420: 4220 666f 720a 7369 6d70 6c69 6369 7479 B for.simplicity │ │ │ │ +00005430: 2e20 2059 6f75 7220 7461 736b 2069 7320 . Your task is │ │ │ │ +00005440: 746f 2068 6176 6520 6120 736d 616c 6c20 to have a small │ │ │ │ +00005450: 7072 6f67 7261 6d20 7768 6963 6820 6973 program which is │ │ │ │ +00005460: 206c 6f61 6461 626c 6520 6173 0a62 6f6f loadable as.boo │ │ │ │ +00005470: 746c 6f61 6465 7220 616e 6420 636c 6561 tloader and clea │ │ │ │ +00005480: 726c 7920 7368 6f77 7320 6974 7320 7072 rly shows its pr │ │ │ │ +00005490: 6573 656e 6365 2074 6f20 796f 752e 2020 esence to you. │ │ │ │ +000054a0: 4966 2079 6f75 2068 6176 6520 6561 7369 If you have easi │ │ │ │ +000054b0: 6c79 0a61 6363 6573 7369 626c 6520 636f ly.accessible co │ │ │ │ +000054c0: 6e73 6f6c 6520 796f 7520 6361 6e20 6a75 nsole you can ju │ │ │ │ +000054d0: 7374 2070 7269 6e74 2061 206d 6573 7361 st print a messa │ │ │ │ +000054e0: 6765 2e20 2049 6620 796f 7520 6861 7665 ge. If you have │ │ │ │ +000054f0: 2061 206d 6170 7065 640a 6672 616d 6562 a mapped.frameb │ │ │ │ +00005500: 7566 6665 7220 796f 7520 6b6e 6f77 2061 uffer you know a │ │ │ │ +00005510: 6464 7265 7373 206f 662c 2079 6f75 2063 ddress of, you c │ │ │ │ +00005520: 616e 2064 7261 7720 6120 7371 7561 7265 an draw a square │ │ │ │ +00005530: 2e20 2049 6620 796f 7520 6861 7665 2061 . If you have a │ │ │ │ +00005540: 0a64 6562 7567 2066 6163 696c 6974 792c .debug facility, │ │ │ │ +00005550: 206a 7573 7420 6861 6e67 696e 6720 7769 just hanging wi │ │ │ │ +00005560: 7468 6f75 7420 6372 6173 6869 6e67 206d thout crashing m │ │ │ │ +00005570: 6967 6874 2062 6520 656e 6f75 6768 2e20 ight be enough. │ │ │ │ +00005580: 2046 6f72 2074 6865 0a66 6972 7374 2073 For the.first s │ │ │ │ +00005590: 7461 6765 2079 6f75 2063 616e 2063 686f tage you can cho │ │ │ │ +000055a0: 6f73 6520 746f 206c 6f61 6420 7468 6520 ose to load the │ │ │ │ +000055b0: 626f 6f74 6c6f 6164 6572 2061 6372 6f73 bootloader acros │ │ │ │ +000055c0: 7320 7468 6520 6e65 7477 6f72 6b0a 7369 s the network.si │ │ │ │ +000055d0: 6e63 6520 666f 726d 6174 2066 6f72 206e nce format for n │ │ │ │ +000055e0: 6574 776f 726b 2069 6d61 6765 2069 7320 etwork image is │ │ │ │ +000055f0: 6f66 7465 6e20 6561 7369 6572 2074 6861 often easier tha │ │ │ │ +00005600: 6e20 666f 7220 6c6f 6361 6c20 626f 6f74 n for local boot │ │ │ │ +00005610: 2061 6e64 0a69 7420 736b 6970 7320 7468 and.it skips th │ │ │ │ +00005620: 6520 6e65 6564 206f 6620 736d 616c 6c20 e need of small │ │ │ │ +00005630: 696e 7465 726d 6564 6961 7279 2073 7461 intermediary sta │ │ │ │ +00005640: 6765 7320 616e 6420 6e76 7261 6d20 6861 ges and nvram ha │ │ │ │ +00005650: 6e64 6c69 6e67 2e0a 4164 6469 7469 6f6e ndling..Addition │ │ │ │ +00005660: 616c 6c79 2079 6f75 2063 616e 206f 6674 ally you can oft │ │ │ │ +00005670: 656e 2068 6176 6520 6120 676f 6f64 2069 en have a good i │ │ │ │ +00005680: 6465 6120 6f66 2074 6865 206e 6565 6465 dea of the neede │ │ │ │ +00005690: 6420 666f 726d 6174 2062 790a 7275 6e6e d format by.runn │ │ │ │ +000056a0: 696e 6720 2266 696c 6522 206f 6e20 616e ing "file" on an │ │ │ │ +000056b0: 7920 6e65 7462 6f6f 7461 626c 6520 6578 y netbootable ex │ │ │ │ +000056c0: 6563 7574 6162 6c65 2066 6f72 2067 6976 ecutable for giv │ │ │ │ +000056d0: 656e 2070 6c61 7466 6f72 6d2e 0a0a 2020 en platform... │ │ │ │ +000056e0: 2054 6869 7320 7072 6f67 7261 6d20 7368 This program sh │ │ │ │ +000056f0: 6f75 6c64 2070 726f 6261 626c 7920 6861 ould probably ha │ │ │ │ +00005700: 7665 2032 2070 6172 7473 3a20 616e 2061 ve 2 parts: an a │ │ │ │ +00005710: 7373 656d 626c 6572 2061 6e64 2043 206f ssembler and C o │ │ │ │ +00005720: 6e65 2e0a 4173 7365 6d62 6c65 7220 6f6e ne..Assembler on │ │ │ │ +00005730: 6520 6861 6e64 6c65 7320 4253 5320 636c e handles BSS cl │ │ │ │ +00005740: 6561 6e69 6e67 2061 6e64 206f 7468 6572 eaning and other │ │ │ │ +00005750: 206e 6565 6465 6420 7365 7475 7020 286f needed setup (o │ │ │ │ +00005760: 6e20 736f 6d65 0a70 6c61 7466 6f72 6d73 n some.platforms │ │ │ │ +00005770: 2079 6f75 206d 6179 206e 6565 6420 746f you may need to │ │ │ │ +00005780: 2073 7769 7463 6820 6d6f 6465 7320 6f72 switch modes or │ │ │ │ +00005790: 2063 6f70 7920 7468 6520 6578 6563 7574 copy the execut │ │ │ │ +000057a0: 6162 6c65 2074 6f20 6974 730a 6465 6669 able to its.defi │ │ │ │ +000057b0: 6e69 7469 7665 2070 6f73 6974 696f 6e29 nitive position) │ │ │ │ +000057c0: 2e20 2053 6f20 796f 7572 2063 6f64 6520 . So your code │ │ │ │ +000057d0: 6d61 7920 6c6f 6f6b 206c 696b 6520 2878 may look like (x │ │ │ │ +000057e0: 3836 2061 7373 656d 626c 7920 666f 720a 86 assembly for. │ │ │ │ +000057f0: 696c 6c75 7374 7261 7469 6f6e 2070 7572 illustration pur │ │ │ │ +00005800: 706f 7365 7329 0a0a 2020 2020 2020 2020 poses).. │ │ │ │ +00005810: 2020 2020 202e 676c 6f62 6c20 5f73 7461 .globl _sta │ │ │ │ +00005820: 7274 0a20 2020 2020 5f73 7461 7274 3a0a rt. _start:. │ │ │ │ +00005830: 2020 2020 2009 6d6f 766c 0924 5f62 7373 .movl.$_bss │ │ │ │ +00005840: 5f73 7461 7274 2c20 2565 6469 0a20 2020 _start, %edi. │ │ │ │ +00005850: 2020 096d 6f76 6c09 245f 656e 642c 2025 .movl.$_end, % │ │ │ │ +00005860: 6563 780a 2020 2020 2009 7375 626c 0925 ecx. .subl.% │ │ │ │ +00005870: 6564 692c 2025 6563 780a 2020 2020 2009 edi, %ecx. . │ │ │ │ +00005880: 786f 726c 0925 6561 782c 2025 6561 780a xorl.%eax, %eax. │ │ │ │ +00005890: 2020 2020 2009 636c 640a 2020 2020 2009 .cld. . │ │ │ │ +000058a0: 7265 700a 2020 2020 2009 7374 6f73 620a rep. .stosb. │ │ │ │ +000058b0: 2020 2020 2020 2020 2020 2020 2063 616c cal │ │ │ │ +000058c0: 6c20 6d61 696e 0a0a 0a20 2020 2020 7374 l main... st │ │ │ │ +000058d0: 6174 6963 2063 6f6e 7374 2063 6861 7220 atic const char │ │ │ │ +000058e0: 6d73 675b 5d20 3d20 2248 656c 6c6f 2c20 msg[] = "Hello, │ │ │ │ +000058f0: 776f 726c 6422 3b0a 0a20 2020 2020 766f world";.. vo │ │ │ │ +00005900: 6964 0a20 2020 2020 7075 7463 6861 7220 id. putchar │ │ │ │ +00005910: 2869 6e74 2063 290a 2020 2020 207b 0a20 (int c). {. │ │ │ │ +00005920: 2020 2020 2020 2e2e 2e0a 2020 2020 207d .... } │ │ │ │ +00005930: 0a0a 2020 2020 2076 6f69 640a 2020 2020 .. void. │ │ │ │ +00005940: 206d 6169 6e20 2876 6f69 6429 0a20 2020 main (void). │ │ │ │ +00005950: 2020 7b0a 2020 2020 2020 2063 6f6e 7374 {. const │ │ │ │ +00005960: 2063 6861 7220 2a70 7472 203d 206d 7367 char *ptr = msg │ │ │ │ +00005970: 3b0a 2020 2020 2020 2077 6869 6c65 2028 ;. while ( │ │ │ │ +00005980: 2a70 7472 290a 2020 2020 2020 2020 2070 *ptr). p │ │ │ │ +00005990: 7574 6368 6172 2028 2a70 7472 2b2b 293b utchar (*ptr++); │ │ │ │ +000059a0: 0a20 2020 2020 2020 7768 696c 6520 2831 . while (1 │ │ │ │ +000059b0: 293b 0a20 2020 2020 7d0a 0a20 2020 536f );. }.. So │ │ │ │ +000059c0: 6d65 7469 6d65 7320 796f 7520 6e65 6564 metimes you need │ │ │ │ +000059d0: 2061 2074 6869 7264 2066 696c 653a 2061 a third file: a │ │ │ │ +000059e0: 7373 656d 626c 7920 7374 7562 7320 666f ssembly stubs fo │ │ │ │ +000059f0: 720a 4142 492d 636f 6d70 6174 6962 696c r.ABI-compatibil │ │ │ │ +00005a00: 6974 792e 0a0a 2020 204f 6e63 6520 7468 ity... Once th │ │ │ │ +00005a10: 6973 2066 696c 6520 6973 2066 756e 6374 is file is funct │ │ │ │ +00005a20: 696f 6e61 6c20 6974 2773 2074 696d 6520 ional it's time │ │ │ │ +00005a30: 746f 206d 6f76 6520 6974 2069 6e74 6f20 to move it into │ │ │ │ +00005a40: 4752 5542 322e 2020 5468 650a 7374 6172 GRUB2. The.star │ │ │ │ +00005a50: 7475 7020 6173 7365 6d62 6c79 2066 696c tup assembly fil │ │ │ │ +00005a60: 6520 676f 6573 2074 6f20 6772 7562 2d63 e goes to grub-c │ │ │ │ +00005a70: 6f72 652f 6b65 726e 2f24 6370 752f 2470 ore/kern/$cpu/$p │ │ │ │ +00005a80: 6c61 7466 6f72 6d2f 7374 6172 7475 702e latform/startup. │ │ │ │ +00005a90: 532e 0a59 6f75 2073 686f 756c 6420 616c S..You should al │ │ │ │ +00005aa0: 736f 2069 6e63 6c75 6465 2067 7275 622f so include grub/ │ │ │ │ +00005ab0: 7379 6d62 6f6c 2e68 2061 6e64 2072 6570 symbol.h and rep │ │ │ │ +00005ac0: 6c61 6365 2063 616c 6c20 746f 2065 6e74 lace call to ent │ │ │ │ +00005ad0: 7279 2070 6f69 6e74 0a77 6974 6820 6361 ry point.with ca │ │ │ │ +00005ae0: 6c6c 2074 6f20 4558 545f 4328 6772 7562 ll to EXT_C(grub │ │ │ │ +00005af0: 5f6d 6169 6e29 2e20 2054 6865 2043 2066 _main). The C f │ │ │ │ +00005b00: 696c 6520 676f 6573 2074 6f0a 6772 7562 ile goes to.grub │ │ │ │ +00005b10: 2d63 6f72 652f 6b65 726e 2f24 6370 752f -core/kern/$cpu/ │ │ │ │ +00005b20: 2470 6c61 7466 6f72 6d2f 696e 6974 2e63 $platform/init.c │ │ │ │ +00005b30: 2061 6e64 2069 7473 2065 6e74 7279 2070 and its entry p │ │ │ │ +00005b40: 6f69 6e74 2069 7320 7265 6e61 6d65 6420 oint is renamed │ │ │ │ +00005b50: 746f 0a76 6f69 6420 6772 7562 5f6d 6163 to.void grub_mac │ │ │ │ +00005b60: 6869 6e65 5f69 6e69 7420 2876 6f69 6429 hine_init (void) │ │ │ │ +00005b70: 2e20 204b 6565 7020 6669 6e61 6c20 696e . Keep final in │ │ │ │ +00005b80: 6669 6e69 7465 206c 6f6f 7020 666f 7220 finite loop for │ │ │ │ +00005b90: 6e6f 772e 2020 5374 7562 730a 6669 6c65 now. Stubs.file │ │ │ │ +00005ba0: 2069 6620 616e 7920 676f 6573 2074 6f20 if any goes to │ │ │ │ +00005bb0: 6772 7562 2d63 6f72 652f 6b65 726e 2f24 grub-core/kern/$ │ │ │ │ +00005bc0: 6370 752f 2470 6c61 7466 6f72 6d2f 6361 cpu/$platform/ca │ │ │ │ +00005bd0: 6c6c 7772 6170 2e53 2e20 536f 6d65 7469 llwrap.S. Someti │ │ │ │ +00005be0: 6d65 730a 6569 7468 6572 2024 6370 7520 mes.either $cpu │ │ │ │ +00005bf0: 6f72 2024 706c 6174 666f 726d 2069 7320 or $platform is │ │ │ │ +00005c00: 6472 6f70 7065 6420 6966 2066 696c 6520 dropped if file │ │ │ │ +00005c10: 6973 2075 7365 6420 6f6e 2073 6576 6572 is used on sever │ │ │ │ +00005c20: 616c 2063 7075 730a 7265 7370 6563 7469 al cpus.respecti │ │ │ │ +00005c30: 7665 6c79 706c 6174 666f 726d 732e 2020 velyplatforms. │ │ │ │ +00005c40: 4368 6563 6b20 7468 6f73 6520 6c6f 6361 Check those loca │ │ │ │ +00005c50: 7469 6f6e 7320 6966 2074 6865 7920 616c tions if they al │ │ │ │ +00005c60: 7265 6164 7920 6861 7665 2077 6861 740a ready have what. │ │ │ │ +00005c70: 796f 7527 7265 206c 6f6f 6b69 6e67 2066 you're looking f │ │ │ │ +00005c80: 6f72 2e0a 0a20 2020 5468 656e 206d 6f64 or... Then mod │ │ │ │ +00005c90: 6966 7920 696e 2063 6f6e 6669 6775 7265 ify in configure │ │ │ │ +00005ca0: 2e61 6320 7468 6520 666f 6c6c 6f77 696e .ac the followin │ │ │ │ +00005cb0: 6720 7061 7274 733a 0a0a 2020 2043 5055 g parts:.. CPU │ │ │ │ +00005cc0: 206e 616d 6573 3a0a 0a20 2020 2020 6361 names:.. ca │ │ │ │ +00005cd0: 7365 2022 2474 6172 6765 745f 6370 7522 se "$target_cpu" │ │ │ │ +00005ce0: 2069 6e0a 2020 2020 2020 2069 5b5b 3334 in. i[[34 │ │ │ │ +00005cf0: 3536 5d5d 3836 2909 7461 7267 6574 5f63 56]]86).target_c │ │ │ │ +00005d00: 7075 3d69 3338 3620 3b3b 0a20 2020 2020 pu=i386 ;;. │ │ │ │ +00005d10: 2020 616d 6436 3429 0974 6172 6765 745f amd64).target_ │ │ │ │ +00005d20: 6370 753d 7838 365f 3634 203b 3b0a 2020 cpu=x86_64 ;;. │ │ │ │ +00005d30: 2020 2020 2073 7061 7263 2909 7461 7267 sparc).targ │ │ │ │ +00005d40: 6574 5f63 7075 3d73 7061 7263 3634 203b et_cpu=sparc64 ; │ │ │ │ +00005d50: 3b0a 2020 2020 2020 2073 3339 3078 2909 ;. s390x). │ │ │ │ +00005d60: 7461 7267 6574 5f63 7075 3d73 3339 3020 target_cpu=s390 │ │ │ │ +00005d70: 3b3b 0a20 2020 2020 2020 2e2e 2e0a 2020 ;;. .... │ │ │ │ +00005d80: 2020 2065 7361 630a 0a20 2020 536f 6d65 esac.. Some │ │ │ │ +00005d90: 7469 6d65 7320 4350 5520 6861 7665 2061 times CPU have a │ │ │ │ +00005da0: 6464 6974 696f 6e61 6c20 6172 6368 6974 dditional archit │ │ │ │ +00005db0: 6563 7475 7265 206e 616d 6573 2077 6869 ecture names whi │ │ │ │ +00005dc0: 6368 2064 6f6e 2774 0a69 6e66 6c75 656e ch don't.influen │ │ │ │ +00005dd0: 6365 2062 6f6f 7469 6e67 2e20 2059 6f75 ce booting. You │ │ │ │ +00005de0: 206d 6967 6874 2077 616e 7420 746f 2068 might want to h │ │ │ │ +00005df0: 6176 6520 736f 6d65 2063 616e 6f6e 6963 ave some canonic │ │ │ │ +00005e00: 616c 206e 616d 6520 746f 2061 766f 6964 al name to avoid │ │ │ │ +00005e10: 0a68 6176 696e 6720 6275 6e63 6820 6f66 .having bunch of │ │ │ │ +00005e20: 2069 6465 6e74 6963 616c 2070 6c61 7466 identical platf │ │ │ │ +00005e30: 6f72 6d73 2077 6974 6820 6469 6666 6572 orms with differ │ │ │ │ +00005e40: 656e 7420 6e61 6d65 732e 0a0a 2020 204e ent names... N │ │ │ │ +00005e50: 4f54 453a 2069 7420 646f 6573 6e27 7420 OTE: it doesn't │ │ │ │ +00005e60: 696e 666c 7565 6e63 6520 636f 6d70 696c influence compil │ │ │ │ +00005e70: 6520 6f70 7469 6d69 7361 7469 6f6e 7320 e optimisations │ │ │ │ +00005e80: 7768 6963 6820 6465 7065 6e64 2073 6f6c which depend sol │ │ │ │ +00005e90: 656c 790a 6f6e 2063 686f 7365 6e20 636f ely.on chosen co │ │ │ │ +00005ea0: 6d70 696c 6572 2061 6e64 2063 6f6d 7069 mpiler and compi │ │ │ │ +00005eb0: 6c65 206f 7074 696f 6e73 2e0a 0a20 2020 le options... │ │ │ │ +00005ec0: 2020 6966 2074 6573 7420 2278 2477 6974 if test "x$wit │ │ │ │ +00005ed0: 685f 706c 6174 666f 726d 2220 3d20 783b h_platform" = x; │ │ │ │ +00005ee0: 2074 6865 6e0a 2020 2020 2020 2063 6173 then. cas │ │ │ │ +00005ef0: 6520 2224 7461 7267 6574 5f63 7075 222d e "$target_cpu"- │ │ │ │ +00005f00: 2224 7461 7267 6574 5f76 656e 646f 7222 "$target_vendor" │ │ │ │ +00005f10: 2069 6e0a 2020 2020 2020 2020 2069 3338 in. i38 │ │ │ │ +00005f20: 362d 6170 706c 6529 2070 6c61 7466 6f72 6-apple) platfor │ │ │ │ +00005f30: 6d3d 6566 6920 3b3b 0a20 2020 2020 2020 m=efi ;;. │ │ │ │ +00005f40: 2020 6933 3836 2d2a 2920 706c 6174 666f i386-*) platfo │ │ │ │ +00005f50: 726d 3d70 6320 3b3b 0a20 2020 2020 2020 rm=pc ;;. │ │ │ │ +00005f60: 2020 7838 365f 3634 2d61 7070 6c65 2920 x86_64-apple) │ │ │ │ +00005f70: 706c 6174 666f 726d 3d65 6669 203b 3b0a platform=efi ;;. │ │ │ │ +00005f80: 2020 2020 2020 2020 2078 3836 5f36 342d x86_64- │ │ │ │ +00005f90: 2a29 2070 6c61 7466 6f72 6d3d 7063 203b *) platform=pc ; │ │ │ │ +00005fa0: 3b0a 2020 2020 2020 2020 2070 6f77 6572 ;. power │ │ │ │ +00005fb0: 7063 2d2a 2920 706c 6174 666f 726d 3d69 pc-*) platform=i │ │ │ │ +00005fc0: 6565 6531 3237 3520 3b3b 0a20 2020 2020 eee1275 ;;. │ │ │ │ +00005fd0: 2020 2020 2e2e 2e0a 2020 2020 2020 2065 .... e │ │ │ │ +00005fe0: 7361 630a 2020 2020 2065 6c73 650a 2020 sac. else. │ │ │ │ +00005ff0: 2020 2020 202e 2e2e 0a20 2020 2020 6669 .... fi │ │ │ │ +00006000: 0a0a 2020 2054 6869 7320 7061 7274 2064 .. This part d │ │ │ │ +00006010: 6561 6c73 2077 6974 6820 6775 6573 7369 eals with guessi │ │ │ │ +00006020: 6e67 2074 6865 2070 6c61 7466 6f72 6d20 ng the platform │ │ │ │ +00006030: 6672 6f6d 2043 5055 2061 6e64 2076 656e from CPU and ven │ │ │ │ +00006040: 646f 722e 0a53 6f6d 6574 696d 6573 2079 dor..Sometimes y │ │ │ │ +00006050: 6f75 206e 6565 6420 746f 2075 7365 2033 ou need to use 3 │ │ │ │ +00006060: 322d 6269 7420 6d6f 6465 2066 6f72 2062 2-bit mode for b │ │ │ │ +00006070: 6f6f 7469 6e67 2065 7665 6e20 6966 204f ooting even if O │ │ │ │ +00006080: 5320 7275 6e73 2069 6e0a 3634 2d62 6974 S runs in.64-bit │ │ │ │ +00006090: 206f 6e65 2e20 2049 6620 736f 2061 6464 one. If so add │ │ │ │ +000060a0: 2079 6f75 7220 706c 6174 666f 726d 2074 your platform t │ │ │ │ +000060b0: 6f3a 0a0a 2020 2020 2063 6173 6520 2224 o:.. case "$ │ │ │ │ +000060c0: 7461 7267 6574 5f63 7075 222d 2224 706c target_cpu"-"$pl │ │ │ │ +000060d0: 6174 666f 726d 2220 696e 0a20 2020 2020 atform" in. │ │ │ │ +000060e0: 2020 7838 365f 3634 2d65 6669 2920 3b3b x86_64-efi) ;; │ │ │ │ +000060f0: 0a20 2020 2020 2020 7838 365f 3634 2d65 . x86_64-e │ │ │ │ +00006100: 6d75 2920 3b3b 0a20 2020 2020 2020 7838 mu) ;;. x8 │ │ │ │ +00006110: 365f 3634 2d2a 2920 7461 7267 6574 5f63 6_64-*) target_c │ │ │ │ +00006120: 7075 3d69 3338 3620 3b3b 0a20 2020 2020 pu=i386 ;;. │ │ │ │ +00006130: 2020 706f 7765 7270 6336 342d 6965 6565 powerpc64-ieee │ │ │ │ +00006140: 3132 3735 2920 7461 7267 6574 5f63 7075 1275) target_cpu │ │ │ │ +00006150: 3d70 6f77 6572 7063 203b 3b0a 2020 2020 =powerpc ;;. │ │ │ │ +00006160: 2065 7361 630a 0a20 2020 4164 6420 796f esac.. Add yo │ │ │ │ +00006170: 7572 2070 6c61 7466 6f72 6d20 746f 2074 ur platform to t │ │ │ │ +00006180: 6865 206c 6973 7420 6f66 2073 7570 706f he list of suppo │ │ │ │ +00006190: 7274 6564 206f 6e65 733a 0a0a 2020 2020 rted ones:.. │ │ │ │ +000061a0: 2063 6173 6520 2224 7461 7267 6574 5f63 case "$target_c │ │ │ │ +000061b0: 7075 222d 2224 706c 6174 666f 726d 2220 pu"-"$platform" │ │ │ │ +000061c0: 696e 0a20 2020 2020 2020 6933 3836 2d65 in. i386-e │ │ │ │ +000061d0: 6669 2920 3b3b 0a20 2020 2020 2020 7838 fi) ;;. x8 │ │ │ │ +000061e0: 365f 3634 2d65 6669 2920 3b3b 0a20 2020 6_64-efi) ;;. │ │ │ │ +000061f0: 2020 2020 6933 3836 2d70 6329 203b 3b0a i386-pc) ;;. │ │ │ │ +00006200: 2020 2020 2020 2069 3338 362d 6d75 6c74 i386-mult │ │ │ │ +00006210: 6962 6f6f 7429 203b 3b0a 2020 2020 2020 iboot) ;;. │ │ │ │ +00006220: 2069 3338 362d 636f 7265 626f 6f74 2920 i386-coreboot) │ │ │ │ +00006230: 3b3b 0a20 2020 2020 2020 2e2e 2e0a 2020 ;;. .... │ │ │ │ +00006240: 2020 2065 7361 630a 0a20 2020 4966 2065 esac.. If e │ │ │ │ +00006250: 7870 6c69 6369 7420 2d6d 3332 206f 7220 xplicit -m32 or │ │ │ │ +00006260: 2d6d 3634 2069 7320 6e65 6564 6564 2061 -m64 is needed a │ │ │ │ +00006270: 6464 2069 7420 746f 3a0a 0a20 2020 2020 dd it to:.. │ │ │ │ +00006280: 6361 7365 2022 2474 6172 6765 745f 6370 case "$target_cp │ │ │ │ +00006290: 7522 2069 6e0a 2020 2020 2020 2069 3338 u" in. i38 │ │ │ │ +000062a0: 3620 7c20 706f 7765 7270 6329 2074 6172 6 | powerpc) tar │ │ │ │ +000062b0: 6765 745f 6d33 323d 3120 3b3b 0a20 2020 get_m32=1 ;;. │ │ │ │ +000062c0: 2020 2020 7838 365f 3634 207c 2073 7061 x86_64 | spa │ │ │ │ +000062d0: 7263 3634 2920 7461 7267 6574 5f6d 3634 rc64) target_m64 │ │ │ │ +000062e0: 3d31 203b 3b0a 2020 2020 2065 7361 630a =1 ;;. esac. │ │ │ │ +000062f0: 0a20 2020 4669 6e61 6c6c 7920 796f 7520 . Finally you │ │ │ │ +00006300: 6e65 6564 2074 6f20 6164 6420 6120 636f need to add a co │ │ │ │ +00006310: 6e64 6974 696f 6e61 6c20 746f 2074 6865 nditional to the │ │ │ │ +00006320: 2066 6f6c 6c6f 7769 6e67 2062 6c6f 636b following block │ │ │ │ +00006330: 3a0a 0a20 2020 2020 414d 5f43 4f4e 4449 :.. AM_CONDI │ │ │ │ +00006340: 5449 4f4e 414c 285b 434f 4e44 5f6d 6970 TIONAL([COND_mip │ │ │ │ +00006350: 735f 6172 635d 2c20 5b74 6573 7420 7824 s_arc], [test x$ │ │ │ │ +00006360: 7461 7267 6574 5f63 7075 203d 2078 6d69 target_cpu = xmi │ │ │ │ +00006370: 7073 202d 6120 7824 706c 6174 666f 726d ps -a x$platform │ │ │ │ +00006380: 203d 2078 6172 635d 290a 2020 2020 2041 = xarc]). A │ │ │ │ +00006390: 4d5f 434f 4e44 4954 494f 4e41 4c28 5b43 M_CONDITIONAL([C │ │ │ │ +000063a0: 4f4e 445f 7370 6172 6336 345f 6965 6565 OND_sparc64_ieee │ │ │ │ +000063b0: 3132 3735 5d2c 205b 7465 7374 2078 2474 1275], [test x$t │ │ │ │ +000063c0: 6172 6765 745f 6370 7520 3d20 7873 7061 arget_cpu = xspa │ │ │ │ +000063d0: 7263 3634 202d 6120 7824 706c 6174 666f rc64 -a x$platfo │ │ │ │ +000063e0: 726d 203d 2078 6965 6565 3132 3735 5d29 rm = xieee1275]) │ │ │ │ +000063f0: 0a20 2020 2020 414d 5f43 4f4e 4449 5449 . AM_CONDITI │ │ │ │ +00006400: 4f4e 414c 285b 434f 4e44 5f70 6f77 6572 ONAL([COND_power │ │ │ │ +00006410: 7063 5f69 6565 6531 3237 355d 2c20 5b74 pc_ieee1275], [t │ │ │ │ +00006420: 6573 7420 7824 7461 7267 6574 5f63 7075 est x$target_cpu │ │ │ │ +00006430: 203d 2078 706f 7765 7270 6320 2d61 2078 = xpowerpc -a x │ │ │ │ +00006440: 2470 6c61 7466 6f72 6d20 3d20 7869 6565 $platform = xiee │ │ │ │ +00006450: 6531 3237 355d 290a 0a20 2020 4e65 7874 e1275]).. Next │ │ │ │ +00006460: 2073 746f 7020 6973 2067 656e 7470 6c2e stop is gentpl. │ │ │ │ +00006470: 7079 2e20 2059 6f75 206e 6565 6420 746f py. You need to │ │ │ │ +00006480: 2061 6464 2079 6f75 7220 706c 6174 666f add your platfo │ │ │ │ +00006490: 726d 2074 6f20 7468 6520 6c69 7374 206f rm to the list o │ │ │ │ +000064a0: 660a 7375 7070 6f72 7465 6420 6f6e 6573 f.supported ones │ │ │ │ +000064b0: 2028 736f 7272 7920 7468 6174 2074 6869 (sorry that thi │ │ │ │ +000064c0: 7320 6c69 7374 2069 7320 6475 706c 6963 s list is duplic │ │ │ │ +000064d0: 6174 6564 293a 0a0a 2020 2020 2047 5255 ated):.. GRU │ │ │ │ +000064e0: 425f 504c 4154 464f 524d 5320 3d20 5b20 B_PLATFORMS = [ │ │ │ │ +000064f0: 2265 6d75 222c 2022 6933 3836 5f70 6322 "emu", "i386_pc" │ │ │ │ +00006500: 2c20 2269 3338 365f 6566 6922 2c20 2269 , "i386_efi", "i │ │ │ │ +00006510: 3338 365f 7165 6d75 222c 2022 6933 3836 386_qemu", "i386 │ │ │ │ +00006520: 5f63 6f72 6562 6f6f 7422 2c0a 2020 2020 _coreboot",. │ │ │ │ 00006530: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00006540: 2269 3338 365f 6d75 6c74 6962 6f6f 7422 "i386_multiboot" │ │ │ │ -00006550: 2c20 2269 3338 365f 6965 6565 3132 3735 , "i386_ieee1275 │ │ │ │ -00006560: 222c 2022 7838 365f 3634 5f65 6669 222c ", "x86_64_efi", │ │ │ │ -00006570: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ -00006580: 2020 2020 2020 2020 2022 6d69 7073 5f6c "mips_l │ │ │ │ -00006590: 6f6f 6e67 736f 6e22 2c20 2273 7061 7263 oongson", "sparc │ │ │ │ -000065a0: 3634 5f69 6565 6531 3237 3522 2c0a 2020 64_ieee1275",. │ │ │ │ -000065b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -000065c0: 2020 2020 2020 2270 6f77 6572 7063 5f69 "powerpc_i │ │ │ │ -000065d0: 6565 6531 3237 3522 2c20 226d 6970 735f eee1275", "mips_ │ │ │ │ -000065e0: 6172 6322 2c20 2269 6136 345f 6566 6922 arc", "ia64_efi" │ │ │ │ -000065f0: 2c0a 2020 2020 2020 2020 2020 2020 2020 ,. │ │ │ │ -00006600: 2020 2020 2020 2020 2020 226d 6970 735f "mips_ │ │ │ │ -00006610: 7165 6d75 5f6d 6970 7322 2c20 2273 3339 qemu_mips", "s39 │ │ │ │ -00006620: 305f 6d61 696e 6672 616d 6522 205d 0a0a 0_mainframe" ].. │ │ │ │ -00006630: 2020 2059 6f75 206d 6179 2061 6c73 6f20 You may also │ │ │ │ -00006640: 7761 6e74 2061 6c72 6561 6479 2074 6f20 want already to │ │ │ │ -00006650: 6164 6420 6e65 7720 706c 6174 666f 726d add new platform │ │ │ │ -00006660: 2074 6f20 6f6e 6520 6f72 2073 6576 6572 to one or sever │ │ │ │ -00006670: 616c 206f 660a 6176 6169 6c61 626c 6520 al of.available │ │ │ │ -00006680: 6772 6f75 7073 2e20 2049 6e20 7061 7274 groups. In part │ │ │ │ -00006690: 6963 756c 6172 2077 6520 616c 7761 7973 icular we always │ │ │ │ -000066a0: 2068 6176 6520 6120 6772 6f75 7020 666f have a group fo │ │ │ │ -000066b0: 7220 6561 6368 2043 5055 0a65 7665 6e20 r each CPU.even │ │ │ │ -000066c0: 7768 656e 206f 6e6c 7920 6f6e 6520 706c when only one pl │ │ │ │ -000066d0: 6174 666f 726d 2066 6f72 2067 6976 656e atform for given │ │ │ │ -000066e0: 2043 5055 2069 7320 6176 6169 6c61 626c CPU is availabl │ │ │ │ -000066f0: 652e 0a0a 2020 2054 6865 6e20 636f 6d65 e... Then come │ │ │ │ -00006700: 7320 6772 7562 2d63 6f72 652f 4d61 6b65 s grub-core/Make │ │ │ │ -00006710: 6669 6c65 2e63 6f72 652e 6465 662e 2020 file.core.def. │ │ │ │ -00006720: 496e 2074 6865 2062 6c6f 636b 2022 6b65 In the block "ke │ │ │ │ -00006730: 726e 656c 2220 796f 7527 6c6c 0a6e 6565 rnel" you'll.nee │ │ │ │ -00006740: 6420 746f 2064 6566 696e 6520 6c64 666c d to define ldfl │ │ │ │ -00006750: 6167 7320 666f 7220 796f 7572 2070 6c61 ags for your pla │ │ │ │ -00006760: 7466 6f72 6d20 2824 6370 755f 2470 6c61 tform ($cpu_$pla │ │ │ │ -00006770: 7466 6f72 6d5f 6c64 666c 6167 7329 2e20 tform_ldflags). │ │ │ │ -00006780: 2059 6f75 0a61 6c73 6f20 6e65 6564 2074 You.also need t │ │ │ │ -00006790: 6f20 6465 636c 6172 6520 7374 6172 7475 o declare startu │ │ │ │ -000067a0: 7020 6173 6d20 6669 6c65 2028 2463 7075 p asm file ($cpu │ │ │ │ -000067b0: 5f24 706c 6174 666f 726d 5f73 7461 7274 _$platform_start │ │ │ │ -000067c0: 7570 2920 6173 2077 656c 6c0a 6173 2061 up) as well.as a │ │ │ │ -000067d0: 6e79 206f 7468 6572 2066 696c 6573 2028 ny other files ( │ │ │ │ -000067e0: 652e 672e 2020 696e 6974 2e63 2061 6e64 e.g. init.c and │ │ │ │ -000067f0: 2063 616c 6c77 7261 702e 5329 2028 652e callwrap.S) (e. │ │ │ │ -00006800: 672e 2020 2463 7075 5f24 706c 6174 666f g. $cpu_$platfo │ │ │ │ -00006810: 726d 203d 0a6b 6572 6e2f 2463 7075 2f24 rm =.kern/$cpu/$ │ │ │ │ -00006820: 706c 6174 666f 726d 2f69 6e69 742e 6329 platform/init.c) │ │ │ │ -00006830: 2e20 2041 7420 7468 6973 2073 7461 6765 . At this stage │ │ │ │ -00006840: 2079 6f75 2077 696c 6c20 616c 736f 206e you will also n │ │ │ │ -00006850: 6565 6420 746f 2061 6464 0a64 756d 6d79 eed to add.dummy │ │ │ │ -00006860: 2064 6c2e 6320 616e 6420 6361 6368 652e dl.c and cache. │ │ │ │ -00006870: 5320 7769 7468 2066 756e 6374 696f 6e73 S with functions │ │ │ │ -00006880: 2067 7275 625f 6572 725f 740a 6772 7562 grub_err_t.grub │ │ │ │ -00006890: 5f61 7263 685f 646c 5f63 6865 636b 5f68 _arch_dl_check_h │ │ │ │ -000068a0: 6561 6465 7220 2876 6f69 6420 2a65 6864 eader (void *ehd │ │ │ │ -000068b0: 7229 2c20 6772 7562 5f65 7272 5f74 0a67 r), grub_err_t.g │ │ │ │ -000068c0: 7275 625f 6172 6368 5f64 6c5f 7265 6c6f rub_arch_dl_relo │ │ │ │ -000068d0: 6361 7465 5f73 796d 626f 6c73 2028 6772 cate_symbols (gr │ │ │ │ -000068e0: 7562 5f64 6c5f 7420 6d6f 642c 2076 6f69 ub_dl_t mod, voi │ │ │ │ -000068f0: 6420 2a65 6864 7229 2028 646c 2e63 2920 d *ehdr) (dl.c) │ │ │ │ -00006900: 616e 640a 766f 6964 2067 7275 625f 6172 and.void grub_ar │ │ │ │ -00006910: 6368 5f73 796e 635f 6361 6368 6573 2028 ch_sync_caches ( │ │ │ │ -00006920: 766f 6964 202a 6164 6472 6573 732c 2067 void *address, g │ │ │ │ -00006930: 7275 625f 7369 7a65 5f74 206c 656e 2920 rub_size_t len) │ │ │ │ -00006940: 2863 6163 6865 2e53 292e 0a54 6865 7920 (cache.S)..They │ │ │ │ -00006950: 776f 6e27 7420 6265 2075 7365 6420 666f won't be used fo │ │ │ │ -00006960: 7220 6e6f 772e 0a0a 2020 2059 6f75 2077 r now... You w │ │ │ │ -00006970: 696c 6c20 6e65 6564 2074 6f20 6372 6561 ill need to crea │ │ │ │ -00006980: 7465 2064 6972 6563 746f 7279 2069 6e63 te directory inc │ │ │ │ -00006990: 6c75 6465 2f24 6370 752f 2470 6c61 7466 lude/$cpu/$platf │ │ │ │ -000069a0: 6f72 6d20 616e 6420 6120 6669 6c65 0a69 orm and a file.i │ │ │ │ -000069b0: 6e63 6c75 6465 2f24 6370 752f 7479 7065 nclude/$cpu/type │ │ │ │ -000069c0: 732e 682e 2020 5468 6520 6c61 7465 7220 s.h. The later │ │ │ │ -000069d0: 666f 6c6f 7769 6e67 2074 6869 7320 7465 folowing this te │ │ │ │ -000069e0: 6d70 6c61 7465 3a0a 0a20 2020 2020 2369 mplate:.. #i │ │ │ │ -000069f0: 666e 6465 6620 4752 5542 5f54 5950 4553 fndef GRUB_TYPES │ │ │ │ -00006a00: 5f43 5055 5f48 4541 4445 520a 2020 2020 _CPU_HEADER. │ │ │ │ -00006a10: 2023 6465 6669 6e65 2047 5255 425f 5459 #define GRUB_TY │ │ │ │ -00006a20: 5045 535f 4350 555f 4845 4144 4552 0931 PES_CPU_HEADER.1 │ │ │ │ -00006a30: 0a0a 2020 2020 202f 2a20 5468 6520 7369 .. /* The si │ │ │ │ -00006a40: 7a65 206f 6620 766f 6964 202a 2e20 202a ze of void *. * │ │ │ │ -00006a50: 2f0a 2020 2020 2023 6465 6669 6e65 2047 /. #define G │ │ │ │ -00006a60: 5255 425f 5441 5247 4554 5f53 495a 454f RUB_TARGET_SIZEO │ │ │ │ -00006a70: 465f 564f 4944 5f50 0934 0a0a 2020 2020 F_VOID_P.4.. │ │ │ │ -00006a80: 202f 2a20 5468 6520 7369 7a65 206f 6620 /* The size of │ │ │ │ -00006a90: 6c6f 6e67 2e20 202a 2f0a 2020 2020 2023 long. */. # │ │ │ │ -00006aa0: 6465 6669 6e65 2047 5255 425f 5441 5247 define GRUB_TARG │ │ │ │ -00006ab0: 4554 5f53 495a 454f 465f 4c4f 4e47 0909 ET_SIZEOF_LONG.. │ │ │ │ -00006ac0: 340a 0a20 2020 2020 2f2a 206d 7963 7075 4.. /* mycpu │ │ │ │ -00006ad0: 2069 7320 6269 672d 656e 6469 616e 2e20 is big-endian. │ │ │ │ -00006ae0: 202a 2f0a 2020 2020 2023 6465 6669 6e65 */. #define │ │ │ │ -00006af0: 2047 5255 425f 5441 5247 4554 5f57 4f52 GRUB_TARGET_WOR │ │ │ │ -00006b00: 4453 5f42 4947 454e 4449 414e 0931 0a20 DS_BIGENDIAN.1. │ │ │ │ -00006b10: 2020 2020 2f2a 2041 6c74 6572 6e61 7469 /* Alternati │ │ │ │ -00006b20: 7665 6c79 3a20 6d79 6370 7520 6973 206c vely: mycpu is l │ │ │ │ -00006b30: 6974 746c 652d 656e 6469 616e 2e20 202a ittle-endian. * │ │ │ │ -00006b40: 2f0a 2020 2020 2023 756e 6465 6620 4752 /. #undef GR │ │ │ │ -00006b50: 5542 5f54 4152 4745 545f 574f 5244 535f UB_TARGET_WORDS_ │ │ │ │ -00006b60: 4249 4745 4e44 4941 4e0a 0a20 2020 2020 BIGENDIAN.. │ │ │ │ -00006b70: 2365 6e64 6966 202f 2a20 2120 4752 5542 #endif /* ! GRUB │ │ │ │ -00006b80: 5f54 5950 4553 5f43 5055 5f48 4541 4445 _TYPES_CPU_HEADE │ │ │ │ -00006b90: 5220 2a2f 0a0a 2020 2059 6f75 2077 696c R */.. You wil │ │ │ │ -00006ba0: 6c20 616c 736f 206e 6565 6420 746f 2061 l also need to a │ │ │ │ -00006bb0: 6464 2061 2064 756d 6d79 2066 696c 6520 dd a dummy file │ │ │ │ -00006bc0: 746f 2064 6174 6574 696d 6520 616e 6420 to datetime and │ │ │ │ -00006bd0: 7365 746a 6d70 206d 6f64 756c 6573 0a74 setjmp modules.t │ │ │ │ -00006be0: 6f20 6176 6f69 6420 616e 7920 6f66 2069 o avoid any of i │ │ │ │ -00006bf0: 7420 6861 7669 6e67 206e 6f20 6669 6c65 t having no file │ │ │ │ -00006c00: 732e 2020 4974 2063 616e 2062 6520 6a75 s. It can be ju │ │ │ │ -00006c10: 7374 2063 6f6d 706c 6574 656c 7920 656d st completely em │ │ │ │ -00006c20: 7074 7920 6174 0a74 6869 7320 7374 6167 pty at.this stag │ │ │ │ -00006c30: 652e 0a0a 2020 2059 6f75 276c 6c20 6e65 e... You'll ne │ │ │ │ -00006c40: 6564 2074 6f20 6d61 6b65 2067 7275 622d ed to make grub- │ │ │ │ -00006c50: 6d6b 696d 6167 652e 6320 2875 7469 6c2f mkimage.c (util/ │ │ │ │ -00006c60: 6772 7562 5f6d 6b69 6d61 6765 2e63 2920 grub_mkimage.c) │ │ │ │ -00006c70: 6177 6172 6520 6f66 2074 6865 0a6e 6565 aware of the.nee │ │ │ │ -00006c80: 6465 6420 666f 726d 6174 2e20 2046 6f72 ded format. For │ │ │ │ -00006c90: 206d 6f73 7420 636f 6d6d 6f6e 6c79 2075 most commonly u │ │ │ │ -00006ca0: 7365 6420 666f 726d 6174 7320 6c69 6b65 sed formats like │ │ │ │ -00006cb0: 2045 4c46 2c20 5045 2c20 616f 7574 206f ELF, PE, aout o │ │ │ │ -00006cc0: 7220 7261 770a 7468 6520 7375 7070 6f72 r raw.the suppor │ │ │ │ -00006cd0: 7420 6973 2061 6c72 6561 6479 2070 7265 t is already pre │ │ │ │ -00006ce0: 7365 6e74 2061 6e64 2079 6f75 276c 6c20 sent and you'll │ │ │ │ -00006cf0: 6e65 6564 2074 6f20 6d61 6b65 2069 7420 need to make it │ │ │ │ -00006d00: 666f 6c6c 6f77 2074 6865 0a65 7869 7374 follow the.exist │ │ │ │ -00006d10: 616e 7420 636f 6465 2070 6174 6873 2066 ant code paths f │ │ │ │ -00006d20: 6f72 2079 6f75 7220 706c 6174 666f 726d or your platform │ │ │ │ -00006d30: 2061 6464 696e 6720 6164 6a75 7374 6d65 adding adjustme │ │ │ │ -00006d40: 6e74 7320 6966 206e 6563 6573 7361 7279 nts if necessary │ │ │ │ -00006d50: 2e0a 5768 656e 2064 6f6e 6520 636f 6d70 ..When done comp │ │ │ │ -00006d60: 696c 653a 0a0a 2020 2020 202e 2f62 6f6f ile:.. ./boo │ │ │ │ -00006d70: 7473 7472 6170 0a20 2020 2020 2e2f 636f tstrap. ./co │ │ │ │ -00006d80: 6e66 6967 7572 6520 2d2d 7461 7267 6574 nfigure --target │ │ │ │ -00006d90: 3d24 6370 7520 2d2d 7769 7468 2d70 6c61 =$cpu --with-pla │ │ │ │ -00006da0: 7466 6f72 6d3d 2470 6c61 7466 6f72 6d20 tform=$platform │ │ │ │ -00006db0: 5441 5247 4554 5f43 433d 2e2e 204f 424a TARGET_CC=.. OBJ │ │ │ │ -00006dc0: 434f 5059 3d2e 2e2e 2053 5452 4950 3d2e COPY=... STRIP=. │ │ │ │ -00006dd0: 2e2e 0a20 2020 2020 6d61 6b65 203e 202f ... make > / │ │ │ │ -00006de0: 6465 762f 6e75 6c6c 0a0a 2020 2041 6e64 dev/null.. And │ │ │ │ -00006df0: 2063 7265 6174 6520 696d 6167 650a 0a20 create image.. │ │ │ │ -00006e00: 2020 2020 2e2f 6772 7562 2d6d 6b69 6d61 ./grub-mkima │ │ │ │ -00006e10: 6765 202d 6420 6772 7562 2d63 6f72 6520 ge -d grub-core │ │ │ │ -00006e20: 2d4f 2024 666f 726d 6174 5f69 6420 2d6f -O $format_id -o │ │ │ │ -00006e30: 2074 6573 742e 696d 670a 0a20 2020 416e test.img.. An │ │ │ │ -00006e40: 6420 6974 2773 2074 696d 6520 746f 2074 d it's time to t │ │ │ │ -00006e50: 6573 7420 796f 7572 2074 6573 742e 696d est your test.im │ │ │ │ -00006e60: 672e 0a0a 2020 2049 6620 6974 2077 6f72 g... If it wor │ │ │ │ -00006e70: 6b73 206e 6578 7420 7374 6167 6520 6973 ks next stage is │ │ │ │ -00006e80: 2074 6f20 6861 7665 2068 6561 702c 2063 to have heap, c │ │ │ │ -00006e90: 6f6e 736f 6c65 2061 6e64 2074 696d 6572 onsole and timer │ │ │ │ -00006ea0: 2e0a 0a20 2020 546f 2068 6176 6520 7468 ... To have th │ │ │ │ -00006eb0: 6520 6865 6170 2077 6f72 6b69 6e67 2079 e heap working y │ │ │ │ -00006ec0: 6f75 206e 6565 6420 746f 2064 6574 6572 ou need to deter │ │ │ │ -00006ed0: 6d69 6e65 2077 6869 6368 2072 6567 696f mine which regio │ │ │ │ -00006ee0: 6e73 2061 7265 0a73 7569 7461 626c 6520 ns are.suitable │ │ │ │ -00006ef0: 666f 7220 6865 6170 2075 7361 6765 2c20 for heap usage, │ │ │ │ -00006f00: 616c 6c6f 6361 7465 2074 6865 6d20 6672 allocate them fr │ │ │ │ -00006f10: 6f6d 2066 6972 6d77 6172 6520 616e 6420 om firmware and │ │ │ │ -00006f20: 6d61 7020 2869 660a 6170 706c 6963 6162 map (if.applicab │ │ │ │ -00006f30: 6c65 292e 2020 5468 656e 2063 616c 6c20 le). Then call │ │ │ │ -00006f40: 6772 7562 5f6d 6d5f 696e 6974 5f72 6567 grub_mm_init_reg │ │ │ │ -00006f50: 696f 6e20 2876 6f69 7320 2a73 7461 7274 ion (vois *start │ │ │ │ -00006f60: 2c20 6772 7562 5f73 697a 655f 7420 7329 , grub_size_t s) │ │ │ │ -00006f70: 0a66 6f72 2065 7665 7279 206f 6620 7468 .for every of th │ │ │ │ -00006f80: 6973 2072 6567 696f 6e2e 2020 4173 2061 is region. As a │ │ │ │ -00006f90: 2073 686f 7274 6375 7420 666f 7220 6561 shortcut for ea │ │ │ │ -00006fa0: 726c 7920 706f 7274 2079 6f75 2063 616e rly port you can │ │ │ │ -00006fb0: 2061 6c6c 6f63 6174 650a 7269 6768 7420 allocate.right │ │ │ │ -00006fc0: 6166 7465 7220 5f65 6e64 206f 7220 6861 after _end or ha │ │ │ │ -00006fd0: 7665 2061 2062 6967 2073 7461 7469 6320 ve a big static │ │ │ │ -00006fe0: 6172 7261 7920 666f 7220 6865 6170 2e20 array for heap. │ │ │ │ -00006ff0: 2049 6620 796f 7520 646f 2079 6f75 276c If you do you'l │ │ │ │ -00007000: 6c0a 7072 6f62 6162 6c79 206e 6565 6420 l.probably need │ │ │ │ -00007010: 746f 2063 6f6d 6520 6261 636b 2074 6f20 to come back to │ │ │ │ -00007020: 7468 6973 206c 6174 6572 2e20 2041 7320 this later. As │ │ │ │ -00007030: 666f 7220 6f75 7470 7574 2063 6f6e 736f for output conso │ │ │ │ -00007040: 6c65 2079 6f75 0a73 686f 756c 6420 6469 le you.should di │ │ │ │ -00007050: 7374 696e 6775 6973 6820 6265 7477 6565 stinguish betwee │ │ │ │ -00007060: 6e20 616e 2061 7272 6179 206f 6620 7465 n an array of te │ │ │ │ -00007070: 7874 2c20 7465 726d 696e 666f 206f 7220 xt, terminfo or │ │ │ │ -00007080: 6772 6170 6869 6373 2d62 6173 6564 0a63 graphics-based.c │ │ │ │ -00007090: 6f6e 736f 6c65 2e20 204d 616e 7920 6f66 onsole. Many of │ │ │ │ -000070a0: 2072 6561 6c2d 776f 726c 6420 6578 616d real-world exam │ │ │ │ -000070b0: 706c 6573 2064 6f6e 2774 2066 6974 2070 ples don't fit p │ │ │ │ -000070c0: 6572 6665 6374 6c79 2069 6e74 6f20 616e erfectly into an │ │ │ │ -000070d0: 7920 6f66 0a74 6865 7365 2063 6174 6567 y of.these categ │ │ │ │ -000070e0: 6f72 6965 7320 6275 7420 6f6e 6520 6f66 ories but one of │ │ │ │ -000070f0: 2074 6865 206d 6f64 656c 7320 6973 2065 the models is e │ │ │ │ -00007100: 6173 6965 7220 746f 2062 6520 7573 6564 asier to be used │ │ │ │ -00007110: 2061 7320 6261 7365 2e20 2049 6e0a 7365 as base. In.se │ │ │ │ -00007120: 636f 6e64 2061 6e64 2074 6869 7264 2063 cond and third c │ │ │ │ -00007130: 6173 6520 796f 7520 7368 6f75 6c64 2061 ase you should a │ │ │ │ -00007140: 6464 2079 6f75 7220 706c 6174 666f 726d dd your platform │ │ │ │ -00007150: 2074 6f20 7465 726d 696e 666f 6b65 726e to terminfokern │ │ │ │ -00007160: 656c 0a72 6573 7065 6374 6976 656c 7920 el.respectively │ │ │ │ -00007170: 7669 6465 6f69 6e6b 6572 6e65 6c20 6772 videoinkernel gr │ │ │ │ -00007180: 6f75 702e 2020 4120 676f 6f64 2065 7861 oup. A good exa │ │ │ │ -00007190: 6d70 6c65 206f 6620 6172 7261 7920 6f66 mple of array of │ │ │ │ -000071a0: 2074 6578 7420 6973 0a69 3338 362d 7063 text is.i386-pc │ │ │ │ -000071b0: 2028 6b65 726e 2f69 3338 362f 7063 2f69 (kern/i386/pc/i │ │ │ │ -000071c0: 6e69 742e 6320 616e 6420 7465 726d 2f69 nit.c and term/i │ │ │ │ -000071d0: 3338 362f 7063 2f63 6f6e 736f 6c65 2e63 386/pc/console.c │ │ │ │ -000071e0: 292e 2020 4f66 2074 6572 6d69 6e66 6f0a ). Of terminfo. │ │ │ │ -000071f0: 6973 2069 6565 6531 3237 3520 286b 6572 is ieee1275 (ker │ │ │ │ -00007200: 6e2f 6965 6565 3132 3735 2f69 6e69 742e n/ieee1275/init. │ │ │ │ -00007210: 6320 616e 6420 7465 726d 2f69 6565 6531 c and term/ieee1 │ │ │ │ -00007220: 3237 352f 636f 6e73 6f6c 652e 6329 2e20 275/console.c). │ │ │ │ -00007230: 204f 660a 7669 6465 6f20 6973 206c 6f6f Of.video is loo │ │ │ │ -00007240: 6e67 736f 6e20 286b 6572 6e2f 6d69 7073 ngson (kern/mips │ │ │ │ -00007250: 2f6c 6f6f 6e67 736f 6e2f 696e 6974 2e63 /loongson/init.c │ │ │ │ -00007260: 292e 2020 4e6f 7465 2074 6861 7420 7465 ). Note that te │ │ │ │ -00007270: 726d 696e 666f 2068 6173 0a74 6f20 6265 rminfo has.to be │ │ │ │ -00007280: 2069 6e69 7465 6420 696e 2032 2073 7461 inited in 2 sta │ │ │ │ -00007290: 6765 733a 206f 6e65 2062 6566 6f72 6520 ges: one before │ │ │ │ -000072a0: 2874 6f20 6765 7420 6174 206c 6561 7374 (to get at least │ │ │ │ -000072b0: 2072 7564 696d 656e 7461 7279 0a63 6f6e rudimentary.con │ │ │ │ -000072c0: 736f 6c65 2061 7320 6561 726c 7920 6173 sole as early as │ │ │ │ -000072d0: 2070 6f73 7369 626c 6529 2061 6e64 2061 possible) and a │ │ │ │ -000072e0: 6e6f 7468 6572 2061 6674 6572 2074 6865 nother after the │ │ │ │ -000072f0: 2068 6561 7020 2874 6f20 6765 740a 6675 heap (to get.fu │ │ │ │ -00007300: 6c6c 2d66 6561 7475 7265 6420 636f 6e73 ll-featured cons │ │ │ │ -00007310: 6f6c 6529 2e20 2046 6f72 2074 6865 2069 ole). For the i │ │ │ │ -00007320: 6e70 7574 2074 6865 7265 2061 7265 2073 nput there are s │ │ │ │ -00007330: 7472 696e 6720 6f66 206b 6579 732c 0a74 tring of keys,.t │ │ │ │ -00007340: 6572 6d69 6e66 6f20 616e 6420 6469 7265 erminfo and dire │ │ │ │ -00007350: 6374 2068 6172 6477 6172 652e 2020 466f ct hardware. Fo │ │ │ │ -00007360: 7220 7374 7269 6e67 206f 6620 6b65 7973 r string of keys │ │ │ │ -00007370: 206c 6f6f 6b20 6174 2069 3338 362d 7063 look at i386-pc │ │ │ │ -00007380: 2028 7361 6d65 0a66 696c 6573 292c 2066 (same.files), f │ │ │ │ -00007390: 6f72 2074 6572 6d69 6e6f 2069 6565 6531 or termino ieee1 │ │ │ │ -000073a0: 3237 3520 2873 616d 6520 6669 6c65 7329 275 (same files) │ │ │ │ -000073b0: 2061 6e64 2066 6f72 2068 6172 6477 6172 and for hardwar │ │ │ │ -000073c0: 6520 6c6f 6f6e 6773 6f6e 0a28 6b65 726e e loongson.(kern │ │ │ │ -000073d0: 2f6d 6970 732f 6c6f 6f6e 6773 6f6e 2f69 /mips/loongson/i │ │ │ │ -000073e0: 6e69 742e 6320 616e 6420 7465 726d 2f61 nit.c and term/a │ │ │ │ -000073f0: 745f 6b65 7962 6f61 7264 2e63 292e 0a0a t_keyboard.c)... │ │ │ │ -00007400: 2020 2046 6f72 2074 6865 2074 696d 6572 For the timer │ │ │ │ -00007410: 2079 6f75 276c 6c20 6e65 6564 2074 6f20 you'll need to │ │ │ │ -00007420: 6361 6c6c 2067 7275 625f 696e 7374 616c call grub_instal │ │ │ │ -00007430: 6c5f 6765 745f 7469 6d65 5f6d 7320 282e l_get_time_ms (. │ │ │ │ -00007440: 2e2e 290a 7769 7468 2061 7320 736f 6c65 ..).with as sole │ │ │ │ -00007450: 2061 7267 756d 656e 7420 6120 6675 6e63 argument a func │ │ │ │ -00007460: 7469 6f6e 2072 6574 7572 6e69 6e67 2061 tion returning a │ │ │ │ -00007470: 2067 7275 625f 7569 6e74 3634 5f74 206f grub_uint64_t o │ │ │ │ -00007480: 6620 6120 6e75 6d62 6572 0a6f 6620 6d69 f a number.of mi │ │ │ │ -00007490: 6c6c 6973 6563 6f6e 6473 2065 6c61 7073 lliseconds elaps │ │ │ │ -000074a0: 6564 2073 696e 6365 2061 7262 6974 7261 ed since arbitra │ │ │ │ -000074b0: 7279 2070 6f69 6e74 2069 6e20 7468 6520 ry point in the │ │ │ │ -000074c0: 7061 7374 2e0a 0a20 2020 4f6e 6365 2074 past... Once t │ │ │ │ -000074d0: 6865 7365 2073 7465 7073 2061 6363 6f6d hese steps accom │ │ │ │ -000074e0: 706c 6973 6865 6420 796f 7520 6361 6e20 plished you can │ │ │ │ -000074f0: 7265 6d6f 7665 2074 6865 2069 6e69 6669 remove the inifi │ │ │ │ -00007500: 6e69 7465 206c 6f6f 7020 616e 640a 796f nite loop and.yo │ │ │ │ -00007510: 7520 7368 6f75 6c64 2062 6520 6162 6c65 u should be able │ │ │ │ -00007520: 2074 6f20 6765 7420 746f 2074 6865 206d to get to the m │ │ │ │ -00007530: 696e 696d 616c 2063 6f6e 736f 6c65 2e20 inimal console. │ │ │ │ -00007540: 204e 6578 7420 7374 6570 2069 7320 746f Next step is to │ │ │ │ -00007550: 2068 6176 650a 6d6f 6475 6c65 206c 6f61 have.module loa │ │ │ │ -00007560: 6469 6e67 2077 6f72 6b69 6e67 2e20 2046 ding working. F │ │ │ │ -00007570: 6f72 2074 6869 7320 796f 7527 6c6c 206e or this you'll n │ │ │ │ -00007580: 6565 6420 746f 2066 696c 6c20 6b65 726e eed to fill kern │ │ │ │ -00007590: 2f24 6370 752f 646c 2e63 2061 6e64 0a6b /$cpu/dl.c and.k │ │ │ │ -000075a0: 6572 6e2f 2463 7075 2f63 6163 6865 2e53 ern/$cpu/cache.S │ │ │ │ -000075b0: 2077 6974 6820 7265 616c 2068 616e 646c with real handl │ │ │ │ -000075c0: 696e 6720 6f66 2072 656c 6f63 6174 696f ing of relocatio │ │ │ │ -000075d0: 6e73 2061 6e64 2072 6573 7065 6374 6976 ns and respectiv │ │ │ │ -000075e0: 656c 7920 7468 650a 7265 616c 2073 796e ely the.real syn │ │ │ │ -000075f0: 6320 6f66 2049 2061 6e64 2044 2063 6163 c of I and D cac │ │ │ │ -00007600: 6865 732e 2020 416c 736f 2079 6f75 276c hes. Also you'l │ │ │ │ -00007610: 6c20 6e65 6564 2074 6f20 6465 6369 6465 l need to decide │ │ │ │ -00007620: 2077 6865 7265 2069 6e20 7468 650a 696d where in the.im │ │ │ │ -00007630: 6167 6520 746f 2073 746f 7265 2074 6865 age to store the │ │ │ │ -00007640: 206d 6f64 756c 6573 2e20 2055 7375 616c modules. Usual │ │ │ │ -00007650: 2077 6179 2069 7320 746f 2068 6176 6520 way is to have │ │ │ │ -00007660: 6974 2063 6f6e 6361 7465 6e61 7465 6420 it concatenated │ │ │ │ -00007670: 6174 2074 6865 0a65 6e64 2e20 2049 6e20 at the.end. In │ │ │ │ -00007680: 7468 6973 2063 6173 6520 796f 7527 6c6c this case you'll │ │ │ │ -00007690: 206e 6565 6420 746f 206d 6f64 6966 7920 need to modify │ │ │ │ -000076a0: 7374 6172 7475 702e 5320 746f 2063 6f70 startup.S to cop │ │ │ │ -000076b0: 7920 6d6f 6475 6c65 7320 6f75 740a 6f66 y modules out.of │ │ │ │ -000076c0: 2062 7373 2074 6f20 6c65 7427 7320 7361 bss to let's sa │ │ │ │ -000076d0: 7920 414c 4947 4e5f 5550 2028 5f65 6e64 y ALIGN_UP (_end │ │ │ │ -000076e0: 2c20 3829 2062 6566 6f72 6520 636c 6561 , 8) before clea │ │ │ │ -000076f0: 6e69 6e67 206f 7574 2062 7373 2e20 2059 ning out bss. Y │ │ │ │ -00007700: 6f75 276c 6c0a 7072 6f62 6162 6c79 2066 ou'll.probably f │ │ │ │ -00007710: 696e 6420 7573 6566 756c 2074 6f20 6164 ind useful to ad │ │ │ │ -00007720: 6420 746f 7461 6c5f 6d6f 6475 6c65 5f73 d total_module_s │ │ │ │ -00007730: 697a 6520 6669 656c 6420 746f 2073 7461 ize field to sta │ │ │ │ -00007740: 7274 7570 2e53 2e20 496e 0a69 6e69 742e rtup.S. In.init. │ │ │ │ -00007750: 6320 796f 7520 6e65 6564 2074 6f20 7365 c you need to se │ │ │ │ -00007760: 7420 6772 7562 5f6d 6f64 6261 7365 2074 t grub_modbase t │ │ │ │ -00007770: 6f20 7468 6520 6164 6472 6573 7320 7768 o the address wh │ │ │ │ -00007780: 6572 6520 6d6f 6475 6c65 7320 6361 6e20 ere modules can │ │ │ │ -00007790: 6265 0a66 6f75 6e64 2e20 2059 6f75 206d be.found. You m │ │ │ │ -000077a0: 6179 206e 6565 6420 6772 7562 5f6d 6f64 ay need grub_mod │ │ │ │ -000077b0: 756c 6573 5f67 6574 5f65 6e64 2028 2920 ules_get_end () │ │ │ │ -000077c0: 746f 2061 766f 6964 2064 6563 6c61 7269 to avoid declari │ │ │ │ -000077d0: 6e67 2074 6865 0a73 7061 6365 206f 6363 ng the.space occ │ │ │ │ -000077e0: 7570 6965 6420 6279 206d 6f64 756c 6573 upied by modules │ │ │ │ -000077f0: 2061 7320 7573 6162 6c65 2066 6f72 2068 as usable for h │ │ │ │ -00007800: 6561 702e 2020 596f 7520 6361 6e20 7465 eap. You can te │ │ │ │ -00007810: 7374 206d 6f64 756c 6573 0a77 6974 683a st modules.with: │ │ │ │ -00007820: 0a0a 2020 2020 202e 2f67 7275 622d 6d6b .. ./grub-mk │ │ │ │ -00007830: 696d 6167 6520 2d64 2067 7275 622d 636f image -d grub-co │ │ │ │ -00007840: 7265 202d 4f20 2466 6f72 6d61 745f 6964 re -O $format_id │ │ │ │ -00007850: 202d 6f20 7465 7374 2e69 6d67 2068 656c -o test.img hel │ │ │ │ -00007860: 6c6f 0a0a 2020 2061 6e64 2074 6865 6e20 lo.. and then │ │ │ │ -00007870: 7275 6e6e 696e 6720 2268 656c 6c6f 2220 running "hello" │ │ │ │ -00007880: 696e 2074 6865 2073 6865 6c6c 2e0a 0a20 in the shell... │ │ │ │ -00007890: 2020 4f6e 6365 2074 6869 7320 776f 726b Once this work │ │ │ │ -000078a0: 732c 2079 6f75 2073 686f 756c 6420 7468 s, you should th │ │ │ │ -000078b0: 696e 6b20 6f66 2069 6d70 6c65 6d65 6e74 ink of implement │ │ │ │ -000078c0: 696e 6720 6469 736b 2061 6363 6573 732e ing disk access. │ │ │ │ -000078d0: 2020 4c6f 6f6b 0a61 726f 756e 6420 6469 Look.around di │ │ │ │ -000078e0: 736b 2f20 666f 7220 6578 616d 706c 6573 sk/ for examples │ │ │ │ -000078f0: 2e0a 0a20 2020 5468 656e 2c20 7665 7279 ... Then, very │ │ │ │ -00007900: 2069 6d70 6f72 7461 6e74 6c79 2c20 796f importantly, yo │ │ │ │ -00007910: 7520 7072 6f62 6162 6c79 206e 6565 6420 u probably need │ │ │ │ -00007920: 746f 2069 6d70 6c65 6d65 6e74 2074 6865 to implement the │ │ │ │ -00007930: 2061 6374 7561 6c0a 6c6f 6164 6572 2028 actual.loader ( │ │ │ │ -00007940: 6578 616d 706c 6573 2061 7661 696c 6162 examples availab │ │ │ │ -00007950: 6c65 2069 6e20 6c6f 6164 6572 2f29 0a0a le in loader/).. │ │ │ │ -00007960: 2020 204c 6173 7420 7374 6570 2074 6f20 Last step to │ │ │ │ -00007970: 6861 7665 206d 696e 696d 616c 6c79 2075 have minimally u │ │ │ │ -00007980: 7361 626c 6520 706f 7274 2069 7320 746f sable port is to │ │ │ │ -00007990: 2061 6464 2073 7570 706f 7274 2074 6f0a add support to. │ │ │ │ -000079a0: 6772 7562 2d69 6e73 7461 6c6c 2074 6f20 grub-install to │ │ │ │ -000079b0: 7075 7420 4752 5542 2069 6e20 6120 706c put GRUB in a pl │ │ │ │ -000079c0: 6163 6520 7768 6572 6520 6669 726d 7761 ace where firmwa │ │ │ │ -000079d0: 7265 206f 7220 706c 6174 666f 726d 2077 re or platform w │ │ │ │ -000079e0: 696c 6c20 7069 636b 0a69 7420 7570 2e0a ill pick.it up.. │ │ │ │ -000079f0: 0a20 2020 4e65 7874 2073 7465 7073 2061 . Next steps a │ │ │ │ -00007a00: 7265 3a20 6669 6c6c 696e 6720 6461 7465 re: filling date │ │ │ │ -00007a10: 7469 6d65 2e63 2c20 7365 746a 6d70 2e53 time.c, setjmp.S │ │ │ │ -00007a20: 2c20 6e65 7477 6f72 6b20 286e 6574 2f64 , network (net/d │ │ │ │ -00007a30: 7269 7665 7273 292c 0a76 6964 656f 2028 rivers),.video ( │ │ │ │ -00007a40: 7669 6465 6f2f 292c 2068 616c 7420 286c video/), halt (l │ │ │ │ -00007a50: 6962 2f29 2c20 7265 626f 6f74 2028 6c69 ib/), reboot (li │ │ │ │ -00007a60: 622f 292e 0a0a 2020 2050 6c65 6173 6520 b/)... Please │ │ │ │ -00007a70: 6164 6420 796f 7572 2070 6c61 7466 6f72 add your platfor │ │ │ │ -00007a80: 6d20 746f 2050 6c61 7466 6f72 6d20 6c69 m to Platform li │ │ │ │ -00007a90: 6d69 7461 7469 6f6e 7320 616e 6420 5375 mitations and Su │ │ │ │ -00007aa0: 7070 6f72 7465 640a 6b65 726e 656c 7320 pported.kernels │ │ │ │ -00007ab0: 6368 6170 7465 7220 696e 2075 7365 7220 chapter in user │ │ │ │ -00007ac0: 646f 6375 6d65 6e74 6174 696f 6e20 616e documentation an │ │ │ │ -00007ad0: 6420 6d65 6e74 696f 6e20 616e 7920 7374 d mention any st │ │ │ │ -00007ae0: 6570 7320 796f 7520 736b 6970 7065 640a eps you skipped. │ │ │ │ -00007af0: 7768 6963 6820 7265 7375 6c74 2069 6e20 which result in │ │ │ │ -00007b00: 7265 6475 6365 6420 6665 6174 7572 6573 reduced features │ │ │ │ -00007b10: 206f 7220 7065 7266 6f72 6d61 6e63 652e or performance. │ │ │ │ -00007b20: 2020 4865 7265 2069 7320 7468 6520 7175 Here is the qu │ │ │ │ -00007b30: 6963 6b0a 6368 6563 6b6c 6973 7420 6f66 ick.checklist of │ │ │ │ -00007b40: 2066 6561 7475 7265 732e 2020 536f 6d65 features. Some │ │ │ │ -00007b50: 206f 6620 7468 656d 2061 7265 206c 6573 of them are les │ │ │ │ -00007b60: 7320 696d 706f 7274 616e 7420 7468 616e s important than │ │ │ │ -00007b70: 206f 7468 6572 7320 616e 640a 736b 6970 others and.skip │ │ │ │ -00007b80: 7069 6e67 2074 6865 6d20 6973 2063 6f6d ping them is com │ │ │ │ -00007b90: 706c 6574 656c 7920 6f6b 2c20 6a75 7374 pletely ok, just │ │ │ │ -00007ba0: 206e 6565 6473 2074 6f20 6265 206d 656e needs to be men │ │ │ │ -00007bb0: 7469 6f6e 6564 2069 6e20 7573 6572 0a64 tioned in user.d │ │ │ │ -00007bc0: 6f63 756d 656e 7461 7469 6f6e 2e0a 0a20 ocumentation... │ │ │ │ -00007bd0: 2020 4368 6563 6b6c 6973 743a 0a20 2020 Checklist:. │ │ │ │ -00007be0: 2a20 4973 2068 6561 7020 6269 6720 656e * Is heap big en │ │ │ │ -00007bf0: 6f75 6768 3f0a 2020 202a 2057 6869 6368 ough?. * Which │ │ │ │ -00007c00: 2063 6861 7273 6574 2069 7320 7375 7070 charset is supp │ │ │ │ -00007c10: 6f72 7465 6420 6279 2063 6f6e 736f 6c65 orted by console │ │ │ │ -00007c20: 3f0a 2020 202a 2044 6f65 7320 706c 6174 ?. * Does plat │ │ │ │ -00007c30: 666f 726d 2068 6176 6520 6469 736b 2064 form have disk d │ │ │ │ -00007c40: 7269 7665 723f 0a20 2020 2a20 446f 2079 river?. * Do y │ │ │ │ -00007c50: 6f75 2068 6176 6520 6e65 7477 6f72 6b20 ou have network │ │ │ │ -00007c60: 6361 7264 2073 7570 706f 7274 3f0a 2020 card support?. │ │ │ │ -00007c70: 202a 2041 7265 2079 6f75 2061 626c 6520 * Are you able │ │ │ │ -00007c80: 746f 2072 6574 7269 6576 6520 6461 7465 to retrieve date │ │ │ │ -00007c90: 7469 6d65 2028 7769 7468 2064 6174 6529 time (with date) │ │ │ │ -00007ca0: 3f0a 2020 202a 2041 7265 2079 6f75 2061 ?. * Are you a │ │ │ │ -00007cb0: 626c 6520 746f 2073 6574 2064 6174 6574 ble to set datet │ │ │ │ -00007cc0: 696d 6520 2877 6974 6820 6461 7465 293f ime (with date)? │ │ │ │ -00007cd0: 0a20 2020 2a20 4973 2073 6572 6961 6c20 . * Is serial │ │ │ │ -00007ce0: 7375 7070 6f72 7465 643f 0a20 2020 2a20 supported?. * │ │ │ │ -00007cf0: 446f 2079 6f75 2068 6176 6520 6469 7265 Do you have dire │ │ │ │ -00007d00: 6374 2064 6973 6b20 7375 7070 6f72 743f ct disk support? │ │ │ │ -00007d10: 0a20 2020 2a20 446f 2079 6f75 2068 6176 . * Do you hav │ │ │ │ -00007d20: 6520 6469 7265 6374 206b 6579 626f 6172 e direct keyboar │ │ │ │ -00007d30: 6420 7375 7070 6f72 743f 0a20 2020 2a20 d support?. * │ │ │ │ -00007d40: 446f 2079 6f75 2068 6176 6520 5553 4220 Do you have USB │ │ │ │ -00007d50: 7375 7070 6f72 743f 0a20 2020 2a20 446f support?. * Do │ │ │ │ -00007d60: 2079 6f75 2073 7570 706f 7274 206c 6f61 you support loa │ │ │ │ -00007d70: 6469 6e67 2074 6872 6f75 6768 206e 6574 ding through net │ │ │ │ -00007d80: 776f 726b 3f0a 2020 202a 2044 6f20 796f work?. * Do yo │ │ │ │ -00007d90: 7520 7375 7070 6f72 7420 6c6f 6164 696e u support loadin │ │ │ │ -00007da0: 6720 6672 6f6d 2064 6973 6b3f 0a20 2020 g from disk?. │ │ │ │ -00007db0: 2a20 446f 2079 6f75 2073 7570 706f 7274 * Do you support │ │ │ │ -00007dc0: 2063 6861 696e 6c6f 6164 696e 673f 0a20 chainloading?. │ │ │ │ -00007dd0: 2020 2a20 446f 2079 6f75 2073 7570 706f * Do you suppo │ │ │ │ -00007de0: 7274 206e 6574 776f 726b 2063 6861 696e rt network chain │ │ │ │ -00007df0: 6c6f 6164 696e 673f 0a20 2020 2a20 446f loading?. * Do │ │ │ │ -00007e00: 6573 2063 7075 6964 2063 6f6d 6d61 6e64 es cpuid command │ │ │ │ -00007e10: 2073 7570 706f 7274 7320 6368 6563 6b69 supports checki │ │ │ │ -00007e20: 6e67 2061 6c6c 2043 5055 2066 6561 7475 ng all CPU featu │ │ │ │ -00007e30: 7265 7320 7468 6174 2074 6865 2075 7365 res that the use │ │ │ │ -00007e40: 720a 2020 2020 206d 6967 6874 2077 616e r. might wan │ │ │ │ -00007e50: 7420 636f 6e64 6974 696f 6e61 6c69 7365 t conditionalise │ │ │ │ -00007e60: 206f 6e20 2836 342d 6269 7420 6d6f 6465 on (64-bit mode │ │ │ │ -00007e70: 2c20 6879 7065 7276 6973 6f72 2c2e 2e2e , hypervisor,... │ │ │ │ -00007e80: 290a 2020 202a 2044 6f20 796f 7520 7375 ). * Do you su │ │ │ │ -00007e90: 7070 6f72 7420 6869 6e74 733f 2020 486f pport hints? Ho │ │ │ │ -00007ea0: 7720 7265 6c69 6162 6c65 2061 7265 2074 w reliable are t │ │ │ │ -00007eb0: 6865 793f 0a20 2020 2a20 446f 6573 2070 hey?. * Does p │ │ │ │ -00007ec0: 6c61 7466 6f72 6d20 6861 7665 2041 4350 latform have ACP │ │ │ │ -00007ed0: 493f 2049 6620 736f 2064 6f20 2261 6370 I? If so do "acp │ │ │ │ -00007ee0: 6922 2061 6e64 2022 6c73 6163 7069 2220 i" and "lsacpi" │ │ │ │ -00007ef0: 6d6f 6475 6c65 7320 776f 726b 3f0a 2020 modules work?. │ │ │ │ -00007f00: 202a 2044 6f20 616e 7920 6f66 2070 6c61 * Do any of pla │ │ │ │ -00007f10: 7466 6f72 6d2d 7370 6563 6966 6963 206f tform-specific o │ │ │ │ -00007f20: 7065 7261 7469 6f6e 7320 6d65 6e74 696f perations mentio │ │ │ │ -00007f30: 6e65 6420 696e 2074 6865 2072 656c 6576 ned in the relev │ │ │ │ -00007f40: 616e 740a 2020 2020 2073 6563 7469 6f6e ant. section │ │ │ │ -00007f50: 206f 6620 7573 6572 206d 616e 7561 6c20 of user manual │ │ │ │ -00007f60: 6d61 6b65 7320 7365 6e73 6520 6f6e 2079 makes sense on y │ │ │ │ -00007f70: 6f75 7220 706c 6174 666f 726d 3f0a 2020 our platform?. │ │ │ │ -00007f80: 202a 2044 6f65 7320 796f 7572 2070 6c61 * Does your pla │ │ │ │ -00007f90: 7466 6f72 6d20 7375 7070 6f72 7420 5043 tform support PC │ │ │ │ -00007fa0: 493f 2049 6620 736f 2069 7320 7468 6572 I? If so is ther │ │ │ │ -00007fb0: 6520 616e 2061 7070 726f 7072 6961 7465 e an appropriate │ │ │ │ -00007fc0: 0a20 2020 2020 6472 6976 6572 2066 6f72 . driver for │ │ │ │ -00007fd0: 2047 5255 423f 0a20 2020 2a20 446f 2079 GRUB?. * Do y │ │ │ │ -00007fe0: 6f75 2073 7570 706f 7274 2062 6164 7261 ou support badra │ │ │ │ -00007ff0: 6d3f 0a0a 1f0a 4669 6c65 3a20 6772 7562 m?....File: grub │ │ │ │ -00008000: 2d64 6576 2e69 6e66 6f2c 2020 4e6f 6465 -dev.info, Node │ │ │ │ -00008010: 3a20 4572 726f 7220 4861 6e64 6c69 6e67 : Error Handling │ │ │ │ -00008020: 2c20 204e 6578 743a 2053 7461 636b 2061 , Next: Stack a │ │ │ │ -00008030: 6e64 2068 6561 7020 7369 7a65 2c20 2050 nd heap size, P │ │ │ │ -00008040: 7265 763a 2050 6f72 7469 6e67 2c20 2055 rev: Porting, U │ │ │ │ -00008050: 703a 2054 6f70 0a0a 3720 4572 726f 7220 p: Top..7 Error │ │ │ │ -00008060: 4861 6e64 6c69 6e67 0a2a 2a2a 2a2a 2a2a Handling.******* │ │ │ │ -00008070: 2a2a 2a2a 2a2a 2a2a 2a0a 0a45 7272 6f72 *********..Error │ │ │ │ -00008080: 2068 616e 646c 696e 6720 696e 2047 5255 handling in GRU │ │ │ │ -00008090: 4220 3220 6973 2062 6173 6564 206f 6e20 B 2 is based on │ │ │ │ -000080a0: 6578 6365 7074 696f 6e20 6861 6e64 6c69 exception handli │ │ │ │ -000080b0: 6e67 206d 6f64 656c 2e20 2041 7320 430a ng model. As C. │ │ │ │ -000080c0: 6c61 6e67 7561 6765 2064 6f65 736e 2774 language doesn't │ │ │ │ -000080d0: 2064 6972 6563 746c 7920 7375 7070 6f72 directly suppor │ │ │ │ -000080e0: 7420 6578 6365 7074 696f 6e73 2c20 6578 t exceptions, ex │ │ │ │ -000080f0: 6365 7074 696f 6e20 6861 6e64 6c69 6e67 ception handling │ │ │ │ -00008100: 0a62 6568 6176 696f 7220 6973 2065 6d75 .behavior is emu │ │ │ │ -00008110: 6c61 7465 6420 696e 2073 6f66 7477 6172 lated in softwar │ │ │ │ -00008120: 652e 0a0a 2020 2057 6865 6e20 6578 6365 e... When exce │ │ │ │ -00008130: 7074 696f 6e20 6973 2072 6169 7365 642c ption is raised, │ │ │ │ -00008140: 2066 756e 6374 696f 6e20 6d75 7374 2072 function must r │ │ │ │ -00008150: 6574 7572 6e20 746f 2063 616c 6c69 6e67 eturn to calling │ │ │ │ -00008160: 2066 756e 6374 696f 6e2e 0a49 6620 6361 function..If ca │ │ │ │ -00008170: 6c6c 696e 6720 6675 6e63 7469 6f6e 2064 lling function d │ │ │ │ -00008180: 6f65 7320 6e6f 7420 7072 6f76 6964 6520 oes not provide │ │ │ │ -00008190: 6861 6e64 6c69 6e67 206f 6620 7468 6520 handling of the │ │ │ │ -000081a0: 6578 6365 7074 696f 6e20 6974 206d 7573 exception it mus │ │ │ │ -000081b0: 740a 7265 7475 726e 2062 6163 6b20 746f t.return back to │ │ │ │ -000081c0: 2069 7473 2063 616c 6c69 6e67 2066 756e its calling fun │ │ │ │ -000081d0: 6374 696f 6e20 616e 6420 736f 206f 6e2c ction and so on, │ │ │ │ -000081e0: 2075 6e74 696c 2065 7863 6570 7469 6f6e until exception │ │ │ │ -000081f0: 2069 730a 6861 6e64 6c65 642e 2020 4966 is.handled. If │ │ │ │ -00008200: 2065 7863 6570 7469 6f6e 2069 7320 6e6f exception is no │ │ │ │ -00008210: 7420 6861 6e64 6c65 6420 6265 666f 7265 t handled before │ │ │ │ -00008220: 2070 726f 6d70 7420 6973 2064 6973 706c prompt is displ │ │ │ │ -00008230: 6179 6564 2c20 6572 726f 720a 6d65 7373 ayed, error.mess │ │ │ │ -00008240: 6167 6520 7769 6c6c 2062 6520 7368 6f77 age will be show │ │ │ │ -00008250: 6e20 746f 2075 7365 722e 0a0a 2020 2045 n to user... E │ │ │ │ -00008260: 7863 6570 7469 6f6e 2069 6e66 6f72 6d61 xception informa │ │ │ │ -00008270: 7469 6f6e 2069 7320 7374 6f72 6564 206f tion is stored o │ │ │ │ -00008280: 6e20 2767 7275 625f 6572 726e 6f27 2067 n 'grub_errno' g │ │ │ │ -00008290: 6c6f 6261 6c20 7661 7269 6162 6c65 2e20 lobal variable. │ │ │ │ -000082a0: 2049 660a 2767 7275 625f 6572 726e 6f27 If.'grub_errno' │ │ │ │ -000082b0: 2076 6172 6961 626c 6520 636f 6e74 6169 variable contai │ │ │ │ -000082c0: 6e73 2076 616c 7565 2027 4752 5542 5f45 ns value 'GRUB_E │ │ │ │ -000082d0: 5252 5f4e 4f4e 4527 2c20 7468 6572 6520 RR_NONE', there │ │ │ │ -000082e0: 6973 206e 6f20 6163 7469 7665 0a65 7863 is no active.exc │ │ │ │ -000082f0: 6570 7469 6f6e 2061 6e64 2061 7070 6c69 eption and appli │ │ │ │ -00008300: 6361 7469 6f6e 2063 616e 2063 6f6e 7469 cation can conti │ │ │ │ -00008310: 6e75 6520 6e6f 726d 616c 2070 726f 6365 nue normal proce │ │ │ │ -00008320: 7373 696e 672e 2020 5768 656e 0a27 6772 ssing. When.'gr │ │ │ │ -00008330: 7562 5f65 7272 6e6f 2720 6861 7320 6f74 ub_errno' has ot │ │ │ │ -00008340: 6865 7220 7661 6c75 652c 2069 7420 6973 her value, it is │ │ │ │ -00008350: 2072 6571 7569 7265 6420 7468 6174 2061 required that a │ │ │ │ -00008360: 7070 6c69 6361 7469 6f6e 2063 6f64 650a pplication code. │ │ │ │ -00008370: 6569 7468 6572 2068 616e 646c 6573 2074 either handles t │ │ │ │ -00008380: 6869 7320 6572 726f 7220 6f72 2072 6574 his error or ret │ │ │ │ -00008390: 7572 6e73 2069 6e73 7461 6e74 6c79 2074 urns instantly t │ │ │ │ -000083a0: 6f20 6361 6c6c 6572 2e20 2049 6620 6675 o caller. If fu │ │ │ │ -000083b0: 6e63 7469 6f6e 0a69 7320 7769 7468 2072 nction.is with r │ │ │ │ -000083c0: 6574 7572 6e20 7479 7065 2027 6772 7562 eturn type 'grub │ │ │ │ -000083d0: 5f65 7272 5f74 2720 6973 2061 626f 7574 _err_t' is about │ │ │ │ -000083e0: 2074 6f20 7265 7475 726e 2027 4752 5542 to return 'GRUB │ │ │ │ -000083f0: 5f45 5252 5f4e 4f4e 4527 2c20 6974 0a73 _ERR_NONE', it.s │ │ │ │ -00008400: 686f 756c 6420 6e6f 7420 7365 7420 2767 hould not set 'g │ │ │ │ -00008410: 7275 625f 6572 726e 6f27 2074 6f20 7468 rub_errno' to th │ │ │ │ -00008420: 6174 2076 616c 7565 2e20 204f 6e6c 7920 at value. Only │ │ │ │ -00008430: 7365 7420 2767 7275 625f 6572 726e 6f27 set 'grub_errno' │ │ │ │ -00008440: 2069 6e0a 6361 7365 7320 7768 6572 6520 in.cases where │ │ │ │ -00008450: 7468 6572 6520 6973 2065 7272 6f72 2073 there is error s │ │ │ │ -00008460: 6974 7561 7469 6f6e 2e0a 0a20 2020 5369 ituation... Si │ │ │ │ -00008470: 6d70 6c65 2065 7863 6570 7469 6f6e 2066 mple exception f │ │ │ │ -00008480: 6f72 7761 7264 6572 2e0a 2020 2020 2067 orwarder.. g │ │ │ │ -00008490: 7275 625f 6572 725f 740a 2020 2020 2066 rub_err_t. f │ │ │ │ -000084a0: 6f72 7761 7264 696e 675f 6578 616d 706c orwarding_exampl │ │ │ │ -000084b0: 6520 2876 6f69 6429 0a20 2020 2020 7b0a e (void). {. │ │ │ │ -000084c0: 2020 2020 2020 202f 2a20 4361 6c6c 2066 /* Call f │ │ │ │ -000084d0: 756e 6374 696f 6e20 7468 6174 206d 6967 unction that mig │ │ │ │ -000084e0: 6874 2063 6175 7365 2065 7863 6570 7469 ht cause excepti │ │ │ │ -000084f0: 6f6e 2e20 202a 2f0a 2020 2020 2020 2066 on. */. f │ │ │ │ -00008500: 6f6f 6261 7220 2829 3b0a 0a20 2020 2020 oobar ();.. │ │ │ │ -00008510: 2020 2f2a 204e 6f20 7370 6563 6961 6c20 /* No special │ │ │ │ -00008520: 6578 6365 7074 696f 6e20 6861 6e64 6c65 exception handle │ │ │ │ -00008530: 722c 206a 7573 7420 666f 7277 6172 6420 r, just forward │ │ │ │ -00008540: 706f 7373 6962 6c65 2065 7863 6570 7469 possible excepti │ │ │ │ -00008550: 6f6e 732e 2020 2a2f 0a20 2020 2020 2020 ons. */. │ │ │ │ -00008560: 6966 2028 6772 7562 5f65 7272 6e6f 2021 if (grub_errno ! │ │ │ │ -00008570: 3d20 4752 5542 5f45 5252 5f4e 4f4e 4529 = GRUB_ERR_NONE) │ │ │ │ -00008580: 0a20 2020 2020 2020 2020 7b0a 2020 2020 . {. │ │ │ │ -00008590: 2020 2020 2020 2072 6574 7572 6e20 6772 return gr │ │ │ │ -000085a0: 7562 5f65 7272 6e6f 3b0a 2020 2020 2020 ub_errno;. │ │ │ │ -000085b0: 2020 207d 0a0a 2020 2020 2020 202f 2a20 }.. /* │ │ │ │ -000085c0: 416c 6c20 6973 204f 4b2c 2064 6f20 6d6f All is OK, do mo │ │ │ │ -000085d0: 7265 2070 726f 6365 7373 696e 672e 2020 re processing. │ │ │ │ -000085e0: 2a2f 0a0a 2020 2020 2020 202f 2a20 5265 */.. /* Re │ │ │ │ -000085f0: 7475 726e 204f 4b20 7369 676e 616c 2c20 turn OK signal, │ │ │ │ -00008600: 746f 2063 616c 6c65 722e 2020 2a2f 0a20 to caller. */. │ │ │ │ -00008610: 2020 2020 2020 7265 7475 726e 2047 5255 return GRU │ │ │ │ -00008620: 425f 4552 525f 4e4f 4e45 3b0a 2020 2020 B_ERR_NONE;. │ │ │ │ -00008630: 207d 0a0a 2020 2045 7272 6f72 2072 6570 }.. Error rep │ │ │ │ -00008640: 6f72 7469 6e67 2068 6173 2074 776f 2063 orting has two c │ │ │ │ -00008650: 6f6d 706f 6e65 6e74 732c 2074 6865 2061 omponents, the a │ │ │ │ -00008660: 6374 7561 6c20 6572 726f 7220 636f 6465 ctual error code │ │ │ │ -00008670: 2028 6f66 2074 7970 650a 2767 7275 625f (of type.'grub_ │ │ │ │ -00008680: 6572 725f 7427 2920 616e 6420 7465 7874 err_t') and text │ │ │ │ -00008690: 7561 6c20 6d65 7373 6167 6520 7468 6174 ual message that │ │ │ │ -000086a0: 2077 696c 6c20 6265 2064 6973 706c 6179 will be display │ │ │ │ -000086b0: 6564 2074 6f20 7573 6572 2e20 204c 6973 ed to user. Lis │ │ │ │ -000086c0: 740a 6f66 2076 616c 6964 2065 7272 6f72 t.of valid error │ │ │ │ -000086d0: 2063 6f64 6573 2069 7320 6c69 7374 6564 codes is listed │ │ │ │ -000086e0: 2069 6e20 6865 6164 6572 2066 696c 6520 in header file │ │ │ │ -000086f0: 2769 6e63 6c75 6465 2f67 7275 622f 6572 'include/grub/er │ │ │ │ -00008700: 722e 6827 2e0a 5465 7874 7561 6c20 6572 r.h'..Textual er │ │ │ │ -00008710: 726f 7220 6d65 7373 6167 6520 6361 6e20 ror message can │ │ │ │ -00008720: 636f 6e74 6169 6e20 616e 7920 7465 7874 contain any text │ │ │ │ -00008730: 7561 6c20 6461 7461 2e20 2041 7420 7469 ual data. At ti │ │ │ │ -00008740: 6d65 206f 6620 7772 6974 696e 672c 0a65 me of writing,.e │ │ │ │ -00008750: 7272 6f72 206d 6573 7361 6765 2063 616e rror message can │ │ │ │ -00008760: 2063 6f6e 7461 696e 2075 7020 746f 2032 contain up to 2 │ │ │ │ -00008770: 3536 2063 6861 7261 6374 6572 7320 2869 56 characters (i │ │ │ │ -00008780: 6e63 6c75 6469 6e67 2074 6572 6d69 6e61 ncluding termina │ │ │ │ -00008790: 7469 6e67 0a4e 554c 292e 2054 6f20 6561 ting.NUL). To ea │ │ │ │ -000087a0: 7365 2065 7272 6f72 2072 6570 6f72 7469 se error reporti │ │ │ │ -000087b0: 6e67 2074 6865 7265 2069 7320 6120 6865 ng there is a he │ │ │ │ -000087c0: 6c70 6572 2066 756e 6374 696f 6e20 2767 lper function 'g │ │ │ │ -000087d0: 7275 625f 6572 726f 7227 0a74 6861 7420 rub_error'.that │ │ │ │ -000087e0: 616c 6c6f 7773 2065 6173 6965 7220 666f allows easier fo │ │ │ │ -000087f0: 726d 6174 7469 6e67 206f 6620 6572 726f rmatting of erro │ │ │ │ -00008800: 7220 6d65 7373 6167 6573 2061 6e64 2073 r messages and s │ │ │ │ -00008810: 686f 756c 6420 6265 2075 7365 640a 696e hould be used.in │ │ │ │ -00008820: 7374 6561 6420 6f66 2077 7269 7469 6e67 stead of writing │ │ │ │ -00008830: 2064 6972 6563 746c 7920 746f 2067 6c6f directly to glo │ │ │ │ -00008840: 6261 6c20 7661 7269 6162 6c65 732e 0a0a bal variables... │ │ │ │ -00008850: 2020 2045 7861 6d70 6c65 206f 6620 6572 Example of er │ │ │ │ -00008860: 726f 7220 7265 706f 7274 696e 672e 0a20 ror reporting.. │ │ │ │ -00008870: 2020 2020 6772 7562 5f65 7272 5f74 0a20 grub_err_t. │ │ │ │ -00008880: 2020 2020 6661 696c 696e 675f 6578 616d failing_exam │ │ │ │ -00008890: 706c 6520 2829 0a20 2020 2020 7b0a 2020 ple (). {. │ │ │ │ -000088a0: 2020 2020 2072 6574 7572 6e20 6772 7562 return grub │ │ │ │ -000088b0: 5f65 7272 6f72 2028 4752 5542 5f45 5252 _error (GRUB_ERR │ │ │ │ -000088c0: 5f46 494c 455f 4e4f 545f 464f 554e 442c _FILE_NOT_FOUND, │ │ │ │ -000088d0: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ -000088e0: 2020 2020 2020 2020 2020 2022 4661 696c "Fail │ │ │ │ -000088f0: 6564 2074 6f20 7265 6164 2025 732c 2074 ed to read %s, t │ │ │ │ -00008900: 7269 6564 2025 6420 7469 6d65 732e 222c ried %d times.", │ │ │ │ -00008910: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ -00008920: 2020 2020 2020 2020 2020 2022 7465 7374 "test │ │ │ │ -00008930: 2e74 7874 222c 0a20 2020 2020 2020 2020 .txt",. │ │ │ │ +00006540: 2020 2020 2269 3338 365f 6d75 6c74 6962 "i386_multib │ │ │ │ +00006550: 6f6f 7422 2c20 2269 3338 365f 6965 6565 oot", "i386_ieee │ │ │ │ +00006560: 3132 3735 222c 2022 7838 365f 3634 5f65 1275", "x86_64_e │ │ │ │ +00006570: 6669 222c 0a20 2020 2020 2020 2020 2020 fi",. │ │ │ │ +00006580: 2020 2020 2020 2020 2020 2020 2022 6d69 "mi │ │ │ │ +00006590: 7073 5f6c 6f6f 6e67 736f 6e22 2c20 2273 ps_loongson", "s │ │ │ │ +000065a0: 7061 7263 3634 5f69 6565 6531 3237 3522 parc64_ieee1275" │ │ │ │ +000065b0: 2c0a 2020 2020 2020 2020 2020 2020 2020 ,. │ │ │ │ +000065c0: 2020 2020 2020 2020 2020 2270 6f77 6572 "power │ │ │ │ +000065d0: 7063 5f69 6565 6531 3237 3522 2c20 226d pc_ieee1275", "m │ │ │ │ +000065e0: 6970 735f 6172 6322 2c20 2269 6136 345f ips_arc", "ia64_ │ │ │ │ +000065f0: 6566 6922 2c0a 2020 2020 2020 2020 2020 efi",. │ │ │ │ +00006600: 2020 2020 2020 2020 2020 2020 2020 226d "m │ │ │ │ +00006610: 6970 735f 7165 6d75 5f6d 6970 7322 2c20 ips_qemu_mips", │ │ │ │ +00006620: 2273 3339 305f 6d61 696e 6672 616d 6522 "s390_mainframe" │ │ │ │ +00006630: 205d 0a0a 2020 2059 6f75 206d 6179 2061 ].. You may a │ │ │ │ +00006640: 6c73 6f20 7761 6e74 2061 6c72 6561 6479 lso want already │ │ │ │ +00006650: 2074 6f20 6164 6420 6e65 7720 706c 6174 to add new plat │ │ │ │ +00006660: 666f 726d 2074 6f20 6f6e 6520 6f72 2073 form to one or s │ │ │ │ +00006670: 6576 6572 616c 206f 660a 6176 6169 6c61 everal of.availa │ │ │ │ +00006680: 626c 6520 6772 6f75 7073 2e20 2049 6e20 ble groups. In │ │ │ │ +00006690: 7061 7274 6963 756c 6172 2077 6520 616c particular we al │ │ │ │ +000066a0: 7761 7973 2068 6176 6520 6120 6772 6f75 ways have a grou │ │ │ │ +000066b0: 7020 666f 7220 6561 6368 2043 5055 0a65 p for each CPU.e │ │ │ │ +000066c0: 7665 6e20 7768 656e 206f 6e6c 7920 6f6e ven when only on │ │ │ │ +000066d0: 6520 706c 6174 666f 726d 2066 6f72 2067 e platform for g │ │ │ │ +000066e0: 6976 656e 2043 5055 2069 7320 6176 6169 iven CPU is avai │ │ │ │ +000066f0: 6c61 626c 652e 0a0a 2020 2054 6865 6e20 lable... Then │ │ │ │ +00006700: 636f 6d65 7320 6772 7562 2d63 6f72 652f comes grub-core/ │ │ │ │ +00006710: 4d61 6b65 6669 6c65 2e63 6f72 652e 6465 Makefile.core.de │ │ │ │ +00006720: 662e 2020 496e 2074 6865 2062 6c6f 636b f. In the block │ │ │ │ +00006730: 2022 6b65 726e 656c 2220 796f 7527 6c6c "kernel" you'll │ │ │ │ +00006740: 0a6e 6565 6420 746f 2064 6566 696e 6520 .need to define │ │ │ │ +00006750: 6c64 666c 6167 7320 666f 7220 796f 7572 ldflags for your │ │ │ │ +00006760: 2070 6c61 7466 6f72 6d20 2824 6370 755f platform ($cpu_ │ │ │ │ +00006770: 2470 6c61 7466 6f72 6d5f 6c64 666c 6167 $platform_ldflag │ │ │ │ +00006780: 7329 2e20 2059 6f75 0a61 6c73 6f20 6e65 s). You.also ne │ │ │ │ +00006790: 6564 2074 6f20 6465 636c 6172 6520 7374 ed to declare st │ │ │ │ +000067a0: 6172 7475 7020 6173 6d20 6669 6c65 2028 artup asm file ( │ │ │ │ +000067b0: 2463 7075 5f24 706c 6174 666f 726d 5f73 $cpu_$platform_s │ │ │ │ +000067c0: 7461 7274 7570 2920 6173 2077 656c 6c0a tartup) as well. │ │ │ │ +000067d0: 6173 2061 6e79 206f 7468 6572 2066 696c as any other fil │ │ │ │ +000067e0: 6573 2028 652e 672e 2020 696e 6974 2e63 es (e.g. init.c │ │ │ │ +000067f0: 2061 6e64 2063 616c 6c77 7261 702e 5329 and callwrap.S) │ │ │ │ +00006800: 2028 652e 672e 2020 2463 7075 5f24 706c (e.g. $cpu_$pl │ │ │ │ +00006810: 6174 666f 726d 203d 0a6b 6572 6e2f 2463 atform =.kern/$c │ │ │ │ +00006820: 7075 2f24 706c 6174 666f 726d 2f69 6e69 pu/$platform/ini │ │ │ │ +00006830: 742e 6329 2e20 2041 7420 7468 6973 2073 t.c). At this s │ │ │ │ +00006840: 7461 6765 2079 6f75 2077 696c 6c20 616c tage you will al │ │ │ │ +00006850: 736f 206e 6565 6420 746f 2061 6464 0a64 so need to add.d │ │ │ │ +00006860: 756d 6d79 2064 6c2e 6320 616e 6420 6361 ummy dl.c and ca │ │ │ │ +00006870: 6368 652e 5320 7769 7468 2066 756e 6374 che.S with funct │ │ │ │ +00006880: 696f 6e73 2067 7275 625f 6572 725f 740a ions grub_err_t. │ │ │ │ +00006890: 6772 7562 5f61 7263 685f 646c 5f63 6865 grub_arch_dl_che │ │ │ │ +000068a0: 636b 5f68 6561 6465 7220 2876 6f69 6420 ck_header (void │ │ │ │ +000068b0: 2a65 6864 7229 2c20 6772 7562 5f65 7272 *ehdr), grub_err │ │ │ │ +000068c0: 5f74 0a67 7275 625f 6172 6368 5f64 6c5f _t.grub_arch_dl_ │ │ │ │ +000068d0: 7265 6c6f 6361 7465 5f73 796d 626f 6c73 relocate_symbols │ │ │ │ +000068e0: 2028 6772 7562 5f64 6c5f 7420 6d6f 642c (grub_dl_t mod, │ │ │ │ +000068f0: 2076 6f69 6420 2a65 6864 7229 2028 646c void *ehdr) (dl │ │ │ │ +00006900: 2e63 2920 616e 640a 766f 6964 2067 7275 .c) and.void gru │ │ │ │ +00006910: 625f 6172 6368 5f73 796e 635f 6361 6368 b_arch_sync_cach │ │ │ │ +00006920: 6573 2028 766f 6964 202a 6164 6472 6573 es (void *addres │ │ │ │ +00006930: 732c 2067 7275 625f 7369 7a65 5f74 206c s, grub_size_t l │ │ │ │ +00006940: 656e 2920 2863 6163 6865 2e53 292e 0a54 en) (cache.S)..T │ │ │ │ +00006950: 6865 7920 776f 6e27 7420 6265 2075 7365 hey won't be use │ │ │ │ +00006960: 6420 666f 7220 6e6f 772e 0a0a 2020 2059 d for now... Y │ │ │ │ +00006970: 6f75 2077 696c 6c20 6e65 6564 2074 6f20 ou will need to │ │ │ │ +00006980: 6372 6561 7465 2064 6972 6563 746f 7279 create directory │ │ │ │ +00006990: 2069 6e63 6c75 6465 2f24 6370 752f 2470 include/$cpu/$p │ │ │ │ +000069a0: 6c61 7466 6f72 6d20 616e 6420 6120 6669 latform and a fi │ │ │ │ +000069b0: 6c65 0a69 6e63 6c75 6465 2f24 6370 752f le.include/$cpu/ │ │ │ │ +000069c0: 7479 7065 732e 682e 2020 5468 6520 6c61 types.h. The la │ │ │ │ +000069d0: 7465 7220 666f 6c6f 7769 6e67 2074 6869 ter folowing thi │ │ │ │ +000069e0: 7320 7465 6d70 6c61 7465 3a0a 0a20 2020 s template:.. │ │ │ │ +000069f0: 2020 2369 666e 6465 6620 4752 5542 5f54 #ifndef GRUB_T │ │ │ │ +00006a00: 5950 4553 5f43 5055 5f48 4541 4445 520a YPES_CPU_HEADER. │ │ │ │ +00006a10: 2020 2020 2023 6465 6669 6e65 2047 5255 #define GRU │ │ │ │ +00006a20: 425f 5459 5045 535f 4350 555f 4845 4144 B_TYPES_CPU_HEAD │ │ │ │ +00006a30: 4552 0931 0a0a 2020 2020 202f 2a20 5468 ER.1.. /* Th │ │ │ │ +00006a40: 6520 7369 7a65 206f 6620 766f 6964 202a e size of void * │ │ │ │ +00006a50: 2e20 202a 2f0a 2020 2020 2023 6465 6669 . */. #defi │ │ │ │ +00006a60: 6e65 2047 5255 425f 5441 5247 4554 5f53 ne GRUB_TARGET_S │ │ │ │ +00006a70: 495a 454f 465f 564f 4944 5f50 0934 0a0a IZEOF_VOID_P.4.. │ │ │ │ +00006a80: 2020 2020 202f 2a20 5468 6520 7369 7a65 /* The size │ │ │ │ +00006a90: 206f 6620 6c6f 6e67 2e20 202a 2f0a 2020 of long. */. │ │ │ │ +00006aa0: 2020 2023 6465 6669 6e65 2047 5255 425f #define GRUB_ │ │ │ │ +00006ab0: 5441 5247 4554 5f53 495a 454f 465f 4c4f TARGET_SIZEOF_LO │ │ │ │ +00006ac0: 4e47 0909 340a 0a20 2020 2020 2f2a 206d NG..4.. /* m │ │ │ │ +00006ad0: 7963 7075 2069 7320 6269 672d 656e 6469 ycpu is big-endi │ │ │ │ +00006ae0: 616e 2e20 202a 2f0a 2020 2020 2023 6465 an. */. #de │ │ │ │ +00006af0: 6669 6e65 2047 5255 425f 5441 5247 4554 fine GRUB_TARGET │ │ │ │ +00006b00: 5f57 4f52 4453 5f42 4947 454e 4449 414e _WORDS_BIGENDIAN │ │ │ │ +00006b10: 0931 0a20 2020 2020 2f2a 2041 6c74 6572 .1. /* Alter │ │ │ │ +00006b20: 6e61 7469 7665 6c79 3a20 6d79 6370 7520 natively: mycpu │ │ │ │ +00006b30: 6973 206c 6974 746c 652d 656e 6469 616e is little-endian │ │ │ │ +00006b40: 2e20 202a 2f0a 2020 2020 2023 756e 6465 . */. #unde │ │ │ │ +00006b50: 6620 4752 5542 5f54 4152 4745 545f 574f f GRUB_TARGET_WO │ │ │ │ +00006b60: 5244 535f 4249 4745 4e44 4941 4e0a 0a20 RDS_BIGENDIAN.. │ │ │ │ +00006b70: 2020 2020 2365 6e64 6966 202f 2a20 2120 #endif /* ! │ │ │ │ +00006b80: 4752 5542 5f54 5950 4553 5f43 5055 5f48 GRUB_TYPES_CPU_H │ │ │ │ +00006b90: 4541 4445 5220 2a2f 0a0a 2020 2059 6f75 EADER */.. You │ │ │ │ +00006ba0: 2077 696c 6c20 616c 736f 206e 6565 6420 will also need │ │ │ │ +00006bb0: 746f 2061 6464 2061 2064 756d 6d79 2066 to add a dummy f │ │ │ │ +00006bc0: 696c 6520 746f 2064 6174 6574 696d 6520 ile to datetime │ │ │ │ +00006bd0: 616e 6420 7365 746a 6d70 206d 6f64 756c and setjmp modul │ │ │ │ +00006be0: 6573 0a74 6f20 6176 6f69 6420 616e 7920 es.to avoid any │ │ │ │ +00006bf0: 6f66 2069 7420 6861 7669 6e67 206e 6f20 of it having no │ │ │ │ +00006c00: 6669 6c65 732e 2020 4974 2063 616e 2062 files. It can b │ │ │ │ +00006c10: 6520 6a75 7374 2063 6f6d 706c 6574 656c e just completel │ │ │ │ +00006c20: 7920 656d 7074 7920 6174 0a74 6869 7320 y empty at.this │ │ │ │ +00006c30: 7374 6167 652e 0a0a 2020 2059 6f75 276c stage... You'l │ │ │ │ +00006c40: 6c20 6e65 6564 2074 6f20 6d61 6b65 2067 l need to make g │ │ │ │ +00006c50: 7275 622d 6d6b 696d 6167 652e 6320 2875 rub-mkimage.c (u │ │ │ │ +00006c60: 7469 6c2f 6772 7562 5f6d 6b69 6d61 6765 til/grub_mkimage │ │ │ │ +00006c70: 2e63 2920 6177 6172 6520 6f66 2074 6865 .c) aware of the │ │ │ │ +00006c80: 0a6e 6565 6465 6420 666f 726d 6174 2e20 .needed format. │ │ │ │ +00006c90: 2046 6f72 206d 6f73 7420 636f 6d6d 6f6e For most common │ │ │ │ +00006ca0: 6c79 2075 7365 6420 666f 726d 6174 7320 ly used formats │ │ │ │ +00006cb0: 6c69 6b65 2045 4c46 2c20 5045 2c20 616f like ELF, PE, ao │ │ │ │ +00006cc0: 7574 206f 7220 7261 770a 7468 6520 7375 ut or raw.the su │ │ │ │ +00006cd0: 7070 6f72 7420 6973 2061 6c72 6561 6479 pport is already │ │ │ │ +00006ce0: 2070 7265 7365 6e74 2061 6e64 2079 6f75 present and you │ │ │ │ +00006cf0: 276c 6c20 6e65 6564 2074 6f20 6d61 6b65 'll need to make │ │ │ │ +00006d00: 2069 7420 666f 6c6c 6f77 2074 6865 0a65 it follow the.e │ │ │ │ +00006d10: 7869 7374 616e 7420 636f 6465 2070 6174 xistant code pat │ │ │ │ +00006d20: 6873 2066 6f72 2079 6f75 7220 706c 6174 hs for your plat │ │ │ │ +00006d30: 666f 726d 2061 6464 696e 6720 6164 6a75 form adding adju │ │ │ │ +00006d40: 7374 6d65 6e74 7320 6966 206e 6563 6573 stments if neces │ │ │ │ +00006d50: 7361 7279 2e0a 5768 656e 2064 6f6e 6520 sary..When done │ │ │ │ +00006d60: 636f 6d70 696c 653a 0a0a 2020 2020 202e compile:.. . │ │ │ │ +00006d70: 2f62 6f6f 7473 7472 6170 0a20 2020 2020 /bootstrap. │ │ │ │ +00006d80: 2e2f 636f 6e66 6967 7572 6520 2d2d 7461 ./configure --ta │ │ │ │ +00006d90: 7267 6574 3d24 6370 7520 2d2d 7769 7468 rget=$cpu --with │ │ │ │ +00006da0: 2d70 6c61 7466 6f72 6d3d 2470 6c61 7466 -platform=$platf │ │ │ │ +00006db0: 6f72 6d20 5441 5247 4554 5f43 433d 2e2e orm TARGET_CC=.. │ │ │ │ +00006dc0: 204f 424a 434f 5059 3d2e 2e2e 2053 5452 OBJCOPY=... STR │ │ │ │ +00006dd0: 4950 3d2e 2e2e 0a20 2020 2020 6d61 6b65 IP=.... make │ │ │ │ +00006de0: 203e 202f 6465 762f 6e75 6c6c 0a0a 2020 > /dev/null.. │ │ │ │ +00006df0: 2041 6e64 2063 7265 6174 6520 696d 6167 And create imag │ │ │ │ +00006e00: 650a 0a20 2020 2020 2e2f 6772 7562 2d6d e.. ./grub-m │ │ │ │ +00006e10: 6b69 6d61 6765 202d 6420 6772 7562 2d63 kimage -d grub-c │ │ │ │ +00006e20: 6f72 6520 2d4f 2024 666f 726d 6174 5f69 ore -O $format_i │ │ │ │ +00006e30: 6420 2d6f 2074 6573 742e 696d 670a 0a20 d -o test.img.. │ │ │ │ +00006e40: 2020 416e 6420 6974 2773 2074 696d 6520 And it's time │ │ │ │ +00006e50: 746f 2074 6573 7420 796f 7572 2074 6573 to test your tes │ │ │ │ +00006e60: 742e 696d 672e 0a0a 2020 2049 6620 6974 t.img... If it │ │ │ │ +00006e70: 2077 6f72 6b73 206e 6578 7420 7374 6167 works next stag │ │ │ │ +00006e80: 6520 6973 2074 6f20 6861 7665 2068 6561 e is to have hea │ │ │ │ +00006e90: 702c 2063 6f6e 736f 6c65 2061 6e64 2074 p, console and t │ │ │ │ +00006ea0: 696d 6572 2e0a 0a20 2020 546f 2068 6176 imer... To hav │ │ │ │ +00006eb0: 6520 7468 6520 6865 6170 2077 6f72 6b69 e the heap worki │ │ │ │ +00006ec0: 6e67 2079 6f75 206e 6565 6420 746f 2064 ng you need to d │ │ │ │ +00006ed0: 6574 6572 6d69 6e65 2077 6869 6368 2072 etermine which r │ │ │ │ +00006ee0: 6567 696f 6e73 2061 7265 0a73 7569 7461 egions are.suita │ │ │ │ +00006ef0: 626c 6520 666f 7220 6865 6170 2075 7361 ble for heap usa │ │ │ │ +00006f00: 6765 2c20 616c 6c6f 6361 7465 2074 6865 ge, allocate the │ │ │ │ +00006f10: 6d20 6672 6f6d 2066 6972 6d77 6172 6520 m from firmware │ │ │ │ +00006f20: 616e 6420 6d61 7020 2869 660a 6170 706c and map (if.appl │ │ │ │ +00006f30: 6963 6162 6c65 292e 2020 5468 656e 2063 icable). Then c │ │ │ │ +00006f40: 616c 6c20 6772 7562 5f6d 6d5f 696e 6974 all grub_mm_init │ │ │ │ +00006f50: 5f72 6567 696f 6e20 2876 6f69 7320 2a73 _region (vois *s │ │ │ │ +00006f60: 7461 7274 2c20 6772 7562 5f73 697a 655f tart, grub_size_ │ │ │ │ +00006f70: 7420 7329 0a66 6f72 2065 7665 7279 206f t s).for every o │ │ │ │ +00006f80: 6620 7468 6973 2072 6567 696f 6e2e 2020 f this region. │ │ │ │ +00006f90: 4173 2061 2073 686f 7274 6375 7420 666f As a shortcut fo │ │ │ │ +00006fa0: 7220 6561 726c 7920 706f 7274 2079 6f75 r early port you │ │ │ │ +00006fb0: 2063 616e 2061 6c6c 6f63 6174 650a 7269 can allocate.ri │ │ │ │ +00006fc0: 6768 7420 6166 7465 7220 5f65 6e64 206f ght after _end o │ │ │ │ +00006fd0: 7220 6861 7665 2061 2062 6967 2073 7461 r have a big sta │ │ │ │ +00006fe0: 7469 6320 6172 7261 7920 666f 7220 6865 tic array for he │ │ │ │ +00006ff0: 6170 2e20 2049 6620 796f 7520 646f 2079 ap. If you do y │ │ │ │ +00007000: 6f75 276c 6c0a 7072 6f62 6162 6c79 206e ou'll.probably n │ │ │ │ +00007010: 6565 6420 746f 2063 6f6d 6520 6261 636b eed to come back │ │ │ │ +00007020: 2074 6f20 7468 6973 206c 6174 6572 2e20 to this later. │ │ │ │ +00007030: 2041 7320 666f 7220 6f75 7470 7574 2063 As for output c │ │ │ │ +00007040: 6f6e 736f 6c65 2079 6f75 0a73 686f 756c onsole you.shoul │ │ │ │ +00007050: 6420 6469 7374 696e 6775 6973 6820 6265 d distinguish be │ │ │ │ +00007060: 7477 6565 6e20 616e 2061 7272 6179 206f tween an array o │ │ │ │ +00007070: 6620 7465 7874 2c20 7465 726d 696e 666f f text, terminfo │ │ │ │ +00007080: 206f 7220 6772 6170 6869 6373 2d62 6173 or graphics-bas │ │ │ │ +00007090: 6564 0a63 6f6e 736f 6c65 2e20 204d 616e ed.console. Man │ │ │ │ +000070a0: 7920 6f66 2072 6561 6c2d 776f 726c 6420 y of real-world │ │ │ │ +000070b0: 6578 616d 706c 6573 2064 6f6e 2774 2066 examples don't f │ │ │ │ +000070c0: 6974 2070 6572 6665 6374 6c79 2069 6e74 it perfectly int │ │ │ │ +000070d0: 6f20 616e 7920 6f66 0a74 6865 7365 2063 o any of.these c │ │ │ │ +000070e0: 6174 6567 6f72 6965 7320 6275 7420 6f6e ategories but on │ │ │ │ +000070f0: 6520 6f66 2074 6865 206d 6f64 656c 7320 e of the models │ │ │ │ +00007100: 6973 2065 6173 6965 7220 746f 2062 6520 is easier to be │ │ │ │ +00007110: 7573 6564 2061 7320 6261 7365 2e20 2049 used as base. I │ │ │ │ +00007120: 6e0a 7365 636f 6e64 2061 6e64 2074 6869 n.second and thi │ │ │ │ +00007130: 7264 2063 6173 6520 796f 7520 7368 6f75 rd case you shou │ │ │ │ +00007140: 6c64 2061 6464 2079 6f75 7220 706c 6174 ld add your plat │ │ │ │ +00007150: 666f 726d 2074 6f20 7465 726d 696e 666f form to terminfo │ │ │ │ +00007160: 6b65 726e 656c 0a72 6573 7065 6374 6976 kernel.respectiv │ │ │ │ +00007170: 656c 7920 7669 6465 6f69 6e6b 6572 6e65 ely videoinkerne │ │ │ │ +00007180: 6c20 6772 6f75 702e 2020 4120 676f 6f64 l group. A good │ │ │ │ +00007190: 2065 7861 6d70 6c65 206f 6620 6172 7261 example of arra │ │ │ │ +000071a0: 7920 6f66 2074 6578 7420 6973 0a69 3338 y of text is.i38 │ │ │ │ +000071b0: 362d 7063 2028 6b65 726e 2f69 3338 362f 6-pc (kern/i386/ │ │ │ │ +000071c0: 7063 2f69 6e69 742e 6320 616e 6420 7465 pc/init.c and te │ │ │ │ +000071d0: 726d 2f69 3338 362f 7063 2f63 6f6e 736f rm/i386/pc/conso │ │ │ │ +000071e0: 6c65 2e63 292e 2020 4f66 2074 6572 6d69 le.c). Of termi │ │ │ │ +000071f0: 6e66 6f0a 6973 2069 6565 6531 3237 3520 nfo.is ieee1275 │ │ │ │ +00007200: 286b 6572 6e2f 6965 6565 3132 3735 2f69 (kern/ieee1275/i │ │ │ │ +00007210: 6e69 742e 6320 616e 6420 7465 726d 2f69 nit.c and term/i │ │ │ │ +00007220: 6565 6531 3237 352f 636f 6e73 6f6c 652e eee1275/console. │ │ │ │ +00007230: 6329 2e20 204f 660a 7669 6465 6f20 6973 c). Of.video is │ │ │ │ +00007240: 206c 6f6f 6e67 736f 6e20 286b 6572 6e2f loongson (kern/ │ │ │ │ +00007250: 6d69 7073 2f6c 6f6f 6e67 736f 6e2f 696e mips/loongson/in │ │ │ │ +00007260: 6974 2e63 292e 2020 4e6f 7465 2074 6861 it.c). Note tha │ │ │ │ +00007270: 7420 7465 726d 696e 666f 2068 6173 0a74 t terminfo has.t │ │ │ │ +00007280: 6f20 6265 2069 6e69 7465 6420 696e 2032 o be inited in 2 │ │ │ │ +00007290: 2073 7461 6765 733a 206f 6e65 2062 6566 stages: one bef │ │ │ │ +000072a0: 6f72 6520 2874 6f20 6765 7420 6174 206c ore (to get at l │ │ │ │ +000072b0: 6561 7374 2072 7564 696d 656e 7461 7279 east rudimentary │ │ │ │ +000072c0: 0a63 6f6e 736f 6c65 2061 7320 6561 726c .console as earl │ │ │ │ +000072d0: 7920 6173 2070 6f73 7369 626c 6529 2061 y as possible) a │ │ │ │ +000072e0: 6e64 2061 6e6f 7468 6572 2061 6674 6572 nd another after │ │ │ │ +000072f0: 2074 6865 2068 6561 7020 2874 6f20 6765 the heap (to ge │ │ │ │ +00007300: 740a 6675 6c6c 2d66 6561 7475 7265 6420 t.full-featured │ │ │ │ +00007310: 636f 6e73 6f6c 6529 2e20 2046 6f72 2074 console). For t │ │ │ │ +00007320: 6865 2069 6e70 7574 2074 6865 7265 2061 he input there a │ │ │ │ +00007330: 7265 2073 7472 696e 6720 6f66 206b 6579 re string of key │ │ │ │ +00007340: 732c 0a74 6572 6d69 6e66 6f20 616e 6420 s,.terminfo and │ │ │ │ +00007350: 6469 7265 6374 2068 6172 6477 6172 652e direct hardware. │ │ │ │ +00007360: 2020 466f 7220 7374 7269 6e67 206f 6620 For string of │ │ │ │ +00007370: 6b65 7973 206c 6f6f 6b20 6174 2069 3338 keys look at i38 │ │ │ │ +00007380: 362d 7063 2028 7361 6d65 0a66 696c 6573 6-pc (same.files │ │ │ │ +00007390: 292c 2066 6f72 2074 6572 6d69 6e6f 2069 ), for termino i │ │ │ │ +000073a0: 6565 6531 3237 3520 2873 616d 6520 6669 eee1275 (same fi │ │ │ │ +000073b0: 6c65 7329 2061 6e64 2066 6f72 2068 6172 les) and for har │ │ │ │ +000073c0: 6477 6172 6520 6c6f 6f6e 6773 6f6e 0a28 dware loongson.( │ │ │ │ +000073d0: 6b65 726e 2f6d 6970 732f 6c6f 6f6e 6773 kern/mips/loongs │ │ │ │ +000073e0: 6f6e 2f69 6e69 742e 6320 616e 6420 7465 on/init.c and te │ │ │ │ +000073f0: 726d 2f61 745f 6b65 7962 6f61 7264 2e63 rm/at_keyboard.c │ │ │ │ +00007400: 292e 0a0a 2020 2046 6f72 2074 6865 2074 )... For the t │ │ │ │ +00007410: 696d 6572 2079 6f75 276c 6c20 6e65 6564 imer you'll need │ │ │ │ +00007420: 2074 6f20 6361 6c6c 2067 7275 625f 696e to call grub_in │ │ │ │ +00007430: 7374 616c 6c5f 6765 745f 7469 6d65 5f6d stall_get_time_m │ │ │ │ +00007440: 7320 282e 2e2e 290a 7769 7468 2061 7320 s (...).with as │ │ │ │ +00007450: 736f 6c65 2061 7267 756d 656e 7420 6120 sole argument a │ │ │ │ +00007460: 6675 6e63 7469 6f6e 2072 6574 7572 6e69 function returni │ │ │ │ +00007470: 6e67 2061 2067 7275 625f 7569 6e74 3634 ng a grub_uint64 │ │ │ │ +00007480: 5f74 206f 6620 6120 6e75 6d62 6572 0a6f _t of a number.o │ │ │ │ +00007490: 6620 6d69 6c6c 6973 6563 6f6e 6473 2065 f milliseconds e │ │ │ │ +000074a0: 6c61 7073 6564 2073 696e 6365 2061 7262 lapsed since arb │ │ │ │ +000074b0: 6974 7261 7279 2070 6f69 6e74 2069 6e20 itrary point in │ │ │ │ +000074c0: 7468 6520 7061 7374 2e0a 0a20 2020 4f6e the past... On │ │ │ │ +000074d0: 6365 2074 6865 7365 2073 7465 7073 2061 ce these steps a │ │ │ │ +000074e0: 6363 6f6d 706c 6973 6865 6420 796f 7520 ccomplished you │ │ │ │ +000074f0: 6361 6e20 7265 6d6f 7665 2074 6865 2069 can remove the i │ │ │ │ +00007500: 6e69 6669 6e69 7465 206c 6f6f 7020 616e nifinite loop an │ │ │ │ +00007510: 640a 796f 7520 7368 6f75 6c64 2062 6520 d.you should be │ │ │ │ +00007520: 6162 6c65 2074 6f20 6765 7420 746f 2074 able to get to t │ │ │ │ +00007530: 6865 206d 696e 696d 616c 2063 6f6e 736f he minimal conso │ │ │ │ +00007540: 6c65 2e20 204e 6578 7420 7374 6570 2069 le. Next step i │ │ │ │ +00007550: 7320 746f 2068 6176 650a 6d6f 6475 6c65 s to have.module │ │ │ │ +00007560: 206c 6f61 6469 6e67 2077 6f72 6b69 6e67 loading working │ │ │ │ +00007570: 2e20 2046 6f72 2074 6869 7320 796f 7527 . For this you' │ │ │ │ +00007580: 6c6c 206e 6565 6420 746f 2066 696c 6c20 ll need to fill │ │ │ │ +00007590: 6b65 726e 2f24 6370 752f 646c 2e63 2061 kern/$cpu/dl.c a │ │ │ │ +000075a0: 6e64 0a6b 6572 6e2f 2463 7075 2f63 6163 nd.kern/$cpu/cac │ │ │ │ +000075b0: 6865 2e53 2077 6974 6820 7265 616c 2068 he.S with real h │ │ │ │ +000075c0: 616e 646c 696e 6720 6f66 2072 656c 6f63 andling of reloc │ │ │ │ +000075d0: 6174 696f 6e73 2061 6e64 2072 6573 7065 ations and respe │ │ │ │ +000075e0: 6374 6976 656c 7920 7468 650a 7265 616c ctively the.real │ │ │ │ +000075f0: 2073 796e 6320 6f66 2049 2061 6e64 2044 sync of I and D │ │ │ │ +00007600: 2063 6163 6865 732e 2020 416c 736f 2079 caches. Also y │ │ │ │ +00007610: 6f75 276c 6c20 6e65 6564 2074 6f20 6465 ou'll need to de │ │ │ │ +00007620: 6369 6465 2077 6865 7265 2069 6e20 7468 cide where in th │ │ │ │ +00007630: 650a 696d 6167 6520 746f 2073 746f 7265 e.image to store │ │ │ │ +00007640: 2074 6865 206d 6f64 756c 6573 2e20 2055 the modules. U │ │ │ │ +00007650: 7375 616c 2077 6179 2069 7320 746f 2068 sual way is to h │ │ │ │ +00007660: 6176 6520 6974 2063 6f6e 6361 7465 6e61 ave it concatena │ │ │ │ +00007670: 7465 6420 6174 2074 6865 0a65 6e64 2e20 ted at the.end. │ │ │ │ +00007680: 2049 6e20 7468 6973 2063 6173 6520 796f In this case yo │ │ │ │ +00007690: 7527 6c6c 206e 6565 6420 746f 206d 6f64 u'll need to mod │ │ │ │ +000076a0: 6966 7920 7374 6172 7475 702e 5320 746f ify startup.S to │ │ │ │ +000076b0: 2063 6f70 7920 6d6f 6475 6c65 7320 6f75 copy modules ou │ │ │ │ +000076c0: 740a 6f66 2062 7373 2074 6f20 6c65 7427 t.of bss to let' │ │ │ │ +000076d0: 7320 7361 7920 414c 4947 4e5f 5550 2028 s say ALIGN_UP ( │ │ │ │ +000076e0: 5f65 6e64 2c20 3829 2062 6566 6f72 6520 _end, 8) before │ │ │ │ +000076f0: 636c 6561 6e69 6e67 206f 7574 2062 7373 cleaning out bss │ │ │ │ +00007700: 2e20 2059 6f75 276c 6c0a 7072 6f62 6162 . You'll.probab │ │ │ │ +00007710: 6c79 2066 696e 6420 7573 6566 756c 2074 ly find useful t │ │ │ │ +00007720: 6f20 6164 6420 746f 7461 6c5f 6d6f 6475 o add total_modu │ │ │ │ +00007730: 6c65 5f73 697a 6520 6669 656c 6420 746f le_size field to │ │ │ │ +00007740: 2073 7461 7274 7570 2e53 2e20 496e 0a69 startup.S. In.i │ │ │ │ +00007750: 6e69 742e 6320 796f 7520 6e65 6564 2074 nit.c you need t │ │ │ │ +00007760: 6f20 7365 7420 6772 7562 5f6d 6f64 6261 o set grub_modba │ │ │ │ +00007770: 7365 2074 6f20 7468 6520 6164 6472 6573 se to the addres │ │ │ │ +00007780: 7320 7768 6572 6520 6d6f 6475 6c65 7320 s where modules │ │ │ │ +00007790: 6361 6e20 6265 0a66 6f75 6e64 2e20 2059 can be.found. Y │ │ │ │ +000077a0: 6f75 206d 6179 206e 6565 6420 6772 7562 ou may need grub │ │ │ │ +000077b0: 5f6d 6f64 756c 6573 5f67 6574 5f65 6e64 _modules_get_end │ │ │ │ +000077c0: 2028 2920 746f 2061 766f 6964 2064 6563 () to avoid dec │ │ │ │ +000077d0: 6c61 7269 6e67 2074 6865 0a73 7061 6365 laring the.space │ │ │ │ +000077e0: 206f 6363 7570 6965 6420 6279 206d 6f64 occupied by mod │ │ │ │ +000077f0: 756c 6573 2061 7320 7573 6162 6c65 2066 ules as usable f │ │ │ │ +00007800: 6f72 2068 6561 702e 2020 596f 7520 6361 or heap. You ca │ │ │ │ +00007810: 6e20 7465 7374 206d 6f64 756c 6573 0a77 n test modules.w │ │ │ │ +00007820: 6974 683a 0a0a 2020 2020 202e 2f67 7275 ith:.. ./gru │ │ │ │ +00007830: 622d 6d6b 696d 6167 6520 2d64 2067 7275 b-mkimage -d gru │ │ │ │ +00007840: 622d 636f 7265 202d 4f20 2466 6f72 6d61 b-core -O $forma │ │ │ │ +00007850: 745f 6964 202d 6f20 7465 7374 2e69 6d67 t_id -o test.img │ │ │ │ +00007860: 2068 656c 6c6f 0a0a 2020 2061 6e64 2074 hello.. and t │ │ │ │ +00007870: 6865 6e20 7275 6e6e 696e 6720 2268 656c hen running "hel │ │ │ │ +00007880: 6c6f 2220 696e 2074 6865 2073 6865 6c6c lo" in the shell │ │ │ │ +00007890: 2e0a 0a20 2020 4f6e 6365 2074 6869 7320 ... Once this │ │ │ │ +000078a0: 776f 726b 732c 2079 6f75 2073 686f 756c works, you shoul │ │ │ │ +000078b0: 6420 7468 696e 6b20 6f66 2069 6d70 6c65 d think of imple │ │ │ │ +000078c0: 6d65 6e74 696e 6720 6469 736b 2061 6363 menting disk acc │ │ │ │ +000078d0: 6573 732e 2020 4c6f 6f6b 0a61 726f 756e ess. Look.aroun │ │ │ │ +000078e0: 6420 6469 736b 2f20 666f 7220 6578 616d d disk/ for exam │ │ │ │ +000078f0: 706c 6573 2e0a 0a20 2020 5468 656e 2c20 ples... Then, │ │ │ │ +00007900: 7665 7279 2069 6d70 6f72 7461 6e74 6c79 very importantly │ │ │ │ +00007910: 2c20 796f 7520 7072 6f62 6162 6c79 206e , you probably n │ │ │ │ +00007920: 6565 6420 746f 2069 6d70 6c65 6d65 6e74 eed to implement │ │ │ │ +00007930: 2074 6865 2061 6374 7561 6c0a 6c6f 6164 the actual.load │ │ │ │ +00007940: 6572 2028 6578 616d 706c 6573 2061 7661 er (examples ava │ │ │ │ +00007950: 696c 6162 6c65 2069 6e20 6c6f 6164 6572 ilable in loader │ │ │ │ +00007960: 2f29 0a0a 2020 204c 6173 7420 7374 6570 /).. Last step │ │ │ │ +00007970: 2074 6f20 6861 7665 206d 696e 696d 616c to have minimal │ │ │ │ +00007980: 6c79 2075 7361 626c 6520 706f 7274 2069 ly usable port i │ │ │ │ +00007990: 7320 746f 2061 6464 2073 7570 706f 7274 s to add support │ │ │ │ +000079a0: 2074 6f0a 6772 7562 2d69 6e73 7461 6c6c to.grub-install │ │ │ │ +000079b0: 2074 6f20 7075 7420 4752 5542 2069 6e20 to put GRUB in │ │ │ │ +000079c0: 6120 706c 6163 6520 7768 6572 6520 6669 a place where fi │ │ │ │ +000079d0: 726d 7761 7265 206f 7220 706c 6174 666f rmware or platfo │ │ │ │ +000079e0: 726d 2077 696c 6c20 7069 636b 0a69 7420 rm will pick.it │ │ │ │ +000079f0: 7570 2e0a 0a20 2020 4e65 7874 2073 7465 up... Next ste │ │ │ │ +00007a00: 7073 2061 7265 3a20 6669 6c6c 696e 6720 ps are: filling │ │ │ │ +00007a10: 6461 7465 7469 6d65 2e63 2c20 7365 746a datetime.c, setj │ │ │ │ +00007a20: 6d70 2e53 2c20 6e65 7477 6f72 6b20 286e mp.S, network (n │ │ │ │ +00007a30: 6574 2f64 7269 7665 7273 292c 0a76 6964 et/drivers),.vid │ │ │ │ +00007a40: 656f 2028 7669 6465 6f2f 292c 2068 616c eo (video/), hal │ │ │ │ +00007a50: 7420 286c 6962 2f29 2c20 7265 626f 6f74 t (lib/), reboot │ │ │ │ +00007a60: 2028 6c69 622f 292e 0a0a 2020 2050 6c65 (lib/)... Ple │ │ │ │ +00007a70: 6173 6520 6164 6420 796f 7572 2070 6c61 ase add your pla │ │ │ │ +00007a80: 7466 6f72 6d20 746f 2050 6c61 7466 6f72 tform to Platfor │ │ │ │ +00007a90: 6d20 6c69 6d69 7461 7469 6f6e 7320 616e m limitations an │ │ │ │ +00007aa0: 6420 5375 7070 6f72 7465 640a 6b65 726e d Supported.kern │ │ │ │ +00007ab0: 656c 7320 6368 6170 7465 7220 696e 2075 els chapter in u │ │ │ │ +00007ac0: 7365 7220 646f 6375 6d65 6e74 6174 696f ser documentatio │ │ │ │ +00007ad0: 6e20 616e 6420 6d65 6e74 696f 6e20 616e n and mention an │ │ │ │ +00007ae0: 7920 7374 6570 7320 796f 7520 736b 6970 y steps you skip │ │ │ │ +00007af0: 7065 640a 7768 6963 6820 7265 7375 6c74 ped.which result │ │ │ │ +00007b00: 2069 6e20 7265 6475 6365 6420 6665 6174 in reduced feat │ │ │ │ +00007b10: 7572 6573 206f 7220 7065 7266 6f72 6d61 ures or performa │ │ │ │ +00007b20: 6e63 652e 2020 4865 7265 2069 7320 7468 nce. Here is th │ │ │ │ +00007b30: 6520 7175 6963 6b0a 6368 6563 6b6c 6973 e quick.checklis │ │ │ │ +00007b40: 7420 6f66 2066 6561 7475 7265 732e 2020 t of features. │ │ │ │ +00007b50: 536f 6d65 206f 6620 7468 656d 2061 7265 Some of them are │ │ │ │ +00007b60: 206c 6573 7320 696d 706f 7274 616e 7420 less important │ │ │ │ +00007b70: 7468 616e 206f 7468 6572 7320 616e 640a than others and. │ │ │ │ +00007b80: 736b 6970 7069 6e67 2074 6865 6d20 6973 skipping them is │ │ │ │ +00007b90: 2063 6f6d 706c 6574 656c 7920 6f6b 2c20 completely ok, │ │ │ │ +00007ba0: 6a75 7374 206e 6565 6473 2074 6f20 6265 just needs to be │ │ │ │ +00007bb0: 206d 656e 7469 6f6e 6564 2069 6e20 7573 mentioned in us │ │ │ │ +00007bc0: 6572 0a64 6f63 756d 656e 7461 7469 6f6e er.documentation │ │ │ │ +00007bd0: 2e0a 0a20 2020 4368 6563 6b6c 6973 743a ... Checklist: │ │ │ │ +00007be0: 0a20 2020 2a20 4973 2068 6561 7020 6269 . * Is heap bi │ │ │ │ +00007bf0: 6720 656e 6f75 6768 3f0a 2020 202a 2057 g enough?. * W │ │ │ │ +00007c00: 6869 6368 2063 6861 7273 6574 2069 7320 hich charset is │ │ │ │ +00007c10: 7375 7070 6f72 7465 6420 6279 2063 6f6e supported by con │ │ │ │ +00007c20: 736f 6c65 3f0a 2020 202a 2044 6f65 7320 sole?. * Does │ │ │ │ +00007c30: 706c 6174 666f 726d 2068 6176 6520 6469 platform have di │ │ │ │ +00007c40: 736b 2064 7269 7665 723f 0a20 2020 2a20 sk driver?. * │ │ │ │ +00007c50: 446f 2079 6f75 2068 6176 6520 6e65 7477 Do you have netw │ │ │ │ +00007c60: 6f72 6b20 6361 7264 2073 7570 706f 7274 ork card support │ │ │ │ +00007c70: 3f0a 2020 202a 2041 7265 2079 6f75 2061 ?. * Are you a │ │ │ │ +00007c80: 626c 6520 746f 2072 6574 7269 6576 6520 ble to retrieve │ │ │ │ +00007c90: 6461 7465 7469 6d65 2028 7769 7468 2064 datetime (with d │ │ │ │ +00007ca0: 6174 6529 3f0a 2020 202a 2041 7265 2079 ate)?. * Are y │ │ │ │ +00007cb0: 6f75 2061 626c 6520 746f 2073 6574 2064 ou able to set d │ │ │ │ +00007cc0: 6174 6574 696d 6520 2877 6974 6820 6461 atetime (with da │ │ │ │ +00007cd0: 7465 293f 0a20 2020 2a20 4973 2073 6572 te)?. * Is ser │ │ │ │ +00007ce0: 6961 6c20 7375 7070 6f72 7465 643f 0a20 ial supported?. │ │ │ │ +00007cf0: 2020 2a20 446f 2079 6f75 2068 6176 6520 * Do you have │ │ │ │ +00007d00: 6469 7265 6374 2064 6973 6b20 7375 7070 direct disk supp │ │ │ │ +00007d10: 6f72 743f 0a20 2020 2a20 446f 2079 6f75 ort?. * Do you │ │ │ │ +00007d20: 2068 6176 6520 6469 7265 6374 206b 6579 have direct key │ │ │ │ +00007d30: 626f 6172 6420 7375 7070 6f72 743f 0a20 board support?. │ │ │ │ +00007d40: 2020 2a20 446f 2079 6f75 2068 6176 6520 * Do you have │ │ │ │ +00007d50: 5553 4220 7375 7070 6f72 743f 0a20 2020 USB support?. │ │ │ │ +00007d60: 2a20 446f 2079 6f75 2073 7570 706f 7274 * Do you support │ │ │ │ +00007d70: 206c 6f61 6469 6e67 2074 6872 6f75 6768 loading through │ │ │ │ +00007d80: 206e 6574 776f 726b 3f0a 2020 202a 2044 network?. * D │ │ │ │ +00007d90: 6f20 796f 7520 7375 7070 6f72 7420 6c6f o you support lo │ │ │ │ +00007da0: 6164 696e 6720 6672 6f6d 2064 6973 6b3f ading from disk? │ │ │ │ +00007db0: 0a20 2020 2a20 446f 2079 6f75 2073 7570 . * Do you sup │ │ │ │ +00007dc0: 706f 7274 2063 6861 696e 6c6f 6164 696e port chainloadin │ │ │ │ +00007dd0: 673f 0a20 2020 2a20 446f 2079 6f75 2073 g?. * Do you s │ │ │ │ +00007de0: 7570 706f 7274 206e 6574 776f 726b 2063 upport network c │ │ │ │ +00007df0: 6861 696e 6c6f 6164 696e 673f 0a20 2020 hainloading?. │ │ │ │ +00007e00: 2a20 446f 6573 2063 7075 6964 2063 6f6d * Does cpuid com │ │ │ │ +00007e10: 6d61 6e64 2073 7570 706f 7274 7320 6368 mand supports ch │ │ │ │ +00007e20: 6563 6b69 6e67 2061 6c6c 2043 5055 2066 ecking all CPU f │ │ │ │ +00007e30: 6561 7475 7265 7320 7468 6174 2074 6865 eatures that the │ │ │ │ +00007e40: 2075 7365 720a 2020 2020 206d 6967 6874 user. might │ │ │ │ +00007e50: 2077 616e 7420 636f 6e64 6974 696f 6e61 want conditiona │ │ │ │ +00007e60: 6c69 7365 206f 6e20 2836 342d 6269 7420 lise on (64-bit │ │ │ │ +00007e70: 6d6f 6465 2c20 6879 7065 7276 6973 6f72 mode, hypervisor │ │ │ │ +00007e80: 2c2e 2e2e 290a 2020 202a 2044 6f20 796f ,...). * Do yo │ │ │ │ +00007e90: 7520 7375 7070 6f72 7420 6869 6e74 733f u support hints? │ │ │ │ +00007ea0: 2020 486f 7720 7265 6c69 6162 6c65 2061 How reliable a │ │ │ │ +00007eb0: 7265 2074 6865 793f 0a20 2020 2a20 446f re they?. * Do │ │ │ │ +00007ec0: 6573 2070 6c61 7466 6f72 6d20 6861 7665 es platform have │ │ │ │ +00007ed0: 2041 4350 493f 2049 6620 736f 2064 6f20 ACPI? If so do │ │ │ │ +00007ee0: 2261 6370 6922 2061 6e64 2022 6c73 6163 "acpi" and "lsac │ │ │ │ +00007ef0: 7069 2220 6d6f 6475 6c65 7320 776f 726b pi" modules work │ │ │ │ +00007f00: 3f0a 2020 202a 2044 6f20 616e 7920 6f66 ?. * Do any of │ │ │ │ +00007f10: 2070 6c61 7466 6f72 6d2d 7370 6563 6966 platform-specif │ │ │ │ +00007f20: 6963 206f 7065 7261 7469 6f6e 7320 6d65 ic operations me │ │ │ │ +00007f30: 6e74 696f 6e65 6420 696e 2074 6865 2072 ntioned in the r │ │ │ │ +00007f40: 656c 6576 616e 740a 2020 2020 2073 6563 elevant. sec │ │ │ │ +00007f50: 7469 6f6e 206f 6620 7573 6572 206d 616e tion of user man │ │ │ │ +00007f60: 7561 6c20 6d61 6b65 7320 7365 6e73 6520 ual makes sense │ │ │ │ +00007f70: 6f6e 2079 6f75 7220 706c 6174 666f 726d on your platform │ │ │ │ +00007f80: 3f0a 2020 202a 2044 6f65 7320 796f 7572 ?. * Does your │ │ │ │ +00007f90: 2070 6c61 7466 6f72 6d20 7375 7070 6f72 platform suppor │ │ │ │ +00007fa0: 7420 5043 493f 2049 6620 736f 2069 7320 t PCI? If so is │ │ │ │ +00007fb0: 7468 6572 6520 616e 2061 7070 726f 7072 there an appropr │ │ │ │ +00007fc0: 6961 7465 0a20 2020 2020 6472 6976 6572 iate. driver │ │ │ │ +00007fd0: 2066 6f72 2047 5255 423f 0a20 2020 2a20 for GRUB?. * │ │ │ │ +00007fe0: 446f 2079 6f75 2073 7570 706f 7274 2062 Do you support b │ │ │ │ +00007ff0: 6164 7261 6d3f 0a0a 1f0a 4669 6c65 3a20 adram?....File: │ │ │ │ +00008000: 6772 7562 2d64 6576 2e69 6e66 6f2c 2020 grub-dev.info, │ │ │ │ +00008010: 4e6f 6465 3a20 4572 726f 7220 4861 6e64 Node: Error Hand │ │ │ │ +00008020: 6c69 6e67 2c20 204e 6578 743a 2053 7461 ling, Next: Sta │ │ │ │ +00008030: 636b 2061 6e64 2068 6561 7020 7369 7a65 ck and heap size │ │ │ │ +00008040: 2c20 2050 7265 763a 2050 6f72 7469 6e67 , Prev: Porting │ │ │ │ +00008050: 2c20 2055 703a 2054 6f70 0a0a 3720 4572 , Up: Top..7 Er │ │ │ │ +00008060: 726f 7220 4861 6e64 6c69 6e67 0a2a 2a2a ror Handling.*** │ │ │ │ +00008070: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a0a 0a45 *************..E │ │ │ │ +00008080: 7272 6f72 2068 616e 646c 696e 6720 696e rror handling in │ │ │ │ +00008090: 2047 5255 4220 3220 6973 2062 6173 6564 GRUB 2 is based │ │ │ │ +000080a0: 206f 6e20 6578 6365 7074 696f 6e20 6861 on exception ha │ │ │ │ +000080b0: 6e64 6c69 6e67 206d 6f64 656c 2e20 2041 ndling model. A │ │ │ │ +000080c0: 7320 430a 6c61 6e67 7561 6765 2064 6f65 s C.language doe │ │ │ │ +000080d0: 736e 2774 2064 6972 6563 746c 7920 7375 sn't directly su │ │ │ │ +000080e0: 7070 6f72 7420 6578 6365 7074 696f 6e73 pport exceptions │ │ │ │ +000080f0: 2c20 6578 6365 7074 696f 6e20 6861 6e64 , exception hand │ │ │ │ +00008100: 6c69 6e67 0a62 6568 6176 696f 7220 6973 ling.behavior is │ │ │ │ +00008110: 2065 6d75 6c61 7465 6420 696e 2073 6f66 emulated in sof │ │ │ │ +00008120: 7477 6172 652e 0a0a 2020 2057 6865 6e20 tware... When │ │ │ │ +00008130: 6578 6365 7074 696f 6e20 6973 2072 6169 exception is rai │ │ │ │ +00008140: 7365 642c 2066 756e 6374 696f 6e20 6d75 sed, function mu │ │ │ │ +00008150: 7374 2072 6574 7572 6e20 746f 2063 616c st return to cal │ │ │ │ +00008160: 6c69 6e67 2066 756e 6374 696f 6e2e 0a49 ling function..I │ │ │ │ +00008170: 6620 6361 6c6c 696e 6720 6675 6e63 7469 f calling functi │ │ │ │ +00008180: 6f6e 2064 6f65 7320 6e6f 7420 7072 6f76 on does not prov │ │ │ │ +00008190: 6964 6520 6861 6e64 6c69 6e67 206f 6620 ide handling of │ │ │ │ +000081a0: 7468 6520 6578 6365 7074 696f 6e20 6974 the exception it │ │ │ │ +000081b0: 206d 7573 740a 7265 7475 726e 2062 6163 must.return bac │ │ │ │ +000081c0: 6b20 746f 2069 7473 2063 616c 6c69 6e67 k to its calling │ │ │ │ +000081d0: 2066 756e 6374 696f 6e20 616e 6420 736f function and so │ │ │ │ +000081e0: 206f 6e2c 2075 6e74 696c 2065 7863 6570 on, until excep │ │ │ │ +000081f0: 7469 6f6e 2069 730a 6861 6e64 6c65 642e tion is.handled. │ │ │ │ +00008200: 2020 4966 2065 7863 6570 7469 6f6e 2069 If exception i │ │ │ │ +00008210: 7320 6e6f 7420 6861 6e64 6c65 6420 6265 s not handled be │ │ │ │ +00008220: 666f 7265 2070 726f 6d70 7420 6973 2064 fore prompt is d │ │ │ │ +00008230: 6973 706c 6179 6564 2c20 6572 726f 720a isplayed, error. │ │ │ │ +00008240: 6d65 7373 6167 6520 7769 6c6c 2062 6520 message will be │ │ │ │ +00008250: 7368 6f77 6e20 746f 2075 7365 722e 0a0a shown to user... │ │ │ │ +00008260: 2020 2045 7863 6570 7469 6f6e 2069 6e66 Exception inf │ │ │ │ +00008270: 6f72 6d61 7469 6f6e 2069 7320 7374 6f72 ormation is stor │ │ │ │ +00008280: 6564 206f 6e20 2767 7275 625f 6572 726e ed on 'grub_errn │ │ │ │ +00008290: 6f27 2067 6c6f 6261 6c20 7661 7269 6162 o' global variab │ │ │ │ +000082a0: 6c65 2e20 2049 660a 2767 7275 625f 6572 le. If.'grub_er │ │ │ │ +000082b0: 726e 6f27 2076 6172 6961 626c 6520 636f rno' variable co │ │ │ │ +000082c0: 6e74 6169 6e73 2076 616c 7565 2027 4752 ntains value 'GR │ │ │ │ +000082d0: 5542 5f45 5252 5f4e 4f4e 4527 2c20 7468 UB_ERR_NONE', th │ │ │ │ +000082e0: 6572 6520 6973 206e 6f20 6163 7469 7665 ere is no active │ │ │ │ +000082f0: 0a65 7863 6570 7469 6f6e 2061 6e64 2061 .exception and a │ │ │ │ +00008300: 7070 6c69 6361 7469 6f6e 2063 616e 2063 pplication can c │ │ │ │ +00008310: 6f6e 7469 6e75 6520 6e6f 726d 616c 2070 ontinue normal p │ │ │ │ +00008320: 726f 6365 7373 696e 672e 2020 5768 656e rocessing. When │ │ │ │ +00008330: 0a27 6772 7562 5f65 7272 6e6f 2720 6861 .'grub_errno' ha │ │ │ │ +00008340: 7320 6f74 6865 7220 7661 6c75 652c 2069 s other value, i │ │ │ │ +00008350: 7420 6973 2072 6571 7569 7265 6420 7468 t is required th │ │ │ │ +00008360: 6174 2061 7070 6c69 6361 7469 6f6e 2063 at application c │ │ │ │ +00008370: 6f64 650a 6569 7468 6572 2068 616e 646c ode.either handl │ │ │ │ +00008380: 6573 2074 6869 7320 6572 726f 7220 6f72 es this error or │ │ │ │ +00008390: 2072 6574 7572 6e73 2069 6e73 7461 6e74 returns instant │ │ │ │ +000083a0: 6c79 2074 6f20 6361 6c6c 6572 2e20 2049 ly to caller. I │ │ │ │ +000083b0: 6620 6675 6e63 7469 6f6e 0a69 7320 7769 f function.is wi │ │ │ │ +000083c0: 7468 2072 6574 7572 6e20 7479 7065 2027 th return type ' │ │ │ │ +000083d0: 6772 7562 5f65 7272 5f74 2720 6973 2061 grub_err_t' is a │ │ │ │ +000083e0: 626f 7574 2074 6f20 7265 7475 726e 2027 bout to return ' │ │ │ │ +000083f0: 4752 5542 5f45 5252 5f4e 4f4e 4527 2c20 GRUB_ERR_NONE', │ │ │ │ +00008400: 6974 0a73 686f 756c 6420 6e6f 7420 7365 it.should not se │ │ │ │ +00008410: 7420 2767 7275 625f 6572 726e 6f27 2074 t 'grub_errno' t │ │ │ │ +00008420: 6f20 7468 6174 2076 616c 7565 2e20 204f o that value. O │ │ │ │ +00008430: 6e6c 7920 7365 7420 2767 7275 625f 6572 nly set 'grub_er │ │ │ │ +00008440: 726e 6f27 2069 6e0a 6361 7365 7320 7768 rno' in.cases wh │ │ │ │ +00008450: 6572 6520 7468 6572 6520 6973 2065 7272 ere there is err │ │ │ │ +00008460: 6f72 2073 6974 7561 7469 6f6e 2e0a 0a20 or situation... │ │ │ │ +00008470: 2020 5369 6d70 6c65 2065 7863 6570 7469 Simple excepti │ │ │ │ +00008480: 6f6e 2066 6f72 7761 7264 6572 2e0a 2020 on forwarder.. │ │ │ │ +00008490: 2020 2067 7275 625f 6572 725f 740a 2020 grub_err_t. │ │ │ │ +000084a0: 2020 2066 6f72 7761 7264 696e 675f 6578 forwarding_ex │ │ │ │ +000084b0: 616d 706c 6520 2876 6f69 6429 0a20 2020 ample (void). │ │ │ │ +000084c0: 2020 7b0a 2020 2020 2020 202f 2a20 4361 {. /* Ca │ │ │ │ +000084d0: 6c6c 2066 756e 6374 696f 6e20 7468 6174 ll function that │ │ │ │ +000084e0: 206d 6967 6874 2063 6175 7365 2065 7863 might cause exc │ │ │ │ +000084f0: 6570 7469 6f6e 2e20 202a 2f0a 2020 2020 eption. */. │ │ │ │ +00008500: 2020 2066 6f6f 6261 7220 2829 3b0a 0a20 foobar ();.. │ │ │ │ +00008510: 2020 2020 2020 2f2a 204e 6f20 7370 6563 /* No spec │ │ │ │ +00008520: 6961 6c20 6578 6365 7074 696f 6e20 6861 ial exception ha │ │ │ │ +00008530: 6e64 6c65 722c 206a 7573 7420 666f 7277 ndler, just forw │ │ │ │ +00008540: 6172 6420 706f 7373 6962 6c65 2065 7863 ard possible exc │ │ │ │ +00008550: 6570 7469 6f6e 732e 2020 2a2f 0a20 2020 eptions. */. │ │ │ │ +00008560: 2020 2020 6966 2028 6772 7562 5f65 7272 if (grub_err │ │ │ │ +00008570: 6e6f 2021 3d20 4752 5542 5f45 5252 5f4e no != GRUB_ERR_N │ │ │ │ +00008580: 4f4e 4529 0a20 2020 2020 2020 2020 7b0a ONE). {. │ │ │ │ +00008590: 2020 2020 2020 2020 2020 2072 6574 7572 retur │ │ │ │ +000085a0: 6e20 6772 7562 5f65 7272 6e6f 3b0a 2020 n grub_errno;. │ │ │ │ +000085b0: 2020 2020 2020 207d 0a0a 2020 2020 2020 }.. │ │ │ │ +000085c0: 202f 2a20 416c 6c20 6973 204f 4b2c 2064 /* All is OK, d │ │ │ │ +000085d0: 6f20 6d6f 7265 2070 726f 6365 7373 696e o more processin │ │ │ │ +000085e0: 672e 2020 2a2f 0a0a 2020 2020 2020 202f g. */.. / │ │ │ │ +000085f0: 2a20 5265 7475 726e 204f 4b20 7369 676e * Return OK sign │ │ │ │ +00008600: 616c 2c20 746f 2063 616c 6c65 722e 2020 al, to caller. │ │ │ │ +00008610: 2a2f 0a20 2020 2020 2020 7265 7475 726e */. return │ │ │ │ +00008620: 2047 5255 425f 4552 525f 4e4f 4e45 3b0a GRUB_ERR_NONE;. │ │ │ │ +00008630: 2020 2020 207d 0a0a 2020 2045 7272 6f72 }.. Error │ │ │ │ +00008640: 2072 6570 6f72 7469 6e67 2068 6173 2074 reporting has t │ │ │ │ +00008650: 776f 2063 6f6d 706f 6e65 6e74 732c 2074 wo components, t │ │ │ │ +00008660: 6865 2061 6374 7561 6c20 6572 726f 7220 he actual error │ │ │ │ +00008670: 636f 6465 2028 6f66 2074 7970 650a 2767 code (of type.'g │ │ │ │ +00008680: 7275 625f 6572 725f 7427 2920 616e 6420 rub_err_t') and │ │ │ │ +00008690: 7465 7874 7561 6c20 6d65 7373 6167 6520 textual message │ │ │ │ +000086a0: 7468 6174 2077 696c 6c20 6265 2064 6973 that will be dis │ │ │ │ +000086b0: 706c 6179 6564 2074 6f20 7573 6572 2e20 played to user. │ │ │ │ +000086c0: 204c 6973 740a 6f66 2076 616c 6964 2065 List.of valid e │ │ │ │ +000086d0: 7272 6f72 2063 6f64 6573 2069 7320 6c69 rror codes is li │ │ │ │ +000086e0: 7374 6564 2069 6e20 6865 6164 6572 2066 sted in header f │ │ │ │ +000086f0: 696c 6520 2769 6e63 6c75 6465 2f67 7275 ile 'include/gru │ │ │ │ +00008700: 622f 6572 722e 6827 2e0a 5465 7874 7561 b/err.h'..Textua │ │ │ │ +00008710: 6c20 6572 726f 7220 6d65 7373 6167 6520 l error message │ │ │ │ +00008720: 6361 6e20 636f 6e74 6169 6e20 616e 7920 can contain any │ │ │ │ +00008730: 7465 7874 7561 6c20 6461 7461 2e20 2041 textual data. A │ │ │ │ +00008740: 7420 7469 6d65 206f 6620 7772 6974 696e t time of writin │ │ │ │ +00008750: 672c 0a65 7272 6f72 206d 6573 7361 6765 g,.error message │ │ │ │ +00008760: 2063 616e 2063 6f6e 7461 696e 2075 7020 can contain up │ │ │ │ +00008770: 746f 2032 3536 2063 6861 7261 6374 6572 to 256 character │ │ │ │ +00008780: 7320 2869 6e63 6c75 6469 6e67 2074 6572 s (including ter │ │ │ │ +00008790: 6d69 6e61 7469 6e67 0a4e 554c 292e 2054 minating.NUL). T │ │ │ │ +000087a0: 6f20 6561 7365 2065 7272 6f72 2072 6570 o ease error rep │ │ │ │ +000087b0: 6f72 7469 6e67 2074 6865 7265 2069 7320 orting there is │ │ │ │ +000087c0: 6120 6865 6c70 6572 2066 756e 6374 696f a helper functio │ │ │ │ +000087d0: 6e20 2767 7275 625f 6572 726f 7227 0a74 n 'grub_error'.t │ │ │ │ +000087e0: 6861 7420 616c 6c6f 7773 2065 6173 6965 hat allows easie │ │ │ │ +000087f0: 7220 666f 726d 6174 7469 6e67 206f 6620 r formatting of │ │ │ │ +00008800: 6572 726f 7220 6d65 7373 6167 6573 2061 error messages a │ │ │ │ +00008810: 6e64 2073 686f 756c 6420 6265 2075 7365 nd should be use │ │ │ │ +00008820: 640a 696e 7374 6561 6420 6f66 2077 7269 d.instead of wri │ │ │ │ +00008830: 7469 6e67 2064 6972 6563 746c 7920 746f ting directly to │ │ │ │ +00008840: 2067 6c6f 6261 6c20 7661 7269 6162 6c65 global variable │ │ │ │ +00008850: 732e 0a0a 2020 2045 7861 6d70 6c65 206f s... Example o │ │ │ │ +00008860: 6620 6572 726f 7220 7265 706f 7274 696e f error reportin │ │ │ │ +00008870: 672e 0a20 2020 2020 6772 7562 5f65 7272 g.. grub_err │ │ │ │ +00008880: 5f74 0a20 2020 2020 6661 696c 696e 675f _t. failing_ │ │ │ │ +00008890: 6578 616d 706c 6520 2829 0a20 2020 2020 example (). │ │ │ │ +000088a0: 7b0a 2020 2020 2020 2072 6574 7572 6e20 {. return │ │ │ │ +000088b0: 6772 7562 5f65 7272 6f72 2028 4752 5542 grub_error (GRUB │ │ │ │ +000088c0: 5f45 5252 5f46 494c 455f 4e4f 545f 464f _ERR_FILE_NOT_FO │ │ │ │ +000088d0: 554e 442c 0a20 2020 2020 2020 2020 2020 UND,. │ │ │ │ +000088e0: 2020 2020 2020 2020 2020 2020 2020 2022 " │ │ │ │ +000088f0: 4661 696c 6564 2074 6f20 7265 6164 2025 Failed to read % │ │ │ │ +00008900: 732c 2074 7269 6564 2025 6420 7469 6d65 s, tried %d time │ │ │ │ +00008910: 732e 222c 0a20 2020 2020 2020 2020 2020 s.",. │ │ │ │ +00008920: 2020 2020 2020 2020 2020 2020 2020 2022 " │ │ │ │ +00008930: 7465 7374 2e74 7874 222c 0a20 2020 2020 test.txt",. │ │ │ │ 00008940: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00008950: 2031 3029 3b0a 2020 2020 207d 0a0a 2020 10);. }.. │ │ │ │ -00008960: 2049 6620 7468 6572 6520 6973 2061 2073 If there is a s │ │ │ │ -00008970: 7065 6369 616c 2072 6561 736f 6e20 7468 pecial reason th │ │ │ │ -00008980: 6174 2065 7272 6f72 2063 6f64 6520 646f at error code do │ │ │ │ -00008990: 6573 206e 6f74 206e 6565 6420 746f 2062 es not need to b │ │ │ │ -000089a0: 650a 7461 6b65 6e20 6163 636f 756e 742c e.taken account, │ │ │ │ -000089b0: 2027 6772 7562 5f65 7272 6e6f 2720 6361 'grub_errno' ca │ │ │ │ -000089c0: 6e20 6265 207a 6572 6f65 6420 6261 636b n be zeroed back │ │ │ │ -000089d0: 2074 6f20 2747 5255 425f 4552 525f 4e4f to 'GRUB_ERR_NO │ │ │ │ -000089e0: 4e45 272e 2020 496e 0a63 6173 6573 206c NE'. In.cases l │ │ │ │ -000089f0: 696b 6520 7468 6973 2061 6c6c 2070 7265 ike this all pre │ │ │ │ -00008a00: 7669 6f75 7320 6572 726f 7220 636f 6465 vious error code │ │ │ │ -00008a10: 7320 7368 6f75 6c64 2068 6176 6520 6265 s should have be │ │ │ │ -00008a20: 656e 2068 616e 646c 6564 0a63 6f72 7265 en handled.corre │ │ │ │ -00008a30: 6374 6c79 2e20 2054 6869 7320 6d61 6b65 ctly. This make │ │ │ │ -00008a40: 7320 7375 7265 2074 6861 7420 7468 6572 s sure that ther │ │ │ │ -00008a50: 6520 6172 6520 6e6f 2075 6e68 616e 646c e are no unhandl │ │ │ │ -00008a60: 6564 2065 7863 6570 7469 6f6e 732e 0a0a ed exceptions... │ │ │ │ -00008a70: 2020 2045 7861 6d70 6c65 206f 6620 7a65 Example of ze │ │ │ │ -00008a80: 726f 696e 6720 2767 7275 625f 6572 726e roing 'grub_errn │ │ │ │ -00008a90: 6f27 2e0a 2020 2020 2067 7275 625f 6572 o'.. grub_er │ │ │ │ -00008aa0: 725f 740a 2020 2020 2070 726f 6265 5f65 r_t. probe_e │ │ │ │ -00008ab0: 7861 6d70 6c65 2028 290a 2020 2020 207b xample (). { │ │ │ │ -00008ac0: 0a20 2020 2020 2020 2f2a 2054 7279 2074 . /* Try t │ │ │ │ -00008ad0: 6f20 7072 6f62 6520 6465 7669 6365 2074 o probe device t │ │ │ │ -00008ae0: 7970 6520 312e 2020 2a2f 0a20 2020 2020 ype 1. */. │ │ │ │ -00008af0: 2020 7072 6f62 655f 666f 725f 6465 7669 probe_for_devi │ │ │ │ -00008b00: 6365 2028 293b 0a20 2020 2020 2020 6966 ce ();. if │ │ │ │ -00008b10: 2028 6772 7562 5f65 7272 6e6f 203d 3d20 (grub_errno == │ │ │ │ -00008b20: 4752 5542 5f45 5252 5f4e 4f4e 4529 0a20 GRUB_ERR_NONE). │ │ │ │ -00008b30: 2020 2020 2020 2020 7b0a 2020 2020 2020 {. │ │ │ │ -00008b40: 2020 2020 202f 2a20 4465 7669 6365 2074 /* Device t │ │ │ │ -00008b50: 7970 6520 3120 7761 7320 666f 756e 6420 ype 1 was found │ │ │ │ -00008b60: 6f6e 2073 7973 7465 6d2e 2020 2a2f 0a20 on system. */. │ │ │ │ -00008b70: 2020 2020 2020 2020 2020 7265 6769 7374 regist │ │ │ │ -00008b80: 6572 5f64 6576 6963 6520 2829 3b0a 2020 er_device ();. │ │ │ │ -00008b90: 2020 2020 2020 2020 2072 6574 7572 6e20 return │ │ │ │ -00008ba0: 4752 5542 5f45 5252 5f4e 4f4e 453b 0a20 GRUB_ERR_NONE;. │ │ │ │ -00008bb0: 2020 2020 2020 2020 7d0a 2020 2020 2020 }. │ │ │ │ -00008bc0: 202f 2a20 5a65 726f 206f 7574 2065 7272 /* Zero out err │ │ │ │ -00008bd0: 6f72 2063 6f64 652e 2020 2a2f 0a20 2020 or code. */. │ │ │ │ -00008be0: 2020 2020 6772 7562 5f65 7272 6e6f 203d grub_errno = │ │ │ │ -00008bf0: 2047 5255 425f 4552 525f 4e4f 4e45 3b0a GRUB_ERR_NONE;. │ │ │ │ -00008c00: 0a20 2020 2020 2020 2f2a 204e 6f20 6465 . /* No de │ │ │ │ -00008c10: 7669 6365 2074 7970 6520 3120 666f 756e vice type 1 foun │ │ │ │ -00008c20: 642c 2074 7279 2074 6f20 7072 6f62 6520 d, try to probe │ │ │ │ -00008c30: 6465 7669 6365 2074 7970 6520 322e 2020 device type 2. │ │ │ │ -00008c40: 2a2f 0a20 2020 2020 2020 7072 6f62 655f */. probe_ │ │ │ │ -00008c50: 666f 725f 6465 7669 6365 3220 2829 3b0a for_device2 ();. │ │ │ │ -00008c60: 2020 2020 2020 2069 6620 2867 7275 625f if (grub_ │ │ │ │ -00008c70: 6572 726e 6f20 3d3d 2047 5255 425f 4552 errno == GRUB_ER │ │ │ │ -00008c80: 525f 4e4f 4e45 290a 2020 2020 2020 2020 R_NONE). │ │ │ │ -00008c90: 207b 0a20 2020 2020 2020 2020 2020 2f2a {. /* │ │ │ │ -00008ca0: 2044 6576 6963 6520 7479 7065 2032 2077 Device type 2 w │ │ │ │ -00008cb0: 6173 2066 6f75 6e64 206f 6e20 7379 7374 as found on syst │ │ │ │ -00008cc0: 656d 2e20 202a 2f0a 2020 2020 2020 2020 em. */. │ │ │ │ -00008cd0: 2020 2072 6567 6973 7465 725f 6465 7669 register_devi │ │ │ │ -00008ce0: 6365 3220 2829 3b0a 2020 2020 2020 2020 ce2 ();. │ │ │ │ -00008cf0: 2020 2072 6574 7572 6e20 4752 5542 5f45 return GRUB_E │ │ │ │ -00008d00: 5252 5f4e 4f4e 453b 0a20 2020 2020 2020 RR_NONE;. │ │ │ │ -00008d10: 2020 7d0a 2020 2020 2020 202f 2a20 5a65 }. /* Ze │ │ │ │ -00008d20: 726f 206f 7574 2065 7272 6f72 2063 6f64 ro out error cod │ │ │ │ -00008d30: 652e 2020 2a2f 0a20 2020 2020 2020 6772 e. */. gr │ │ │ │ -00008d40: 7562 5f65 7272 6e6f 203d 2047 5255 425f ub_errno = GRUB_ │ │ │ │ -00008d50: 4552 525f 4e4f 4e45 3b0a 0a20 2020 2020 ERR_NONE;.. │ │ │ │ -00008d60: 2020 2f2a 2052 6574 7572 6e20 6375 7374 /* Return cust │ │ │ │ -00008d70: 6f6d 2065 7272 6f72 206d 6573 7361 6765 om error message │ │ │ │ -00008d80: 2e20 202a 2f0a 2020 2020 2020 2072 6574 . */. ret │ │ │ │ -00008d90: 7572 6e20 6772 7562 5f65 7272 6f72 2028 urn grub_error ( │ │ │ │ -00008da0: 4752 5542 5f45 5252 5f55 4e4b 4e4f 574e GRUB_ERR_UNKNOWN │ │ │ │ -00008db0: 5f44 4556 4943 452c 2022 4e6f 2064 6576 _DEVICE, "No dev │ │ │ │ -00008dc0: 6963 6520 7479 7065 2031 206f 7220 3220 ice type 1 or 2 │ │ │ │ -00008dd0: 666f 756e 642e 2229 3b0a 2020 2020 207d found.");. } │ │ │ │ -00008de0: 0a0a 2020 2053 6f6d 6520 7469 6d65 7320 .. Some times │ │ │ │ -00008df0: 7468 6572 6520 6973 2061 206e 6565 6420 there is a need │ │ │ │ -00008e00: 746f 2063 6f6e 7469 6e75 6520 7072 6f63 to continue proc │ │ │ │ -00008e10: 6573 7369 6e67 2065 7665 6e20 6966 2074 essing even if t │ │ │ │ -00008e20: 6865 7265 2069 7320 610a 6572 726f 7220 here is a.error │ │ │ │ -00008e30: 7374 6174 6520 696e 2061 7070 6c69 6361 state in applica │ │ │ │ -00008e40: 7469 6f6e 2e20 2049 6e20 7369 7475 6174 tion. In situat │ │ │ │ -00008e50: 696f 6e73 206c 696b 6520 7468 6973 2c20 ions like this, │ │ │ │ -00008e60: 7468 6572 6520 6973 2061 206e 6565 6465 there is a neede │ │ │ │ -00008e70: 640a 746f 2073 6176 6520 6f6c 6420 6572 d.to save old er │ │ │ │ -00008e80: 726f 7220 7374 6174 6520 616e 6420 7468 ror state and th │ │ │ │ -00008e90: 656e 2063 616c 6c20 6f74 6865 7220 6675 en call other fu │ │ │ │ -00008ea0: 6e63 7469 6f6e 7320 7468 6174 206d 6967 nctions that mig │ │ │ │ -00008eb0: 6874 2066 6169 6c2e 0a54 6f20 6169 6420 ht fail..To aid │ │ │ │ -00008ec0: 696e 2074 6869 732c 2074 6865 7265 2069 in this, there i │ │ │ │ -00008ed0: 7320 6120 6572 726f 7220 7374 6163 6b20 s a error stack │ │ │ │ -00008ee0: 696d 706c 656d 656e 7465 642e 2020 4572 implemented. Er │ │ │ │ -00008ef0: 726f 7220 7374 6174 6520 6361 6e20 6265 ror state can be │ │ │ │ -00008f00: 0a70 7573 6865 6420 746f 2065 7272 6f72 .pushed to error │ │ │ │ -00008f10: 2073 7461 636b 2062 7920 6361 6c6c 696e stack by callin │ │ │ │ -00008f20: 6720 6675 6e63 7469 6f6e 2027 6772 7562 g function 'grub │ │ │ │ -00008f30: 5f65 7272 6f72 5f70 7573 6820 2829 272e _error_push ()'. │ │ │ │ -00008f40: 2020 5768 656e 0a70 726f 6365 7373 696e When.processin │ │ │ │ -00008f50: 6720 6861 7320 6265 656e 2063 6f6d 706c g has been compl │ │ │ │ -00008f60: 6574 6564 2c20 2767 7275 625f 6572 726f eted, 'grub_erro │ │ │ │ -00008f70: 725f 706f 7020 2829 2720 6361 6e20 6265 r_pop ()' can be │ │ │ │ -00008f80: 2075 7365 6420 746f 2070 6f70 0a65 7272 used to pop.err │ │ │ │ -00008f90: 6f72 2073 7461 7465 2066 726f 6d20 7374 or state from st │ │ │ │ -00008fa0: 6163 6b2e 2020 4572 726f 7220 7374 6163 ack. Error stac │ │ │ │ -00008fb0: 6b20 636f 6e74 6169 6e73 2070 7265 6465 k contains prede │ │ │ │ -00008fc0: 6669 6e65 6420 616d 6f75 6e74 206f 6620 fined amount of │ │ │ │ -00008fd0: 6572 726f 720a 7374 6163 6b20 6974 656d error.stack item │ │ │ │ -00008fe0: 732e 2020 4572 726f 7220 7374 6163 6b20 s. Error stack │ │ │ │ -00008ff0: 6973 2070 726f 7465 6374 6564 2066 6f72 is protected for │ │ │ │ -00009000: 206f 7665 7266 6c6f 7720 616e 6420 6d61 overflow and ma │ │ │ │ -00009010: 726b 7320 7468 6573 650a 7369 7475 6174 rks these.situat │ │ │ │ -00009020: 696f 6e73 2073 6f20 6f76 6572 666c 6f77 ions so overflow │ │ │ │ -00009030: 2065 7272 6f72 2064 6f65 7320 6e6f 7420 error does not │ │ │ │ -00009040: 6765 7420 756e 7365 656e 2e20 2049 6620 get unseen. If │ │ │ │ -00009050: 7468 6572 6520 6973 206e 6f20 7370 6163 there is no spac │ │ │ │ -00009060: 650a 6176 6169 6c61 626c 6520 746f 2073 e.available to s │ │ │ │ -00009070: 746f 7265 2065 7272 6f72 206d 6573 7361 tore error messa │ │ │ │ -00009080: 6765 2c20 6974 2069 7320 7369 6d70 6c79 ge, it is simply │ │ │ │ -00009090: 2064 6973 6361 7264 6564 2061 6e64 206f discarded and o │ │ │ │ -000090a0: 7665 7266 6c6f 770a 7769 6c6c 2062 6520 verflow.will be │ │ │ │ -000090b0: 6d61 726b 6564 2061 7320 6861 7070 656e marked as happen │ │ │ │ -000090c0: 6564 2e20 2057 6865 6e20 6f76 6572 666c ed. When overfl │ │ │ │ -000090d0: 6f77 2068 6170 7065 6e73 2c20 6974 206d ow happens, it m │ │ │ │ -000090e0: 6f73 7420 6c69 6b65 6c79 2077 696c 6c0a ost likely will. │ │ │ │ -000090f0: 636f 7272 7570 7420 6572 726f 7220 7374 corrupt error st │ │ │ │ -00009100: 6163 6b20 636f 6e73 6973 7465 6e63 7920 ack consistency │ │ │ │ -00009110: 6173 2066 6f72 2070 7573 6865 6420 6572 as for pushed er │ │ │ │ -00009120: 726f 7220 7468 6572 6520 6973 206e 6f20 ror there is no │ │ │ │ -00009130: 6d61 7463 6869 6e67 0a70 6f70 2c20 6275 matching.pop, bu │ │ │ │ -00009140: 7420 6f76 6572 666c 6f77 206d 6573 7361 t overflow messa │ │ │ │ -00009150: 6765 2077 696c 6c20 6265 2073 686f 776e ge will be shown │ │ │ │ -00009160: 2074 6f20 696e 666f 726d 2075 7365 7220 to inform user │ │ │ │ -00009170: 6162 6f75 7420 7468 650a 7369 7475 6174 about the.situat │ │ │ │ -00009180: 696f 6e2e 2020 4f76 6572 666c 6f77 206d ion. Overflow m │ │ │ │ -00009190: 6573 7361 6765 2077 696c 6c20 6265 2073 essage will be s │ │ │ │ -000091a0: 686f 776e 2061 7420 7469 6d65 2077 6865 hown at time whe │ │ │ │ -000091b0: 6e20 7072 6f6d 7074 2069 7320 6162 6f75 n prompt is abou │ │ │ │ -000091c0: 740a 746f 2062 6520 6472 6177 6e2e 0a0a t.to be drawn... │ │ │ │ -000091d0: 2020 2045 7861 6d70 6c65 2075 7361 6765 Example usage │ │ │ │ -000091e0: 206f 6620 6572 726f 7220 7374 6163 6b2e of error stack. │ │ │ │ -000091f0: 0a20 2020 2020 2f2a 2053 6176 6520 706f . /* Save po │ │ │ │ -00009200: 7373 6962 6c65 206f 6c64 2065 7272 6f72 ssible old error │ │ │ │ -00009210: 206d 6573 7361 6765 2e20 202a 2f0a 2020 message. */. │ │ │ │ -00009220: 2020 2067 7275 625f 6572 726f 725f 7075 grub_error_pu │ │ │ │ -00009230: 7368 2028 293b 0a0a 2020 2020 202f 2a20 sh ();.. /* │ │ │ │ -00009240: 446f 2079 6f75 7220 7374 7566 6620 6865 Do your stuff he │ │ │ │ -00009250: 7265 2e20 202a 2f0a 2020 2020 2063 616c re. */. cal │ │ │ │ -00009260: 6c5f 706f 7373 6962 6c79 5f66 6169 6c69 l_possibly_faili │ │ │ │ -00009270: 6e67 5f66 756e 6374 696f 6e20 2829 3b0a ng_function ();. │ │ │ │ -00009280: 0a20 2020 2020 6966 2028 6772 7562 5f65 . if (grub_e │ │ │ │ -00009290: 7272 6e6f 2021 3d20 4752 5542 5f45 5252 rrno != GRUB_ERR │ │ │ │ -000092a0: 5f4e 4f4e 4529 0a20 2020 2020 2020 7b0a _NONE). {. │ │ │ │ -000092b0: 2020 2020 2020 2020 202f 2a20 496e 666f /* Info │ │ │ │ -000092c0: 726d 2072 6573 7420 6f66 2074 6865 2063 rm rest of the c │ │ │ │ -000092d0: 6f64 6520 7468 6174 2074 6865 7265 2069 ode that there i │ │ │ │ -000092e0: 7320 6572 726f 7220 2867 7275 625f 6572 s error (grub_er │ │ │ │ -000092f0: 726e 6f0a 2020 2020 2020 2020 2020 2020 rno. │ │ │ │ -00009300: 6973 2073 6574 292e 2054 6865 7265 2069 is set). There i │ │ │ │ -00009310: 7320 6e6f 2070 6f70 2068 6572 6520 6173 s no pop here as │ │ │ │ -00009320: 2077 6520 7761 6e74 2062 6f74 6820 6572 we want both er │ │ │ │ -00009330: 726f 7220 7374 6174 6573 0a20 2020 2020 ror states. │ │ │ │ -00009340: 2020 2020 2020 2074 6f20 6265 2064 6973 to be dis │ │ │ │ -00009350: 706c 6179 6564 2e20 202a 2f0a 2020 2020 played. */. │ │ │ │ -00009360: 2020 2020 2072 6574 7572 6e3b 0a20 2020 return;. │ │ │ │ -00009370: 2020 2020 7d0a 0a20 2020 2020 2f2a 2052 }.. /* R │ │ │ │ -00009380: 6573 746f 7265 206f 6c64 2065 7272 6f72 estore old error │ │ │ │ -00009390: 2073 7461 7465 2062 7920 706f 7070 696e state by poppin │ │ │ │ -000093a0: 6720 7072 6576 696f 7573 2069 7465 6d20 g previous item │ │ │ │ -000093b0: 6672 6f6d 2073 7461 636b 2e20 2a2f 0a20 from stack. */. │ │ │ │ -000093c0: 2020 2020 6772 7562 5f65 7272 6f72 5f70 grub_error_p │ │ │ │ -000093d0: 6f70 2028 293b 0a0a 1f0a 4669 6c65 3a20 op ();....File: │ │ │ │ -000093e0: 6772 7562 2d64 6576 2e69 6e66 6f2c 2020 grub-dev.info, │ │ │ │ -000093f0: 4e6f 6465 3a20 5374 6163 6b20 616e 6420 Node: Stack and │ │ │ │ -00009400: 6865 6170 2073 697a 652c 2020 4e65 7874 heap size, Next │ │ │ │ -00009410: 3a20 4249 4f53 2070 6f72 7420 6d65 6d6f : BIOS port memo │ │ │ │ -00009420: 7279 206d 6170 2c20 2050 7265 763a 2045 ry map, Prev: E │ │ │ │ -00009430: 7272 6f72 2048 616e 646c 696e 672c 2020 rror Handling, │ │ │ │ -00009440: 5570 3a20 546f 700a 0a38 2053 7461 636b Up: Top..8 Stack │ │ │ │ -00009450: 2061 6e64 2068 6561 7020 7369 7a65 0a2a and heap size.* │ │ │ │ -00009460: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ -00009470: 2a2a 2a2a 0a0a 4f6e 2065 6d75 2073 7461 ****..On emu sta │ │ │ │ -00009480: 636b 2061 6e64 2068 6561 7020 6172 6520 ck and heap are │ │ │ │ -00009490: 6a75 7374 206e 6f72 6d61 6c20 686f 7374 just normal host │ │ │ │ -000094a0: 204f 5320 7374 6163 6b20 616e 6420 6865 OS stack and he │ │ │ │ -000094b0: 6170 2e20 2053 7461 636b 2069 730a 7479 ap. Stack is.ty │ │ │ │ -000094c0: 7069 6361 6c6c 7920 3820 4d69 4220 616c pically 8 MiB al │ │ │ │ -000094d0: 7468 6f75 6768 2069 7427 7320 4f53 2d64 though it's OS-d │ │ │ │ -000094e0: 6570 656e 6465 6e74 2e0a 0a20 2020 4f6e ependent... On │ │ │ │ -000094f0: 2069 3338 362d 7063 2c20 6933 3836 2d63 i386-pc, i386-c │ │ │ │ -00009500: 6f72 6562 6f6f 742c 2069 3338 362d 7165 oreboot, i386-qe │ │ │ │ -00009510: 6d75 2061 6e64 2069 3338 362d 6d75 6c74 mu and i386-mult │ │ │ │ -00009520: 6962 6f6f 7420 7468 6520 7374 6163 6b20 iboot the stack │ │ │ │ -00009530: 6973 0a36 304b 6942 2e20 416c 6c20 6176 is.60KiB. All av │ │ │ │ -00009540: 6169 6c61 626c 6520 7370 6163 6520 6265 ailable space be │ │ │ │ -00009550: 7477 6565 6e20 314d 6942 2061 6e64 2034 tween 1MiB and 4 │ │ │ │ -00009560: 4769 4220 6d61 726b 7320 6973 2070 6172 GiB marks is par │ │ │ │ -00009570: 7420 6f66 2068 6561 702e 0a0a 2020 204f t of heap... O │ │ │ │ -00009580: 6e20 2a2d 7865 6e20 7374 6163 6b20 6973 n *-xen stack is │ │ │ │ -00009590: 2034 4d69 422e 2049 6620 636f 6d70 696c 4MiB. If compil │ │ │ │ -000095a0: 6564 2066 6f72 2078 3836 2d36 3420 7769 ed for x86-64 wi │ │ │ │ -000095b0: 7468 2047 4343 2034 2e34 206f 7220 6c61 th GCC 4.4 or la │ │ │ │ -000095c0: 7465 720a 6164 7265 7373 6162 6c65 2073 ter.adressable s │ │ │ │ -000095d0: 7061 6365 2069 7320 756e 6c69 6d69 7465 pace is unlimite │ │ │ │ -000095e0: 642e 2020 5768 656e 2063 6f6d 7069 6c65 d. When compile │ │ │ │ -000095f0: 6420 666f 7220 7838 362d 3634 2077 6974 d for x86-64 wit │ │ │ │ -00009600: 6820 6f6c 6465 7220 4743 430a 7665 7273 h older GCC.vers │ │ │ │ -00009610: 696f 6e20 6164 7265 7373 6162 6c65 2073 ion adressable s │ │ │ │ -00009620: 7061 6365 2069 7320 6c69 6d69 7465 6420 pace is limited │ │ │ │ -00009630: 746f 2032 4769 422e 2057 6865 6e20 636f to 2GiB. When co │ │ │ │ -00009640: 6d70 696c 696e 6720 666f 7220 6933 3836 mpiling for i386 │ │ │ │ -00009650: 0a61 6472 6573 7361 626c 6520 7370 6163 .adressable spac │ │ │ │ -00009660: 6520 6973 206c 696d 6974 6564 2074 6f20 e is limited to │ │ │ │ -00009670: 3447 6942 2e20 416c 6c20 6164 7265 7373 4GiB. All adress │ │ │ │ -00009680: 6162 6c65 2070 6167 6573 2065 7863 6570 able pages excep │ │ │ │ -00009690: 7420 7468 650a 6f6e 6573 2066 6f72 2073 t the.ones for s │ │ │ │ -000096a0: 7461 636b 2c20 4752 5542 2062 696e 6172 tack, GRUB binar │ │ │ │ -000096b0: 792c 2073 7065 6369 616c 2070 6167 6573 y, special pages │ │ │ │ -000096c0: 2061 6e64 2070 6167 6520 7461 626c 6520 and page table │ │ │ │ -000096d0: 6172 6520 696e 2074 6865 0a68 6561 702e are in the.heap. │ │ │ │ -000096e0: 0a0a 2020 204f 6e20 2a2d 6566 6920 4752 .. On *-efi GR │ │ │ │ -000096f0: 5542 2075 7365 7320 7361 6d65 2073 7461 UB uses same sta │ │ │ │ -00009700: 636b 2061 7320 4546 492e 2049 6620 636f ck as EFI. If co │ │ │ │ -00009710: 6d70 696c 6564 2066 6f72 2078 3836 2d36 mpiled for x86-6 │ │ │ │ -00009720: 3420 7769 7468 2047 4343 0a34 2e34 206f 4 with GCC.4.4 o │ │ │ │ -00009730: 7220 6c61 7465 7220 6164 7265 7373 6162 r later adressab │ │ │ │ -00009740: 6c65 2073 7061 6365 2069 7320 756e 6c69 le space is unli │ │ │ │ -00009750: 6d69 7465 642e 2020 5768 656e 2063 6f6d mited. When com │ │ │ │ -00009760: 7069 6c65 6420 666f 7220 7838 362d 3634 piled for x86-64 │ │ │ │ -00009770: 0a77 6974 6820 6f6c 6465 7220 4743 4320 .with older GCC │ │ │ │ -00009780: 7665 7273 696f 6e20 6164 7265 7373 6162 version adressab │ │ │ │ -00009790: 6c65 2073 7061 6365 2069 7320 6c69 6d69 le space is limi │ │ │ │ -000097a0: 7465 6420 746f 2032 4769 422e 2046 6f72 ted to 2GiB. For │ │ │ │ -000097b0: 2061 6c6c 0a6f 7468 6572 2070 6c61 7466 all.other platf │ │ │ │ -000097c0: 6f72 6d73 2061 6472 6573 7361 626c 6520 orms adressable │ │ │ │ -000097d0: 7370 6163 6520 6973 206c 696d 6974 6564 space is limited │ │ │ │ -000097e0: 2074 6f20 3447 6942 2e20 4752 5542 2061 to 4GiB. GRUB a │ │ │ │ -000097f0: 6c6c 6f63 6174 6573 0a70 6167 6573 2066 llocates.pages f │ │ │ │ -00009800: 726f 6d20 4546 4920 666f 7220 6974 7320 rom EFI for its │ │ │ │ -00009810: 6865 6170 2c20 6174 206d 6f73 7420 312e heap, at most 1. │ │ │ │ -00009820: 3620 4769 422e 0a0a 2020 204f 6e20 6933 6 GiB... On i3 │ │ │ │ -00009830: 3836 2d69 6565 6531 3237 3520 616e 6420 86-ieee1275 and │ │ │ │ -00009840: 706f 7765 7270 632d 6965 6565 3132 3735 powerpc-ieee1275 │ │ │ │ -00009850: 2047 5255 4220 7573 6573 2073 616d 6520 GRUB uses same │ │ │ │ -00009860: 7374 6163 6b20 6173 0a49 4545 4531 3237 stack as.IEEE127 │ │ │ │ -00009870: 352e 2020 4974 2061 6c6c 6f63 6174 6573 5. It allocates │ │ │ │ -00009880: 2061 7420 6d6f 7374 2033 324d 6942 2066 at most 32MiB f │ │ │ │ -00009890: 6f72 2069 7473 2068 6561 702e 0a0a 2020 or its heap... │ │ │ │ -000098a0: 204f 6e20 7370 6172 6336 342d 6965 6565 On sparc64-ieee │ │ │ │ -000098b0: 3132 3735 2073 7461 636b 2069 7320 3235 1275 stack is 25 │ │ │ │ -000098c0: 364b 6942 2061 6e64 2068 6561 7020 6973 6KiB and heap is │ │ │ │ -000098d0: 2032 4d69 422e 0a0a 2020 204f 6e20 6d69 2MiB... On mi │ │ │ │ -000098e0: 7073 2865 6c29 2d71 656d 755f 6d69 7073 ps(el)-qemu_mips │ │ │ │ -000098f0: 2061 6e64 206d 6970 7365 6c2d 6c6f 6f6e and mipsel-loon │ │ │ │ -00009900: 6773 6f6e 2073 7461 636b 2069 7320 324d gson stack is 2M │ │ │ │ -00009910: 6942 2028 6576 6572 7974 6869 6e67 0a62 iB (everything.b │ │ │ │ -00009920: 656c 6f77 2047 5255 4220 696d 6167 6529 elow GRUB image) │ │ │ │ -00009930: 2061 6e64 2065 7665 7279 7468 696e 6720 and everything │ │ │ │ -00009940: 6162 6f76 6520 4752 5542 2069 6d61 6765 above GRUB image │ │ │ │ -00009950: 2028 6672 6f6d 2032 4d69 4220 2b20 6b65 (from 2MiB + ke │ │ │ │ -00009960: 726e 656c 0a73 697a 6529 2075 6e74 696c rnel.size) until │ │ │ │ -00009970: 2032 3536 4d69 4220 6973 2070 6172 7420 256MiB is part │ │ │ │ -00009980: 6f66 2068 6561 702e 0a0a 2020 204f 6e20 of heap... On │ │ │ │ -00009990: 6d69 7073 2d61 7263 2073 7461 636b 2069 mips-arc stack i │ │ │ │ -000099a0: 7320 324d 6942 2028 6576 6572 7974 6869 s 2MiB (everythi │ │ │ │ -000099b0: 6e67 2062 656c 6f77 2047 5255 4220 696d ng below GRUB im │ │ │ │ -000099c0: 6167 6529 2061 6e64 0a65 7665 7279 7468 age) and.everyth │ │ │ │ -000099d0: 696e 6720 6162 6f76 6520 4752 5542 2069 ing above GRUB i │ │ │ │ -000099e0: 6d61 6765 2866 726f 6d20 324d 6942 202b mage(from 2MiB + │ │ │ │ -000099f0: 206b 6572 6e65 6c20 7369 7a65 2920 756e kernel size) un │ │ │ │ -00009a00: 7469 6c20 3132 384d 6942 2069 730a 7061 til 128MiB is.pa │ │ │ │ -00009a10: 7274 206f 6620 6865 6170 2e0a 0a20 2020 rt of heap... │ │ │ │ -00009a20: 4f6e 206d 6970 7365 6c2d 6172 6320 7374 On mipsel-arc st │ │ │ │ -00009a30: 6163 6b20 6973 2032 4d69 4220 2865 7665 ack is 2MiB (eve │ │ │ │ -00009a40: 7279 7468 696e 6720 6265 6c6f 7720 4752 rything below GR │ │ │ │ -00009a50: 5542 2069 6d61 6765 2077 6869 6368 2069 UB image which i │ │ │ │ -00009a60: 7320 6e6f 740a 7061 7274 206f 6620 4152 s not.part of AR │ │ │ │ -00009a70: 4329 2061 6e64 2065 7665 7279 7468 696e C) and everythin │ │ │ │ -00009a80: 6720 6162 6f76 6520 4752 5542 2069 6d61 g above GRUB ima │ │ │ │ -00009a90: 6765 2028 6672 6f6d 2037 4d69 4220 2b20 ge (from 7MiB + │ │ │ │ -00009aa0: 6b65 726e 656c 2073 697a 6529 0a75 6e74 kernel size).unt │ │ │ │ -00009ab0: 696c 2032 3536 4d69 4220 6973 2070 6172 il 256MiB is par │ │ │ │ -00009ac0: 7420 6f66 2068 6561 702e 0a0a 2020 204f t of heap... O │ │ │ │ -00009ad0: 6e20 6172 6d2d 7562 6f6f 7420 7374 6163 n arm-uboot stac │ │ │ │ -00009ae0: 6b20 6973 2032 3536 4b69 4220 616e 6420 k is 256KiB and │ │ │ │ -00009af0: 6865 6170 2069 7320 324d 6942 2e0a 0a20 heap is 2MiB... │ │ │ │ -00009b00: 2020 496e 2073 686f 7274 3a0a 0a50 6c61 In short:..Pla │ │ │ │ -00009b10: 7466 6f72 6d20 2020 2053 7461 636b 2020 tform Stack │ │ │ │ -00009b20: 2020 2020 2020 2020 2020 2020 4865 6170 Heap │ │ │ │ -00009b30: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d .--------------- │ │ │ │ +00008950: 2020 2020 2031 3029 3b0a 2020 2020 207d 10);. } │ │ │ │ +00008960: 0a0a 2020 2049 6620 7468 6572 6520 6973 .. If there is │ │ │ │ +00008970: 2061 2073 7065 6369 616c 2072 6561 736f a special reaso │ │ │ │ +00008980: 6e20 7468 6174 2065 7272 6f72 2063 6f64 n that error cod │ │ │ │ +00008990: 6520 646f 6573 206e 6f74 206e 6565 6420 e does not need │ │ │ │ +000089a0: 746f 2062 650a 7461 6b65 6e20 6163 636f to be.taken acco │ │ │ │ +000089b0: 756e 742c 2027 6772 7562 5f65 7272 6e6f unt, 'grub_errno │ │ │ │ +000089c0: 2720 6361 6e20 6265 207a 6572 6f65 6420 ' can be zeroed │ │ │ │ +000089d0: 6261 636b 2074 6f20 2747 5255 425f 4552 back to 'GRUB_ER │ │ │ │ +000089e0: 525f 4e4f 4e45 272e 2020 496e 0a63 6173 R_NONE'. In.cas │ │ │ │ +000089f0: 6573 206c 696b 6520 7468 6973 2061 6c6c es like this all │ │ │ │ +00008a00: 2070 7265 7669 6f75 7320 6572 726f 7220 previous error │ │ │ │ +00008a10: 636f 6465 7320 7368 6f75 6c64 2068 6176 codes should hav │ │ │ │ +00008a20: 6520 6265 656e 2068 616e 646c 6564 0a63 e been handled.c │ │ │ │ +00008a30: 6f72 7265 6374 6c79 2e20 2054 6869 7320 orrectly. This │ │ │ │ +00008a40: 6d61 6b65 7320 7375 7265 2074 6861 7420 makes sure that │ │ │ │ +00008a50: 7468 6572 6520 6172 6520 6e6f 2075 6e68 there are no unh │ │ │ │ +00008a60: 616e 646c 6564 2065 7863 6570 7469 6f6e andled exception │ │ │ │ +00008a70: 732e 0a0a 2020 2045 7861 6d70 6c65 206f s... Example o │ │ │ │ +00008a80: 6620 7a65 726f 696e 6720 2767 7275 625f f zeroing 'grub_ │ │ │ │ +00008a90: 6572 726e 6f27 2e0a 2020 2020 2067 7275 errno'.. gru │ │ │ │ +00008aa0: 625f 6572 725f 740a 2020 2020 2070 726f b_err_t. pro │ │ │ │ +00008ab0: 6265 5f65 7861 6d70 6c65 2028 290a 2020 be_example (). │ │ │ │ +00008ac0: 2020 207b 0a20 2020 2020 2020 2f2a 2054 {. /* T │ │ │ │ +00008ad0: 7279 2074 6f20 7072 6f62 6520 6465 7669 ry to probe devi │ │ │ │ +00008ae0: 6365 2074 7970 6520 312e 2020 2a2f 0a20 ce type 1. */. │ │ │ │ +00008af0: 2020 2020 2020 7072 6f62 655f 666f 725f probe_for_ │ │ │ │ +00008b00: 6465 7669 6365 2028 293b 0a20 2020 2020 device ();. │ │ │ │ +00008b10: 2020 6966 2028 6772 7562 5f65 7272 6e6f if (grub_errno │ │ │ │ +00008b20: 203d 3d20 4752 5542 5f45 5252 5f4e 4f4e == GRUB_ERR_NON │ │ │ │ +00008b30: 4529 0a20 2020 2020 2020 2020 7b0a 2020 E). {. │ │ │ │ +00008b40: 2020 2020 2020 2020 202f 2a20 4465 7669 /* Devi │ │ │ │ +00008b50: 6365 2074 7970 6520 3120 7761 7320 666f ce type 1 was fo │ │ │ │ +00008b60: 756e 6420 6f6e 2073 7973 7465 6d2e 2020 und on system. │ │ │ │ +00008b70: 2a2f 0a20 2020 2020 2020 2020 2020 7265 */. re │ │ │ │ +00008b80: 6769 7374 6572 5f64 6576 6963 6520 2829 gister_device () │ │ │ │ +00008b90: 3b0a 2020 2020 2020 2020 2020 2072 6574 ;. ret │ │ │ │ +00008ba0: 7572 6e20 4752 5542 5f45 5252 5f4e 4f4e urn GRUB_ERR_NON │ │ │ │ +00008bb0: 453b 0a20 2020 2020 2020 2020 7d0a 2020 E;. }. │ │ │ │ +00008bc0: 2020 2020 202f 2a20 5a65 726f 206f 7574 /* Zero out │ │ │ │ +00008bd0: 2065 7272 6f72 2063 6f64 652e 2020 2a2f error code. */ │ │ │ │ +00008be0: 0a20 2020 2020 2020 6772 7562 5f65 7272 . grub_err │ │ │ │ +00008bf0: 6e6f 203d 2047 5255 425f 4552 525f 4e4f no = GRUB_ERR_NO │ │ │ │ +00008c00: 4e45 3b0a 0a20 2020 2020 2020 2f2a 204e NE;.. /* N │ │ │ │ +00008c10: 6f20 6465 7669 6365 2074 7970 6520 3120 o device type 1 │ │ │ │ +00008c20: 666f 756e 642c 2074 7279 2074 6f20 7072 found, try to pr │ │ │ │ +00008c30: 6f62 6520 6465 7669 6365 2074 7970 6520 obe device type │ │ │ │ +00008c40: 322e 2020 2a2f 0a20 2020 2020 2020 7072 2. */. pr │ │ │ │ +00008c50: 6f62 655f 666f 725f 6465 7669 6365 3220 obe_for_device2 │ │ │ │ +00008c60: 2829 3b0a 2020 2020 2020 2069 6620 2867 ();. if (g │ │ │ │ +00008c70: 7275 625f 6572 726e 6f20 3d3d 2047 5255 rub_errno == GRU │ │ │ │ +00008c80: 425f 4552 525f 4e4f 4e45 290a 2020 2020 B_ERR_NONE). │ │ │ │ +00008c90: 2020 2020 207b 0a20 2020 2020 2020 2020 {. │ │ │ │ +00008ca0: 2020 2f2a 2044 6576 6963 6520 7479 7065 /* Device type │ │ │ │ +00008cb0: 2032 2077 6173 2066 6f75 6e64 206f 6e20 2 was found on │ │ │ │ +00008cc0: 7379 7374 656d 2e20 202a 2f0a 2020 2020 system. */. │ │ │ │ +00008cd0: 2020 2020 2020 2072 6567 6973 7465 725f register_ │ │ │ │ +00008ce0: 6465 7669 6365 3220 2829 3b0a 2020 2020 device2 ();. │ │ │ │ +00008cf0: 2020 2020 2020 2072 6574 7572 6e20 4752 return GR │ │ │ │ +00008d00: 5542 5f45 5252 5f4e 4f4e 453b 0a20 2020 UB_ERR_NONE;. │ │ │ │ +00008d10: 2020 2020 2020 7d0a 2020 2020 2020 202f }. / │ │ │ │ +00008d20: 2a20 5a65 726f 206f 7574 2065 7272 6f72 * Zero out error │ │ │ │ +00008d30: 2063 6f64 652e 2020 2a2f 0a20 2020 2020 code. */. │ │ │ │ +00008d40: 2020 6772 7562 5f65 7272 6e6f 203d 2047 grub_errno = G │ │ │ │ +00008d50: 5255 425f 4552 525f 4e4f 4e45 3b0a 0a20 RUB_ERR_NONE;.. │ │ │ │ +00008d60: 2020 2020 2020 2f2a 2052 6574 7572 6e20 /* Return │ │ │ │ +00008d70: 6375 7374 6f6d 2065 7272 6f72 206d 6573 custom error mes │ │ │ │ +00008d80: 7361 6765 2e20 202a 2f0a 2020 2020 2020 sage. */. │ │ │ │ +00008d90: 2072 6574 7572 6e20 6772 7562 5f65 7272 return grub_err │ │ │ │ +00008da0: 6f72 2028 4752 5542 5f45 5252 5f55 4e4b or (GRUB_ERR_UNK │ │ │ │ +00008db0: 4e4f 574e 5f44 4556 4943 452c 2022 4e6f NOWN_DEVICE, "No │ │ │ │ +00008dc0: 2064 6576 6963 6520 7479 7065 2031 206f device type 1 o │ │ │ │ +00008dd0: 7220 3220 666f 756e 642e 2229 3b0a 2020 r 2 found.");. │ │ │ │ +00008de0: 2020 207d 0a0a 2020 2053 6f6d 6520 7469 }.. Some ti │ │ │ │ +00008df0: 6d65 7320 7468 6572 6520 6973 2061 206e mes there is a n │ │ │ │ +00008e00: 6565 6420 746f 2063 6f6e 7469 6e75 6520 eed to continue │ │ │ │ +00008e10: 7072 6f63 6573 7369 6e67 2065 7665 6e20 processing even │ │ │ │ +00008e20: 6966 2074 6865 7265 2069 7320 610a 6572 if there is a.er │ │ │ │ +00008e30: 726f 7220 7374 6174 6520 696e 2061 7070 ror state in app │ │ │ │ +00008e40: 6c69 6361 7469 6f6e 2e20 2049 6e20 7369 lication. In si │ │ │ │ +00008e50: 7475 6174 696f 6e73 206c 696b 6520 7468 tuations like th │ │ │ │ +00008e60: 6973 2c20 7468 6572 6520 6973 2061 206e is, there is a n │ │ │ │ +00008e70: 6565 6465 640a 746f 2073 6176 6520 6f6c eeded.to save ol │ │ │ │ +00008e80: 6420 6572 726f 7220 7374 6174 6520 616e d error state an │ │ │ │ +00008e90: 6420 7468 656e 2063 616c 6c20 6f74 6865 d then call othe │ │ │ │ +00008ea0: 7220 6675 6e63 7469 6f6e 7320 7468 6174 r functions that │ │ │ │ +00008eb0: 206d 6967 6874 2066 6169 6c2e 0a54 6f20 might fail..To │ │ │ │ +00008ec0: 6169 6420 696e 2074 6869 732c 2074 6865 aid in this, the │ │ │ │ +00008ed0: 7265 2069 7320 6120 6572 726f 7220 7374 re is a error st │ │ │ │ +00008ee0: 6163 6b20 696d 706c 656d 656e 7465 642e ack implemented. │ │ │ │ +00008ef0: 2020 4572 726f 7220 7374 6174 6520 6361 Error state ca │ │ │ │ +00008f00: 6e20 6265 0a70 7573 6865 6420 746f 2065 n be.pushed to e │ │ │ │ +00008f10: 7272 6f72 2073 7461 636b 2062 7920 6361 rror stack by ca │ │ │ │ +00008f20: 6c6c 696e 6720 6675 6e63 7469 6f6e 2027 lling function ' │ │ │ │ +00008f30: 6772 7562 5f65 7272 6f72 5f70 7573 6820 grub_error_push │ │ │ │ +00008f40: 2829 272e 2020 5768 656e 0a70 726f 6365 ()'. When.proce │ │ │ │ +00008f50: 7373 696e 6720 6861 7320 6265 656e 2063 ssing has been c │ │ │ │ +00008f60: 6f6d 706c 6574 6564 2c20 2767 7275 625f ompleted, 'grub_ │ │ │ │ +00008f70: 6572 726f 725f 706f 7020 2829 2720 6361 error_pop ()' ca │ │ │ │ +00008f80: 6e20 6265 2075 7365 6420 746f 2070 6f70 n be used to pop │ │ │ │ +00008f90: 0a65 7272 6f72 2073 7461 7465 2066 726f .error state fro │ │ │ │ +00008fa0: 6d20 7374 6163 6b2e 2020 4572 726f 7220 m stack. Error │ │ │ │ +00008fb0: 7374 6163 6b20 636f 6e74 6169 6e73 2070 stack contains p │ │ │ │ +00008fc0: 7265 6465 6669 6e65 6420 616d 6f75 6e74 redefined amount │ │ │ │ +00008fd0: 206f 6620 6572 726f 720a 7374 6163 6b20 of error.stack │ │ │ │ +00008fe0: 6974 656d 732e 2020 4572 726f 7220 7374 items. Error st │ │ │ │ +00008ff0: 6163 6b20 6973 2070 726f 7465 6374 6564 ack is protected │ │ │ │ +00009000: 2066 6f72 206f 7665 7266 6c6f 7720 616e for overflow an │ │ │ │ +00009010: 6420 6d61 726b 7320 7468 6573 650a 7369 d marks these.si │ │ │ │ +00009020: 7475 6174 696f 6e73 2073 6f20 6f76 6572 tuations so over │ │ │ │ +00009030: 666c 6f77 2065 7272 6f72 2064 6f65 7320 flow error does │ │ │ │ +00009040: 6e6f 7420 6765 7420 756e 7365 656e 2e20 not get unseen. │ │ │ │ +00009050: 2049 6620 7468 6572 6520 6973 206e 6f20 If there is no │ │ │ │ +00009060: 7370 6163 650a 6176 6169 6c61 626c 6520 space.available │ │ │ │ +00009070: 746f 2073 746f 7265 2065 7272 6f72 206d to store error m │ │ │ │ +00009080: 6573 7361 6765 2c20 6974 2069 7320 7369 essage, it is si │ │ │ │ +00009090: 6d70 6c79 2064 6973 6361 7264 6564 2061 mply discarded a │ │ │ │ +000090a0: 6e64 206f 7665 7266 6c6f 770a 7769 6c6c nd overflow.will │ │ │ │ +000090b0: 2062 6520 6d61 726b 6564 2061 7320 6861 be marked as ha │ │ │ │ +000090c0: 7070 656e 6564 2e20 2057 6865 6e20 6f76 ppened. When ov │ │ │ │ +000090d0: 6572 666c 6f77 2068 6170 7065 6e73 2c20 erflow happens, │ │ │ │ +000090e0: 6974 206d 6f73 7420 6c69 6b65 6c79 2077 it most likely w │ │ │ │ +000090f0: 696c 6c0a 636f 7272 7570 7420 6572 726f ill.corrupt erro │ │ │ │ +00009100: 7220 7374 6163 6b20 636f 6e73 6973 7465 r stack consiste │ │ │ │ +00009110: 6e63 7920 6173 2066 6f72 2070 7573 6865 ncy as for pushe │ │ │ │ +00009120: 6420 6572 726f 7220 7468 6572 6520 6973 d error there is │ │ │ │ +00009130: 206e 6f20 6d61 7463 6869 6e67 0a70 6f70 no matching.pop │ │ │ │ +00009140: 2c20 6275 7420 6f76 6572 666c 6f77 206d , but overflow m │ │ │ │ +00009150: 6573 7361 6765 2077 696c 6c20 6265 2073 essage will be s │ │ │ │ +00009160: 686f 776e 2074 6f20 696e 666f 726d 2075 hown to inform u │ │ │ │ +00009170: 7365 7220 6162 6f75 7420 7468 650a 7369 ser about the.si │ │ │ │ +00009180: 7475 6174 696f 6e2e 2020 4f76 6572 666c tuation. Overfl │ │ │ │ +00009190: 6f77 206d 6573 7361 6765 2077 696c 6c20 ow message will │ │ │ │ +000091a0: 6265 2073 686f 776e 2061 7420 7469 6d65 be shown at time │ │ │ │ +000091b0: 2077 6865 6e20 7072 6f6d 7074 2069 7320 when prompt is │ │ │ │ +000091c0: 6162 6f75 740a 746f 2062 6520 6472 6177 about.to be draw │ │ │ │ +000091d0: 6e2e 0a0a 2020 2045 7861 6d70 6c65 2075 n... Example u │ │ │ │ +000091e0: 7361 6765 206f 6620 6572 726f 7220 7374 sage of error st │ │ │ │ +000091f0: 6163 6b2e 0a20 2020 2020 2f2a 2053 6176 ack.. /* Sav │ │ │ │ +00009200: 6520 706f 7373 6962 6c65 206f 6c64 2065 e possible old e │ │ │ │ +00009210: 7272 6f72 206d 6573 7361 6765 2e20 202a rror message. * │ │ │ │ +00009220: 2f0a 2020 2020 2067 7275 625f 6572 726f /. grub_erro │ │ │ │ +00009230: 725f 7075 7368 2028 293b 0a0a 2020 2020 r_push ();.. │ │ │ │ +00009240: 202f 2a20 446f 2079 6f75 7220 7374 7566 /* Do your stuf │ │ │ │ +00009250: 6620 6865 7265 2e20 202a 2f0a 2020 2020 f here. */. │ │ │ │ +00009260: 2063 616c 6c5f 706f 7373 6962 6c79 5f66 call_possibly_f │ │ │ │ +00009270: 6169 6c69 6e67 5f66 756e 6374 696f 6e20 ailing_function │ │ │ │ +00009280: 2829 3b0a 0a20 2020 2020 6966 2028 6772 ();.. if (gr │ │ │ │ +00009290: 7562 5f65 7272 6e6f 2021 3d20 4752 5542 ub_errno != GRUB │ │ │ │ +000092a0: 5f45 5252 5f4e 4f4e 4529 0a20 2020 2020 _ERR_NONE). │ │ │ │ +000092b0: 2020 7b0a 2020 2020 2020 2020 202f 2a20 {. /* │ │ │ │ +000092c0: 496e 666f 726d 2072 6573 7420 6f66 2074 Inform rest of t │ │ │ │ +000092d0: 6865 2063 6f64 6520 7468 6174 2074 6865 he code that the │ │ │ │ +000092e0: 7265 2069 7320 6572 726f 7220 2867 7275 re is error (gru │ │ │ │ +000092f0: 625f 6572 726e 6f0a 2020 2020 2020 2020 b_errno. │ │ │ │ +00009300: 2020 2020 6973 2073 6574 292e 2054 6865 is set). The │ │ │ │ +00009310: 7265 2069 7320 6e6f 2070 6f70 2068 6572 re is no pop her │ │ │ │ +00009320: 6520 6173 2077 6520 7761 6e74 2062 6f74 e as we want bot │ │ │ │ +00009330: 6820 6572 726f 7220 7374 6174 6573 0a20 h error states. │ │ │ │ +00009340: 2020 2020 2020 2020 2020 2074 6f20 6265 to be │ │ │ │ +00009350: 2064 6973 706c 6179 6564 2e20 202a 2f0a displayed. */. │ │ │ │ +00009360: 2020 2020 2020 2020 2072 6574 7572 6e3b return; │ │ │ │ +00009370: 0a20 2020 2020 2020 7d0a 0a20 2020 2020 . }.. │ │ │ │ +00009380: 2f2a 2052 6573 746f 7265 206f 6c64 2065 /* Restore old e │ │ │ │ +00009390: 7272 6f72 2073 7461 7465 2062 7920 706f rror state by po │ │ │ │ +000093a0: 7070 696e 6720 7072 6576 696f 7573 2069 pping previous i │ │ │ │ +000093b0: 7465 6d20 6672 6f6d 2073 7461 636b 2e20 tem from stack. │ │ │ │ +000093c0: 2a2f 0a20 2020 2020 6772 7562 5f65 7272 */. grub_err │ │ │ │ +000093d0: 6f72 5f70 6f70 2028 293b 0a0a 1f0a 4669 or_pop ();....Fi │ │ │ │ +000093e0: 6c65 3a20 6772 7562 2d64 6576 2e69 6e66 le: grub-dev.inf │ │ │ │ +000093f0: 6f2c 2020 4e6f 6465 3a20 5374 6163 6b20 o, Node: Stack │ │ │ │ +00009400: 616e 6420 6865 6170 2073 697a 652c 2020 and heap size, │ │ │ │ +00009410: 4e65 7874 3a20 4249 4f53 2070 6f72 7420 Next: BIOS port │ │ │ │ +00009420: 6d65 6d6f 7279 206d 6170 2c20 2050 7265 memory map, Pre │ │ │ │ +00009430: 763a 2045 7272 6f72 2048 616e 646c 696e v: Error Handlin │ │ │ │ +00009440: 672c 2020 5570 3a20 546f 700a 0a38 2053 g, Up: Top..8 S │ │ │ │ +00009450: 7461 636b 2061 6e64 2068 6561 7020 7369 tack and heap si │ │ │ │ +00009460: 7a65 0a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a ze.************* │ │ │ │ +00009470: 2a2a 2a2a 2a2a 2a2a 0a0a 4f6e 2065 6d75 ********..On emu │ │ │ │ +00009480: 2073 7461 636b 2061 6e64 2068 6561 7020 stack and heap │ │ │ │ +00009490: 6172 6520 6a75 7374 206e 6f72 6d61 6c20 are just normal │ │ │ │ +000094a0: 686f 7374 204f 5320 7374 6163 6b20 616e host OS stack an │ │ │ │ +000094b0: 6420 6865 6170 2e20 2053 7461 636b 2069 d heap. Stack i │ │ │ │ +000094c0: 730a 7479 7069 6361 6c6c 7920 3820 4d69 s.typically 8 Mi │ │ │ │ +000094d0: 4220 616c 7468 6f75 6768 2069 7427 7320 B although it's │ │ │ │ +000094e0: 4f53 2d64 6570 656e 6465 6e74 2e0a 0a20 OS-dependent... │ │ │ │ +000094f0: 2020 4f6e 2069 3338 362d 7063 2c20 6933 On i386-pc, i3 │ │ │ │ +00009500: 3836 2d63 6f72 6562 6f6f 742c 2069 3338 86-coreboot, i38 │ │ │ │ +00009510: 362d 7165 6d75 2061 6e64 2069 3338 362d 6-qemu and i386- │ │ │ │ +00009520: 6d75 6c74 6962 6f6f 7420 7468 6520 7374 multiboot the st │ │ │ │ +00009530: 6163 6b20 6973 0a36 304b 6942 2e20 416c ack is.60KiB. Al │ │ │ │ +00009540: 6c20 6176 6169 6c61 626c 6520 7370 6163 l available spac │ │ │ │ +00009550: 6520 6265 7477 6565 6e20 314d 6942 2061 e between 1MiB a │ │ │ │ +00009560: 6e64 2034 4769 4220 6d61 726b 7320 6973 nd 4GiB marks is │ │ │ │ +00009570: 2070 6172 7420 6f66 2068 6561 702e 0a0a part of heap... │ │ │ │ +00009580: 2020 204f 6e20 2a2d 7865 6e20 7374 6163 On *-xen stac │ │ │ │ +00009590: 6b20 6973 2034 4d69 422e 2049 6620 636f k is 4MiB. If co │ │ │ │ +000095a0: 6d70 696c 6564 2066 6f72 2078 3836 2d36 mpiled for x86-6 │ │ │ │ +000095b0: 3420 7769 7468 2047 4343 2034 2e34 206f 4 with GCC 4.4 o │ │ │ │ +000095c0: 7220 6c61 7465 720a 6164 7265 7373 6162 r later.adressab │ │ │ │ +000095d0: 6c65 2073 7061 6365 2069 7320 756e 6c69 le space is unli │ │ │ │ +000095e0: 6d69 7465 642e 2020 5768 656e 2063 6f6d mited. When com │ │ │ │ +000095f0: 7069 6c65 6420 666f 7220 7838 362d 3634 piled for x86-64 │ │ │ │ +00009600: 2077 6974 6820 6f6c 6465 7220 4743 430a with older GCC. │ │ │ │ +00009610: 7665 7273 696f 6e20 6164 7265 7373 6162 version adressab │ │ │ │ +00009620: 6c65 2073 7061 6365 2069 7320 6c69 6d69 le space is limi │ │ │ │ +00009630: 7465 6420 746f 2032 4769 422e 2057 6865 ted to 2GiB. Whe │ │ │ │ +00009640: 6e20 636f 6d70 696c 696e 6720 666f 7220 n compiling for │ │ │ │ +00009650: 6933 3836 0a61 6472 6573 7361 626c 6520 i386.adressable │ │ │ │ +00009660: 7370 6163 6520 6973 206c 696d 6974 6564 space is limited │ │ │ │ +00009670: 2074 6f20 3447 6942 2e20 416c 6c20 6164 to 4GiB. All ad │ │ │ │ +00009680: 7265 7373 6162 6c65 2070 6167 6573 2065 ressable pages e │ │ │ │ +00009690: 7863 6570 7420 7468 650a 6f6e 6573 2066 xcept the.ones f │ │ │ │ +000096a0: 6f72 2073 7461 636b 2c20 4752 5542 2062 or stack, GRUB b │ │ │ │ +000096b0: 696e 6172 792c 2073 7065 6369 616c 2070 inary, special p │ │ │ │ +000096c0: 6167 6573 2061 6e64 2070 6167 6520 7461 ages and page ta │ │ │ │ +000096d0: 626c 6520 6172 6520 696e 2074 6865 0a68 ble are in the.h │ │ │ │ +000096e0: 6561 702e 0a0a 2020 204f 6e20 2a2d 6566 eap... On *-ef │ │ │ │ +000096f0: 6920 4752 5542 2075 7365 7320 7361 6d65 i GRUB uses same │ │ │ │ +00009700: 2073 7461 636b 2061 7320 4546 492e 2049 stack as EFI. I │ │ │ │ +00009710: 6620 636f 6d70 696c 6564 2066 6f72 2078 f compiled for x │ │ │ │ +00009720: 3836 2d36 3420 7769 7468 2047 4343 0a34 86-64 with GCC.4 │ │ │ │ +00009730: 2e34 206f 7220 6c61 7465 7220 6164 7265 .4 or later adre │ │ │ │ +00009740: 7373 6162 6c65 2073 7061 6365 2069 7320 ssable space is │ │ │ │ +00009750: 756e 6c69 6d69 7465 642e 2020 5768 656e unlimited. When │ │ │ │ +00009760: 2063 6f6d 7069 6c65 6420 666f 7220 7838 compiled for x8 │ │ │ │ +00009770: 362d 3634 0a77 6974 6820 6f6c 6465 7220 6-64.with older │ │ │ │ +00009780: 4743 4320 7665 7273 696f 6e20 6164 7265 GCC version adre │ │ │ │ +00009790: 7373 6162 6c65 2073 7061 6365 2069 7320 ssable space is │ │ │ │ +000097a0: 6c69 6d69 7465 6420 746f 2032 4769 422e limited to 2GiB. │ │ │ │ +000097b0: 2046 6f72 2061 6c6c 0a6f 7468 6572 2070 For all.other p │ │ │ │ +000097c0: 6c61 7466 6f72 6d73 2061 6472 6573 7361 latforms adressa │ │ │ │ +000097d0: 626c 6520 7370 6163 6520 6973 206c 696d ble space is lim │ │ │ │ +000097e0: 6974 6564 2074 6f20 3447 6942 2e20 4752 ited to 4GiB. GR │ │ │ │ +000097f0: 5542 2061 6c6c 6f63 6174 6573 0a70 6167 UB allocates.pag │ │ │ │ +00009800: 6573 2066 726f 6d20 4546 4920 666f 7220 es from EFI for │ │ │ │ +00009810: 6974 7320 6865 6170 2c20 6174 206d 6f73 its heap, at mos │ │ │ │ +00009820: 7420 312e 3620 4769 422e 0a0a 2020 204f t 1.6 GiB... O │ │ │ │ +00009830: 6e20 6933 3836 2d69 6565 6531 3237 3520 n i386-ieee1275 │ │ │ │ +00009840: 616e 6420 706f 7765 7270 632d 6965 6565 and powerpc-ieee │ │ │ │ +00009850: 3132 3735 2047 5255 4220 7573 6573 2073 1275 GRUB uses s │ │ │ │ +00009860: 616d 6520 7374 6163 6b20 6173 0a49 4545 ame stack as.IEE │ │ │ │ +00009870: 4531 3237 352e 2020 4974 2061 6c6c 6f63 E1275. It alloc │ │ │ │ +00009880: 6174 6573 2061 7420 6d6f 7374 2033 324d ates at most 32M │ │ │ │ +00009890: 6942 2066 6f72 2069 7473 2068 6561 702e iB for its heap. │ │ │ │ +000098a0: 0a0a 2020 204f 6e20 7370 6172 6336 342d .. On sparc64- │ │ │ │ +000098b0: 6965 6565 3132 3735 2073 7461 636b 2069 ieee1275 stack i │ │ │ │ +000098c0: 7320 3235 364b 6942 2061 6e64 2068 6561 s 256KiB and hea │ │ │ │ +000098d0: 7020 6973 2032 4d69 422e 0a0a 2020 204f p is 2MiB... O │ │ │ │ +000098e0: 6e20 6d69 7073 2865 6c29 2d71 656d 755f n mips(el)-qemu_ │ │ │ │ +000098f0: 6d69 7073 2061 6e64 206d 6970 7365 6c2d mips and mipsel- │ │ │ │ +00009900: 6c6f 6f6e 6773 6f6e 2073 7461 636b 2069 loongson stack i │ │ │ │ +00009910: 7320 324d 6942 2028 6576 6572 7974 6869 s 2MiB (everythi │ │ │ │ +00009920: 6e67 0a62 656c 6f77 2047 5255 4220 696d ng.below GRUB im │ │ │ │ +00009930: 6167 6529 2061 6e64 2065 7665 7279 7468 age) and everyth │ │ │ │ +00009940: 696e 6720 6162 6f76 6520 4752 5542 2069 ing above GRUB i │ │ │ │ +00009950: 6d61 6765 2028 6672 6f6d 2032 4d69 4220 mage (from 2MiB │ │ │ │ +00009960: 2b20 6b65 726e 656c 0a73 697a 6529 2075 + kernel.size) u │ │ │ │ +00009970: 6e74 696c 2032 3536 4d69 4220 6973 2070 ntil 256MiB is p │ │ │ │ +00009980: 6172 7420 6f66 2068 6561 702e 0a0a 2020 art of heap... │ │ │ │ +00009990: 204f 6e20 6d69 7073 2d61 7263 2073 7461 On mips-arc sta │ │ │ │ +000099a0: 636b 2069 7320 324d 6942 2028 6576 6572 ck is 2MiB (ever │ │ │ │ +000099b0: 7974 6869 6e67 2062 656c 6f77 2047 5255 ything below GRU │ │ │ │ +000099c0: 4220 696d 6167 6529 2061 6e64 0a65 7665 B image) and.eve │ │ │ │ +000099d0: 7279 7468 696e 6720 6162 6f76 6520 4752 rything above GR │ │ │ │ +000099e0: 5542 2069 6d61 6765 2866 726f 6d20 324d UB image(from 2M │ │ │ │ +000099f0: 6942 202b 206b 6572 6e65 6c20 7369 7a65 iB + kernel size │ │ │ │ +00009a00: 2920 756e 7469 6c20 3132 384d 6942 2069 ) until 128MiB i │ │ │ │ +00009a10: 730a 7061 7274 206f 6620 6865 6170 2e0a s.part of heap.. │ │ │ │ +00009a20: 0a20 2020 4f6e 206d 6970 7365 6c2d 6172 . On mipsel-ar │ │ │ │ +00009a30: 6320 7374 6163 6b20 6973 2032 4d69 4220 c stack is 2MiB │ │ │ │ +00009a40: 2865 7665 7279 7468 696e 6720 6265 6c6f (everything belo │ │ │ │ +00009a50: 7720 4752 5542 2069 6d61 6765 2077 6869 w GRUB image whi │ │ │ │ +00009a60: 6368 2069 7320 6e6f 740a 7061 7274 206f ch is not.part o │ │ │ │ +00009a70: 6620 4152 4329 2061 6e64 2065 7665 7279 f ARC) and every │ │ │ │ +00009a80: 7468 696e 6720 6162 6f76 6520 4752 5542 thing above GRUB │ │ │ │ +00009a90: 2069 6d61 6765 2028 6672 6f6d 2037 4d69 image (from 7Mi │ │ │ │ +00009aa0: 4220 2b20 6b65 726e 656c 2073 697a 6529 B + kernel size) │ │ │ │ +00009ab0: 0a75 6e74 696c 2032 3536 4d69 4220 6973 .until 256MiB is │ │ │ │ +00009ac0: 2070 6172 7420 6f66 2068 6561 702e 0a0a part of heap... │ │ │ │ +00009ad0: 2020 204f 6e20 6172 6d2d 7562 6f6f 7420 On arm-uboot │ │ │ │ +00009ae0: 7374 6163 6b20 6973 2032 3536 4b69 4220 stack is 256KiB │ │ │ │ +00009af0: 616e 6420 6865 6170 2069 7320 324d 6942 and heap is 2MiB │ │ │ │ +00009b00: 2e0a 0a20 2020 496e 2073 686f 7274 3a0a ... In short:. │ │ │ │ +00009b10: 0a50 6c61 7466 6f72 6d20 2020 2053 7461 .Platform Sta │ │ │ │ +00009b20: 636b 2020 2020 2020 2020 2020 2020 2020 ck │ │ │ │ +00009b30: 4865 6170 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d Heap.----------- │ │ │ │ 00009b40: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ 00009b50: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ 00009b60: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ -00009b70: 2d2d 2d2d 2d0a 656d 7520 2020 2020 2020 -----.emu │ │ │ │ -00009b80: 2020 3820 4d69 4220 2020 2020 2020 2020 8 MiB │ │ │ │ -00009b90: 2020 2020 203f 0a69 3338 362d 7063 2020 ?.i386-pc │ │ │ │ -00009ba0: 2020 2036 3020 4b69 4220 2020 2020 2020 60 KiB │ │ │ │ -00009bb0: 2020 2020 2020 3c20 3420 4769 420a 6933 < 4 GiB.i3 │ │ │ │ -00009bc0: 3836 2d63 6f72 6562 6f6f 7436 3020 4b69 86-coreboot60 Ki │ │ │ │ -00009bd0: 4220 2020 2020 2020 2020 2020 203c 2034 B < 4 │ │ │ │ -00009be0: 2047 6942 0a69 3338 362d 6d75 6c74 6962 GiB.i386-multib │ │ │ │ -00009bf0: 6f6f 7436 3020 4b69 4220 2020 2020 2020 oot60 KiB │ │ │ │ -00009c00: 2020 2020 3c20 3420 4769 420a 6933 3836 < 4 GiB.i386 │ │ │ │ -00009c10: 2d71 656d 7520 2020 3630 204b 6942 2020 -qemu 60 KiB │ │ │ │ -00009c20: 2020 2020 2020 2020 2020 203c 2034 2047 < 4 G │ │ │ │ -00009c30: 6942 0a2a 2d65 6669 2020 2020 2020 203f iB.*-efi ? │ │ │ │ -00009c40: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00009c50: 2020 3c20 312e 3620 4769 420a 6933 3836 < 1.6 GiB.i386 │ │ │ │ -00009c60: 2d69 6565 6531 3237 353f 2020 2020 2020 -ieee1275? │ │ │ │ -00009c70: 2020 2020 2020 2020 2020 203c 2033 3220 < 32 │ │ │ │ -00009c80: 4d69 420a 706f 7765 7270 632d 6965 6565 MiB.powerpc-ieee │ │ │ │ -00009c90: 3132 3735 3f20 2020 2020 2020 2020 2020 1275? │ │ │ │ -00009ca0: 2020 203c 2033 3220 4d69 420a 7370 6172 < 32 MiB.spar │ │ │ │ -00009cb0: 6336 342d 6965 6565 3132 3735 3235 364b c64-ieee1275256K │ │ │ │ -00009cc0: 6942 2020 2020 2020 2020 2032 204d 6942 iB 2 MiB │ │ │ │ -00009cd0: 0a61 726d 2d75 626f 6f74 2020 2032 3536 .arm-uboot 256 │ │ │ │ -00009ce0: 4b69 4220 2020 2020 2020 2020 2020 2020 KiB │ │ │ │ -00009cf0: 3220 4d69 420a 6d69 7073 2865 6c29 2d71 2 MiB.mips(el)-q │ │ │ │ -00009d00: 656d 755f 6d69 7073 324d 6942 2020 2020 emu_mips2MiB │ │ │ │ -00009d10: 2020 2020 2032 3533 204d 6942 0a6d 6970 253 MiB.mip │ │ │ │ -00009d20: 7365 6c2d 6c6f 6f6e 6773 6f6e 324d 6942 sel-loongson2MiB │ │ │ │ -00009d30: 2020 2020 2020 2020 2020 2020 3235 3320 253 │ │ │ │ -00009d40: 4d69 420a 6d69 7073 2d61 7263 2020 2020 MiB.mips-arc │ │ │ │ -00009d50: 324d 6942 2020 2020 2020 2020 2020 2020 2MiB │ │ │ │ -00009d60: 2020 2031 3235 204d 6942 0a6d 6970 7365 125 MiB.mipse │ │ │ │ -00009d70: 6c2d 6172 6320 2032 4d69 4220 2020 2020 l-arc 2MiB │ │ │ │ -00009d80: 2020 2020 2020 2020 2020 3234 3820 4d69 248 Mi │ │ │ │ -00009d90: 420a 7838 365f 3634 2d78 656e 2020 344d B.x86_64-xen 4M │ │ │ │ -00009da0: 6942 2020 2020 2020 2020 2020 2020 2020 iB │ │ │ │ -00009db0: 2075 6e6c 696d 6974 6564 0a28 4743 4320 unlimited.(GCC │ │ │ │ -00009dc0: 3e3d 0a34 2e34 290a 7838 365f 3634 2d78 >=.4.4).x86_64-x │ │ │ │ -00009dd0: 656e 2020 344d 6942 2020 2020 2020 2020 en 4MiB │ │ │ │ -00009de0: 2020 2020 2020 203c 2032 4769 420a 2847 < 2GiB.(G │ │ │ │ -00009df0: 4343 203c 0a34 2e34 290a 6933 3836 2d78 CC <.4.4).i386-x │ │ │ │ -00009e00: 656e 2020 2020 344d 6942 2020 2020 2020 en 4MiB │ │ │ │ -00009e10: 2020 2020 2020 2020 203c 2034 4769 420a < 4GiB. │ │ │ │ -00009e20: 0a1f 0a46 696c 653a 2067 7275 622d 6465 ...File: grub-de │ │ │ │ -00009e30: 762e 696e 666f 2c20 204e 6f64 653a 2042 v.info, Node: B │ │ │ │ -00009e40: 494f 5320 706f 7274 206d 656d 6f72 7920 IOS port memory │ │ │ │ -00009e50: 6d61 702c 2020 4e65 7874 3a20 5669 6465 map, Next: Vide │ │ │ │ -00009e60: 6f20 5375 6273 7973 7465 6d2c 2020 5072 o Subsystem, Pr │ │ │ │ -00009e70: 6576 3a20 5374 6163 6b20 616e 6420 6865 ev: Stack and he │ │ │ │ -00009e80: 6170 2073 697a 652c 2020 5570 3a20 546f ap size, Up: To │ │ │ │ -00009e90: 700a 0a39 2042 494f 5320 706f 7274 206d p..9 BIOS port m │ │ │ │ -00009ea0: 656d 6f72 7920 6d61 700a 2a2a 2a2a 2a2a emory map.****** │ │ │ │ +00009b70: 2d2d 2d2d 2d2d 2d2d 2d0a 656d 7520 2020 ---------.emu │ │ │ │ +00009b80: 2020 2020 2020 3820 4d69 4220 2020 2020 8 MiB │ │ │ │ +00009b90: 2020 2020 2020 2020 203f 0a69 3338 362d ?.i386- │ │ │ │ +00009ba0: 7063 2020 2020 2036 3020 4b69 4220 2020 pc 60 KiB │ │ │ │ +00009bb0: 2020 2020 2020 2020 2020 3c20 3420 4769 < 4 Gi │ │ │ │ +00009bc0: 420a 6933 3836 2d63 6f72 6562 6f6f 7436 B.i386-coreboot6 │ │ │ │ +00009bd0: 3020 4b69 4220 2020 2020 2020 2020 2020 0 KiB │ │ │ │ +00009be0: 203c 2034 2047 6942 0a69 3338 362d 6d75 < 4 GiB.i386-mu │ │ │ │ +00009bf0: 6c74 6962 6f6f 7436 3020 4b69 4220 2020 ltiboot60 KiB │ │ │ │ +00009c00: 2020 2020 2020 2020 3c20 3420 4769 420a < 4 GiB. │ │ │ │ +00009c10: 6933 3836 2d71 656d 7520 2020 3630 204b i386-qemu 60 K │ │ │ │ +00009c20: 6942 2020 2020 2020 2020 2020 2020 203c iB < │ │ │ │ +00009c30: 2034 2047 6942 0a2a 2d65 6669 2020 2020 4 GiB.*-efi │ │ │ │ +00009c40: 2020 203f 2020 2020 2020 2020 2020 2020 ? │ │ │ │ +00009c50: 2020 2020 2020 3c20 312e 3620 4769 420a < 1.6 GiB. │ │ │ │ +00009c60: 6933 3836 2d69 6565 6531 3237 353f 2020 i386-ieee1275? │ │ │ │ +00009c70: 2020 2020 2020 2020 2020 2020 2020 203c < │ │ │ │ +00009c80: 2033 3220 4d69 420a 706f 7765 7270 632d 32 MiB.powerpc- │ │ │ │ +00009c90: 6965 6565 3132 3735 3f20 2020 2020 2020 ieee1275? │ │ │ │ +00009ca0: 2020 2020 2020 203c 2033 3220 4d69 420a < 32 MiB. │ │ │ │ +00009cb0: 7370 6172 6336 342d 6965 6565 3132 3735 sparc64-ieee1275 │ │ │ │ +00009cc0: 3235 364b 6942 2020 2020 2020 2020 2032 256KiB 2 │ │ │ │ +00009cd0: 204d 6942 0a61 726d 2d75 626f 6f74 2020 MiB.arm-uboot │ │ │ │ +00009ce0: 2032 3536 4b69 4220 2020 2020 2020 2020 256KiB │ │ │ │ +00009cf0: 2020 2020 3220 4d69 420a 6d69 7073 2865 2 MiB.mips(e │ │ │ │ +00009d00: 6c29 2d71 656d 755f 6d69 7073 324d 6942 l)-qemu_mips2MiB │ │ │ │ +00009d10: 2020 2020 2020 2020 2032 3533 204d 6942 253 MiB │ │ │ │ +00009d20: 0a6d 6970 7365 6c2d 6c6f 6f6e 6773 6f6e .mipsel-loongson │ │ │ │ +00009d30: 324d 6942 2020 2020 2020 2020 2020 2020 2MiB │ │ │ │ +00009d40: 3235 3320 4d69 420a 6d69 7073 2d61 7263 253 MiB.mips-arc │ │ │ │ +00009d50: 2020 2020 324d 6942 2020 2020 2020 2020 2MiB │ │ │ │ +00009d60: 2020 2020 2020 2031 3235 204d 6942 0a6d 125 MiB.m │ │ │ │ +00009d70: 6970 7365 6c2d 6172 6320 2032 4d69 4220 ipsel-arc 2MiB │ │ │ │ +00009d80: 2020 2020 2020 2020 2020 2020 2020 3234 24 │ │ │ │ +00009d90: 3820 4d69 420a 7838 365f 3634 2d78 656e 8 MiB.x86_64-xen │ │ │ │ +00009da0: 2020 344d 6942 2020 2020 2020 2020 2020 4MiB │ │ │ │ +00009db0: 2020 2020 2075 6e6c 696d 6974 6564 0a28 unlimited.( │ │ │ │ +00009dc0: 4743 4320 3e3d 0a34 2e34 290a 7838 365f GCC >=.4.4).x86_ │ │ │ │ +00009dd0: 3634 2d78 656e 2020 344d 6942 2020 2020 64-xen 4MiB │ │ │ │ +00009de0: 2020 2020 2020 2020 2020 203c 2032 4769 < 2Gi │ │ │ │ +00009df0: 420a 2847 4343 203c 0a34 2e34 290a 6933 B.(GCC <.4.4).i3 │ │ │ │ +00009e00: 3836 2d78 656e 2020 2020 344d 6942 2020 86-xen 4MiB │ │ │ │ +00009e10: 2020 2020 2020 2020 2020 2020 203c 2034 < 4 │ │ │ │ +00009e20: 4769 420a 0a1f 0a46 696c 653a 2067 7275 GiB....File: gru │ │ │ │ +00009e30: 622d 6465 762e 696e 666f 2c20 204e 6f64 b-dev.info, Nod │ │ │ │ +00009e40: 653a 2042 494f 5320 706f 7274 206d 656d e: BIOS port mem │ │ │ │ +00009e50: 6f72 7920 6d61 702c 2020 4e65 7874 3a20 ory map, Next: │ │ │ │ +00009e60: 5669 6465 6f20 5375 6273 7973 7465 6d2c Video Subsystem, │ │ │ │ +00009e70: 2020 5072 6576 3a20 5374 6163 6b20 616e Prev: Stack an │ │ │ │ +00009e80: 6420 6865 6170 2073 697a 652c 2020 5570 d heap size, Up │ │ │ │ +00009e90: 3a20 546f 700a 0a39 2042 494f 5320 706f : Top..9 BIOS po │ │ │ │ +00009ea0: 7274 206d 656d 6f72 7920 6d61 700a 2a2a rt memory map.** │ │ │ │ 00009eb0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ -00009ec0: 0a0a 5374 6172 7420 2020 2020 2020 456e ..Start En │ │ │ │ -00009ed0: 6420 2020 2020 2020 2020 2020 2020 2020 d │ │ │ │ -00009ee0: 2055 7361 6765 0a2d 2d2d 2d2d 2d2d 2d2d Usage.--------- │ │ │ │ +00009ec0: 2a2a 2a2a 0a0a 5374 6172 7420 2020 2020 ****..Start │ │ │ │ +00009ed0: 2020 456e 6420 2020 2020 2020 2020 2020 End │ │ │ │ +00009ee0: 2020 2020 2055 7361 6765 0a2d 2d2d 2d2d Usage.----- │ │ │ │ 00009ef0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ 00009f00: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ 00009f10: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ -00009f20: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 3020 2020 -----------.0 │ │ │ │ -00009f30: 2020 2020 2020 2020 3078 3130 3030 202d 0x1000 - │ │ │ │ -00009f40: 2031 2020 2020 2020 2020 2042 494f 5320 1 BIOS │ │ │ │ -00009f50: 616e 6420 7265 616c 206d 6f64 6520 696e and real mode in │ │ │ │ -00009f60: 7465 7272 7570 7473 0a30 7830 3742 4520 terrupts.0x07BE │ │ │ │ -00009f70: 2020 2020 2030 7830 3746 4620 2020 2020 0x07FF │ │ │ │ -00009f80: 2020 2020 2020 2020 5061 7274 6974 696f Partitio │ │ │ │ -00009f90: 6e20 7461 626c 6520 7061 7373 6564 2074 n table passed t │ │ │ │ -00009fa0: 6f20 616e 6f74 6865 720a 2020 2020 2020 o another. │ │ │ │ +00009f20: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a ---------------. │ │ │ │ +00009f30: 3020 2020 2020 2020 2020 2020 3078 3130 0 0x10 │ │ │ │ +00009f40: 3030 202d 2031 2020 2020 2020 2020 2042 00 - 1 B │ │ │ │ +00009f50: 494f 5320 616e 6420 7265 616c 206d 6f64 IOS and real mod │ │ │ │ +00009f60: 6520 696e 7465 7272 7570 7473 0a30 7830 e interrupts.0x0 │ │ │ │ +00009f70: 3742 4520 2020 2020 2030 7830 3746 4620 7BE 0x07FF │ │ │ │ +00009f80: 2020 2020 2020 2020 2020 2020 5061 7274 Part │ │ │ │ +00009f90: 6974 696f 6e20 7461 626c 6520 7061 7373 ition table pass │ │ │ │ +00009fa0: 6564 2074 6f20 616e 6f74 6865 720a 2020 ed to another. │ │ │ │ 00009fb0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00009fc0: 2020 2020 2020 2020 2062 6f6f 7420 6c6f boot lo │ │ │ │ -00009fd0: 6164 6572 0a3f 2020 2020 2020 2020 2020 ader.? │ │ │ │ -00009fe0: 2030 7832 3030 3020 2d20 3120 2020 2020 0x2000 - 1 │ │ │ │ -00009ff0: 2020 2020 5265 616c 206d 6f64 6520 7374 Real mode st │ │ │ │ -0000a000: 6163 6b0a 3078 3743 3030 2020 2020 2020 ack.0x7C00 │ │ │ │ -0000a010: 3078 3744 3030 202d 2031 2020 2020 2020 0x7D00 - 1 │ │ │ │ -0000a020: 2020 2042 6f6f 7420 7365 6374 6f72 0a30 Boot sector.0 │ │ │ │ -0000a030: 7838 3030 3020 2020 2020 203f 2020 2020 x8000 ? │ │ │ │ -0000a040: 2020 2020 2020 2020 2020 2020 2020 4752 GR │ │ │ │ -0000a050: 5542 206b 6572 6e65 6c0a 3078 3638 3030 UB kernel.0x6800 │ │ │ │ -0000a060: 3020 2020 2020 3078 3731 3030 3020 2d20 0 0x71000 - │ │ │ │ -0000a070: 3120 2020 2020 2020 2044 6973 6b20 6275 1 Disk bu │ │ │ │ -0000a080: 6666 6572 0a3f 2020 2020 2020 2020 2020 ffer.? │ │ │ │ -0000a090: 2030 7838 3030 3030 202d 2031 2020 2020 0x80000 - 1 │ │ │ │ -0000a0a0: 2020 2020 5072 6f74 6563 7465 6420 6d6f Protected mo │ │ │ │ -0000a0b0: 6465 2073 7461 636b 0a3f 2020 2020 2020 de stack.? │ │ │ │ -0000a0c0: 2020 2020 2030 7841 3030 3030 202d 2031 0xA0000 - 1 │ │ │ │ -0000a0d0: 2020 2020 2020 2020 4578 7465 6e64 6564 Extended │ │ │ │ -0000a0e0: 2042 494f 5320 4461 7461 2041 7265 610a BIOS Data Area. │ │ │ │ -0000a0f0: 3078 4130 3030 3020 2020 2020 3078 4330 0xA0000 0xC0 │ │ │ │ -0000a100: 3030 3020 2d20 3120 2020 2020 2020 2056 000 - 1 V │ │ │ │ -0000a110: 6964 656f 2052 414d 0a30 7843 3030 3030 ideo RAM.0xC0000 │ │ │ │ -0000a120: 2020 2020 2030 7831 3030 3030 3020 2d20 0x100000 - │ │ │ │ -0000a130: 3120 2020 2020 2020 4249 4f53 0a30 7831 1 BIOS.0x1 │ │ │ │ -0000a140: 3030 3030 3020 2020 203f 2020 2020 2020 00000 ? │ │ │ │ -0000a150: 2020 2020 2020 2020 2020 2020 4865 6170 Heap │ │ │ │ -0000a160: 2061 6e64 206d 6f64 756c 6520 636f 6465 and module code │ │ │ │ -0000a170: 0a0a 1f0a 4669 6c65 3a20 6772 7562 2d64 ....File: grub-d │ │ │ │ -0000a180: 6576 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ev.info, Node: │ │ │ │ -0000a190: 5669 6465 6f20 5375 6273 7973 7465 6d2c Video Subsystem, │ │ │ │ -0000a1a0: 2020 4e65 7874 3a20 5046 4632 2046 6f6e Next: PFF2 Fon │ │ │ │ -0000a1b0: 7420 4669 6c65 2046 6f72 6d61 742c 2020 t File Format, │ │ │ │ -0000a1c0: 5072 6576 3a20 4249 4f53 2070 6f72 7420 Prev: BIOS port │ │ │ │ -0000a1d0: 6d65 6d6f 7279 206d 6170 2c20 2055 703a memory map, Up: │ │ │ │ -0000a1e0: 2054 6f70 0a0a 3130 2056 6964 656f 2053 Top..10 Video S │ │ │ │ -0000a1f0: 7562 7379 7374 656d 0a2a 2a2a 2a2a 2a2a ubsystem.******* │ │ │ │ -0000a200: 2a2a 2a2a 2a2a 2a2a 2a2a 2a0a 0a54 6869 ***********..Thi │ │ │ │ -0000a210: 7320 646f 6375 6d65 6e74 2063 6f6e 7461 s document conta │ │ │ │ -0000a220: 696e 7320 7370 6563 6966 6963 6174 696f ins specificatio │ │ │ │ -0000a230: 6e20 666f 7220 5669 6465 6f20 5375 6273 n for Video Subs │ │ │ │ -0000a240: 7973 7465 6d20 666f 7220 4752 5542 322e ystem for GRUB2. │ │ │ │ -0000a250: 0a43 7572 7265 6e74 6c79 206f 6e6c 7920 .Currently only │ │ │ │ -0000a260: 7468 6520 7573 6167 6520 696e 7465 7266 the usage interf │ │ │ │ -0000a270: 6163 6520 6973 2064 6573 6372 6962 6564 ace is described │ │ │ │ -0000a280: 2069 6e20 7468 6973 2064 6f63 756d 656e in this documen │ │ │ │ -0000a290: 742e 0a49 6e74 6572 6e61 6c20 7374 7275 t..Internal stru │ │ │ │ -0000a2a0: 6374 7572 6520 6f66 2068 6f77 2076 6964 cture of how vid │ │ │ │ -0000a2b0: 656f 2064 7269 7665 7273 2061 7265 2072 eo drivers are r │ │ │ │ -0000a2c0: 6567 6973 7465 7269 6e67 2061 6e64 2068 egistering and h │ │ │ │ -0000a2d0: 6f77 2076 6964 656f 0a64 7269 7665 7220 ow video.driver │ │ │ │ -0000a2e0: 6d61 6e61 6765 7220 776f 726b 7320 6172 manager works ar │ │ │ │ -0000a2f0: 6520 6e6f 7420 696e 636c 7564 6564 2068 e not included h │ │ │ │ -0000a300: 6572 652e 0a0a 2a20 4d65 6e75 3a0a 0a2a ere...* Menu:..* │ │ │ │ -0000a310: 2056 6964 656f 2041 5049 3a3a 0a2a 2045 Video API::.* E │ │ │ │ -0000a320: 7861 6d70 6c65 2075 7361 6765 206f 6620 xample usage of │ │ │ │ -0000a330: 5669 6465 6f20 4150 493a 3a0a 2a20 4269 Video API::.* Bi │ │ │ │ -0000a340: 746d 6170 2041 5049 3a3a 0a0a 1f0a 4669 tmap API::....Fi │ │ │ │ -0000a350: 6c65 3a20 6772 7562 2d64 6576 2e69 6e66 le: grub-dev.inf │ │ │ │ -0000a360: 6f2c 2020 4e6f 6465 3a20 5669 6465 6f20 o, Node: Video │ │ │ │ -0000a370: 4150 492c 2020 4e65 7874 3a20 4578 616d API, Next: Exam │ │ │ │ -0000a380: 706c 6520 7573 6167 6520 6f66 2056 6964 ple usage of Vid │ │ │ │ -0000a390: 656f 2041 5049 2c20 2055 703a 2056 6964 eo API, Up: Vid │ │ │ │ -0000a3a0: 656f 2053 7562 7379 7374 656d 0a0a 3130 eo Subsystem..10 │ │ │ │ -0000a3b0: 2e31 2056 6964 656f 2041 5049 0a3d 3d3d .1 Video API.=== │ │ │ │ -0000a3c0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a31 302e ===========..10. │ │ │ │ -0000a3d0: 312e 3120 6772 7562 5f76 6964 656f 5f73 1.1 grub_video_s │ │ │ │ -0000a3e0: 6574 7570 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d etup.----------- │ │ │ │ -0000a3f0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 2020 ------------.. │ │ │ │ -0000a400: 202a 2050 726f 746f 7479 7065 3a0a 2020 * Prototype:. │ │ │ │ -0000a410: 2020 2020 2020 2020 6772 7562 5f65 7272 grub_err │ │ │ │ -0000a420: 5f74 0a20 2020 2020 2020 2020 2067 7275 _t. gru │ │ │ │ -0000a430: 625f 7669 6465 6f5f 7365 7475 7020 2875 b_video_setup (u │ │ │ │ -0000a440: 6e73 6967 6e65 6420 696e 7420 7769 6474 nsigned int widt │ │ │ │ -0000a450: 682c 2075 6e73 6967 6e65 6420 696e 7420 h, unsigned int │ │ │ │ -0000a460: 6865 6967 6874 2c20 756e 7369 676e 6564 height, unsigned │ │ │ │ -0000a470: 2069 6e74 206d 6f64 655f 7479 7065 293b int mode_type); │ │ │ │ -0000a480: 0a20 2020 2a20 4465 7363 7269 7074 696f . * Descriptio │ │ │ │ -0000a490: 6e3a 0a0a 2020 2020 2044 7269 7665 7220 n:.. Driver │ │ │ │ -0000a4a0: 7769 6c6c 2075 7365 2069 6e66 6f72 6d61 will use informa │ │ │ │ -0000a4b0: 7469 6f6e 2070 726f 7669 6465 6420 746f tion provided to │ │ │ │ -0000a4c0: 2069 7420 746f 2073 656c 6563 7420 6265 it to select be │ │ │ │ -0000a4d0: 7374 2070 6f73 7369 626c 650a 2020 2020 st possible. │ │ │ │ -0000a4e0: 2076 6964 656f 206d 6f64 6520 616e 6420 video mode and │ │ │ │ -0000a4f0: 7377 6974 6368 2074 6f20 6974 2e20 2053 switch to it. S │ │ │ │ -0000a500: 7570 706f 7274 6564 2076 616c 7565 7320 upported values │ │ │ │ -0000a510: 666f 7220 276d 6f64 655f 7479 7065 2720 for 'mode_type' │ │ │ │ -0000a520: 6172 650a 2020 2020 2027 4752 5542 5f56 are. 'GRUB_V │ │ │ │ -0000a530: 4944 454f 5f4d 4f44 455f 5459 5045 5f49 IDEO_MODE_TYPE_I │ │ │ │ -0000a540: 4e44 4558 5f43 4f4c 4f52 2720 666f 7220 NDEX_COLOR' for │ │ │ │ -0000a550: 696e 6465 7820 636f 6c6f 7220 6d6f 6465 index color mode │ │ │ │ -0000a560: 732c 0a20 2020 2020 2747 5255 425f 5649 s,. 'GRUB_VI │ │ │ │ -0000a570: 4445 4f5f 4d4f 4445 5f54 5950 455f 5247 DEO_MODE_TYPE_RG │ │ │ │ -0000a580: 4227 2066 6f72 2064 6972 6563 7420 5247 B' for direct RG │ │ │ │ -0000a590: 4220 636f 6c6f 7220 6d6f 6465 7320 616e B color modes an │ │ │ │ -0000a5a0: 640a 2020 2020 2027 4752 5542 5f56 4944 d. 'GRUB_VID │ │ │ │ -0000a5b0: 454f 5f4d 4f44 455f 5459 5045 5f44 4f55 EO_MODE_TYPE_DOU │ │ │ │ -0000a5c0: 424c 455f 4255 4646 4552 4544 2720 666f BLE_BUFFERED' fo │ │ │ │ -0000a5d0: 7220 646f 7562 6c65 2062 7566 6665 7269 r double bufferi │ │ │ │ -0000a5e0: 6e67 2e20 2057 6865 6e0a 2020 2020 2072 ng. When. r │ │ │ │ -0000a5f0: 6571 7565 7374 696e 6720 5247 4220 6d6f equesting RGB mo │ │ │ │ -0000a600: 6465 2c20 6869 6768 6573 7420 6269 7473 de, highest bits │ │ │ │ -0000a610: 2070 6572 2070 6978 656c 206d 6f64 6520 per pixel mode │ │ │ │ -0000a620: 7769 6c6c 2062 6520 7365 6c65 6374 6564 will be selected │ │ │ │ -0000a630: 2e0a 2020 2020 2057 6865 6e20 7265 7175 .. When requ │ │ │ │ -0000a640: 6573 7469 6e67 2049 6e64 6578 2063 6f6c esting Index col │ │ │ │ -0000a650: 6f72 206d 6f64 652c 206d 6f64 6520 7769 or mode, mode wi │ │ │ │ -0000a660: 7468 2068 6967 6865 7374 206e 756d 6265 th highest numbe │ │ │ │ -0000a670: 7220 6f66 0a20 2020 2020 636f 6c6f 7273 r of. colors │ │ │ │ -0000a680: 2077 696c 6c20 6265 2073 656c 6563 7465 will be selecte │ │ │ │ -0000a690: 642e 2020 4966 2061 6c6c 2070 6172 616d d. If all param │ │ │ │ -0000a6a0: 6574 6572 7320 6172 6520 7370 6563 6966 eters are specif │ │ │ │ -0000a6b0: 6965 6420 6173 207a 6572 6f2c 0a20 2020 ied as zero,. │ │ │ │ -0000a6c0: 2020 7669 6465 6f20 6164 6170 7465 7220 video adapter │ │ │ │ -0000a6d0: 7769 6c6c 2074 7279 2074 6f20 6669 6775 will try to figu │ │ │ │ -0000a6e0: 7265 206f 7574 2062 6573 7420 706f 7373 re out best poss │ │ │ │ -0000a6f0: 6962 6c65 206d 6f64 6520 616e 640a 2020 ible mode and. │ │ │ │ -0000a700: 2020 2069 6e69 7469 616c 697a 6520 6974 initialize it │ │ │ │ -0000a710: 2c20 706c 6174 666f 726d 2073 7065 6369 , platform speci │ │ │ │ -0000a720: 6669 6320 6469 6666 6572 656e 6365 7320 fic differences │ │ │ │ -0000a730: 6172 6520 616c 6c6f 7765 6420 6865 7265 are allowed here │ │ │ │ -0000a740: 2e20 2049 660a 2020 2020 2074 6865 7265 . If. there │ │ │ │ -0000a750: 2069 7320 6e6f 206d 6f64 6520 6d61 7463 is no mode matc │ │ │ │ -0000a760: 6869 6e67 2072 6571 7565 7374 2c20 6572 hing request, er │ │ │ │ -0000a770: 726f 7220 5820 7769 6c6c 2062 6520 7265 ror X will be re │ │ │ │ -0000a780: 7475 726e 6564 2e20 2049 660a 2020 2020 turned. If. │ │ │ │ -0000a790: 2074 6865 7265 2061 7265 206e 6f20 7072 there are no pr │ │ │ │ -0000a7a0: 6f62 6c65 6d73 2c20 6675 6e63 7469 6f6e oblems, function │ │ │ │ -0000a7b0: 2072 6574 7572 6e73 2027 4752 5542 5f45 returns 'GRUB_E │ │ │ │ -0000a7c0: 5252 5f4e 4f4e 4527 2e0a 0a20 2020 2020 RR_NONE'... │ │ │ │ -0000a7d0: 5468 6973 2066 756e 6374 696f 6e20 616c This function al │ │ │ │ -0000a7e0: 736f 2070 6572 666f 726d 7320 666f 6c6c so performs foll │ │ │ │ -0000a7f0: 6f77 696e 6720 7461 736b 2075 706f 6e20 owing task upon │ │ │ │ -0000a800: 7375 6363 6573 6675 6c20 6d6f 6465 0a20 succesful mode. │ │ │ │ -0000a810: 2020 2020 7377 6974 6368 2e20 2041 6374 switch. Act │ │ │ │ -0000a820: 6976 6520 7265 6e64 6572 696e 6720 7461 ive rendering ta │ │ │ │ -0000a830: 7267 6574 2069 7320 6368 616e 6765 6420 rget is changed │ │ │ │ -0000a840: 746f 2073 6372 6565 6e20 616e 6420 7669 to screen and vi │ │ │ │ -0000a850: 6577 706f 7274 0a20 2020 2020 6973 206d ewport. is m │ │ │ │ -0000a860: 6178 696d 697a 6564 2074 6f20 616c 6c6f aximized to allo │ │ │ │ -0000a870: 7720 7768 6f6c 6520 7363 7265 656e 2074 w whole screen t │ │ │ │ -0000a880: 6f20 6265 2075 7365 6420 7768 656e 2070 o be used when p │ │ │ │ -0000a890: 6572 666f 726d 696e 670a 2020 2020 2067 erforming. g │ │ │ │ -0000a8a0: 7261 7068 6963 7320 6f70 6572 6174 696f raphics operatio │ │ │ │ -0000a8b0: 6e73 2e20 2049 6e20 5247 4220 6d6f 6465 ns. In RGB mode │ │ │ │ -0000a8c0: 732c 2065 6d75 6c61 7465 6420 7061 6c65 s, emulated pale │ │ │ │ -0000a8d0: 7474 6520 6765 7473 2031 360a 2020 2020 tte gets 16. │ │ │ │ -0000a8e0: 2065 6e74 7269 6573 2063 6f6e 7461 696e entries contain │ │ │ │ -0000a8f0: 696e 6720 6465 6661 756c 7420 7661 6c75 ing default valu │ │ │ │ -0000a900: 6573 2066 6f72 2056 4741 2070 616c 6574 es for VGA palet │ │ │ │ -0000a910: 7465 2c20 6f74 6865 7220 636f 6c6f 7273 te, other colors │ │ │ │ -0000a920: 2061 7265 0a20 2020 2020 6465 6669 6e65 are. define │ │ │ │ -0000a930: 6420 6173 2062 6c61 636b 2e20 2057 6865 d as black. Whe │ │ │ │ -0000a940: 6e20 7377 6974 6368 696e 6720 746f 2049 n switching to I │ │ │ │ -0000a950: 6e64 6578 6564 2043 6f6c 6f72 206d 6f64 ndexed Color mod │ │ │ │ -0000a960: 652c 2064 7269 7665 7220 6d61 790a 2020 e, driver may. │ │ │ │ -0000a970: 2020 2073 6574 2064 6566 6175 6c74 2056 set default V │ │ │ │ -0000a980: 4741 2070 616c 6574 7465 2074 6f20 7363 GA palette to sc │ │ │ │ -0000a990: 7265 656e 2069 6620 7468 6520 7669 6465 reen if the vide │ │ │ │ -0000a9a0: 6f20 6361 7264 2061 6c6c 6f77 7320 7468 o card allows th │ │ │ │ -0000a9b0: 650a 2020 2020 206f 7065 7261 7469 6f6e e. operation │ │ │ │ -0000a9c0: 2e0a 0a31 302e 312e 3220 6772 7562 5f76 ...10.1.2 grub_v │ │ │ │ -0000a9d0: 6964 656f 5f72 6573 746f 7265 0a2d 2d2d ideo_restore.--- │ │ │ │ -0000a9e0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ -0000a9f0: 2d2d 2d2d 2d2d 0a0a 2020 202a 2050 726f ------.. * Pro │ │ │ │ -0000aa00: 746f 7479 7065 3a0a 0a20 2020 2020 2020 totype:.. │ │ │ │ -0000aa10: 2020 2067 7275 625f 6572 725f 740a 2020 grub_err_t. │ │ │ │ -0000aa20: 2020 2020 2020 2020 6772 7562 5f76 6964 grub_vid │ │ │ │ -0000aa30: 656f 5f72 6573 746f 7265 2028 766f 6964 eo_restore (void │ │ │ │ -0000aa40: 293b 0a20 2020 2a20 4465 7363 7269 7074 );. * Descript │ │ │ │ -0000aa50: 696f 6e3a 0a0a 2020 2020 2056 6964 656f ion:.. Video │ │ │ │ -0000aa60: 2073 7562 7379 7374 656d 2077 696c 6c20 subsystem will │ │ │ │ -0000aa70: 6465 696e 6974 6961 6c69 7a65 2061 6374 deinitialize act │ │ │ │ -0000aa80: 6976 6174 6564 2076 6964 656f 2064 7269 ivated video dri │ │ │ │ -0000aa90: 7665 7220 746f 2072 6573 746f 7265 0a20 ver to restore. │ │ │ │ -0000aaa0: 2020 2020 6f6c 6420 7374 6174 6520 6f66 old state of │ │ │ │ -0000aab0: 2076 6964 656f 2064 6576 6963 652e 2020 video device. │ │ │ │ -0000aac0: 5468 6973 2063 616e 2062 6520 7573 6564 This can be used │ │ │ │ -0000aad0: 2074 6f20 7377 6974 6368 2062 6163 6b20 to switch back │ │ │ │ -0000aae0: 746f 2074 6578 740a 2020 2020 206d 6f64 to text. mod │ │ │ │ -0000aaf0: 652e 0a0a 3130 2e31 2e33 2067 7275 625f e...10.1.3 grub_ │ │ │ │ -0000ab00: 7669 6465 6f5f 6765 745f 696e 666f 0a2d video_get_info.- │ │ │ │ -0000ab10: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ -0000ab20: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2020 2a20 ---------.. * │ │ │ │ -0000ab30: 5072 6f74 6f74 7970 653a 0a0a 2020 2020 Prototype:.. │ │ │ │ -0000ab40: 2020 2020 2020 6772 7562 5f65 7272 5f74 grub_err_t │ │ │ │ -0000ab50: 0a20 2020 2020 2020 2020 2067 7275 625f . grub_ │ │ │ │ -0000ab60: 7669 6465 6f5f 6765 745f 696e 666f 2028 video_get_info ( │ │ │ │ -0000ab70: 7374 7275 6374 2067 7275 625f 7669 6465 struct grub_vide │ │ │ │ -0000ab80: 6f5f 6d6f 6465 5f69 6e66 6f20 2a6d 6f64 o_mode_info *mod │ │ │ │ -0000ab90: 655f 696e 666f 293b 0a20 2020 2020 2020 e_info);. │ │ │ │ -0000aba0: 2020 2073 7472 7563 7420 6772 7562 5f76 struct grub_v │ │ │ │ -0000abb0: 6964 656f 5f6d 6f64 655f 696e 666f 0a20 ideo_mode_info. │ │ │ │ -0000abc0: 2020 2020 2020 2020 207b 0a20 2020 2020 {. │ │ │ │ -0000abd0: 2020 2020 2020 202f 2a20 5769 6474 6820 /* Width │ │ │ │ -0000abe0: 6f66 2074 6865 2073 6372 6565 6e2e 2020 of the screen. │ │ │ │ -0000abf0: 2a2f 0a20 2020 2020 2020 2020 2020 2075 */. u │ │ │ │ -0000ac00: 6e73 6967 6e65 6420 696e 7420 7769 6474 nsigned int widt │ │ │ │ -0000ac10: 683b 0a20 2020 2020 2020 2020 2020 202f h;. / │ │ │ │ -0000ac20: 2a20 4865 6967 6874 206f 6620 7468 6520 * Height of the │ │ │ │ -0000ac30: 7363 7265 656e 2e20 202a 2f0a 2020 2020 screen. */. │ │ │ │ -0000ac40: 2020 2020 2020 2020 756e 7369 676e 6564 unsigned │ │ │ │ -0000ac50: 2069 6e74 2068 6569 6768 743b 0a20 2020 int height;. │ │ │ │ -0000ac60: 2020 2020 2020 2020 202f 2a20 4d6f 6465 /* Mode │ │ │ │ -0000ac70: 2074 7970 6520 6269 746d 6173 6b2e 2020 type bitmask. │ │ │ │ -0000ac80: 436f 6e74 6169 6e73 2069 6e66 6f72 6d61 Contains informa │ │ │ │ -0000ac90: 7469 6f6e 206c 696b 6520 6973 2069 7420 tion like is it │ │ │ │ -0000aca0: 496e 6465 7820 636f 6c6f 7220 6f72 0a20 Index color or. │ │ │ │ -0000acb0: 2020 2020 2020 2020 2020 2020 2020 5247 RG │ │ │ │ -0000acc0: 4220 6d6f 6465 2e20 202a 2f0a 2020 2020 B mode. */. │ │ │ │ -0000acd0: 2020 2020 2020 2020 756e 7369 676e 6564 unsigned │ │ │ │ -0000ace0: 2069 6e74 206d 6f64 655f 7479 7065 3b0a int mode_type;. │ │ │ │ -0000acf0: 2020 2020 2020 2020 2020 2020 2f2a 2042 /* B │ │ │ │ -0000ad00: 6974 7320 7065 7220 7069 7865 6c2e 2020 its per pixel. │ │ │ │ -0000ad10: 2a2f 0a20 2020 2020 2020 2020 2020 2075 */. u │ │ │ │ -0000ad20: 6e73 6967 6e65 6420 696e 7420 6270 703b nsigned int bpp; │ │ │ │ -0000ad30: 0a20 2020 2020 2020 2020 2020 202f 2a20 . /* │ │ │ │ -0000ad40: 4279 7465 7320 7065 7220 7069 7865 6c2e Bytes per pixel. │ │ │ │ -0000ad50: 2020 2a2f 0a20 2020 2020 2020 2020 2020 */. │ │ │ │ -0000ad60: 2075 6e73 6967 6e65 6420 696e 7420 6279 unsigned int by │ │ │ │ -0000ad70: 7465 735f 7065 725f 7069 7865 6c3b 0a20 tes_per_pixel;. │ │ │ │ -0000ad80: 2020 2020 2020 2020 2020 202f 2a20 5069 /* Pi │ │ │ │ -0000ad90: 7463 6820 6f66 206f 6e65 2073 6361 6e6c tch of one scanl │ │ │ │ -0000ada0: 696e 652e 2020 486f 7720 6d61 6e79 2062 ine. How many b │ │ │ │ -0000adb0: 7974 6573 2074 6865 7265 2061 7265 2066 ytes there are f │ │ │ │ -0000adc0: 6f72 2073 6361 6e6c 696e 652e 2020 2a2f or scanline. */ │ │ │ │ -0000add0: 0a20 2020 2020 2020 2020 2020 2075 6e73 . uns │ │ │ │ -0000ade0: 6967 6e65 6420 696e 7420 7069 7463 683b igned int pitch; │ │ │ │ -0000adf0: 0a20 2020 2020 2020 2020 2020 202f 2a20 . /* │ │ │ │ -0000ae00: 496e 2069 6e64 6578 2063 6f6c 6f72 206d In index color m │ │ │ │ -0000ae10: 6f64 652c 206e 756d 6265 7220 6f66 2063 ode, number of c │ │ │ │ -0000ae20: 6f6c 6f72 732e 2020 496e 2052 4742 206d olors. In RGB m │ │ │ │ -0000ae30: 6f64 6520 7468 6973 2069 7320 3235 362e ode this is 256. │ │ │ │ -0000ae40: 2020 2a2f 0a20 2020 2020 2020 2020 2020 */. │ │ │ │ -0000ae50: 2075 6e73 6967 6e65 6420 696e 7420 6e75 unsigned int nu │ │ │ │ -0000ae60: 6d62 6572 5f6f 665f 636f 6c6f 7273 3b0a mber_of_colors;. │ │ │ │ -0000ae70: 2020 2020 2020 2020 2020 2020 2f2a 204f /* O │ │ │ │ -0000ae80: 7074 696d 697a 6174 696f 6e20 6869 6e74 ptimization hint │ │ │ │ -0000ae90: 2068 6f77 2062 696e 6172 7920 6461 7461 how binary data │ │ │ │ -0000aea0: 2069 7320 636f 6465 642e 2020 2a2f 0a20 is coded. */. │ │ │ │ -0000aeb0: 2020 2020 2020 2020 2020 2065 6e75 6d20 enum │ │ │ │ -0000aec0: 6772 7562 5f76 6964 656f 5f62 6c69 745f grub_video_blit_ │ │ │ │ -0000aed0: 666f 726d 6174 2062 6c69 745f 666f 726d format blit_form │ │ │ │ -0000aee0: 6174 3b0a 2020 2020 2020 2020 2020 2020 at;. │ │ │ │ -0000aef0: 2f2a 2048 6f77 206d 616e 7920 6269 7473 /* How many bits │ │ │ │ -0000af00: 2061 7265 2072 6573 6572 7665 6420 666f are reserved fo │ │ │ │ -0000af10: 7220 7265 6420 636f 6c6f 722e 2020 2a2f r red color. */ │ │ │ │ -0000af20: 0a20 2020 2020 2020 2020 2020 2075 6e73 . uns │ │ │ │ -0000af30: 6967 6e65 6420 696e 7420 7265 645f 6d61 igned int red_ma │ │ │ │ -0000af40: 736b 5f73 697a 653b 0a20 2020 2020 2020 sk_size;. │ │ │ │ -0000af50: 2020 2020 202f 2a20 5768 6174 2069 7320 /* What is │ │ │ │ -0000af60: 6c6f 6361 7469 6f6e 206f 6620 7265 6420 location of red │ │ │ │ -0000af70: 636f 6c6f 7220 6269 7473 2e20 2049 6e20 color bits. In │ │ │ │ -0000af80: 496e 6465 7820 436f 6c6f 7220 6d6f 6465 Index Color mode │ │ │ │ -0000af90: 2c20 7468 6973 2069 7320 302e 2020 2a2f , this is 0. */ │ │ │ │ -0000afa0: 0a20 2020 2020 2020 2020 2020 2075 6e73 . uns │ │ │ │ -0000afb0: 6967 6e65 6420 696e 7420 7265 645f 6669 igned int red_fi │ │ │ │ -0000afc0: 656c 645f 706f 733b 0a20 2020 2020 2020 eld_pos;. │ │ │ │ -0000afd0: 2020 2020 202f 2a20 486f 7720 6d61 6e79 /* How many │ │ │ │ -0000afe0: 2062 6974 7320 6172 6520 7265 7365 7276 bits are reserv │ │ │ │ -0000aff0: 6564 2066 6f72 2067 7265 656e 2063 6f6c ed for green col │ │ │ │ -0000b000: 6f72 2e20 202a 2f0a 2020 2020 2020 2020 or. */. │ │ │ │ -0000b010: 2020 2020 756e 7369 676e 6564 2069 6e74 unsigned int │ │ │ │ -0000b020: 2067 7265 656e 5f6d 6173 6b5f 7369 7a65 green_mask_size │ │ │ │ -0000b030: 3b0a 2020 2020 2020 2020 2020 2020 2f2a ;. /* │ │ │ │ -0000b040: 2057 6861 7420 6973 206c 6f63 6174 696f What is locatio │ │ │ │ -0000b050: 6e20 6f66 2067 7265 656e 2063 6f6c 6f72 n of green color │ │ │ │ -0000b060: 2062 6974 732e 2020 496e 2049 6e64 6578 bits. In Index │ │ │ │ -0000b070: 2043 6f6c 6f72 206d 6f64 652c 2074 6869 Color mode, thi │ │ │ │ -0000b080: 7320 6973 2030 2e20 202a 2f0a 2020 2020 s is 0. */. │ │ │ │ -0000b090: 2020 2020 2020 2020 756e 7369 676e 6564 unsigned │ │ │ │ -0000b0a0: 2069 6e74 2067 7265 656e 5f66 6965 6c64 int green_field │ │ │ │ -0000b0b0: 5f70 6f73 3b0a 2020 2020 2020 2020 2020 _pos;. │ │ │ │ -0000b0c0: 2020 2f2a 2048 6f77 206d 616e 7920 6269 /* How many bi │ │ │ │ -0000b0d0: 7473 2061 7265 2072 6573 6572 7665 6420 ts are reserved │ │ │ │ -0000b0e0: 666f 7220 626c 7565 2063 6f6c 6f72 2e20 for blue color. │ │ │ │ -0000b0f0: 202a 2f0a 2020 2020 2020 2020 2020 2020 */. │ │ │ │ -0000b100: 756e 7369 676e 6564 2069 6e74 2062 6c75 unsigned int blu │ │ │ │ -0000b110: 655f 6d61 736b 5f73 697a 653b 0a20 2020 e_mask_size;. │ │ │ │ -0000b120: 2020 2020 2020 2020 202f 2a20 5768 6174 /* What │ │ │ │ -0000b130: 2069 7320 6c6f 6361 7469 6f6e 206f 6620 is location of │ │ │ │ -0000b140: 626c 7565 2063 6f6c 6f72 2062 6974 732e blue color bits. │ │ │ │ -0000b150: 2020 496e 2049 6e64 6578 2043 6f6c 6f72 In Index Color │ │ │ │ -0000b160: 206d 6f64 652c 2074 6869 7320 6973 2030 mode, this is 0 │ │ │ │ -0000b170: 2e20 202a 2f0a 2020 2020 2020 2020 2020 . */. │ │ │ │ -0000b180: 2020 756e 7369 676e 6564 2069 6e74 2062 unsigned int b │ │ │ │ -0000b190: 6c75 655f 6669 656c 645f 706f 733b 0a20 lue_field_pos;. │ │ │ │ -0000b1a0: 2020 2020 2020 2020 2020 202f 2a20 486f /* Ho │ │ │ │ -0000b1b0: 7720 6d61 6e79 2062 6974 7320 6172 6520 w many bits are │ │ │ │ -0000b1c0: 7265 7365 7276 6564 2069 6e20 636f 6c6f reserved in colo │ │ │ │ -0000b1d0: 722e 2020 2a2f 0a20 2020 2020 2020 2020 r. */. │ │ │ │ -0000b1e0: 2020 2075 6e73 6967 6e65 6420 696e 7420 unsigned int │ │ │ │ -0000b1f0: 7265 7365 7276 6564 5f6d 6173 6b5f 7369 reserved_mask_si │ │ │ │ -0000b200: 7a65 3b0a 2020 2020 2020 2020 2020 2020 ze;. │ │ │ │ -0000b210: 2f2a 2057 6861 7420 6973 206c 6f63 6174 /* What is locat │ │ │ │ -0000b220: 696f 6e20 6f66 2072 6573 6572 7665 6420 ion of reserved │ │ │ │ -0000b230: 636f 6c6f 7220 6269 7473 2e20 2049 6e20 color bits. In │ │ │ │ -0000b240: 496e 6465 7820 436f 6c6f 7220 6d6f 6465 Index Color mode │ │ │ │ -0000b250: 2c0a 2020 2020 2020 2020 2020 2020 2020 ,. │ │ │ │ -0000b260: 2074 6869 7320 6973 2030 2e20 202a 2f0a this is 0. */. │ │ │ │ -0000b270: 2020 2020 2020 2020 2020 2020 756e 7369 unsi │ │ │ │ -0000b280: 676e 6564 2069 6e74 2072 6573 6572 7665 gned int reserve │ │ │ │ -0000b290: 645f 6669 656c 645f 706f 733b 0a20 2020 d_field_pos;. │ │ │ │ -0000b2a0: 2020 2020 2020 207d 3b0a 2020 202a 2044 };. * D │ │ │ │ -0000b2b0: 6573 6372 6970 7469 6f6e 3a0a 0a20 2020 escription:.. │ │ │ │ -0000b2c0: 2020 536f 6674 7761 7265 2064 6576 656c Software devel │ │ │ │ -0000b2d0: 6f70 6572 2063 616e 2075 7365 2074 6869 oper can use thi │ │ │ │ -0000b2e0: 7320 6675 6e63 7469 6f6e 2074 6f20 7175 s function to qu │ │ │ │ -0000b2f0: 6572 7920 7072 6f70 6572 7469 6573 206f ery properties o │ │ │ │ -0000b300: 660a 2020 2020 2061 6374 6976 6520 7265 f. active re │ │ │ │ -0000b310: 6e64 6572 696e 6720 7461 6765 742e 2020 ndering taget. │ │ │ │ -0000b320: 496e 666f 726d 6174 696f 6e20 7072 6f76 Information prov │ │ │ │ -0000b330: 6964 6564 2068 6572 6520 6361 6e20 6265 ided here can be │ │ │ │ -0000b340: 2075 7365 6420 6279 0a20 2020 2020 6f74 used by. ot │ │ │ │ -0000b350: 6865 7220 7061 7274 7320 6f66 2047 5255 her parts of GRU │ │ │ │ -0000b360: 422c 206c 696b 6520 696d 6167 6520 6c6f B, like image lo │ │ │ │ -0000b370: 6164 6572 7320 746f 2063 6f6e 7665 7274 aders to convert │ │ │ │ -0000b380: 206c 6f61 6465 6420 696d 6167 6573 2074 loaded images t │ │ │ │ -0000b390: 6f0a 2020 2020 2063 6f72 7265 6374 2073 o. correct s │ │ │ │ -0000b3a0: 6372 6565 6e20 666f 726d 6174 2074 6f20 creen format to │ │ │ │ -0000b3b0: 616c 6c6f 7720 6d6f 7265 206f 7074 696d allow more optim │ │ │ │ -0000b3c0: 697a 6564 2062 6c69 7474 6572 7320 746f ized blitters to │ │ │ │ -0000b3d0: 2062 6520 7573 6564 2e0a 2020 2020 2049 be used.. I │ │ │ │ -0000b3e0: 6620 7468 6572 6520 7468 6572 6520 6973 f there there is │ │ │ │ -0000b3f0: 206e 6f20 636f 6e66 6967 7572 6564 2076 no configured v │ │ │ │ -0000b400: 6964 656f 2064 7269 7665 7220 7769 7468 ideo driver with │ │ │ │ -0000b410: 2061 6374 6976 6520 7363 7265 656e 2c0a active screen,. │ │ │ │ -0000b420: 2020 2020 2065 7272 6f72 2027 4752 5542 error 'GRUB │ │ │ │ -0000b430: 5f45 5252 5f42 4144 5f44 4556 4943 4527 _ERR_BAD_DEVICE' │ │ │ │ -0000b440: 2069 7320 7265 7475 726e 6564 2c20 6f74 is returned, ot │ │ │ │ -0000b450: 6865 7277 6973 6520 276d 6f64 655f 696e herwise 'mode_in │ │ │ │ -0000b460: 666f 2720 6973 0a20 2020 2020 6669 6c6c fo' is. fill │ │ │ │ -0000b470: 6564 2077 6974 6820 7661 6c69 6420 696e ed with valid in │ │ │ │ -0000b480: 666f 726d 6174 696f 6e20 616e 6420 2747 formation and 'G │ │ │ │ -0000b490: 5255 425f 4552 525f 4e4f 4e45 2720 6973 RUB_ERR_NONE' is │ │ │ │ -0000b4a0: 2072 6574 7572 6e65 642e 0a0a 3130 2e31 returned...10.1 │ │ │ │ -0000b4b0: 2e34 2067 7275 625f 7669 6465 6f5f 6765 .4 grub_video_ge │ │ │ │ -0000b4c0: 745f 626c 6974 5f66 6f72 6d61 740a 2d2d t_blit_format.-- │ │ │ │ -0000b4d0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ -0000b4e0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a ---------------. │ │ │ │ -0000b4f0: 0a20 2020 2a20 5072 6f74 6f74 7970 653a . * Prototype: │ │ │ │ -0000b500: 0a0a 2020 2020 2020 2020 2020 656e 756d .. enum │ │ │ │ -0000b510: 2067 7275 625f 7669 6465 6f5f 626c 6974 grub_video_blit │ │ │ │ -0000b520: 5f66 6f72 6d61 740a 2020 2020 2020 2020 _format. │ │ │ │ -0000b530: 2020 6772 7562 5f76 6964 656f 5f67 6574 grub_video_get │ │ │ │ -0000b540: 5f62 6c69 745f 666f 726d 6174 2028 7374 _blit_format (st │ │ │ │ -0000b550: 7275 6374 2067 7275 625f 7669 6465 6f5f ruct grub_video_ │ │ │ │ -0000b560: 6d6f 6465 5f69 6e66 6f20 2a6d 6f64 655f mode_info *mode_ │ │ │ │ -0000b570: 696e 666f 293b 0a20 2020 2020 2020 2020 info);. │ │ │ │ -0000b580: 2065 6e75 6d20 6772 7562 5f76 6964 656f enum grub_video │ │ │ │ -0000b590: 5f62 6c69 745f 666f 726d 6174 0a20 2020 _blit_format. │ │ │ │ -0000b5a0: 2020 2020 2020 2020 207b 0a20 2020 2020 {. │ │ │ │ -0000b5b0: 2020 2020 2020 2020 202f 2a20 466f 6c6c /* Foll │ │ │ │ -0000b5c0: 6f77 2065 7861 6374 6c79 2066 6965 6c64 ow exactly field │ │ │ │ -0000b5d0: 2026 206d 6173 6b20 696e 666f 726d 6174 & mask informat │ │ │ │ -0000b5e0: 696f 6e2e 2020 2a2f 0a20 2020 2020 2020 ion. */. │ │ │ │ -0000b5f0: 2020 2020 2020 2047 5255 425f 5649 4445 GRUB_VIDE │ │ │ │ -0000b600: 4f5f 424c 4954 5f46 4f52 4d41 545f 5247 O_BLIT_FORMAT_RG │ │ │ │ -0000b610: 4241 2c0a 2020 2020 2020 2020 2020 2020 BA,. │ │ │ │ -0000b620: 2020 2f2a 204d 616b 6520 6f70 7469 6d69 /* Make optimi │ │ │ │ -0000b630: 7a61 7469 6f6e 2061 7373 756d 7074 696f zation assumptio │ │ │ │ -0000b640: 6e2e 2020 2a2f 0a20 2020 2020 2020 2020 n. */. │ │ │ │ -0000b650: 2020 2020 2047 5255 425f 5649 4445 4f5f GRUB_VIDEO_ │ │ │ │ -0000b660: 424c 4954 5f46 4f52 4d41 545f 5238 4738 BLIT_FORMAT_R8G8 │ │ │ │ -0000b670: 4238 4138 2c0a 2020 2020 2020 2020 2020 B8A8,. │ │ │ │ -0000b680: 2020 2020 2f2a 2046 6f6c 6c6f 7720 6578 /* Follow ex │ │ │ │ -0000b690: 6163 746c 7920 6669 656c 6420 2620 6d61 actly field & ma │ │ │ │ -0000b6a0: 736b 2069 6e66 6f72 6d61 7469 6f6e 2e20 sk information. │ │ │ │ -0000b6b0: 202a 2f0a 2020 2020 2020 2020 2020 2020 */. │ │ │ │ -0000b6c0: 2020 4752 5542 5f56 4944 454f 5f42 4c49 GRUB_VIDEO_BLI │ │ │ │ -0000b6d0: 545f 464f 524d 4154 5f52 4742 2c0a 2020 T_FORMAT_RGB,. │ │ │ │ -0000b6e0: 2020 2020 2020 2020 2020 2020 2f2a 204d /* M │ │ │ │ -0000b6f0: 616b 6520 6f70 7469 6d69 7a61 7469 6f6e ake optimization │ │ │ │ -0000b700: 2061 7373 756d 7074 696f 6e2e 2020 2a2f assumption. */ │ │ │ │ -0000b710: 0a20 2020 2020 2020 2020 2020 2020 2047 . G │ │ │ │ -0000b720: 5255 425f 5649 4445 4f5f 424c 4954 5f46 RUB_VIDEO_BLIT_F │ │ │ │ -0000b730: 4f52 4d41 545f 5238 4738 4238 2c0a 2020 ORMAT_R8G8B8,. │ │ │ │ -0000b740: 2020 2020 2020 2020 2020 2020 2f2a 2057 /* W │ │ │ │ -0000b750: 6865 6e20 6e65 6564 6564 2c20 6465 636f hen needed, deco │ │ │ │ -0000b760: 6465 2063 6f6c 6f72 206f 7220 6a75 7374 de color or just │ │ │ │ -0000b770: 2075 7365 2076 616c 7565 2061 7320 6973 use value as is │ │ │ │ -0000b780: 2e20 202a 2f0a 2020 2020 2020 2020 2020 . */. │ │ │ │ -0000b790: 2020 2020 4752 5542 5f56 4944 454f 5f42 GRUB_VIDEO_B │ │ │ │ -0000b7a0: 4c49 545f 464f 524d 4154 5f49 4e44 4558 LIT_FORMAT_INDEX │ │ │ │ -0000b7b0: 434f 4c4f 520a 2020 2020 2020 2020 2020 COLOR. │ │ │ │ -0000b7c0: 2020 7d3b 0a20 2020 2a20 4465 7363 7269 };. * Descri │ │ │ │ -0000b7d0: 7074 696f 6e3a 0a0a 2020 2020 2055 7365 ption:.. Use │ │ │ │ -0000b7e0: 6420 746f 2071 7565 7279 2068 6f77 2064 d to query how d │ │ │ │ -0000b7f0: 6174 6120 636f 756c 6420 6265 206f 7074 ata could be opt │ │ │ │ -0000b800: 696d 697a 6564 2074 6f20 7375 6974 2073 imized to suit s │ │ │ │ -0000b810: 7065 6369 6669 6564 2076 6964 656f 0a20 pecified video. │ │ │ │ -0000b820: 2020 2020 6d6f 6465 2e20 2052 6574 7572 mode. Retur │ │ │ │ -0000b830: 6e73 2065 7861 6374 2076 6964 656f 2066 ns exact video f │ │ │ │ -0000b840: 6f72 6d61 7420 7479 7065 2c20 6f72 2061 ormat type, or a │ │ │ │ -0000b850: 2067 656e 6572 6963 206f 6e65 2069 6620 generic one if │ │ │ │ -0000b860: 7468 6572 650a 2020 2020 2069 7320 6e6f there. is no │ │ │ │ -0000b870: 2064 6566 696e 6974 696f 6e20 666f 7220 definition for │ │ │ │ -0000b880: 7468 6520 7479 7065 2e20 2046 6f72 2067 the type. For g │ │ │ │ -0000b890: 656e 6572 6963 2066 6f72 6d61 7473 2c20 eneric formats, │ │ │ │ -0000b8a0: 7573 650a 2020 2020 2027 6772 7562 5f76 use. 'grub_v │ │ │ │ -0000b8b0: 6964 656f 5f67 6574 5f69 6e66 6f27 2074 ideo_get_info' t │ │ │ │ -0000b8c0: 6f20 7175 6572 7920 7669 6465 6f20 636f o query video co │ │ │ │ -0000b8d0: 6c6f 7220 636f 6469 6e67 2073 6574 7469 lor coding setti │ │ │ │ -0000b8e0: 6e67 732e 0a0a 3130 2e31 2e35 2067 7275 ngs...10.1.5 gru │ │ │ │ -0000b8f0: 625f 7669 6465 6f5f 7365 745f 7061 6c65 b_video_set_pale │ │ │ │ -0000b900: 7474 650a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d tte.------------ │ │ │ │ +00009fc0: 2020 2020 2020 2020 2020 2020 2062 6f6f boo │ │ │ │ +00009fd0: 7420 6c6f 6164 6572 0a3f 2020 2020 2020 t loader.? │ │ │ │ +00009fe0: 2020 2020 2030 7832 3030 3020 2d20 3120 0x2000 - 1 │ │ │ │ +00009ff0: 2020 2020 2020 2020 5265 616c 206d 6f64 Real mod │ │ │ │ +0000a000: 6520 7374 6163 6b0a 3078 3743 3030 2020 e stack.0x7C00 │ │ │ │ +0000a010: 2020 2020 3078 3744 3030 202d 2031 2020 0x7D00 - 1 │ │ │ │ +0000a020: 2020 2020 2020 2042 6f6f 7420 7365 6374 Boot sect │ │ │ │ +0000a030: 6f72 0a30 7838 3030 3020 2020 2020 203f or.0x8000 ? │ │ │ │ +0000a040: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +0000a050: 2020 4752 5542 206b 6572 6e65 6c0a 3078 GRUB kernel.0x │ │ │ │ +0000a060: 3638 3030 3020 2020 2020 3078 3731 3030 68000 0x7100 │ │ │ │ +0000a070: 3020 2d20 3120 2020 2020 2020 2044 6973 0 - 1 Dis │ │ │ │ +0000a080: 6b20 6275 6666 6572 0a3f 2020 2020 2020 k buffer.? │ │ │ │ +0000a090: 2020 2020 2030 7838 3030 3030 202d 2031 0x80000 - 1 │ │ │ │ +0000a0a0: 2020 2020 2020 2020 5072 6f74 6563 7465 Protecte │ │ │ │ +0000a0b0: 6420 6d6f 6465 2073 7461 636b 0a3f 2020 d mode stack.? │ │ │ │ +0000a0c0: 2020 2020 2020 2020 2030 7841 3030 3030 0xA0000 │ │ │ │ +0000a0d0: 202d 2031 2020 2020 2020 2020 4578 7465 - 1 Exte │ │ │ │ +0000a0e0: 6e64 6564 2042 494f 5320 4461 7461 2041 nded BIOS Data A │ │ │ │ +0000a0f0: 7265 610a 3078 4130 3030 3020 2020 2020 rea.0xA0000 │ │ │ │ +0000a100: 3078 4330 3030 3020 2d20 3120 2020 2020 0xC0000 - 1 │ │ │ │ +0000a110: 2020 2056 6964 656f 2052 414d 0a30 7843 Video RAM.0xC │ │ │ │ +0000a120: 3030 3030 2020 2020 2030 7831 3030 3030 0000 0x10000 │ │ │ │ +0000a130: 3020 2d20 3120 2020 2020 2020 4249 4f53 0 - 1 BIOS │ │ │ │ +0000a140: 0a30 7831 3030 3030 3020 2020 203f 2020 .0x100000 ? │ │ │ │ +0000a150: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +0000a160: 4865 6170 2061 6e64 206d 6f64 756c 6520 Heap and module │ │ │ │ +0000a170: 636f 6465 0a0a 1f0a 4669 6c65 3a20 6772 code....File: gr │ │ │ │ +0000a180: 7562 2d64 6576 2e69 6e66 6f2c 2020 4e6f ub-dev.info, No │ │ │ │ +0000a190: 6465 3a20 5669 6465 6f20 5375 6273 7973 de: Video Subsys │ │ │ │ +0000a1a0: 7465 6d2c 2020 4e65 7874 3a20 5046 4632 tem, Next: PFF2 │ │ │ │ +0000a1b0: 2046 6f6e 7420 4669 6c65 2046 6f72 6d61 Font File Forma │ │ │ │ +0000a1c0: 742c 2020 5072 6576 3a20 4249 4f53 2070 t, Prev: BIOS p │ │ │ │ +0000a1d0: 6f72 7420 6d65 6d6f 7279 206d 6170 2c20 ort memory map, │ │ │ │ +0000a1e0: 2055 703a 2054 6f70 0a0a 3130 2056 6964 Up: Top..10 Vid │ │ │ │ +0000a1f0: 656f 2053 7562 7379 7374 656d 0a2a 2a2a eo Subsystem.*** │ │ │ │ +0000a200: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a0a ***************. │ │ │ │ +0000a210: 0a54 6869 7320 646f 6375 6d65 6e74 2063 .This document c │ │ │ │ +0000a220: 6f6e 7461 696e 7320 7370 6563 6966 6963 ontains specific │ │ │ │ +0000a230: 6174 696f 6e20 666f 7220 5669 6465 6f20 ation for Video │ │ │ │ +0000a240: 5375 6273 7973 7465 6d20 666f 7220 4752 Subsystem for GR │ │ │ │ +0000a250: 5542 322e 0a43 7572 7265 6e74 6c79 206f UB2..Currently o │ │ │ │ +0000a260: 6e6c 7920 7468 6520 7573 6167 6520 696e nly the usage in │ │ │ │ +0000a270: 7465 7266 6163 6520 6973 2064 6573 6372 terface is descr │ │ │ │ +0000a280: 6962 6564 2069 6e20 7468 6973 2064 6f63 ibed in this doc │ │ │ │ +0000a290: 756d 656e 742e 0a49 6e74 6572 6e61 6c20 ument..Internal │ │ │ │ +0000a2a0: 7374 7275 6374 7572 6520 6f66 2068 6f77 structure of how │ │ │ │ +0000a2b0: 2076 6964 656f 2064 7269 7665 7273 2061 video drivers a │ │ │ │ +0000a2c0: 7265 2072 6567 6973 7465 7269 6e67 2061 re registering a │ │ │ │ +0000a2d0: 6e64 2068 6f77 2076 6964 656f 0a64 7269 nd how video.dri │ │ │ │ +0000a2e0: 7665 7220 6d61 6e61 6765 7220 776f 726b ver manager work │ │ │ │ +0000a2f0: 7320 6172 6520 6e6f 7420 696e 636c 7564 s are not includ │ │ │ │ +0000a300: 6564 2068 6572 652e 0a0a 2a20 4d65 6e75 ed here...* Menu │ │ │ │ +0000a310: 3a0a 0a2a 2056 6964 656f 2041 5049 3a3a :..* Video API:: │ │ │ │ +0000a320: 0a2a 2045 7861 6d70 6c65 2075 7361 6765 .* Example usage │ │ │ │ +0000a330: 206f 6620 5669 6465 6f20 4150 493a 3a0a of Video API::. │ │ │ │ +0000a340: 2a20 4269 746d 6170 2041 5049 3a3a 0a0a * Bitmap API::.. │ │ │ │ +0000a350: 1f0a 4669 6c65 3a20 6772 7562 2d64 6576 ..File: grub-dev │ │ │ │ +0000a360: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 5669 .info, Node: Vi │ │ │ │ +0000a370: 6465 6f20 4150 492c 2020 4e65 7874 3a20 deo API, Next: │ │ │ │ +0000a380: 4578 616d 706c 6520 7573 6167 6520 6f66 Example usage of │ │ │ │ +0000a390: 2056 6964 656f 2041 5049 2c20 2055 703a Video API, Up: │ │ │ │ +0000a3a0: 2056 6964 656f 2053 7562 7379 7374 656d Video Subsystem │ │ │ │ +0000a3b0: 0a0a 3130 2e31 2056 6964 656f 2041 5049 ..10.1 Video API │ │ │ │ +0000a3c0: 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a .==============. │ │ │ │ +0000a3d0: 0a31 302e 312e 3120 6772 7562 5f76 6964 .10.1.1 grub_vid │ │ │ │ +0000a3e0: 656f 5f73 6574 7570 0a2d 2d2d 2d2d 2d2d eo_setup.------- │ │ │ │ +0000a3f0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ +0000a400: 0a0a 2020 202a 2050 726f 746f 7479 7065 .. * Prototype │ │ │ │ +0000a410: 3a0a 2020 2020 2020 2020 2020 6772 7562 :. grub │ │ │ │ +0000a420: 5f65 7272 5f74 0a20 2020 2020 2020 2020 _err_t. │ │ │ │ +0000a430: 2067 7275 625f 7669 6465 6f5f 7365 7475 grub_video_setu │ │ │ │ +0000a440: 7020 2875 6e73 6967 6e65 6420 696e 7420 p (unsigned int │ │ │ │ +0000a450: 7769 6474 682c 2075 6e73 6967 6e65 6420 width, unsigned │ │ │ │ +0000a460: 696e 7420 6865 6967 6874 2c20 756e 7369 int height, unsi │ │ │ │ +0000a470: 676e 6564 2069 6e74 206d 6f64 655f 7479 gned int mode_ty │ │ │ │ +0000a480: 7065 293b 0a20 2020 2a20 4465 7363 7269 pe);. * Descri │ │ │ │ +0000a490: 7074 696f 6e3a 0a0a 2020 2020 2044 7269 ption:.. Dri │ │ │ │ +0000a4a0: 7665 7220 7769 6c6c 2075 7365 2069 6e66 ver will use inf │ │ │ │ +0000a4b0: 6f72 6d61 7469 6f6e 2070 726f 7669 6465 ormation provide │ │ │ │ +0000a4c0: 6420 746f 2069 7420 746f 2073 656c 6563 d to it to selec │ │ │ │ +0000a4d0: 7420 6265 7374 2070 6f73 7369 626c 650a t best possible. │ │ │ │ +0000a4e0: 2020 2020 2076 6964 656f 206d 6f64 6520 video mode │ │ │ │ +0000a4f0: 616e 6420 7377 6974 6368 2074 6f20 6974 and switch to it │ │ │ │ +0000a500: 2e20 2053 7570 706f 7274 6564 2076 616c . Supported val │ │ │ │ +0000a510: 7565 7320 666f 7220 276d 6f64 655f 7479 ues for 'mode_ty │ │ │ │ +0000a520: 7065 2720 6172 650a 2020 2020 2027 4752 pe' are. 'GR │ │ │ │ +0000a530: 5542 5f56 4944 454f 5f4d 4f44 455f 5459 UB_VIDEO_MODE_TY │ │ │ │ +0000a540: 5045 5f49 4e44 4558 5f43 4f4c 4f52 2720 PE_INDEX_COLOR' │ │ │ │ +0000a550: 666f 7220 696e 6465 7820 636f 6c6f 7220 for index color │ │ │ │ +0000a560: 6d6f 6465 732c 0a20 2020 2020 2747 5255 modes,. 'GRU │ │ │ │ +0000a570: 425f 5649 4445 4f5f 4d4f 4445 5f54 5950 B_VIDEO_MODE_TYP │ │ │ │ +0000a580: 455f 5247 4227 2066 6f72 2064 6972 6563 E_RGB' for direc │ │ │ │ +0000a590: 7420 5247 4220 636f 6c6f 7220 6d6f 6465 t RGB color mode │ │ │ │ +0000a5a0: 7320 616e 640a 2020 2020 2027 4752 5542 s and. 'GRUB │ │ │ │ +0000a5b0: 5f56 4944 454f 5f4d 4f44 455f 5459 5045 _VIDEO_MODE_TYPE │ │ │ │ +0000a5c0: 5f44 4f55 424c 455f 4255 4646 4552 4544 _DOUBLE_BUFFERED │ │ │ │ +0000a5d0: 2720 666f 7220 646f 7562 6c65 2062 7566 ' for double buf │ │ │ │ +0000a5e0: 6665 7269 6e67 2e20 2057 6865 6e0a 2020 fering. When. │ │ │ │ +0000a5f0: 2020 2072 6571 7565 7374 696e 6720 5247 requesting RG │ │ │ │ +0000a600: 4220 6d6f 6465 2c20 6869 6768 6573 7420 B mode, highest │ │ │ │ +0000a610: 6269 7473 2070 6572 2070 6978 656c 206d bits per pixel m │ │ │ │ +0000a620: 6f64 6520 7769 6c6c 2062 6520 7365 6c65 ode will be sele │ │ │ │ +0000a630: 6374 6564 2e0a 2020 2020 2057 6865 6e20 cted.. When │ │ │ │ +0000a640: 7265 7175 6573 7469 6e67 2049 6e64 6578 requesting Index │ │ │ │ +0000a650: 2063 6f6c 6f72 206d 6f64 652c 206d 6f64 color mode, mod │ │ │ │ +0000a660: 6520 7769 7468 2068 6967 6865 7374 206e e with highest n │ │ │ │ +0000a670: 756d 6265 7220 6f66 0a20 2020 2020 636f umber of. co │ │ │ │ +0000a680: 6c6f 7273 2077 696c 6c20 6265 2073 656c lors will be sel │ │ │ │ +0000a690: 6563 7465 642e 2020 4966 2061 6c6c 2070 ected. If all p │ │ │ │ +0000a6a0: 6172 616d 6574 6572 7320 6172 6520 7370 arameters are sp │ │ │ │ +0000a6b0: 6563 6966 6965 6420 6173 207a 6572 6f2c ecified as zero, │ │ │ │ +0000a6c0: 0a20 2020 2020 7669 6465 6f20 6164 6170 . video adap │ │ │ │ +0000a6d0: 7465 7220 7769 6c6c 2074 7279 2074 6f20 ter will try to │ │ │ │ +0000a6e0: 6669 6775 7265 206f 7574 2062 6573 7420 figure out best │ │ │ │ +0000a6f0: 706f 7373 6962 6c65 206d 6f64 6520 616e possible mode an │ │ │ │ +0000a700: 640a 2020 2020 2069 6e69 7469 616c 697a d. initializ │ │ │ │ +0000a710: 6520 6974 2c20 706c 6174 666f 726d 2073 e it, platform s │ │ │ │ +0000a720: 7065 6369 6669 6320 6469 6666 6572 656e pecific differen │ │ │ │ +0000a730: 6365 7320 6172 6520 616c 6c6f 7765 6420 ces are allowed │ │ │ │ +0000a740: 6865 7265 2e20 2049 660a 2020 2020 2074 here. If. t │ │ │ │ +0000a750: 6865 7265 2069 7320 6e6f 206d 6f64 6520 here is no mode │ │ │ │ +0000a760: 6d61 7463 6869 6e67 2072 6571 7565 7374 matching request │ │ │ │ +0000a770: 2c20 6572 726f 7220 5820 7769 6c6c 2062 , error X will b │ │ │ │ +0000a780: 6520 7265 7475 726e 6564 2e20 2049 660a e returned. If. │ │ │ │ +0000a790: 2020 2020 2074 6865 7265 2061 7265 206e there are n │ │ │ │ +0000a7a0: 6f20 7072 6f62 6c65 6d73 2c20 6675 6e63 o problems, func │ │ │ │ +0000a7b0: 7469 6f6e 2072 6574 7572 6e73 2027 4752 tion returns 'GR │ │ │ │ +0000a7c0: 5542 5f45 5252 5f4e 4f4e 4527 2e0a 0a20 UB_ERR_NONE'... │ │ │ │ +0000a7d0: 2020 2020 5468 6973 2066 756e 6374 696f This functio │ │ │ │ +0000a7e0: 6e20 616c 736f 2070 6572 666f 726d 7320 n also performs │ │ │ │ +0000a7f0: 666f 6c6c 6f77 696e 6720 7461 736b 2075 following task u │ │ │ │ +0000a800: 706f 6e20 7375 6363 6573 6675 6c20 6d6f pon succesful mo │ │ │ │ +0000a810: 6465 0a20 2020 2020 7377 6974 6368 2e20 de. switch. │ │ │ │ +0000a820: 2041 6374 6976 6520 7265 6e64 6572 696e Active renderin │ │ │ │ +0000a830: 6720 7461 7267 6574 2069 7320 6368 616e g target is chan │ │ │ │ +0000a840: 6765 6420 746f 2073 6372 6565 6e20 616e ged to screen an │ │ │ │ +0000a850: 6420 7669 6577 706f 7274 0a20 2020 2020 d viewport. │ │ │ │ +0000a860: 6973 206d 6178 696d 697a 6564 2074 6f20 is maximized to │ │ │ │ +0000a870: 616c 6c6f 7720 7768 6f6c 6520 7363 7265 allow whole scre │ │ │ │ +0000a880: 656e 2074 6f20 6265 2075 7365 6420 7768 en to be used wh │ │ │ │ +0000a890: 656e 2070 6572 666f 726d 696e 670a 2020 en performing. │ │ │ │ +0000a8a0: 2020 2067 7261 7068 6963 7320 6f70 6572 graphics oper │ │ │ │ +0000a8b0: 6174 696f 6e73 2e20 2049 6e20 5247 4220 ations. In RGB │ │ │ │ +0000a8c0: 6d6f 6465 732c 2065 6d75 6c61 7465 6420 modes, emulated │ │ │ │ +0000a8d0: 7061 6c65 7474 6520 6765 7473 2031 360a palette gets 16. │ │ │ │ +0000a8e0: 2020 2020 2065 6e74 7269 6573 2063 6f6e entries con │ │ │ │ +0000a8f0: 7461 696e 696e 6720 6465 6661 756c 7420 taining default │ │ │ │ +0000a900: 7661 6c75 6573 2066 6f72 2056 4741 2070 values for VGA p │ │ │ │ +0000a910: 616c 6574 7465 2c20 6f74 6865 7220 636f alette, other co │ │ │ │ +0000a920: 6c6f 7273 2061 7265 0a20 2020 2020 6465 lors are. de │ │ │ │ +0000a930: 6669 6e65 6420 6173 2062 6c61 636b 2e20 fined as black. │ │ │ │ +0000a940: 2057 6865 6e20 7377 6974 6368 696e 6720 When switching │ │ │ │ +0000a950: 746f 2049 6e64 6578 6564 2043 6f6c 6f72 to Indexed Color │ │ │ │ +0000a960: 206d 6f64 652c 2064 7269 7665 7220 6d61 mode, driver ma │ │ │ │ +0000a970: 790a 2020 2020 2073 6574 2064 6566 6175 y. set defau │ │ │ │ +0000a980: 6c74 2056 4741 2070 616c 6574 7465 2074 lt VGA palette t │ │ │ │ +0000a990: 6f20 7363 7265 656e 2069 6620 7468 6520 o screen if the │ │ │ │ +0000a9a0: 7669 6465 6f20 6361 7264 2061 6c6c 6f77 video card allow │ │ │ │ +0000a9b0: 7320 7468 650a 2020 2020 206f 7065 7261 s the. opera │ │ │ │ +0000a9c0: 7469 6f6e 2e0a 0a31 302e 312e 3220 6772 tion...10.1.2 gr │ │ │ │ +0000a9d0: 7562 5f76 6964 656f 5f72 6573 746f 7265 ub_video_restore │ │ │ │ +0000a9e0: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d .--------------- │ │ │ │ +0000a9f0: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 2020 202a ----------.. * │ │ │ │ +0000aa00: 2050 726f 746f 7479 7065 3a0a 0a20 2020 Prototype:.. │ │ │ │ +0000aa10: 2020 2020 2020 2067 7275 625f 6572 725f grub_err_ │ │ │ │ +0000aa20: 740a 2020 2020 2020 2020 2020 6772 7562 t. grub │ │ │ │ +0000aa30: 5f76 6964 656f 5f72 6573 746f 7265 2028 _video_restore ( │ │ │ │ +0000aa40: 766f 6964 293b 0a20 2020 2a20 4465 7363 void);. * Desc │ │ │ │ +0000aa50: 7269 7074 696f 6e3a 0a0a 2020 2020 2056 ription:.. V │ │ │ │ +0000aa60: 6964 656f 2073 7562 7379 7374 656d 2077 ideo subsystem w │ │ │ │ +0000aa70: 696c 6c20 6465 696e 6974 6961 6c69 7a65 ill deinitialize │ │ │ │ +0000aa80: 2061 6374 6976 6174 6564 2076 6964 656f activated video │ │ │ │ +0000aa90: 2064 7269 7665 7220 746f 2072 6573 746f driver to resto │ │ │ │ +0000aaa0: 7265 0a20 2020 2020 6f6c 6420 7374 6174 re. old stat │ │ │ │ +0000aab0: 6520 6f66 2076 6964 656f 2064 6576 6963 e of video devic │ │ │ │ +0000aac0: 652e 2020 5468 6973 2063 616e 2062 6520 e. This can be │ │ │ │ +0000aad0: 7573 6564 2074 6f20 7377 6974 6368 2062 used to switch b │ │ │ │ +0000aae0: 6163 6b20 746f 2074 6578 740a 2020 2020 ack to text. │ │ │ │ +0000aaf0: 206d 6f64 652e 0a0a 3130 2e31 2e33 2067 mode...10.1.3 g │ │ │ │ +0000ab00: 7275 625f 7669 6465 6f5f 6765 745f 696e rub_video_get_in │ │ │ │ +0000ab10: 666f 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d fo.------------- │ │ │ │ +0000ab20: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 -------------.. │ │ │ │ +0000ab30: 2020 2a20 5072 6f74 6f74 7970 653a 0a0a * Prototype:.. │ │ │ │ +0000ab40: 2020 2020 2020 2020 2020 6772 7562 5f65 grub_e │ │ │ │ +0000ab50: 7272 5f74 0a20 2020 2020 2020 2020 2067 rr_t. g │ │ │ │ +0000ab60: 7275 625f 7669 6465 6f5f 6765 745f 696e rub_video_get_in │ │ │ │ +0000ab70: 666f 2028 7374 7275 6374 2067 7275 625f fo (struct grub_ │ │ │ │ +0000ab80: 7669 6465 6f5f 6d6f 6465 5f69 6e66 6f20 video_mode_info │ │ │ │ +0000ab90: 2a6d 6f64 655f 696e 666f 293b 0a20 2020 *mode_info);. │ │ │ │ +0000aba0: 2020 2020 2020 2073 7472 7563 7420 6772 struct gr │ │ │ │ +0000abb0: 7562 5f76 6964 656f 5f6d 6f64 655f 696e ub_video_mode_in │ │ │ │ +0000abc0: 666f 0a20 2020 2020 2020 2020 207b 0a20 fo. {. │ │ │ │ +0000abd0: 2020 2020 2020 2020 2020 202f 2a20 5769 /* Wi │ │ │ │ +0000abe0: 6474 6820 6f66 2074 6865 2073 6372 6565 dth of the scree │ │ │ │ +0000abf0: 6e2e 2020 2a2f 0a20 2020 2020 2020 2020 n. */. │ │ │ │ +0000ac00: 2020 2075 6e73 6967 6e65 6420 696e 7420 unsigned int │ │ │ │ +0000ac10: 7769 6474 683b 0a20 2020 2020 2020 2020 width;. │ │ │ │ +0000ac20: 2020 202f 2a20 4865 6967 6874 206f 6620 /* Height of │ │ │ │ +0000ac30: 7468 6520 7363 7265 656e 2e20 202a 2f0a the screen. */. │ │ │ │ +0000ac40: 2020 2020 2020 2020 2020 2020 756e 7369 unsi │ │ │ │ +0000ac50: 676e 6564 2069 6e74 2068 6569 6768 743b gned int height; │ │ │ │ +0000ac60: 0a20 2020 2020 2020 2020 2020 202f 2a20 . /* │ │ │ │ +0000ac70: 4d6f 6465 2074 7970 6520 6269 746d 6173 Mode type bitmas │ │ │ │ +0000ac80: 6b2e 2020 436f 6e74 6169 6e73 2069 6e66 k. Contains inf │ │ │ │ +0000ac90: 6f72 6d61 7469 6f6e 206c 696b 6520 6973 ormation like is │ │ │ │ +0000aca0: 2069 7420 496e 6465 7820 636f 6c6f 7220 it Index color │ │ │ │ +0000acb0: 6f72 0a20 2020 2020 2020 2020 2020 2020 or. │ │ │ │ +0000acc0: 2020 5247 4220 6d6f 6465 2e20 202a 2f0a RGB mode. */. │ │ │ │ +0000acd0: 2020 2020 2020 2020 2020 2020 756e 7369 unsi │ │ │ │ +0000ace0: 676e 6564 2069 6e74 206d 6f64 655f 7479 gned int mode_ty │ │ │ │ +0000acf0: 7065 3b0a 2020 2020 2020 2020 2020 2020 pe;. │ │ │ │ +0000ad00: 2f2a 2042 6974 7320 7065 7220 7069 7865 /* Bits per pixe │ │ │ │ +0000ad10: 6c2e 2020 2a2f 0a20 2020 2020 2020 2020 l. */. │ │ │ │ +0000ad20: 2020 2075 6e73 6967 6e65 6420 696e 7420 unsigned int │ │ │ │ +0000ad30: 6270 703b 0a20 2020 2020 2020 2020 2020 bpp;. │ │ │ │ +0000ad40: 202f 2a20 4279 7465 7320 7065 7220 7069 /* Bytes per pi │ │ │ │ +0000ad50: 7865 6c2e 2020 2a2f 0a20 2020 2020 2020 xel. */. │ │ │ │ +0000ad60: 2020 2020 2075 6e73 6967 6e65 6420 696e unsigned in │ │ │ │ +0000ad70: 7420 6279 7465 735f 7065 725f 7069 7865 t bytes_per_pixe │ │ │ │ +0000ad80: 6c3b 0a20 2020 2020 2020 2020 2020 202f l;. / │ │ │ │ +0000ad90: 2a20 5069 7463 6820 6f66 206f 6e65 2073 * Pitch of one s │ │ │ │ +0000ada0: 6361 6e6c 696e 652e 2020 486f 7720 6d61 canline. How ma │ │ │ │ +0000adb0: 6e79 2062 7974 6573 2074 6865 7265 2061 ny bytes there a │ │ │ │ +0000adc0: 7265 2066 6f72 2073 6361 6e6c 696e 652e re for scanline. │ │ │ │ +0000add0: 2020 2a2f 0a20 2020 2020 2020 2020 2020 */. │ │ │ │ +0000ade0: 2075 6e73 6967 6e65 6420 696e 7420 7069 unsigned int pi │ │ │ │ +0000adf0: 7463 683b 0a20 2020 2020 2020 2020 2020 tch;. │ │ │ │ +0000ae00: 202f 2a20 496e 2069 6e64 6578 2063 6f6c /* In index col │ │ │ │ +0000ae10: 6f72 206d 6f64 652c 206e 756d 6265 7220 or mode, number │ │ │ │ +0000ae20: 6f66 2063 6f6c 6f72 732e 2020 496e 2052 of colors. In R │ │ │ │ +0000ae30: 4742 206d 6f64 6520 7468 6973 2069 7320 GB mode this is │ │ │ │ +0000ae40: 3235 362e 2020 2a2f 0a20 2020 2020 2020 256. */. │ │ │ │ +0000ae50: 2020 2020 2075 6e73 6967 6e65 6420 696e unsigned in │ │ │ │ +0000ae60: 7420 6e75 6d62 6572 5f6f 665f 636f 6c6f t number_of_colo │ │ │ │ +0000ae70: 7273 3b0a 2020 2020 2020 2020 2020 2020 rs;. │ │ │ │ +0000ae80: 2f2a 204f 7074 696d 697a 6174 696f 6e20 /* Optimization │ │ │ │ +0000ae90: 6869 6e74 2068 6f77 2062 696e 6172 7920 hint how binary │ │ │ │ +0000aea0: 6461 7461 2069 7320 636f 6465 642e 2020 data is coded. │ │ │ │ +0000aeb0: 2a2f 0a20 2020 2020 2020 2020 2020 2065 */. e │ │ │ │ +0000aec0: 6e75 6d20 6772 7562 5f76 6964 656f 5f62 num grub_video_b │ │ │ │ +0000aed0: 6c69 745f 666f 726d 6174 2062 6c69 745f lit_format blit_ │ │ │ │ +0000aee0: 666f 726d 6174 3b0a 2020 2020 2020 2020 format;. │ │ │ │ +0000aef0: 2020 2020 2f2a 2048 6f77 206d 616e 7920 /* How many │ │ │ │ +0000af00: 6269 7473 2061 7265 2072 6573 6572 7665 bits are reserve │ │ │ │ +0000af10: 6420 666f 7220 7265 6420 636f 6c6f 722e d for red color. │ │ │ │ +0000af20: 2020 2a2f 0a20 2020 2020 2020 2020 2020 */. │ │ │ │ +0000af30: 2075 6e73 6967 6e65 6420 696e 7420 7265 unsigned int re │ │ │ │ +0000af40: 645f 6d61 736b 5f73 697a 653b 0a20 2020 d_mask_size;. │ │ │ │ +0000af50: 2020 2020 2020 2020 202f 2a20 5768 6174 /* What │ │ │ │ +0000af60: 2069 7320 6c6f 6361 7469 6f6e 206f 6620 is location of │ │ │ │ +0000af70: 7265 6420 636f 6c6f 7220 6269 7473 2e20 red color bits. │ │ │ │ +0000af80: 2049 6e20 496e 6465 7820 436f 6c6f 7220 In Index Color │ │ │ │ +0000af90: 6d6f 6465 2c20 7468 6973 2069 7320 302e mode, this is 0. │ │ │ │ +0000afa0: 2020 2a2f 0a20 2020 2020 2020 2020 2020 */. │ │ │ │ +0000afb0: 2075 6e73 6967 6e65 6420 696e 7420 7265 unsigned int re │ │ │ │ +0000afc0: 645f 6669 656c 645f 706f 733b 0a20 2020 d_field_pos;. │ │ │ │ +0000afd0: 2020 2020 2020 2020 202f 2a20 486f 7720 /* How │ │ │ │ +0000afe0: 6d61 6e79 2062 6974 7320 6172 6520 7265 many bits are re │ │ │ │ +0000aff0: 7365 7276 6564 2066 6f72 2067 7265 656e served for green │ │ │ │ +0000b000: 2063 6f6c 6f72 2e20 202a 2f0a 2020 2020 color. */. │ │ │ │ +0000b010: 2020 2020 2020 2020 756e 7369 676e 6564 unsigned │ │ │ │ +0000b020: 2069 6e74 2067 7265 656e 5f6d 6173 6b5f int green_mask_ │ │ │ │ +0000b030: 7369 7a65 3b0a 2020 2020 2020 2020 2020 size;. │ │ │ │ +0000b040: 2020 2f2a 2057 6861 7420 6973 206c 6f63 /* What is loc │ │ │ │ +0000b050: 6174 696f 6e20 6f66 2067 7265 656e 2063 ation of green c │ │ │ │ +0000b060: 6f6c 6f72 2062 6974 732e 2020 496e 2049 olor bits. In I │ │ │ │ +0000b070: 6e64 6578 2043 6f6c 6f72 206d 6f64 652c ndex Color mode, │ │ │ │ +0000b080: 2074 6869 7320 6973 2030 2e20 202a 2f0a this is 0. */. │ │ │ │ +0000b090: 2020 2020 2020 2020 2020 2020 756e 7369 unsi │ │ │ │ +0000b0a0: 676e 6564 2069 6e74 2067 7265 656e 5f66 gned int green_f │ │ │ │ +0000b0b0: 6965 6c64 5f70 6f73 3b0a 2020 2020 2020 ield_pos;. │ │ │ │ +0000b0c0: 2020 2020 2020 2f2a 2048 6f77 206d 616e /* How man │ │ │ │ +0000b0d0: 7920 6269 7473 2061 7265 2072 6573 6572 y bits are reser │ │ │ │ +0000b0e0: 7665 6420 666f 7220 626c 7565 2063 6f6c ved for blue col │ │ │ │ +0000b0f0: 6f72 2e20 202a 2f0a 2020 2020 2020 2020 or. */. │ │ │ │ +0000b100: 2020 2020 756e 7369 676e 6564 2069 6e74 unsigned int │ │ │ │ +0000b110: 2062 6c75 655f 6d61 736b 5f73 697a 653b blue_mask_size; │ │ │ │ +0000b120: 0a20 2020 2020 2020 2020 2020 202f 2a20 . /* │ │ │ │ +0000b130: 5768 6174 2069 7320 6c6f 6361 7469 6f6e What is location │ │ │ │ +0000b140: 206f 6620 626c 7565 2063 6f6c 6f72 2062 of blue color b │ │ │ │ +0000b150: 6974 732e 2020 496e 2049 6e64 6578 2043 its. In Index C │ │ │ │ +0000b160: 6f6c 6f72 206d 6f64 652c 2074 6869 7320 olor mode, this │ │ │ │ +0000b170: 6973 2030 2e20 202a 2f0a 2020 2020 2020 is 0. */. │ │ │ │ +0000b180: 2020 2020 2020 756e 7369 676e 6564 2069 unsigned i │ │ │ │ +0000b190: 6e74 2062 6c75 655f 6669 656c 645f 706f nt blue_field_po │ │ │ │ +0000b1a0: 733b 0a20 2020 2020 2020 2020 2020 202f s;. / │ │ │ │ +0000b1b0: 2a20 486f 7720 6d61 6e79 2062 6974 7320 * How many bits │ │ │ │ +0000b1c0: 6172 6520 7265 7365 7276 6564 2069 6e20 are reserved in │ │ │ │ +0000b1d0: 636f 6c6f 722e 2020 2a2f 0a20 2020 2020 color. */. │ │ │ │ +0000b1e0: 2020 2020 2020 2075 6e73 6967 6e65 6420 unsigned │ │ │ │ +0000b1f0: 696e 7420 7265 7365 7276 6564 5f6d 6173 int reserved_mas │ │ │ │ +0000b200: 6b5f 7369 7a65 3b0a 2020 2020 2020 2020 k_size;. │ │ │ │ +0000b210: 2020 2020 2f2a 2057 6861 7420 6973 206c /* What is l │ │ │ │ +0000b220: 6f63 6174 696f 6e20 6f66 2072 6573 6572 ocation of reser │ │ │ │ +0000b230: 7665 6420 636f 6c6f 7220 6269 7473 2e20 ved color bits. │ │ │ │ +0000b240: 2049 6e20 496e 6465 7820 436f 6c6f 7220 In Index Color │ │ │ │ +0000b250: 6d6f 6465 2c0a 2020 2020 2020 2020 2020 mode,. │ │ │ │ +0000b260: 2020 2020 2074 6869 7320 6973 2030 2e20 this is 0. │ │ │ │ +0000b270: 202a 2f0a 2020 2020 2020 2020 2020 2020 */. │ │ │ │ +0000b280: 756e 7369 676e 6564 2069 6e74 2072 6573 unsigned int res │ │ │ │ +0000b290: 6572 7665 645f 6669 656c 645f 706f 733b erved_field_pos; │ │ │ │ +0000b2a0: 0a20 2020 2020 2020 2020 207d 3b0a 2020 . };. │ │ │ │ +0000b2b0: 202a 2044 6573 6372 6970 7469 6f6e 3a0a * Description:. │ │ │ │ +0000b2c0: 0a20 2020 2020 536f 6674 7761 7265 2064 . Software d │ │ │ │ +0000b2d0: 6576 656c 6f70 6572 2063 616e 2075 7365 eveloper can use │ │ │ │ +0000b2e0: 2074 6869 7320 6675 6e63 7469 6f6e 2074 this function t │ │ │ │ +0000b2f0: 6f20 7175 6572 7920 7072 6f70 6572 7469 o query properti │ │ │ │ +0000b300: 6573 206f 660a 2020 2020 2061 6374 6976 es of. activ │ │ │ │ +0000b310: 6520 7265 6e64 6572 696e 6720 7461 6765 e rendering tage │ │ │ │ +0000b320: 742e 2020 496e 666f 726d 6174 696f 6e20 t. Information │ │ │ │ +0000b330: 7072 6f76 6964 6564 2068 6572 6520 6361 provided here ca │ │ │ │ +0000b340: 6e20 6265 2075 7365 6420 6279 0a20 2020 n be used by. │ │ │ │ +0000b350: 2020 6f74 6865 7220 7061 7274 7320 6f66 other parts of │ │ │ │ +0000b360: 2047 5255 422c 206c 696b 6520 696d 6167 GRUB, like imag │ │ │ │ +0000b370: 6520 6c6f 6164 6572 7320 746f 2063 6f6e e loaders to con │ │ │ │ +0000b380: 7665 7274 206c 6f61 6465 6420 696d 6167 vert loaded imag │ │ │ │ +0000b390: 6573 2074 6f0a 2020 2020 2063 6f72 7265 es to. corre │ │ │ │ +0000b3a0: 6374 2073 6372 6565 6e20 666f 726d 6174 ct screen format │ │ │ │ +0000b3b0: 2074 6f20 616c 6c6f 7720 6d6f 7265 206f to allow more o │ │ │ │ +0000b3c0: 7074 696d 697a 6564 2062 6c69 7474 6572 ptimized blitter │ │ │ │ +0000b3d0: 7320 746f 2062 6520 7573 6564 2e0a 2020 s to be used.. │ │ │ │ +0000b3e0: 2020 2049 6620 7468 6572 6520 7468 6572 If there ther │ │ │ │ +0000b3f0: 6520 6973 206e 6f20 636f 6e66 6967 7572 e is no configur │ │ │ │ +0000b400: 6564 2076 6964 656f 2064 7269 7665 7220 ed video driver │ │ │ │ +0000b410: 7769 7468 2061 6374 6976 6520 7363 7265 with active scre │ │ │ │ +0000b420: 656e 2c0a 2020 2020 2065 7272 6f72 2027 en,. error ' │ │ │ │ +0000b430: 4752 5542 5f45 5252 5f42 4144 5f44 4556 GRUB_ERR_BAD_DEV │ │ │ │ +0000b440: 4943 4527 2069 7320 7265 7475 726e 6564 ICE' is returned │ │ │ │ +0000b450: 2c20 6f74 6865 7277 6973 6520 276d 6f64 , otherwise 'mod │ │ │ │ +0000b460: 655f 696e 666f 2720 6973 0a20 2020 2020 e_info' is. │ │ │ │ +0000b470: 6669 6c6c 6564 2077 6974 6820 7661 6c69 filled with vali │ │ │ │ +0000b480: 6420 696e 666f 726d 6174 696f 6e20 616e d information an │ │ │ │ +0000b490: 6420 2747 5255 425f 4552 525f 4e4f 4e45 d 'GRUB_ERR_NONE │ │ │ │ +0000b4a0: 2720 6973 2072 6574 7572 6e65 642e 0a0a ' is returned... │ │ │ │ +0000b4b0: 3130 2e31 2e34 2067 7275 625f 7669 6465 10.1.4 grub_vide │ │ │ │ +0000b4c0: 6f5f 6765 745f 626c 6974 5f66 6f72 6d61 o_get_blit_forma │ │ │ │ +0000b4d0: 740a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d t.-------------- │ │ │ │ +0000b4e0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ +0000b4f0: 2d2d 2d0a 0a20 2020 2a20 5072 6f74 6f74 ---.. * Protot │ │ │ │ +0000b500: 7970 653a 0a0a 2020 2020 2020 2020 2020 ype:.. │ │ │ │ +0000b510: 656e 756d 2067 7275 625f 7669 6465 6f5f enum grub_video_ │ │ │ │ +0000b520: 626c 6974 5f66 6f72 6d61 740a 2020 2020 blit_format. │ │ │ │ +0000b530: 2020 2020 2020 6772 7562 5f76 6964 656f grub_video │ │ │ │ +0000b540: 5f67 6574 5f62 6c69 745f 666f 726d 6174 _get_blit_format │ │ │ │ +0000b550: 2028 7374 7275 6374 2067 7275 625f 7669 (struct grub_vi │ │ │ │ +0000b560: 6465 6f5f 6d6f 6465 5f69 6e66 6f20 2a6d deo_mode_info *m │ │ │ │ +0000b570: 6f64 655f 696e 666f 293b 0a20 2020 2020 ode_info);. │ │ │ │ +0000b580: 2020 2020 2065 6e75 6d20 6772 7562 5f76 enum grub_v │ │ │ │ +0000b590: 6964 656f 5f62 6c69 745f 666f 726d 6174 ideo_blit_format │ │ │ │ +0000b5a0: 0a20 2020 2020 2020 2020 2020 207b 0a20 . {. │ │ │ │ +0000b5b0: 2020 2020 2020 2020 2020 2020 202f 2a20 /* │ │ │ │ +0000b5c0: 466f 6c6c 6f77 2065 7861 6374 6c79 2066 Follow exactly f │ │ │ │ +0000b5d0: 6965 6c64 2026 206d 6173 6b20 696e 666f ield & mask info │ │ │ │ +0000b5e0: 726d 6174 696f 6e2e 2020 2a2f 0a20 2020 rmation. */. │ │ │ │ +0000b5f0: 2020 2020 2020 2020 2020 2047 5255 425f GRUB_ │ │ │ │ +0000b600: 5649 4445 4f5f 424c 4954 5f46 4f52 4d41 VIDEO_BLIT_FORMA │ │ │ │ +0000b610: 545f 5247 4241 2c0a 2020 2020 2020 2020 T_RGBA,. │ │ │ │ +0000b620: 2020 2020 2020 2f2a 204d 616b 6520 6f70 /* Make op │ │ │ │ +0000b630: 7469 6d69 7a61 7469 6f6e 2061 7373 756d timization assum │ │ │ │ +0000b640: 7074 696f 6e2e 2020 2a2f 0a20 2020 2020 ption. */. │ │ │ │ +0000b650: 2020 2020 2020 2020 2047 5255 425f 5649 GRUB_VI │ │ │ │ +0000b660: 4445 4f5f 424c 4954 5f46 4f52 4d41 545f DEO_BLIT_FORMAT_ │ │ │ │ +0000b670: 5238 4738 4238 4138 2c0a 2020 2020 2020 R8G8B8A8,. │ │ │ │ +0000b680: 2020 2020 2020 2020 2f2a 2046 6f6c 6c6f /* Follo │ │ │ │ +0000b690: 7720 6578 6163 746c 7920 6669 656c 6420 w exactly field │ │ │ │ +0000b6a0: 2620 6d61 736b 2069 6e66 6f72 6d61 7469 & mask informati │ │ │ │ +0000b6b0: 6f6e 2e20 202a 2f0a 2020 2020 2020 2020 on. */. │ │ │ │ +0000b6c0: 2020 2020 2020 4752 5542 5f56 4944 454f GRUB_VIDEO │ │ │ │ +0000b6d0: 5f42 4c49 545f 464f 524d 4154 5f52 4742 _BLIT_FORMAT_RGB │ │ │ │ +0000b6e0: 2c0a 2020 2020 2020 2020 2020 2020 2020 ,. │ │ │ │ +0000b6f0: 2f2a 204d 616b 6520 6f70 7469 6d69 7a61 /* Make optimiza │ │ │ │ +0000b700: 7469 6f6e 2061 7373 756d 7074 696f 6e2e tion assumption. │ │ │ │ +0000b710: 2020 2a2f 0a20 2020 2020 2020 2020 2020 */. │ │ │ │ +0000b720: 2020 2047 5255 425f 5649 4445 4f5f 424c GRUB_VIDEO_BL │ │ │ │ +0000b730: 4954 5f46 4f52 4d41 545f 5238 4738 4238 IT_FORMAT_R8G8B8 │ │ │ │ +0000b740: 2c0a 2020 2020 2020 2020 2020 2020 2020 ,. │ │ │ │ +0000b750: 2f2a 2057 6865 6e20 6e65 6564 6564 2c20 /* When needed, │ │ │ │ +0000b760: 6465 636f 6465 2063 6f6c 6f72 206f 7220 decode color or │ │ │ │ +0000b770: 6a75 7374 2075 7365 2076 616c 7565 2061 just use value a │ │ │ │ +0000b780: 7320 6973 2e20 202a 2f0a 2020 2020 2020 s is. */. │ │ │ │ +0000b790: 2020 2020 2020 2020 4752 5542 5f56 4944 GRUB_VID │ │ │ │ +0000b7a0: 454f 5f42 4c49 545f 464f 524d 4154 5f49 EO_BLIT_FORMAT_I │ │ │ │ +0000b7b0: 4e44 4558 434f 4c4f 520a 2020 2020 2020 NDEXCOLOR. │ │ │ │ +0000b7c0: 2020 2020 2020 7d3b 0a20 2020 2a20 4465 };. * De │ │ │ │ +0000b7d0: 7363 7269 7074 696f 6e3a 0a0a 2020 2020 scription:.. │ │ │ │ +0000b7e0: 2055 7365 6420 746f 2071 7565 7279 2068 Used to query h │ │ │ │ +0000b7f0: 6f77 2064 6174 6120 636f 756c 6420 6265 ow data could be │ │ │ │ +0000b800: 206f 7074 696d 697a 6564 2074 6f20 7375 optimized to su │ │ │ │ +0000b810: 6974 2073 7065 6369 6669 6564 2076 6964 it specified vid │ │ │ │ +0000b820: 656f 0a20 2020 2020 6d6f 6465 2e20 2052 eo. mode. R │ │ │ │ +0000b830: 6574 7572 6e73 2065 7861 6374 2076 6964 eturns exact vid │ │ │ │ +0000b840: 656f 2066 6f72 6d61 7420 7479 7065 2c20 eo format type, │ │ │ │ +0000b850: 6f72 2061 2067 656e 6572 6963 206f 6e65 or a generic one │ │ │ │ +0000b860: 2069 6620 7468 6572 650a 2020 2020 2069 if there. i │ │ │ │ +0000b870: 7320 6e6f 2064 6566 696e 6974 696f 6e20 s no definition │ │ │ │ +0000b880: 666f 7220 7468 6520 7479 7065 2e20 2046 for the type. F │ │ │ │ +0000b890: 6f72 2067 656e 6572 6963 2066 6f72 6d61 or generic forma │ │ │ │ +0000b8a0: 7473 2c20 7573 650a 2020 2020 2027 6772 ts, use. 'gr │ │ │ │ +0000b8b0: 7562 5f76 6964 656f 5f67 6574 5f69 6e66 ub_video_get_inf │ │ │ │ +0000b8c0: 6f27 2074 6f20 7175 6572 7920 7669 6465 o' to query vide │ │ │ │ +0000b8d0: 6f20 636f 6c6f 7220 636f 6469 6e67 2073 o color coding s │ │ │ │ +0000b8e0: 6574 7469 6e67 732e 0a0a 3130 2e31 2e35 ettings...10.1.5 │ │ │ │ +0000b8f0: 2067 7275 625f 7669 6465 6f5f 7365 745f grub_video_set_ │ │ │ │ +0000b900: 7061 6c65 7474 650a 2d2d 2d2d 2d2d 2d2d palette.-------- │ │ │ │ 0000b910: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ -0000b920: 2d0a 0a20 2020 2a20 5072 6f74 6f74 7970 -.. * Prototyp │ │ │ │ -0000b930: 653a 0a0a 2020 2020 2020 2020 2020 6772 e:.. gr │ │ │ │ -0000b940: 7562 5f65 7272 5f74 0a20 2020 2020 2020 ub_err_t. │ │ │ │ -0000b950: 2020 2067 7275 625f 7669 6465 6f5f 7365 grub_video_se │ │ │ │ -0000b960: 745f 7061 6c65 7474 6520 2875 6e73 6967 t_palette (unsig │ │ │ │ -0000b970: 6e65 6420 696e 7420 7374 6172 742c 2075 ned int start, u │ │ │ │ -0000b980: 6e73 6967 6e65 6420 696e 7420 636f 756e nsigned int coun │ │ │ │ -0000b990: 742c 2073 7472 7563 7420 6772 7562 5f76 t, struct grub_v │ │ │ │ -0000b9a0: 6964 656f 5f70 616c 6574 7465 5f64 6174 ideo_palette_dat │ │ │ │ -0000b9b0: 6120 2a70 616c 6574 7465 5f64 6174 6129 a *palette_data) │ │ │ │ -0000b9c0: 3b0a 2020 2020 2020 2020 2020 7374 7275 ;. stru │ │ │ │ -0000b9d0: 6374 2067 7275 625f 7669 6465 6f5f 7061 ct grub_video_pa │ │ │ │ -0000b9e0: 6c65 7474 655f 6461 7461 0a20 2020 2020 lette_data. │ │ │ │ -0000b9f0: 2020 2020 207b 0a20 2020 2020 2020 2020 {. │ │ │ │ -0000ba00: 2020 2020 2067 7275 625f 7569 6e74 385f grub_uint8_ │ │ │ │ -0000ba10: 7420 723b 202f 2a20 5265 6420 636f 6c6f t r; /* Red colo │ │ │ │ -0000ba20: 7220 7661 6c75 6520 2830 2d32 3535 292e r value (0-255). │ │ │ │ -0000ba30: 202a 2f0a 2020 2020 2020 2020 2020 2020 */. │ │ │ │ -0000ba40: 2020 6772 7562 5f75 696e 7438 5f74 2067 grub_uint8_t g │ │ │ │ -0000ba50: 3b20 2f2a 2047 7265 656e 2063 6f6c 6f72 ; /* Green color │ │ │ │ -0000ba60: 2076 616c 7565 2028 302d 3235 3529 2e20 value (0-255). │ │ │ │ -0000ba70: 2a2f 0a20 2020 2020 2020 2020 2020 2020 */. │ │ │ │ -0000ba80: 2067 7275 625f 7569 6e74 385f 7420 623b grub_uint8_t b; │ │ │ │ -0000ba90: 202f 2a20 426c 7565 2063 6f6c 6f72 2076 /* Blue color v │ │ │ │ -0000baa0: 616c 7565 2028 302d 3235 3529 2e20 2a2f alue (0-255). */ │ │ │ │ -0000bab0: 0a20 2020 2020 2020 2020 2020 2020 2067 . g │ │ │ │ -0000bac0: 7275 625f 7569 6e74 385f 7420 613b 202f rub_uint8_t a; / │ │ │ │ -0000bad0: 2a20 5265 7365 7276 6564 2062 6974 7320 * Reserved bits │ │ │ │ -0000bae0: 7661 6c75 6520 2830 2d32 3535 292e 202a value (0-255). * │ │ │ │ -0000baf0: 2f0a 2020 2020 2020 2020 2020 7d3b 0a20 /. };. │ │ │ │ -0000bb00: 2020 2a20 4465 7363 7269 7074 696f 6e3a * Description: │ │ │ │ -0000bb10: 0a0a 2020 2020 2055 7365 6420 746f 2073 .. Used to s │ │ │ │ -0000bb20: 6574 7570 2069 6e64 6578 6564 2063 6f6c etup indexed col │ │ │ │ -0000bb30: 6f72 2070 616c 6574 7465 732e 2020 4966 or palettes. If │ │ │ │ -0000bb40: 206d 6f64 6520 6973 2052 4742 206d 6f64 mode is RGB mod │ │ │ │ -0000bb50: 652c 2063 6f6c 6f72 730a 2020 2020 2077 e, colors. w │ │ │ │ -0000bb60: 696c 6c20 6265 2073 6574 2074 6f20 656d ill be set to em │ │ │ │ -0000bb70: 756c 6174 6564 2070 616c 6574 7465 2064 ulated palette d │ │ │ │ -0000bb80: 6174 612e 2020 496e 2049 6e64 6578 6564 ata. In Indexed │ │ │ │ -0000bb90: 2043 6f6c 6f72 206d 6f64 6573 2c0a 2020 Color modes,. │ │ │ │ -0000bba0: 2020 2070 616c 6574 7465 7320 7769 6c6c palettes will │ │ │ │ -0000bbb0: 2062 6520 7365 7420 746f 2068 6172 6477 be set to hardw │ │ │ │ -0000bbc0: 6172 652e 2020 436f 6c6f 7220 7661 6c75 are. Color valu │ │ │ │ -0000bbd0: 6573 2077 696c 6c20 6265 2063 6f6e 7665 es will be conve │ │ │ │ -0000bbe0: 7274 6564 0a20 2020 2020 746f 2073 7569 rted. to sui │ │ │ │ -0000bbf0: 7420 7265 7175 6972 656d 656e 7473 206f t requirements o │ │ │ │ -0000bc00: 6620 7468 6520 7669 6465 6f20 6d6f 6465 f the video mode │ │ │ │ -0000bc10: 2e20 2027 7374 6172 7427 2077 696c 6c20 . 'start' will │ │ │ │ -0000bc20: 7465 6c6c 2077 6861 740a 2020 2020 2068 tell what. h │ │ │ │ -0000bc30: 6172 6477 6172 6520 636f 6c6f 7220 696e ardware color in │ │ │ │ -0000bc40: 6465 7820 286f 7220 656d 756c 6174 6564 dex (or emulated │ │ │ │ -0000bc50: 2063 6f6c 6f72 2069 6e64 6578 2920 7769 color index) wi │ │ │ │ -0000bc60: 6c6c 2062 6520 7365 7420 746f 0a20 2020 ll be set to. │ │ │ │ -0000bc70: 2020 6163 636f 7264 696e 6720 696e 666f according info │ │ │ │ -0000bc80: 726d 6174 696f 6e20 696e 2066 6972 7374 rmation in first │ │ │ │ -0000bc90: 2069 6e64 6963 6520 6f66 2027 7061 6c65 indice of 'pale │ │ │ │ -0000bca0: 7474 655f 6461 7461 272c 2061 6674 6572 tte_data', after │ │ │ │ -0000bcb0: 2074 6861 740a 2020 2020 2062 6f74 6820 that. both │ │ │ │ -0000bcc0: 6861 7264 7761 7265 2063 6f6c 6f72 2069 hardware color i │ │ │ │ -0000bcd0: 6e64 6578 2061 6e64 2027 7061 6c65 7474 ndex and 'palett │ │ │ │ -0000bce0: 655f 6461 7461 2720 696e 6465 7820 7769 e_data' index wi │ │ │ │ -0000bcf0: 6c6c 2062 650a 2020 2020 2069 6e63 7265 ll be. incre │ │ │ │ -0000bd00: 6d65 6e74 6564 2075 6e74 696c 2027 636f mented until 'co │ │ │ │ -0000bd10: 756e 7427 206e 756d 6265 7220 6f66 2063 unt' number of c │ │ │ │ -0000bd20: 6f6c 6f72 7320 6861 7665 2062 6565 6e20 olors have been │ │ │ │ -0000bd30: 7365 742e 0a0a 3130 2e31 2e36 2067 7275 set...10.1.6 gru │ │ │ │ -0000bd40: 625f 7669 6465 6f5f 6765 745f 7061 6c65 b_video_get_pale │ │ │ │ -0000bd50: 7474 650a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d tte.------------ │ │ │ │ +0000b920: 2d2d 2d2d 2d0a 0a20 2020 2a20 5072 6f74 -----.. * Prot │ │ │ │ +0000b930: 6f74 7970 653a 0a0a 2020 2020 2020 2020 otype:.. │ │ │ │ +0000b940: 2020 6772 7562 5f65 7272 5f74 0a20 2020 grub_err_t. │ │ │ │ +0000b950: 2020 2020 2020 2067 7275 625f 7669 6465 grub_vide │ │ │ │ +0000b960: 6f5f 7365 745f 7061 6c65 7474 6520 2875 o_set_palette (u │ │ │ │ +0000b970: 6e73 6967 6e65 6420 696e 7420 7374 6172 nsigned int star │ │ │ │ +0000b980: 742c 2075 6e73 6967 6e65 6420 696e 7420 t, unsigned int │ │ │ │ +0000b990: 636f 756e 742c 2073 7472 7563 7420 6772 count, struct gr │ │ │ │ +0000b9a0: 7562 5f76 6964 656f 5f70 616c 6574 7465 ub_video_palette │ │ │ │ +0000b9b0: 5f64 6174 6120 2a70 616c 6574 7465 5f64 _data *palette_d │ │ │ │ +0000b9c0: 6174 6129 3b0a 2020 2020 2020 2020 2020 ata);. │ │ │ │ +0000b9d0: 7374 7275 6374 2067 7275 625f 7669 6465 struct grub_vide │ │ │ │ +0000b9e0: 6f5f 7061 6c65 7474 655f 6461 7461 0a20 o_palette_data. │ │ │ │ +0000b9f0: 2020 2020 2020 2020 207b 0a20 2020 2020 {. │ │ │ │ +0000ba00: 2020 2020 2020 2020 2067 7275 625f 7569 grub_ui │ │ │ │ +0000ba10: 6e74 385f 7420 723b 202f 2a20 5265 6420 nt8_t r; /* Red │ │ │ │ +0000ba20: 636f 6c6f 7220 7661 6c75 6520 2830 2d32 color value (0-2 │ │ │ │ +0000ba30: 3535 292e 202a 2f0a 2020 2020 2020 2020 55). */. │ │ │ │ +0000ba40: 2020 2020 2020 6772 7562 5f75 696e 7438 grub_uint8 │ │ │ │ +0000ba50: 5f74 2067 3b20 2f2a 2047 7265 656e 2063 _t g; /* Green c │ │ │ │ +0000ba60: 6f6c 6f72 2076 616c 7565 2028 302d 3235 olor value (0-25 │ │ │ │ +0000ba70: 3529 2e20 2a2f 0a20 2020 2020 2020 2020 5). */. │ │ │ │ +0000ba80: 2020 2020 2067 7275 625f 7569 6e74 385f grub_uint8_ │ │ │ │ +0000ba90: 7420 623b 202f 2a20 426c 7565 2063 6f6c t b; /* Blue col │ │ │ │ +0000baa0: 6f72 2076 616c 7565 2028 302d 3235 3529 or value (0-255) │ │ │ │ +0000bab0: 2e20 2a2f 0a20 2020 2020 2020 2020 2020 . */. │ │ │ │ +0000bac0: 2020 2067 7275 625f 7569 6e74 385f 7420 grub_uint8_t │ │ │ │ +0000bad0: 613b 202f 2a20 5265 7365 7276 6564 2062 a; /* Reserved b │ │ │ │ +0000bae0: 6974 7320 7661 6c75 6520 2830 2d32 3535 its value (0-255 │ │ │ │ +0000baf0: 292e 202a 2f0a 2020 2020 2020 2020 2020 ). */. │ │ │ │ +0000bb00: 7d3b 0a20 2020 2a20 4465 7363 7269 7074 };. * Descript │ │ │ │ +0000bb10: 696f 6e3a 0a0a 2020 2020 2055 7365 6420 ion:.. Used │ │ │ │ +0000bb20: 746f 2073 6574 7570 2069 6e64 6578 6564 to setup indexed │ │ │ │ +0000bb30: 2063 6f6c 6f72 2070 616c 6574 7465 732e color palettes. │ │ │ │ +0000bb40: 2020 4966 206d 6f64 6520 6973 2052 4742 If mode is RGB │ │ │ │ +0000bb50: 206d 6f64 652c 2063 6f6c 6f72 730a 2020 mode, colors. │ │ │ │ +0000bb60: 2020 2077 696c 6c20 6265 2073 6574 2074 will be set t │ │ │ │ +0000bb70: 6f20 656d 756c 6174 6564 2070 616c 6574 o emulated palet │ │ │ │ +0000bb80: 7465 2064 6174 612e 2020 496e 2049 6e64 te data. In Ind │ │ │ │ +0000bb90: 6578 6564 2043 6f6c 6f72 206d 6f64 6573 exed Color modes │ │ │ │ +0000bba0: 2c0a 2020 2020 2070 616c 6574 7465 7320 ,. palettes │ │ │ │ +0000bbb0: 7769 6c6c 2062 6520 7365 7420 746f 2068 will be set to h │ │ │ │ +0000bbc0: 6172 6477 6172 652e 2020 436f 6c6f 7220 ardware. Color │ │ │ │ +0000bbd0: 7661 6c75 6573 2077 696c 6c20 6265 2063 values will be c │ │ │ │ +0000bbe0: 6f6e 7665 7274 6564 0a20 2020 2020 746f onverted. to │ │ │ │ +0000bbf0: 2073 7569 7420 7265 7175 6972 656d 656e suit requiremen │ │ │ │ +0000bc00: 7473 206f 6620 7468 6520 7669 6465 6f20 ts of the video │ │ │ │ +0000bc10: 6d6f 6465 2e20 2027 7374 6172 7427 2077 mode. 'start' w │ │ │ │ +0000bc20: 696c 6c20 7465 6c6c 2077 6861 740a 2020 ill tell what. │ │ │ │ +0000bc30: 2020 2068 6172 6477 6172 6520 636f 6c6f hardware colo │ │ │ │ +0000bc40: 7220 696e 6465 7820 286f 7220 656d 756c r index (or emul │ │ │ │ +0000bc50: 6174 6564 2063 6f6c 6f72 2069 6e64 6578 ated color index │ │ │ │ +0000bc60: 2920 7769 6c6c 2062 6520 7365 7420 746f ) will be set to │ │ │ │ +0000bc70: 0a20 2020 2020 6163 636f 7264 696e 6720 . according │ │ │ │ +0000bc80: 696e 666f 726d 6174 696f 6e20 696e 2066 information in f │ │ │ │ +0000bc90: 6972 7374 2069 6e64 6963 6520 6f66 2027 irst indice of ' │ │ │ │ +0000bca0: 7061 6c65 7474 655f 6461 7461 272c 2061 palette_data', a │ │ │ │ +0000bcb0: 6674 6572 2074 6861 740a 2020 2020 2062 fter that. b │ │ │ │ +0000bcc0: 6f74 6820 6861 7264 7761 7265 2063 6f6c oth hardware col │ │ │ │ +0000bcd0: 6f72 2069 6e64 6578 2061 6e64 2027 7061 or index and 'pa │ │ │ │ +0000bce0: 6c65 7474 655f 6461 7461 2720 696e 6465 lette_data' inde │ │ │ │ +0000bcf0: 7820 7769 6c6c 2062 650a 2020 2020 2069 x will be. i │ │ │ │ +0000bd00: 6e63 7265 6d65 6e74 6564 2075 6e74 696c ncremented until │ │ │ │ +0000bd10: 2027 636f 756e 7427 206e 756d 6265 7220 'count' number │ │ │ │ +0000bd20: 6f66 2063 6f6c 6f72 7320 6861 7665 2062 of colors have b │ │ │ │ +0000bd30: 6565 6e20 7365 742e 0a0a 3130 2e31 2e36 een set...10.1.6 │ │ │ │ +0000bd40: 2067 7275 625f 7669 6465 6f5f 6765 745f grub_video_get_ │ │ │ │ +0000bd50: 7061 6c65 7474 650a 2d2d 2d2d 2d2d 2d2d palette.-------- │ │ │ │ 0000bd60: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ -0000bd70: 2d0a 0a20 2020 2a20 5072 6f74 6f74 7970 -.. * Prototyp │ │ │ │ -0000bd80: 653a 0a0a 2020 2020 2020 2020 2020 6772 e:.. gr │ │ │ │ -0000bd90: 7562 5f65 7272 5f74 0a20 2020 2020 2020 ub_err_t. │ │ │ │ -0000bda0: 2020 2067 7275 625f 7669 6465 6f5f 6765 grub_video_ge │ │ │ │ -0000bdb0: 745f 7061 6c65 7474 6520 2875 6e73 6967 t_palette (unsig │ │ │ │ -0000bdc0: 6e65 6420 696e 7420 7374 6172 742c 2075 ned int start, u │ │ │ │ -0000bdd0: 6e73 6967 6e65 6420 696e 7420 636f 756e nsigned int coun │ │ │ │ -0000bde0: 742c 2073 7472 7563 7420 6772 7562 5f76 t, struct grub_v │ │ │ │ -0000bdf0: 6964 656f 5f70 616c 6574 7465 5f64 6174 ideo_palette_dat │ │ │ │ -0000be00: 6120 2a70 616c 6574 7465 5f64 6174 6129 a *palette_data) │ │ │ │ -0000be10: 3b0a 2020 2020 2020 2020 2020 7374 7275 ;. stru │ │ │ │ -0000be20: 6374 2067 7275 625f 7669 6465 6f5f 7061 ct grub_video_pa │ │ │ │ -0000be30: 6c65 7474 655f 6461 7461 0a20 2020 2020 lette_data. │ │ │ │ -0000be40: 2020 2020 207b 0a20 2020 2020 2020 2020 {. │ │ │ │ -0000be50: 2020 2020 2067 7275 625f 7569 6e74 385f grub_uint8_ │ │ │ │ -0000be60: 7420 723b 202f 2a20 5265 6420 636f 6c6f t r; /* Red colo │ │ │ │ -0000be70: 7220 7661 6c75 6520 2830 2d32 3535 292e r value (0-255). │ │ │ │ -0000be80: 202a 2f0a 2020 2020 2020 2020 2020 2020 */. │ │ │ │ -0000be90: 2020 6772 7562 5f75 696e 7438 5f74 2067 grub_uint8_t g │ │ │ │ -0000bea0: 3b20 2f2a 2047 7265 656e 2063 6f6c 6f72 ; /* Green color │ │ │ │ -0000beb0: 2076 616c 7565 2028 302d 3235 3529 2e20 value (0-255). │ │ │ │ -0000bec0: 2a2f 0a20 2020 2020 2020 2020 2020 2020 */. │ │ │ │ -0000bed0: 2067 7275 625f 7569 6e74 385f 7420 623b grub_uint8_t b; │ │ │ │ -0000bee0: 202f 2a20 426c 7565 2063 6f6c 6f72 2076 /* Blue color v │ │ │ │ -0000bef0: 616c 7565 2028 302d 3235 3529 2e20 2a2f alue (0-255). */ │ │ │ │ -0000bf00: 0a20 2020 2020 2020 2020 2020 2020 2067 . g │ │ │ │ -0000bf10: 7275 625f 7569 6e74 385f 7420 613b 202f rub_uint8_t a; / │ │ │ │ -0000bf20: 2a20 5265 7365 7276 6564 2062 6974 7320 * Reserved bits │ │ │ │ -0000bf30: 7661 6c75 6520 2830 2d32 3535 292e 202a value (0-255). * │ │ │ │ -0000bf40: 2f0a 2020 2020 2020 2020 2020 7d3b 0a20 /. };. │ │ │ │ -0000bf50: 2020 2a20 4465 7363 7269 7074 696f 6e3a * Description: │ │ │ │ -0000bf60: 0a0a 2020 2020 2055 7365 6420 746f 2071 .. Used to q │ │ │ │ -0000bf70: 7565 7279 2069 6e64 6578 6564 2063 6f6c uery indexed col │ │ │ │ -0000bf80: 6f72 2070 616c 6574 7465 732e 2020 4966 or palettes. If │ │ │ │ -0000bf90: 206d 6f64 6520 6973 2052 4742 206d 6f64 mode is RGB mod │ │ │ │ -0000bfa0: 652c 2063 6f6c 6f72 730a 2020 2020 2077 e, colors. w │ │ │ │ -0000bfb0: 696c 6c20 6265 2063 6f70 6965 6420 6672 ill be copied fr │ │ │ │ -0000bfc0: 6f6d 2065 6d75 6c61 7465 6420 7061 6c65 om emulated pale │ │ │ │ -0000bfd0: 7474 6520 6461 7461 2e20 2049 6e20 496e tte data. In In │ │ │ │ -0000bfe0: 6465 7865 6420 436f 6c6f 7220 6d6f 6465 dexed Color mode │ │ │ │ -0000bff0: 732c 0a20 2020 2020 7061 6c65 7474 6573 s,. palettes │ │ │ │ -0000c000: 2077 696c 6c20 6265 2072 6561 6420 6672 will be read fr │ │ │ │ -0000c010: 6f6d 2068 6172 6477 6172 652e 2020 436f om hardware. Co │ │ │ │ -0000c020: 6c6f 7220 7661 6c75 6573 2077 696c 6c20 lor values will │ │ │ │ -0000c030: 6265 0a20 2020 2020 636f 6e76 6572 7465 be. converte │ │ │ │ -0000c040: 6420 746f 2073 7569 7420 7374 7275 6374 d to suit struct │ │ │ │ -0000c050: 7572 6520 666f 726d 6174 2e20 2027 7374 ure format. 'st │ │ │ │ -0000c060: 6172 7427 2077 696c 6c20 7465 6c6c 2077 art' will tell w │ │ │ │ -0000c070: 6861 740a 2020 2020 2068 6172 6477 6172 hat. hardwar │ │ │ │ -0000c080: 6520 636f 6c6f 7220 696e 6465 7820 286f e color index (o │ │ │ │ -0000c090: 7220 656d 756c 6174 6564 2063 6f6c 6f72 r emulated color │ │ │ │ -0000c0a0: 2069 6e64 6578 2920 7769 6c6c 2062 6520 index) will be │ │ │ │ -0000c0b0: 7573 6564 2061 7320 610a 2020 2020 2073 used as a. s │ │ │ │ -0000c0c0: 6f75 7263 6520 666f 7220 6669 7273 7420 ource for first │ │ │ │ -0000c0d0: 696e 6469 6365 206f 6620 2770 616c 6574 indice of 'palet │ │ │ │ -0000c0e0: 7465 5f64 6174 6127 2c20 6166 7465 7220 te_data', after │ │ │ │ -0000c0f0: 7468 6174 2062 6f74 6820 6861 7264 7761 that both hardwa │ │ │ │ -0000c100: 7265 0a20 2020 2020 636f 6c6f 7220 696e re. color in │ │ │ │ -0000c110: 6465 7820 616e 6420 2770 616c 6574 7465 dex and 'palette │ │ │ │ -0000c120: 5f64 6174 6127 2069 6e64 6578 2077 696c _data' index wil │ │ │ │ -0000c130: 6c20 6265 2069 6e63 7265 6d65 6e74 6564 l be incremented │ │ │ │ -0000c140: 2075 6e74 696c 0a20 2020 2020 2763 6f75 until. 'cou │ │ │ │ -0000c150: 6e74 2720 6e75 6d62 6572 206f 6620 636f nt' number of co │ │ │ │ -0000c160: 6c6f 7273 2068 6176 6520 6265 656e 2072 lors have been r │ │ │ │ -0000c170: 6561 642e 0a0a 3130 2e31 2e37 2067 7275 ead...10.1.7 gru │ │ │ │ -0000c180: 625f 7669 6465 6f5f 7365 745f 6172 6561 b_video_set_area │ │ │ │ -0000c190: 5f73 7461 7475 730a 2d2d 2d2d 2d2d 2d2d _status.-------- │ │ │ │ +0000bd70: 2d2d 2d2d 2d0a 0a20 2020 2a20 5072 6f74 -----.. * Prot │ │ │ │ +0000bd80: 6f74 7970 653a 0a0a 2020 2020 2020 2020 otype:.. │ │ │ │ +0000bd90: 2020 6772 7562 5f65 7272 5f74 0a20 2020 grub_err_t. │ │ │ │ +0000bda0: 2020 2020 2020 2067 7275 625f 7669 6465 grub_vide │ │ │ │ +0000bdb0: 6f5f 6765 745f 7061 6c65 7474 6520 2875 o_get_palette (u │ │ │ │ +0000bdc0: 6e73 6967 6e65 6420 696e 7420 7374 6172 nsigned int star │ │ │ │ +0000bdd0: 742c 2075 6e73 6967 6e65 6420 696e 7420 t, unsigned int │ │ │ │ +0000bde0: 636f 756e 742c 2073 7472 7563 7420 6772 count, struct gr │ │ │ │ +0000bdf0: 7562 5f76 6964 656f 5f70 616c 6574 7465 ub_video_palette │ │ │ │ +0000be00: 5f64 6174 6120 2a70 616c 6574 7465 5f64 _data *palette_d │ │ │ │ +0000be10: 6174 6129 3b0a 2020 2020 2020 2020 2020 ata);. │ │ │ │ +0000be20: 7374 7275 6374 2067 7275 625f 7669 6465 struct grub_vide │ │ │ │ +0000be30: 6f5f 7061 6c65 7474 655f 6461 7461 0a20 o_palette_data. │ │ │ │ +0000be40: 2020 2020 2020 2020 207b 0a20 2020 2020 {. │ │ │ │ +0000be50: 2020 2020 2020 2020 2067 7275 625f 7569 grub_ui │ │ │ │ +0000be60: 6e74 385f 7420 723b 202f 2a20 5265 6420 nt8_t r; /* Red │ │ │ │ +0000be70: 636f 6c6f 7220 7661 6c75 6520 2830 2d32 color value (0-2 │ │ │ │ +0000be80: 3535 292e 202a 2f0a 2020 2020 2020 2020 55). */. │ │ │ │ +0000be90: 2020 2020 2020 6772 7562 5f75 696e 7438 grub_uint8 │ │ │ │ +0000bea0: 5f74 2067 3b20 2f2a 2047 7265 656e 2063 _t g; /* Green c │ │ │ │ +0000beb0: 6f6c 6f72 2076 616c 7565 2028 302d 3235 olor value (0-25 │ │ │ │ +0000bec0: 3529 2e20 2a2f 0a20 2020 2020 2020 2020 5). */. │ │ │ │ +0000bed0: 2020 2020 2067 7275 625f 7569 6e74 385f grub_uint8_ │ │ │ │ +0000bee0: 7420 623b 202f 2a20 426c 7565 2063 6f6c t b; /* Blue col │ │ │ │ +0000bef0: 6f72 2076 616c 7565 2028 302d 3235 3529 or value (0-255) │ │ │ │ +0000bf00: 2e20 2a2f 0a20 2020 2020 2020 2020 2020 . */. │ │ │ │ +0000bf10: 2020 2067 7275 625f 7569 6e74 385f 7420 grub_uint8_t │ │ │ │ +0000bf20: 613b 202f 2a20 5265 7365 7276 6564 2062 a; /* Reserved b │ │ │ │ +0000bf30: 6974 7320 7661 6c75 6520 2830 2d32 3535 its value (0-255 │ │ │ │ +0000bf40: 292e 202a 2f0a 2020 2020 2020 2020 2020 ). */. │ │ │ │ +0000bf50: 7d3b 0a20 2020 2a20 4465 7363 7269 7074 };. * Descript │ │ │ │ +0000bf60: 696f 6e3a 0a0a 2020 2020 2055 7365 6420 ion:.. Used │ │ │ │ +0000bf70: 746f 2071 7565 7279 2069 6e64 6578 6564 to query indexed │ │ │ │ +0000bf80: 2063 6f6c 6f72 2070 616c 6574 7465 732e color palettes. │ │ │ │ +0000bf90: 2020 4966 206d 6f64 6520 6973 2052 4742 If mode is RGB │ │ │ │ +0000bfa0: 206d 6f64 652c 2063 6f6c 6f72 730a 2020 mode, colors. │ │ │ │ +0000bfb0: 2020 2077 696c 6c20 6265 2063 6f70 6965 will be copie │ │ │ │ +0000bfc0: 6420 6672 6f6d 2065 6d75 6c61 7465 6420 d from emulated │ │ │ │ +0000bfd0: 7061 6c65 7474 6520 6461 7461 2e20 2049 palette data. I │ │ │ │ +0000bfe0: 6e20 496e 6465 7865 6420 436f 6c6f 7220 n Indexed Color │ │ │ │ +0000bff0: 6d6f 6465 732c 0a20 2020 2020 7061 6c65 modes,. pale │ │ │ │ +0000c000: 7474 6573 2077 696c 6c20 6265 2072 6561 ttes will be rea │ │ │ │ +0000c010: 6420 6672 6f6d 2068 6172 6477 6172 652e d from hardware. │ │ │ │ +0000c020: 2020 436f 6c6f 7220 7661 6c75 6573 2077 Color values w │ │ │ │ +0000c030: 696c 6c20 6265 0a20 2020 2020 636f 6e76 ill be. conv │ │ │ │ +0000c040: 6572 7465 6420 746f 2073 7569 7420 7374 erted to suit st │ │ │ │ +0000c050: 7275 6374 7572 6520 666f 726d 6174 2e20 ructure format. │ │ │ │ +0000c060: 2027 7374 6172 7427 2077 696c 6c20 7465 'start' will te │ │ │ │ +0000c070: 6c6c 2077 6861 740a 2020 2020 2068 6172 ll what. har │ │ │ │ +0000c080: 6477 6172 6520 636f 6c6f 7220 696e 6465 dware color inde │ │ │ │ +0000c090: 7820 286f 7220 656d 756c 6174 6564 2063 x (or emulated c │ │ │ │ +0000c0a0: 6f6c 6f72 2069 6e64 6578 2920 7769 6c6c olor index) will │ │ │ │ +0000c0b0: 2062 6520 7573 6564 2061 7320 610a 2020 be used as a. │ │ │ │ +0000c0c0: 2020 2073 6f75 7263 6520 666f 7220 6669 source for fi │ │ │ │ +0000c0d0: 7273 7420 696e 6469 6365 206f 6620 2770 rst indice of 'p │ │ │ │ +0000c0e0: 616c 6574 7465 5f64 6174 6127 2c20 6166 alette_data', af │ │ │ │ +0000c0f0: 7465 7220 7468 6174 2062 6f74 6820 6861 ter that both ha │ │ │ │ +0000c100: 7264 7761 7265 0a20 2020 2020 636f 6c6f rdware. colo │ │ │ │ +0000c110: 7220 696e 6465 7820 616e 6420 2770 616c r index and 'pal │ │ │ │ +0000c120: 6574 7465 5f64 6174 6127 2069 6e64 6578 ette_data' index │ │ │ │ +0000c130: 2077 696c 6c20 6265 2069 6e63 7265 6d65 will be increme │ │ │ │ +0000c140: 6e74 6564 2075 6e74 696c 0a20 2020 2020 nted until. │ │ │ │ +0000c150: 2763 6f75 6e74 2720 6e75 6d62 6572 206f 'count' number o │ │ │ │ +0000c160: 6620 636f 6c6f 7273 2068 6176 6520 6265 f colors have be │ │ │ │ +0000c170: 656e 2072 6561 642e 0a0a 3130 2e31 2e37 en read...10.1.7 │ │ │ │ +0000c180: 2067 7275 625f 7669 6465 6f5f 7365 745f grub_video_set_ │ │ │ │ +0000c190: 6172 6561 5f73 7461 7475 730a 2d2d 2d2d area_status.---- │ │ │ │ 0000c1a0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ -0000c1b0: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2020 2a20 ---------.. * │ │ │ │ -0000c1c0: 5072 6f74 6f74 7970 653a 0a20 2020 2020 Prototype:. │ │ │ │ -0000c1d0: 2020 2020 2067 7275 625f 6572 725f 740a grub_err_t. │ │ │ │ -0000c1e0: 2020 2020 2020 2020 2020 6772 7562 5f76 grub_v │ │ │ │ -0000c1f0: 6964 656f 5f73 6574 5f61 7265 615f 7374 ideo_set_area_st │ │ │ │ -0000c200: 6174 7573 2028 6772 7562 5f76 6964 656f atus (grub_video │ │ │ │ -0000c210: 5f61 7265 615f 7374 6174 7573 5f74 2061 _area_status_t a │ │ │ │ -0000c220: 7265 615f 7374 6174 7573 293b 0a20 2020 rea_status);. │ │ │ │ -0000c230: 2020 2020 2020 2065 6e75 6d20 6772 7562 enum grub │ │ │ │ -0000c240: 5f76 6964 656f 5f61 7265 615f 7374 6174 _video_area_stat │ │ │ │ -0000c250: 7573 5f74 0a20 2020 2020 2020 2020 2020 us_t. │ │ │ │ -0000c260: 207b 0a20 2020 2020 2020 2020 2020 2020 {. │ │ │ │ -0000c270: 2047 5255 425f 5649 4445 4f5f 4152 4541 GRUB_VIDEO_AREA │ │ │ │ -0000c280: 5f44 4953 4142 4c45 442c 0a20 2020 2020 _DISABLED,. │ │ │ │ -0000c290: 2020 2020 2020 2020 2047 5255 425f 5649 GRUB_VI │ │ │ │ -0000c2a0: 4445 4f5f 4152 4541 5f45 4e41 424c 4544 DEO_AREA_ENABLED │ │ │ │ -0000c2b0: 0a20 2020 2020 2020 2020 2020 207d 3b0a . };. │ │ │ │ -0000c2c0: 0a20 2020 2a20 4465 7363 7269 7074 696f . * Descriptio │ │ │ │ -0000c2d0: 6e3a 0a0a 2020 2020 2055 7365 6420 746f n:.. Used to │ │ │ │ -0000c2e0: 2073 6574 2061 7265 6120 6472 6177 696e set area drawin │ │ │ │ -0000c2f0: 6720 6d6f 6465 2066 6f72 2072 6564 7261 g mode for redra │ │ │ │ -0000c300: 7769 6e67 2074 6865 2073 7065 6369 6669 wing the specifi │ │ │ │ -0000c310: 6564 2072 6567 696f 6e2e 0a20 2020 2020 ed region.. │ │ │ │ -0000c320: 4472 6177 2063 6f6d 6d61 6e64 7320 6172 Draw commands ar │ │ │ │ -0000c330: 6520 7065 7266 6f72 6d65 6420 696e 2074 e performed in t │ │ │ │ -0000c340: 6865 2069 6e74 6572 7365 6374 696f 6e20 he intersection │ │ │ │ -0000c350: 6f66 2074 6865 2076 6965 7770 6f72 7420 of the viewport │ │ │ │ -0000c360: 616e 640a 2020 2020 2074 6865 2072 6567 and. the reg │ │ │ │ -0000c370: 696f 6e20 6361 6c6c 6564 2061 7265 612e ion called area. │ │ │ │ -0000c380: 2020 436f 6f72 6469 6e61 7465 7320 7265 Coordinates re │ │ │ │ -0000c390: 6d61 696e 2072 656c 6174 6564 2074 6f20 main related to │ │ │ │ -0000c3a0: 7468 650a 2020 2020 2076 6965 7770 6f72 the. viewpor │ │ │ │ -0000c3b0: 742e 2020 4966 2064 7261 7720 636f 6d6d t. If draw comm │ │ │ │ -0000c3c0: 616e 6473 2074 7279 2074 6f20 6472 6177 ands try to draw │ │ │ │ -0000c3d0: 206f 7665 7220 7468 6520 6172 6561 2c20 over the area, │ │ │ │ -0000c3e0: 7468 6579 2061 7265 0a20 2020 2020 636c they are. cl │ │ │ │ -0000c3f0: 6970 7065 642e 2020 5365 7420 7374 6174 ipped. Set stat │ │ │ │ -0000c400: 7573 2074 6f20 4449 5341 424c 4544 2069 us to DISABLED i │ │ │ │ -0000c410: 6620 796f 7520 6e65 6564 2074 6f20 6472 f you need to dr │ │ │ │ -0000c420: 6177 2065 7665 7279 7468 696e 672e 0a20 aw everything.. │ │ │ │ -0000c430: 2020 2020 5365 7420 7374 6174 7573 2074 Set status t │ │ │ │ -0000c440: 6f20 454e 4142 4c45 4420 616e 6420 7265 o ENABLED and re │ │ │ │ -0000c450: 6769 6f6e 2074 6f20 7468 6520 6465 7369 gion to the desi │ │ │ │ -0000c460: 7265 6420 7265 6374 616e 676c 6520 746f red rectangle to │ │ │ │ -0000c470: 2072 6564 7261 770a 2020 2020 2065 7665 redraw. eve │ │ │ │ -0000c480: 7279 7468 696e 6720 696e 7369 6465 2074 rything inside t │ │ │ │ -0000c490: 6865 2072 6567 696f 6e20 6c65 6176 696e he region leavin │ │ │ │ -0000c4a0: 6720 6576 6572 7974 6869 6e67 2065 6c73 g everything els │ │ │ │ -0000c4b0: 6520 696e 7461 6374 2e0a 2020 2020 2053 e intact.. S │ │ │ │ -0000c4c0: 686f 756c 6420 6265 2075 7365 6420 666f hould be used fo │ │ │ │ -0000c4d0: 7220 7265 6472 6177 696e 6720 6f66 2061 r redrawing of a │ │ │ │ -0000c4e0: 6374 6976 6520 656c 656d 656e 7473 2e0a ctive elements.. │ │ │ │ -0000c4f0: 0a31 302e 312e 3820 6772 7562 5f76 6964 .10.1.8 grub_vid │ │ │ │ -0000c500: 656f 5f67 6574 5f61 7265 615f 7374 6174 eo_get_area_stat │ │ │ │ -0000c510: 7573 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d us.------------- │ │ │ │ +0000c1b0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 -------------.. │ │ │ │ +0000c1c0: 2020 2a20 5072 6f74 6f74 7970 653a 0a20 * Prototype:. │ │ │ │ +0000c1d0: 2020 2020 2020 2020 2067 7275 625f 6572 grub_er │ │ │ │ +0000c1e0: 725f 740a 2020 2020 2020 2020 2020 6772 r_t. gr │ │ │ │ +0000c1f0: 7562 5f76 6964 656f 5f73 6574 5f61 7265 ub_video_set_are │ │ │ │ +0000c200: 615f 7374 6174 7573 2028 6772 7562 5f76 a_status (grub_v │ │ │ │ +0000c210: 6964 656f 5f61 7265 615f 7374 6174 7573 ideo_area_status │ │ │ │ +0000c220: 5f74 2061 7265 615f 7374 6174 7573 293b _t area_status); │ │ │ │ +0000c230: 0a20 2020 2020 2020 2020 2065 6e75 6d20 . enum │ │ │ │ +0000c240: 6772 7562 5f76 6964 656f 5f61 7265 615f grub_video_area_ │ │ │ │ +0000c250: 7374 6174 7573 5f74 0a20 2020 2020 2020 status_t. │ │ │ │ +0000c260: 2020 2020 207b 0a20 2020 2020 2020 2020 {. │ │ │ │ +0000c270: 2020 2020 2047 5255 425f 5649 4445 4f5f GRUB_VIDEO_ │ │ │ │ +0000c280: 4152 4541 5f44 4953 4142 4c45 442c 0a20 AREA_DISABLED,. │ │ │ │ +0000c290: 2020 2020 2020 2020 2020 2020 2047 5255 GRU │ │ │ │ +0000c2a0: 425f 5649 4445 4f5f 4152 4541 5f45 4e41 B_VIDEO_AREA_ENA │ │ │ │ +0000c2b0: 424c 4544 0a20 2020 2020 2020 2020 2020 BLED. │ │ │ │ +0000c2c0: 207d 3b0a 0a20 2020 2a20 4465 7363 7269 };.. * Descri │ │ │ │ +0000c2d0: 7074 696f 6e3a 0a0a 2020 2020 2055 7365 ption:.. Use │ │ │ │ +0000c2e0: 6420 746f 2073 6574 2061 7265 6120 6472 d to set area dr │ │ │ │ +0000c2f0: 6177 696e 6720 6d6f 6465 2066 6f72 2072 awing mode for r │ │ │ │ +0000c300: 6564 7261 7769 6e67 2074 6865 2073 7065 edrawing the spe │ │ │ │ +0000c310: 6369 6669 6564 2072 6567 696f 6e2e 0a20 cified region.. │ │ │ │ +0000c320: 2020 2020 4472 6177 2063 6f6d 6d61 6e64 Draw command │ │ │ │ +0000c330: 7320 6172 6520 7065 7266 6f72 6d65 6420 s are performed │ │ │ │ +0000c340: 696e 2074 6865 2069 6e74 6572 7365 6374 in the intersect │ │ │ │ +0000c350: 696f 6e20 6f66 2074 6865 2076 6965 7770 ion of the viewp │ │ │ │ +0000c360: 6f72 7420 616e 640a 2020 2020 2074 6865 ort and. the │ │ │ │ +0000c370: 2072 6567 696f 6e20 6361 6c6c 6564 2061 region called a │ │ │ │ +0000c380: 7265 612e 2020 436f 6f72 6469 6e61 7465 rea. Coordinate │ │ │ │ +0000c390: 7320 7265 6d61 696e 2072 656c 6174 6564 s remain related │ │ │ │ +0000c3a0: 2074 6f20 7468 650a 2020 2020 2076 6965 to the. vie │ │ │ │ +0000c3b0: 7770 6f72 742e 2020 4966 2064 7261 7720 wport. If draw │ │ │ │ +0000c3c0: 636f 6d6d 616e 6473 2074 7279 2074 6f20 commands try to │ │ │ │ +0000c3d0: 6472 6177 206f 7665 7220 7468 6520 6172 draw over the ar │ │ │ │ +0000c3e0: 6561 2c20 7468 6579 2061 7265 0a20 2020 ea, they are. │ │ │ │ +0000c3f0: 2020 636c 6970 7065 642e 2020 5365 7420 clipped. Set │ │ │ │ +0000c400: 7374 6174 7573 2074 6f20 4449 5341 424c status to DISABL │ │ │ │ +0000c410: 4544 2069 6620 796f 7520 6e65 6564 2074 ED if you need t │ │ │ │ +0000c420: 6f20 6472 6177 2065 7665 7279 7468 696e o draw everythin │ │ │ │ +0000c430: 672e 0a20 2020 2020 5365 7420 7374 6174 g.. Set stat │ │ │ │ +0000c440: 7573 2074 6f20 454e 4142 4c45 4420 616e us to ENABLED an │ │ │ │ +0000c450: 6420 7265 6769 6f6e 2074 6f20 7468 6520 d region to the │ │ │ │ +0000c460: 6465 7369 7265 6420 7265 6374 616e 676c desired rectangl │ │ │ │ +0000c470: 6520 746f 2072 6564 7261 770a 2020 2020 e to redraw. │ │ │ │ +0000c480: 2065 7665 7279 7468 696e 6720 696e 7369 everything insi │ │ │ │ +0000c490: 6465 2074 6865 2072 6567 696f 6e20 6c65 de the region le │ │ │ │ +0000c4a0: 6176 696e 6720 6576 6572 7974 6869 6e67 aving everything │ │ │ │ +0000c4b0: 2065 6c73 6520 696e 7461 6374 2e0a 2020 else intact.. │ │ │ │ +0000c4c0: 2020 2053 686f 756c 6420 6265 2075 7365 Should be use │ │ │ │ +0000c4d0: 6420 666f 7220 7265 6472 6177 696e 6720 d for redrawing │ │ │ │ +0000c4e0: 6f66 2061 6374 6976 6520 656c 656d 656e of active elemen │ │ │ │ +0000c4f0: 7473 2e0a 0a31 302e 312e 3820 6772 7562 ts...10.1.8 grub │ │ │ │ +0000c500: 5f76 6964 656f 5f67 6574 5f61 7265 615f _video_get_area_ │ │ │ │ +0000c510: 7374 6174 7573 0a2d 2d2d 2d2d 2d2d 2d2d status.--------- │ │ │ │ 0000c520: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ -0000c530: 2d2d 2d2d 0a0a 2020 202a 2050 726f 746f ----.. * Proto │ │ │ │ -0000c540: 7479 7065 3a0a 2020 2020 2020 2020 2020 type:. │ │ │ │ -0000c550: 6772 7562 5f65 7272 5f72 0a20 2020 2020 grub_err_r. │ │ │ │ -0000c560: 2020 2020 2067 7275 625f 7669 6465 6f5f grub_video_ │ │ │ │ -0000c570: 6765 745f 6172 6561 5f73 7461 7475 7320 get_area_status │ │ │ │ -0000c580: 2867 7275 625f 7669 6465 6f5f 6172 6561 (grub_video_area │ │ │ │ -0000c590: 5f73 7461 7475 735f 7420 2a61 7265 615f _status_t *area_ │ │ │ │ -0000c5a0: 7374 6174 7573 293b 0a0a 2020 202a 2044 status);.. * D │ │ │ │ -0000c5b0: 6573 6372 6970 7469 6f6e 3a20 5573 6564 escription: Used │ │ │ │ -0000c5c0: 2074 6f20 7175 6572 7920 7468 6520 6172 to query the ar │ │ │ │ -0000c5d0: 6561 2073 7461 7475 732e 0a0a 3130 2e31 ea status...10.1 │ │ │ │ -0000c5e0: 2e39 2067 7275 625f 7669 6465 6f5f 7365 .9 grub_video_se │ │ │ │ -0000c5f0: 745f 7669 6577 706f 7274 0a2d 2d2d 2d2d t_viewport.----- │ │ │ │ +0000c530: 2d2d 2d2d 2d2d 2d2d 0a0a 2020 202a 2050 --------.. * P │ │ │ │ +0000c540: 726f 746f 7479 7065 3a0a 2020 2020 2020 rototype:. │ │ │ │ +0000c550: 2020 2020 6772 7562 5f65 7272 5f72 0a20 grub_err_r. │ │ │ │ +0000c560: 2020 2020 2020 2020 2067 7275 625f 7669 grub_vi │ │ │ │ +0000c570: 6465 6f5f 6765 745f 6172 6561 5f73 7461 deo_get_area_sta │ │ │ │ +0000c580: 7475 7320 2867 7275 625f 7669 6465 6f5f tus (grub_video_ │ │ │ │ +0000c590: 6172 6561 5f73 7461 7475 735f 7420 2a61 area_status_t *a │ │ │ │ +0000c5a0: 7265 615f 7374 6174 7573 293b 0a0a 2020 rea_status);.. │ │ │ │ +0000c5b0: 202a 2044 6573 6372 6970 7469 6f6e 3a20 * Description: │ │ │ │ +0000c5c0: 5573 6564 2074 6f20 7175 6572 7920 7468 Used to query th │ │ │ │ +0000c5d0: 6520 6172 6561 2073 7461 7475 732e 0a0a e area status... │ │ │ │ +0000c5e0: 3130 2e31 2e39 2067 7275 625f 7669 6465 10.1.9 grub_vide │ │ │ │ +0000c5f0: 6f5f 7365 745f 7669 6577 706f 7274 0a2d o_set_viewport.- │ │ │ │ 0000c600: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ -0000c610: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2020 2a20 ---------.. * │ │ │ │ -0000c620: 5072 6f74 6f74 7970 653a 0a0a 2020 2020 Prototype:.. │ │ │ │ -0000c630: 2020 2020 2020 6772 7562 5f65 7272 5f74 grub_err_t │ │ │ │ -0000c640: 0a20 2020 2020 2020 2020 2067 7275 625f . grub_ │ │ │ │ -0000c650: 7669 6465 6f5f 7365 745f 7669 6577 706f video_set_viewpo │ │ │ │ -0000c660: 7274 2028 756e 7369 676e 6564 2069 6e74 rt (unsigned int │ │ │ │ -0000c670: 2078 2c20 756e 7369 676e 6564 2069 6e74 x, unsigned int │ │ │ │ -0000c680: 2079 2c20 756e 7369 676e 6564 2069 6e74 y, unsigned int │ │ │ │ -0000c690: 2077 6964 7468 2c20 756e 7369 676e 6564 width, unsigned │ │ │ │ -0000c6a0: 2069 6e74 2068 6569 6768 7429 3b0a 2020 int height);. │ │ │ │ -0000c6b0: 202a 2044 6573 6372 6970 7469 6f6e 3a0a * Description:. │ │ │ │ -0000c6c0: 0a20 2020 2020 5573 6564 2074 6f20 7370 . Used to sp │ │ │ │ -0000c6d0: 6563 6966 7920 7669 6577 706f 7274 2077 ecify viewport w │ │ │ │ -0000c6e0: 6865 7265 2064 7261 7720 636f 6d6d 616e here draw comman │ │ │ │ -0000c6f0: 6473 2061 7265 2070 6572 666f 726d 6564 ds are performed │ │ │ │ -0000c700: 2e20 2057 6865 6e0a 2020 2020 2076 6965 . When. vie │ │ │ │ -0000c710: 7770 6f72 7420 6973 2073 6574 2c20 616c wport is set, al │ │ │ │ -0000c720: 6c20 6472 6177 2063 6f6d 6d61 6e64 7320 l draw commands │ │ │ │ -0000c730: 636f 6f72 6469 6e61 7465 7320 7265 6c61 coordinates rela │ │ │ │ -0000c740: 7465 2074 6f20 7468 6f73 650a 2020 2020 te to those. │ │ │ │ -0000c750: 2073 7065 6369 6669 6564 2062 7920 2778 specified by 'x │ │ │ │ -0000c760: 2720 616e 6420 2779 272e 2020 4966 2064 ' and 'y'. If d │ │ │ │ -0000c770: 7261 7720 636f 6d6d 616e 6473 2074 7279 raw commands try │ │ │ │ -0000c780: 2074 6f20 6472 6177 206f 7665 720a 2020 to draw over. │ │ │ │ -0000c790: 2020 2076 6965 7770 6f72 742c 2074 6865 viewport, the │ │ │ │ -0000c7a0: 7920 6172 6520 636c 6970 7065 642e 2020 y are clipped. │ │ │ │ -0000c7b0: 4966 2064 6576 656c 6f70 6572 2072 6571 If developer req │ │ │ │ -0000c7c0: 7565 7374 7320 6c61 7267 6572 2074 6861 uests larger tha │ │ │ │ -0000c7d0: 6e0a 2020 2020 2070 6f73 7369 626c 6520 n. possible │ │ │ │ -0000c7e0: 7669 6577 706f 7274 2c20 7769 6474 6820 viewport, width │ │ │ │ -0000c7f0: 616e 6420 6865 6967 6874 2077 696c 6c20 and height will │ │ │ │ -0000c800: 6265 2063 6c61 6d70 6564 2074 6f20 6669 be clamped to fi │ │ │ │ -0000c810: 7420 7363 7265 656e 2e0a 2020 2020 2049 t screen.. I │ │ │ │ -0000c820: 6620 2778 2720 616e 6420 2779 2720 6172 f 'x' and 'y' ar │ │ │ │ -0000c830: 6520 6f75 7420 6f66 2062 6f75 6e64 732c e out of bounds, │ │ │ │ -0000c840: 2061 6c6c 2066 756e 6374 696f 6e73 2064 all functions d │ │ │ │ -0000c850: 7261 7769 6e67 2074 6f20 7363 7265 656e rawing to screen │ │ │ │ -0000c860: 0a20 2020 2020 7769 6c6c 206e 6f74 2062 . will not b │ │ │ │ -0000c870: 6520 6469 7370 6c61 7965 642e 2020 496e e displayed. In │ │ │ │ -0000c880: 206f 7264 6572 2074 6f20 6d61 7869 6d69 order to maximi │ │ │ │ -0000c890: 7a65 2076 6965 7770 6f72 742c 2075 7365 ze viewport, use │ │ │ │ -0000c8a0: 0a20 2020 2020 2767 7275 625f 7669 6465 . 'grub_vide │ │ │ │ -0000c8b0: 6f5f 6765 745f 696e 666f 2720 746f 2071 o_get_info' to q │ │ │ │ -0000c8c0: 7565 7279 2061 6374 7561 6c20 7363 7265 uery actual scre │ │ │ │ -0000c8d0: 656e 2064 696d 656e 7369 6f6e 7320 616e en dimensions an │ │ │ │ -0000c8e0: 6420 7072 6f76 6964 650a 2020 2020 2074 d provide. t │ │ │ │ -0000c8f0: 6861 7420 696e 666f 726d 6174 696f 6e20 hat information │ │ │ │ -0000c900: 746f 2074 6869 7320 6675 6e63 7469 6f6e to this function │ │ │ │ -0000c910: 2e0a 0a31 302e 312e 3130 2067 7275 625f ...10.1.10 grub_ │ │ │ │ -0000c920: 7669 6465 6f5f 6765 745f 7669 6577 706f video_get_viewpo │ │ │ │ -0000c930: 7274 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d rt.------------- │ │ │ │ +0000c610: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 -------------.. │ │ │ │ +0000c620: 2020 2a20 5072 6f74 6f74 7970 653a 0a0a * Prototype:.. │ │ │ │ +0000c630: 2020 2020 2020 2020 2020 6772 7562 5f65 grub_e │ │ │ │ +0000c640: 7272 5f74 0a20 2020 2020 2020 2020 2067 rr_t. g │ │ │ │ +0000c650: 7275 625f 7669 6465 6f5f 7365 745f 7669 rub_video_set_vi │ │ │ │ +0000c660: 6577 706f 7274 2028 756e 7369 676e 6564 ewport (unsigned │ │ │ │ +0000c670: 2069 6e74 2078 2c20 756e 7369 676e 6564 int x, unsigned │ │ │ │ +0000c680: 2069 6e74 2079 2c20 756e 7369 676e 6564 int y, unsigned │ │ │ │ +0000c690: 2069 6e74 2077 6964 7468 2c20 756e 7369 int width, unsi │ │ │ │ +0000c6a0: 676e 6564 2069 6e74 2068 6569 6768 7429 gned int height) │ │ │ │ +0000c6b0: 3b0a 2020 202a 2044 6573 6372 6970 7469 ;. * Descripti │ │ │ │ +0000c6c0: 6f6e 3a0a 0a20 2020 2020 5573 6564 2074 on:.. Used t │ │ │ │ +0000c6d0: 6f20 7370 6563 6966 7920 7669 6577 706f o specify viewpo │ │ │ │ +0000c6e0: 7274 2077 6865 7265 2064 7261 7720 636f rt where draw co │ │ │ │ +0000c6f0: 6d6d 616e 6473 2061 7265 2070 6572 666f mmands are perfo │ │ │ │ +0000c700: 726d 6564 2e20 2057 6865 6e0a 2020 2020 rmed. When. │ │ │ │ +0000c710: 2076 6965 7770 6f72 7420 6973 2073 6574 viewport is set │ │ │ │ +0000c720: 2c20 616c 6c20 6472 6177 2063 6f6d 6d61 , all draw comma │ │ │ │ +0000c730: 6e64 7320 636f 6f72 6469 6e61 7465 7320 nds coordinates │ │ │ │ +0000c740: 7265 6c61 7465 2074 6f20 7468 6f73 650a relate to those. │ │ │ │ +0000c750: 2020 2020 2073 7065 6369 6669 6564 2062 specified b │ │ │ │ +0000c760: 7920 2778 2720 616e 6420 2779 272e 2020 y 'x' and 'y'. │ │ │ │ +0000c770: 4966 2064 7261 7720 636f 6d6d 616e 6473 If draw commands │ │ │ │ +0000c780: 2074 7279 2074 6f20 6472 6177 206f 7665 try to draw ove │ │ │ │ +0000c790: 720a 2020 2020 2076 6965 7770 6f72 742c r. viewport, │ │ │ │ +0000c7a0: 2074 6865 7920 6172 6520 636c 6970 7065 they are clippe │ │ │ │ +0000c7b0: 642e 2020 4966 2064 6576 656c 6f70 6572 d. If developer │ │ │ │ +0000c7c0: 2072 6571 7565 7374 7320 6c61 7267 6572 requests larger │ │ │ │ +0000c7d0: 2074 6861 6e0a 2020 2020 2070 6f73 7369 than. possi │ │ │ │ +0000c7e0: 626c 6520 7669 6577 706f 7274 2c20 7769 ble viewport, wi │ │ │ │ +0000c7f0: 6474 6820 616e 6420 6865 6967 6874 2077 dth and height w │ │ │ │ +0000c800: 696c 6c20 6265 2063 6c61 6d70 6564 2074 ill be clamped t │ │ │ │ +0000c810: 6f20 6669 7420 7363 7265 656e 2e0a 2020 o fit screen.. │ │ │ │ +0000c820: 2020 2049 6620 2778 2720 616e 6420 2779 If 'x' and 'y │ │ │ │ +0000c830: 2720 6172 6520 6f75 7420 6f66 2062 6f75 ' are out of bou │ │ │ │ +0000c840: 6e64 732c 2061 6c6c 2066 756e 6374 696f nds, all functio │ │ │ │ +0000c850: 6e73 2064 7261 7769 6e67 2074 6f20 7363 ns drawing to sc │ │ │ │ +0000c860: 7265 656e 0a20 2020 2020 7769 6c6c 206e reen. will n │ │ │ │ +0000c870: 6f74 2062 6520 6469 7370 6c61 7965 642e ot be displayed. │ │ │ │ +0000c880: 2020 496e 206f 7264 6572 2074 6f20 6d61 In order to ma │ │ │ │ +0000c890: 7869 6d69 7a65 2076 6965 7770 6f72 742c ximize viewport, │ │ │ │ +0000c8a0: 2075 7365 0a20 2020 2020 2767 7275 625f use. 'grub_ │ │ │ │ +0000c8b0: 7669 6465 6f5f 6765 745f 696e 666f 2720 video_get_info' │ │ │ │ +0000c8c0: 746f 2071 7565 7279 2061 6374 7561 6c20 to query actual │ │ │ │ +0000c8d0: 7363 7265 656e 2064 696d 656e 7369 6f6e screen dimension │ │ │ │ +0000c8e0: 7320 616e 6420 7072 6f76 6964 650a 2020 s and provide. │ │ │ │ +0000c8f0: 2020 2074 6861 7420 696e 666f 726d 6174 that informat │ │ │ │ +0000c900: 696f 6e20 746f 2074 6869 7320 6675 6e63 ion to this func │ │ │ │ +0000c910: 7469 6f6e 2e0a 0a31 302e 312e 3130 2067 tion...10.1.10 g │ │ │ │ +0000c920: 7275 625f 7669 6465 6f5f 6765 745f 7669 rub_video_get_vi │ │ │ │ +0000c930: 6577 706f 7274 0a2d 2d2d 2d2d 2d2d 2d2d ewport.--------- │ │ │ │ 0000c940: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ -0000c950: 2d2d 0a0a 2020 202a 2050 726f 746f 7479 --.. * Prototy │ │ │ │ -0000c960: 7065 3a0a 0a20 2020 2020 2020 2020 2067 pe:.. g │ │ │ │ -0000c970: 7275 625f 6572 725f 740a 2020 2020 2020 rub_err_t. │ │ │ │ -0000c980: 2020 2020 6772 7562 5f76 6964 656f 5f67 grub_video_g │ │ │ │ -0000c990: 6574 5f76 6965 7770 6f72 7420 2875 6e73 et_viewport (uns │ │ │ │ -0000c9a0: 6967 6e65 6420 696e 7420 2a78 2c20 756e igned int *x, un │ │ │ │ -0000c9b0: 7369 676e 6564 2069 6e74 202a 792c 2075 signed int *y, u │ │ │ │ -0000c9c0: 6e73 6967 6e65 6420 696e 7420 2a77 6964 nsigned int *wid │ │ │ │ -0000c9d0: 7468 2c20 756e 7369 676e 6564 2069 6e74 th, unsigned int │ │ │ │ -0000c9e0: 202a 6865 6967 6874 293b 0a20 2020 2a20 *height);. * │ │ │ │ -0000c9f0: 4465 7363 7269 7074 696f 6e3a 0a0a 2020 Description:.. │ │ │ │ -0000ca00: 2020 2055 7365 6420 746f 2071 7565 7279 Used to query │ │ │ │ -0000ca10: 2063 7572 7265 6e74 2076 6965 7770 6f72 current viewpor │ │ │ │ -0000ca20: 7420 6469 6d65 6e73 696f 6e73 2e20 2053 t dimensions. S │ │ │ │ -0000ca30: 6f66 7477 6172 6520 6465 7665 6c6f 7065 oftware develope │ │ │ │ -0000ca40: 7220 6361 6e0a 2020 2020 2075 7365 2074 r can. use t │ │ │ │ -0000ca50: 6869 7320 746f 2063 686f 6f73 6520 6265 his to choose be │ │ │ │ -0000ca60: 7374 2077 6179 2074 6f20 7265 6e64 6572 st way to render │ │ │ │ -0000ca70: 2063 6f6e 7465 6e74 7320 6f66 2074 6865 contents of the │ │ │ │ -0000ca80: 2076 6965 7770 6f72 742e 0a0a 3130 2e31 viewport...10.1 │ │ │ │ -0000ca90: 2e31 3120 6772 7562 5f76 6964 656f 5f73 .11 grub_video_s │ │ │ │ -0000caa0: 6574 5f72 6567 696f 6e0a 2d2d 2d2d 2d2d et_region.------ │ │ │ │ +0000c950: 2d2d 2d2d 2d2d 0a0a 2020 202a 2050 726f ------.. * Pro │ │ │ │ +0000c960: 746f 7479 7065 3a0a 0a20 2020 2020 2020 totype:.. │ │ │ │ +0000c970: 2020 2067 7275 625f 6572 725f 740a 2020 grub_err_t. │ │ │ │ +0000c980: 2020 2020 2020 2020 6772 7562 5f76 6964 grub_vid │ │ │ │ +0000c990: 656f 5f67 6574 5f76 6965 7770 6f72 7420 eo_get_viewport │ │ │ │ +0000c9a0: 2875 6e73 6967 6e65 6420 696e 7420 2a78 (unsigned int *x │ │ │ │ +0000c9b0: 2c20 756e 7369 676e 6564 2069 6e74 202a , unsigned int * │ │ │ │ +0000c9c0: 792c 2075 6e73 6967 6e65 6420 696e 7420 y, unsigned int │ │ │ │ +0000c9d0: 2a77 6964 7468 2c20 756e 7369 676e 6564 *width, unsigned │ │ │ │ +0000c9e0: 2069 6e74 202a 6865 6967 6874 293b 0a20 int *height);. │ │ │ │ +0000c9f0: 2020 2a20 4465 7363 7269 7074 696f 6e3a * Description: │ │ │ │ +0000ca00: 0a0a 2020 2020 2055 7365 6420 746f 2071 .. Used to q │ │ │ │ +0000ca10: 7565 7279 2063 7572 7265 6e74 2076 6965 uery current vie │ │ │ │ +0000ca20: 7770 6f72 7420 6469 6d65 6e73 696f 6e73 wport dimensions │ │ │ │ +0000ca30: 2e20 2053 6f66 7477 6172 6520 6465 7665 . Software deve │ │ │ │ +0000ca40: 6c6f 7065 7220 6361 6e0a 2020 2020 2075 loper can. u │ │ │ │ +0000ca50: 7365 2074 6869 7320 746f 2063 686f 6f73 se this to choos │ │ │ │ +0000ca60: 6520 6265 7374 2077 6179 2074 6f20 7265 e best way to re │ │ │ │ +0000ca70: 6e64 6572 2063 6f6e 7465 6e74 7320 6f66 nder contents of │ │ │ │ +0000ca80: 2074 6865 2076 6965 7770 6f72 742e 0a0a the viewport... │ │ │ │ +0000ca90: 3130 2e31 2e31 3120 6772 7562 5f76 6964 10.1.11 grub_vid │ │ │ │ +0000caa0: 656f 5f73 6574 5f72 6567 696f 6e0a 2d2d eo_set_region.-- │ │ │ │ 0000cab0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ -0000cac0: 2d2d 2d2d 2d2d 2d0a 0a20 2020 2a20 5072 -------.. * Pr │ │ │ │ -0000cad0: 6f74 6f74 7970 653a 0a0a 2020 2020 2020 ototype:.. │ │ │ │ -0000cae0: 2020 2020 6772 7562 5f65 7272 5f74 0a20 grub_err_t. │ │ │ │ -0000caf0: 2020 2020 2020 2020 2067 7275 625f 7669 grub_vi │ │ │ │ -0000cb00: 6465 6f5f 7365 745f 7265 6769 6f6e 2028 deo_set_region ( │ │ │ │ -0000cb10: 756e 7369 676e 6564 2069 6e74 2078 2c20 unsigned int x, │ │ │ │ -0000cb20: 756e 7369 676e 6564 2069 6e74 2079 2c20 unsigned int y, │ │ │ │ -0000cb30: 756e 7369 676e 6564 2069 6e74 2077 6964 unsigned int wid │ │ │ │ -0000cb40: 7468 2c20 756e 7369 676e 6564 2069 6e74 th, unsigned int │ │ │ │ -0000cb50: 2068 6569 6768 7429 3b0a 2020 202a 2044 height);. * D │ │ │ │ -0000cb60: 6573 6372 6970 7469 6f6e 3a0a 0a20 2020 escription:.. │ │ │ │ -0000cb70: 2020 5573 6564 2074 6f20 7370 6563 6966 Used to specif │ │ │ │ -0000cb80: 7920 7468 6520 7265 6769 6f6e 206f 6620 y the region of │ │ │ │ -0000cb90: 7468 6520 7363 7265 656e 2077 6869 6368 the screen which │ │ │ │ -0000cba0: 2073 686f 756c 6420 6265 2072 6564 7261 should be redra │ │ │ │ -0000cbb0: 776e 2e0a 2020 2020 2055 7365 2061 6273 wn.. Use abs │ │ │ │ -0000cbc0: 6f6c 7574 6520 7661 6c75 6573 2e20 2057 olute values. W │ │ │ │ -0000cbd0: 6865 6e20 7468 6520 7265 6769 6f6e 2069 hen the region i │ │ │ │ -0000cbe0: 7320 7365 7420 616e 6420 6172 6561 2073 s set and area s │ │ │ │ -0000cbf0: 7461 7475 7320 6973 0a20 2020 2020 454e tatus is. EN │ │ │ │ -0000cc00: 4142 4c45 2061 6c6c 2064 7261 7720 636f ABLE all draw co │ │ │ │ -0000cc10: 6d6d 616e 6473 2077 696c 6c20 6265 2070 mmands will be p │ │ │ │ -0000cc20: 6572 666f 726d 6564 2069 6e73 6964 6520 erformed inside │ │ │ │ -0000cc30: 7468 6520 696e 7465 7273 6570 7469 6f6e the interseption │ │ │ │ -0000cc40: 0a20 2020 2020 6f66 2072 6567 696f 6e20 . of region │ │ │ │ -0000cc50: 616e 6420 7669 6577 706f 7274 206e 616d and viewport nam │ │ │ │ -0000cc60: 6564 2061 7265 612e 2020 4966 2064 7261 ed area. If dra │ │ │ │ -0000cc70: 7720 636f 6d6d 616e 6473 2074 7279 2074 w commands try t │ │ │ │ -0000cc80: 6f20 6472 6177 0a20 2020 2020 6f76 6572 o draw. over │ │ │ │ -0000cc90: 2076 6965 7770 6f72 742c 2074 6865 7920 viewport, they │ │ │ │ -0000cca0: 6172 6520 636c 6970 7065 642e 2020 4966 are clipped. If │ │ │ │ -0000ccb0: 2064 6576 656c 6f70 6572 2072 6571 7565 developer reque │ │ │ │ -0000ccc0: 7374 7320 6c61 7267 6572 2074 6861 6e0a sts larger than. │ │ │ │ -0000ccd0: 2020 2020 2070 6f73 7369 626c 6520 7265 possible re │ │ │ │ -0000cce0: 6769 6f6e 2c20 7769 6474 6820 616e 6420 gion, width and │ │ │ │ -0000ccf0: 6865 6967 6874 2077 696c 6c20 6265 2063 height will be c │ │ │ │ -0000cd00: 6c61 6d70 6564 2074 6f20 6669 7420 7363 lamped to fit sc │ │ │ │ -0000cd10: 7265 656e 2e0a 2020 2020 2053 686f 756c reen.. Shoul │ │ │ │ -0000cd20: 6420 6265 2075 7365 6420 666f 7220 7265 d be used for re │ │ │ │ -0000cd30: 6472 6177 696e 6720 6f66 2061 6374 6976 drawing of activ │ │ │ │ -0000cd40: 6520 656c 656d 656e 7473 2e0a 0a31 302e e elements...10. │ │ │ │ -0000cd50: 312e 3132 2067 7275 625f 7669 6465 6f5f 1.12 grub_video_ │ │ │ │ -0000cd60: 6765 745f 7265 6769 6f6e 0a2d 2d2d 2d2d get_region.----- │ │ │ │ +0000cac0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2020 -----------.. │ │ │ │ +0000cad0: 2a20 5072 6f74 6f74 7970 653a 0a0a 2020 * Prototype:.. │ │ │ │ +0000cae0: 2020 2020 2020 2020 6772 7562 5f65 7272 grub_err │ │ │ │ +0000caf0: 5f74 0a20 2020 2020 2020 2020 2067 7275 _t. gru │ │ │ │ +0000cb00: 625f 7669 6465 6f5f 7365 745f 7265 6769 b_video_set_regi │ │ │ │ +0000cb10: 6f6e 2028 756e 7369 676e 6564 2069 6e74 on (unsigned int │ │ │ │ +0000cb20: 2078 2c20 756e 7369 676e 6564 2069 6e74 x, unsigned int │ │ │ │ +0000cb30: 2079 2c20 756e 7369 676e 6564 2069 6e74 y, unsigned int │ │ │ │ +0000cb40: 2077 6964 7468 2c20 756e 7369 676e 6564 width, unsigned │ │ │ │ +0000cb50: 2069 6e74 2068 6569 6768 7429 3b0a 2020 int height);. │ │ │ │ +0000cb60: 202a 2044 6573 6372 6970 7469 6f6e 3a0a * Description:. │ │ │ │ +0000cb70: 0a20 2020 2020 5573 6564 2074 6f20 7370 . Used to sp │ │ │ │ +0000cb80: 6563 6966 7920 7468 6520 7265 6769 6f6e ecify the region │ │ │ │ +0000cb90: 206f 6620 7468 6520 7363 7265 656e 2077 of the screen w │ │ │ │ +0000cba0: 6869 6368 2073 686f 756c 6420 6265 2072 hich should be r │ │ │ │ +0000cbb0: 6564 7261 776e 2e0a 2020 2020 2055 7365 edrawn.. Use │ │ │ │ +0000cbc0: 2061 6273 6f6c 7574 6520 7661 6c75 6573 absolute values │ │ │ │ +0000cbd0: 2e20 2057 6865 6e20 7468 6520 7265 6769 . When the regi │ │ │ │ +0000cbe0: 6f6e 2069 7320 7365 7420 616e 6420 6172 on is set and ar │ │ │ │ +0000cbf0: 6561 2073 7461 7475 7320 6973 0a20 2020 ea status is. │ │ │ │ +0000cc00: 2020 454e 4142 4c45 2061 6c6c 2064 7261 ENABLE all dra │ │ │ │ +0000cc10: 7720 636f 6d6d 616e 6473 2077 696c 6c20 w commands will │ │ │ │ +0000cc20: 6265 2070 6572 666f 726d 6564 2069 6e73 be performed ins │ │ │ │ +0000cc30: 6964 6520 7468 6520 696e 7465 7273 6570 ide the intersep │ │ │ │ +0000cc40: 7469 6f6e 0a20 2020 2020 6f66 2072 6567 tion. of reg │ │ │ │ +0000cc50: 696f 6e20 616e 6420 7669 6577 706f 7274 ion and viewport │ │ │ │ +0000cc60: 206e 616d 6564 2061 7265 612e 2020 4966 named area. If │ │ │ │ +0000cc70: 2064 7261 7720 636f 6d6d 616e 6473 2074 draw commands t │ │ │ │ +0000cc80: 7279 2074 6f20 6472 6177 0a20 2020 2020 ry to draw. │ │ │ │ +0000cc90: 6f76 6572 2076 6965 7770 6f72 742c 2074 over viewport, t │ │ │ │ +0000cca0: 6865 7920 6172 6520 636c 6970 7065 642e hey are clipped. │ │ │ │ +0000ccb0: 2020 4966 2064 6576 656c 6f70 6572 2072 If developer r │ │ │ │ +0000ccc0: 6571 7565 7374 7320 6c61 7267 6572 2074 equests larger t │ │ │ │ +0000ccd0: 6861 6e0a 2020 2020 2070 6f73 7369 626c han. possibl │ │ │ │ +0000cce0: 6520 7265 6769 6f6e 2c20 7769 6474 6820 e region, width │ │ │ │ +0000ccf0: 616e 6420 6865 6967 6874 2077 696c 6c20 and height will │ │ │ │ +0000cd00: 6265 2063 6c61 6d70 6564 2074 6f20 6669 be clamped to fi │ │ │ │ +0000cd10: 7420 7363 7265 656e 2e0a 2020 2020 2053 t screen.. S │ │ │ │ +0000cd20: 686f 756c 6420 6265 2075 7365 6420 666f hould be used fo │ │ │ │ +0000cd30: 7220 7265 6472 6177 696e 6720 6f66 2061 r redrawing of a │ │ │ │ +0000cd40: 6374 6976 6520 656c 656d 656e 7473 2e0a ctive elements.. │ │ │ │ +0000cd50: 0a31 302e 312e 3132 2067 7275 625f 7669 .10.1.12 grub_vi │ │ │ │ +0000cd60: 6465 6f5f 6765 745f 7265 6769 6f6e 0a2d deo_get_region.- │ │ │ │ 0000cd70: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ -0000cd80: 2d2d 2d2d 2d2d 2d2d 0a0a 2020 202a 2050 --------.. * P │ │ │ │ -0000cd90: 726f 746f 7479 7065 3a0a 0a20 2020 2020 rototype:.. │ │ │ │ -0000cda0: 2020 2020 2067 7275 625f 6572 725f 740a grub_err_t. │ │ │ │ -0000cdb0: 2020 2020 2020 2020 2020 6772 7562 5f76 grub_v │ │ │ │ -0000cdc0: 6964 656f 5f67 6574 5f72 6567 696f 6e20 ideo_get_region │ │ │ │ -0000cdd0: 2875 6e73 6967 6e65 6420 696e 7420 2a78 (unsigned int *x │ │ │ │ -0000cde0: 2c20 756e 7369 676e 6564 2069 6e74 202a , unsigned int * │ │ │ │ -0000cdf0: 792c 2075 6e73 6967 6e65 6420 696e 7420 y, unsigned int │ │ │ │ -0000ce00: 2a77 6964 7468 2c20 756e 7369 676e 6564 *width, unsigned │ │ │ │ -0000ce10: 2069 6e74 202a 6865 6967 6874 293b 0a20 int *height);. │ │ │ │ -0000ce20: 2020 2a20 4465 7363 7269 7074 696f 6e3a * Description: │ │ │ │ -0000ce30: 0a0a 2020 2020 2055 7365 6420 746f 2071 .. Used to q │ │ │ │ -0000ce40: 7565 7279 2063 7572 7265 6e74 2072 6567 uery current reg │ │ │ │ -0000ce50: 696f 6e20 6469 6d65 6e73 696f 6e73 2e0a ion dimensions.. │ │ │ │ -0000ce60: 0a31 302e 312e 3133 2067 7275 625f 7669 .10.1.13 grub_vi │ │ │ │ -0000ce70: 6465 6f5f 6d61 705f 636f 6c6f 720a 2d2d deo_map_color.-- │ │ │ │ -0000ce80: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ -0000ce90: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 2020 202a ----------.. * │ │ │ │ -0000cea0: 2050 726f 746f 7479 7065 3a0a 0a20 2020 Prototype:.. │ │ │ │ -0000ceb0: 2020 2020 2020 2067 7275 625f 7669 6465 grub_vide │ │ │ │ -0000cec0: 6f5f 636f 6c6f 725f 740a 2020 2020 2020 o_color_t. │ │ │ │ -0000ced0: 2020 2020 6772 7562 5f76 6964 656f 5f6d grub_video_m │ │ │ │ -0000cee0: 6170 5f63 6f6c 6f72 2028 6772 7562 5f75 ap_color (grub_u │ │ │ │ -0000cef0: 696e 7433 325f 7420 636f 6c6f 725f 6e61 int32_t color_na │ │ │ │ -0000cf00: 6d65 293b 0a20 2020 2a20 4465 7363 7269 me);. * Descri │ │ │ │ -0000cf10: 7074 696f 6e3a 0a0a 2020 2020 204d 6170 ption:.. Map │ │ │ │ -0000cf20: 2063 6f6c 6f72 2063 616e 2062 6520 7573 color can be us │ │ │ │ -0000cf30: 6564 2074 6f20 7375 7070 6f72 7420 636f ed to support co │ │ │ │ -0000cf40: 6c6f 7220 7468 656d 6573 2069 6e20 4752 lor themes in GR │ │ │ │ -0000cf50: 5542 2e20 5468 6572 6520 7769 6c6c 0a20 UB. There will. │ │ │ │ -0000cf60: 2020 2020 6265 2063 6f6c 6c65 6374 696f be collectio │ │ │ │ -0000cf70: 6e20 6f66 2063 6f6c 6f72 206e 616d 6573 n of color names │ │ │ │ -0000cf80: 2074 6861 7420 6361 6e20 6265 2075 7365 that can be use │ │ │ │ -0000cf90: 6420 746f 2071 7565 7279 2061 6374 7561 d to query actua │ │ │ │ -0000cfa0: 6c0a 2020 2020 2073 6372 6565 6e20 6d61 l. screen ma │ │ │ │ -0000cfb0: 7070 6564 2063 6f6c 6f72 2064 6174 612e pped color data. │ │ │ │ -0000cfc0: 2020 4578 616d 706c 6573 2063 6f75 6c64 Examples could │ │ │ │ -0000cfd0: 2062 650a 2020 2020 2027 4752 5542 5f43 be. 'GRUB_C │ │ │ │ -0000cfe0: 4f4c 4f52 5f43 4f4e 534f 4c45 5f42 4143 OLOR_CONSOLE_BAC │ │ │ │ -0000cff0: 4b47 524f 554e 4427 2c20 2747 5255 425f KGROUND', 'GRUB_ │ │ │ │ -0000d000: 434f 4c4f 525f 434f 4e53 4f4c 455f 5445 COLOR_CONSOLE_TE │ │ │ │ -0000d010: 5854 272e 2020 5468 650a 2020 2020 2061 XT'. The. a │ │ │ │ -0000d020: 6374 7561 6c20 636f 6c6f 7220 6465 6669 ctual color defi │ │ │ │ -0000d030: 6e65 7320 6172 6520 6e6f 7420 7370 6563 nes are not spec │ │ │ │ -0000d040: 6966 6965 6420 6174 2074 6869 7320 706f ified at this po │ │ │ │ -0000d050: 696e 742e 0a0a 3130 2e31 2e31 3420 6772 int...10.1.14 gr │ │ │ │ -0000d060: 7562 5f76 6964 656f 5f6d 6170 5f72 6762 ub_video_map_rgb │ │ │ │ -0000d070: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d .--------------- │ │ │ │ -0000d080: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2020 -----------.. │ │ │ │ -0000d090: 2a20 5072 6f74 6f74 7970 653a 0a0a 2020 * Prototype:.. │ │ │ │ -0000d0a0: 2020 2020 2020 2020 6772 7562 5f76 6964 grub_vid │ │ │ │ -0000d0b0: 656f 5f63 6f6c 6f72 5f74 0a20 2020 2020 eo_color_t. │ │ │ │ -0000d0c0: 2020 2020 2067 7275 625f 7669 6465 6f5f grub_video_ │ │ │ │ -0000d0d0: 6d61 705f 7267 6220 2867 7275 625f 7569 map_rgb (grub_ui │ │ │ │ -0000d0e0: 6e74 385f 7420 7265 642c 2067 7275 625f nt8_t red, grub_ │ │ │ │ -0000d0f0: 7569 6e74 385f 7420 6772 6565 6e2c 2067 uint8_t green, g │ │ │ │ -0000d100: 7275 625f 7569 6e74 385f 7420 626c 7565 rub_uint8_t blue │ │ │ │ -0000d110: 293b 0a20 2020 2a20 4465 7363 7269 7074 );. * Descript │ │ │ │ -0000d120: 696f 6e3a 0a0a 2020 2020 204d 6170 2052 ion:.. Map R │ │ │ │ -0000d130: 4742 2076 616c 7565 7320 746f 2063 6f6d GB values to com │ │ │ │ -0000d140: 7061 7469 626c 6520 7363 7265 656e 2063 patible screen c │ │ │ │ -0000d150: 6f6c 6f72 2064 6174 612e 2020 5661 6c75 olor data. Valu │ │ │ │ -0000d160: 6573 2061 7265 0a20 2020 2020 6578 7065 es are. expe │ │ │ │ -0000d170: 6374 6564 2074 6f20 6265 2069 6e20 7261 cted to be in ra │ │ │ │ -0000d180: 6e67 6520 302d 3235 3520 616e 6420 696e nge 0-255 and in │ │ │ │ -0000d190: 2052 4742 206d 6f64 6573 2074 6865 7920 RGB modes they │ │ │ │ -0000d1a0: 7769 6c6c 2062 650a 2020 2020 2063 6f6e will be. con │ │ │ │ -0000d1b0: 7665 7274 6564 2074 6f20 7363 7265 656e verted to screen │ │ │ │ -0000d1c0: 2063 6f6c 6f72 2064 6174 612e 2020 496e color data. In │ │ │ │ -0000d1d0: 2069 6e64 6578 2063 6f6c 6f72 206d 6f64 index color mod │ │ │ │ -0000d1e0: 6573 2c20 696e 6465 7820 636f 6c6f 720a es, index color. │ │ │ │ -0000d1f0: 2020 2020 2070 616c 6574 7465 2077 696c palette wil │ │ │ │ -0000d200: 6c20 6265 2073 6561 7263 6865 6420 666f l be searched fo │ │ │ │ -0000d210: 7220 7370 6563 6966 6965 6420 636f 6c6f r specified colo │ │ │ │ -0000d220: 7220 616e 6420 7468 656e 2069 6e64 6578 r and then index │ │ │ │ -0000d230: 2069 730a 2020 2020 2072 6574 7572 6e65 is. returne │ │ │ │ -0000d240: 642e 0a0a 3130 2e31 2e31 3520 6772 7562 d...10.1.15 grub │ │ │ │ -0000d250: 5f76 6964 656f 5f6d 6170 5f72 6762 610a _video_map_rgba. │ │ │ │ -0000d260: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ -0000d270: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2020 -----------.. │ │ │ │ -0000d280: 2a20 5072 6f74 6f74 7970 653a 0a0a 2020 * Prototype:.. │ │ │ │ -0000d290: 2020 2020 2020 2020 6772 7562 5f76 6964 grub_vid │ │ │ │ -0000d2a0: 656f 5f63 6f6c 6f72 5f74 0a20 2020 2020 eo_color_t. │ │ │ │ -0000d2b0: 2020 2020 2067 7275 625f 7669 6465 6f5f grub_video_ │ │ │ │ -0000d2c0: 6d61 705f 7267 6261 2028 6772 7562 5f75 map_rgba (grub_u │ │ │ │ -0000d2d0: 696e 7438 5f74 2072 6564 2c20 6772 7562 int8_t red, grub │ │ │ │ -0000d2e0: 5f75 696e 7438 5f74 2067 7265 656e 2c20 _uint8_t green, │ │ │ │ -0000d2f0: 6772 7562 5f75 696e 7438 5f74 2062 6c75 grub_uint8_t blu │ │ │ │ -0000d300: 652c 2067 7275 625f 7569 6e74 385f 7420 e, grub_uint8_t │ │ │ │ -0000d310: 616c 7068 6129 3b0a 2020 202a 2044 6573 alpha);. * Des │ │ │ │ -0000d320: 6372 6970 7469 6f6e 3a0a 0a20 2020 2020 cription:.. │ │ │ │ -0000d330: 4d61 7020 5247 4241 2076 616c 7565 7320 Map RGBA values │ │ │ │ -0000d340: 746f 2063 6f6d 7061 7469 626c 6520 7363 to compatible sc │ │ │ │ -0000d350: 7265 656e 2063 6f6c 6f72 2064 6174 612e reen color data. │ │ │ │ -0000d360: 2020 5661 6c75 6573 2061 7265 0a20 2020 Values are. │ │ │ │ -0000d370: 2020 6578 7065 6374 6564 2074 6f20 6265 expected to be │ │ │ │ -0000d380: 2069 6e20 7261 6e67 6520 302d 3235 352e in range 0-255. │ │ │ │ -0000d390: 2020 496e 2052 4742 4120 6d6f 6465 7320 In RGBA modes │ │ │ │ -0000d3a0: 7468 6579 2077 696c 6c20 6265 0a20 2020 they will be. │ │ │ │ -0000d3b0: 2020 636f 6e76 6572 7465 6420 746f 2073 converted to s │ │ │ │ -0000d3c0: 6372 6565 6e20 636f 6c6f 7220 6461 7461 creen color data │ │ │ │ -0000d3d0: 2e20 2049 6e20 696e 6465 7820 636f 6c6f . In index colo │ │ │ │ -0000d3e0: 7220 6d6f 6465 732c 2069 6e64 6578 2063 r modes, index c │ │ │ │ -0000d3f0: 6f6c 6f72 0a20 2020 2020 7061 6c65 7474 olor. palett │ │ │ │ -0000d400: 6520 7769 6c6c 2062 6520 7365 6172 6368 e will be search │ │ │ │ -0000d410: 6564 2066 6f72 2062 6573 7420 6d61 7463 ed for best matc │ │ │ │ -0000d420: 6869 6e67 2063 6f6c 6f72 2061 6e64 2069 hing color and i │ │ │ │ -0000d430: 7473 2069 6e64 6578 2069 730a 2020 2020 ts index is. │ │ │ │ -0000d440: 2072 6574 7572 6e65 642e 0a0a 3130 2e31 returned...10.1 │ │ │ │ -0000d450: 2e31 3620 6772 7562 5f76 6964 656f 5f75 .16 grub_video_u │ │ │ │ -0000d460: 6e6d 6170 5f63 6f6c 6f72 0a2d 2d2d 2d2d nmap_color.----- │ │ │ │ +0000cd80: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 2020 ------------.. │ │ │ │ +0000cd90: 202a 2050 726f 746f 7479 7065 3a0a 0a20 * Prototype:.. │ │ │ │ +0000cda0: 2020 2020 2020 2020 2067 7275 625f 6572 grub_er │ │ │ │ +0000cdb0: 725f 740a 2020 2020 2020 2020 2020 6772 r_t. gr │ │ │ │ +0000cdc0: 7562 5f76 6964 656f 5f67 6574 5f72 6567 ub_video_get_reg │ │ │ │ +0000cdd0: 696f 6e20 2875 6e73 6967 6e65 6420 696e ion (unsigned in │ │ │ │ +0000cde0: 7420 2a78 2c20 756e 7369 676e 6564 2069 t *x, unsigned i │ │ │ │ +0000cdf0: 6e74 202a 792c 2075 6e73 6967 6e65 6420 nt *y, unsigned │ │ │ │ +0000ce00: 696e 7420 2a77 6964 7468 2c20 756e 7369 int *width, unsi │ │ │ │ +0000ce10: 676e 6564 2069 6e74 202a 6865 6967 6874 gned int *height │ │ │ │ +0000ce20: 293b 0a20 2020 2a20 4465 7363 7269 7074 );. * Descript │ │ │ │ +0000ce30: 696f 6e3a 0a0a 2020 2020 2055 7365 6420 ion:.. Used │ │ │ │ +0000ce40: 746f 2071 7565 7279 2063 7572 7265 6e74 to query current │ │ │ │ +0000ce50: 2072 6567 696f 6e20 6469 6d65 6e73 696f region dimensio │ │ │ │ +0000ce60: 6e73 2e0a 0a31 302e 312e 3133 2067 7275 ns...10.1.13 gru │ │ │ │ +0000ce70: 625f 7669 6465 6f5f 6d61 705f 636f 6c6f b_video_map_colo │ │ │ │ +0000ce80: 720a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d r.-------------- │ │ │ │ +0000ce90: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a --------------.. │ │ │ │ +0000cea0: 2020 202a 2050 726f 746f 7479 7065 3a0a * Prototype:. │ │ │ │ +0000ceb0: 0a20 2020 2020 2020 2020 2067 7275 625f . grub_ │ │ │ │ +0000cec0: 7669 6465 6f5f 636f 6c6f 725f 740a 2020 video_color_t. │ │ │ │ +0000ced0: 2020 2020 2020 2020 6772 7562 5f76 6964 grub_vid │ │ │ │ +0000cee0: 656f 5f6d 6170 5f63 6f6c 6f72 2028 6772 eo_map_color (gr │ │ │ │ +0000cef0: 7562 5f75 696e 7433 325f 7420 636f 6c6f ub_uint32_t colo │ │ │ │ +0000cf00: 725f 6e61 6d65 293b 0a20 2020 2a20 4465 r_name);. * De │ │ │ │ +0000cf10: 7363 7269 7074 696f 6e3a 0a0a 2020 2020 scription:.. │ │ │ │ +0000cf20: 204d 6170 2063 6f6c 6f72 2063 616e 2062 Map color can b │ │ │ │ +0000cf30: 6520 7573 6564 2074 6f20 7375 7070 6f72 e used to suppor │ │ │ │ +0000cf40: 7420 636f 6c6f 7220 7468 656d 6573 2069 t color themes i │ │ │ │ +0000cf50: 6e20 4752 5542 2e20 5468 6572 6520 7769 n GRUB. There wi │ │ │ │ +0000cf60: 6c6c 0a20 2020 2020 6265 2063 6f6c 6c65 ll. be colle │ │ │ │ +0000cf70: 6374 696f 6e20 6f66 2063 6f6c 6f72 206e ction of color n │ │ │ │ +0000cf80: 616d 6573 2074 6861 7420 6361 6e20 6265 ames that can be │ │ │ │ +0000cf90: 2075 7365 6420 746f 2071 7565 7279 2061 used to query a │ │ │ │ +0000cfa0: 6374 7561 6c0a 2020 2020 2073 6372 6565 ctual. scree │ │ │ │ +0000cfb0: 6e20 6d61 7070 6564 2063 6f6c 6f72 2064 n mapped color d │ │ │ │ +0000cfc0: 6174 612e 2020 4578 616d 706c 6573 2063 ata. Examples c │ │ │ │ +0000cfd0: 6f75 6c64 2062 650a 2020 2020 2027 4752 ould be. 'GR │ │ │ │ +0000cfe0: 5542 5f43 4f4c 4f52 5f43 4f4e 534f 4c45 UB_COLOR_CONSOLE │ │ │ │ +0000cff0: 5f42 4143 4b47 524f 554e 4427 2c20 2747 _BACKGROUND', 'G │ │ │ │ +0000d000: 5255 425f 434f 4c4f 525f 434f 4e53 4f4c RUB_COLOR_CONSOL │ │ │ │ +0000d010: 455f 5445 5854 272e 2020 5468 650a 2020 E_TEXT'. The. │ │ │ │ +0000d020: 2020 2061 6374 7561 6c20 636f 6c6f 7220 actual color │ │ │ │ +0000d030: 6465 6669 6e65 7320 6172 6520 6e6f 7420 defines are not │ │ │ │ +0000d040: 7370 6563 6966 6965 6420 6174 2074 6869 specified at thi │ │ │ │ +0000d050: 7320 706f 696e 742e 0a0a 3130 2e31 2e31 s point...10.1.1 │ │ │ │ +0000d060: 3420 6772 7562 5f76 6964 656f 5f6d 6170 4 grub_video_map │ │ │ │ +0000d070: 5f72 6762 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d _rgb.----------- │ │ │ │ +0000d080: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a ---------------. │ │ │ │ +0000d090: 0a20 2020 2a20 5072 6f74 6f74 7970 653a . * Prototype: │ │ │ │ +0000d0a0: 0a0a 2020 2020 2020 2020 2020 6772 7562 .. grub │ │ │ │ +0000d0b0: 5f76 6964 656f 5f63 6f6c 6f72 5f74 0a20 _video_color_t. │ │ │ │ +0000d0c0: 2020 2020 2020 2020 2067 7275 625f 7669 grub_vi │ │ │ │ +0000d0d0: 6465 6f5f 6d61 705f 7267 6220 2867 7275 deo_map_rgb (gru │ │ │ │ +0000d0e0: 625f 7569 6e74 385f 7420 7265 642c 2067 b_uint8_t red, g │ │ │ │ +0000d0f0: 7275 625f 7569 6e74 385f 7420 6772 6565 rub_uint8_t gree │ │ │ │ +0000d100: 6e2c 2067 7275 625f 7569 6e74 385f 7420 n, grub_uint8_t │ │ │ │ +0000d110: 626c 7565 293b 0a20 2020 2a20 4465 7363 blue);. * Desc │ │ │ │ +0000d120: 7269 7074 696f 6e3a 0a0a 2020 2020 204d ription:.. M │ │ │ │ +0000d130: 6170 2052 4742 2076 616c 7565 7320 746f ap RGB values to │ │ │ │ +0000d140: 2063 6f6d 7061 7469 626c 6520 7363 7265 compatible scre │ │ │ │ +0000d150: 656e 2063 6f6c 6f72 2064 6174 612e 2020 en color data. │ │ │ │ +0000d160: 5661 6c75 6573 2061 7265 0a20 2020 2020 Values are. │ │ │ │ +0000d170: 6578 7065 6374 6564 2074 6f20 6265 2069 expected to be i │ │ │ │ +0000d180: 6e20 7261 6e67 6520 302d 3235 3520 616e n range 0-255 an │ │ │ │ +0000d190: 6420 696e 2052 4742 206d 6f64 6573 2074 d in RGB modes t │ │ │ │ +0000d1a0: 6865 7920 7769 6c6c 2062 650a 2020 2020 hey will be. │ │ │ │ +0000d1b0: 2063 6f6e 7665 7274 6564 2074 6f20 7363 converted to sc │ │ │ │ +0000d1c0: 7265 656e 2063 6f6c 6f72 2064 6174 612e reen color data. │ │ │ │ +0000d1d0: 2020 496e 2069 6e64 6578 2063 6f6c 6f72 In index color │ │ │ │ +0000d1e0: 206d 6f64 6573 2c20 696e 6465 7820 636f modes, index co │ │ │ │ +0000d1f0: 6c6f 720a 2020 2020 2070 616c 6574 7465 lor. palette │ │ │ │ +0000d200: 2077 696c 6c20 6265 2073 6561 7263 6865 will be searche │ │ │ │ +0000d210: 6420 666f 7220 7370 6563 6966 6965 6420 d for specified │ │ │ │ +0000d220: 636f 6c6f 7220 616e 6420 7468 656e 2069 color and then i │ │ │ │ +0000d230: 6e64 6578 2069 730a 2020 2020 2072 6574 ndex is. ret │ │ │ │ +0000d240: 7572 6e65 642e 0a0a 3130 2e31 2e31 3520 urned...10.1.15 │ │ │ │ +0000d250: 6772 7562 5f76 6964 656f 5f6d 6170 5f72 grub_video_map_r │ │ │ │ +0000d260: 6762 610a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d gba.------------ │ │ │ │ +0000d270: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a ---------------. │ │ │ │ +0000d280: 0a20 2020 2a20 5072 6f74 6f74 7970 653a . * Prototype: │ │ │ │ +0000d290: 0a0a 2020 2020 2020 2020 2020 6772 7562 .. grub │ │ │ │ +0000d2a0: 5f76 6964 656f 5f63 6f6c 6f72 5f74 0a20 _video_color_t. │ │ │ │ +0000d2b0: 2020 2020 2020 2020 2067 7275 625f 7669 grub_vi │ │ │ │ +0000d2c0: 6465 6f5f 6d61 705f 7267 6261 2028 6772 deo_map_rgba (gr │ │ │ │ +0000d2d0: 7562 5f75 696e 7438 5f74 2072 6564 2c20 ub_uint8_t red, │ │ │ │ +0000d2e0: 6772 7562 5f75 696e 7438 5f74 2067 7265 grub_uint8_t gre │ │ │ │ +0000d2f0: 656e 2c20 6772 7562 5f75 696e 7438 5f74 en, grub_uint8_t │ │ │ │ +0000d300: 2062 6c75 652c 2067 7275 625f 7569 6e74 blue, grub_uint │ │ │ │ +0000d310: 385f 7420 616c 7068 6129 3b0a 2020 202a 8_t alpha);. * │ │ │ │ +0000d320: 2044 6573 6372 6970 7469 6f6e 3a0a 0a20 Description:.. │ │ │ │ +0000d330: 2020 2020 4d61 7020 5247 4241 2076 616c Map RGBA val │ │ │ │ +0000d340: 7565 7320 746f 2063 6f6d 7061 7469 626c ues to compatibl │ │ │ │ +0000d350: 6520 7363 7265 656e 2063 6f6c 6f72 2064 e screen color d │ │ │ │ +0000d360: 6174 612e 2020 5661 6c75 6573 2061 7265 ata. Values are │ │ │ │ +0000d370: 0a20 2020 2020 6578 7065 6374 6564 2074 . expected t │ │ │ │ +0000d380: 6f20 6265 2069 6e20 7261 6e67 6520 302d o be in range 0- │ │ │ │ +0000d390: 3235 352e 2020 496e 2052 4742 4120 6d6f 255. In RGBA mo │ │ │ │ +0000d3a0: 6465 7320 7468 6579 2077 696c 6c20 6265 des they will be │ │ │ │ +0000d3b0: 0a20 2020 2020 636f 6e76 6572 7465 6420 . converted │ │ │ │ +0000d3c0: 746f 2073 6372 6565 6e20 636f 6c6f 7220 to screen color │ │ │ │ +0000d3d0: 6461 7461 2e20 2049 6e20 696e 6465 7820 data. In index │ │ │ │ +0000d3e0: 636f 6c6f 7220 6d6f 6465 732c 2069 6e64 color modes, ind │ │ │ │ +0000d3f0: 6578 2063 6f6c 6f72 0a20 2020 2020 7061 ex color. pa │ │ │ │ +0000d400: 6c65 7474 6520 7769 6c6c 2062 6520 7365 lette will be se │ │ │ │ +0000d410: 6172 6368 6564 2066 6f72 2062 6573 7420 arched for best │ │ │ │ +0000d420: 6d61 7463 6869 6e67 2063 6f6c 6f72 2061 matching color a │ │ │ │ +0000d430: 6e64 2069 7473 2069 6e64 6578 2069 730a nd its index is. │ │ │ │ +0000d440: 2020 2020 2072 6574 7572 6e65 642e 0a0a returned... │ │ │ │ +0000d450: 3130 2e31 2e31 3620 6772 7562 5f76 6964 10.1.16 grub_vid │ │ │ │ +0000d460: 656f 5f75 6e6d 6170 5f63 6f6c 6f72 0a2d eo_unmap_color.- │ │ │ │ 0000d470: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ -0000d480: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2020 2a20 ---------.. * │ │ │ │ -0000d490: 5072 6f74 6f74 7970 653a 0a0a 2020 2020 Prototype:.. │ │ │ │ -0000d4a0: 2020 2020 2020 6772 7562 5f65 7272 5f74 grub_err_t │ │ │ │ -0000d4b0: 0a20 2020 2020 2020 2020 2067 7275 625f . grub_ │ │ │ │ -0000d4c0: 7669 6465 6f5f 756e 6d61 705f 636f 6c6f video_unmap_colo │ │ │ │ -0000d4d0: 7220 2867 7275 625f 7669 6465 6f5f 636f r (grub_video_co │ │ │ │ -0000d4e0: 6c6f 725f 7420 636f 6c6f 722c 2067 7275 lor_t color, gru │ │ │ │ -0000d4f0: 625f 7569 6e74 385f 7420 2a72 6564 2c20 b_uint8_t *red, │ │ │ │ -0000d500: 6772 7562 5f75 696e 7438 5f74 202a 6772 grub_uint8_t *gr │ │ │ │ -0000d510: 6565 6e2c 2067 7275 625f 7569 6e74 385f een, grub_uint8_ │ │ │ │ -0000d520: 7420 2a62 6c75 652c 2067 7275 625f 7569 t *blue, grub_ui │ │ │ │ -0000d530: 6e74 385f 7420 2a61 6c70 6861 293b 0a20 nt8_t *alpha);. │ │ │ │ -0000d540: 2020 2a20 4465 7363 7269 7074 696f 6e3a * Description: │ │ │ │ -0000d550: 0a0a 2020 2020 2055 6e6d 6170 2063 6f6c .. Unmap col │ │ │ │ -0000d560: 6f72 2076 616c 7565 2066 726f 6d20 2763 or value from 'c │ │ │ │ -0000d570: 6f6c 6f72 2720 746f 2063 6f6c 6f72 2063 olor' to color c │ │ │ │ -0000d580: 6861 6e6e 656c 7320 696e 2027 7265 6427 hannels in 'red' │ │ │ │ -0000d590: 2c20 2767 7265 656e 272c 0a20 2020 2020 , 'green',. │ │ │ │ -0000d5a0: 2762 6c75 6527 2061 6e64 2027 616c 7068 'blue' and 'alph │ │ │ │ -0000d5b0: 6127 2e20 2056 616c 7565 7320 7769 6c6c a'. Values will │ │ │ │ -0000d5c0: 2062 6520 696e 2072 616e 6765 2030 2d32 be in range 0-2 │ │ │ │ -0000d5d0: 3535 2e20 2041 6374 6976 650a 2020 2020 55. Active. │ │ │ │ -0000d5e0: 2072 656e 6465 7269 6e67 2074 6172 6765 rendering targe │ │ │ │ -0000d5f0: 7420 7769 6c6c 2062 6520 7573 6564 2066 t will be used f │ │ │ │ -0000d600: 6f72 2063 6f6c 6f72 2064 6f6d 6169 6e2e or color domain. │ │ │ │ -0000d610: 2020 496e 2063 6173 6520 616c 7068 610a In case alpha. │ │ │ │ -0000d620: 2020 2020 2069 6e66 6f72 6d61 7469 6f6e information │ │ │ │ -0000d630: 2069 7320 6e6f 7420 6176 6169 6c61 626c is not availabl │ │ │ │ -0000d640: 6520 696e 2072 656e 6465 7269 6e67 2074 e in rendering t │ │ │ │ -0000d650: 6172 6765 742c 2069 7420 6973 2061 7373 arget, it is ass │ │ │ │ -0000d660: 756d 6564 2074 6f0a 2020 2020 2062 6520 umed to. be │ │ │ │ -0000d670: 6f70 6171 7565 2028 6861 7669 6e67 2076 opaque (having v │ │ │ │ -0000d680: 616c 7565 2032 3535 292e 0a0a 3130 2e31 alue 255)...10.1 │ │ │ │ -0000d690: 2e31 3720 6772 7562 5f76 6964 656f 5f66 .17 grub_video_f │ │ │ │ -0000d6a0: 696c 6c5f 7265 6374 0a2d 2d2d 2d2d 2d2d ill_rect.------- │ │ │ │ +0000d480: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 -------------.. │ │ │ │ +0000d490: 2020 2a20 5072 6f74 6f74 7970 653a 0a0a * Prototype:.. │ │ │ │ +0000d4a0: 2020 2020 2020 2020 2020 6772 7562 5f65 grub_e │ │ │ │ +0000d4b0: 7272 5f74 0a20 2020 2020 2020 2020 2067 rr_t. g │ │ │ │ +0000d4c0: 7275 625f 7669 6465 6f5f 756e 6d61 705f rub_video_unmap_ │ │ │ │ +0000d4d0: 636f 6c6f 7220 2867 7275 625f 7669 6465 color (grub_vide │ │ │ │ +0000d4e0: 6f5f 636f 6c6f 725f 7420 636f 6c6f 722c o_color_t color, │ │ │ │ +0000d4f0: 2067 7275 625f 7569 6e74 385f 7420 2a72 grub_uint8_t *r │ │ │ │ +0000d500: 6564 2c20 6772 7562 5f75 696e 7438 5f74 ed, grub_uint8_t │ │ │ │ +0000d510: 202a 6772 6565 6e2c 2067 7275 625f 7569 *green, grub_ui │ │ │ │ +0000d520: 6e74 385f 7420 2a62 6c75 652c 2067 7275 nt8_t *blue, gru │ │ │ │ +0000d530: 625f 7569 6e74 385f 7420 2a61 6c70 6861 b_uint8_t *alpha │ │ │ │ +0000d540: 293b 0a20 2020 2a20 4465 7363 7269 7074 );. * Descript │ │ │ │ +0000d550: 696f 6e3a 0a0a 2020 2020 2055 6e6d 6170 ion:.. Unmap │ │ │ │ +0000d560: 2063 6f6c 6f72 2076 616c 7565 2066 726f color value fro │ │ │ │ +0000d570: 6d20 2763 6f6c 6f72 2720 746f 2063 6f6c m 'color' to col │ │ │ │ +0000d580: 6f72 2063 6861 6e6e 656c 7320 696e 2027 or channels in ' │ │ │ │ +0000d590: 7265 6427 2c20 2767 7265 656e 272c 0a20 red', 'green',. │ │ │ │ +0000d5a0: 2020 2020 2762 6c75 6527 2061 6e64 2027 'blue' and ' │ │ │ │ +0000d5b0: 616c 7068 6127 2e20 2056 616c 7565 7320 alpha'. Values │ │ │ │ +0000d5c0: 7769 6c6c 2062 6520 696e 2072 616e 6765 will be in range │ │ │ │ +0000d5d0: 2030 2d32 3535 2e20 2041 6374 6976 650a 0-255. Active. │ │ │ │ +0000d5e0: 2020 2020 2072 656e 6465 7269 6e67 2074 rendering t │ │ │ │ +0000d5f0: 6172 6765 7420 7769 6c6c 2062 6520 7573 arget will be us │ │ │ │ +0000d600: 6564 2066 6f72 2063 6f6c 6f72 2064 6f6d ed for color dom │ │ │ │ +0000d610: 6169 6e2e 2020 496e 2063 6173 6520 616c ain. In case al │ │ │ │ +0000d620: 7068 610a 2020 2020 2069 6e66 6f72 6d61 pha. informa │ │ │ │ +0000d630: 7469 6f6e 2069 7320 6e6f 7420 6176 6169 tion is not avai │ │ │ │ +0000d640: 6c61 626c 6520 696e 2072 656e 6465 7269 lable in renderi │ │ │ │ +0000d650: 6e67 2074 6172 6765 742c 2069 7420 6973 ng target, it is │ │ │ │ +0000d660: 2061 7373 756d 6564 2074 6f0a 2020 2020 assumed to. │ │ │ │ +0000d670: 2062 6520 6f70 6171 7565 2028 6861 7669 be opaque (havi │ │ │ │ +0000d680: 6e67 2076 616c 7565 2032 3535 292e 0a0a ng value 255)... │ │ │ │ +0000d690: 3130 2e31 2e31 3720 6772 7562 5f76 6964 10.1.17 grub_vid │ │ │ │ +0000d6a0: 656f 5f66 696c 6c5f 7265 6374 0a2d 2d2d eo_fill_rect.--- │ │ │ │ 0000d6b0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ -0000d6c0: 2d2d 2d2d 2d0a 0a20 2020 2a20 5072 6f74 -----.. * Prot │ │ │ │ -0000d6d0: 6f74 7970 653a 0a0a 2020 2020 2020 2020 otype:.. │ │ │ │ -0000d6e0: 2020 6772 7562 5f65 7272 5f74 0a20 2020 grub_err_t. │ │ │ │ -0000d6f0: 2020 2020 2020 2067 7275 625f 7669 6465 grub_vide │ │ │ │ -0000d700: 6f5f 6669 6c6c 5f72 6563 7420 2867 7275 o_fill_rect (gru │ │ │ │ -0000d710: 625f 7669 6465 6f5f 636f 6c6f 725f 7420 b_video_color_t │ │ │ │ -0000d720: 636f 6c6f 722c 2069 6e74 2078 2c20 696e color, int x, in │ │ │ │ -0000d730: 7420 792c 2075 6e73 6967 6e65 6420 696e t y, unsigned in │ │ │ │ -0000d740: 7420 7769 6474 682c 2075 6e73 6967 6e65 t width, unsigne │ │ │ │ -0000d750: 6420 696e 7420 6865 6967 6874 293b 0a20 d int height);. │ │ │ │ -0000d760: 2020 2a20 4465 7363 7269 7074 696f 6e3a * Description: │ │ │ │ -0000d770: 0a0a 2020 2020 2046 696c 6c20 7370 6563 .. Fill spec │ │ │ │ -0000d780: 6966 6965 6420 6172 6561 206c 696d 6974 ified area limit │ │ │ │ -0000d790: 6564 2062 7920 6769 7665 6e20 636f 6f72 ed by given coor │ │ │ │ -0000d7a0: 6469 6e61 7465 7320 7769 7468 696e 2073 dinates within s │ │ │ │ -0000d7b0: 7065 6369 6669 6564 0a20 2020 2020 7669 pecified. vi │ │ │ │ -0000d7c0: 6577 706f 7274 2e20 204e 6567 6174 6976 ewport. Negativ │ │ │ │ -0000d7d0: 6520 636f 6f72 6469 6e61 7465 7320 6172 e coordinates ar │ │ │ │ -0000d7e0: 6520 6163 6365 7074 6564 2069 6e20 6f72 e accepted in or │ │ │ │ -0000d7f0: 6465 7220 746f 2061 6c6c 6f77 2065 6173 der to allow eas │ │ │ │ -0000d800: 790a 2020 2020 206d 6f76 696e 6720 6f66 y. moving of │ │ │ │ -0000d810: 2072 6563 7461 6e67 6c65 2077 6974 6869 rectangle withi │ │ │ │ -0000d820: 6e20 7669 6577 706f 7274 2e20 2049 6620 n viewport. If │ │ │ │ -0000d830: 636f 6f72 6469 6e61 7465 7320 6172 6520 coordinates are │ │ │ │ -0000d840: 6e65 6761 7469 7665 2c0a 2020 2020 2061 negative,. a │ │ │ │ -0000d850: 7265 6120 6f66 2074 6865 2072 6563 7461 rea of the recta │ │ │ │ -0000d860: 6e67 6c65 2077 696c 6c20 6265 2073 6872 ngle will be shr │ │ │ │ -0000d870: 696e 6b65 6e20 746f 2066 6f6c 6c6f 7720 inken to follow │ │ │ │ -0000d880: 7369 7a65 206c 696d 6974 7320 6f66 2074 size limits of t │ │ │ │ -0000d890: 6865 0a20 2020 2020 7669 6577 706f 7274 he. viewport │ │ │ │ -0000d8a0: 2e0a 0a20 2020 2020 536f 6674 7761 7265 ... Software │ │ │ │ -0000d8b0: 2064 6576 656c 6f70 6572 2073 686f 756c developer shoul │ │ │ │ -0000d8c0: 6420 7573 6520 6569 7468 6572 2027 6772 d use either 'gr │ │ │ │ -0000d8d0: 7562 5f76 6964 656f 5f6d 6170 5f63 6f6c ub_video_map_col │ │ │ │ -0000d8e0: 6f72 272c 0a20 2020 2020 2767 7275 625f or',. 'grub_ │ │ │ │ -0000d8f0: 7669 6465 6f5f 6d61 705f 7267 6227 206f video_map_rgb' o │ │ │ │ -0000d900: 7220 2767 7275 625f 7669 6465 6f5f 6d61 r 'grub_video_ma │ │ │ │ -0000d910: 705f 7267 6261 2720 746f 206d 6170 2072 p_rgba' to map r │ │ │ │ -0000d920: 6571 7565 7374 6564 0a20 2020 2020 636f equested. co │ │ │ │ -0000d930: 6c6f 7220 746f 2027 636f 6c6f 7227 2070 lor to 'color' p │ │ │ │ -0000d940: 6172 616d 6574 6572 2e0a 0a31 302e 312e arameter...10.1. │ │ │ │ -0000d950: 3138 2067 7275 625f 7669 6465 6f5f 626c 18 grub_video_bl │ │ │ │ -0000d960: 6974 5f67 6c79 7068 0a2d 2d2d 2d2d 2d2d it_glyph.------- │ │ │ │ +0000d6c0: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2020 2a20 ---------.. * │ │ │ │ +0000d6d0: 5072 6f74 6f74 7970 653a 0a0a 2020 2020 Prototype:.. │ │ │ │ +0000d6e0: 2020 2020 2020 6772 7562 5f65 7272 5f74 grub_err_t │ │ │ │ +0000d6f0: 0a20 2020 2020 2020 2020 2067 7275 625f . grub_ │ │ │ │ +0000d700: 7669 6465 6f5f 6669 6c6c 5f72 6563 7420 video_fill_rect │ │ │ │ +0000d710: 2867 7275 625f 7669 6465 6f5f 636f 6c6f (grub_video_colo │ │ │ │ +0000d720: 725f 7420 636f 6c6f 722c 2069 6e74 2078 r_t color, int x │ │ │ │ +0000d730: 2c20 696e 7420 792c 2075 6e73 6967 6e65 , int y, unsigne │ │ │ │ +0000d740: 6420 696e 7420 7769 6474 682c 2075 6e73 d int width, uns │ │ │ │ +0000d750: 6967 6e65 6420 696e 7420 6865 6967 6874 igned int height │ │ │ │ +0000d760: 293b 0a20 2020 2a20 4465 7363 7269 7074 );. * Descript │ │ │ │ +0000d770: 696f 6e3a 0a0a 2020 2020 2046 696c 6c20 ion:.. Fill │ │ │ │ +0000d780: 7370 6563 6966 6965 6420 6172 6561 206c specified area l │ │ │ │ +0000d790: 696d 6974 6564 2062 7920 6769 7665 6e20 imited by given │ │ │ │ +0000d7a0: 636f 6f72 6469 6e61 7465 7320 7769 7468 coordinates with │ │ │ │ +0000d7b0: 696e 2073 7065 6369 6669 6564 0a20 2020 in specified. │ │ │ │ +0000d7c0: 2020 7669 6577 706f 7274 2e20 204e 6567 viewport. Neg │ │ │ │ +0000d7d0: 6174 6976 6520 636f 6f72 6469 6e61 7465 ative coordinate │ │ │ │ +0000d7e0: 7320 6172 6520 6163 6365 7074 6564 2069 s are accepted i │ │ │ │ +0000d7f0: 6e20 6f72 6465 7220 746f 2061 6c6c 6f77 n order to allow │ │ │ │ +0000d800: 2065 6173 790a 2020 2020 206d 6f76 696e easy. movin │ │ │ │ +0000d810: 6720 6f66 2072 6563 7461 6e67 6c65 2077 g of rectangle w │ │ │ │ +0000d820: 6974 6869 6e20 7669 6577 706f 7274 2e20 ithin viewport. │ │ │ │ +0000d830: 2049 6620 636f 6f72 6469 6e61 7465 7320 If coordinates │ │ │ │ +0000d840: 6172 6520 6e65 6761 7469 7665 2c0a 2020 are negative,. │ │ │ │ +0000d850: 2020 2061 7265 6120 6f66 2074 6865 2072 area of the r │ │ │ │ +0000d860: 6563 7461 6e67 6c65 2077 696c 6c20 6265 ectangle will be │ │ │ │ +0000d870: 2073 6872 696e 6b65 6e20 746f 2066 6f6c shrinken to fol │ │ │ │ +0000d880: 6c6f 7720 7369 7a65 206c 696d 6974 7320 low size limits │ │ │ │ +0000d890: 6f66 2074 6865 0a20 2020 2020 7669 6577 of the. view │ │ │ │ +0000d8a0: 706f 7274 2e0a 0a20 2020 2020 536f 6674 port... Soft │ │ │ │ +0000d8b0: 7761 7265 2064 6576 656c 6f70 6572 2073 ware developer s │ │ │ │ +0000d8c0: 686f 756c 6420 7573 6520 6569 7468 6572 hould use either │ │ │ │ +0000d8d0: 2027 6772 7562 5f76 6964 656f 5f6d 6170 'grub_video_map │ │ │ │ +0000d8e0: 5f63 6f6c 6f72 272c 0a20 2020 2020 2767 _color',. 'g │ │ │ │ +0000d8f0: 7275 625f 7669 6465 6f5f 6d61 705f 7267 rub_video_map_rg │ │ │ │ +0000d900: 6227 206f 7220 2767 7275 625f 7669 6465 b' or 'grub_vide │ │ │ │ +0000d910: 6f5f 6d61 705f 7267 6261 2720 746f 206d o_map_rgba' to m │ │ │ │ +0000d920: 6170 2072 6571 7565 7374 6564 0a20 2020 ap requested. │ │ │ │ +0000d930: 2020 636f 6c6f 7220 746f 2027 636f 6c6f color to 'colo │ │ │ │ +0000d940: 7227 2070 6172 616d 6574 6572 2e0a 0a31 r' parameter...1 │ │ │ │ +0000d950: 302e 312e 3138 2067 7275 625f 7669 6465 0.1.18 grub_vide │ │ │ │ +0000d960: 6f5f 626c 6974 5f67 6c79 7068 0a2d 2d2d o_blit_glyph.--- │ │ │ │ 0000d970: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ -0000d980: 2d2d 2d2d 2d2d 0a0a 2020 202a 2050 726f ------.. * Pro │ │ │ │ -0000d990: 746f 7479 7065 3a0a 0a20 2020 2020 2020 totype:.. │ │ │ │ -0000d9a0: 2020 2067 7275 625f 6572 725f 740a 2020 grub_err_t. │ │ │ │ -0000d9b0: 2020 2020 2020 2020 6772 7562 5f76 6964 grub_vid │ │ │ │ -0000d9c0: 656f 5f62 6c69 745f 676c 7970 6820 2873 eo_blit_glyph (s │ │ │ │ -0000d9d0: 7472 7563 7420 6772 7562 5f66 6f6e 745f truct grub_font_ │ │ │ │ -0000d9e0: 676c 7970 6820 2a67 6c79 7068 2c20 6772 glyph *glyph, gr │ │ │ │ -0000d9f0: 7562 5f76 6964 656f 5f63 6f6c 6f72 5f74 ub_video_color_t │ │ │ │ -0000da00: 2063 6f6c 6f72 2c20 696e 7420 782c 2069 color, int x, i │ │ │ │ -0000da10: 6e74 2079 293b 0a20 2020 2020 2020 2020 nt y);. │ │ │ │ -0000da20: 2073 7472 7563 7420 6772 7562 5f66 6f6e struct grub_fon │ │ │ │ -0000da30: 745f 676c 7970 6820 7b0a 2020 2020 2020 t_glyph {. │ │ │ │ -0000da40: 2020 2020 2020 2020 2f2a 2054 4244 2e20 /* TBD. │ │ │ │ -0000da50: 2a2f 0a20 2020 2020 2020 2020 207d 3b0a */. };. │ │ │ │ -0000da60: 2020 202a 2044 6573 6372 6970 7469 6f6e * Description │ │ │ │ -0000da70: 3a0a 0a20 2020 2020 5573 6564 2074 6f20 :.. Used to │ │ │ │ -0000da80: 626c 6974 2067 6c79 7068 2074 6f20 7669 blit glyph to vi │ │ │ │ -0000da90: 6577 706f 7274 2069 6e20 7370 6563 6966 ewport in specif │ │ │ │ -0000daa0: 6965 6420 636f 6f64 696e 6174 6573 2e20 ied coodinates. │ │ │ │ -0000dab0: 2049 6620 676c 7970 680a 2020 2020 2069 If glyph. i │ │ │ │ -0000dac0: 7320 6174 2065 6467 6520 6f66 2076 6965 s at edge of vie │ │ │ │ -0000dad0: 7770 6f72 742c 2070 6978 656c 7320 6f75 wport, pixels ou │ │ │ │ -0000dae0: 7473 6964 6520 6f66 2076 6965 7770 6f72 tside of viewpor │ │ │ │ -0000daf0: 7420 7769 6c6c 2062 6520 636c 6970 7065 t will be clippe │ │ │ │ -0000db00: 640a 2020 2020 206f 7574 2e20 2053 6f66 d. out. Sof │ │ │ │ -0000db10: 7477 6172 6520 6465 7665 6c6f 7065 7220 tware developer │ │ │ │ -0000db20: 7368 6f75 6c64 2075 7365 2065 6974 6865 should use eithe │ │ │ │ -0000db30: 7220 2767 7275 625f 7669 6465 6f5f 6d61 r 'grub_video_ma │ │ │ │ -0000db40: 705f 7267 6227 206f 720a 2020 2020 2027 p_rgb' or. ' │ │ │ │ -0000db50: 6772 7562 5f76 6964 656f 5f6d 6170 5f72 grub_video_map_r │ │ │ │ -0000db60: 6762 6127 2074 6f20 6d61 7020 7265 7175 gba' to map requ │ │ │ │ -0000db70: 6573 7465 6420 636f 6c6f 7220 746f 2027 ested color to ' │ │ │ │ -0000db80: 636f 6c6f 7227 2070 6172 616d 6574 6572 color' parameter │ │ │ │ -0000db90: 2e0a 0a31 302e 312e 3139 2067 7275 625f ...10.1.19 grub_ │ │ │ │ -0000dba0: 7669 6465 6f5f 626c 6974 5f62 6974 6d61 video_blit_bitma │ │ │ │ -0000dbb0: 700a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d p.-------------- │ │ │ │ +0000d980: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 2020 202a ----------.. * │ │ │ │ +0000d990: 2050 726f 746f 7479 7065 3a0a 0a20 2020 Prototype:.. │ │ │ │ +0000d9a0: 2020 2020 2020 2067 7275 625f 6572 725f grub_err_ │ │ │ │ +0000d9b0: 740a 2020 2020 2020 2020 2020 6772 7562 t. grub │ │ │ │ +0000d9c0: 5f76 6964 656f 5f62 6c69 745f 676c 7970 _video_blit_glyp │ │ │ │ +0000d9d0: 6820 2873 7472 7563 7420 6772 7562 5f66 h (struct grub_f │ │ │ │ +0000d9e0: 6f6e 745f 676c 7970 6820 2a67 6c79 7068 ont_glyph *glyph │ │ │ │ +0000d9f0: 2c20 6772 7562 5f76 6964 656f 5f63 6f6c , grub_video_col │ │ │ │ +0000da00: 6f72 5f74 2063 6f6c 6f72 2c20 696e 7420 or_t color, int │ │ │ │ +0000da10: 782c 2069 6e74 2079 293b 0a20 2020 2020 x, int y);. │ │ │ │ +0000da20: 2020 2020 2073 7472 7563 7420 6772 7562 struct grub │ │ │ │ +0000da30: 5f66 6f6e 745f 676c 7970 6820 7b0a 2020 _font_glyph {. │ │ │ │ +0000da40: 2020 2020 2020 2020 2020 2020 2f2a 2054 /* T │ │ │ │ +0000da50: 4244 2e20 2a2f 0a20 2020 2020 2020 2020 BD. */. │ │ │ │ +0000da60: 207d 3b0a 2020 202a 2044 6573 6372 6970 };. * Descrip │ │ │ │ +0000da70: 7469 6f6e 3a0a 0a20 2020 2020 5573 6564 tion:.. Used │ │ │ │ +0000da80: 2074 6f20 626c 6974 2067 6c79 7068 2074 to blit glyph t │ │ │ │ +0000da90: 6f20 7669 6577 706f 7274 2069 6e20 7370 o viewport in sp │ │ │ │ +0000daa0: 6563 6966 6965 6420 636f 6f64 696e 6174 ecified coodinat │ │ │ │ +0000dab0: 6573 2e20 2049 6620 676c 7970 680a 2020 es. If glyph. │ │ │ │ +0000dac0: 2020 2069 7320 6174 2065 6467 6520 6f66 is at edge of │ │ │ │ +0000dad0: 2076 6965 7770 6f72 742c 2070 6978 656c viewport, pixel │ │ │ │ +0000dae0: 7320 6f75 7473 6964 6520 6f66 2076 6965 s outside of vie │ │ │ │ +0000daf0: 7770 6f72 7420 7769 6c6c 2062 6520 636c wport will be cl │ │ │ │ +0000db00: 6970 7065 640a 2020 2020 206f 7574 2e20 ipped. out. │ │ │ │ +0000db10: 2053 6f66 7477 6172 6520 6465 7665 6c6f Software develo │ │ │ │ +0000db20: 7065 7220 7368 6f75 6c64 2075 7365 2065 per should use e │ │ │ │ +0000db30: 6974 6865 7220 2767 7275 625f 7669 6465 ither 'grub_vide │ │ │ │ +0000db40: 6f5f 6d61 705f 7267 6227 206f 720a 2020 o_map_rgb' or. │ │ │ │ +0000db50: 2020 2027 6772 7562 5f76 6964 656f 5f6d 'grub_video_m │ │ │ │ +0000db60: 6170 5f72 6762 6127 2074 6f20 6d61 7020 ap_rgba' to map │ │ │ │ +0000db70: 7265 7175 6573 7465 6420 636f 6c6f 7220 requested color │ │ │ │ +0000db80: 746f 2027 636f 6c6f 7227 2070 6172 616d to 'color' param │ │ │ │ +0000db90: 6574 6572 2e0a 0a31 302e 312e 3139 2067 eter...10.1.19 g │ │ │ │ +0000dba0: 7275 625f 7669 6465 6f5f 626c 6974 5f62 rub_video_blit_b │ │ │ │ +0000dbb0: 6974 6d61 700a 2d2d 2d2d 2d2d 2d2d 2d2d itmap.---------- │ │ │ │ 0000dbc0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ -0000dbd0: 0a0a 2020 202a 2050 726f 746f 7479 7065 .. * Prototype │ │ │ │ -0000dbe0: 3a0a 0a20 2020 2020 2020 2020 2067 7275 :.. gru │ │ │ │ -0000dbf0: 625f 6572 725f 740a 2020 2020 2020 2020 b_err_t. │ │ │ │ -0000dc00: 2020 6772 7562 5f76 6964 656f 5f62 6c69 grub_video_bli │ │ │ │ -0000dc10: 745f 6269 746d 6170 2028 7374 7275 6374 t_bitmap (struct │ │ │ │ -0000dc20: 2067 7275 625f 7669 6465 6f5f 6269 746d grub_video_bitm │ │ │ │ -0000dc30: 6170 202a 6269 746d 6170 2c20 656e 756d ap *bitmap, enum │ │ │ │ -0000dc40: 2067 7275 625f 7669 6465 6f5f 626c 6974 grub_video_blit │ │ │ │ -0000dc50: 5f6f 7065 7261 746f 7273 206f 7065 722c _operators oper, │ │ │ │ -0000dc60: 2069 6e74 2078 2c20 696e 7420 792c 2069 int x, int y, i │ │ │ │ -0000dc70: 6e74 206f 6666 7365 745f 782c 2069 6e74 nt offset_x, int │ │ │ │ -0000dc80: 206f 6666 7365 745f 792c 2075 6e73 6967 offset_y, unsig │ │ │ │ -0000dc90: 6e65 6420 696e 7420 7769 6474 682c 2075 ned int width, u │ │ │ │ -0000dca0: 6e73 6967 6e65 6420 696e 7420 6865 6967 nsigned int heig │ │ │ │ -0000dcb0: 6874 293b 0a20 2020 2020 2020 2020 2073 ht);. s │ │ │ │ -0000dcc0: 7472 7563 7420 6772 7562 5f76 6964 656f truct grub_video │ │ │ │ -0000dcd0: 5f62 6974 6d61 700a 2020 2020 2020 2020 _bitmap. │ │ │ │ -0000dce0: 2020 7b0a 2020 2020 2020 2020 2020 2020 {. │ │ │ │ -0000dcf0: 2020 2f2a 2054 4244 2e20 2a2f 0a20 2020 /* TBD. */. │ │ │ │ -0000dd00: 2020 2020 2020 207d 3b0a 0a20 2020 2020 };.. │ │ │ │ -0000dd10: 2020 2020 2065 6e75 6d20 6772 7562 5f76 enum grub_v │ │ │ │ -0000dd20: 6964 656f 5f62 6c69 745f 6f70 6572 6174 ideo_blit_operat │ │ │ │ -0000dd30: 6f72 730a 2020 2020 2020 2020 2020 2020 ors. │ │ │ │ -0000dd40: 7b0a 2020 2020 2020 2020 2020 2020 2020 {. │ │ │ │ -0000dd50: 4752 5542 5f56 4944 454f 5f42 4c49 545f GRUB_VIDEO_BLIT_ │ │ │ │ -0000dd60: 5245 504c 4143 452c 0a20 2020 2020 2020 REPLACE,. │ │ │ │ -0000dd70: 2020 2020 2020 2047 5255 425f 5649 4445 GRUB_VIDE │ │ │ │ -0000dd80: 4f5f 424c 4954 5f42 4c45 4e44 0a20 2020 O_BLIT_BLEND. │ │ │ │ -0000dd90: 2020 2020 2020 2020 207d 3b0a 2020 202a };. * │ │ │ │ -0000dda0: 2044 6573 6372 6970 7469 6f6e 3a0a 0a20 Description:.. │ │ │ │ -0000ddb0: 2020 2020 5573 6564 2074 6f20 626c 6974 Used to blit │ │ │ │ -0000ddc0: 2062 6974 6d61 7020 746f 2076 6965 7770 bitmap to viewp │ │ │ │ -0000ddd0: 6f72 7420 696e 2073 7065 6369 6669 6564 ort in specified │ │ │ │ -0000dde0: 2063 6f6f 7264 696e 6174 6573 2e20 2049 coordinates. I │ │ │ │ -0000ddf0: 6620 7061 7274 0a20 2020 2020 6f66 2062 f part. of b │ │ │ │ -0000de00: 6974 6d61 7020 6973 206f 7574 7369 6465 itmap is outside │ │ │ │ -0000de10: 206f 6620 7669 6577 706f 7274 2072 6567 of viewport reg │ │ │ │ -0000de20: 696f 6e2c 2069 7420 7769 6c6c 2062 6520 ion, it will be │ │ │ │ -0000de30: 636c 6970 7065 6420 6f75 742e 0a20 2020 clipped out.. │ │ │ │ -0000de40: 2020 4f66 6673 6574 7320 6166 6665 6374 Offsets affect │ │ │ │ -0000de50: 2062 6974 6d61 7020 706f 7369 7469 6f6e bitmap position │ │ │ │ -0000de60: 2077 6865 7265 2064 6174 6120 7769 6c6c where data will │ │ │ │ -0000de70: 2062 6520 636f 7069 6564 2066 726f 6d2e be copied from. │ │ │ │ -0000de80: 0a20 2020 2020 4e65 6761 7469 7665 2076 . Negative v │ │ │ │ -0000de90: 616c 7565 7320 666f 7220 626f 7468 2076 alues for both v │ │ │ │ -0000dea0: 6965 7770 6f72 7420 636f 6f72 6469 6e61 iewport coordina │ │ │ │ -0000deb0: 7465 7320 616e 6420 6269 746d 6170 206f tes and bitmap o │ │ │ │ -0000dec0: 6666 7365 740a 2020 2020 2063 6f6f 7264 ffset. coord │ │ │ │ -0000ded0: 696e 6174 6573 2061 7265 2061 6c6c 6f77 inates are allow │ │ │ │ -0000dee0: 6564 2e20 2049 6620 6461 7461 2069 7320 ed. If data is │ │ │ │ -0000def0: 6c6f 6f6b 6564 206f 7574 206f 6620 626f looked out of bo │ │ │ │ -0000df00: 756e 6473 206f 660a 2020 2020 2062 6974 unds of. bit │ │ │ │ -0000df10: 6d61 702c 2063 6f6c 6f72 2076 616c 7565 map, color value │ │ │ │ -0000df20: 2077 696c 6c20 6265 2061 7373 756d 6564 will be assumed │ │ │ │ -0000df30: 2074 6f20 6265 2074 7261 6e73 7061 7265 to be transpare │ │ │ │ -0000df40: 6e74 2e20 2049 6620 7669 6577 706f 7274 nt. If viewport │ │ │ │ -0000df50: 0a20 2020 2020 636f 6f72 6469 6e61 7465 . coordinate │ │ │ │ -0000df60: 7320 6172 6520 6e65 6761 7469 7665 2c20 s are negative, │ │ │ │ -0000df70: 6172 6561 206f 6620 7468 6520 626c 6974 area of the blit │ │ │ │ -0000df80: 7465 6420 7265 6374 616e 676c 6520 7769 ted rectangle wi │ │ │ │ -0000df90: 6c6c 2062 650a 2020 2020 2073 6872 696e ll be. shrin │ │ │ │ -0000dfa0: 6b65 6e20 746f 2066 6f6c 6c6f 7720 7369 ken to follow si │ │ │ │ -0000dfb0: 7a65 206c 696d 6974 7320 6f66 2074 6865 ze limits of the │ │ │ │ -0000dfc0: 2076 6965 7770 6f72 7420 616e 6420 6269 viewport and bi │ │ │ │ -0000dfd0: 746d 6170 2e0a 2020 2020 2042 6c69 7474 tmap.. Blitt │ │ │ │ -0000dfe0: 696e 6720 6f70 6572 6174 6f72 2027 6f70 ing operator 'op │ │ │ │ -0000dff0: 6572 2720 7370 6563 6966 6965 7320 7368 er' specifies sh │ │ │ │ -0000e000: 6f75 6c64 2073 6f75 7263 6520 7069 7865 ould source pixe │ │ │ │ -0000e010: 6c20 7265 706c 6163 6520 6461 7461 0a20 l replace data. │ │ │ │ -0000e020: 2020 2020 696e 2073 6372 6565 6e20 6f72 in screen or │ │ │ │ -0000e030: 2062 6c65 6e64 2077 6974 6820 7069 7865 blend with pixe │ │ │ │ -0000e040: 6c20 616c 7068 6120 7661 6c75 652e 0a0a l alpha value... │ │ │ │ -0000e050: 2020 2020 2053 6f66 7477 6172 6520 6465 Software de │ │ │ │ -0000e060: 7665 6c6f 7065 7220 7368 6f75 6c64 2075 veloper should u │ │ │ │ -0000e070: 7365 2027 6772 7562 5f76 6964 656f 5f62 se 'grub_video_b │ │ │ │ -0000e080: 6974 6d61 705f 6372 6561 7465 2720 6f72 itmap_create' or │ │ │ │ -0000e090: 0a20 2020 2020 2767 7275 625f 7669 6465 . 'grub_vide │ │ │ │ -0000e0a0: 6f5f 6269 746d 6170 5f6c 6f61 6427 2074 o_bitmap_load' t │ │ │ │ -0000e0b0: 6f20 6372 6561 7465 206f 7220 6c6f 6164 o create or load │ │ │ │ -0000e0c0: 2062 6974 6d61 7020 6461 7461 2e0a 0a31 bitmap data...1 │ │ │ │ -0000e0d0: 302e 312e 3230 2067 7275 625f 7669 6465 0.1.20 grub_vide │ │ │ │ -0000e0e0: 6f5f 626c 6974 5f72 656e 6465 725f 7461 o_blit_render_ta │ │ │ │ -0000e0f0: 7267 6574 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d rget.----------- │ │ │ │ +0000dbd0: 2d2d 2d2d 0a0a 2020 202a 2050 726f 746f ----.. * Proto │ │ │ │ +0000dbe0: 7479 7065 3a0a 0a20 2020 2020 2020 2020 type:.. │ │ │ │ +0000dbf0: 2067 7275 625f 6572 725f 740a 2020 2020 grub_err_t. │ │ │ │ +0000dc00: 2020 2020 2020 6772 7562 5f76 6964 656f grub_video │ │ │ │ +0000dc10: 5f62 6c69 745f 6269 746d 6170 2028 7374 _blit_bitmap (st │ │ │ │ +0000dc20: 7275 6374 2067 7275 625f 7669 6465 6f5f ruct grub_video_ │ │ │ │ +0000dc30: 6269 746d 6170 202a 6269 746d 6170 2c20 bitmap *bitmap, │ │ │ │ +0000dc40: 656e 756d 2067 7275 625f 7669 6465 6f5f enum grub_video_ │ │ │ │ +0000dc50: 626c 6974 5f6f 7065 7261 746f 7273 206f blit_operators o │ │ │ │ +0000dc60: 7065 722c 2069 6e74 2078 2c20 696e 7420 per, int x, int │ │ │ │ +0000dc70: 792c 2069 6e74 206f 6666 7365 745f 782c y, int offset_x, │ │ │ │ +0000dc80: 2069 6e74 206f 6666 7365 745f 792c 2075 int offset_y, u │ │ │ │ +0000dc90: 6e73 6967 6e65 6420 696e 7420 7769 6474 nsigned int widt │ │ │ │ +0000dca0: 682c 2075 6e73 6967 6e65 6420 696e 7420 h, unsigned int │ │ │ │ +0000dcb0: 6865 6967 6874 293b 0a20 2020 2020 2020 height);. │ │ │ │ +0000dcc0: 2020 2073 7472 7563 7420 6772 7562 5f76 struct grub_v │ │ │ │ +0000dcd0: 6964 656f 5f62 6974 6d61 700a 2020 2020 ideo_bitmap. │ │ │ │ +0000dce0: 2020 2020 2020 7b0a 2020 2020 2020 2020 {. │ │ │ │ +0000dcf0: 2020 2020 2020 2f2a 2054 4244 2e20 2a2f /* TBD. */ │ │ │ │ +0000dd00: 0a20 2020 2020 2020 2020 207d 3b0a 0a20 . };.. │ │ │ │ +0000dd10: 2020 2020 2020 2020 2065 6e75 6d20 6772 enum gr │ │ │ │ +0000dd20: 7562 5f76 6964 656f 5f62 6c69 745f 6f70 ub_video_blit_op │ │ │ │ +0000dd30: 6572 6174 6f72 730a 2020 2020 2020 2020 erators. │ │ │ │ +0000dd40: 2020 2020 7b0a 2020 2020 2020 2020 2020 {. │ │ │ │ +0000dd50: 2020 2020 4752 5542 5f56 4944 454f 5f42 GRUB_VIDEO_B │ │ │ │ +0000dd60: 4c49 545f 5245 504c 4143 452c 0a20 2020 LIT_REPLACE,. │ │ │ │ +0000dd70: 2020 2020 2020 2020 2020 2047 5255 425f GRUB_ │ │ │ │ +0000dd80: 5649 4445 4f5f 424c 4954 5f42 4c45 4e44 VIDEO_BLIT_BLEND │ │ │ │ +0000dd90: 0a20 2020 2020 2020 2020 2020 207d 3b0a . };. │ │ │ │ +0000dda0: 2020 202a 2044 6573 6372 6970 7469 6f6e * Description │ │ │ │ +0000ddb0: 3a0a 0a20 2020 2020 5573 6564 2074 6f20 :.. Used to │ │ │ │ +0000ddc0: 626c 6974 2062 6974 6d61 7020 746f 2076 blit bitmap to v │ │ │ │ +0000ddd0: 6965 7770 6f72 7420 696e 2073 7065 6369 iewport in speci │ │ │ │ +0000dde0: 6669 6564 2063 6f6f 7264 696e 6174 6573 fied coordinates │ │ │ │ +0000ddf0: 2e20 2049 6620 7061 7274 0a20 2020 2020 . If part. │ │ │ │ +0000de00: 6f66 2062 6974 6d61 7020 6973 206f 7574 of bitmap is out │ │ │ │ +0000de10: 7369 6465 206f 6620 7669 6577 706f 7274 side of viewport │ │ │ │ +0000de20: 2072 6567 696f 6e2c 2069 7420 7769 6c6c region, it will │ │ │ │ +0000de30: 2062 6520 636c 6970 7065 6420 6f75 742e be clipped out. │ │ │ │ +0000de40: 0a20 2020 2020 4f66 6673 6574 7320 6166 . Offsets af │ │ │ │ +0000de50: 6665 6374 2062 6974 6d61 7020 706f 7369 fect bitmap posi │ │ │ │ +0000de60: 7469 6f6e 2077 6865 7265 2064 6174 6120 tion where data │ │ │ │ +0000de70: 7769 6c6c 2062 6520 636f 7069 6564 2066 will be copied f │ │ │ │ +0000de80: 726f 6d2e 0a20 2020 2020 4e65 6761 7469 rom.. Negati │ │ │ │ +0000de90: 7665 2076 616c 7565 7320 666f 7220 626f ve values for bo │ │ │ │ +0000dea0: 7468 2076 6965 7770 6f72 7420 636f 6f72 th viewport coor │ │ │ │ +0000deb0: 6469 6e61 7465 7320 616e 6420 6269 746d dinates and bitm │ │ │ │ +0000dec0: 6170 206f 6666 7365 740a 2020 2020 2063 ap offset. c │ │ │ │ +0000ded0: 6f6f 7264 696e 6174 6573 2061 7265 2061 oordinates are a │ │ │ │ +0000dee0: 6c6c 6f77 6564 2e20 2049 6620 6461 7461 llowed. If data │ │ │ │ +0000def0: 2069 7320 6c6f 6f6b 6564 206f 7574 206f is looked out o │ │ │ │ +0000df00: 6620 626f 756e 6473 206f 660a 2020 2020 f bounds of. │ │ │ │ +0000df10: 2062 6974 6d61 702c 2063 6f6c 6f72 2076 bitmap, color v │ │ │ │ +0000df20: 616c 7565 2077 696c 6c20 6265 2061 7373 alue will be ass │ │ │ │ +0000df30: 756d 6564 2074 6f20 6265 2074 7261 6e73 umed to be trans │ │ │ │ +0000df40: 7061 7265 6e74 2e20 2049 6620 7669 6577 parent. If view │ │ │ │ +0000df50: 706f 7274 0a20 2020 2020 636f 6f72 6469 port. coordi │ │ │ │ +0000df60: 6e61 7465 7320 6172 6520 6e65 6761 7469 nates are negati │ │ │ │ +0000df70: 7665 2c20 6172 6561 206f 6620 7468 6520 ve, area of the │ │ │ │ +0000df80: 626c 6974 7465 6420 7265 6374 616e 676c blitted rectangl │ │ │ │ +0000df90: 6520 7769 6c6c 2062 650a 2020 2020 2073 e will be. s │ │ │ │ +0000dfa0: 6872 696e 6b65 6e20 746f 2066 6f6c 6c6f hrinken to follo │ │ │ │ +0000dfb0: 7720 7369 7a65 206c 696d 6974 7320 6f66 w size limits of │ │ │ │ +0000dfc0: 2074 6865 2076 6965 7770 6f72 7420 616e the viewport an │ │ │ │ +0000dfd0: 6420 6269 746d 6170 2e0a 2020 2020 2042 d bitmap.. B │ │ │ │ +0000dfe0: 6c69 7474 696e 6720 6f70 6572 6174 6f72 litting operator │ │ │ │ +0000dff0: 2027 6f70 6572 2720 7370 6563 6966 6965 'oper' specifie │ │ │ │ +0000e000: 7320 7368 6f75 6c64 2073 6f75 7263 6520 s should source │ │ │ │ +0000e010: 7069 7865 6c20 7265 706c 6163 6520 6461 pixel replace da │ │ │ │ +0000e020: 7461 0a20 2020 2020 696e 2073 6372 6565 ta. in scree │ │ │ │ +0000e030: 6e20 6f72 2062 6c65 6e64 2077 6974 6820 n or blend with │ │ │ │ +0000e040: 7069 7865 6c20 616c 7068 6120 7661 6c75 pixel alpha valu │ │ │ │ +0000e050: 652e 0a0a 2020 2020 2053 6f66 7477 6172 e... Softwar │ │ │ │ +0000e060: 6520 6465 7665 6c6f 7065 7220 7368 6f75 e developer shou │ │ │ │ +0000e070: 6c64 2075 7365 2027 6772 7562 5f76 6964 ld use 'grub_vid │ │ │ │ +0000e080: 656f 5f62 6974 6d61 705f 6372 6561 7465 eo_bitmap_create │ │ │ │ +0000e090: 2720 6f72 0a20 2020 2020 2767 7275 625f ' or. 'grub_ │ │ │ │ +0000e0a0: 7669 6465 6f5f 6269 746d 6170 5f6c 6f61 video_bitmap_loa │ │ │ │ +0000e0b0: 6427 2074 6f20 6372 6561 7465 206f 7220 d' to create or │ │ │ │ +0000e0c0: 6c6f 6164 2062 6974 6d61 7020 6461 7461 load bitmap data │ │ │ │ +0000e0d0: 2e0a 0a31 302e 312e 3230 2067 7275 625f ...10.1.20 grub_ │ │ │ │ +0000e0e0: 7669 6465 6f5f 626c 6974 5f72 656e 6465 video_blit_rende │ │ │ │ +0000e0f0: 725f 7461 7267 6574 0a2d 2d2d 2d2d 2d2d r_target.------- │ │ │ │ 0000e100: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ -0000e110: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 2020 202a ----------.. * │ │ │ │ -0000e120: 2050 726f 746f 7479 7065 3a0a 0a20 2020 Prototype:.. │ │ │ │ -0000e130: 2020 2020 2020 2067 7275 625f 6572 725f grub_err_ │ │ │ │ -0000e140: 740a 2020 2020 2020 2020 2020 6772 7562 t. grub │ │ │ │ -0000e150: 5f76 6964 656f 5f62 6c69 745f 7265 6e64 _video_blit_rend │ │ │ │ -0000e160: 6572 5f74 6172 6765 7420 2873 7472 7563 er_target (struc │ │ │ │ -0000e170: 7420 6772 7562 5f76 6964 656f 5f72 656e t grub_video_ren │ │ │ │ -0000e180: 6465 725f 7461 7267 6574 202a 736f 7572 der_target *sour │ │ │ │ -0000e190: 6365 2c20 656e 756d 2067 7275 625f 7669 ce, enum grub_vi │ │ │ │ -0000e1a0: 6465 6f5f 626c 6974 5f6f 7065 7261 746f deo_blit_operato │ │ │ │ -0000e1b0: 7273 206f 7065 722c 2069 6e74 2078 2c20 rs oper, int x, │ │ │ │ -0000e1c0: 696e 7420 792c 2069 6e74 206f 6666 7365 int y, int offse │ │ │ │ -0000e1d0: 745f 782c 2069 6e74 206f 6666 7365 745f t_x, int offset_ │ │ │ │ -0000e1e0: 792c 2075 6e73 6967 6e65 6420 696e 7420 y, unsigned int │ │ │ │ -0000e1f0: 7769 6474 682c 2075 6e73 6967 6e65 6420 width, unsigned │ │ │ │ -0000e200: 696e 7420 6865 6967 6874 293b 0a20 2020 int height);. │ │ │ │ -0000e210: 2020 2020 2020 2073 7472 7563 7420 6772 struct gr │ │ │ │ -0000e220: 7562 5f76 6964 656f 5f72 656e 6465 725f ub_video_render_ │ │ │ │ -0000e230: 7461 7267 6574 207b 0a20 2020 2020 2020 target {. │ │ │ │ -0000e240: 2020 2020 2020 202f 2a20 5468 6973 2069 /* This i │ │ │ │ -0000e250: 7320 7072 6976 6174 6520 6461 7461 2066 s private data f │ │ │ │ -0000e260: 6f72 2076 6964 656f 2064 7269 7665 722e or video driver. │ │ │ │ -0000e270: 2053 686f 756c 6420 6e6f 7420 6265 2061 Should not be a │ │ │ │ -0000e280: 6363 6573 7365 6420 6672 6f6d 2065 6c73 ccessed from els │ │ │ │ -0000e290: 6577 6865 7265 2064 6972 6563 746c 792e ewhere directly. │ │ │ │ -0000e2a0: 2020 2a2f 0a20 2020 2020 2020 2020 207d */. } │ │ │ │ -0000e2b0: 3b0a 0a20 2020 2020 2020 2020 2065 6e75 ;.. enu │ │ │ │ -0000e2c0: 6d20 6772 7562 5f76 6964 656f 5f62 6c69 m grub_video_bli │ │ │ │ -0000e2d0: 745f 6f70 6572 6174 6f72 730a 2020 2020 t_operators. │ │ │ │ -0000e2e0: 2020 2020 2020 2020 7b0a 2020 2020 2020 {. │ │ │ │ -0000e2f0: 2020 2020 2020 2020 4752 5542 5f56 4944 GRUB_VID │ │ │ │ -0000e300: 454f 5f42 4c49 545f 5245 504c 4143 452c EO_BLIT_REPLACE, │ │ │ │ -0000e310: 0a20 2020 2020 2020 2020 2020 2020 2047 . G │ │ │ │ -0000e320: 5255 425f 5649 4445 4f5f 424c 4954 5f42 RUB_VIDEO_BLIT_B │ │ │ │ -0000e330: 4c45 4e44 0a20 2020 2020 2020 2020 2020 LEND. │ │ │ │ -0000e340: 207d 3b0a 2020 202a 2044 6573 6372 6970 };. * Descrip │ │ │ │ -0000e350: 7469 6f6e 3a0a 0a20 2020 2020 5573 6564 tion:.. Used │ │ │ │ -0000e360: 2074 6f20 626c 6974 2073 6f75 7263 6520 to blit source │ │ │ │ -0000e370: 7265 6e64 6572 2074 6172 6765 7420 746f render target to │ │ │ │ -0000e380: 2076 6965 7770 6f72 7420 696e 2073 7065 viewport in spe │ │ │ │ -0000e390: 6369 6669 6564 0a20 2020 2020 636f 6f72 cified. coor │ │ │ │ -0000e3a0: 6469 6e61 7465 732e 2020 4966 2070 6172 dinates. If par │ │ │ │ -0000e3b0: 7420 6f66 2073 6f75 7263 6520 7265 6e64 t of source rend │ │ │ │ -0000e3c0: 6572 2074 6172 6765 7420 6973 206f 7574 er target is out │ │ │ │ -0000e3d0: 7369 6465 206f 660a 2020 2020 2076 6965 side of. vie │ │ │ │ -0000e3e0: 7770 6f72 7420 7265 6769 6f6e 2c20 6974 wport region, it │ │ │ │ -0000e3f0: 2077 696c 6c20 6265 2063 6c69 7070 6564 will be clipped │ │ │ │ -0000e400: 206f 7574 2e20 2049 6620 626c 6974 7469 out. If blitti │ │ │ │ -0000e410: 6e67 206f 7065 7261 746f 7220 6973 0a20 ng operator is. │ │ │ │ -0000e420: 2020 2020 7370 6563 6966 6965 6420 616e specified an │ │ │ │ -0000e430: 6420 736f 7572 6365 2063 6f6e 7461 696e d source contain │ │ │ │ -0000e440: 7320 616c 7068 6120 7661 6c75 6573 2c20 s alpha values, │ │ │ │ -0000e450: 7265 7375 6c74 696e 6720 7069 7865 6c20 resulting pixel │ │ │ │ -0000e460: 636f 6c6f 720a 2020 2020 2063 6f6d 706f color. compo │ │ │ │ -0000e470: 6e65 6e74 7320 7769 6c6c 2062 6520 6361 nents will be ca │ │ │ │ -0000e480: 6c63 756c 6174 6564 2075 7369 6e67 2066 lculated using f │ │ │ │ -0000e490: 6f72 6d75 6c61 2028 2873 7263 5f63 6f6c ormula ((src_col │ │ │ │ -0000e4a0: 6f72 202a 0a20 2020 2020 7372 635f 616c or *. src_al │ │ │ │ -0000e4b0: 7068 6129 202b 2028 6473 745f 636f 6c6f pha) + (dst_colo │ │ │ │ -0000e4c0: 7220 2a20 2832 3535 202d 2073 7263 5f61 r * (255 - src_a │ │ │ │ -0000e4d0: 6c70 6861 2929 202f 2032 3535 2c20 6966 lpha)) / 255, if │ │ │ │ -0000e4e0: 2074 6172 6765 740a 2020 2020 2062 7566 target. buf │ │ │ │ -0000e4f0: 6665 7220 6861 7320 616c 7068 612c 2069 fer has alpha, i │ │ │ │ -0000e500: 7420 7769 6c6c 2062 6520 7365 7420 746f t will be set to │ │ │ │ -0000e510: 2073 7263 5f61 6c70 6861 2e20 204f 6666 src_alpha. Off │ │ │ │ -0000e520: 7365 7473 2061 6666 6563 740a 2020 2020 sets affect. │ │ │ │ -0000e530: 2072 656e 6465 7220 7461 7267 6574 2070 render target p │ │ │ │ -0000e540: 6f73 6974 696f 6e20 7768 6572 6520 6461 osition where da │ │ │ │ -0000e550: 7461 2077 696c 6c20 6265 2063 6f70 6965 ta will be copie │ │ │ │ -0000e560: 6420 6672 6f6d 2e20 2049 6620 6461 7461 d from. If data │ │ │ │ -0000e570: 2069 730a 2020 2020 206c 6f6f 6b65 6420 is. looked │ │ │ │ -0000e580: 6f75 7420 6f66 2062 6f75 6e64 7320 6f66 out of bounds of │ │ │ │ -0000e590: 2072 656e 6465 7220 7461 7267 6574 2c20 render target, │ │ │ │ -0000e5a0: 636f 6c6f 7220 7661 6c75 6520 7769 6c6c color value will │ │ │ │ -0000e5b0: 2062 6520 6173 7375 6d65 640a 2020 2020 be assumed. │ │ │ │ -0000e5c0: 2074 6f20 6265 2074 7261 6e73 7061 7265 to be transpare │ │ │ │ -0000e5d0: 6e74 2e20 2042 6c69 7474 696e 6720 6f70 nt. Blitting op │ │ │ │ -0000e5e0: 6572 6174 6f72 2027 6f70 6572 2720 7370 erator 'oper' sp │ │ │ │ -0000e5f0: 6563 6966 6965 7320 7368 6f75 6c64 0a20 ecifies should. │ │ │ │ -0000e600: 2020 2020 736f 7572 6365 2070 6978 656c source pixel │ │ │ │ -0000e610: 2072 6570 6c61 6365 2064 6174 6120 696e replace data in │ │ │ │ -0000e620: 2073 6372 6565 6e20 6f72 2062 6c65 6e64 screen or blend │ │ │ │ -0000e630: 2077 6974 6820 7069 7865 6c20 616c 7068 with pixel alph │ │ │ │ -0000e640: 610a 2020 2020 2076 616c 7565 2e0a 0a31 a. value...1 │ │ │ │ -0000e650: 302e 312e 3231 2067 7275 625f 7669 6465 0.1.21 grub_vide │ │ │ │ -0000e660: 6f5f 7363 726f 6c6c 0a2d 2d2d 2d2d 2d2d o_scroll.------- │ │ │ │ +0000e110: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a --------------.. │ │ │ │ +0000e120: 2020 202a 2050 726f 746f 7479 7065 3a0a * Prototype:. │ │ │ │ +0000e130: 0a20 2020 2020 2020 2020 2067 7275 625f . grub_ │ │ │ │ +0000e140: 6572 725f 740a 2020 2020 2020 2020 2020 err_t. │ │ │ │ +0000e150: 6772 7562 5f76 6964 656f 5f62 6c69 745f grub_video_blit_ │ │ │ │ +0000e160: 7265 6e64 6572 5f74 6172 6765 7420 2873 render_target (s │ │ │ │ +0000e170: 7472 7563 7420 6772 7562 5f76 6964 656f truct grub_video │ │ │ │ +0000e180: 5f72 656e 6465 725f 7461 7267 6574 202a _render_target * │ │ │ │ +0000e190: 736f 7572 6365 2c20 656e 756d 2067 7275 source, enum gru │ │ │ │ +0000e1a0: 625f 7669 6465 6f5f 626c 6974 5f6f 7065 b_video_blit_ope │ │ │ │ +0000e1b0: 7261 746f 7273 206f 7065 722c 2069 6e74 rators oper, int │ │ │ │ +0000e1c0: 2078 2c20 696e 7420 792c 2069 6e74 206f x, int y, int o │ │ │ │ +0000e1d0: 6666 7365 745f 782c 2069 6e74 206f 6666 ffset_x, int off │ │ │ │ +0000e1e0: 7365 745f 792c 2075 6e73 6967 6e65 6420 set_y, unsigned │ │ │ │ +0000e1f0: 696e 7420 7769 6474 682c 2075 6e73 6967 int width, unsig │ │ │ │ +0000e200: 6e65 6420 696e 7420 6865 6967 6874 293b ned int height); │ │ │ │ +0000e210: 0a20 2020 2020 2020 2020 2073 7472 7563 . struc │ │ │ │ +0000e220: 7420 6772 7562 5f76 6964 656f 5f72 656e t grub_video_ren │ │ │ │ +0000e230: 6465 725f 7461 7267 6574 207b 0a20 2020 der_target {. │ │ │ │ +0000e240: 2020 2020 2020 2020 2020 202f 2a20 5468 /* Th │ │ │ │ +0000e250: 6973 2069 7320 7072 6976 6174 6520 6461 is is private da │ │ │ │ +0000e260: 7461 2066 6f72 2076 6964 656f 2064 7269 ta for video dri │ │ │ │ +0000e270: 7665 722e 2053 686f 756c 6420 6e6f 7420 ver. Should not │ │ │ │ +0000e280: 6265 2061 6363 6573 7365 6420 6672 6f6d be accessed from │ │ │ │ +0000e290: 2065 6c73 6577 6865 7265 2064 6972 6563 elsewhere direc │ │ │ │ +0000e2a0: 746c 792e 2020 2a2f 0a20 2020 2020 2020 tly. */. │ │ │ │ +0000e2b0: 2020 207d 3b0a 0a20 2020 2020 2020 2020 };.. │ │ │ │ +0000e2c0: 2065 6e75 6d20 6772 7562 5f76 6964 656f enum grub_video │ │ │ │ +0000e2d0: 5f62 6c69 745f 6f70 6572 6174 6f72 730a _blit_operators. │ │ │ │ +0000e2e0: 2020 2020 2020 2020 2020 2020 7b0a 2020 {. │ │ │ │ +0000e2f0: 2020 2020 2020 2020 2020 2020 4752 5542 GRUB │ │ │ │ +0000e300: 5f56 4944 454f 5f42 4c49 545f 5245 504c _VIDEO_BLIT_REPL │ │ │ │ +0000e310: 4143 452c 0a20 2020 2020 2020 2020 2020 ACE,. │ │ │ │ +0000e320: 2020 2047 5255 425f 5649 4445 4f5f 424c GRUB_VIDEO_BL │ │ │ │ +0000e330: 4954 5f42 4c45 4e44 0a20 2020 2020 2020 IT_BLEND. │ │ │ │ +0000e340: 2020 2020 207d 3b0a 2020 202a 2044 6573 };. * Des │ │ │ │ +0000e350: 6372 6970 7469 6f6e 3a0a 0a20 2020 2020 cription:.. │ │ │ │ +0000e360: 5573 6564 2074 6f20 626c 6974 2073 6f75 Used to blit sou │ │ │ │ +0000e370: 7263 6520 7265 6e64 6572 2074 6172 6765 rce render targe │ │ │ │ +0000e380: 7420 746f 2076 6965 7770 6f72 7420 696e t to viewport in │ │ │ │ +0000e390: 2073 7065 6369 6669 6564 0a20 2020 2020 specified. │ │ │ │ +0000e3a0: 636f 6f72 6469 6e61 7465 732e 2020 4966 coordinates. If │ │ │ │ +0000e3b0: 2070 6172 7420 6f66 2073 6f75 7263 6520 part of source │ │ │ │ +0000e3c0: 7265 6e64 6572 2074 6172 6765 7420 6973 render target is │ │ │ │ +0000e3d0: 206f 7574 7369 6465 206f 660a 2020 2020 outside of. │ │ │ │ +0000e3e0: 2076 6965 7770 6f72 7420 7265 6769 6f6e viewport region │ │ │ │ +0000e3f0: 2c20 6974 2077 696c 6c20 6265 2063 6c69 , it will be cli │ │ │ │ +0000e400: 7070 6564 206f 7574 2e20 2049 6620 626c pped out. If bl │ │ │ │ +0000e410: 6974 7469 6e67 206f 7065 7261 746f 7220 itting operator │ │ │ │ +0000e420: 6973 0a20 2020 2020 7370 6563 6966 6965 is. specifie │ │ │ │ +0000e430: 6420 616e 6420 736f 7572 6365 2063 6f6e d and source con │ │ │ │ +0000e440: 7461 696e 7320 616c 7068 6120 7661 6c75 tains alpha valu │ │ │ │ +0000e450: 6573 2c20 7265 7375 6c74 696e 6720 7069 es, resulting pi │ │ │ │ +0000e460: 7865 6c20 636f 6c6f 720a 2020 2020 2063 xel color. c │ │ │ │ +0000e470: 6f6d 706f 6e65 6e74 7320 7769 6c6c 2062 omponents will b │ │ │ │ +0000e480: 6520 6361 6c63 756c 6174 6564 2075 7369 e calculated usi │ │ │ │ +0000e490: 6e67 2066 6f72 6d75 6c61 2028 2873 7263 ng formula ((src │ │ │ │ +0000e4a0: 5f63 6f6c 6f72 202a 0a20 2020 2020 7372 _color *. sr │ │ │ │ +0000e4b0: 635f 616c 7068 6129 202b 2028 6473 745f c_alpha) + (dst_ │ │ │ │ +0000e4c0: 636f 6c6f 7220 2a20 2832 3535 202d 2073 color * (255 - s │ │ │ │ +0000e4d0: 7263 5f61 6c70 6861 2929 202f 2032 3535 rc_alpha)) / 255 │ │ │ │ +0000e4e0: 2c20 6966 2074 6172 6765 740a 2020 2020 , if target. │ │ │ │ +0000e4f0: 2062 7566 6665 7220 6861 7320 616c 7068 buffer has alph │ │ │ │ +0000e500: 612c 2069 7420 7769 6c6c 2062 6520 7365 a, it will be se │ │ │ │ +0000e510: 7420 746f 2073 7263 5f61 6c70 6861 2e20 t to src_alpha. │ │ │ │ +0000e520: 204f 6666 7365 7473 2061 6666 6563 740a Offsets affect. │ │ │ │ +0000e530: 2020 2020 2072 656e 6465 7220 7461 7267 render targ │ │ │ │ +0000e540: 6574 2070 6f73 6974 696f 6e20 7768 6572 et position wher │ │ │ │ +0000e550: 6520 6461 7461 2077 696c 6c20 6265 2063 e data will be c │ │ │ │ +0000e560: 6f70 6965 6420 6672 6f6d 2e20 2049 6620 opied from. If │ │ │ │ +0000e570: 6461 7461 2069 730a 2020 2020 206c 6f6f data is. loo │ │ │ │ +0000e580: 6b65 6420 6f75 7420 6f66 2062 6f75 6e64 ked out of bound │ │ │ │ +0000e590: 7320 6f66 2072 656e 6465 7220 7461 7267 s of render targ │ │ │ │ +0000e5a0: 6574 2c20 636f 6c6f 7220 7661 6c75 6520 et, color value │ │ │ │ +0000e5b0: 7769 6c6c 2062 6520 6173 7375 6d65 640a will be assumed. │ │ │ │ +0000e5c0: 2020 2020 2074 6f20 6265 2074 7261 6e73 to be trans │ │ │ │ +0000e5d0: 7061 7265 6e74 2e20 2042 6c69 7474 696e parent. Blittin │ │ │ │ +0000e5e0: 6720 6f70 6572 6174 6f72 2027 6f70 6572 g operator 'oper │ │ │ │ +0000e5f0: 2720 7370 6563 6966 6965 7320 7368 6f75 ' specifies shou │ │ │ │ +0000e600: 6c64 0a20 2020 2020 736f 7572 6365 2070 ld. source p │ │ │ │ +0000e610: 6978 656c 2072 6570 6c61 6365 2064 6174 ixel replace dat │ │ │ │ +0000e620: 6120 696e 2073 6372 6565 6e20 6f72 2062 a in screen or b │ │ │ │ +0000e630: 6c65 6e64 2077 6974 6820 7069 7865 6c20 lend with pixel │ │ │ │ +0000e640: 616c 7068 610a 2020 2020 2076 616c 7565 alpha. value │ │ │ │ +0000e650: 2e0a 0a31 302e 312e 3231 2067 7275 625f ...10.1.21 grub_ │ │ │ │ +0000e660: 7669 6465 6f5f 7363 726f 6c6c 0a2d 2d2d video_scroll.--- │ │ │ │ 0000e670: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ -0000e680: 2d2d 0a0a 2020 202a 2050 726f 746f 7479 --.. * Prototy │ │ │ │ -0000e690: 7065 3a0a 0a20 2020 2020 2020 2020 2067 pe:.. g │ │ │ │ -0000e6a0: 7275 625f 6572 725f 740a 2020 2020 2020 rub_err_t. │ │ │ │ -0000e6b0: 2020 2020 6772 7562 5f76 6964 656f 5f73 grub_video_s │ │ │ │ -0000e6c0: 6372 6f6c 6c20 2867 7275 625f 7669 6465 croll (grub_vide │ │ │ │ -0000e6d0: 6f5f 636f 6c6f 725f 7420 636f 6c6f 722c o_color_t color, │ │ │ │ -0000e6e0: 2069 6e74 2064 782c 2069 6e74 2064 7929 int dx, int dy) │ │ │ │ -0000e6f0: 3b0a 2020 202a 2044 6573 6372 6970 7469 ;. * Descripti │ │ │ │ -0000e700: 6f6e 3a0a 0a20 2020 2020 5573 6564 2074 on:.. Used t │ │ │ │ -0000e710: 6f20 7363 726f 6c6c 2076 6965 7770 6f72 o scroll viewpor │ │ │ │ -0000e720: 7420 746f 2073 7065 6369 6669 6564 2064 t to specified d │ │ │ │ -0000e730: 6972 6563 7469 6f6e 2e20 204e 6577 2061 irection. New a │ │ │ │ -0000e740: 7265 6173 2061 7265 0a20 2020 2020 6669 reas are. fi │ │ │ │ -0000e750: 6c6c 6564 2077 6974 6820 7370 6563 6966 lled with specif │ │ │ │ -0000e760: 6965 6420 636f 6c6f 722e 2020 5468 6973 ied color. This │ │ │ │ -0000e770: 2066 756e 6374 696f 6e20 6973 2075 7365 function is use │ │ │ │ -0000e780: 6420 7768 656e 2073 6372 6565 6e20 6973 d when screen is │ │ │ │ -0000e790: 0a20 2020 2020 7363 726f 6c6c 6572 2075 . scroller u │ │ │ │ -0000e7a0: 7020 696e 2076 6964 656f 2074 6572 6d69 p in video termi │ │ │ │ -0000e7b0: 6e61 6c2e 0a0a 3130 2e31 2e32 3220 6772 nal...10.1.22 gr │ │ │ │ -0000e7c0: 7562 5f76 6964 656f 5f73 7761 705f 6275 ub_video_swap_bu │ │ │ │ -0000e7d0: 6666 6572 730a 2d2d 2d2d 2d2d 2d2d 2d2d ffers.---------- │ │ │ │ +0000e680: 2d2d 2d2d 2d2d 0a0a 2020 202a 2050 726f ------.. * Pro │ │ │ │ +0000e690: 746f 7479 7065 3a0a 0a20 2020 2020 2020 totype:.. │ │ │ │ +0000e6a0: 2020 2067 7275 625f 6572 725f 740a 2020 grub_err_t. │ │ │ │ +0000e6b0: 2020 2020 2020 2020 6772 7562 5f76 6964 grub_vid │ │ │ │ +0000e6c0: 656f 5f73 6372 6f6c 6c20 2867 7275 625f eo_scroll (grub_ │ │ │ │ +0000e6d0: 7669 6465 6f5f 636f 6c6f 725f 7420 636f video_color_t co │ │ │ │ +0000e6e0: 6c6f 722c 2069 6e74 2064 782c 2069 6e74 lor, int dx, int │ │ │ │ +0000e6f0: 2064 7929 3b0a 2020 202a 2044 6573 6372 dy);. * Descr │ │ │ │ +0000e700: 6970 7469 6f6e 3a0a 0a20 2020 2020 5573 iption:.. Us │ │ │ │ +0000e710: 6564 2074 6f20 7363 726f 6c6c 2076 6965 ed to scroll vie │ │ │ │ +0000e720: 7770 6f72 7420 746f 2073 7065 6369 6669 wport to specifi │ │ │ │ +0000e730: 6564 2064 6972 6563 7469 6f6e 2e20 204e ed direction. N │ │ │ │ +0000e740: 6577 2061 7265 6173 2061 7265 0a20 2020 ew areas are. │ │ │ │ +0000e750: 2020 6669 6c6c 6564 2077 6974 6820 7370 filled with sp │ │ │ │ +0000e760: 6563 6966 6965 6420 636f 6c6f 722e 2020 ecified color. │ │ │ │ +0000e770: 5468 6973 2066 756e 6374 696f 6e20 6973 This function is │ │ │ │ +0000e780: 2075 7365 6420 7768 656e 2073 6372 6565 used when scree │ │ │ │ +0000e790: 6e20 6973 0a20 2020 2020 7363 726f 6c6c n is. scroll │ │ │ │ +0000e7a0: 6572 2075 7020 696e 2076 6964 656f 2074 er up in video t │ │ │ │ +0000e7b0: 6572 6d69 6e61 6c2e 0a0a 3130 2e31 2e32 erminal...10.1.2 │ │ │ │ +0000e7c0: 3220 6772 7562 5f76 6964 656f 5f73 7761 2 grub_video_swa │ │ │ │ +0000e7d0: 705f 6275 6666 6572 730a 2d2d 2d2d 2d2d p_buffers.------ │ │ │ │ 0000e7e0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ -0000e7f0: 2d2d 2d2d 2d0a 0a20 2020 2a20 5072 6f74 -----.. * Prot │ │ │ │ -0000e800: 6f74 7970 653a 0a0a 2020 2020 2020 2020 otype:.. │ │ │ │ -0000e810: 2020 6772 7562 5f65 7272 5f74 0a20 2020 grub_err_t. │ │ │ │ -0000e820: 2020 2020 2020 2067 7275 625f 7669 6465 grub_vide │ │ │ │ -0000e830: 6f5f 7377 6170 5f62 7566 6665 7273 2028 o_swap_buffers ( │ │ │ │ -0000e840: 766f 6964 293b 0a20 2020 2a20 4465 7363 void);. * Desc │ │ │ │ -0000e850: 7269 7074 696f 6e3a 0a0a 2020 2020 2049 ription:.. I │ │ │ │ -0000e860: 6620 646f 7562 6c65 2062 7566 6665 7269 f double bufferi │ │ │ │ -0000e870: 6e67 2069 7320 656e 6162 6c65 642c 2074 ng is enabled, t │ │ │ │ -0000e880: 6869 7320 7377 6170 7320 6672 6f6e 7462 his swaps frontb │ │ │ │ -0000e890: 7566 6665 7220 616e 640a 2020 2020 2062 uffer and. b │ │ │ │ -0000e8a0: 6163 6b62 7566 6665 722c 2069 6e20 6f72 ackbuffer, in or │ │ │ │ -0000e8b0: 6465 7220 746f 2073 686f 7720 7661 6c75 der to show valu │ │ │ │ -0000e8c0: 6573 2064 7261 776e 2074 6f20 6261 636b es drawn to back │ │ │ │ -0000e8d0: 2062 7566 6665 722e 2020 5669 6465 6f0a buffer. Video. │ │ │ │ -0000e8e0: 2020 2020 2064 7269 7665 7220 6973 2066 driver is f │ │ │ │ -0000e8f0: 7265 6520 746f 2063 686f 6f73 6520 686f ree to choose ho │ │ │ │ -0000e900: 7720 7468 6973 206f 7065 7261 7469 6f6e w this operation │ │ │ │ -0000e910: 2069 7320 7465 6368 696e 6361 6c6c 7920 is techincally │ │ │ │ -0000e920: 646f 6e65 2e0a 0a31 302e 312e 3233 2067 done...10.1.23 g │ │ │ │ -0000e930: 7275 625f 7669 6465 6f5f 6372 6561 7465 rub_video_create │ │ │ │ -0000e940: 5f72 656e 6465 725f 7461 7267 6574 0a2d _render_target.- │ │ │ │ -0000e950: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ +0000e7f0: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2020 2a20 ---------.. * │ │ │ │ +0000e800: 5072 6f74 6f74 7970 653a 0a0a 2020 2020 Prototype:.. │ │ │ │ +0000e810: 2020 2020 2020 6772 7562 5f65 7272 5f74 grub_err_t │ │ │ │ +0000e820: 0a20 2020 2020 2020 2020 2067 7275 625f . grub_ │ │ │ │ +0000e830: 7669 6465 6f5f 7377 6170 5f62 7566 6665 video_swap_buffe │ │ │ │ +0000e840: 7273 2028 766f 6964 293b 0a20 2020 2a20 rs (void);. * │ │ │ │ +0000e850: 4465 7363 7269 7074 696f 6e3a 0a0a 2020 Description:.. │ │ │ │ +0000e860: 2020 2049 6620 646f 7562 6c65 2062 7566 If double buf │ │ │ │ +0000e870: 6665 7269 6e67 2069 7320 656e 6162 6c65 fering is enable │ │ │ │ +0000e880: 642c 2074 6869 7320 7377 6170 7320 6672 d, this swaps fr │ │ │ │ +0000e890: 6f6e 7462 7566 6665 7220 616e 640a 2020 ontbuffer and. │ │ │ │ +0000e8a0: 2020 2062 6163 6b62 7566 6665 722c 2069 backbuffer, i │ │ │ │ +0000e8b0: 6e20 6f72 6465 7220 746f 2073 686f 7720 n order to show │ │ │ │ +0000e8c0: 7661 6c75 6573 2064 7261 776e 2074 6f20 values drawn to │ │ │ │ +0000e8d0: 6261 636b 2062 7566 6665 722e 2020 5669 back buffer. Vi │ │ │ │ +0000e8e0: 6465 6f0a 2020 2020 2064 7269 7665 7220 deo. driver │ │ │ │ +0000e8f0: 6973 2066 7265 6520 746f 2063 686f 6f73 is free to choos │ │ │ │ +0000e900: 6520 686f 7720 7468 6973 206f 7065 7261 e how this opera │ │ │ │ +0000e910: 7469 6f6e 2069 7320 7465 6368 696e 6361 tion is techinca │ │ │ │ +0000e920: 6c6c 7920 646f 6e65 2e0a 0a31 302e 312e lly done...10.1. │ │ │ │ +0000e930: 3233 2067 7275 625f 7669 6465 6f5f 6372 23 grub_video_cr │ │ │ │ +0000e940: 6561 7465 5f72 656e 6465 725f 7461 7267 eate_render_targ │ │ │ │ +0000e950: 6574 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d et.------------- │ │ │ │ 0000e960: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ -0000e970: 2d2d 2d2d 2d2d 0a0a 2020 202a 2050 726f ------.. * Pro │ │ │ │ -0000e980: 746f 7479 7065 3a0a 0a20 2020 2020 2020 totype:.. │ │ │ │ -0000e990: 2020 2067 7275 625f 6572 725f 740a 2020 grub_err_t. │ │ │ │ -0000e9a0: 2020 2020 2020 2020 6772 7562 5f76 6964 grub_vid │ │ │ │ -0000e9b0: 656f 5f63 7265 6174 655f 7265 6e64 6572 eo_create_render │ │ │ │ -0000e9c0: 5f74 6172 6765 7420 2873 7472 7563 7420 _target (struct │ │ │ │ -0000e9d0: 6772 7562 5f76 6964 656f 5f72 656e 6465 grub_video_rende │ │ │ │ -0000e9e0: 725f 7461 7267 6574 202a 2a72 6573 756c r_target **resul │ │ │ │ -0000e9f0: 742c 2075 6e73 6967 6e65 6420 696e 7420 t, unsigned int │ │ │ │ -0000ea00: 7769 6474 682c 2075 6e73 6967 6e65 6420 width, unsigned │ │ │ │ -0000ea10: 696e 7420 6865 6967 6874 2c20 756e 7369 int height, unsi │ │ │ │ -0000ea20: 676e 6564 2069 6e74 206d 6f64 655f 7479 gned int mode_ty │ │ │ │ -0000ea30: 7065 293b 0a20 2020 2020 2020 2020 2073 pe);. s │ │ │ │ -0000ea40: 7472 7563 7420 6772 7562 5f76 6964 656f truct grub_video │ │ │ │ -0000ea50: 5f72 656e 6465 725f 7461 7267 6574 207b _render_target { │ │ │ │ -0000ea60: 0a20 2020 2020 2020 2020 2020 2020 202f . / │ │ │ │ -0000ea70: 2a20 5468 6973 2069 7320 7072 6976 6174 * This is privat │ │ │ │ -0000ea80: 6520 6461 7461 2066 6f72 2076 6964 656f e data for video │ │ │ │ -0000ea90: 2064 7269 7665 722e 2053 686f 756c 6420 driver. Should │ │ │ │ -0000eaa0: 6e6f 7420 6265 2061 6363 6573 7365 6420 not be accessed │ │ │ │ -0000eab0: 6672 6f6d 2065 6c73 6577 6865 7265 2064 from elsewhere d │ │ │ │ -0000eac0: 6972 6563 746c 792e 2020 2a2f 0a20 2020 irectly. */. │ │ │ │ -0000ead0: 2020 2020 2020 207d 3b0a 2020 202a 2044 };. * D │ │ │ │ -0000eae0: 6573 6372 6970 7469 6f6e 3a0a 0a20 2020 escription:.. │ │ │ │ -0000eaf0: 2020 4472 6976 6572 2077 696c 6c20 7573 Driver will us │ │ │ │ -0000eb00: 6520 696e 666f 726d 6174 696f 6e20 7072 e information pr │ │ │ │ -0000eb10: 6f76 6964 6564 2074 6f20 6974 2074 6f20 ovided to it to │ │ │ │ -0000eb20: 6372 6561 7465 2062 6573 7420 6669 7474 create best fitt │ │ │ │ -0000eb30: 696e 670a 2020 2020 2072 656e 6465 7220 ing. render │ │ │ │ -0000eb40: 7461 7267 6574 2e20 2027 6d6f 6465 5f74 target. 'mode_t │ │ │ │ -0000eb50: 7970 6527 2077 696c 6c20 6265 2075 7365 ype' will be use │ │ │ │ -0000eb60: 6420 746f 2067 7569 6465 206f 6e20 7365 d to guide on se │ │ │ │ -0000eb70: 6c65 6374 696e 6720 7768 6174 0a20 2020 lecting what. │ │ │ │ -0000eb80: 2020 6665 6174 7572 6573 2061 7265 2077 features are w │ │ │ │ -0000eb90: 616e 7465 6420 666f 7220 7265 6e64 6572 anted for render │ │ │ │ -0000eba0: 2074 6172 6765 742e 2020 5375 7070 6f72 target. Suppor │ │ │ │ -0000ebb0: 7465 6420 7661 6c75 6573 2066 6f72 0a20 ted values for. │ │ │ │ -0000ebc0: 2020 2020 276d 6f64 655f 7479 7065 2720 'mode_type' │ │ │ │ -0000ebd0: 6172 6520 2747 5255 425f 5649 4445 4f5f are 'GRUB_VIDEO_ │ │ │ │ -0000ebe0: 4d4f 4445 5f54 5950 455f 494e 4445 585f MODE_TYPE_INDEX_ │ │ │ │ -0000ebf0: 434f 4c4f 5227 2066 6f72 2069 6e64 6578 COLOR' for index │ │ │ │ -0000ec00: 2063 6f6c 6f72 0a20 2020 2020 6d6f 6465 color. mode │ │ │ │ -0000ec10: 732c 2027 4752 5542 5f56 4944 454f 5f4d s, 'GRUB_VIDEO_M │ │ │ │ -0000ec20: 4f44 455f 5459 5045 5f52 4742 2720 666f ODE_TYPE_RGB' fo │ │ │ │ -0000ec30: 7220 6469 7265 6374 2052 4742 2063 6f6c r direct RGB col │ │ │ │ -0000ec40: 6f72 206d 6f64 6573 2061 6e64 0a20 2020 or modes and. │ │ │ │ -0000ec50: 2020 2747 5255 425f 5649 4445 4f5f 4d4f 'GRUB_VIDEO_MO │ │ │ │ -0000ec60: 4445 5f54 5950 455f 414c 5048 4127 2066 DE_TYPE_ALPHA' f │ │ │ │ -0000ec70: 6f72 2061 6c70 6861 2063 6f6d 706f 6e65 or alpha compone │ │ │ │ -0000ec80: 6e74 2e0a 0a31 302e 312e 3234 2067 7275 nt...10.1.24 gru │ │ │ │ -0000ec90: 625f 7669 6465 6f5f 6465 6c65 7465 5f72 b_video_delete_r │ │ │ │ -0000eca0: 656e 6465 725f 7461 7267 6574 0a2d 2d2d ender_target.--- │ │ │ │ -0000ecb0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ +0000e970: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 2020 202a ----------.. * │ │ │ │ +0000e980: 2050 726f 746f 7479 7065 3a0a 0a20 2020 Prototype:.. │ │ │ │ +0000e990: 2020 2020 2020 2067 7275 625f 6572 725f grub_err_ │ │ │ │ +0000e9a0: 740a 2020 2020 2020 2020 2020 6772 7562 t. grub │ │ │ │ +0000e9b0: 5f76 6964 656f 5f63 7265 6174 655f 7265 _video_create_re │ │ │ │ +0000e9c0: 6e64 6572 5f74 6172 6765 7420 2873 7472 nder_target (str │ │ │ │ +0000e9d0: 7563 7420 6772 7562 5f76 6964 656f 5f72 uct grub_video_r │ │ │ │ +0000e9e0: 656e 6465 725f 7461 7267 6574 202a 2a72 ender_target **r │ │ │ │ +0000e9f0: 6573 756c 742c 2075 6e73 6967 6e65 6420 esult, unsigned │ │ │ │ +0000ea00: 696e 7420 7769 6474 682c 2075 6e73 6967 int width, unsig │ │ │ │ +0000ea10: 6e65 6420 696e 7420 6865 6967 6874 2c20 ned int height, │ │ │ │ +0000ea20: 756e 7369 676e 6564 2069 6e74 206d 6f64 unsigned int mod │ │ │ │ +0000ea30: 655f 7479 7065 293b 0a20 2020 2020 2020 e_type);. │ │ │ │ +0000ea40: 2020 2073 7472 7563 7420 6772 7562 5f76 struct grub_v │ │ │ │ +0000ea50: 6964 656f 5f72 656e 6465 725f 7461 7267 ideo_render_targ │ │ │ │ +0000ea60: 6574 207b 0a20 2020 2020 2020 2020 2020 et {. │ │ │ │ +0000ea70: 2020 202f 2a20 5468 6973 2069 7320 7072 /* This is pr │ │ │ │ +0000ea80: 6976 6174 6520 6461 7461 2066 6f72 2076 ivate data for v │ │ │ │ +0000ea90: 6964 656f 2064 7269 7665 722e 2053 686f ideo driver. Sho │ │ │ │ +0000eaa0: 756c 6420 6e6f 7420 6265 2061 6363 6573 uld not be acces │ │ │ │ +0000eab0: 7365 6420 6672 6f6d 2065 6c73 6577 6865 sed from elsewhe │ │ │ │ +0000eac0: 7265 2064 6972 6563 746c 792e 2020 2a2f re directly. */ │ │ │ │ +0000ead0: 0a20 2020 2020 2020 2020 207d 3b0a 2020 . };. │ │ │ │ +0000eae0: 202a 2044 6573 6372 6970 7469 6f6e 3a0a * Description:. │ │ │ │ +0000eaf0: 0a20 2020 2020 4472 6976 6572 2077 696c . Driver wil │ │ │ │ +0000eb00: 6c20 7573 6520 696e 666f 726d 6174 696f l use informatio │ │ │ │ +0000eb10: 6e20 7072 6f76 6964 6564 2074 6f20 6974 n provided to it │ │ │ │ +0000eb20: 2074 6f20 6372 6561 7465 2062 6573 7420 to create best │ │ │ │ +0000eb30: 6669 7474 696e 670a 2020 2020 2072 656e fitting. ren │ │ │ │ +0000eb40: 6465 7220 7461 7267 6574 2e20 2027 6d6f der target. 'mo │ │ │ │ +0000eb50: 6465 5f74 7970 6527 2077 696c 6c20 6265 de_type' will be │ │ │ │ +0000eb60: 2075 7365 6420 746f 2067 7569 6465 206f used to guide o │ │ │ │ +0000eb70: 6e20 7365 6c65 6374 696e 6720 7768 6174 n selecting what │ │ │ │ +0000eb80: 0a20 2020 2020 6665 6174 7572 6573 2061 . features a │ │ │ │ +0000eb90: 7265 2077 616e 7465 6420 666f 7220 7265 re wanted for re │ │ │ │ +0000eba0: 6e64 6572 2074 6172 6765 742e 2020 5375 nder target. Su │ │ │ │ +0000ebb0: 7070 6f72 7465 6420 7661 6c75 6573 2066 pported values f │ │ │ │ +0000ebc0: 6f72 0a20 2020 2020 276d 6f64 655f 7479 or. 'mode_ty │ │ │ │ +0000ebd0: 7065 2720 6172 6520 2747 5255 425f 5649 pe' are 'GRUB_VI │ │ │ │ +0000ebe0: 4445 4f5f 4d4f 4445 5f54 5950 455f 494e DEO_MODE_TYPE_IN │ │ │ │ +0000ebf0: 4445 585f 434f 4c4f 5227 2066 6f72 2069 DEX_COLOR' for i │ │ │ │ +0000ec00: 6e64 6578 2063 6f6c 6f72 0a20 2020 2020 ndex color. │ │ │ │ +0000ec10: 6d6f 6465 732c 2027 4752 5542 5f56 4944 modes, 'GRUB_VID │ │ │ │ +0000ec20: 454f 5f4d 4f44 455f 5459 5045 5f52 4742 EO_MODE_TYPE_RGB │ │ │ │ +0000ec30: 2720 666f 7220 6469 7265 6374 2052 4742 ' for direct RGB │ │ │ │ +0000ec40: 2063 6f6c 6f72 206d 6f64 6573 2061 6e64 color modes and │ │ │ │ +0000ec50: 0a20 2020 2020 2747 5255 425f 5649 4445 . 'GRUB_VIDE │ │ │ │ +0000ec60: 4f5f 4d4f 4445 5f54 5950 455f 414c 5048 O_MODE_TYPE_ALPH │ │ │ │ +0000ec70: 4127 2066 6f72 2061 6c70 6861 2063 6f6d A' for alpha com │ │ │ │ +0000ec80: 706f 6e65 6e74 2e0a 0a31 302e 312e 3234 ponent...10.1.24 │ │ │ │ +0000ec90: 2067 7275 625f 7669 6465 6f5f 6465 6c65 grub_video_dele │ │ │ │ +0000eca0: 7465 5f72 656e 6465 725f 7461 7267 6574 te_render_target │ │ │ │ +0000ecb0: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d .--------------- │ │ │ │ 0000ecc0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ -0000ecd0: 2d2d 2d2d 0a0a 2020 202a 2050 726f 746f ----.. * Proto │ │ │ │ -0000ece0: 7479 7065 3a0a 0a20 2020 2020 2020 2020 type:.. │ │ │ │ -0000ecf0: 2067 7275 625f 6572 725f 740a 2020 2020 grub_err_t. │ │ │ │ -0000ed00: 2020 2020 2020 6772 7562 5f76 6964 656f grub_video │ │ │ │ -0000ed10: 5f64 656c 6574 655f 7265 6e64 6572 5f74 _delete_render_t │ │ │ │ -0000ed20: 6172 6765 7420 2873 7472 7563 7420 6772 arget (struct gr │ │ │ │ -0000ed30: 7562 5f76 6964 656f 5f72 656e 6465 725f ub_video_render_ │ │ │ │ -0000ed40: 7461 7267 6574 202a 7461 7267 6574 293b target *target); │ │ │ │ -0000ed50: 0a20 2020 2a20 4465 7363 7269 7074 696f . * Descriptio │ │ │ │ -0000ed60: 6e3a 0a0a 2020 2020 2055 7365 6420 746f n:.. Used to │ │ │ │ -0000ed70: 2064 656c 6574 6520 7072 6576 696f 7573 delete previous │ │ │ │ -0000ed80: 6c79 2063 7265 6174 6564 2072 656e 6465 ly created rende │ │ │ │ -0000ed90: 7220 7461 7267 6574 2e20 2049 6620 2774 r target. If 't │ │ │ │ -0000eda0: 6172 6765 7427 0a20 2020 2020 636f 6e74 arget'. cont │ │ │ │ -0000edb0: 6169 6e73 2027 4e55 4c4c 2720 706f 696e ains 'NULL' poin │ │ │ │ -0000edc0: 7465 722c 206e 6f74 6869 6e67 2077 696c ter, nothing wil │ │ │ │ -0000edd0: 6c20 6265 2064 6f6e 652e 2020 4966 2072 l be done. If r │ │ │ │ -0000ede0: 656e 6465 7220 7461 7267 6574 2069 730a ender target is. │ │ │ │ -0000edf0: 2020 2020 2063 6f72 7265 6374 6c79 2064 correctly d │ │ │ │ -0000ee00: 6573 7472 6f79 6564 2c20 4752 5542 5f45 estroyed, GRUB_E │ │ │ │ -0000ee10: 5252 5f4e 4f4e 4520 6973 2072 6574 7572 RR_NONE is retur │ │ │ │ -0000ee20: 6e65 642e 0a0a 3130 2e31 2e32 3520 6772 ned...10.1.25 gr │ │ │ │ -0000ee30: 7562 5f76 6964 656f 5f73 6574 5f61 6374 ub_video_set_act │ │ │ │ -0000ee40: 6976 655f 7265 6e64 6572 5f74 6172 6765 ive_render_targe │ │ │ │ -0000ee50: 740a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d t.-------------- │ │ │ │ +0000ecd0: 2d2d 2d2d 2d2d 2d2d 0a0a 2020 202a 2050 --------.. * P │ │ │ │ +0000ece0: 726f 746f 7479 7065 3a0a 0a20 2020 2020 rototype:.. │ │ │ │ +0000ecf0: 2020 2020 2067 7275 625f 6572 725f 740a grub_err_t. │ │ │ │ +0000ed00: 2020 2020 2020 2020 2020 6772 7562 5f76 grub_v │ │ │ │ +0000ed10: 6964 656f 5f64 656c 6574 655f 7265 6e64 ideo_delete_rend │ │ │ │ +0000ed20: 6572 5f74 6172 6765 7420 2873 7472 7563 er_target (struc │ │ │ │ +0000ed30: 7420 6772 7562 5f76 6964 656f 5f72 656e t grub_video_ren │ │ │ │ +0000ed40: 6465 725f 7461 7267 6574 202a 7461 7267 der_target *targ │ │ │ │ +0000ed50: 6574 293b 0a20 2020 2a20 4465 7363 7269 et);. * Descri │ │ │ │ +0000ed60: 7074 696f 6e3a 0a0a 2020 2020 2055 7365 ption:.. Use │ │ │ │ +0000ed70: 6420 746f 2064 656c 6574 6520 7072 6576 d to delete prev │ │ │ │ +0000ed80: 696f 7573 6c79 2063 7265 6174 6564 2072 iously created r │ │ │ │ +0000ed90: 656e 6465 7220 7461 7267 6574 2e20 2049 ender target. I │ │ │ │ +0000eda0: 6620 2774 6172 6765 7427 0a20 2020 2020 f 'target'. │ │ │ │ +0000edb0: 636f 6e74 6169 6e73 2027 4e55 4c4c 2720 contains 'NULL' │ │ │ │ +0000edc0: 706f 696e 7465 722c 206e 6f74 6869 6e67 pointer, nothing │ │ │ │ +0000edd0: 2077 696c 6c20 6265 2064 6f6e 652e 2020 will be done. │ │ │ │ +0000ede0: 4966 2072 656e 6465 7220 7461 7267 6574 If render target │ │ │ │ +0000edf0: 2069 730a 2020 2020 2063 6f72 7265 6374 is. correct │ │ │ │ +0000ee00: 6c79 2064 6573 7472 6f79 6564 2c20 4752 ly destroyed, GR │ │ │ │ +0000ee10: 5542 5f45 5252 5f4e 4f4e 4520 6973 2072 UB_ERR_NONE is r │ │ │ │ +0000ee20: 6574 7572 6e65 642e 0a0a 3130 2e31 2e32 eturned...10.1.2 │ │ │ │ +0000ee30: 3520 6772 7562 5f76 6964 656f 5f73 6574 5 grub_video_set │ │ │ │ +0000ee40: 5f61 6374 6976 655f 7265 6e64 6572 5f74 _active_render_t │ │ │ │ +0000ee50: 6172 6765 740a 2d2d 2d2d 2d2d 2d2d 2d2d arget.---------- │ │ │ │ 0000ee60: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ -0000ee70: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 -------------.. │ │ │ │ -0000ee80: 2020 2a20 5072 6f74 6f74 7970 653a 0a0a * Prototype:.. │ │ │ │ -0000ee90: 2020 2020 2020 2020 2020 6772 7562 5f65 grub_e │ │ │ │ -0000eea0: 7272 5f74 0a20 2020 2020 2020 2020 2067 rr_t. g │ │ │ │ -0000eeb0: 7275 625f 7669 6465 6f5f 7365 745f 6163 rub_video_set_ac │ │ │ │ -0000eec0: 7469 7665 5f72 656e 6465 725f 7461 7267 tive_render_targ │ │ │ │ -0000eed0: 6574 2028 7374 7275 6374 2067 7275 625f et (struct grub_ │ │ │ │ -0000eee0: 7669 6465 6f5f 7265 6e64 6572 5f74 6172 video_render_tar │ │ │ │ -0000eef0: 6765 7420 2a74 6172 6765 7429 3b0a 2020 get *target);. │ │ │ │ -0000ef00: 202a 2044 6573 6372 6970 7469 6f6e 3a0a * Description:. │ │ │ │ -0000ef10: 0a20 2020 2020 5365 7473 2061 6374 6976 . Sets activ │ │ │ │ -0000ef20: 6520 7265 6e64 6572 2074 6172 6765 742e e render target. │ │ │ │ -0000ef30: 2020 4966 2074 6869 7320 636f 6d61 6e64 If this comand │ │ │ │ -0000ef40: 2069 7320 7375 6363 6573 7366 756c 2061 is successful a │ │ │ │ -0000ef50: 6c6c 0a20 2020 2020 6472 6177 696e 6720 ll. drawing │ │ │ │ -0000ef60: 636f 6d6d 616e 6473 2077 696c 6c20 6265 commands will be │ │ │ │ -0000ef70: 2064 6f6e 6520 746f 2073 7065 6369 6669 done to specifi │ │ │ │ -0000ef80: 6564 2027 7461 7267 6574 272e 2020 5468 ed 'target'. Th │ │ │ │ -0000ef90: 6572 6520 6973 2061 6c73 6f0a 2020 2020 ere is also. │ │ │ │ -0000efa0: 2073 7065 6369 616c 2076 616c 7565 7320 special values │ │ │ │ -0000efb0: 666f 7220 7461 7267 6574 2c20 2747 5255 for target, 'GRU │ │ │ │ -0000efc0: 425f 5649 4445 4f5f 5245 4e44 4552 5f54 B_VIDEO_RENDER_T │ │ │ │ -0000efd0: 4152 4745 545f 4449 5350 4c41 5927 2075 ARGET_DISPLAY' u │ │ │ │ -0000efe0: 7365 640a 2020 2020 2074 6f20 7265 6665 sed. to refe │ │ │ │ -0000eff0: 7265 6e63 6520 7363 7265 656e 2773 2066 rence screen's f │ │ │ │ -0000f000: 726f 6e74 2062 7566 6665 722c 0a20 2020 ront buffer,. │ │ │ │ -0000f010: 2020 2747 5255 425f 5649 4445 4f5f 5245 'GRUB_VIDEO_RE │ │ │ │ -0000f020: 4e44 4552 5f54 4152 4745 545f 4652 4f4e NDER_TARGET_FRON │ │ │ │ -0000f030: 545f 4255 4646 4552 2720 7573 6564 2074 T_BUFFER' used t │ │ │ │ -0000f040: 6f20 7265 6665 7265 6e63 6520 7363 7265 o reference scre │ │ │ │ -0000f050: 656e 2773 0a20 2020 2020 6672 6f6e 7420 en's. front │ │ │ │ -0000f060: 6275 6666 6572 2028 616c 6961 7320 666f buffer (alias fo │ │ │ │ -0000f070: 7220 2747 5255 425f 5649 4445 4f5f 5245 r 'GRUB_VIDEO_RE │ │ │ │ -0000f080: 4e44 4552 5f54 4152 4745 545f 4449 5350 NDER_TARGET_DISP │ │ │ │ -0000f090: 4c41 5927 2920 616e 640a 2020 2020 2027 LAY') and. ' │ │ │ │ -0000f0a0: 4752 5542 5f56 4944 454f 5f52 454e 4445 GRUB_VIDEO_RENDE │ │ │ │ -0000f0b0: 525f 5441 5247 4554 5f42 4143 4b5f 4255 R_TARGET_BACK_BU │ │ │ │ -0000f0c0: 4646 4552 2720 7573 6564 2074 6f20 7265 FFER' used to re │ │ │ │ -0000f0d0: 6665 7265 6e63 6520 6261 636b 0a20 2020 ference back. │ │ │ │ -0000f0e0: 2020 6275 6666 6572 2028 6966 2064 6f75 buffer (if dou │ │ │ │ -0000f0f0: 626c 6520 6275 6666 6572 696e 6720 6973 ble buffering is │ │ │ │ -0000f100: 2065 6e61 626c 6564 292e 2020 4966 2072 enabled). If r │ │ │ │ -0000f110: 656e 6465 7220 7461 7267 6574 2069 730a ender target is. │ │ │ │ -0000f120: 2020 2020 2063 6f72 7265 636c 7479 2073 correclty s │ │ │ │ -0000f130: 7769 7463 6865 6420 4752 5542 5f45 5252 witched GRUB_ERR │ │ │ │ -0000f140: 5f4e 4f4e 4520 6973 2072 6574 7572 6e65 _NONE is returne │ │ │ │ -0000f150: 642e 2020 496e 206e 6f20 616e 7920 6576 d. In no any ev │ │ │ │ -0000f160: 656e 740a 2020 2020 2073 6861 6c6c 2074 ent. shall t │ │ │ │ -0000f170: 6865 7265 2062 6520 6e6f 6e20 6472 6177 here be non draw │ │ │ │ -0000f180: 6162 6c65 2061 6374 6976 6520 7265 6e64 able active rend │ │ │ │ -0000f190: 6572 2074 6172 6765 742e 0a0a 3130 2e31 er target...10.1 │ │ │ │ -0000f1a0: 2e32 3620 6772 7562 5f76 6964 656f 5f67 .26 grub_video_g │ │ │ │ -0000f1b0: 6574 5f61 6374 6976 655f 7265 6e64 6572 et_active_render │ │ │ │ -0000f1c0: 5f74 6172 6765 740a 2d2d 2d2d 2d2d 2d2d _target.-------- │ │ │ │ +0000ee70: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ +0000ee80: 2d0a 0a20 2020 2a20 5072 6f74 6f74 7970 -.. * Prototyp │ │ │ │ +0000ee90: 653a 0a0a 2020 2020 2020 2020 2020 6772 e:.. gr │ │ │ │ +0000eea0: 7562 5f65 7272 5f74 0a20 2020 2020 2020 ub_err_t. │ │ │ │ +0000eeb0: 2020 2067 7275 625f 7669 6465 6f5f 7365 grub_video_se │ │ │ │ +0000eec0: 745f 6163 7469 7665 5f72 656e 6465 725f t_active_render_ │ │ │ │ +0000eed0: 7461 7267 6574 2028 7374 7275 6374 2067 target (struct g │ │ │ │ +0000eee0: 7275 625f 7669 6465 6f5f 7265 6e64 6572 rub_video_render │ │ │ │ +0000eef0: 5f74 6172 6765 7420 2a74 6172 6765 7429 _target *target) │ │ │ │ +0000ef00: 3b0a 2020 202a 2044 6573 6372 6970 7469 ;. * Descripti │ │ │ │ +0000ef10: 6f6e 3a0a 0a20 2020 2020 5365 7473 2061 on:.. Sets a │ │ │ │ +0000ef20: 6374 6976 6520 7265 6e64 6572 2074 6172 ctive render tar │ │ │ │ +0000ef30: 6765 742e 2020 4966 2074 6869 7320 636f get. If this co │ │ │ │ +0000ef40: 6d61 6e64 2069 7320 7375 6363 6573 7366 mand is successf │ │ │ │ +0000ef50: 756c 2061 6c6c 0a20 2020 2020 6472 6177 ul all. draw │ │ │ │ +0000ef60: 696e 6720 636f 6d6d 616e 6473 2077 696c ing commands wil │ │ │ │ +0000ef70: 6c20 6265 2064 6f6e 6520 746f 2073 7065 l be done to spe │ │ │ │ +0000ef80: 6369 6669 6564 2027 7461 7267 6574 272e cified 'target'. │ │ │ │ +0000ef90: 2020 5468 6572 6520 6973 2061 6c73 6f0a There is also. │ │ │ │ +0000efa0: 2020 2020 2073 7065 6369 616c 2076 616c special val │ │ │ │ +0000efb0: 7565 7320 666f 7220 7461 7267 6574 2c20 ues for target, │ │ │ │ +0000efc0: 2747 5255 425f 5649 4445 4f5f 5245 4e44 'GRUB_VIDEO_REND │ │ │ │ +0000efd0: 4552 5f54 4152 4745 545f 4449 5350 4c41 ER_TARGET_DISPLA │ │ │ │ +0000efe0: 5927 2075 7365 640a 2020 2020 2074 6f20 Y' used. to │ │ │ │ +0000eff0: 7265 6665 7265 6e63 6520 7363 7265 656e reference screen │ │ │ │ +0000f000: 2773 2066 726f 6e74 2062 7566 6665 722c 's front buffer, │ │ │ │ +0000f010: 0a20 2020 2020 2747 5255 425f 5649 4445 . 'GRUB_VIDE │ │ │ │ +0000f020: 4f5f 5245 4e44 4552 5f54 4152 4745 545f O_RENDER_TARGET_ │ │ │ │ +0000f030: 4652 4f4e 545f 4255 4646 4552 2720 7573 FRONT_BUFFER' us │ │ │ │ +0000f040: 6564 2074 6f20 7265 6665 7265 6e63 6520 ed to reference │ │ │ │ +0000f050: 7363 7265 656e 2773 0a20 2020 2020 6672 screen's. fr │ │ │ │ +0000f060: 6f6e 7420 6275 6666 6572 2028 616c 6961 ont buffer (alia │ │ │ │ +0000f070: 7320 666f 7220 2747 5255 425f 5649 4445 s for 'GRUB_VIDE │ │ │ │ +0000f080: 4f5f 5245 4e44 4552 5f54 4152 4745 545f O_RENDER_TARGET_ │ │ │ │ +0000f090: 4449 5350 4c41 5927 2920 616e 640a 2020 DISPLAY') and. │ │ │ │ +0000f0a0: 2020 2027 4752 5542 5f56 4944 454f 5f52 'GRUB_VIDEO_R │ │ │ │ +0000f0b0: 454e 4445 525f 5441 5247 4554 5f42 4143 ENDER_TARGET_BAC │ │ │ │ +0000f0c0: 4b5f 4255 4646 4552 2720 7573 6564 2074 K_BUFFER' used t │ │ │ │ +0000f0d0: 6f20 7265 6665 7265 6e63 6520 6261 636b o reference back │ │ │ │ +0000f0e0: 0a20 2020 2020 6275 6666 6572 2028 6966 . buffer (if │ │ │ │ +0000f0f0: 2064 6f75 626c 6520 6275 6666 6572 696e double bufferin │ │ │ │ +0000f100: 6720 6973 2065 6e61 626c 6564 292e 2020 g is enabled). │ │ │ │ +0000f110: 4966 2072 656e 6465 7220 7461 7267 6574 If render target │ │ │ │ +0000f120: 2069 730a 2020 2020 2063 6f72 7265 636c is. correcl │ │ │ │ +0000f130: 7479 2073 7769 7463 6865 6420 4752 5542 ty switched GRUB │ │ │ │ +0000f140: 5f45 5252 5f4e 4f4e 4520 6973 2072 6574 _ERR_NONE is ret │ │ │ │ +0000f150: 7572 6e65 642e 2020 496e 206e 6f20 616e urned. In no an │ │ │ │ +0000f160: 7920 6576 656e 740a 2020 2020 2073 6861 y event. sha │ │ │ │ +0000f170: 6c6c 2074 6865 7265 2062 6520 6e6f 6e20 ll there be non │ │ │ │ +0000f180: 6472 6177 6162 6c65 2061 6374 6976 6520 drawable active │ │ │ │ +0000f190: 7265 6e64 6572 2074 6172 6765 742e 0a0a render target... │ │ │ │ +0000f1a0: 3130 2e31 2e32 3620 6772 7562 5f76 6964 10.1.26 grub_vid │ │ │ │ +0000f1b0: 656f 5f67 6574 5f61 6374 6976 655f 7265 eo_get_active_re │ │ │ │ +0000f1c0: 6e64 6572 5f74 6172 6765 740a 2d2d 2d2d nder_target.---- │ │ │ │ 0000f1d0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ 0000f1e0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ -0000f1f0: 2d2d 2d0a 0a20 2020 2a20 5072 6f74 6f74 ---.. * Protot │ │ │ │ -0000f200: 7970 653a 0a0a 2020 2020 2020 2020 2020 ype:.. │ │ │ │ -0000f210: 6772 7562 5f65 7272 5f74 0a20 2020 2020 grub_err_t. │ │ │ │ -0000f220: 2020 2020 2067 7275 625f 7669 6465 6f5f grub_video_ │ │ │ │ -0000f230: 6765 745f 6163 7469 7665 5f72 656e 6465 get_active_rende │ │ │ │ -0000f240: 725f 7461 7267 6574 2028 7374 7275 6374 r_target (struct │ │ │ │ -0000f250: 2067 7275 625f 7669 6465 6f5f 7265 6e64 grub_video_rend │ │ │ │ -0000f260: 6572 5f74 6172 6765 7420 2a2a 7461 7267 er_target **targ │ │ │ │ -0000f270: 6574 293b 0a20 2020 2a20 4465 7363 7269 et);. * Descri │ │ │ │ -0000f280: 7074 696f 6e3a 0a0a 2020 2020 2052 6574 ption:.. Ret │ │ │ │ -0000f290: 7572 6e73 2063 7572 7265 6e74 6c79 2061 urns currently a │ │ │ │ -0000f2a0: 6374 6976 6520 7265 6e64 6572 2074 6172 ctive render tar │ │ │ │ -0000f2b0: 6765 742e 2020 4974 2072 6574 7572 6e73 get. It returns │ │ │ │ -0000f2c0: 2076 616c 7565 2069 6e0a 2020 2020 2027 value in. ' │ │ │ │ -0000f2d0: 7461 7267 6574 2720 7468 6174 2063 616e target' that can │ │ │ │ -0000f2e0: 2062 6520 7375 6273 6571 7565 6e74 6c79 be subsequently │ │ │ │ -0000f2f0: 2069 7373 7565 6420 6261 636b 2074 6f0a issued back to. │ │ │ │ -0000f300: 2020 2020 2027 6772 7562 5f76 6964 656f 'grub_video │ │ │ │ -0000f310: 5f73 6574 5f61 6374 6976 655f 7265 6e64 _set_active_rend │ │ │ │ -0000f320: 6572 5f74 6172 6765 7427 2e0a 0a1f 0a46 er_target'.....F │ │ │ │ -0000f330: 696c 653a 2067 7275 622d 6465 762e 696e ile: grub-dev.in │ │ │ │ -0000f340: 666f 2c20 204e 6f64 653a 2045 7861 6d70 fo, Node: Examp │ │ │ │ -0000f350: 6c65 2075 7361 6765 206f 6620 5669 6465 le usage of Vide │ │ │ │ -0000f360: 6f20 4150 492c 2020 4e65 7874 3a20 4269 o API, Next: Bi │ │ │ │ -0000f370: 746d 6170 2041 5049 2c20 2050 7265 763a tmap API, Prev: │ │ │ │ -0000f380: 2056 6964 656f 2041 5049 2c20 2055 703a Video API, Up: │ │ │ │ -0000f390: 2056 6964 656f 2053 7562 7379 7374 656d Video Subsystem │ │ │ │ -0000f3a0: 0a0a 3130 2e32 2045 7861 6d70 6c65 2075 ..10.2 Example u │ │ │ │ -0000f3b0: 7361 6765 206f 6620 5669 6465 6f20 4150 sage of Video AP │ │ │ │ -0000f3c0: 490a 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d I.============== │ │ │ │ +0000f1f0: 2d2d 2d2d 2d2d 2d0a 0a20 2020 2a20 5072 -------.. * Pr │ │ │ │ +0000f200: 6f74 6f74 7970 653a 0a0a 2020 2020 2020 ototype:.. │ │ │ │ +0000f210: 2020 2020 6772 7562 5f65 7272 5f74 0a20 grub_err_t. │ │ │ │ +0000f220: 2020 2020 2020 2020 2067 7275 625f 7669 grub_vi │ │ │ │ +0000f230: 6465 6f5f 6765 745f 6163 7469 7665 5f72 deo_get_active_r │ │ │ │ +0000f240: 656e 6465 725f 7461 7267 6574 2028 7374 ender_target (st │ │ │ │ +0000f250: 7275 6374 2067 7275 625f 7669 6465 6f5f ruct grub_video_ │ │ │ │ +0000f260: 7265 6e64 6572 5f74 6172 6765 7420 2a2a render_target ** │ │ │ │ +0000f270: 7461 7267 6574 293b 0a20 2020 2a20 4465 target);. * De │ │ │ │ +0000f280: 7363 7269 7074 696f 6e3a 0a0a 2020 2020 scription:.. │ │ │ │ +0000f290: 2052 6574 7572 6e73 2063 7572 7265 6e74 Returns current │ │ │ │ +0000f2a0: 6c79 2061 6374 6976 6520 7265 6e64 6572 ly active render │ │ │ │ +0000f2b0: 2074 6172 6765 742e 2020 4974 2072 6574 target. It ret │ │ │ │ +0000f2c0: 7572 6e73 2076 616c 7565 2069 6e0a 2020 urns value in. │ │ │ │ +0000f2d0: 2020 2027 7461 7267 6574 2720 7468 6174 'target' that │ │ │ │ +0000f2e0: 2063 616e 2062 6520 7375 6273 6571 7565 can be subseque │ │ │ │ +0000f2f0: 6e74 6c79 2069 7373 7565 6420 6261 636b ntly issued back │ │ │ │ +0000f300: 2074 6f0a 2020 2020 2027 6772 7562 5f76 to. 'grub_v │ │ │ │ +0000f310: 6964 656f 5f73 6574 5f61 6374 6976 655f ideo_set_active_ │ │ │ │ +0000f320: 7265 6e64 6572 5f74 6172 6765 7427 2e0a render_target'.. │ │ │ │ +0000f330: 0a1f 0a46 696c 653a 2067 7275 622d 6465 ...File: grub-de │ │ │ │ +0000f340: 762e 696e 666f 2c20 204e 6f64 653a 2045 v.info, Node: E │ │ │ │ +0000f350: 7861 6d70 6c65 2075 7361 6765 206f 6620 xample usage of │ │ │ │ +0000f360: 5669 6465 6f20 4150 492c 2020 4e65 7874 Video API, Next │ │ │ │ +0000f370: 3a20 4269 746d 6170 2041 5049 2c20 2050 : Bitmap API, P │ │ │ │ +0000f380: 7265 763a 2056 6964 656f 2041 5049 2c20 rev: Video API, │ │ │ │ +0000f390: 2055 703a 2056 6964 656f 2053 7562 7379 Up: Video Subsy │ │ │ │ +0000f3a0: 7374 656d 0a0a 3130 2e32 2045 7861 6d70 stem..10.2 Examp │ │ │ │ +0000f3b0: 6c65 2075 7361 6765 206f 6620 5669 6465 le usage of Vide │ │ │ │ +0000f3c0: 6f20 4150 490a 3d3d 3d3d 3d3d 3d3d 3d3d o API.========== │ │ │ │ 0000f3d0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ -0000f3e0: 3d0a 0a31 302e 322e 3120 4578 616d 706c =..10.2.1 Exampl │ │ │ │ -0000f3f0: 6520 6f66 2073 6372 6565 6e20 7365 7475 e of screen setu │ │ │ │ -0000f400: 700a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d p.-------------- │ │ │ │ +0000f3e0: 3d3d 3d3d 3d0a 0a31 302e 322e 3120 4578 =====..10.2.1 Ex │ │ │ │ +0000f3f0: 616d 706c 6520 6f66 2073 6372 6565 6e20 ample of screen │ │ │ │ +0000f400: 7365 7475 700a 2d2d 2d2d 2d2d 2d2d 2d2d setup.---------- │ │ │ │ 0000f410: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ -0000f420: 0a0a 2020 2020 2067 7275 625f 6572 725f .. grub_err_ │ │ │ │ -0000f430: 7420 7263 3b0a 2020 2020 202f 2a20 5472 t rc;. /* Tr │ │ │ │ -0000f440: 7920 746f 2069 6e69 7469 616c 697a 6520 y to initialize │ │ │ │ -0000f450: 7669 6465 6f20 6d6f 6465 2031 3032 3420 video mode 1024 │ │ │ │ -0000f460: 7820 3736 3820 7769 7468 2064 6972 6563 x 768 with direc │ │ │ │ -0000f470: 7420 5247 422e 2020 2a2f 0a20 2020 2020 t RGB. */. │ │ │ │ -0000f480: 7263 203d 2067 7275 625f 7669 6465 6f5f rc = grub_video_ │ │ │ │ -0000f490: 7365 7475 7020 2831 3032 342c 2037 3638 setup (1024, 768 │ │ │ │ -0000f4a0: 2c20 4752 5542 5f56 4944 454f 5f4d 4f44 , GRUB_VIDEO_MOD │ │ │ │ -0000f4b0: 455f 5459 5045 5f52 4742 293b 0a20 2020 E_TYPE_RGB);. │ │ │ │ -0000f4c0: 2020 6966 2028 7263 2021 3d20 4752 5542 if (rc != GRUB │ │ │ │ -0000f4d0: 5f45 5252 5f4e 4f4e 4529 0a20 2020 2020 _ERR_NONE). │ │ │ │ -0000f4e0: 7b0a 2020 2020 2020 202f 2a20 4661 6c6c {. /* Fall │ │ │ │ -0000f4f0: 2062 6163 6b20 746f 2073 7461 6e64 6172 back to standar │ │ │ │ -0000f500: 6420 5647 4120 496e 6465 7820 436f 6c6f d VGA Index Colo │ │ │ │ -0000f510: 7220 6d6f 6465 2e20 202a 2f0a 2020 2020 r mode. */. │ │ │ │ -0000f520: 2020 2072 6320 3d20 6772 7562 5f76 6964 rc = grub_vid │ │ │ │ -0000f530: 656f 5f73 6574 7570 2028 3634 302c 2034 eo_setup (640, 4 │ │ │ │ -0000f540: 3830 2c20 4752 5542 5f56 4944 454f 5f4d 80, GRUB_VIDEO_M │ │ │ │ -0000f550: 4f44 455f 5459 5045 5f49 4e44 4558 293b ODE_TYPE_INDEX); │ │ │ │ -0000f560: 0a20 2020 2020 2020 6966 2028 7263 2021 . if (rc ! │ │ │ │ -0000f570: 3d20 4752 5542 5f45 5252 5f4e 4f4e 4529 = GRUB_ERR_NONE) │ │ │ │ -0000f580: 0a20 2020 2020 2020 7b0a 2020 2020 2020 . {. │ │ │ │ -0000f590: 202f 2a20 4861 6e64 6c65 2065 7272 6f72 /* Handle error │ │ │ │ -0000f5a0: 2e20 202a 2f0a 2020 2020 2020 207d 0a20 . */. }. │ │ │ │ -0000f5b0: 2020 2020 7d0a 0a31 302e 322e 3220 4578 }..10.2.2 Ex │ │ │ │ -0000f5c0: 616d 706c 6520 6f66 2073 6574 7469 6e67 ample of setting │ │ │ │ -0000f5d0: 2075 7020 636f 6e73 6f6c 6520 7669 6577 up console view │ │ │ │ -0000f5e0: 706f 7274 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d port.----------- │ │ │ │ +0000f420: 2d2d 2d2d 0a0a 2020 2020 2067 7275 625f ----.. grub_ │ │ │ │ +0000f430: 6572 725f 7420 7263 3b0a 2020 2020 202f err_t rc;. / │ │ │ │ +0000f440: 2a20 5472 7920 746f 2069 6e69 7469 616c * Try to initial │ │ │ │ +0000f450: 697a 6520 7669 6465 6f20 6d6f 6465 2031 ize video mode 1 │ │ │ │ +0000f460: 3032 3420 7820 3736 3820 7769 7468 2064 024 x 768 with d │ │ │ │ +0000f470: 6972 6563 7420 5247 422e 2020 2a2f 0a20 irect RGB. */. │ │ │ │ +0000f480: 2020 2020 7263 203d 2067 7275 625f 7669 rc = grub_vi │ │ │ │ +0000f490: 6465 6f5f 7365 7475 7020 2831 3032 342c deo_setup (1024, │ │ │ │ +0000f4a0: 2037 3638 2c20 4752 5542 5f56 4944 454f 768, GRUB_VIDEO │ │ │ │ +0000f4b0: 5f4d 4f44 455f 5459 5045 5f52 4742 293b _MODE_TYPE_RGB); │ │ │ │ +0000f4c0: 0a20 2020 2020 6966 2028 7263 2021 3d20 . if (rc != │ │ │ │ +0000f4d0: 4752 5542 5f45 5252 5f4e 4f4e 4529 0a20 GRUB_ERR_NONE). │ │ │ │ +0000f4e0: 2020 2020 7b0a 2020 2020 2020 202f 2a20 {. /* │ │ │ │ +0000f4f0: 4661 6c6c 2062 6163 6b20 746f 2073 7461 Fall back to sta │ │ │ │ +0000f500: 6e64 6172 6420 5647 4120 496e 6465 7820 ndard VGA Index │ │ │ │ +0000f510: 436f 6c6f 7220 6d6f 6465 2e20 202a 2f0a Color mode. */. │ │ │ │ +0000f520: 2020 2020 2020 2072 6320 3d20 6772 7562 rc = grub │ │ │ │ +0000f530: 5f76 6964 656f 5f73 6574 7570 2028 3634 _video_setup (64 │ │ │ │ +0000f540: 302c 2034 3830 2c20 4752 5542 5f56 4944 0, 480, GRUB_VID │ │ │ │ +0000f550: 454f 5f4d 4f44 455f 5459 5045 5f49 4e44 EO_MODE_TYPE_IND │ │ │ │ +0000f560: 4558 293b 0a20 2020 2020 2020 6966 2028 EX);. if ( │ │ │ │ +0000f570: 7263 2021 3d20 4752 5542 5f45 5252 5f4e rc != GRUB_ERR_N │ │ │ │ +0000f580: 4f4e 4529 0a20 2020 2020 2020 7b0a 2020 ONE). {. │ │ │ │ +0000f590: 2020 2020 202f 2a20 4861 6e64 6c65 2065 /* Handle e │ │ │ │ +0000f5a0: 7272 6f72 2e20 202a 2f0a 2020 2020 2020 rror. */. │ │ │ │ +0000f5b0: 207d 0a20 2020 2020 7d0a 0a31 302e 322e }. }..10.2. │ │ │ │ +0000f5c0: 3220 4578 616d 706c 6520 6f66 2073 6574 2 Example of set │ │ │ │ +0000f5d0: 7469 6e67 2075 7020 636f 6e73 6f6c 6520 ting up console │ │ │ │ +0000f5e0: 7669 6577 706f 7274 0a2d 2d2d 2d2d 2d2d viewport.------- │ │ │ │ 0000f5f0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ 0000f600: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ -0000f610: 2d2d 0a0a 2020 2020 2067 7275 625f 7569 --.. grub_ui │ │ │ │ -0000f620: 6e74 3332 5f74 2078 2c20 792c 2077 6964 nt32_t x, y, wid │ │ │ │ -0000f630: 7468 2c20 6865 6967 6874 3b0a 2020 2020 th, height;. │ │ │ │ -0000f640: 2067 7275 625f 7669 6465 6f5f 636f 6c6f grub_video_colo │ │ │ │ -0000f650: 725f 7420 636f 6c6f 723b 0a20 2020 2020 r_t color;. │ │ │ │ -0000f660: 7374 7275 6374 2067 7275 625f 666f 6e74 struct grub_font │ │ │ │ -0000f670: 5f67 6c79 7068 2067 6c79 7068 3b0a 2020 _glyph glyph;. │ │ │ │ -0000f680: 2020 2067 7275 625f 6572 725f 7420 7263 grub_err_t rc │ │ │ │ -0000f690: 3b0a 2020 2020 202f 2a20 5175 6572 7920 ;. /* Query │ │ │ │ -0000f6a0: 6578 6973 7469 6e67 2076 6965 7770 6f72 existing viewpor │ │ │ │ -0000f6b0: 742e 2020 2a2f 0a20 2020 2020 6772 7562 t. */. grub │ │ │ │ -0000f6c0: 5f76 6964 656f 5f67 6574 5f76 6965 7770 _video_get_viewp │ │ │ │ -0000f6d0: 6f72 7420 2826 782c 2026 792c 2026 7769 ort (&x, &y, &wi │ │ │ │ -0000f6e0: 6474 682c 2026 6865 6967 6874 293b 0a20 dth, &height);. │ │ │ │ -0000f6f0: 2020 2020 2f2a 2046 696c 6c20 6261 636b /* Fill back │ │ │ │ -0000f700: 6772 6f75 6e64 2e20 202a 2f0a 2020 2020 ground. */. │ │ │ │ -0000f710: 2063 6f6c 6f72 203d 2067 7275 625f 7669 color = grub_vi │ │ │ │ -0000f720: 6465 6f5f 6d61 705f 636f 6c6f 7220 2847 deo_map_color (G │ │ │ │ -0000f730: 5255 425f 434f 4c4f 525f 4241 434b 4752 RUB_COLOR_BACKGR │ │ │ │ -0000f740: 4f55 4e44 293b 0a20 2020 2020 6772 7562 OUND);. grub │ │ │ │ -0000f750: 5f76 6964 656f 5f66 696c 6c5f 7265 6374 _video_fill_rect │ │ │ │ -0000f760: 2028 636f 6c6f 722c 2030 2c20 302c 2077 (color, 0, 0, w │ │ │ │ -0000f770: 6964 7468 2c20 6865 6967 6874 293b 0a20 idth, height);. │ │ │ │ -0000f780: 2020 2020 2f2a 2053 6574 7570 2063 6f6e /* Setup con │ │ │ │ -0000f790: 736f 6c65 2076 6965 7770 6f72 742e 2020 sole viewport. │ │ │ │ -0000f7a0: 2a2f 0a20 2020 2020 6772 7562 5f76 6964 */. grub_vid │ │ │ │ -0000f7b0: 656f 5f73 6574 5f76 6965 7770 6f72 7420 eo_set_viewport │ │ │ │ -0000f7c0: 2878 202b 2031 302c 2079 202b 2031 302c (x + 10, y + 10, │ │ │ │ -0000f7d0: 2077 6964 7468 202d 2032 302c 2068 6569 width - 20, hei │ │ │ │ -0000f7e0: 6768 7420 2d20 3230 293b 0a20 2020 2020 ght - 20);. │ │ │ │ -0000f7f0: 6772 7562 5f76 6964 656f 5f67 6574 5f76 grub_video_get_v │ │ │ │ -0000f800: 6965 7770 6f72 7420 2826 782c 2026 792c iewport (&x, &y, │ │ │ │ -0000f810: 2026 7769 6474 682c 2026 6865 6967 6874 &width, &height │ │ │ │ -0000f820: 293b 0a20 2020 2020 636f 6c6f 7220 3d20 );. color = │ │ │ │ -0000f830: 6772 7562 5f76 6964 656f 5f6d 6170 5f63 grub_video_map_c │ │ │ │ -0000f840: 6f6c 6f72 2028 4752 5542 5f43 4f4c 4f52 olor (GRUB_COLOR │ │ │ │ -0000f850: 5f43 4f4e 534f 4c45 5f42 4143 4b47 524f _CONSOLE_BACKGRO │ │ │ │ -0000f860: 554e 4429 3b0a 2020 2020 2067 7275 625f UND);. grub_ │ │ │ │ -0000f870: 7669 6465 6f5f 6669 6c6c 5f72 6563 7420 video_fill_rect │ │ │ │ -0000f880: 2863 6f6c 6f72 2c20 302c 2030 2c20 7769 (color, 0, 0, wi │ │ │ │ -0000f890: 6474 682c 2068 6569 6768 7429 3b0a 2020 dth, height);. │ │ │ │ -0000f8a0: 2020 202f 2a20 4472 6177 2074 6578 7420 /* Draw text │ │ │ │ -0000f8b0: 746f 2076 6965 7770 6f72 742e 2020 2a2f to viewport. */ │ │ │ │ -0000f8c0: 0a20 2020 2020 636f 6c6f 7220 3d20 6772 . color = gr │ │ │ │ -0000f8d0: 7562 5f76 6964 656f 5f6d 6170 5f63 6f6c ub_video_map_col │ │ │ │ -0000f8e0: 6f72 2028 4752 5542 5f43 4f4c 4f52 5f43 or (GRUB_COLOR_C │ │ │ │ -0000f8f0: 4f4e 534f 4c45 5f54 4558 5429 3b0a 2020 ONSOLE_TEXT);. │ │ │ │ -0000f900: 2020 2067 7275 625f 666f 6e74 5f67 6574 grub_font_get │ │ │ │ -0000f910: 5f67 6c79 7068 2028 2758 272c 2026 676c _glyph ('X', &gl │ │ │ │ -0000f920: 7970 6829 3b0a 2020 2020 2067 7275 625f yph);. grub_ │ │ │ │ -0000f930: 7669 6465 6f5f 626c 6974 5f67 6c79 7068 video_blit_glyph │ │ │ │ -0000f940: 2028 2667 6c79 7068 2c20 636f 6c6f 722c (&glyph, color, │ │ │ │ -0000f950: 2030 2c20 3029 3b0a 0a1f 0a46 696c 653a 0, 0);....File: │ │ │ │ -0000f960: 2067 7275 622d 6465 762e 696e 666f 2c20 grub-dev.info, │ │ │ │ -0000f970: 204e 6f64 653a 2042 6974 6d61 7020 4150 Node: Bitmap AP │ │ │ │ -0000f980: 492c 2020 5072 6576 3a20 4578 616d 706c I, Prev: Exampl │ │ │ │ -0000f990: 6520 7573 6167 6520 6f66 2056 6964 656f e usage of Video │ │ │ │ -0000f9a0: 2041 5049 2c20 2055 703a 2056 6964 656f API, Up: Video │ │ │ │ -0000f9b0: 2053 7562 7379 7374 656d 0a0a 3130 2e33 Subsystem..10.3 │ │ │ │ -0000f9c0: 2042 6974 6d61 7020 4150 490a 3d3d 3d3d Bitmap API.==== │ │ │ │ -0000f9d0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a31 302e ===========..10. │ │ │ │ -0000f9e0: 332e 3120 6772 7562 5f76 6964 656f 5f62 3.1 grub_video_b │ │ │ │ -0000f9f0: 6974 6d61 705f 6372 6561 7465 0a2d 2d2d itmap_create.--- │ │ │ │ -0000fa00: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ -0000fa10: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 2020 ------------.. │ │ │ │ -0000fa20: 202a 2050 726f 746f 7479 7065 3a0a 2020 * Prototype:. │ │ │ │ -0000fa30: 2020 2020 2020 2020 6772 7562 5f65 7272 grub_err │ │ │ │ -0000fa40: 5f74 2067 7275 625f 7669 6465 6f5f 6269 _t grub_video_bi │ │ │ │ -0000fa50: 746d 6170 5f63 7265 6174 6520 2873 7472 tmap_create (str │ │ │ │ -0000fa60: 7563 7420 6772 7562 5f76 6964 656f 5f62 uct grub_video_b │ │ │ │ -0000fa70: 6974 6d61 7020 2a2a 6269 746d 6170 2c20 itmap **bitmap, │ │ │ │ -0000fa80: 756e 7369 676e 6564 2069 6e74 2077 6964 unsigned int wid │ │ │ │ -0000fa90: 7468 2c20 756e 7369 676e 6564 2069 6e74 th, unsigned int │ │ │ │ -0000faa0: 2068 6569 6768 742c 2065 6e75 6d20 6772 height, enum gr │ │ │ │ -0000fab0: 7562 5f76 6964 656f 5f62 6c69 745f 666f ub_video_blit_fo │ │ │ │ -0000fac0: 726d 6174 2062 6c69 745f 666f 726d 6174 rmat blit_format │ │ │ │ -0000fad0: 290a 0a20 2020 2a20 4465 7363 7269 7074 ).. * Descript │ │ │ │ -0000fae0: 696f 6e3a 0a0a 2020 2020 2043 7265 6174 ion:.. Creat │ │ │ │ -0000faf0: 6573 2061 206e 6577 2062 6974 6d61 7020 es a new bitmap │ │ │ │ -0000fb00: 7769 7468 2067 6976 656e 2064 696d 656e with given dimen │ │ │ │ -0000fb10: 7369 6f6e 7320 616e 6420 626c 6974 7469 sions and blitti │ │ │ │ -0000fb20: 6e67 2066 6f72 6d61 742e 0a20 2020 2020 ng format.. │ │ │ │ -0000fb30: 416c 6c6f 6361 7465 6420 6269 746d 6170 Allocated bitmap │ │ │ │ -0000fb40: 2064 6174 6120 6361 6e20 7468 656e 2062 data can then b │ │ │ │ -0000fb50: 6520 6d6f 6469 6669 6564 2066 7265 656c e modified freel │ │ │ │ -0000fb60: 7920 616e 6420 6669 6e61 6c6c 790a 2020 y and finally. │ │ │ │ -0000fb70: 2020 2062 6c69 7474 6564 2077 6974 6820 blitted with │ │ │ │ -0000fb80: 2767 7275 625f 7669 6465 6f5f 626c 6974 'grub_video_blit │ │ │ │ -0000fb90: 5f62 6974 6d61 7027 2074 6f20 7265 6e64 _bitmap' to rend │ │ │ │ -0000fba0: 6572 696e 6720 7461 7267 6574 2e0a 0a31 ering target...1 │ │ │ │ -0000fbb0: 302e 332e 3220 6772 7562 5f76 6964 656f 0.3.2 grub_video │ │ │ │ -0000fbc0: 5f62 6974 6d61 705f 6465 7374 726f 790a _bitmap_destroy. │ │ │ │ -0000fbd0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ +0000f610: 2d2d 2d2d 2d2d 0a0a 2020 2020 2067 7275 ------.. gru │ │ │ │ +0000f620: 625f 7569 6e74 3332 5f74 2078 2c20 792c b_uint32_t x, y, │ │ │ │ +0000f630: 2077 6964 7468 2c20 6865 6967 6874 3b0a width, height;. │ │ │ │ +0000f640: 2020 2020 2067 7275 625f 7669 6465 6f5f grub_video_ │ │ │ │ +0000f650: 636f 6c6f 725f 7420 636f 6c6f 723b 0a20 color_t color;. │ │ │ │ +0000f660: 2020 2020 7374 7275 6374 2067 7275 625f struct grub_ │ │ │ │ +0000f670: 666f 6e74 5f67 6c79 7068 2067 6c79 7068 font_glyph glyph │ │ │ │ +0000f680: 3b0a 2020 2020 2067 7275 625f 6572 725f ;. grub_err_ │ │ │ │ +0000f690: 7420 7263 3b0a 2020 2020 202f 2a20 5175 t rc;. /* Qu │ │ │ │ +0000f6a0: 6572 7920 6578 6973 7469 6e67 2076 6965 ery existing vie │ │ │ │ +0000f6b0: 7770 6f72 742e 2020 2a2f 0a20 2020 2020 wport. */. │ │ │ │ +0000f6c0: 6772 7562 5f76 6964 656f 5f67 6574 5f76 grub_video_get_v │ │ │ │ +0000f6d0: 6965 7770 6f72 7420 2826 782c 2026 792c iewport (&x, &y, │ │ │ │ +0000f6e0: 2026 7769 6474 682c 2026 6865 6967 6874 &width, &height │ │ │ │ +0000f6f0: 293b 0a20 2020 2020 2f2a 2046 696c 6c20 );. /* Fill │ │ │ │ +0000f700: 6261 636b 6772 6f75 6e64 2e20 202a 2f0a background. */. │ │ │ │ +0000f710: 2020 2020 2063 6f6c 6f72 203d 2067 7275 color = gru │ │ │ │ +0000f720: 625f 7669 6465 6f5f 6d61 705f 636f 6c6f b_video_map_colo │ │ │ │ +0000f730: 7220 2847 5255 425f 434f 4c4f 525f 4241 r (GRUB_COLOR_BA │ │ │ │ +0000f740: 434b 4752 4f55 4e44 293b 0a20 2020 2020 CKGROUND);. │ │ │ │ +0000f750: 6772 7562 5f76 6964 656f 5f66 696c 6c5f grub_video_fill_ │ │ │ │ +0000f760: 7265 6374 2028 636f 6c6f 722c 2030 2c20 rect (color, 0, │ │ │ │ +0000f770: 302c 2077 6964 7468 2c20 6865 6967 6874 0, width, height │ │ │ │ +0000f780: 293b 0a20 2020 2020 2f2a 2053 6574 7570 );. /* Setup │ │ │ │ +0000f790: 2063 6f6e 736f 6c65 2076 6965 7770 6f72 console viewpor │ │ │ │ +0000f7a0: 742e 2020 2a2f 0a20 2020 2020 6772 7562 t. */. grub │ │ │ │ +0000f7b0: 5f76 6964 656f 5f73 6574 5f76 6965 7770 _video_set_viewp │ │ │ │ +0000f7c0: 6f72 7420 2878 202b 2031 302c 2079 202b ort (x + 10, y + │ │ │ │ +0000f7d0: 2031 302c 2077 6964 7468 202d 2032 302c 10, width - 20, │ │ │ │ +0000f7e0: 2068 6569 6768 7420 2d20 3230 293b 0a20 height - 20);. │ │ │ │ +0000f7f0: 2020 2020 6772 7562 5f76 6964 656f 5f67 grub_video_g │ │ │ │ +0000f800: 6574 5f76 6965 7770 6f72 7420 2826 782c et_viewport (&x, │ │ │ │ +0000f810: 2026 792c 2026 7769 6474 682c 2026 6865 &y, &width, &he │ │ │ │ +0000f820: 6967 6874 293b 0a20 2020 2020 636f 6c6f ight);. colo │ │ │ │ +0000f830: 7220 3d20 6772 7562 5f76 6964 656f 5f6d r = grub_video_m │ │ │ │ +0000f840: 6170 5f63 6f6c 6f72 2028 4752 5542 5f43 ap_color (GRUB_C │ │ │ │ +0000f850: 4f4c 4f52 5f43 4f4e 534f 4c45 5f42 4143 OLOR_CONSOLE_BAC │ │ │ │ +0000f860: 4b47 524f 554e 4429 3b0a 2020 2020 2067 KGROUND);. g │ │ │ │ +0000f870: 7275 625f 7669 6465 6f5f 6669 6c6c 5f72 rub_video_fill_r │ │ │ │ +0000f880: 6563 7420 2863 6f6c 6f72 2c20 302c 2030 ect (color, 0, 0 │ │ │ │ +0000f890: 2c20 7769 6474 682c 2068 6569 6768 7429 , width, height) │ │ │ │ +0000f8a0: 3b0a 2020 2020 202f 2a20 4472 6177 2074 ;. /* Draw t │ │ │ │ +0000f8b0: 6578 7420 746f 2076 6965 7770 6f72 742e ext to viewport. │ │ │ │ +0000f8c0: 2020 2a2f 0a20 2020 2020 636f 6c6f 7220 */. color │ │ │ │ +0000f8d0: 3d20 6772 7562 5f76 6964 656f 5f6d 6170 = grub_video_map │ │ │ │ +0000f8e0: 5f63 6f6c 6f72 2028 4752 5542 5f43 4f4c _color (GRUB_COL │ │ │ │ +0000f8f0: 4f52 5f43 4f4e 534f 4c45 5f54 4558 5429 OR_CONSOLE_TEXT) │ │ │ │ +0000f900: 3b0a 2020 2020 2067 7275 625f 666f 6e74 ;. grub_font │ │ │ │ +0000f910: 5f67 6574 5f67 6c79 7068 2028 2758 272c _get_glyph ('X', │ │ │ │ +0000f920: 2026 676c 7970 6829 3b0a 2020 2020 2067 &glyph);. g │ │ │ │ +0000f930: 7275 625f 7669 6465 6f5f 626c 6974 5f67 rub_video_blit_g │ │ │ │ +0000f940: 6c79 7068 2028 2667 6c79 7068 2c20 636f lyph (&glyph, co │ │ │ │ +0000f950: 6c6f 722c 2030 2c20 3029 3b0a 0a1f 0a46 lor, 0, 0);....F │ │ │ │ +0000f960: 696c 653a 2067 7275 622d 6465 762e 696e ile: grub-dev.in │ │ │ │ +0000f970: 666f 2c20 204e 6f64 653a 2042 6974 6d61 fo, Node: Bitma │ │ │ │ +0000f980: 7020 4150 492c 2020 5072 6576 3a20 4578 p API, Prev: Ex │ │ │ │ +0000f990: 616d 706c 6520 7573 6167 6520 6f66 2056 ample usage of V │ │ │ │ +0000f9a0: 6964 656f 2041 5049 2c20 2055 703a 2056 ideo API, Up: V │ │ │ │ +0000f9b0: 6964 656f 2053 7562 7379 7374 656d 0a0a ideo Subsystem.. │ │ │ │ +0000f9c0: 3130 2e33 2042 6974 6d61 7020 4150 490a 10.3 Bitmap API. │ │ │ │ +0000f9d0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a ===============. │ │ │ │ +0000f9e0: 0a31 302e 332e 3120 6772 7562 5f76 6964 .10.3.1 grub_vid │ │ │ │ +0000f9f0: 656f 5f62 6974 6d61 705f 6372 6561 7465 eo_bitmap_create │ │ │ │ +0000fa00: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d .--------------- │ │ │ │ +0000fa10: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ +0000fa20: 0a0a 2020 202a 2050 726f 746f 7479 7065 .. * Prototype │ │ │ │ +0000fa30: 3a0a 2020 2020 2020 2020 2020 6772 7562 :. grub │ │ │ │ +0000fa40: 5f65 7272 5f74 2067 7275 625f 7669 6465 _err_t grub_vide │ │ │ │ +0000fa50: 6f5f 6269 746d 6170 5f63 7265 6174 6520 o_bitmap_create │ │ │ │ +0000fa60: 2873 7472 7563 7420 6772 7562 5f76 6964 (struct grub_vid │ │ │ │ +0000fa70: 656f 5f62 6974 6d61 7020 2a2a 6269 746d eo_bitmap **bitm │ │ │ │ +0000fa80: 6170 2c20 756e 7369 676e 6564 2069 6e74 ap, unsigned int │ │ │ │ +0000fa90: 2077 6964 7468 2c20 756e 7369 676e 6564 width, unsigned │ │ │ │ +0000faa0: 2069 6e74 2068 6569 6768 742c 2065 6e75 int height, enu │ │ │ │ +0000fab0: 6d20 6772 7562 5f76 6964 656f 5f62 6c69 m grub_video_bli │ │ │ │ +0000fac0: 745f 666f 726d 6174 2062 6c69 745f 666f t_format blit_fo │ │ │ │ +0000fad0: 726d 6174 290a 0a20 2020 2a20 4465 7363 rmat).. * Desc │ │ │ │ +0000fae0: 7269 7074 696f 6e3a 0a0a 2020 2020 2043 ription:.. C │ │ │ │ +0000faf0: 7265 6174 6573 2061 206e 6577 2062 6974 reates a new bit │ │ │ │ +0000fb00: 6d61 7020 7769 7468 2067 6976 656e 2064 map with given d │ │ │ │ +0000fb10: 696d 656e 7369 6f6e 7320 616e 6420 626c imensions and bl │ │ │ │ +0000fb20: 6974 7469 6e67 2066 6f72 6d61 742e 0a20 itting format.. │ │ │ │ +0000fb30: 2020 2020 416c 6c6f 6361 7465 6420 6269 Allocated bi │ │ │ │ +0000fb40: 746d 6170 2064 6174 6120 6361 6e20 7468 tmap data can th │ │ │ │ +0000fb50: 656e 2062 6520 6d6f 6469 6669 6564 2066 en be modified f │ │ │ │ +0000fb60: 7265 656c 7920 616e 6420 6669 6e61 6c6c reely and finall │ │ │ │ +0000fb70: 790a 2020 2020 2062 6c69 7474 6564 2077 y. blitted w │ │ │ │ +0000fb80: 6974 6820 2767 7275 625f 7669 6465 6f5f ith 'grub_video_ │ │ │ │ +0000fb90: 626c 6974 5f62 6974 6d61 7027 2074 6f20 blit_bitmap' to │ │ │ │ +0000fba0: 7265 6e64 6572 696e 6720 7461 7267 6574 rendering target │ │ │ │ +0000fbb0: 2e0a 0a31 302e 332e 3220 6772 7562 5f76 ...10.3.2 grub_v │ │ │ │ +0000fbc0: 6964 656f 5f62 6974 6d61 705f 6465 7374 ideo_bitmap_dest │ │ │ │ +0000fbd0: 726f 790a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d roy.------------ │ │ │ │ 0000fbe0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ -0000fbf0: 0a0a 2020 202a 2050 726f 746f 7479 7065 .. * Prototype │ │ │ │ -0000fc00: 3a0a 2020 2020 2020 2020 2020 6772 7562 :. grub │ │ │ │ -0000fc10: 5f65 7272 5f74 2067 7275 625f 7669 6465 _err_t grub_vide │ │ │ │ -0000fc20: 6f5f 6269 746d 6170 5f64 6573 7472 6f79 o_bitmap_destroy │ │ │ │ -0000fc30: 2028 7374 7275 6374 2067 7275 625f 7669 (struct grub_vi │ │ │ │ -0000fc40: 6465 6f5f 6269 746d 6170 202a 6269 746d deo_bitmap *bitm │ │ │ │ -0000fc50: 6170 293b 0a0a 2020 202a 2044 6573 6372 ap);.. * Descr │ │ │ │ -0000fc60: 6970 7469 6f6e 3a0a 0a20 2020 2020 5768 iption:.. Wh │ │ │ │ -0000fc70: 656e 2062 6974 6d61 7020 6973 206e 6f20 en bitmap is no │ │ │ │ -0000fc80: 6c6f 6e67 6572 206e 6565 6465 642c 2069 longer needed, i │ │ │ │ -0000fc90: 7420 6361 6e20 6265 2066 7265 6564 2066 t can be freed f │ │ │ │ -0000fca0: 726f 6d20 6d65 6d6f 7279 2075 7369 6e67 rom memory using │ │ │ │ -0000fcb0: 0a20 2020 2020 7468 6973 2063 6f6d 6d61 . this comma │ │ │ │ -0000fcc0: 6e64 2e20 2027 6269 746d 6170 2720 6973 nd. 'bitmap' is │ │ │ │ -0000fcd0: 2070 7265 7669 6f75 736c 7920 616c 6c6f previously allo │ │ │ │ -0000fce0: 6361 7465 6420 6269 746d 6170 2077 6974 cated bitmap wit │ │ │ │ -0000fcf0: 680a 2020 2020 2027 6772 7562 5f76 6964 h. 'grub_vid │ │ │ │ -0000fd00: 656f 5f62 6974 6d61 705f 6372 6561 7465 eo_bitmap_create │ │ │ │ -0000fd10: 2720 6f72 206c 6f61 6465 6420 7769 7468 ' or loaded with │ │ │ │ -0000fd20: 2027 6772 7562 5f76 6964 656f 5f62 6974 'grub_video_bit │ │ │ │ -0000fd30: 6d61 705f 6c6f 6164 272e 0a0a 3130 2e33 map_load'...10.3 │ │ │ │ -0000fd40: 2e33 2067 7275 625f 7669 6465 6f5f 6269 .3 grub_video_bi │ │ │ │ -0000fd50: 746d 6170 5f6c 6f61 640a 2d2d 2d2d 2d2d tmap_load.------ │ │ │ │ +0000fbf0: 2d2d 2d2d 0a0a 2020 202a 2050 726f 746f ----.. * Proto │ │ │ │ +0000fc00: 7479 7065 3a0a 2020 2020 2020 2020 2020 type:. │ │ │ │ +0000fc10: 6772 7562 5f65 7272 5f74 2067 7275 625f grub_err_t grub_ │ │ │ │ +0000fc20: 7669 6465 6f5f 6269 746d 6170 5f64 6573 video_bitmap_des │ │ │ │ +0000fc30: 7472 6f79 2028 7374 7275 6374 2067 7275 troy (struct gru │ │ │ │ +0000fc40: 625f 7669 6465 6f5f 6269 746d 6170 202a b_video_bitmap * │ │ │ │ +0000fc50: 6269 746d 6170 293b 0a0a 2020 202a 2044 bitmap);.. * D │ │ │ │ +0000fc60: 6573 6372 6970 7469 6f6e 3a0a 0a20 2020 escription:.. │ │ │ │ +0000fc70: 2020 5768 656e 2062 6974 6d61 7020 6973 When bitmap is │ │ │ │ +0000fc80: 206e 6f20 6c6f 6e67 6572 206e 6565 6465 no longer neede │ │ │ │ +0000fc90: 642c 2069 7420 6361 6e20 6265 2066 7265 d, it can be fre │ │ │ │ +0000fca0: 6564 2066 726f 6d20 6d65 6d6f 7279 2075 ed from memory u │ │ │ │ +0000fcb0: 7369 6e67 0a20 2020 2020 7468 6973 2063 sing. this c │ │ │ │ +0000fcc0: 6f6d 6d61 6e64 2e20 2027 6269 746d 6170 ommand. 'bitmap │ │ │ │ +0000fcd0: 2720 6973 2070 7265 7669 6f75 736c 7920 ' is previously │ │ │ │ +0000fce0: 616c 6c6f 6361 7465 6420 6269 746d 6170 allocated bitmap │ │ │ │ +0000fcf0: 2077 6974 680a 2020 2020 2027 6772 7562 with. 'grub │ │ │ │ +0000fd00: 5f76 6964 656f 5f62 6974 6d61 705f 6372 _video_bitmap_cr │ │ │ │ +0000fd10: 6561 7465 2720 6f72 206c 6f61 6465 6420 eate' or loaded │ │ │ │ +0000fd20: 7769 7468 2027 6772 7562 5f76 6964 656f with 'grub_video │ │ │ │ +0000fd30: 5f62 6974 6d61 705f 6c6f 6164 272e 0a0a _bitmap_load'... │ │ │ │ +0000fd40: 3130 2e33 2e33 2067 7275 625f 7669 6465 10.3.3 grub_vide │ │ │ │ +0000fd50: 6f5f 6269 746d 6170 5f6c 6f61 640a 2d2d o_bitmap_load.-- │ │ │ │ 0000fd60: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ -0000fd70: 2d2d 2d2d 2d2d 2d0a 0a20 2020 2a20 5072 -------.. * Pr │ │ │ │ -0000fd80: 6f74 6f74 7970 653a 0a20 2020 2020 2020 ototype:. │ │ │ │ -0000fd90: 2020 2067 7275 625f 6572 725f 7420 6772 grub_err_t gr │ │ │ │ -0000fda0: 7562 5f76 6964 656f 5f62 6974 6d61 705f ub_video_bitmap_ │ │ │ │ -0000fdb0: 6c6f 6164 2028 7374 7275 6374 2067 7275 load (struct gru │ │ │ │ -0000fdc0: 625f 7669 6465 6f5f 6269 746d 6170 202a b_video_bitmap * │ │ │ │ -0000fdd0: 2a62 6974 6d61 702c 2063 6f6e 7374 2063 *bitmap, const c │ │ │ │ -0000fde0: 6861 7220 2a66 696c 656e 616d 6529 3b0a har *filename);. │ │ │ │ -0000fdf0: 0a20 2020 2a20 4465 7363 7269 7074 696f . * Descriptio │ │ │ │ -0000fe00: 6e3a 0a0a 2020 2020 2054 7269 6573 2074 n:.. Tries t │ │ │ │ -0000fe10: 6f20 6c6f 6164 2067 6976 656e 2062 6974 o load given bit │ │ │ │ -0000fe20: 6d61 7020 2827 6669 6c65 6e61 6d65 2729 map ('filename') │ │ │ │ -0000fe30: 2075 7369 6e67 2072 6567 6973 7465 7265 using registere │ │ │ │ -0000fe40: 6420 6269 746d 6170 0a20 2020 2020 6c6f d bitmap. lo │ │ │ │ -0000fe50: 6164 6572 732e 2020 496e 2063 6173 6520 aders. In case │ │ │ │ -0000fe60: 6269 746d 6170 2066 6f72 6d61 7420 6973 bitmap format is │ │ │ │ -0000fe70: 206e 6f74 2072 6563 6f67 6e69 7a65 6420 not recognized │ │ │ │ -0000fe80: 6f72 2073 7570 706f 7274 6564 0a20 2020 or supported. │ │ │ │ -0000fe90: 2020 6572 726f 7220 2747 5255 425f 4552 error 'GRUB_ER │ │ │ │ -0000fea0: 525f 4241 445f 4649 4c45 5f54 5950 4527 R_BAD_FILE_TYPE' │ │ │ │ -0000feb0: 2069 7320 7265 7475 726e 6564 2e0a 0a31 is returned...1 │ │ │ │ -0000fec0: 302e 332e 3420 6772 7562 5f76 6964 656f 0.3.4 grub_video │ │ │ │ -0000fed0: 5f62 6974 6d61 705f 6765 745f 7769 6474 _bitmap_get_widt │ │ │ │ -0000fee0: 680a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d h.-------------- │ │ │ │ +0000fd70: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2020 -----------.. │ │ │ │ +0000fd80: 2a20 5072 6f74 6f74 7970 653a 0a20 2020 * Prototype:. │ │ │ │ +0000fd90: 2020 2020 2020 2067 7275 625f 6572 725f grub_err_ │ │ │ │ +0000fda0: 7420 6772 7562 5f76 6964 656f 5f62 6974 t grub_video_bit │ │ │ │ +0000fdb0: 6d61 705f 6c6f 6164 2028 7374 7275 6374 map_load (struct │ │ │ │ +0000fdc0: 2067 7275 625f 7669 6465 6f5f 6269 746d grub_video_bitm │ │ │ │ +0000fdd0: 6170 202a 2a62 6974 6d61 702c 2063 6f6e ap **bitmap, con │ │ │ │ +0000fde0: 7374 2063 6861 7220 2a66 696c 656e 616d st char *filenam │ │ │ │ +0000fdf0: 6529 3b0a 0a20 2020 2a20 4465 7363 7269 e);.. * Descri │ │ │ │ +0000fe00: 7074 696f 6e3a 0a0a 2020 2020 2054 7269 ption:.. Tri │ │ │ │ +0000fe10: 6573 2074 6f20 6c6f 6164 2067 6976 656e es to load given │ │ │ │ +0000fe20: 2062 6974 6d61 7020 2827 6669 6c65 6e61 bitmap ('filena │ │ │ │ +0000fe30: 6d65 2729 2075 7369 6e67 2072 6567 6973 me') using regis │ │ │ │ +0000fe40: 7465 7265 6420 6269 746d 6170 0a20 2020 tered bitmap. │ │ │ │ +0000fe50: 2020 6c6f 6164 6572 732e 2020 496e 2063 loaders. In c │ │ │ │ +0000fe60: 6173 6520 6269 746d 6170 2066 6f72 6d61 ase bitmap forma │ │ │ │ +0000fe70: 7420 6973 206e 6f74 2072 6563 6f67 6e69 t is not recogni │ │ │ │ +0000fe80: 7a65 6420 6f72 2073 7570 706f 7274 6564 zed or supported │ │ │ │ +0000fe90: 0a20 2020 2020 6572 726f 7220 2747 5255 . error 'GRU │ │ │ │ +0000fea0: 425f 4552 525f 4241 445f 4649 4c45 5f54 B_ERR_BAD_FILE_T │ │ │ │ +0000feb0: 5950 4527 2069 7320 7265 7475 726e 6564 YPE' is returned │ │ │ │ +0000fec0: 2e0a 0a31 302e 332e 3420 6772 7562 5f76 ...10.3.4 grub_v │ │ │ │ +0000fed0: 6964 656f 5f62 6974 6d61 705f 6765 745f ideo_bitmap_get_ │ │ │ │ +0000fee0: 7769 6474 680a 2d2d 2d2d 2d2d 2d2d 2d2d width.---------- │ │ │ │ 0000fef0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ -0000ff00: 2d2d 2d2d 0a0a 2020 202a 2050 726f 746f ----.. * Proto │ │ │ │ -0000ff10: 7479 7065 3a0a 2020 2020 2020 2020 2020 type:. │ │ │ │ -0000ff20: 756e 7369 676e 6564 2069 6e74 2067 7275 unsigned int gru │ │ │ │ -0000ff30: 625f 7669 6465 6f5f 6269 746d 6170 5f67 b_video_bitmap_g │ │ │ │ -0000ff40: 6574 5f77 6964 7468 2028 7374 7275 6374 et_width (struct │ │ │ │ -0000ff50: 2067 7275 625f 7669 6465 6f5f 6269 746d grub_video_bitm │ │ │ │ -0000ff60: 6170 202a 6269 746d 6170 293b 0a0a 2020 ap *bitmap);.. │ │ │ │ -0000ff70: 202a 2044 6573 6372 6970 7469 6f6e 3a0a * Description:. │ │ │ │ -0000ff80: 0a20 2020 2020 5265 7475 726e 7320 6269 . Returns bi │ │ │ │ -0000ff90: 746d 6170 2077 6964 7468 2e0a 0a31 302e tmap width...10. │ │ │ │ -0000ffa0: 332e 3520 6772 7562 5f76 6964 656f 5f62 3.5 grub_video_b │ │ │ │ -0000ffb0: 6974 6d61 705f 6765 745f 6865 6967 6874 itmap_get_height │ │ │ │ -0000ffc0: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d .--------------- │ │ │ │ +0000ff00: 2d2d 2d2d 2d2d 2d2d 0a0a 2020 202a 2050 --------.. * P │ │ │ │ +0000ff10: 726f 746f 7479 7065 3a0a 2020 2020 2020 rototype:. │ │ │ │ +0000ff20: 2020 2020 756e 7369 676e 6564 2069 6e74 unsigned int │ │ │ │ +0000ff30: 2067 7275 625f 7669 6465 6f5f 6269 746d grub_video_bitm │ │ │ │ +0000ff40: 6170 5f67 6574 5f77 6964 7468 2028 7374 ap_get_width (st │ │ │ │ +0000ff50: 7275 6374 2067 7275 625f 7669 6465 6f5f ruct grub_video_ │ │ │ │ +0000ff60: 6269 746d 6170 202a 6269 746d 6170 293b bitmap *bitmap); │ │ │ │ +0000ff70: 0a0a 2020 202a 2044 6573 6372 6970 7469 .. * Descripti │ │ │ │ +0000ff80: 6f6e 3a0a 0a20 2020 2020 5265 7475 726e on:.. Return │ │ │ │ +0000ff90: 7320 6269 746d 6170 2077 6964 7468 2e0a s bitmap width.. │ │ │ │ +0000ffa0: 0a31 302e 332e 3520 6772 7562 5f76 6964 .10.3.5 grub_vid │ │ │ │ +0000ffb0: 656f 5f62 6974 6d61 705f 6765 745f 6865 eo_bitmap_get_he │ │ │ │ +0000ffc0: 6967 6874 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d ight.----------- │ │ │ │ 0000ffd0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ -0000ffe0: 2d2d 2d2d 0a0a 2020 202a 2050 726f 746f ----.. * Proto │ │ │ │ -0000fff0: 7479 7065 3a0a 2020 2020 2020 2020 2020 type:. │ │ │ │ -00010000: 756e 7369 676e 6564 2069 6e74 2067 7275 unsigned int gru │ │ │ │ -00010010: 625f 7669 6465 6f5f 6269 746d 6170 5f67 b_video_bitmap_g │ │ │ │ -00010020: 6574 5f68 6569 6768 7420 2873 7472 7563 et_height (struc │ │ │ │ -00010030: 7420 6772 7562 5f76 6964 656f 5f62 6974 t grub_video_bit │ │ │ │ -00010040: 6d61 7020 2a62 6974 6d61 7029 3b0a 0a20 map *bitmap);.. │ │ │ │ -00010050: 2020 2a20 4465 7363 7269 7074 696f 6e3a * Description: │ │ │ │ -00010060: 0a0a 2020 2020 2052 6574 7572 6e20 6269 .. Return bi │ │ │ │ -00010070: 746d 6170 2068 6569 6768 742e 0a0a 3130 tmap height...10 │ │ │ │ -00010080: 2e33 2e36 2067 7275 625f 7669 6465 6f5f .3.6 grub_video_ │ │ │ │ -00010090: 6269 746d 6170 5f67 6574 5f6d 6f64 655f bitmap_get_mode_ │ │ │ │ -000100a0: 696e 666f 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d info.----------- │ │ │ │ +0000ffe0: 2d2d 2d2d 2d2d 2d2d 0a0a 2020 202a 2050 --------.. * P │ │ │ │ +0000fff0: 726f 746f 7479 7065 3a0a 2020 2020 2020 rototype:. │ │ │ │ +00010000: 2020 2020 756e 7369 676e 6564 2069 6e74 unsigned int │ │ │ │ +00010010: 2067 7275 625f 7669 6465 6f5f 6269 746d grub_video_bitm │ │ │ │ +00010020: 6170 5f67 6574 5f68 6569 6768 7420 2873 ap_get_height (s │ │ │ │ +00010030: 7472 7563 7420 6772 7562 5f76 6964 656f truct grub_video │ │ │ │ +00010040: 5f62 6974 6d61 7020 2a62 6974 6d61 7029 _bitmap *bitmap) │ │ │ │ +00010050: 3b0a 0a20 2020 2a20 4465 7363 7269 7074 ;.. * Descript │ │ │ │ +00010060: 696f 6e3a 0a0a 2020 2020 2052 6574 7572 ion:.. Retur │ │ │ │ +00010070: 6e20 6269 746d 6170 2068 6569 6768 742e n bitmap height. │ │ │ │ +00010080: 0a0a 3130 2e33 2e36 2067 7275 625f 7669 ..10.3.6 grub_vi │ │ │ │ +00010090: 6465 6f5f 6269 746d 6170 5f67 6574 5f6d deo_bitmap_get_m │ │ │ │ +000100a0: 6f64 655f 696e 666f 0a2d 2d2d 2d2d 2d2d ode_info.------- │ │ │ │ 000100b0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ -000100c0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2020 -----------.. │ │ │ │ -000100d0: 2a20 5072 6f74 6f74 7970 653a 0a20 2020 * Prototype:. │ │ │ │ -000100e0: 2020 2020 2020 2076 6f69 6420 6772 7562 void grub │ │ │ │ -000100f0: 5f76 6964 656f 5f62 6974 6d61 705f 6765 _video_bitmap_ge │ │ │ │ -00010100: 745f 6d6f 6465 5f69 6e66 6f20 2873 7472 t_mode_info (str │ │ │ │ -00010110: 7563 7420 6772 7562 5f76 6964 656f 5f62 uct grub_video_b │ │ │ │ -00010120: 6974 6d61 7020 2a62 6974 6d61 702c 2073 itmap *bitmap, s │ │ │ │ -00010130: 7472 7563 7420 6772 7562 5f76 6964 656f truct grub_video │ │ │ │ -00010140: 5f6d 6f64 655f 696e 666f 202a 6d6f 6465 _mode_info *mode │ │ │ │ -00010150: 5f69 6e66 6f29 3b0a 0a20 2020 2a20 4465 _info);.. * De │ │ │ │ -00010160: 7363 7269 7074 696f 6e3a 0a0a 2020 2020 scription:.. │ │ │ │ -00010170: 2052 6574 7572 6e73 2062 6974 6d61 7020 Returns bitmap │ │ │ │ -00010180: 666f 726d 6174 2064 6574 6169 6c73 2069 format details i │ │ │ │ -00010190: 6e20 666f 726d 206f 6620 2767 7275 625f n form of 'grub_ │ │ │ │ -000101a0: 7669 6465 6f5f 6d6f 6465 5f69 6e66 6f27 video_mode_info' │ │ │ │ -000101b0: 2e0a 0a31 302e 332e 3720 6772 7562 5f76 ...10.3.7 grub_v │ │ │ │ -000101c0: 6964 656f 5f62 6974 6d61 705f 6765 745f ideo_bitmap_get_ │ │ │ │ -000101d0: 6461 7461 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d data.----------- │ │ │ │ +000100c0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a ---------------. │ │ │ │ +000100d0: 0a20 2020 2a20 5072 6f74 6f74 7970 653a . * Prototype: │ │ │ │ +000100e0: 0a20 2020 2020 2020 2020 2076 6f69 6420 . void │ │ │ │ +000100f0: 6772 7562 5f76 6964 656f 5f62 6974 6d61 grub_video_bitma │ │ │ │ +00010100: 705f 6765 745f 6d6f 6465 5f69 6e66 6f20 p_get_mode_info │ │ │ │ +00010110: 2873 7472 7563 7420 6772 7562 5f76 6964 (struct grub_vid │ │ │ │ +00010120: 656f 5f62 6974 6d61 7020 2a62 6974 6d61 eo_bitmap *bitma │ │ │ │ +00010130: 702c 2073 7472 7563 7420 6772 7562 5f76 p, struct grub_v │ │ │ │ +00010140: 6964 656f 5f6d 6f64 655f 696e 666f 202a ideo_mode_info * │ │ │ │ +00010150: 6d6f 6465 5f69 6e66 6f29 3b0a 0a20 2020 mode_info);.. │ │ │ │ +00010160: 2a20 4465 7363 7269 7074 696f 6e3a 0a0a * Description:.. │ │ │ │ +00010170: 2020 2020 2052 6574 7572 6e73 2062 6974 Returns bit │ │ │ │ +00010180: 6d61 7020 666f 726d 6174 2064 6574 6169 map format detai │ │ │ │ +00010190: 6c73 2069 6e20 666f 726d 206f 6620 2767 ls in form of 'g │ │ │ │ +000101a0: 7275 625f 7669 6465 6f5f 6d6f 6465 5f69 rub_video_mode_i │ │ │ │ +000101b0: 6e66 6f27 2e0a 0a31 302e 332e 3720 6772 nfo'...10.3.7 gr │ │ │ │ +000101c0: 7562 5f76 6964 656f 5f62 6974 6d61 705f ub_video_bitmap_ │ │ │ │ +000101d0: 6765 745f 6461 7461 0a2d 2d2d 2d2d 2d2d get_data.------- │ │ │ │ 000101e0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ -000101f0: 2d2d 2d2d 2d2d 0a0a 2020 202a 2050 726f ------.. * Pro │ │ │ │ -00010200: 746f 7479 7065 3a0a 2020 2020 2020 2020 totype:. │ │ │ │ -00010210: 2020 766f 6964 202a 6772 7562 5f76 6964 void *grub_vid │ │ │ │ -00010220: 656f 5f62 6974 6d61 705f 6765 745f 6461 eo_bitmap_get_da │ │ │ │ -00010230: 7461 2028 7374 7275 6374 2067 7275 625f ta (struct grub_ │ │ │ │ -00010240: 7669 6465 6f5f 6269 746d 6170 202a 6269 video_bitmap *bi │ │ │ │ -00010250: 746d 6170 293b 0a0a 2020 202a 2044 6573 tmap);.. * Des │ │ │ │ -00010260: 6372 6970 7469 6f6e 3a0a 0a20 2020 2020 cription:.. │ │ │ │ -00010270: 5265 7475 726e 2070 6f69 6e74 6572 2074 Return pointer t │ │ │ │ -00010280: 6f20 6269 746d 6170 2064 6174 612e 2020 o bitmap data. │ │ │ │ -00010290: 436f 6e74 656e 7473 206f 6620 7468 6520 Contents of the │ │ │ │ -000102a0: 706f 696e 7465 6420 6461 7461 2063 616e pointed data can │ │ │ │ -000102b0: 2062 650a 2020 2020 2066 7265 656c 7920 be. freely │ │ │ │ -000102c0: 6d6f 6469 6669 6564 2e20 2054 6865 7265 modified. There │ │ │ │ -000102d0: 2069 7320 6e6f 2065 7874 7261 2070 726f is no extra pro │ │ │ │ -000102e0: 7465 6374 696f 6e20 6167 6169 6e73 7420 tection against │ │ │ │ -000102f0: 676f 696e 6720 6f66 660a 2020 2020 2074 going off. t │ │ │ │ -00010300: 6865 2062 6f75 6e64 7320 736f 2079 6f75 he bounds so you │ │ │ │ -00010310: 2068 6176 6520 746f 2062 6520 6361 7265 have to be care │ │ │ │ -00010320: 6675 6c6c 2068 6f77 2074 6f20 6163 6365 full how to acce │ │ │ │ -00010330: 7373 2074 6865 2064 6174 612e 0a0a 1f0a ss the data..... │ │ │ │ -00010340: 4669 6c65 3a20 6772 7562 2d64 6576 2e69 File: grub-dev.i │ │ │ │ -00010350: 6e66 6f2c 2020 4e6f 6465 3a20 5046 4632 nfo, Node: PFF2 │ │ │ │ -00010360: 2046 6f6e 7420 4669 6c65 2046 6f72 6d61 Font File Forma │ │ │ │ -00010370: 742c 2020 4e65 7874 3a20 4772 6170 6869 t, Next: Graphi │ │ │ │ -00010380: 6361 6c20 4d65 6e75 2053 6f66 7477 6172 cal Menu Softwar │ │ │ │ -00010390: 6520 4465 7369 676e 2c20 2050 7265 763a e Design, Prev: │ │ │ │ -000103a0: 2056 6964 656f 2053 7562 7379 7374 656d Video Subsystem │ │ │ │ -000103b0: 2c20 2055 703a 2054 6f70 0a0a 3131 2050 , Up: Top..11 P │ │ │ │ -000103c0: 4646 3220 466f 6e74 2046 696c 6520 466f FF2 Font File Fo │ │ │ │ -000103d0: 726d 6174 0a2a 2a2a 2a2a 2a2a 2a2a 2a2a rmat.*********** │ │ │ │ -000103e0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a0a 0a2a *************..* │ │ │ │ -000103f0: 204d 656e 753a 0a0a 2a20 496e 7472 6f64 Menu:..* Introd │ │ │ │ -00010400: 7563 7469 6f6e 3a3a 0a2a 2046 696c 6520 uction::.* File │ │ │ │ -00010410: 5374 7275 6374 7572 653a 3a0a 2a20 466f Structure::.* Fo │ │ │ │ -00010420: 6e74 204d 6574 7269 6373 3a3a 0a0a 1f0a nt Metrics::.... │ │ │ │ -00010430: 4669 6c65 3a20 6772 7562 2d64 6576 2e69 File: grub-dev.i │ │ │ │ -00010440: 6e66 6f2c 2020 4e6f 6465 3a20 496e 7472 nfo, Node: Intr │ │ │ │ -00010450: 6f64 7563 7469 6f6e 2c20 204e 6578 743a oduction, Next: │ │ │ │ -00010460: 2046 696c 6520 5374 7275 6374 7572 652c File Structure, │ │ │ │ -00010470: 2020 5570 3a20 5046 4632 2046 6f6e 7420 Up: PFF2 Font │ │ │ │ -00010480: 4669 6c65 2046 6f72 6d61 740a 0a31 312e File Format..11. │ │ │ │ -00010490: 3120 496e 7472 6f64 7563 7469 6f6e 0a3d 1 Introduction.= │ │ │ │ -000104a0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ -000104b0: 0a0a 5468 6520 676f 616c 206f 6620 7468 ..The goal of th │ │ │ │ -000104c0: 6973 2066 6f72 6d61 7420 6973 2074 6f20 is format is to │ │ │ │ -000104d0: 7072 6f76 6964 6520 6120 6269 746d 6170 provide a bitmap │ │ │ │ -000104e0: 2066 6f6e 7420 666f 726d 6174 2074 6861 font format tha │ │ │ │ -000104f0: 7420 6973 0a73 696d 706c 6520 746f 2075 t is.simple to u │ │ │ │ -00010500: 7365 2c20 636f 6d70 6163 742c 2061 6e64 se, compact, and │ │ │ │ -00010510: 2063 6c65 616e 6c79 2073 7570 706f 7274 cleanly support │ │ │ │ -00010520: 7320 556e 6963 6f64 652e 0a0a 3131 2e31 s Unicode...11.1 │ │ │ │ -00010530: 2e31 2047 6f61 6c73 206f 6620 7468 6520 .1 Goals of the │ │ │ │ -00010540: 4752 5542 2046 6f6e 7420 466f 726d 6174 GRUB Font Format │ │ │ │ -00010550: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d .--------------- │ │ │ │ +000101f0: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 2020 202a ----------.. * │ │ │ │ +00010200: 2050 726f 746f 7479 7065 3a0a 2020 2020 Prototype:. │ │ │ │ +00010210: 2020 2020 2020 766f 6964 202a 6772 7562 void *grub │ │ │ │ +00010220: 5f76 6964 656f 5f62 6974 6d61 705f 6765 _video_bitmap_ge │ │ │ │ +00010230: 745f 6461 7461 2028 7374 7275 6374 2067 t_data (struct g │ │ │ │ +00010240: 7275 625f 7669 6465 6f5f 6269 746d 6170 rub_video_bitmap │ │ │ │ +00010250: 202a 6269 746d 6170 293b 0a0a 2020 202a *bitmap);.. * │ │ │ │ +00010260: 2044 6573 6372 6970 7469 6f6e 3a0a 0a20 Description:.. │ │ │ │ +00010270: 2020 2020 5265 7475 726e 2070 6f69 6e74 Return point │ │ │ │ +00010280: 6572 2074 6f20 6269 746d 6170 2064 6174 er to bitmap dat │ │ │ │ +00010290: 612e 2020 436f 6e74 656e 7473 206f 6620 a. Contents of │ │ │ │ +000102a0: 7468 6520 706f 696e 7465 6420 6461 7461 the pointed data │ │ │ │ +000102b0: 2063 616e 2062 650a 2020 2020 2066 7265 can be. fre │ │ │ │ +000102c0: 656c 7920 6d6f 6469 6669 6564 2e20 2054 ely modified. T │ │ │ │ +000102d0: 6865 7265 2069 7320 6e6f 2065 7874 7261 here is no extra │ │ │ │ +000102e0: 2070 726f 7465 6374 696f 6e20 6167 6169 protection agai │ │ │ │ +000102f0: 6e73 7420 676f 696e 6720 6f66 660a 2020 nst going off. │ │ │ │ +00010300: 2020 2074 6865 2062 6f75 6e64 7320 736f the bounds so │ │ │ │ +00010310: 2079 6f75 2068 6176 6520 746f 2062 6520 you have to be │ │ │ │ +00010320: 6361 7265 6675 6c6c 2068 6f77 2074 6f20 carefull how to │ │ │ │ +00010330: 6163 6365 7373 2074 6865 2064 6174 612e access the data. │ │ │ │ +00010340: 0a0a 1f0a 4669 6c65 3a20 6772 7562 2d64 ....File: grub-d │ │ │ │ +00010350: 6576 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ev.info, Node: │ │ │ │ +00010360: 5046 4632 2046 6f6e 7420 4669 6c65 2046 PFF2 Font File F │ │ │ │ +00010370: 6f72 6d61 742c 2020 4e65 7874 3a20 4772 ormat, Next: Gr │ │ │ │ +00010380: 6170 6869 6361 6c20 4d65 6e75 2053 6f66 aphical Menu Sof │ │ │ │ +00010390: 7477 6172 6520 4465 7369 676e 2c20 2050 tware Design, P │ │ │ │ +000103a0: 7265 763a 2056 6964 656f 2053 7562 7379 rev: Video Subsy │ │ │ │ +000103b0: 7374 656d 2c20 2055 703a 2054 6f70 0a0a stem, Up: Top.. │ │ │ │ +000103c0: 3131 2050 4646 3220 466f 6e74 2046 696c 11 PFF2 Font Fil │ │ │ │ +000103d0: 6520 466f 726d 6174 0a2a 2a2a 2a2a 2a2a e Format.******* │ │ │ │ +000103e0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ +000103f0: 2a0a 0a2a 204d 656e 753a 0a0a 2a20 496e *..* Menu:..* In │ │ │ │ +00010400: 7472 6f64 7563 7469 6f6e 3a3a 0a2a 2046 troduction::.* F │ │ │ │ +00010410: 696c 6520 5374 7275 6374 7572 653a 3a0a ile Structure::. │ │ │ │ +00010420: 2a20 466f 6e74 204d 6574 7269 6373 3a3a * Font Metrics:: │ │ │ │ +00010430: 0a0a 1f0a 4669 6c65 3a20 6772 7562 2d64 ....File: grub-d │ │ │ │ +00010440: 6576 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ev.info, Node: │ │ │ │ +00010450: 496e 7472 6f64 7563 7469 6f6e 2c20 204e Introduction, N │ │ │ │ +00010460: 6578 743a 2046 696c 6520 5374 7275 6374 ext: File Struct │ │ │ │ +00010470: 7572 652c 2020 5570 3a20 5046 4632 2046 ure, Up: PFF2 F │ │ │ │ +00010480: 6f6e 7420 4669 6c65 2046 6f72 6d61 740a ont File Format. │ │ │ │ +00010490: 0a31 312e 3120 496e 7472 6f64 7563 7469 .11.1 Introducti │ │ │ │ +000104a0: 6f6e 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d on.============= │ │ │ │ +000104b0: 3d3d 3d3d 0a0a 5468 6520 676f 616c 206f ====..The goal o │ │ │ │ +000104c0: 6620 7468 6973 2066 6f72 6d61 7420 6973 f this format is │ │ │ │ +000104d0: 2074 6f20 7072 6f76 6964 6520 6120 6269 to provide a bi │ │ │ │ +000104e0: 746d 6170 2066 6f6e 7420 666f 726d 6174 tmap font format │ │ │ │ +000104f0: 2074 6861 7420 6973 0a73 696d 706c 6520 that is.simple │ │ │ │ +00010500: 746f 2075 7365 2c20 636f 6d70 6163 742c to use, compact, │ │ │ │ +00010510: 2061 6e64 2063 6c65 616e 6c79 2073 7570 and cleanly sup │ │ │ │ +00010520: 706f 7274 7320 556e 6963 6f64 652e 0a0a ports Unicode... │ │ │ │ +00010530: 3131 2e31 2e31 2047 6f61 6c73 206f 6620 11.1.1 Goals of │ │ │ │ +00010540: 7468 6520 4752 5542 2046 6f6e 7420 466f the GRUB Font Fo │ │ │ │ +00010550: 726d 6174 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d rmat.----------- │ │ │ │ 00010560: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ -00010570: 2d2d 2d2d 2d0a 0a20 2020 2a20 5369 6d70 -----.. * Simp │ │ │ │ -00010580: 6c65 2074 6f20 7265 6164 2061 6e64 2075 le to read and u │ │ │ │ -00010590: 7365 2e20 2053 696e 6365 2047 5255 4220 se. Since GRUB │ │ │ │ -000105a0: 7769 6c6c 206f 6e6c 7920 6265 2072 6561 will only be rea │ │ │ │ -000105b0: 6469 6e67 2074 6865 2066 6f6e 740a 2020 ding the font. │ │ │ │ -000105c0: 2020 2066 696c 6573 2c20 7765 2061 7265 files, we are │ │ │ │ -000105d0: 206d 6f72 6520 636f 6e63 6572 6e65 6420 more concerned │ │ │ │ -000105e0: 7769 7468 206d 616b 696e 6720 7468 6520 with making the │ │ │ │ -000105f0: 636f 6465 2074 6f20 7265 6164 2074 6865 code to read the │ │ │ │ -00010600: 2066 6f6e 740a 2020 2020 2073 696d 706c font. simpl │ │ │ │ -00010610: 6520 7468 616e 2077 6520 6172 6520 7769 e than we are wi │ │ │ │ -00010620: 7468 2077 7269 7469 6e67 2074 6865 2066 th writing the f │ │ │ │ -00010630: 6f6e 742e 0a0a 2020 202a 2043 6f6d 7061 ont... * Compa │ │ │ │ -00010640: 6374 2073 746f 7261 6765 2e20 2054 6865 ct storage. The │ │ │ │ -00010650: 2066 6f6e 7473 2077 696c 6c20 6765 6e65 fonts will gene │ │ │ │ -00010660: 7261 6c6c 7920 6265 2073 746f 7265 6420 rally be stored │ │ │ │ -00010670: 696e 2061 2073 6d61 6c6c 0a20 2020 2020 in a small. │ │ │ │ -00010680: 626f 6f74 2070 6172 7469 7469 6f6e 2077 boot partition w │ │ │ │ -00010690: 6865 7265 2047 5255 4220 6973 206c 6f63 here GRUB is loc │ │ │ │ -000106a0: 6174 6564 2c20 616e 6420 7468 6973 206d ated, and this m │ │ │ │ -000106b0: 6179 2062 6520 6f6e 2061 0a20 2020 2020 ay be on a. │ │ │ │ -000106c0: 7265 6d6f 7661 626c 6520 7374 6f72 6167 removable storag │ │ │ │ -000106d0: 6520 6465 7669 6365 2073 7563 6820 6173 e device such as │ │ │ │ -000106e0: 2061 2043 4420 6f72 2055 5342 2066 6c61 a CD or USB fla │ │ │ │ -000106f0: 7368 2064 7269 7665 2077 6865 7265 0a20 sh drive where. │ │ │ │ -00010700: 2020 2020 7370 6163 6520 6973 206d 6f72 space is mor │ │ │ │ -00010710: 6520 6c69 6d69 7465 6420 7468 616e 2069 e limited than i │ │ │ │ -00010720: 7420 6973 206f 6e20 6d6f 7374 2068 6172 t is on most har │ │ │ │ -00010730: 6420 6472 6976 6573 2e0a 0a20 2020 2a20 d drives... * │ │ │ │ -00010740: 556e 6963 6f64 652e 2020 4752 5542 2073 Unicode. GRUB s │ │ │ │ -00010750: 686f 756c 6420 6e6f 7420 6861 7665 2074 hould not have t │ │ │ │ -00010760: 6f20 6465 616c 2077 6974 6820 6d75 6c74 o deal with mult │ │ │ │ -00010770: 6970 6c65 2063 6861 7261 6374 6572 0a20 iple character. │ │ │ │ -00010780: 2020 2020 656e 636f 6469 6e67 732e 2020 encodings. │ │ │ │ -00010790: 5468 6520 666f 6e74 2073 686f 756c 6420 The font should │ │ │ │ -000107a0: 616c 7761 7973 2075 7365 2055 6e69 636f always use Unico │ │ │ │ -000107b0: 6465 2063 6861 7261 6374 6572 2063 6f64 de character cod │ │ │ │ -000107c0: 6573 2066 6f72 0a20 2020 2020 7369 6d70 es for. simp │ │ │ │ -000107d0: 6c65 2069 6e74 6572 6e61 7469 6f6e 616c le international │ │ │ │ -000107e0: 697a 6174 696f 6e2e 0a0a 3131 2e31 2e32 ization...11.1.2 │ │ │ │ -000107f0: 2057 6879 2041 6e6f 7468 6572 2046 6f6e Why Another Fon │ │ │ │ -00010800: 7420 466f 726d 6174 3f0a 2d2d 2d2d 2d2d t Format?.------ │ │ │ │ +00010570: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2020 2a20 ---------.. * │ │ │ │ +00010580: 5369 6d70 6c65 2074 6f20 7265 6164 2061 Simple to read a │ │ │ │ +00010590: 6e64 2075 7365 2e20 2053 696e 6365 2047 nd use. Since G │ │ │ │ +000105a0: 5255 4220 7769 6c6c 206f 6e6c 7920 6265 RUB will only be │ │ │ │ +000105b0: 2072 6561 6469 6e67 2074 6865 2066 6f6e reading the fon │ │ │ │ +000105c0: 740a 2020 2020 2066 696c 6573 2c20 7765 t. files, we │ │ │ │ +000105d0: 2061 7265 206d 6f72 6520 636f 6e63 6572 are more concer │ │ │ │ +000105e0: 6e65 6420 7769 7468 206d 616b 696e 6720 ned with making │ │ │ │ +000105f0: 7468 6520 636f 6465 2074 6f20 7265 6164 the code to read │ │ │ │ +00010600: 2074 6865 2066 6f6e 740a 2020 2020 2073 the font. s │ │ │ │ +00010610: 696d 706c 6520 7468 616e 2077 6520 6172 imple than we ar │ │ │ │ +00010620: 6520 7769 7468 2077 7269 7469 6e67 2074 e with writing t │ │ │ │ +00010630: 6865 2066 6f6e 742e 0a0a 2020 202a 2043 he font... * C │ │ │ │ +00010640: 6f6d 7061 6374 2073 746f 7261 6765 2e20 ompact storage. │ │ │ │ +00010650: 2054 6865 2066 6f6e 7473 2077 696c 6c20 The fonts will │ │ │ │ +00010660: 6765 6e65 7261 6c6c 7920 6265 2073 746f generally be sto │ │ │ │ +00010670: 7265 6420 696e 2061 2073 6d61 6c6c 0a20 red in a small. │ │ │ │ +00010680: 2020 2020 626f 6f74 2070 6172 7469 7469 boot partiti │ │ │ │ +00010690: 6f6e 2077 6865 7265 2047 5255 4220 6973 on where GRUB is │ │ │ │ +000106a0: 206c 6f63 6174 6564 2c20 616e 6420 7468 located, and th │ │ │ │ +000106b0: 6973 206d 6179 2062 6520 6f6e 2061 0a20 is may be on a. │ │ │ │ +000106c0: 2020 2020 7265 6d6f 7661 626c 6520 7374 removable st │ │ │ │ +000106d0: 6f72 6167 6520 6465 7669 6365 2073 7563 orage device suc │ │ │ │ +000106e0: 6820 6173 2061 2043 4420 6f72 2055 5342 h as a CD or USB │ │ │ │ +000106f0: 2066 6c61 7368 2064 7269 7665 2077 6865 flash drive whe │ │ │ │ +00010700: 7265 0a20 2020 2020 7370 6163 6520 6973 re. space is │ │ │ │ +00010710: 206d 6f72 6520 6c69 6d69 7465 6420 7468 more limited th │ │ │ │ +00010720: 616e 2069 7420 6973 206f 6e20 6d6f 7374 an it is on most │ │ │ │ +00010730: 2068 6172 6420 6472 6976 6573 2e0a 0a20 hard drives... │ │ │ │ +00010740: 2020 2a20 556e 6963 6f64 652e 2020 4752 * Unicode. GR │ │ │ │ +00010750: 5542 2073 686f 756c 6420 6e6f 7420 6861 UB should not ha │ │ │ │ +00010760: 7665 2074 6f20 6465 616c 2077 6974 6820 ve to deal with │ │ │ │ +00010770: 6d75 6c74 6970 6c65 2063 6861 7261 6374 multiple charact │ │ │ │ +00010780: 6572 0a20 2020 2020 656e 636f 6469 6e67 er. encoding │ │ │ │ +00010790: 732e 2020 5468 6520 666f 6e74 2073 686f s. The font sho │ │ │ │ +000107a0: 756c 6420 616c 7761 7973 2075 7365 2055 uld always use U │ │ │ │ +000107b0: 6e69 636f 6465 2063 6861 7261 6374 6572 nicode character │ │ │ │ +000107c0: 2063 6f64 6573 2066 6f72 0a20 2020 2020 codes for. │ │ │ │ +000107d0: 7369 6d70 6c65 2069 6e74 6572 6e61 7469 simple internati │ │ │ │ +000107e0: 6f6e 616c 697a 6174 696f 6e2e 0a0a 3131 onalization...11 │ │ │ │ +000107f0: 2e31 2e32 2057 6879 2041 6e6f 7468 6572 .1.2 Why Another │ │ │ │ +00010800: 2046 6f6e 7420 466f 726d 6174 3f0a 2d2d Font Format?.-- │ │ │ │ 00010810: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ -00010820: 2d2d 2d2d 2d2d 2d2d 2d0a 0a54 6865 7265 ---------..There │ │ │ │ -00010830: 2061 7265 206d 616e 7920 6578 6973 7469 are many existi │ │ │ │ -00010840: 6e67 2062 6974 6d61 7020 666f 6e74 2066 ng bitmap font f │ │ │ │ -00010850: 6f72 6d61 7473 2074 6861 7420 4752 5542 ormats that GRUB │ │ │ │ -00010860: 2063 6f75 6c64 2075 7365 2e0a 486f 7765 could use..Howe │ │ │ │ -00010870: 7665 722c 2074 6865 7265 2061 7265 2061 ver, there are a │ │ │ │ -00010880: 7370 6563 7473 206f 6620 7468 6573 6520 spects of these │ │ │ │ -00010890: 666f 726d 6174 7320 7468 6174 206d 6179 formats that may │ │ │ │ -000108a0: 206d 616b 6520 7468 656d 206c 6573 7320 make them less │ │ │ │ -000108b0: 7468 616e 0a73 7569 7461 626c 6520 666f than.suitable fo │ │ │ │ -000108c0: 7220 7573 6520 696e 2047 5255 4220 6174 r use in GRUB at │ │ │ │ -000108d0: 2074 6869 7320 7469 6d65 3a0a 0a27 4244 this time:..'BD │ │ │ │ -000108e0: 4627 0a20 2020 2020 496e 6566 6669 6369 F'. Ineffici │ │ │ │ -000108f0: 656e 7420 7374 6f72 6167 653b 2075 7365 ent storage; use │ │ │ │ -00010900: 7320 4153 4349 4920 746f 2064 6573 6372 s ASCII to descr │ │ │ │ -00010910: 6962 6520 7072 6f70 6572 7469 6573 2061 ibe properties a │ │ │ │ -00010920: 6e64 0a20 2020 2020 6865 7861 6465 6369 nd. hexadeci │ │ │ │ -00010930: 6d61 6c20 6e75 6d62 6572 7320 696e 2041 mal numbers in A │ │ │ │ -00010940: 5343 4949 2066 6f72 2074 6865 2062 6974 SCII for the bit │ │ │ │ -00010950: 6d61 7020 726f 7773 2e0a 2750 4346 270a map rows..'PCF'. │ │ │ │ -00010960: 2020 2020 204d 616e 7920 666f 726d 6174 Many format │ │ │ │ -00010970: 2076 6172 6961 7469 6f6e 7320 7375 6368 variations such │ │ │ │ -00010980: 2061 7320 6279 7465 206f 7264 6572 2061 as byte order a │ │ │ │ -00010990: 6e64 2062 6974 6d61 7020 7061 6464 696e nd bitmap paddin │ │ │ │ -000109a0: 6720 2872 6f77 730a 2020 2020 2070 6164 g (rows. pad │ │ │ │ -000109b0: 6465 6420 746f 2062 7974 652c 2077 6f72 ded to byte, wor │ │ │ │ -000109c0: 642c 2065 7463 2e29 2020 776f 756c 6420 d, etc.) would │ │ │ │ -000109d0: 7265 7375 6c74 2069 6e20 6d6f 7265 2063 result in more c │ │ │ │ -000109e0: 6f6d 706c 6578 2063 6f64 6520 746f 0a20 omplex code to. │ │ │ │ -000109f0: 2020 2020 6861 6e64 6c65 2074 6865 2066 handle the f │ │ │ │ -00010a00: 6f6e 7420 666f 726d 6174 2e0a 0a1f 0a46 ont format.....F │ │ │ │ -00010a10: 696c 653a 2067 7275 622d 6465 762e 696e ile: grub-dev.in │ │ │ │ -00010a20: 666f 2c20 204e 6f64 653a 2046 696c 6520 fo, Node: File │ │ │ │ -00010a30: 5374 7275 6374 7572 652c 2020 4e65 7874 Structure, Next │ │ │ │ -00010a40: 3a20 466f 6e74 204d 6574 7269 6373 2c20 : Font Metrics, │ │ │ │ -00010a50: 2050 7265 763a 2049 6e74 726f 6475 6374 Prev: Introduct │ │ │ │ -00010a60: 696f 6e2c 2020 5570 3a20 5046 4632 2046 ion, Up: PFF2 F │ │ │ │ -00010a70: 6f6e 7420 4669 6c65 2046 6f72 6d61 740a ont File Format. │ │ │ │ -00010a80: 0a31 312e 3220 4669 6c65 2053 7472 7563 .11.2 File Struc │ │ │ │ -00010a90: 7475 7265 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d ture.=========== │ │ │ │ -00010aa0: 3d3d 3d3d 3d3d 3d3d 0a0a 4120 6669 6c65 ========..A file │ │ │ │ -00010ab0: 202a 7365 6374 696f 6e2a 2063 6f6e 7369 *section* consi │ │ │ │ -00010ac0: 7374 7320 6f66 2061 2034 2d62 7974 6520 sts of a 4-byte │ │ │ │ -00010ad0: 6e61 6d65 2c20 6120 3332 2d62 6974 2062 name, a 32-bit b │ │ │ │ -00010ae0: 6967 2d65 6e64 6961 6e20 6c65 6e67 7468 ig-endian length │ │ │ │ -00010af0: 0a28 6e6f 7420 696e 636c 7564 696e 6720 .(not including │ │ │ │ -00010b00: 7468 6520 6e61 6d65 206f 7220 6c65 6e67 the name or leng │ │ │ │ -00010b10: 7468 292c 2061 6e64 2074 6865 6e20 4c45 th), and then LE │ │ │ │ -00010b20: 4e47 5448 206d 6f72 650a 7365 6374 696f NGTH more.sectio │ │ │ │ -00010b30: 6e2d 7479 7065 2d73 7065 6369 6669 6320 n-type-specific │ │ │ │ -00010b40: 6279 7465 732e 0a0a 2020 2054 6865 2073 bytes... The s │ │ │ │ -00010b50: 7461 6e64 6172 6420 6669 6c65 2065 7874 tandard file ext │ │ │ │ -00010b60: 656e 7369 6f6e 2066 6f72 2050 4646 3220 ension for PFF2 │ │ │ │ -00010b70: 666f 6e74 2066 696c 6573 2069 7320 272e font files is '. │ │ │ │ -00010b80: 7066 3227 2e0a 0a31 312e 322e 3120 5365 pf2'...11.2.1 Se │ │ │ │ -00010b90: 6374 696f 6e20 5479 7065 730a 2d2d 2d2d ction Types.---- │ │ │ │ +00010820: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a54 -------------..T │ │ │ │ +00010830: 6865 7265 2061 7265 206d 616e 7920 6578 here are many ex │ │ │ │ +00010840: 6973 7469 6e67 2062 6974 6d61 7020 666f isting bitmap fo │ │ │ │ +00010850: 6e74 2066 6f72 6d61 7473 2074 6861 7420 nt formats that │ │ │ │ +00010860: 4752 5542 2063 6f75 6c64 2075 7365 2e0a GRUB could use.. │ │ │ │ +00010870: 486f 7765 7665 722c 2074 6865 7265 2061 However, there a │ │ │ │ +00010880: 7265 2061 7370 6563 7473 206f 6620 7468 re aspects of th │ │ │ │ +00010890: 6573 6520 666f 726d 6174 7320 7468 6174 ese formats that │ │ │ │ +000108a0: 206d 6179 206d 616b 6520 7468 656d 206c may make them l │ │ │ │ +000108b0: 6573 7320 7468 616e 0a73 7569 7461 626c ess than.suitabl │ │ │ │ +000108c0: 6520 666f 7220 7573 6520 696e 2047 5255 e for use in GRU │ │ │ │ +000108d0: 4220 6174 2074 6869 7320 7469 6d65 3a0a B at this time:. │ │ │ │ +000108e0: 0a27 4244 4627 0a20 2020 2020 496e 6566 .'BDF'. Inef │ │ │ │ +000108f0: 6669 6369 656e 7420 7374 6f72 6167 653b ficient storage; │ │ │ │ +00010900: 2075 7365 7320 4153 4349 4920 746f 2064 uses ASCII to d │ │ │ │ +00010910: 6573 6372 6962 6520 7072 6f70 6572 7469 escribe properti │ │ │ │ +00010920: 6573 2061 6e64 0a20 2020 2020 6865 7861 es and. hexa │ │ │ │ +00010930: 6465 6369 6d61 6c20 6e75 6d62 6572 7320 decimal numbers │ │ │ │ +00010940: 696e 2041 5343 4949 2066 6f72 2074 6865 in ASCII for the │ │ │ │ +00010950: 2062 6974 6d61 7020 726f 7773 2e0a 2750 bitmap rows..'P │ │ │ │ +00010960: 4346 270a 2020 2020 204d 616e 7920 666f CF'. Many fo │ │ │ │ +00010970: 726d 6174 2076 6172 6961 7469 6f6e 7320 rmat variations │ │ │ │ +00010980: 7375 6368 2061 7320 6279 7465 206f 7264 such as byte ord │ │ │ │ +00010990: 6572 2061 6e64 2062 6974 6d61 7020 7061 er and bitmap pa │ │ │ │ +000109a0: 6464 696e 6720 2872 6f77 730a 2020 2020 dding (rows. │ │ │ │ +000109b0: 2070 6164 6465 6420 746f 2062 7974 652c padded to byte, │ │ │ │ +000109c0: 2077 6f72 642c 2065 7463 2e29 2020 776f word, etc.) wo │ │ │ │ +000109d0: 756c 6420 7265 7375 6c74 2069 6e20 6d6f uld result in mo │ │ │ │ +000109e0: 7265 2063 6f6d 706c 6578 2063 6f64 6520 re complex code │ │ │ │ +000109f0: 746f 0a20 2020 2020 6861 6e64 6c65 2074 to. handle t │ │ │ │ +00010a00: 6865 2066 6f6e 7420 666f 726d 6174 2e0a he font format.. │ │ │ │ +00010a10: 0a1f 0a46 696c 653a 2067 7275 622d 6465 ...File: grub-de │ │ │ │ +00010a20: 762e 696e 666f 2c20 204e 6f64 653a 2046 v.info, Node: F │ │ │ │ +00010a30: 696c 6520 5374 7275 6374 7572 652c 2020 ile Structure, │ │ │ │ +00010a40: 4e65 7874 3a20 466f 6e74 204d 6574 7269 Next: Font Metri │ │ │ │ +00010a50: 6373 2c20 2050 7265 763a 2049 6e74 726f cs, Prev: Intro │ │ │ │ +00010a60: 6475 6374 696f 6e2c 2020 5570 3a20 5046 duction, Up: PF │ │ │ │ +00010a70: 4632 2046 6f6e 7420 4669 6c65 2046 6f72 F2 Font File For │ │ │ │ +00010a80: 6d61 740a 0a31 312e 3220 4669 6c65 2053 mat..11.2 File S │ │ │ │ +00010a90: 7472 7563 7475 7265 0a3d 3d3d 3d3d 3d3d tructure.======= │ │ │ │ +00010aa0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a 4120 ============..A │ │ │ │ +00010ab0: 6669 6c65 202a 7365 6374 696f 6e2a 2063 file *section* c │ │ │ │ +00010ac0: 6f6e 7369 7374 7320 6f66 2061 2034 2d62 onsists of a 4-b │ │ │ │ +00010ad0: 7974 6520 6e61 6d65 2c20 6120 3332 2d62 yte name, a 32-b │ │ │ │ +00010ae0: 6974 2062 6967 2d65 6e64 6961 6e20 6c65 it big-endian le │ │ │ │ +00010af0: 6e67 7468 0a28 6e6f 7420 696e 636c 7564 ngth.(not includ │ │ │ │ +00010b00: 696e 6720 7468 6520 6e61 6d65 206f 7220 ing the name or │ │ │ │ +00010b10: 6c65 6e67 7468 292c 2061 6e64 2074 6865 length), and the │ │ │ │ +00010b20: 6e20 4c45 4e47 5448 206d 6f72 650a 7365 n LENGTH more.se │ │ │ │ +00010b30: 6374 696f 6e2d 7479 7065 2d73 7065 6369 ction-type-speci │ │ │ │ +00010b40: 6669 6320 6279 7465 732e 0a0a 2020 2054 fic bytes... T │ │ │ │ +00010b50: 6865 2073 7461 6e64 6172 6420 6669 6c65 he standard file │ │ │ │ +00010b60: 2065 7874 656e 7369 6f6e 2066 6f72 2050 extension for P │ │ │ │ +00010b70: 4646 3220 666f 6e74 2066 696c 6573 2069 FF2 font files i │ │ │ │ +00010b80: 7320 272e 7066 3227 2e0a 0a31 312e 322e s '.pf2'...11.2. │ │ │ │ +00010b90: 3120 5365 6374 696f 6e20 5479 7065 730a 1 Section Types. │ │ │ │ 00010ba0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ -00010bb0: 0a0a 2746 494c 4527 0a20 2020 2020 2a46 ..'FILE'. *F │ │ │ │ -00010bc0: 696c 6520 7479 7065 2049 442a 2028 4153 ile type ID* (AS │ │ │ │ -00010bd0: 4349 4920 7374 7269 6e67 292e 2020 5468 CII string). Th │ │ │ │ -00010be0: 6973 206d 7573 7420 6265 2074 6865 2066 is must be the f │ │ │ │ -00010bf0: 6972 7374 2073 6563 7469 6f6e 2069 6e0a irst section in. │ │ │ │ -00010c00: 2020 2020 2074 6865 2066 696c 652e 2020 the file. │ │ │ │ -00010c10: 4974 2068 6173 206c 656e 6774 6820 3420 It has length 4 │ │ │ │ -00010c20: 616e 6420 7468 6520 636f 6e74 656e 7473 and the contents │ │ │ │ -00010c30: 2061 7265 2074 6865 2066 6f75 7220 6279 are the four by │ │ │ │ -00010c40: 7465 7320 6f66 0a20 2020 2020 7468 6520 tes of. the │ │ │ │ -00010c50: 4153 4349 4920 7374 7269 6e67 2027 5046 ASCII string 'PF │ │ │ │ -00010c60: 4632 272e 0a0a 274e 414d 4527 0a20 2020 F2'...'NAME'. │ │ │ │ -00010c70: 2020 2a46 6f6e 7420 6e61 6d65 2a20 2841 *Font name* (A │ │ │ │ -00010c80: 5343 4949 2073 7472 696e 6729 2e20 2054 SCII string). T │ │ │ │ -00010c90: 6869 7320 6973 2074 6865 2066 756c 6c20 his is the full │ │ │ │ -00010ca0: 666f 6e74 206e 616d 6520 696e 636c 7564 font name includ │ │ │ │ -00010cb0: 696e 670a 2020 2020 2066 616d 696c 792c ing. family, │ │ │ │ -00010cc0: 2077 6569 6768 742c 2073 7479 6c65 2c20 weight, style, │ │ │ │ -00010cd0: 616e 6420 706f 696e 7420 7369 7a65 2e20 and point size. │ │ │ │ -00010ce0: 2046 6f72 2069 6e73 7461 6e63 652c 2022 For instance, " │ │ │ │ -00010cf0: 4865 6c76 6574 6963 610a 2020 2020 2042 Helvetica. B │ │ │ │ -00010d00: 6f6c 6420 4974 616c 6963 2031 3422 2e0a old Italic 14".. │ │ │ │ -00010d10: 0a27 4641 4d49 270a 2020 2020 202a 466f .'FAMI'. *Fo │ │ │ │ -00010d20: 6e74 2066 616d 696c 7920 6e61 6d65 2a20 nt family name* │ │ │ │ -00010d30: 2841 5343 4949 2073 7472 696e 6729 2e20 (ASCII string). │ │ │ │ -00010d40: 2046 6f72 2069 6e73 7461 6e63 652c 2022 For instance, " │ │ │ │ -00010d50: 4865 6c76 6574 6963 6122 2e0a 2020 2020 Helvetica".. │ │ │ │ -00010d60: 2054 6869 7320 7368 6f75 6c64 2062 6520 This should be │ │ │ │ -00010d70: 696e 636c 7564 6564 2073 6f20 7468 6174 included so that │ │ │ │ -00010d80: 2069 6e74 656c 6c69 6765 6e74 2066 6f6e intelligent fon │ │ │ │ -00010d90: 7420 7375 6273 7469 7475 7469 6f6e 2063 t substitution c │ │ │ │ -00010da0: 616e 0a20 2020 2020 7461 6b65 2070 6c61 an. take pla │ │ │ │ -00010db0: 6365 2e0a 0a27 5745 4947 270a 2020 2020 ce...'WEIG'. │ │ │ │ -00010dc0: 202a 466f 6e74 2077 6569 6768 742a 2028 *Font weight* ( │ │ │ │ -00010dd0: 4153 4349 4920 7374 7269 6e67 292e 2020 ASCII string). │ │ │ │ -00010de0: 5661 6c69 6420 7661 6c75 6573 2061 7265 Valid values are │ │ │ │ -00010df0: 2027 626f 6c64 2720 616e 640a 2020 2020 'bold' and. │ │ │ │ -00010e00: 2027 6e6f 726d 616c 272e 2020 5468 6973 'normal'. This │ │ │ │ -00010e10: 2073 686f 756c 6420 6265 2069 6e63 6c75 should be inclu │ │ │ │ -00010e20: 6465 6420 736f 2074 6861 7420 696e 7465 ded so that inte │ │ │ │ -00010e30: 6c6c 6967 656e 7420 666f 6e74 0a20 2020 lligent font. │ │ │ │ -00010e40: 2020 7375 6273 7469 7475 7469 6f6e 2063 substitution c │ │ │ │ -00010e50: 616e 2074 616b 6520 706c 6163 652e 0a0a an take place... │ │ │ │ -00010e60: 2753 4c41 4e27 0a20 2020 2020 2a46 6f6e 'SLAN'. *Fon │ │ │ │ -00010e70: 7420 736c 616e 742a 2028 4153 4349 4920 t slant* (ASCII │ │ │ │ -00010e80: 7374 7269 6e67 292e 2020 5661 6c69 6420 string). Valid │ │ │ │ -00010e90: 7661 6c75 6573 2061 7265 2027 6974 616c values are 'ital │ │ │ │ -00010ea0: 6963 2720 616e 640a 2020 2020 2027 6e6f ic' and. 'no │ │ │ │ -00010eb0: 726d 616c 272e 2020 5468 6973 2073 686f rmal'. This sho │ │ │ │ -00010ec0: 756c 6420 6265 2069 6e63 6c75 6465 6420 uld be included │ │ │ │ -00010ed0: 736f 2074 6861 7420 696e 7465 6c6c 6967 so that intellig │ │ │ │ -00010ee0: 656e 7420 666f 6e74 0a20 2020 2020 7375 ent font. su │ │ │ │ -00010ef0: 6273 7469 7475 7469 6f6e 2063 616e 2074 bstitution can t │ │ │ │ -00010f00: 616b 6520 706c 6163 652e 0a0a 2750 5453 ake place...'PTS │ │ │ │ -00010f10: 5a27 0a20 2020 2020 2a46 6f6e 7420 706f Z'. *Font po │ │ │ │ -00010f20: 696e 7420 7369 7a65 2a20 2875 696e 7431 int size* (uint1 │ │ │ │ -00010f30: 3662 6529 2e0a 0a27 4d41 5857 270a 2020 6be)...'MAXW'. │ │ │ │ -00010f40: 2020 202a 4d61 7869 6d75 6d20 6368 6172 *Maximum char │ │ │ │ -00010f50: 6163 7465 7220 7769 6474 6820 696e 2070 acter width in p │ │ │ │ -00010f60: 6978 656c 732a 2028 7569 6e74 3136 6265 ixels* (uint16be │ │ │ │ -00010f70: 292e 0a0a 274d 4158 4827 0a20 2020 2020 )...'MAXH'. │ │ │ │ -00010f80: 2a4d 6178 696d 756d 2063 6861 7261 6374 *Maximum charact │ │ │ │ -00010f90: 6572 2068 6569 6768 7420 696e 2070 6978 er height in pix │ │ │ │ -00010fa0: 656c 732a 2028 7569 6e74 3136 6265 292e els* (uint16be). │ │ │ │ -00010fb0: 0a0a 2741 5343 4527 0a20 2020 2020 2a41 ..'ASCE'. *A │ │ │ │ -00010fc0: 7363 656e 7420 696e 2070 6978 656c 732a scent in pixels* │ │ │ │ -00010fd0: 2028 7569 6e74 3136 6265 292e 2020 2a4e (uint16be). *N │ │ │ │ -00010fe0: 6f74 6520 466f 6e74 204d 6574 7269 6373 ote Font Metrics │ │ │ │ -00010ff0: 3a3a 2c20 666f 7220 6465 7461 696c 732e ::, for details. │ │ │ │ -00011000: 0a0a 2744 4553 4327 0a20 2020 2020 2a44 ..'DESC'. *D │ │ │ │ -00011010: 6573 6365 6e74 2069 6e20 7069 7865 6c73 escent in pixels │ │ │ │ -00011020: 2a20 2875 696e 7431 3662 6529 2e20 202a * (uint16be). * │ │ │ │ -00011030: 4e6f 7465 2046 6f6e 7420 4d65 7472 6963 Note Font Metric │ │ │ │ -00011040: 733a 3a2c 2066 6f72 2064 6574 6169 6c73 s::, for details │ │ │ │ -00011050: 2e0a 0a27 4348 4958 270a 2020 2020 202a ...'CHIX'. * │ │ │ │ -00011060: 4368 6172 6163 7465 7220 696e 6465 782e Character index. │ │ │ │ -00011070: 2a20 2054 6865 2063 6861 7261 6374 6572 * The character │ │ │ │ -00011080: 2069 6e64 6578 2062 6567 696e 7320 7769 index begins wi │ │ │ │ -00011090: 7468 2061 2033 322d 6269 740a 2020 2020 th a 32-bit. │ │ │ │ -000110a0: 2062 6967 2d65 6e64 6961 6e20 756e 7369 big-endian unsi │ │ │ │ -000110b0: 676e 6564 2069 6e74 6567 6572 2069 6e64 gned integer ind │ │ │ │ -000110c0: 6963 6174 696e 6720 7468 6520 746f 7461 icating the tota │ │ │ │ -000110d0: 6c20 7369 7a65 206f 6620 7468 650a 2020 l size of the. │ │ │ │ -000110e0: 2020 2073 6563 7469 6f6e 2c20 6e6f 7420 section, not │ │ │ │ -000110f0: 696e 636c 7564 696e 6720 7468 6973 2073 including this s │ │ │ │ -00011100: 697a 6520 7661 6c75 652e 2020 466f 7220 ize value. For │ │ │ │ -00011110: 6561 6368 2063 6861 7261 6374 6572 2c20 each character, │ │ │ │ -00011120: 7468 6572 650a 2020 2020 2069 7320 616e there. is an │ │ │ │ -00011130: 2069 6e73 7461 6e63 6520 6f66 2074 6865 instance of the │ │ │ │ -00011140: 2066 6f6c 6c6f 7769 6e67 2065 6e74 7279 following entry │ │ │ │ -00011150: 2073 7472 7563 7475 7265 3a0a 0a20 2020 structure:.. │ │ │ │ -00011160: 2020 2020 202a 202a 556e 6963 6f64 6520 * *Unicode │ │ │ │ -00011170: 636f 6465 2070 6f69 6e74 2e2a 2020 2833 code point.* (3 │ │ │ │ -00011180: 322d 6269 7420 6269 672d 656e 6469 616e 2-bit big-endian │ │ │ │ -00011190: 2069 6e74 6567 6572 2e29 0a0a 2020 2020 integer.).. │ │ │ │ -000111a0: 2020 2020 2a20 2a53 746f 7261 6765 2066 * *Storage f │ │ │ │ -000111b0: 6c61 6773 2e2a 2020 2862 7974 652e 290a lags.* (byte.). │ │ │ │ -000111c0: 0a20 2020 2020 2020 2020 2020 2020 2a20 . * │ │ │ │ -000111d0: 4269 7473 2032 2e2e 303a 0a0a 2020 2020 Bits 2..0:.. │ │ │ │ -000111e0: 2020 2020 2020 2020 2020 2049 6620 6571 If eq │ │ │ │ -000111f0: 7561 6c20 746f 2030 3030 2062 696e 6172 ual to 000 binar │ │ │ │ -00011200: 792c 2074 6865 6e20 7468 6520 6368 6172 y, then the char │ │ │ │ -00011210: 6163 7465 7220 6461 7461 2069 7320 7374 acter data is st │ │ │ │ -00011220: 6f72 6564 0a20 2020 2020 2020 2020 2020 ored. │ │ │ │ -00011230: 2020 2020 756e 636f 6d70 7265 7373 6564 uncompressed │ │ │ │ -00011240: 2062 6567 696e 6e69 6e67 2061 7420 7468 beginning at th │ │ │ │ -00011250: 6520 6f66 6673 6574 2069 6e64 6963 6174 e offset indicat │ │ │ │ -00011260: 6564 2062 7920 7468 650a 2020 2020 2020 ed by the. │ │ │ │ -00011270: 2020 2020 2020 2020 2063 6861 7261 6374 charact │ │ │ │ -00011280: 6572 2773 202a 6f66 6673 6574 2a20 7661 er's *offset* va │ │ │ │ -00011290: 6c75 652e 0a0a 2020 2020 2020 2020 2020 lue... │ │ │ │ -000112a0: 2020 2020 2049 6620 6571 7561 6c20 746f If equal to │ │ │ │ -000112b0: 2030 3031 2062 696e 6172 792c 2074 6865 001 binary, the │ │ │ │ -000112c0: 6e20 7468 6520 6368 6172 6163 7465 7220 n the character │ │ │ │ -000112d0: 6461 7461 2069 7320 7374 6f72 6564 0a20 data is stored. │ │ │ │ -000112e0: 2020 2020 2020 2020 2020 2020 2020 7769 wi │ │ │ │ -000112f0: 7468 696e 2061 2063 6f6d 7072 6573 7365 thin a compresse │ │ │ │ -00011300: 6420 6368 6172 6163 7465 7220 6465 6669 d character defi │ │ │ │ -00011310: 6e69 7469 6f6e 2062 6c6f 636b 2074 6861 nition block tha │ │ │ │ -00011320: 740a 2020 2020 2020 2020 2020 2020 2020 t. │ │ │ │ -00011330: 2062 6567 696e 7320 6174 2074 6865 206f begins at the o │ │ │ │ -00011340: 6666 7365 7420 7769 7468 696e 2074 6865 ffset within the │ │ │ │ -00011350: 2066 696c 6520 696e 6469 6361 7465 6420 file indicated │ │ │ │ -00011360: 6279 2074 6865 0a20 2020 2020 2020 2020 by the. │ │ │ │ -00011370: 2020 2020 2020 6368 6172 6163 7465 7227 character' │ │ │ │ -00011380: 7320 2a6f 6666 7365 742a 2076 616c 7565 s *offset* value │ │ │ │ -00011390: 2e0a 0a20 2020 2020 2020 202a 202a 4f66 ... * *Of │ │ │ │ -000113a0: 6673 6574 2e2a 2020 2833 322d 6269 7420 fset.* (32-bit │ │ │ │ -000113b0: 6269 672d 656e 6469 616e 2069 6e74 6567 big-endian integ │ │ │ │ -000113c0: 6572 2e29 0a0a 2020 2020 2020 2020 2020 er.).. │ │ │ │ -000113d0: 4120 6d61 726b 6572 2074 6861 7420 696e A marker that in │ │ │ │ -000113e0: 6469 6361 7465 7320 7468 6520 7265 6d61 dicates the rema │ │ │ │ -000113f0: 696e 6465 7220 6f66 2074 6865 2066 696c inder of the fil │ │ │ │ -00011400: 6520 6973 2064 6174 610a 2020 2020 2020 e is data. │ │ │ │ -00011410: 2020 2020 6163 6365 7373 6564 2076 6961 accessed via │ │ │ │ -00011420: 2074 6865 2063 6861 7261 6374 6572 2069 the character i │ │ │ │ -00011430: 6e64 6578 2028 4348 4958 2920 7365 6374 ndex (CHIX) sect │ │ │ │ -00011440: 696f 6e2e 2020 5768 656e 2072 6561 6469 ion. When readi │ │ │ │ -00011450: 6e67 0a20 2020 2020 2020 2020 2074 6869 ng. thi │ │ │ │ -00011460: 7320 666f 6e74 2066 696c 652c 2074 6865 s font file, the │ │ │ │ -00011470: 2072 6573 7420 6f66 2074 6865 2066 696c rest of the fil │ │ │ │ -00011480: 6520 6361 6e20 6265 2069 676e 6f72 6564 e can be ignored │ │ │ │ -00011490: 2077 6865 6e0a 2020 2020 2020 2020 2020 when. │ │ │ │ -000114a0: 7363 616e 6e69 6e67 2074 6865 2073 6563 scanning the sec │ │ │ │ -000114b0: 7469 6f6e 732e 2020 5468 6520 6c65 6e67 tions. The leng │ │ │ │ -000114c0: 7468 2073 686f 756c 6420 6265 2073 6574 th should be set │ │ │ │ -000114d0: 2074 6f20 2d31 0a20 2020 2020 2020 2020 to -1. │ │ │ │ -000114e0: 2028 3078 4646 4646 4646 4646 292e 0a0a (0xFFFFFFFF)... │ │ │ │ -000114f0: 2020 2020 2020 2020 2020 5375 7070 6f72 Suppor │ │ │ │ -00011500: 7465 6420 6461 7461 2073 7472 7563 7475 ted data structu │ │ │ │ -00011510: 7265 733a 0a0a 2020 2020 2020 2020 2020 res:.. │ │ │ │ -00011520: 4368 6172 6163 7465 7220 6465 6669 6e69 Character defini │ │ │ │ -00011530: 7469 6f6e 2045 6163 6820 6368 6172 6163 tion Each charac │ │ │ │ -00011540: 7465 7220 6465 6669 6e69 7469 6f6e 2063 ter definition c │ │ │ │ -00011550: 6f6e 7369 7374 7320 6f66 3a0a 0a20 2020 onsists of:.. │ │ │ │ -00011560: 2020 2020 2020 2020 2020 2a20 2a57 6964 * *Wid │ │ │ │ -00011570: 7468 2e2a 2020 5769 6474 6820 6f66 2074 th.* Width of t │ │ │ │ -00011580: 6865 2062 6974 6d61 7020 696e 2070 6978 he bitmap in pix │ │ │ │ -00011590: 656c 732e 2020 5468 6520 6269 746d 6170 els. The bitmap │ │ │ │ -000115a0: 2773 0a20 2020 2020 2020 2020 2020 2020 's. │ │ │ │ -000115b0: 2020 6578 7465 6e74 7320 7265 7072 6573 extents repres │ │ │ │ -000115c0: 656e 7420 7468 6520 676c 7970 6827 7320 ent the glyph's │ │ │ │ -000115d0: 626f 756e 6469 6e67 2062 6f78 2e20 2027 bounding box. ' │ │ │ │ -000115e0: 7569 6e74 3136 6265 272e 0a0a 2020 2020 uint16be'... │ │ │ │ -000115f0: 2020 2020 2020 2020 202a 202a 4865 6967 * *Heig │ │ │ │ -00011600: 6874 2e2a 2020 4865 6967 6874 206f 6620 ht.* Height of │ │ │ │ -00011610: 7468 6520 6269 746d 6170 2069 6e20 7069 the bitmap in pi │ │ │ │ -00011620: 7865 6c73 2e20 2054 6865 2062 6974 6d61 xels. The bitma │ │ │ │ -00011630: 7027 730a 2020 2020 2020 2020 2020 2020 p's. │ │ │ │ -00011640: 2020 2065 7874 656e 7473 2072 6570 7265 extents repre │ │ │ │ -00011650: 7365 6e74 2074 6865 2067 6c79 7068 2773 sent the glyph's │ │ │ │ -00011660: 2062 6f75 6e64 696e 6720 626f 782e 2020 bounding box. │ │ │ │ -00011670: 2775 696e 7431 3662 6527 2e0a 0a20 2020 'uint16be'... │ │ │ │ -00011680: 2020 2020 2020 2020 2020 2a20 2a58 206f * *X o │ │ │ │ -00011690: 6666 7365 742e 2a20 2054 6865 206e 756d ffset.* The num │ │ │ │ -000116a0: 6265 7220 6f66 2070 6978 656c 7320 746f ber of pixels to │ │ │ │ -000116b0: 2073 6869 6674 2074 6865 2062 6974 6d61 shift the bitma │ │ │ │ -000116c0: 7020 6279 0a20 2020 2020 2020 2020 2020 p by. │ │ │ │ -000116d0: 2020 2020 686f 7269 7a6f 6e74 616c 6c79 horizontally │ │ │ │ -000116e0: 2062 6566 6f72 6520 6472 6177 696e 6720 before drawing │ │ │ │ -000116f0: 7468 6520 6368 6172 6163 7465 722e 2020 the character. │ │ │ │ -00011700: 2769 6e74 3136 6265 272e 0a0a 2020 2020 'int16be'... │ │ │ │ -00011710: 2020 2020 2020 2020 202a 202a 5920 6f66 * *Y of │ │ │ │ -00011720: 6673 6574 2e2a 2020 5468 6520 6e75 6d62 fset.* The numb │ │ │ │ -00011730: 6572 206f 6620 7069 7865 6c73 2074 6f20 er of pixels to │ │ │ │ -00011740: 7368 6966 7420 7468 6520 6269 746d 6170 shift the bitmap │ │ │ │ -00011750: 2062 790a 2020 2020 2020 2020 2020 2020 by. │ │ │ │ -00011760: 2020 2076 6572 7469 6361 6c6c 7920 6265 vertically be │ │ │ │ -00011770: 666f 7265 2064 7261 7769 6e67 2074 6865 fore drawing the │ │ │ │ -00011780: 2063 6861 7261 6374 6572 2e20 2027 696e character. 'in │ │ │ │ -00011790: 7431 3662 6527 2e0a 0a20 2020 2020 2020 t16be'... │ │ │ │ -000117a0: 2020 2020 2020 2a20 2a44 6576 6963 6520 * *Device │ │ │ │ -000117b0: 7769 6474 682e 2a20 2054 6865 206e 756d width.* The num │ │ │ │ -000117c0: 6265 7220 6f66 2070 6978 656c 7320 746f ber of pixels to │ │ │ │ -000117d0: 2061 6476 616e 6365 0a20 2020 2020 2020 advance. │ │ │ │ -000117e0: 2020 2020 2020 2020 686f 7269 7a6f 6e74 horizont │ │ │ │ -000117f0: 616c 6c79 2066 726f 6d20 7468 6973 2063 ally from this c │ │ │ │ -00011800: 6861 7261 6374 6572 2773 206f 7269 6769 haracter's origi │ │ │ │ -00011810: 6e20 746f 2074 6865 206f 7269 6769 6e0a n to the origin. │ │ │ │ -00011820: 2020 2020 2020 2020 2020 2020 2020 206f o │ │ │ │ -00011830: 6620 7468 6520 6e65 7874 2063 6861 7261 f the next chara │ │ │ │ -00011840: 6374 6572 2e20 2027 696e 7431 3662 6527 cter. 'int16be' │ │ │ │ -00011850: 2e0a 0a20 2020 2020 2020 2020 2020 2020 ... │ │ │ │ -00011860: 2a20 2a42 6974 6d61 7020 6461 7461 2e2a * *Bitmap data.* │ │ │ │ -00011870: 2020 5468 6973 2069 7320 656e 636f 6465 This is encode │ │ │ │ -00011880: 6420 6173 2061 2073 7472 696e 6720 6f66 d as a string of │ │ │ │ -00011890: 2062 6974 732e 2020 4974 0a20 2020 2020 bits. It. │ │ │ │ -000118a0: 2020 2020 2020 2020 2020 6973 206f 7267 is org │ │ │ │ -000118b0: 616e 697a 6564 2061 7320 6120 726f 772d anized as a row- │ │ │ │ -000118c0: 6d61 6a6f 722c 2074 6f70 2d64 6f77 6e2c major, top-down, │ │ │ │ -000118d0: 206c 6566 742d 746f 2d72 6967 6874 0a20 left-to-right. │ │ │ │ -000118e0: 2020 2020 2020 2020 2020 2020 2020 6269 bi │ │ │ │ -000118f0: 746d 6170 2e20 2054 6865 206d 6f73 7420 tmap. The most │ │ │ │ -00011900: 7369 676e 6966 6963 616e 7420 6269 7420 significant bit │ │ │ │ -00011910: 6f66 2065 6163 6820 6279 7465 2069 7320 of each byte is │ │ │ │ -00011920: 7461 6b65 6e0a 2020 2020 2020 2020 2020 taken. │ │ │ │ -00011930: 2020 2020 2074 6f20 6265 2074 6865 206c to be the l │ │ │ │ -00011940: 6566 746d 6f73 7420 6f72 2075 7070 6572 eftmost or upper │ │ │ │ -00011950: 6d6f 7374 2062 6974 2069 6e20 7468 6520 most bit in the │ │ │ │ -00011960: 6279 7465 2e20 2046 6f72 2074 6865 0a20 byte. For the. │ │ │ │ -00011970: 2020 2020 2020 2020 2020 2020 2020 7361 sa │ │ │ │ -00011980: 6b65 206f 6620 636f 6d70 6163 7420 7374 ke of compact st │ │ │ │ -00011990: 6f72 6167 652c 2072 6f77 7320 6172 6520 orage, rows are │ │ │ │ -000119a0: 6e6f 7420 7061 6464 6564 2074 6f20 6279 not padded to by │ │ │ │ -000119b0: 7465 0a20 2020 2020 2020 2020 2020 2020 te. │ │ │ │ -000119c0: 2020 626f 756e 6461 7269 6573 2028 692e boundaries (i. │ │ │ │ -000119d0: 652e 2c20 6120 7369 6e67 6c65 2062 7974 e., a single byt │ │ │ │ -000119e0: 6520 6d61 7920 636f 6e74 6169 6e20 6269 e may contain bi │ │ │ │ -000119f0: 7473 0a20 2020 2020 2020 2020 2020 2020 ts. │ │ │ │ -00011a00: 2020 6265 6c6f 6e67 696e 6720 746f 206d belonging to m │ │ │ │ -00011a10: 756c 7469 706c 6520 726f 7773 292e 2020 ultiple rows). │ │ │ │ -00011a20: 5468 6520 6c61 7374 2062 7974 6520 6f66 The last byte of │ │ │ │ -00011a30: 2074 6865 2062 6974 6d61 700a 2020 2020 the bitmap. │ │ │ │ -00011a40: 2020 2020 2020 2020 2020 202a 6973 2a20 *is* │ │ │ │ -00011a50: 7061 6464 6564 2077 6974 6820 7a65 726f padded with zero │ │ │ │ -00011a60: 2062 6974 7320 696e 2074 6865 2062 6974 bits in the bit │ │ │ │ -00011a70: 7320 706f 7369 7469 6f6e 7320 746f 2074 s positions to t │ │ │ │ -00011a80: 6865 0a20 2020 2020 2020 2020 2020 2020 he. │ │ │ │ -00011a90: 2020 7269 6768 7420 6f66 2074 6865 206c right of the l │ │ │ │ -00011aa0: 6173 7420 7573 6564 2062 6974 2069 6620 ast used bit if │ │ │ │ -00011ab0: 7468 6520 6269 746d 6170 2064 6174 6120 the bitmap data │ │ │ │ -00011ac0: 646f 6573 206e 6f74 0a20 2020 2020 2020 does not. │ │ │ │ -00011ad0: 2020 2020 2020 2020 6669 6c6c 2074 6865 fill the │ │ │ │ -00011ae0: 206c 6173 7420 6279 7465 2e0a 0a20 2020 last byte... │ │ │ │ -00011af0: 2020 2020 2020 2020 2020 2020 5468 6520 The │ │ │ │ -00011b00: 6c65 6e67 7468 206f 6620 7468 6520 2a62 length of the *b │ │ │ │ -00011b10: 6974 6d61 7020 6461 7461 2a20 6669 656c itmap data* fiel │ │ │ │ -00011b20: 6420 6973 2028 5749 4454 4820 2a20 4845 d is (WIDTH * HE │ │ │ │ -00011b30: 4947 4854 0a20 2020 2020 2020 2020 2020 IGHT. │ │ │ │ -00011b40: 2020 2020 2b20 3729 202f 2038 2075 7369 + 7) / 8 usi │ │ │ │ -00011b50: 6e67 2069 6e74 6567 6572 2061 7269 7468 ng integer arith │ │ │ │ -00011b60: 6d65 7469 632c 2077 6869 6368 2069 7320 metic, which is │ │ │ │ -00011b70: 6571 7569 7661 6c65 6e74 2074 6f0a 2020 equivalent to. │ │ │ │ -00011b80: 2020 2020 2020 2020 2020 2020 2063 6569 cei │ │ │ │ -00011b90: 6c28 5749 4454 4820 2a20 4845 4947 4854 l(WIDTH * HEIGHT │ │ │ │ -00011ba0: 202f 2038 2920 7573 696e 6720 7265 616c / 8) using real │ │ │ │ -00011bb0: 206e 756d 6265 7220 6172 6974 686d 6574 number arithmet │ │ │ │ -00011bc0: 6963 2e0a 0a20 2020 2020 2020 2020 2020 ic... │ │ │ │ -00011bd0: 2020 2020 4974 2072 656d 6169 6e73 2074 It remains t │ │ │ │ -00011be0: 6f20 6265 2064 6574 6572 6d69 6e65 6420 o be determined │ │ │ │ -00011bf0: 7768 6574 6865 7220 6269 746d 6170 2066 whether bitmap f │ │ │ │ -00011c00: 6f6e 7473 2075 7375 616c 6c79 0a20 2020 onts usually. │ │ │ │ -00011c10: 2020 2020 2020 2020 2020 2020 6d61 6b65 make │ │ │ │ -00011c20: 2061 6c6c 2067 6c79 7068 2062 6974 6d61 all glyph bitma │ │ │ │ -00011c30: 7073 2074 6865 2073 616d 6520 6865 6967 ps the same heig │ │ │ │ -00011c40: 6874 2c20 6f72 2069 6620 736d 616c 6c65 ht, or if smalle │ │ │ │ -00011c50: 720a 2020 2020 2020 2020 2020 2020 2020 r. │ │ │ │ -00011c60: 2067 6c79 7068 7320 6172 6520 7374 6f72 glyphs are stor │ │ │ │ -00011c70: 6564 2077 6974 6820 6269 746d 6170 7320 ed with bitmaps │ │ │ │ -00011c80: 6861 7669 6e67 2061 206c 6573 7365 7220 having a lesser │ │ │ │ -00011c90: 6865 6967 6874 2e0a 2020 2020 2020 2020 height.. │ │ │ │ -00011ca0: 2020 2020 2020 2049 6e20 7468 6520 6c61 In the la │ │ │ │ -00011cb0: 7474 6572 2063 6173 652c 2074 6865 2062 tter case, the b │ │ │ │ -00011cc0: 6173 656c 696e 6520 776f 756c 6420 6861 aseline would ha │ │ │ │ -00011cd0: 7665 2074 6f20 6265 2075 7365 6420 746f ve to be used to │ │ │ │ -00011ce0: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ -00011cf0: 6361 6c63 756c 6174 6520 7468 6520 6c6f calculate the lo │ │ │ │ -00011d00: 6361 7469 6f6e 2074 6865 2062 6974 6d61 cation the bitma │ │ │ │ -00011d10: 7020 7368 6f75 6c64 2062 6520 616e 6368 p should be anch │ │ │ │ -00011d20: 6f72 6564 2061 740a 2020 2020 2020 2020 ored at. │ │ │ │ -00011d30: 2020 2020 2020 206f 6e20 7363 7265 656e on screen │ │ │ │ -00011d40: 2e0a 0a1f 0a46 696c 653a 2067 7275 622d .....File: grub- │ │ │ │ -00011d50: 6465 762e 696e 666f 2c20 204e 6f64 653a dev.info, Node: │ │ │ │ -00011d60: 2046 6f6e 7420 4d65 7472 6963 732c 2020 Font Metrics, │ │ │ │ -00011d70: 5072 6576 3a20 4669 6c65 2053 7472 7563 Prev: File Struc │ │ │ │ -00011d80: 7475 7265 2c20 2055 703a 2050 4646 3220 ture, Up: PFF2 │ │ │ │ -00011d90: 466f 6e74 2046 696c 6520 466f 726d 6174 Font File Format │ │ │ │ -00011da0: 0a0a 3131 2e33 2046 6f6e 7420 4d65 7472 ..11.3 Font Metr │ │ │ │ -00011db0: 6963 730a 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ics.============ │ │ │ │ -00011dc0: 3d3d 3d3d 3d0a 0a20 2020 2a20 4173 6365 =====.. * Asce │ │ │ │ -00011dd0: 6e74 2e20 2054 6865 2064 6973 7461 6e63 nt. The distanc │ │ │ │ -00011de0: 6520 6672 6f6d 2074 6865 2062 6173 656c e from the basel │ │ │ │ -00011df0: 696e 6520 746f 2074 6865 2074 6f70 206f ine to the top o │ │ │ │ -00011e00: 6620 6d6f 7374 0a20 2020 2020 6368 6172 f most. char │ │ │ │ -00011e10: 6163 7465 7273 2e20 204e 6f74 6520 7468 acters. Note th │ │ │ │ -00011e20: 6174 2069 6e20 736f 6d65 2063 6173 6573 at in some cases │ │ │ │ -00011e30: 2063 6861 7261 6374 6572 7320 6d61 7920 characters may │ │ │ │ -00011e40: 6578 7465 6e64 2061 626f 7665 0a20 2020 extend above. │ │ │ │ -00011e50: 2020 7468 6520 6173 6365 6e74 2e0a 0a20 the ascent... │ │ │ │ -00011e60: 2020 2a20 4465 7363 656e 742e 2020 5468 * Descent. Th │ │ │ │ -00011e70: 6520 6469 7374 616e 6365 2066 726f 6d20 e distance from │ │ │ │ -00011e80: 7468 6520 6261 7365 6c69 6e65 2074 6f20 the baseline to │ │ │ │ -00011e90: 7468 6520 626f 7474 6f6d 206f 6620 6d6f the bottom of mo │ │ │ │ -00011ea0: 7374 0a20 2020 2020 6368 6172 6163 7465 st. characte │ │ │ │ -00011eb0: 7273 2e20 204e 6f74 6520 7468 6174 2069 rs. Note that i │ │ │ │ -00011ec0: 6e20 736f 6d65 2063 6173 6573 2063 6861 n some cases cha │ │ │ │ -00011ed0: 7261 6374 6572 7320 6d61 7920 6578 7465 racters may exte │ │ │ │ -00011ee0: 6e64 2062 656c 6f77 0a20 2020 2020 7468 nd below. th │ │ │ │ -00011ef0: 6520 6465 7363 656e 742e 0a0a 2020 202a e descent... * │ │ │ │ -00011f00: 204c 6561 6469 6e67 2e20 2054 6865 2061 Leading. The a │ │ │ │ -00011f10: 6d6f 756e 7420 6f66 2073 7061 6365 2c20 mount of space, │ │ │ │ -00011f20: 696e 2070 6978 656c 732c 2074 6f20 6c65 in pixels, to le │ │ │ │ -00011f30: 6176 6520 6265 7477 6565 6e20 7468 650a ave between the. │ │ │ │ -00011f40: 2020 2020 2064 6573 6365 6e74 206f 6620 descent of │ │ │ │ -00011f50: 6f6e 6520 6c69 6e65 206f 6620 7465 7874 one line of text │ │ │ │ -00011f60: 2061 6e64 2074 6865 2061 7363 656e 7420 and the ascent │ │ │ │ -00011f70: 6f66 2074 6865 206e 6578 7420 6c69 6e65 of the next line │ │ │ │ -00011f80: 2e20 2054 6869 730a 2020 2020 206d 6574 . This. met │ │ │ │ -00011f90: 7269 6373 2069 7320 6e6f 7420 7370 6563 rics is not spec │ │ │ │ -00011fa0: 6966 6965 6420 696e 2074 6865 2063 7572 ified in the cur │ │ │ │ -00011fb0: 7265 6e74 2066 696c 6520 666f 726d 6174 rent file format │ │ │ │ -00011fc0: 3b20 696e 7374 6561 642c 2074 6865 0a20 ; instead, the. │ │ │ │ -00011fd0: 2020 2020 666f 6e74 2072 656e 6465 7269 font renderi │ │ │ │ -00011fe0: 6e67 2065 6e67 696e 6520 6361 6c63 756c ng engine calcul │ │ │ │ -00011ff0: 6174 6573 2061 2072 6561 736f 6e61 626c ates a reasonabl │ │ │ │ -00012000: 6520 6c65 6164 696e 6720 7661 6c75 6520 e leading value │ │ │ │ -00012010: 6261 7365 640a 2020 2020 206f 6e20 7468 based. on th │ │ │ │ -00012020: 6520 6f74 6865 7220 666f 6e74 206d 6574 e other font met │ │ │ │ -00012030: 7269 6373 2e0a 0a20 2020 2a20 486f 7269 rics... * Hori │ │ │ │ -00012040: 7a6f 6e61 6c20 6c65 6164 696e 672e 2020 zonal leading. │ │ │ │ -00012050: 5468 6520 616d 6f75 6e74 206f 6620 7370 The amount of sp │ │ │ │ -00012060: 6163 652c 2069 6e20 7069 7865 6c73 2c20 ace, in pixels, │ │ │ │ -00012070: 746f 206c 6561 7665 0a20 2020 2020 686f to leave. ho │ │ │ │ -00012080: 7269 7a6f 6e74 616c 6c79 2062 6574 7765 rizontally betwe │ │ │ │ -00012090: 656e 2074 6865 206c 6566 7420 616e 6420 en the left and │ │ │ │ -000120a0: 7269 6768 7420 6564 6765 7320 6f66 2074 right edges of t │ │ │ │ -000120b0: 776f 2061 646a 6163 656e 740a 2020 2020 wo adjacent. │ │ │ │ -000120c0: 2067 6c79 7068 732e 2020 5468 6520 2a64 glyphs. The *d │ │ │ │ -000120d0: 6576 6963 6520 7769 6474 682a 2066 6965 evice width* fie │ │ │ │ -000120e0: 6c64 2064 6574 6572 6d69 6e65 7320 7468 ld determines th │ │ │ │ -000120f0: 6520 6566 6665 6374 6976 6520 6c65 6164 e effective lead │ │ │ │ -00012100: 696e 670a 2020 2020 2076 616c 7565 2074 ing. value t │ │ │ │ -00012110: 6861 7420 6973 2075 7365 6420 746f 2072 hat is used to r │ │ │ │ -00012120: 656e 6465 7220 7468 6520 666f 6e74 2e0a ender the font.. │ │ │ │ -00012130: 0a00 085b 696d 6167 6520 7372 633d 2266 ...[image src="f │ │ │ │ -00012140: 6f6e 745f 6368 6172 5f6d 6574 7269 6373 ont_char_metrics │ │ │ │ -00012150: 2e70 6e67 2220 7465 7874 3d22 506c 6561 .png" text="Plea │ │ │ │ -00012160: 7365 2066 696c 6c20 7468 6973 2069 6e2e se fill this in. │ │ │ │ -00012170: 2200 085d 0a0a 2020 2041 6e20 696c 6c75 "..].. An illu │ │ │ │ -00012180: 7374 7261 7469 6f6e 206f 6620 686f 7720 stration of how │ │ │ │ -00012190: 7468 6520 7661 7269 6f75 7320 666f 6e74 the various font │ │ │ │ -000121a0: 206d 6574 7269 6373 2061 7070 6c79 2074 metrics apply t │ │ │ │ -000121b0: 6f20 6368 6172 6163 7465 7273 2e0a 0a1f o characters.... │ │ │ │ -000121c0: 0a46 696c 653a 2067 7275 622d 6465 762e .File: grub-dev. │ │ │ │ -000121d0: 696e 666f 2c20 204e 6f64 653a 2047 7261 info, Node: Gra │ │ │ │ -000121e0: 7068 6963 616c 204d 656e 7520 536f 6674 phical Menu Soft │ │ │ │ -000121f0: 7761 7265 2044 6573 6967 6e2c 2020 4e65 ware Design, Ne │ │ │ │ -00012200: 7874 3a20 5665 7269 6669 6572 7320 6672 xt: Verifiers fr │ │ │ │ -00012210: 616d 6577 6f72 6b2c 2020 5072 6576 3a20 amework, Prev: │ │ │ │ -00012220: 5046 4632 2046 6f6e 7420 4669 6c65 2046 PFF2 Font File F │ │ │ │ -00012230: 6f72 6d61 742c 2020 5570 3a20 546f 700a ormat, Up: Top. │ │ │ │ -00012240: 0a31 3220 4772 6170 6869 6361 6c20 4d65 .12 Graphical Me │ │ │ │ -00012250: 6e75 2053 6f66 7477 6172 6520 4465 7369 nu Software Desi │ │ │ │ -00012260: 676e 0a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a gn.************* │ │ │ │ +00010bb0: 2d2d 2d2d 0a0a 2746 494c 4527 0a20 2020 ----..'FILE'. │ │ │ │ +00010bc0: 2020 2a46 696c 6520 7479 7065 2049 442a *File type ID* │ │ │ │ +00010bd0: 2028 4153 4349 4920 7374 7269 6e67 292e (ASCII string). │ │ │ │ +00010be0: 2020 5468 6973 206d 7573 7420 6265 2074 This must be t │ │ │ │ +00010bf0: 6865 2066 6972 7374 2073 6563 7469 6f6e he first section │ │ │ │ +00010c00: 2069 6e0a 2020 2020 2074 6865 2066 696c in. the fil │ │ │ │ +00010c10: 652e 2020 4974 2068 6173 206c 656e 6774 e. It has lengt │ │ │ │ +00010c20: 6820 3420 616e 6420 7468 6520 636f 6e74 h 4 and the cont │ │ │ │ +00010c30: 656e 7473 2061 7265 2074 6865 2066 6f75 ents are the fou │ │ │ │ +00010c40: 7220 6279 7465 7320 6f66 0a20 2020 2020 r bytes of. │ │ │ │ +00010c50: 7468 6520 4153 4349 4920 7374 7269 6e67 the ASCII string │ │ │ │ +00010c60: 2027 5046 4632 272e 0a0a 274e 414d 4527 'PFF2'...'NAME' │ │ │ │ +00010c70: 0a20 2020 2020 2a46 6f6e 7420 6e61 6d65 . *Font name │ │ │ │ +00010c80: 2a20 2841 5343 4949 2073 7472 696e 6729 * (ASCII string) │ │ │ │ +00010c90: 2e20 2054 6869 7320 6973 2074 6865 2066 . This is the f │ │ │ │ +00010ca0: 756c 6c20 666f 6e74 206e 616d 6520 696e ull font name in │ │ │ │ +00010cb0: 636c 7564 696e 670a 2020 2020 2066 616d cluding. fam │ │ │ │ +00010cc0: 696c 792c 2077 6569 6768 742c 2073 7479 ily, weight, sty │ │ │ │ +00010cd0: 6c65 2c20 616e 6420 706f 696e 7420 7369 le, and point si │ │ │ │ +00010ce0: 7a65 2e20 2046 6f72 2069 6e73 7461 6e63 ze. For instanc │ │ │ │ +00010cf0: 652c 2022 4865 6c76 6574 6963 610a 2020 e, "Helvetica. │ │ │ │ +00010d00: 2020 2042 6f6c 6420 4974 616c 6963 2031 Bold Italic 1 │ │ │ │ +00010d10: 3422 2e0a 0a27 4641 4d49 270a 2020 2020 4"...'FAMI'. │ │ │ │ +00010d20: 202a 466f 6e74 2066 616d 696c 7920 6e61 *Font family na │ │ │ │ +00010d30: 6d65 2a20 2841 5343 4949 2073 7472 696e me* (ASCII strin │ │ │ │ +00010d40: 6729 2e20 2046 6f72 2069 6e73 7461 6e63 g). For instanc │ │ │ │ +00010d50: 652c 2022 4865 6c76 6574 6963 6122 2e0a e, "Helvetica".. │ │ │ │ +00010d60: 2020 2020 2054 6869 7320 7368 6f75 6c64 This should │ │ │ │ +00010d70: 2062 6520 696e 636c 7564 6564 2073 6f20 be included so │ │ │ │ +00010d80: 7468 6174 2069 6e74 656c 6c69 6765 6e74 that intelligent │ │ │ │ +00010d90: 2066 6f6e 7420 7375 6273 7469 7475 7469 font substituti │ │ │ │ +00010da0: 6f6e 2063 616e 0a20 2020 2020 7461 6b65 on can. take │ │ │ │ +00010db0: 2070 6c61 6365 2e0a 0a27 5745 4947 270a place...'WEIG'. │ │ │ │ +00010dc0: 2020 2020 202a 466f 6e74 2077 6569 6768 *Font weigh │ │ │ │ +00010dd0: 742a 2028 4153 4349 4920 7374 7269 6e67 t* (ASCII string │ │ │ │ +00010de0: 292e 2020 5661 6c69 6420 7661 6c75 6573 ). Valid values │ │ │ │ +00010df0: 2061 7265 2027 626f 6c64 2720 616e 640a are 'bold' and. │ │ │ │ +00010e00: 2020 2020 2027 6e6f 726d 616c 272e 2020 'normal'. │ │ │ │ +00010e10: 5468 6973 2073 686f 756c 6420 6265 2069 This should be i │ │ │ │ +00010e20: 6e63 6c75 6465 6420 736f 2074 6861 7420 ncluded so that │ │ │ │ +00010e30: 696e 7465 6c6c 6967 656e 7420 666f 6e74 intelligent font │ │ │ │ +00010e40: 0a20 2020 2020 7375 6273 7469 7475 7469 . substituti │ │ │ │ +00010e50: 6f6e 2063 616e 2074 616b 6520 706c 6163 on can take plac │ │ │ │ +00010e60: 652e 0a0a 2753 4c41 4e27 0a20 2020 2020 e...'SLAN'. │ │ │ │ +00010e70: 2a46 6f6e 7420 736c 616e 742a 2028 4153 *Font slant* (AS │ │ │ │ +00010e80: 4349 4920 7374 7269 6e67 292e 2020 5661 CII string). Va │ │ │ │ +00010e90: 6c69 6420 7661 6c75 6573 2061 7265 2027 lid values are ' │ │ │ │ +00010ea0: 6974 616c 6963 2720 616e 640a 2020 2020 italic' and. │ │ │ │ +00010eb0: 2027 6e6f 726d 616c 272e 2020 5468 6973 'normal'. This │ │ │ │ +00010ec0: 2073 686f 756c 6420 6265 2069 6e63 6c75 should be inclu │ │ │ │ +00010ed0: 6465 6420 736f 2074 6861 7420 696e 7465 ded so that inte │ │ │ │ +00010ee0: 6c6c 6967 656e 7420 666f 6e74 0a20 2020 lligent font. │ │ │ │ +00010ef0: 2020 7375 6273 7469 7475 7469 6f6e 2063 substitution c │ │ │ │ +00010f00: 616e 2074 616b 6520 706c 6163 652e 0a0a an take place... │ │ │ │ +00010f10: 2750 5453 5a27 0a20 2020 2020 2a46 6f6e 'PTSZ'. *Fon │ │ │ │ +00010f20: 7420 706f 696e 7420 7369 7a65 2a20 2875 t point size* (u │ │ │ │ +00010f30: 696e 7431 3662 6529 2e0a 0a27 4d41 5857 int16be)...'MAXW │ │ │ │ +00010f40: 270a 2020 2020 202a 4d61 7869 6d75 6d20 '. *Maximum │ │ │ │ +00010f50: 6368 6172 6163 7465 7220 7769 6474 6820 character width │ │ │ │ +00010f60: 696e 2070 6978 656c 732a 2028 7569 6e74 in pixels* (uint │ │ │ │ +00010f70: 3136 6265 292e 0a0a 274d 4158 4827 0a20 16be)...'MAXH'. │ │ │ │ +00010f80: 2020 2020 2a4d 6178 696d 756d 2063 6861 *Maximum cha │ │ │ │ +00010f90: 7261 6374 6572 2068 6569 6768 7420 696e racter height in │ │ │ │ +00010fa0: 2070 6978 656c 732a 2028 7569 6e74 3136 pixels* (uint16 │ │ │ │ +00010fb0: 6265 292e 0a0a 2741 5343 4527 0a20 2020 be)...'ASCE'. │ │ │ │ +00010fc0: 2020 2a41 7363 656e 7420 696e 2070 6978 *Ascent in pix │ │ │ │ +00010fd0: 656c 732a 2028 7569 6e74 3136 6265 292e els* (uint16be). │ │ │ │ +00010fe0: 2020 2a4e 6f74 6520 466f 6e74 204d 6574 *Note Font Met │ │ │ │ +00010ff0: 7269 6373 3a3a 2c20 666f 7220 6465 7461 rics::, for deta │ │ │ │ +00011000: 696c 732e 0a0a 2744 4553 4327 0a20 2020 ils...'DESC'. │ │ │ │ +00011010: 2020 2a44 6573 6365 6e74 2069 6e20 7069 *Descent in pi │ │ │ │ +00011020: 7865 6c73 2a20 2875 696e 7431 3662 6529 xels* (uint16be) │ │ │ │ +00011030: 2e20 202a 4e6f 7465 2046 6f6e 7420 4d65 . *Note Font Me │ │ │ │ +00011040: 7472 6963 733a 3a2c 2066 6f72 2064 6574 trics::, for det │ │ │ │ +00011050: 6169 6c73 2e0a 0a27 4348 4958 270a 2020 ails...'CHIX'. │ │ │ │ +00011060: 2020 202a 4368 6172 6163 7465 7220 696e *Character in │ │ │ │ +00011070: 6465 782e 2a20 2054 6865 2063 6861 7261 dex.* The chara │ │ │ │ +00011080: 6374 6572 2069 6e64 6578 2062 6567 696e cter index begin │ │ │ │ +00011090: 7320 7769 7468 2061 2033 322d 6269 740a s with a 32-bit. │ │ │ │ +000110a0: 2020 2020 2062 6967 2d65 6e64 6961 6e20 big-endian │ │ │ │ +000110b0: 756e 7369 676e 6564 2069 6e74 6567 6572 unsigned integer │ │ │ │ +000110c0: 2069 6e64 6963 6174 696e 6720 7468 6520 indicating the │ │ │ │ +000110d0: 746f 7461 6c20 7369 7a65 206f 6620 7468 total size of th │ │ │ │ +000110e0: 650a 2020 2020 2073 6563 7469 6f6e 2c20 e. section, │ │ │ │ +000110f0: 6e6f 7420 696e 636c 7564 696e 6720 7468 not including th │ │ │ │ +00011100: 6973 2073 697a 6520 7661 6c75 652e 2020 is size value. │ │ │ │ +00011110: 466f 7220 6561 6368 2063 6861 7261 6374 For each charact │ │ │ │ +00011120: 6572 2c20 7468 6572 650a 2020 2020 2069 er, there. i │ │ │ │ +00011130: 7320 616e 2069 6e73 7461 6e63 6520 6f66 s an instance of │ │ │ │ +00011140: 2074 6865 2066 6f6c 6c6f 7769 6e67 2065 the following e │ │ │ │ +00011150: 6e74 7279 2073 7472 7563 7475 7265 3a0a ntry structure:. │ │ │ │ +00011160: 0a20 2020 2020 2020 202a 202a 556e 6963 . * *Unic │ │ │ │ +00011170: 6f64 6520 636f 6465 2070 6f69 6e74 2e2a ode code point.* │ │ │ │ +00011180: 2020 2833 322d 6269 7420 6269 672d 656e (32-bit big-en │ │ │ │ +00011190: 6469 616e 2069 6e74 6567 6572 2e29 0a0a dian integer.).. │ │ │ │ +000111a0: 2020 2020 2020 2020 2a20 2a53 746f 7261 * *Stora │ │ │ │ +000111b0: 6765 2066 6c61 6773 2e2a 2020 2862 7974 ge flags.* (byt │ │ │ │ +000111c0: 652e 290a 0a20 2020 2020 2020 2020 2020 e.).. │ │ │ │ +000111d0: 2020 2a20 4269 7473 2032 2e2e 303a 0a0a * Bits 2..0:.. │ │ │ │ +000111e0: 2020 2020 2020 2020 2020 2020 2020 2049 I │ │ │ │ +000111f0: 6620 6571 7561 6c20 746f 2030 3030 2062 f equal to 000 b │ │ │ │ +00011200: 696e 6172 792c 2074 6865 6e20 7468 6520 inary, then the │ │ │ │ +00011210: 6368 6172 6163 7465 7220 6461 7461 2069 character data i │ │ │ │ +00011220: 7320 7374 6f72 6564 0a20 2020 2020 2020 s stored. │ │ │ │ +00011230: 2020 2020 2020 2020 756e 636f 6d70 7265 uncompre │ │ │ │ +00011240: 7373 6564 2062 6567 696e 6e69 6e67 2061 ssed beginning a │ │ │ │ +00011250: 7420 7468 6520 6f66 6673 6574 2069 6e64 t the offset ind │ │ │ │ +00011260: 6963 6174 6564 2062 7920 7468 650a 2020 icated by the. │ │ │ │ +00011270: 2020 2020 2020 2020 2020 2020 2063 6861 cha │ │ │ │ +00011280: 7261 6374 6572 2773 202a 6f66 6673 6574 racter's *offset │ │ │ │ +00011290: 2a20 7661 6c75 652e 0a0a 2020 2020 2020 * value... │ │ │ │ +000112a0: 2020 2020 2020 2020 2049 6620 6571 7561 If equa │ │ │ │ +000112b0: 6c20 746f 2030 3031 2062 696e 6172 792c l to 001 binary, │ │ │ │ +000112c0: 2074 6865 6e20 7468 6520 6368 6172 6163 then the charac │ │ │ │ +000112d0: 7465 7220 6461 7461 2069 7320 7374 6f72 ter data is stor │ │ │ │ +000112e0: 6564 0a20 2020 2020 2020 2020 2020 2020 ed. │ │ │ │ +000112f0: 2020 7769 7468 696e 2061 2063 6f6d 7072 within a compr │ │ │ │ +00011300: 6573 7365 6420 6368 6172 6163 7465 7220 essed character │ │ │ │ +00011310: 6465 6669 6e69 7469 6f6e 2062 6c6f 636b definition block │ │ │ │ +00011320: 2074 6861 740a 2020 2020 2020 2020 2020 that. │ │ │ │ +00011330: 2020 2020 2062 6567 696e 7320 6174 2074 begins at t │ │ │ │ +00011340: 6865 206f 6666 7365 7420 7769 7468 696e he offset within │ │ │ │ +00011350: 2074 6865 2066 696c 6520 696e 6469 6361 the file indica │ │ │ │ +00011360: 7465 6420 6279 2074 6865 0a20 2020 2020 ted by the. │ │ │ │ +00011370: 2020 2020 2020 2020 2020 6368 6172 6163 charac │ │ │ │ +00011380: 7465 7227 7320 2a6f 6666 7365 742a 2076 ter's *offset* v │ │ │ │ +00011390: 616c 7565 2e0a 0a20 2020 2020 2020 202a alue... * │ │ │ │ +000113a0: 202a 4f66 6673 6574 2e2a 2020 2833 322d *Offset.* (32- │ │ │ │ +000113b0: 6269 7420 6269 672d 656e 6469 616e 2069 bit big-endian i │ │ │ │ +000113c0: 6e74 6567 6572 2e29 0a0a 2020 2020 2020 nteger.).. │ │ │ │ +000113d0: 2020 2020 4120 6d61 726b 6572 2074 6861 A marker tha │ │ │ │ +000113e0: 7420 696e 6469 6361 7465 7320 7468 6520 t indicates the │ │ │ │ +000113f0: 7265 6d61 696e 6465 7220 6f66 2074 6865 remainder of the │ │ │ │ +00011400: 2066 696c 6520 6973 2064 6174 610a 2020 file is data. │ │ │ │ +00011410: 2020 2020 2020 2020 6163 6365 7373 6564 accessed │ │ │ │ +00011420: 2076 6961 2074 6865 2063 6861 7261 6374 via the charact │ │ │ │ +00011430: 6572 2069 6e64 6578 2028 4348 4958 2920 er index (CHIX) │ │ │ │ +00011440: 7365 6374 696f 6e2e 2020 5768 656e 2072 section. When r │ │ │ │ +00011450: 6561 6469 6e67 0a20 2020 2020 2020 2020 eading. │ │ │ │ +00011460: 2074 6869 7320 666f 6e74 2066 696c 652c this font file, │ │ │ │ +00011470: 2074 6865 2072 6573 7420 6f66 2074 6865 the rest of the │ │ │ │ +00011480: 2066 696c 6520 6361 6e20 6265 2069 676e file can be ign │ │ │ │ +00011490: 6f72 6564 2077 6865 6e0a 2020 2020 2020 ored when. │ │ │ │ +000114a0: 2020 2020 7363 616e 6e69 6e67 2074 6865 scanning the │ │ │ │ +000114b0: 2073 6563 7469 6f6e 732e 2020 5468 6520 sections. The │ │ │ │ +000114c0: 6c65 6e67 7468 2073 686f 756c 6420 6265 length should be │ │ │ │ +000114d0: 2073 6574 2074 6f20 2d31 0a20 2020 2020 set to -1. │ │ │ │ +000114e0: 2020 2020 2028 3078 4646 4646 4646 4646 (0xFFFFFFFF │ │ │ │ +000114f0: 292e 0a0a 2020 2020 2020 2020 2020 5375 )... Su │ │ │ │ +00011500: 7070 6f72 7465 6420 6461 7461 2073 7472 pported data str │ │ │ │ +00011510: 7563 7475 7265 733a 0a0a 2020 2020 2020 uctures:.. │ │ │ │ +00011520: 2020 2020 4368 6172 6163 7465 7220 6465 Character de │ │ │ │ +00011530: 6669 6e69 7469 6f6e 2045 6163 6820 6368 finition Each ch │ │ │ │ +00011540: 6172 6163 7465 7220 6465 6669 6e69 7469 aracter definiti │ │ │ │ +00011550: 6f6e 2063 6f6e 7369 7374 7320 6f66 3a0a on consists of:. │ │ │ │ +00011560: 0a20 2020 2020 2020 2020 2020 2020 2a20 . * │ │ │ │ +00011570: 2a57 6964 7468 2e2a 2020 5769 6474 6820 *Width.* Width │ │ │ │ +00011580: 6f66 2074 6865 2062 6974 6d61 7020 696e of the bitmap in │ │ │ │ +00011590: 2070 6978 656c 732e 2020 5468 6520 6269 pixels. The bi │ │ │ │ +000115a0: 746d 6170 2773 0a20 2020 2020 2020 2020 tmap's. │ │ │ │ +000115b0: 2020 2020 2020 6578 7465 6e74 7320 7265 extents re │ │ │ │ +000115c0: 7072 6573 656e 7420 7468 6520 676c 7970 present the glyp │ │ │ │ +000115d0: 6827 7320 626f 756e 6469 6e67 2062 6f78 h's bounding box │ │ │ │ +000115e0: 2e20 2027 7569 6e74 3136 6265 272e 0a0a . 'uint16be'... │ │ │ │ +000115f0: 2020 2020 2020 2020 2020 2020 202a 202a * * │ │ │ │ +00011600: 4865 6967 6874 2e2a 2020 4865 6967 6874 Height.* Height │ │ │ │ +00011610: 206f 6620 7468 6520 6269 746d 6170 2069 of the bitmap i │ │ │ │ +00011620: 6e20 7069 7865 6c73 2e20 2054 6865 2062 n pixels. The b │ │ │ │ +00011630: 6974 6d61 7027 730a 2020 2020 2020 2020 itmap's. │ │ │ │ +00011640: 2020 2020 2020 2065 7874 656e 7473 2072 extents r │ │ │ │ +00011650: 6570 7265 7365 6e74 2074 6865 2067 6c79 epresent the gly │ │ │ │ +00011660: 7068 2773 2062 6f75 6e64 696e 6720 626f ph's bounding bo │ │ │ │ +00011670: 782e 2020 2775 696e 7431 3662 6527 2e0a x. 'uint16be'.. │ │ │ │ +00011680: 0a20 2020 2020 2020 2020 2020 2020 2a20 . * │ │ │ │ +00011690: 2a58 206f 6666 7365 742e 2a20 2054 6865 *X offset.* The │ │ │ │ +000116a0: 206e 756d 6265 7220 6f66 2070 6978 656c number of pixel │ │ │ │ +000116b0: 7320 746f 2073 6869 6674 2074 6865 2062 s to shift the b │ │ │ │ +000116c0: 6974 6d61 7020 6279 0a20 2020 2020 2020 itmap by. │ │ │ │ +000116d0: 2020 2020 2020 2020 686f 7269 7a6f 6e74 horizont │ │ │ │ +000116e0: 616c 6c79 2062 6566 6f72 6520 6472 6177 ally before draw │ │ │ │ +000116f0: 696e 6720 7468 6520 6368 6172 6163 7465 ing the characte │ │ │ │ +00011700: 722e 2020 2769 6e74 3136 6265 272e 0a0a r. 'int16be'... │ │ │ │ +00011710: 2020 2020 2020 2020 2020 2020 202a 202a * * │ │ │ │ +00011720: 5920 6f66 6673 6574 2e2a 2020 5468 6520 Y offset.* The │ │ │ │ +00011730: 6e75 6d62 6572 206f 6620 7069 7865 6c73 number of pixels │ │ │ │ +00011740: 2074 6f20 7368 6966 7420 7468 6520 6269 to shift the bi │ │ │ │ +00011750: 746d 6170 2062 790a 2020 2020 2020 2020 tmap by. │ │ │ │ +00011760: 2020 2020 2020 2076 6572 7469 6361 6c6c verticall │ │ │ │ +00011770: 7920 6265 666f 7265 2064 7261 7769 6e67 y before drawing │ │ │ │ +00011780: 2074 6865 2063 6861 7261 6374 6572 2e20 the character. │ │ │ │ +00011790: 2027 696e 7431 3662 6527 2e0a 0a20 2020 'int16be'... │ │ │ │ +000117a0: 2020 2020 2020 2020 2020 2a20 2a44 6576 * *Dev │ │ │ │ +000117b0: 6963 6520 7769 6474 682e 2a20 2054 6865 ice width.* The │ │ │ │ +000117c0: 206e 756d 6265 7220 6f66 2070 6978 656c number of pixel │ │ │ │ +000117d0: 7320 746f 2061 6476 616e 6365 0a20 2020 s to advance. │ │ │ │ +000117e0: 2020 2020 2020 2020 2020 2020 686f 7269 hori │ │ │ │ +000117f0: 7a6f 6e74 616c 6c79 2066 726f 6d20 7468 zontally from th │ │ │ │ +00011800: 6973 2063 6861 7261 6374 6572 2773 206f is character's o │ │ │ │ +00011810: 7269 6769 6e20 746f 2074 6865 206f 7269 rigin to the ori │ │ │ │ +00011820: 6769 6e0a 2020 2020 2020 2020 2020 2020 gin. │ │ │ │ +00011830: 2020 206f 6620 7468 6520 6e65 7874 2063 of the next c │ │ │ │ +00011840: 6861 7261 6374 6572 2e20 2027 696e 7431 haracter. 'int1 │ │ │ │ +00011850: 3662 6527 2e0a 0a20 2020 2020 2020 2020 6be'... │ │ │ │ +00011860: 2020 2020 2a20 2a42 6974 6d61 7020 6461 * *Bitmap da │ │ │ │ +00011870: 7461 2e2a 2020 5468 6973 2069 7320 656e ta.* This is en │ │ │ │ +00011880: 636f 6465 6420 6173 2061 2073 7472 696e coded as a strin │ │ │ │ +00011890: 6720 6f66 2062 6974 732e 2020 4974 0a20 g of bits. It. │ │ │ │ +000118a0: 2020 2020 2020 2020 2020 2020 2020 6973 is │ │ │ │ +000118b0: 206f 7267 616e 697a 6564 2061 7320 6120 organized as a │ │ │ │ +000118c0: 726f 772d 6d61 6a6f 722c 2074 6f70 2d64 row-major, top-d │ │ │ │ +000118d0: 6f77 6e2c 206c 6566 742d 746f 2d72 6967 own, left-to-rig │ │ │ │ +000118e0: 6874 0a20 2020 2020 2020 2020 2020 2020 ht. │ │ │ │ +000118f0: 2020 6269 746d 6170 2e20 2054 6865 206d bitmap. The m │ │ │ │ +00011900: 6f73 7420 7369 676e 6966 6963 616e 7420 ost significant │ │ │ │ +00011910: 6269 7420 6f66 2065 6163 6820 6279 7465 bit of each byte │ │ │ │ +00011920: 2069 7320 7461 6b65 6e0a 2020 2020 2020 is taken. │ │ │ │ +00011930: 2020 2020 2020 2020 2074 6f20 6265 2074 to be t │ │ │ │ +00011940: 6865 206c 6566 746d 6f73 7420 6f72 2075 he leftmost or u │ │ │ │ +00011950: 7070 6572 6d6f 7374 2062 6974 2069 6e20 ppermost bit in │ │ │ │ +00011960: 7468 6520 6279 7465 2e20 2046 6f72 2074 the byte. For t │ │ │ │ +00011970: 6865 0a20 2020 2020 2020 2020 2020 2020 he. │ │ │ │ +00011980: 2020 7361 6b65 206f 6620 636f 6d70 6163 sake of compac │ │ │ │ +00011990: 7420 7374 6f72 6167 652c 2072 6f77 7320 t storage, rows │ │ │ │ +000119a0: 6172 6520 6e6f 7420 7061 6464 6564 2074 are not padded t │ │ │ │ +000119b0: 6f20 6279 7465 0a20 2020 2020 2020 2020 o byte. │ │ │ │ +000119c0: 2020 2020 2020 626f 756e 6461 7269 6573 boundaries │ │ │ │ +000119d0: 2028 692e 652e 2c20 6120 7369 6e67 6c65 (i.e., a single │ │ │ │ +000119e0: 2062 7974 6520 6d61 7920 636f 6e74 6169 byte may contai │ │ │ │ +000119f0: 6e20 6269 7473 0a20 2020 2020 2020 2020 n bits. │ │ │ │ +00011a00: 2020 2020 2020 6265 6c6f 6e67 696e 6720 belonging │ │ │ │ +00011a10: 746f 206d 756c 7469 706c 6520 726f 7773 to multiple rows │ │ │ │ +00011a20: 292e 2020 5468 6520 6c61 7374 2062 7974 ). The last byt │ │ │ │ +00011a30: 6520 6f66 2074 6865 2062 6974 6d61 700a e of the bitmap. │ │ │ │ +00011a40: 2020 2020 2020 2020 2020 2020 2020 202a * │ │ │ │ +00011a50: 6973 2a20 7061 6464 6564 2077 6974 6820 is* padded with │ │ │ │ +00011a60: 7a65 726f 2062 6974 7320 696e 2074 6865 zero bits in the │ │ │ │ +00011a70: 2062 6974 7320 706f 7369 7469 6f6e 7320 bits positions │ │ │ │ +00011a80: 746f 2074 6865 0a20 2020 2020 2020 2020 to the. │ │ │ │ +00011a90: 2020 2020 2020 7269 6768 7420 6f66 2074 right of t │ │ │ │ +00011aa0: 6865 206c 6173 7420 7573 6564 2062 6974 he last used bit │ │ │ │ +00011ab0: 2069 6620 7468 6520 6269 746d 6170 2064 if the bitmap d │ │ │ │ +00011ac0: 6174 6120 646f 6573 206e 6f74 0a20 2020 ata does not. │ │ │ │ +00011ad0: 2020 2020 2020 2020 2020 2020 6669 6c6c fill │ │ │ │ +00011ae0: 2074 6865 206c 6173 7420 6279 7465 2e0a the last byte.. │ │ │ │ +00011af0: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ +00011b00: 5468 6520 6c65 6e67 7468 206f 6620 7468 The length of th │ │ │ │ +00011b10: 6520 2a62 6974 6d61 7020 6461 7461 2a20 e *bitmap data* │ │ │ │ +00011b20: 6669 656c 6420 6973 2028 5749 4454 4820 field is (WIDTH │ │ │ │ +00011b30: 2a20 4845 4947 4854 0a20 2020 2020 2020 * HEIGHT. │ │ │ │ +00011b40: 2020 2020 2020 2020 2b20 3729 202f 2038 + 7) / 8 │ │ │ │ +00011b50: 2075 7369 6e67 2069 6e74 6567 6572 2061 using integer a │ │ │ │ +00011b60: 7269 7468 6d65 7469 632c 2077 6869 6368 rithmetic, which │ │ │ │ +00011b70: 2069 7320 6571 7569 7661 6c65 6e74 2074 is equivalent t │ │ │ │ +00011b80: 6f0a 2020 2020 2020 2020 2020 2020 2020 o. │ │ │ │ +00011b90: 2063 6569 6c28 5749 4454 4820 2a20 4845 ceil(WIDTH * HE │ │ │ │ +00011ba0: 4947 4854 202f 2038 2920 7573 696e 6720 IGHT / 8) using │ │ │ │ +00011bb0: 7265 616c 206e 756d 6265 7220 6172 6974 real number arit │ │ │ │ +00011bc0: 686d 6574 6963 2e0a 0a20 2020 2020 2020 hmetic... │ │ │ │ +00011bd0: 2020 2020 2020 2020 4974 2072 656d 6169 It remai │ │ │ │ +00011be0: 6e73 2074 6f20 6265 2064 6574 6572 6d69 ns to be determi │ │ │ │ +00011bf0: 6e65 6420 7768 6574 6865 7220 6269 746d ned whether bitm │ │ │ │ +00011c00: 6170 2066 6f6e 7473 2075 7375 616c 6c79 ap fonts usually │ │ │ │ +00011c10: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ +00011c20: 6d61 6b65 2061 6c6c 2067 6c79 7068 2062 make all glyph b │ │ │ │ +00011c30: 6974 6d61 7073 2074 6865 2073 616d 6520 itmaps the same │ │ │ │ +00011c40: 6865 6967 6874 2c20 6f72 2069 6620 736d height, or if sm │ │ │ │ +00011c50: 616c 6c65 720a 2020 2020 2020 2020 2020 aller. │ │ │ │ +00011c60: 2020 2020 2067 6c79 7068 7320 6172 6520 glyphs are │ │ │ │ +00011c70: 7374 6f72 6564 2077 6974 6820 6269 746d stored with bitm │ │ │ │ +00011c80: 6170 7320 6861 7669 6e67 2061 206c 6573 aps having a les │ │ │ │ +00011c90: 7365 7220 6865 6967 6874 2e0a 2020 2020 ser height.. │ │ │ │ +00011ca0: 2020 2020 2020 2020 2020 2049 6e20 7468 In th │ │ │ │ +00011cb0: 6520 6c61 7474 6572 2063 6173 652c 2074 e latter case, t │ │ │ │ +00011cc0: 6865 2062 6173 656c 696e 6520 776f 756c he baseline woul │ │ │ │ +00011cd0: 6420 6861 7665 2074 6f20 6265 2075 7365 d have to be use │ │ │ │ +00011ce0: 6420 746f 0a20 2020 2020 2020 2020 2020 d to. │ │ │ │ +00011cf0: 2020 2020 6361 6c63 756c 6174 6520 7468 calculate th │ │ │ │ +00011d00: 6520 6c6f 6361 7469 6f6e 2074 6865 2062 e location the b │ │ │ │ +00011d10: 6974 6d61 7020 7368 6f75 6c64 2062 6520 itmap should be │ │ │ │ +00011d20: 616e 6368 6f72 6564 2061 740a 2020 2020 anchored at. │ │ │ │ +00011d30: 2020 2020 2020 2020 2020 206f 6e20 7363 on sc │ │ │ │ +00011d40: 7265 656e 2e0a 0a1f 0a46 696c 653a 2067 reen.....File: g │ │ │ │ +00011d50: 7275 622d 6465 762e 696e 666f 2c20 204e rub-dev.info, N │ │ │ │ +00011d60: 6f64 653a 2046 6f6e 7420 4d65 7472 6963 ode: Font Metric │ │ │ │ +00011d70: 732c 2020 5072 6576 3a20 4669 6c65 2053 s, Prev: File S │ │ │ │ +00011d80: 7472 7563 7475 7265 2c20 2055 703a 2050 tructure, Up: P │ │ │ │ +00011d90: 4646 3220 466f 6e74 2046 696c 6520 466f FF2 Font File Fo │ │ │ │ +00011da0: 726d 6174 0a0a 3131 2e33 2046 6f6e 7420 rmat..11.3 Font │ │ │ │ +00011db0: 4d65 7472 6963 730a 3d3d 3d3d 3d3d 3d3d Metrics.======== │ │ │ │ +00011dc0: 3d3d 3d3d 3d3d 3d3d 3d0a 0a20 2020 2a20 =========.. * │ │ │ │ +00011dd0: 4173 6365 6e74 2e20 2054 6865 2064 6973 Ascent. The dis │ │ │ │ +00011de0: 7461 6e63 6520 6672 6f6d 2074 6865 2062 tance from the b │ │ │ │ +00011df0: 6173 656c 696e 6520 746f 2074 6865 2074 aseline to the t │ │ │ │ +00011e00: 6f70 206f 6620 6d6f 7374 0a20 2020 2020 op of most. │ │ │ │ +00011e10: 6368 6172 6163 7465 7273 2e20 204e 6f74 characters. Not │ │ │ │ +00011e20: 6520 7468 6174 2069 6e20 736f 6d65 2063 e that in some c │ │ │ │ +00011e30: 6173 6573 2063 6861 7261 6374 6572 7320 ases characters │ │ │ │ +00011e40: 6d61 7920 6578 7465 6e64 2061 626f 7665 may extend above │ │ │ │ +00011e50: 0a20 2020 2020 7468 6520 6173 6365 6e74 . the ascent │ │ │ │ +00011e60: 2e0a 0a20 2020 2a20 4465 7363 656e 742e ... * Descent. │ │ │ │ +00011e70: 2020 5468 6520 6469 7374 616e 6365 2066 The distance f │ │ │ │ +00011e80: 726f 6d20 7468 6520 6261 7365 6c69 6e65 rom the baseline │ │ │ │ +00011e90: 2074 6f20 7468 6520 626f 7474 6f6d 206f to the bottom o │ │ │ │ +00011ea0: 6620 6d6f 7374 0a20 2020 2020 6368 6172 f most. char │ │ │ │ +00011eb0: 6163 7465 7273 2e20 204e 6f74 6520 7468 acters. Note th │ │ │ │ +00011ec0: 6174 2069 6e20 736f 6d65 2063 6173 6573 at in some cases │ │ │ │ +00011ed0: 2063 6861 7261 6374 6572 7320 6d61 7920 characters may │ │ │ │ +00011ee0: 6578 7465 6e64 2062 656c 6f77 0a20 2020 extend below. │ │ │ │ +00011ef0: 2020 7468 6520 6465 7363 656e 742e 0a0a the descent... │ │ │ │ +00011f00: 2020 202a 204c 6561 6469 6e67 2e20 2054 * Leading. T │ │ │ │ +00011f10: 6865 2061 6d6f 756e 7420 6f66 2073 7061 he amount of spa │ │ │ │ +00011f20: 6365 2c20 696e 2070 6978 656c 732c 2074 ce, in pixels, t │ │ │ │ +00011f30: 6f20 6c65 6176 6520 6265 7477 6565 6e20 o leave between │ │ │ │ +00011f40: 7468 650a 2020 2020 2064 6573 6365 6e74 the. descent │ │ │ │ +00011f50: 206f 6620 6f6e 6520 6c69 6e65 206f 6620 of one line of │ │ │ │ +00011f60: 7465 7874 2061 6e64 2074 6865 2061 7363 text and the asc │ │ │ │ +00011f70: 656e 7420 6f66 2074 6865 206e 6578 7420 ent of the next │ │ │ │ +00011f80: 6c69 6e65 2e20 2054 6869 730a 2020 2020 line. This. │ │ │ │ +00011f90: 206d 6574 7269 6373 2069 7320 6e6f 7420 metrics is not │ │ │ │ +00011fa0: 7370 6563 6966 6965 6420 696e 2074 6865 specified in the │ │ │ │ +00011fb0: 2063 7572 7265 6e74 2066 696c 6520 666f current file fo │ │ │ │ +00011fc0: 726d 6174 3b20 696e 7374 6561 642c 2074 rmat; instead, t │ │ │ │ +00011fd0: 6865 0a20 2020 2020 666f 6e74 2072 656e he. font ren │ │ │ │ +00011fe0: 6465 7269 6e67 2065 6e67 696e 6520 6361 dering engine ca │ │ │ │ +00011ff0: 6c63 756c 6174 6573 2061 2072 6561 736f lculates a reaso │ │ │ │ +00012000: 6e61 626c 6520 6c65 6164 696e 6720 7661 nable leading va │ │ │ │ +00012010: 6c75 6520 6261 7365 640a 2020 2020 206f lue based. o │ │ │ │ +00012020: 6e20 7468 6520 6f74 6865 7220 666f 6e74 n the other font │ │ │ │ +00012030: 206d 6574 7269 6373 2e0a 0a20 2020 2a20 metrics... * │ │ │ │ +00012040: 486f 7269 7a6f 6e61 6c20 6c65 6164 696e Horizonal leadin │ │ │ │ +00012050: 672e 2020 5468 6520 616d 6f75 6e74 206f g. The amount o │ │ │ │ +00012060: 6620 7370 6163 652c 2069 6e20 7069 7865 f space, in pixe │ │ │ │ +00012070: 6c73 2c20 746f 206c 6561 7665 0a20 2020 ls, to leave. │ │ │ │ +00012080: 2020 686f 7269 7a6f 6e74 616c 6c79 2062 horizontally b │ │ │ │ +00012090: 6574 7765 656e 2074 6865 206c 6566 7420 etween the left │ │ │ │ +000120a0: 616e 6420 7269 6768 7420 6564 6765 7320 and right edges │ │ │ │ +000120b0: 6f66 2074 776f 2061 646a 6163 656e 740a of two adjacent. │ │ │ │ +000120c0: 2020 2020 2067 6c79 7068 732e 2020 5468 glyphs. Th │ │ │ │ +000120d0: 6520 2a64 6576 6963 6520 7769 6474 682a e *device width* │ │ │ │ +000120e0: 2066 6965 6c64 2064 6574 6572 6d69 6e65 field determine │ │ │ │ +000120f0: 7320 7468 6520 6566 6665 6374 6976 6520 s the effective │ │ │ │ +00012100: 6c65 6164 696e 670a 2020 2020 2076 616c leading. val │ │ │ │ +00012110: 7565 2074 6861 7420 6973 2075 7365 6420 ue that is used │ │ │ │ +00012120: 746f 2072 656e 6465 7220 7468 6520 666f to render the fo │ │ │ │ +00012130: 6e74 2e0a 0a00 085b 696d 6167 6520 7372 nt.....[image sr │ │ │ │ +00012140: 633d 2266 6f6e 745f 6368 6172 5f6d 6574 c="font_char_met │ │ │ │ +00012150: 7269 6373 2e70 6e67 2220 7465 7874 3d22 rics.png" text=" │ │ │ │ +00012160: 506c 6561 7365 2066 696c 6c20 7468 6973 Please fill this │ │ │ │ +00012170: 2069 6e2e 2200 085d 0a0a 2020 2041 6e20 in."..].. An │ │ │ │ +00012180: 696c 6c75 7374 7261 7469 6f6e 206f 6620 illustration of │ │ │ │ +00012190: 686f 7720 7468 6520 7661 7269 6f75 7320 how the various │ │ │ │ +000121a0: 666f 6e74 206d 6574 7269 6373 2061 7070 font metrics app │ │ │ │ +000121b0: 6c79 2074 6f20 6368 6172 6163 7465 7273 ly to characters │ │ │ │ +000121c0: 2e0a 0a1f 0a46 696c 653a 2067 7275 622d .....File: grub- │ │ │ │ +000121d0: 6465 762e 696e 666f 2c20 204e 6f64 653a dev.info, Node: │ │ │ │ +000121e0: 2047 7261 7068 6963 616c 204d 656e 7520 Graphical Menu │ │ │ │ +000121f0: 536f 6674 7761 7265 2044 6573 6967 6e2c Software Design, │ │ │ │ +00012200: 2020 4e65 7874 3a20 5665 7269 6669 6572 Next: Verifier │ │ │ │ +00012210: 7320 6672 616d 6577 6f72 6b2c 2020 5072 s framework, Pr │ │ │ │ +00012220: 6576 3a20 5046 4632 2046 6f6e 7420 4669 ev: PFF2 Font Fi │ │ │ │ +00012230: 6c65 2046 6f72 6d61 742c 2020 5570 3a20 le Format, Up: │ │ │ │ +00012240: 546f 700a 0a31 3220 4772 6170 6869 6361 Top..12 Graphica │ │ │ │ +00012250: 6c20 4d65 6e75 2053 6f66 7477 6172 6520 l Menu Software │ │ │ │ +00012260: 4465 7369 676e 0a2a 2a2a 2a2a 2a2a 2a2a Design.********* │ │ │ │ 00012270: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ -00012280: 2a2a 2a2a 0a0a 2a20 4d65 6e75 3a0a 0a2a ****..* Menu:..* │ │ │ │ -00012290: 2049 6e74 726f 6475 6374 696f 6e5f 323a Introduction_2: │ │ │ │ -000122a0: 3a0a 2a20 5374 6172 7475 7020 5365 7175 :.* Startup Sequ │ │ │ │ -000122b0: 656e 6365 3a3a 0a2a 2047 5549 2043 6f6d ence::.* GUI Com │ │ │ │ -000122c0: 706f 6e65 6e74 733a 3a0a 2a20 436f 6d6d ponents::.* Comm │ │ │ │ -000122d0: 616e 6420 4c69 6e65 2057 696e 646f 773a and Line Window: │ │ │ │ -000122e0: 3a0a 0a1f 0a46 696c 653a 2067 7275 622d :....File: grub- │ │ │ │ -000122f0: 6465 762e 696e 666f 2c20 204e 6f64 653a dev.info, Node: │ │ │ │ -00012300: 2049 6e74 726f 6475 6374 696f 6e5f 322c Introduction_2, │ │ │ │ -00012310: 2020 4e65 7874 3a20 5374 6172 7475 7020 Next: Startup │ │ │ │ -00012320: 5365 7175 656e 6365 2c20 2055 703a 2047 Sequence, Up: G │ │ │ │ -00012330: 7261 7068 6963 616c 204d 656e 7520 536f raphical Menu So │ │ │ │ -00012340: 6674 7761 7265 2044 6573 6967 6e0a 0a31 ftware Design..1 │ │ │ │ -00012350: 322e 3120 496e 7472 6f64 7563 7469 6f6e 2.1 Introduction │ │ │ │ -00012360: 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d .=============== │ │ │ │ -00012370: 3d3d 0a0a 5468 6520 2767 6678 6d65 6e75 ==..The 'gfxmenu │ │ │ │ -00012380: 2720 6d6f 6475 6c65 2070 726f 7669 6465 ' module provide │ │ │ │ -00012390: 7320 6120 6772 6170 6869 6361 6c20 6d65 s a graphical me │ │ │ │ -000123a0: 6e75 2069 6e74 6572 6661 6365 2066 6f72 nu interface for │ │ │ │ -000123b0: 2047 5255 4220 322e 2020 4974 0a66 756e GRUB 2. It.fun │ │ │ │ -000123c0: 6374 696f 6e73 2061 7320 616e 2061 6c74 ctions as an alt │ │ │ │ -000123d0: 6572 6e61 7469 7665 2074 6f20 7468 6520 ernative to the │ │ │ │ -000123e0: 6d65 6e75 2069 6e74 6572 6661 6365 2070 menu interface p │ │ │ │ -000123f0: 726f 7669 6465 6420 6279 2074 6865 0a27 rovided by the.' │ │ │ │ -00012400: 6e6f 726d 616c 2720 6d6f 6475 6c65 2c20 normal' module, │ │ │ │ -00012410: 7768 6963 6820 7573 6573 2074 6865 2067 which uses the g │ │ │ │ -00012420: 7275 6220 7465 726d 696e 616c 2069 6e74 rub terminal int │ │ │ │ -00012430: 6572 6661 6365 2074 6f20 6469 7370 6c61 erface to displa │ │ │ │ -00012440: 7920 610a 6d65 6e75 206f 6e20 6120 6368 y a.menu on a ch │ │ │ │ -00012450: 6172 6163 7465 722d 6f72 6965 6e74 6564 aracter-oriented │ │ │ │ -00012460: 2074 6572 6d69 6e61 6c2e 0a0a 2020 2054 terminal... T │ │ │ │ -00012470: 6865 2067 7261 7068 6963 616c 206d 656e he graphical men │ │ │ │ -00012480: 7520 7573 6573 2074 6865 2047 5255 4220 u uses the GRUB │ │ │ │ -00012490: 7669 6465 6f20 4150 492c 2077 6869 6368 video API, which │ │ │ │ -000124a0: 2069 7320 6375 7272 656e 746c 7920 666f is currently fo │ │ │ │ -000124b0: 720a 7468 6520 5645 5341 2042 494f 5320 r.the VESA BIOS │ │ │ │ -000124c0: 6578 7465 6e73 696f 6e73 2028 5642 4529 extensions (VBE) │ │ │ │ -000124d0: 2032 2e30 2b2e 2020 5468 6973 2069 7320 2.0+. This is │ │ │ │ -000124e0: 7375 7070 6f72 7465 6420 6f6e 2074 6865 supported on the │ │ │ │ -000124f0: 2069 3338 362d 7063 0a70 6c61 7466 6f72 i386-pc.platfor │ │ │ │ -00012500: 6d2e 2020 486f 7765 7665 722c 2074 6865 m. However, the │ │ │ │ -00012510: 2067 7261 7068 6963 616c 206d 656e 7520 graphical menu │ │ │ │ -00012520: 6974 7365 6c66 2064 6f65 7320 6e6f 7420 itself does not │ │ │ │ -00012530: 6465 7065 6e64 206f 6e20 7573 696e 670a depend on using. │ │ │ │ -00012540: 5642 452c 2073 6f20 6966 2061 6e6f 7468 VBE, so if anoth │ │ │ │ -00012550: 6572 2047 5255 4220 7669 6465 6f20 6472 er GRUB video dr │ │ │ │ -00012560: 6976 6572 2077 6572 6520 696d 706c 656d iver were implem │ │ │ │ -00012570: 656e 7465 642c 2074 6865 2027 6766 786d ented, the 'gfxm │ │ │ │ -00012580: 656e 7527 0a67 7261 7068 6963 616c 206d enu'.graphical m │ │ │ │ -00012590: 656e 7520 776f 756c 6420 776f 726b 206f enu would work o │ │ │ │ -000125a0: 6e20 7468 6520 6e65 7720 7669 6465 6f20 n the new video │ │ │ │ -000125b0: 6472 6976 6572 2061 7320 7765 6c6c 2e0a driver as well.. │ │ │ │ -000125c0: 0a1f 0a46 696c 653a 2067 7275 622d 6465 ...File: grub-de │ │ │ │ -000125d0: 762e 696e 666f 2c20 204e 6f64 653a 2053 v.info, Node: S │ │ │ │ -000125e0: 7461 7274 7570 2053 6571 7565 6e63 652c tartup Sequence, │ │ │ │ -000125f0: 2020 4e65 7874 3a20 4755 4920 436f 6d70 Next: GUI Comp │ │ │ │ -00012600: 6f6e 656e 7473 2c20 2050 7265 763a 2049 onents, Prev: I │ │ │ │ -00012610: 6e74 726f 6475 6374 696f 6e5f 322c 2020 ntroduction_2, │ │ │ │ -00012620: 5570 3a20 4772 6170 6869 6361 6c20 4d65 Up: Graphical Me │ │ │ │ -00012630: 6e75 2053 6f66 7477 6172 6520 4465 7369 nu Software Desi │ │ │ │ -00012640: 676e 0a0a 3132 2e32 2053 7461 7274 7570 gn..12.2 Startup │ │ │ │ -00012650: 2053 6571 7565 6e63 650a 3d3d 3d3d 3d3d Sequence.====== │ │ │ │ -00012660: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a ===============. │ │ │ │ -00012670: 0a20 2020 2a20 6772 7562 5f65 6e74 6572 . * grub_enter │ │ │ │ -00012680: 5f6e 6f72 6d61 6c5f 6d6f 6465 205b 6e6f _normal_mode [no │ │ │ │ -00012690: 726d 616c 2f6d 6169 6e2e 635d 0a20 2020 rmal/main.c]. │ │ │ │ -000126a0: 2a20 6772 7562 5f6e 6f72 6d61 6c5f 6578 * grub_normal_ex │ │ │ │ -000126b0: 6563 7574 6520 5b6e 6f72 6d61 6c2f 6d61 ecute [normal/ma │ │ │ │ -000126c0: 696e 2e63 5d0a 2020 202a 2072 6561 645f in.c]. * read_ │ │ │ │ -000126d0: 636f 6e66 6967 5f66 696c 6520 5b6e 6f72 config_file [nor │ │ │ │ -000126e0: 6d61 6c2f 6d61 696e 2e63 5d0a 2020 202a mal/main.c]. * │ │ │ │ -000126f0: 2028 5768 656e 2027 6766 786d 656e 752e (When 'gfxmenu. │ │ │ │ -00012700: 6d6f 6427 2069 7320 6c6f 6164 6564 2077 mod' is loaded w │ │ │ │ -00012710: 6974 6820 2769 6e73 6d6f 6427 2c20 6974 ith 'insmod', it │ │ │ │ -00012720: 2077 696c 6c20 6361 6c6c 0a20 2020 2020 will call. │ │ │ │ -00012730: 2767 7275 625f 6d65 6e75 5f76 6965 7765 'grub_menu_viewe │ │ │ │ -00012740: 725f 7265 6769 7374 6572 2829 2720 746f r_register()' to │ │ │ │ -00012750: 2072 6567 6973 7465 7220 6974 7365 6c66 register itself │ │ │ │ -00012760: 2e29 0a20 2020 2a20 4752 5542 5f4d 4f44 .). * GRUB_MOD │ │ │ │ -00012770: 5f49 4e49 5420 2867 6678 6d65 6e75 2920 _INIT (gfxmenu) │ │ │ │ -00012780: 5b67 6678 6d65 6e75 2f67 6678 6d65 6e75 [gfxmenu/gfxmenu │ │ │ │ -00012790: 2e63 5d0a 2020 202a 2067 7275 625f 6d65 .c]. * grub_me │ │ │ │ -000127a0: 6e75 5f76 6965 7765 725f 7265 6769 7374 nu_viewer_regist │ │ │ │ -000127b0: 6572 205b 6b65 726e 2f6d 656e 755f 7669 er [kern/menu_vi │ │ │ │ -000127c0: 6577 6572 2e63 5d0a 2020 202a 2067 7275 ewer.c]. * gru │ │ │ │ -000127d0: 625f 6d65 6e75 5f76 6965 7765 725f 7368 b_menu_viewer_sh │ │ │ │ -000127e0: 6f77 5f6d 656e 7520 5b6b 6572 6e2f 6d65 ow_menu [kern/me │ │ │ │ -000127f0: 6e75 5f76 6965 7765 722e 635d 0a20 2020 nu_viewer.c]. │ │ │ │ -00012800: 2a20 6765 745f 6375 7272 656e 745f 6d65 * get_current_me │ │ │ │ -00012810: 6e75 5f76 6965 7765 7228 2920 5b6b 6572 nu_viewer() [ker │ │ │ │ -00012820: 6e2f 6d65 6e75 5f76 6965 7765 722e 635d n/menu_viewer.c] │ │ │ │ -00012830: 0a20 2020 2a20 7368 6f77 5f6d 656e 7528 . * show_menu( │ │ │ │ -00012840: 2920 5b67 6678 6d65 6e75 2f67 6678 6d65 ) [gfxmenu/gfxme │ │ │ │ -00012850: 6e75 2e63 5d0a 2020 202a 2067 7275 625f nu.c]. * grub_ │ │ │ │ -00012860: 6766 786d 656e 755f 6d6f 6465 6c5f 6e65 gfxmenu_model_ne │ │ │ │ -00012870: 7720 5b67 6678 6d65 6e75 2f6d 6f64 656c w [gfxmenu/model │ │ │ │ -00012880: 2e63 5d0a 2020 202a 2067 7275 625f 6766 .c]. * grub_gf │ │ │ │ -00012890: 786d 656e 755f 7669 6577 5f6e 6577 205b xmenu_view_new [ │ │ │ │ -000128a0: 6766 786d 656e 752f 7669 6577 2e63 5d0a gfxmenu/view.c]. │ │ │ │ -000128b0: 2020 202a 2073 6574 5f67 7261 7068 6963 * set_graphic │ │ │ │ -000128c0: 735f 6d6f 6465 205b 6766 786d 656e 752f s_mode [gfxmenu/ │ │ │ │ -000128d0: 7669 6577 2e63 5d0a 2020 202a 2067 7275 view.c]. * gru │ │ │ │ -000128e0: 625f 6766 786d 656e 755f 7669 6577 5f6c b_gfxmenu_view_l │ │ │ │ -000128f0: 6f61 645f 7468 656d 6520 5b67 6678 6d65 oad_theme [gfxme │ │ │ │ -00012900: 6e75 2f74 6865 6d65 5f6c 6f61 6465 722e nu/theme_loader. │ │ │ │ -00012910: 635d 0a0a 1f0a 4669 6c65 3a20 6772 7562 c]....File: grub │ │ │ │ -00012920: 2d64 6576 2e69 6e66 6f2c 2020 4e6f 6465 -dev.info, Node │ │ │ │ -00012930: 3a20 4755 4920 436f 6d70 6f6e 656e 7473 : GUI Components │ │ │ │ -00012940: 2c20 204e 6578 743a 2043 6f6d 6d61 6e64 , Next: Command │ │ │ │ -00012950: 204c 696e 6520 5769 6e64 6f77 2c20 2050 Line Window, P │ │ │ │ -00012960: 7265 763a 2053 7461 7274 7570 2053 6571 rev: Startup Seq │ │ │ │ -00012970: 7565 6e63 652c 2020 5570 3a20 4772 6170 uence, Up: Grap │ │ │ │ -00012980: 6869 6361 6c20 4d65 6e75 2053 6f66 7477 hical Menu Softw │ │ │ │ -00012990: 6172 6520 4465 7369 676e 0a0a 3132 2e33 are Design..12.3 │ │ │ │ -000129a0: 2047 5549 2043 6f6d 706f 6e65 6e74 730a GUI Components. │ │ │ │ -000129b0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ -000129c0: 3d3d 3d0a 0a54 6865 2067 7261 7068 6963 ===..The graphic │ │ │ │ -000129d0: 616c 206d 656e 7520 696d 706c 656d 656e al menu implemen │ │ │ │ -000129e0: 7473 2061 2047 5549 2063 6f6d 706f 6e65 ts a GUI compone │ │ │ │ -000129f0: 6e74 2073 7973 7465 6d20 7468 6174 2073 nt system that s │ │ │ │ -00012a00: 7570 706f 7274 7320 610a 636f 6e74 6169 upports a.contai │ │ │ │ -00012a10: 6e65 722d 6261 7365 6420 6c61 796f 7574 ner-based layout │ │ │ │ -00012a20: 2073 7973 7465 6d2e 2020 436f 6d70 6f6e system. Compon │ │ │ │ -00012a30: 656e 7473 2063 616e 2062 6520 6164 6465 ents can be adde │ │ │ │ -00012a40: 6420 746f 2063 6f6e 7461 696e 6572 732c d to containers, │ │ │ │ -00012a50: 0a61 6e64 2063 6f6e 7461 696e 6572 7320 .and containers │ │ │ │ -00012a60: 2877 6869 6368 2061 7265 2061 2074 7970 (which are a typ │ │ │ │ -00012a70: 6520 6f66 2063 6f6d 706f 6e65 6e74 2920 e of component) │ │ │ │ -00012a80: 6361 6e20 7468 656e 2062 6520 6164 6465 can then be adde │ │ │ │ -00012a90: 6420 746f 0a6f 7468 6572 2063 6f6e 7461 d to.other conta │ │ │ │ -00012aa0: 696e 6572 732c 2074 6f20 666f 726d 2061 iners, to form a │ │ │ │ -00012ab0: 2074 7265 6520 6f66 2063 6f6d 706f 6e65 tree of compone │ │ │ │ -00012ac0: 6e74 732e 2020 4375 7272 656e 746c 792c nts. Currently, │ │ │ │ -00012ad0: 2074 6865 2072 6f6f 740a 636f 6d70 6f6e the root.compon │ │ │ │ -00012ae0: 656e 7420 6f66 2074 6869 7320 7472 6565 ent of this tree │ │ │ │ -00012af0: 2069 7320 6120 2763 616e 7661 7327 2063 is a 'canvas' c │ │ │ │ -00012b00: 6f6d 706f 6e65 6e74 2c20 7768 6963 6820 omponent, which │ │ │ │ -00012b10: 616c 6c6f 7773 206d 616e 7561 6c0a 6c61 allows manual.la │ │ │ │ -00012b20: 796f 7574 206f 6620 6974 7320 6368 696c yout of its chil │ │ │ │ -00012b30: 6420 636f 6d70 6f6e 656e 7473 2e0a 0a20 d components... │ │ │ │ -00012b40: 2020 436f 6d70 6f6e 656e 7473 2028 6e6f Components (no │ │ │ │ -00012b50: 6e2d 636f 6e74 6169 6e65 7229 3a0a 0a20 n-container):.. │ │ │ │ -00012b60: 2020 2a20 6c61 6265 6c0a 2020 202a 2069 * label. * i │ │ │ │ -00012b70: 6d61 6765 0a20 2020 2a20 7072 6f67 7265 mage. * progre │ │ │ │ -00012b80: 7373 5f62 6172 0a20 2020 2a20 6369 7263 ss_bar. * circ │ │ │ │ -00012b90: 756c 6172 5f70 726f 6772 6573 730a 2020 ular_progress. │ │ │ │ -00012ba0: 202a 206c 6973 7420 2863 7572 7265 6e74 * list (current │ │ │ │ -00012bb0: 6c79 2068 6172 6420 636f 6465 6420 746f ly hard coded to │ │ │ │ -00012bc0: 2062 6520 6120 626f 6f74 206d 656e 7520 be a boot menu │ │ │ │ -00012bd0: 6c69 7374 290a 0a20 2020 436f 6e74 6169 list).. Contai │ │ │ │ -00012be0: 6e65 7273 3a0a 0a20 2020 2a20 6361 6e76 ners:.. * canv │ │ │ │ -00012bf0: 6173 0a20 2020 2a20 6862 6f78 0a20 2020 as. * hbox. │ │ │ │ -00012c00: 2a20 7662 6f78 0a0a 2020 2054 6865 2047 * vbox.. The G │ │ │ │ -00012c10: 5549 2063 6f6d 706f 6e65 6e74 2069 6e73 UI component ins │ │ │ │ -00012c20: 7461 6e63 6573 2061 7265 2063 7265 6174 tances are creat │ │ │ │ -00012c30: 6564 2062 7920 7468 6520 7468 656d 6520 ed by the theme │ │ │ │ -00012c40: 6c6f 6164 6572 2069 6e0a 2767 6678 6d65 loader in.'gfxme │ │ │ │ -00012c50: 6e75 2f74 6865 6d65 5f6c 6f61 6465 722e nu/theme_loader. │ │ │ │ -00012c60: 6327 2077 6865 6e20 6120 7468 656d 6520 c' when a theme │ │ │ │ -00012c70: 6973 206c 6f61 6465 642e 2020 5468 656d is loaded. Them │ │ │ │ -00012c80: 6520 6669 6c65 7320 7370 6563 6966 790a e files specify. │ │ │ │ -00012c90: 7374 6174 656d 656e 7473 2073 7563 6820 statements such │ │ │ │ -00012ca0: 6173 2027 2b76 626f 787b 202b 6c61 6265 as '+vbox{ +labe │ │ │ │ -00012cb0: 6c20 7b20 7465 7874 3d22 4865 6c6c 6f22 l { text="Hello" │ │ │ │ -00012cc0: 207d 202b 6c61 6265 6c7b 2074 6578 743d } +label{ text= │ │ │ │ -00012cd0: 2257 6f72 6c64 220a 7d20 7d27 2074 6f20 "World".} }' to │ │ │ │ -00012ce0: 6164 6420 636f 6d70 6f6e 656e 7473 2074 add components t │ │ │ │ -00012cf0: 6f20 7468 6520 636f 6d70 6f6e 656e 7420 o the component │ │ │ │ -00012d00: 7472 6565 2072 6f6f 742e 2020 4279 206e tree root. By n │ │ │ │ -00012d10: 6573 7469 6e67 2074 6865 0a63 6f6d 706f esting the.compo │ │ │ │ -00012d20: 6e65 6e74 2063 7265 6174 696f 6e20 7374 nent creation st │ │ │ │ -00012d30: 6174 656d 656e 7473 2069 6e20 7468 6520 atements in the │ │ │ │ -00012d40: 7468 656d 6520 6669 6c65 2c20 7468 6520 theme file, the │ │ │ │ -00012d50: 696e 7374 616e 7469 6174 6564 0a63 6f6d instantiated.com │ │ │ │ -00012d60: 706f 6e65 6e74 7320 6172 6520 6e65 7374 ponents are nest │ │ │ │ -00012d70: 6564 2074 6865 2073 616d 6520 7761 792e ed the same way. │ │ │ │ -00012d80: 0a0a 2020 2057 6865 6e20 6120 636f 6d70 .. When a comp │ │ │ │ -00012d90: 6f6e 656e 7420 6973 2061 6464 6564 2074 onent is added t │ │ │ │ -00012da0: 6f20 6120 636f 6e74 6169 6e65 722c 2074 o a container, t │ │ │ │ -00012db0: 6861 7420 6e65 7720 6368 696c 6420 6973 hat new child is │ │ │ │ -00012dc0: 0a63 6f6e 7369 6465 7265 6420 2a6f 776e .considered *own │ │ │ │ -00012dd0: 6564 2a20 6279 2074 6865 2063 6f6e 7461 ed* by the conta │ │ │ │ -00012de0: 696e 6572 2e20 2047 7265 6174 2063 6172 iner. Great car │ │ │ │ -00012df0: 6520 7368 6f75 6c64 2062 6520 7461 6b65 e should be take │ │ │ │ -00012e00: 6e20 6966 2074 6865 0a63 616c 6c65 7220 n if the.caller │ │ │ │ -00012e10: 7265 7461 696e 7320 6120 7265 6665 7265 retains a refere │ │ │ │ -00012e20: 6e63 6520 746f 2074 6865 2063 6869 6c64 nce to the child │ │ │ │ -00012e30: 2063 6f6d 706f 6e65 6e74 2c20 7369 6e63 component, sinc │ │ │ │ -00012e40: 6520 6974 2077 696c 6c20 6265 0a64 6573 e it will be.des │ │ │ │ -00012e50: 7472 6f79 6564 2069 6620 6974 7320 7061 troyed if its pa │ │ │ │ -00012e60: 7265 6e74 2063 6f6e 7461 696e 6572 2069 rent container i │ │ │ │ -00012e70: 7320 6465 7374 726f 7965 642e 2020 4120 s destroyed. A │ │ │ │ -00012e80: 6265 7474 6572 2063 686f 6963 6520 696e better choice in │ │ │ │ -00012e90: 7374 6561 640a 6f66 2073 746f 7269 6e67 stead.of storing │ │ │ │ -00012ea0: 2061 2070 6f69 6e74 6572 2074 6f20 7468 a pointer to th │ │ │ │ -00012eb0: 6520 6368 696c 6420 636f 6d70 6f6e 656e e child componen │ │ │ │ -00012ec0: 7420 6973 2074 6f20 7573 6520 7468 6520 t is to use the │ │ │ │ -00012ed0: 636f 6d70 6f6e 656e 7420 4944 0a74 6f20 component ID.to │ │ │ │ -00012ee0: 6669 6e64 2074 6865 2064 6573 6972 6564 find the desired │ │ │ │ -00012ef0: 2063 6f6d 706f 6e65 6e74 2e20 2043 6f6d component. Com │ │ │ │ -00012f00: 706f 6e65 6e74 2049 4473 2064 6f20 6e6f ponent IDs do no │ │ │ │ -00012f10: 7420 6861 7665 2074 6f20 6265 2075 6e69 t have to be uni │ │ │ │ -00012f20: 7175 650a 2869 7420 6973 206f 6674 656e que.(it is often │ │ │ │ -00012f30: 2075 7365 6675 6c20 746f 2068 6176 6520 useful to have │ │ │ │ -00012f40: 6d75 6c74 6970 6c65 2063 6f6d 706f 6e65 multiple compone │ │ │ │ -00012f50: 6e74 7320 7769 7468 2061 6e20 4944 206f nts with an ID o │ │ │ │ -00012f60: 660a 225f 5f74 696d 656f 7574 5f5f 222c f."__timeout__", │ │ │ │ -00012f70: 2066 6f72 2069 6e73 7461 6e63 6529 2e0a for instance).. │ │ │ │ -00012f80: 0a20 2020 496e 206f 7264 6572 2074 6f20 . In order to │ │ │ │ -00012f90: 6163 6365 7373 2061 6e64 2075 7365 2063 access and use c │ │ │ │ -00012fa0: 6f6d 706f 6e65 6e74 7320 696e 2074 6865 omponents in the │ │ │ │ -00012fb0: 2063 6f6d 706f 6e65 6e74 2074 7265 652c component tree, │ │ │ │ -00012fc0: 2074 6865 7265 0a61 7265 2074 776f 2066 there.are two f │ │ │ │ -00012fd0: 756e 6374 696f 6e73 2028 6465 6669 6e65 unctions (define │ │ │ │ -00012fe0: 6420 696e 2027 6766 786d 656e 752f 6775 d in 'gfxmenu/gu │ │ │ │ -00012ff0: 695f 7574 696c 2e63 2729 2074 6861 7420 i_util.c') that │ │ │ │ -00013000: 6172 650a 7061 7274 6963 756c 6172 6c79 are.particularly │ │ │ │ -00013010: 2075 7365 6675 6c3a 0a0a 2020 202a 2027 useful:.. * ' │ │ │ │ -00013020: 6772 7562 5f67 7569 5f66 696e 645f 6279 grub_gui_find_by │ │ │ │ -00013030: 5f69 6420 2872 6f6f 742c 2069 642c 2063 _id (root, id, c │ │ │ │ -00013040: 616c 6c62 6163 6b2c 2075 7365 7264 6174 allback, userdat │ │ │ │ -00013050: 6129 273a 0a0a 2020 2020 2054 6869 7320 a)':.. This │ │ │ │ -00013060: 6675 6e63 7469 6f6e 2065 6375 7273 6976 function ecursiv │ │ │ │ -00013070: 656c 7920 7472 6176 6572 7365 7320 7468 ely traverses th │ │ │ │ -00013080: 6520 636f 6d70 6f6e 656e 7420 7472 6565 e component tree │ │ │ │ -00013090: 2072 6f6f 7465 6420 6174 0a20 2020 2020 rooted at. │ │ │ │ -000130a0: 524f 4f54 2c20 616e 6420 666f 7220 6576 ROOT, and for ev │ │ │ │ -000130b0: 6572 7920 636f 6d70 6f6e 656e 7420 7468 ery component th │ │ │ │ -000130c0: 6174 2068 6173 2061 6e20 4944 2065 7175 at has an ID equ │ │ │ │ -000130d0: 616c 2074 6f20 4944 2c20 6361 6c6c 7320 al to ID, calls │ │ │ │ -000130e0: 7468 650a 2020 2020 2066 756e 6374 696f the. functio │ │ │ │ -000130f0: 6e20 706f 696e 7465 6420 746f 2062 7920 n pointed to by │ │ │ │ -00013100: 4341 4c4c 4241 434b 2077 6974 6820 7468 CALLBACK with th │ │ │ │ -00013110: 6520 6d61 7463 6869 6e67 2063 6f6d 706f e matching compo │ │ │ │ -00013120: 6e65 6e74 2061 6e64 2074 6865 0a20 2020 nent and the. │ │ │ │ -00013130: 2020 766f 6964 2070 6f69 6e74 6572 2055 void pointer U │ │ │ │ -00013140: 5345 5244 4154 4120 6173 2061 7267 756d SERDATA as argum │ │ │ │ -00013150: 656e 7473 2e20 2054 6865 2063 616c 6c62 ents. The callb │ │ │ │ -00013160: 6163 6b20 6675 6e63 7469 6f6e 2063 616e ack function can │ │ │ │ -00013170: 2064 6f0a 2020 2020 2077 6861 7465 7665 do. whateve │ │ │ │ -00013180: 7220 6973 2064 6573 6972 6564 2074 6f20 r is desired to │ │ │ │ -00013190: 7573 6520 7468 6520 636f 6d70 6f6e 656e use the componen │ │ │ │ -000131a0: 7420 7061 7373 6564 2069 6e2e 0a0a 2020 t passed in... │ │ │ │ -000131b0: 202a 2027 6772 7562 5f67 7569 5f69 7465 * 'grub_gui_ite │ │ │ │ -000131c0: 7261 7465 5f72 6563 7572 7369 7665 6c79 rate_recursively │ │ │ │ -000131d0: 2028 726f 6f74 2c20 6361 6c6c 6261 636b (root, callback │ │ │ │ -000131e0: 2c20 7573 6572 6461 7461 2927 3a0a 0a20 , userdata)':.. │ │ │ │ -000131f0: 2020 2020 5468 6973 2066 756e 6374 696f This functio │ │ │ │ -00013200: 6e20 6361 6c6c 7320 7468 6520 6675 6e63 n calls the func │ │ │ │ -00013210: 7469 6f6e 2070 6f69 6e74 6564 2074 6f20 tion pointed to │ │ │ │ -00013220: 6279 2043 414c 4c42 4143 4b20 666f 7220 by CALLBACK for │ │ │ │ -00013230: 6576 6572 790a 2020 2020 2063 6f6d 706f every. compo │ │ │ │ -00013240: 6e65 6e74 2074 6861 7420 6973 2061 2064 nent that is a d │ │ │ │ -00013250: 6573 6365 6e64 616e 7420 6f66 2052 4f4f escendant of ROO │ │ │ │ -00013260: 5420 696e 2074 6865 2063 6f6d 706f 6e65 T in the compone │ │ │ │ -00013270: 6e74 2074 7265 652e 2020 5768 656e 0a20 nt tree. When. │ │ │ │ -00013280: 2020 2020 7468 6520 6361 6c6c 6261 636b the callback │ │ │ │ -00013290: 2066 756e 6374 696f 6e20 6973 2063 616c function is cal │ │ │ │ -000132a0: 6c65 642c 2074 6865 2063 6f6d 706f 6e65 led, the compone │ │ │ │ -000132b0: 6e74 2061 6e64 2074 6865 2076 6f69 6420 nt and the void │ │ │ │ -000132c0: 706f 696e 7465 720a 2020 2020 2055 5345 pointer. USE │ │ │ │ -000132d0: 5244 4154 4120 6173 2061 7267 756d 656e RDATA as argumen │ │ │ │ -000132e0: 7473 2e20 2054 6865 2063 616c 6c62 6163 ts. The callbac │ │ │ │ -000132f0: 6b20 6675 6e63 7469 6f6e 2063 616e 2064 k function can d │ │ │ │ -00013300: 6f20 7768 6174 6576 6572 2069 730a 2020 o whatever is. │ │ │ │ -00013310: 2020 2064 6573 6972 6564 2074 6f20 7573 desired to us │ │ │ │ -00013320: 6520 7468 6520 636f 6d70 6f6e 656e 7420 e the component │ │ │ │ -00013330: 7061 7373 6564 2069 6e2e 0a0a 1f0a 4669 passed in.....Fi │ │ │ │ -00013340: 6c65 3a20 6772 7562 2d64 6576 2e69 6e66 le: grub-dev.inf │ │ │ │ -00013350: 6f2c 2020 4e6f 6465 3a20 436f 6d6d 616e o, Node: Comman │ │ │ │ -00013360: 6420 4c69 6e65 2057 696e 646f 772c 2020 d Line Window, │ │ │ │ -00013370: 5072 6576 3a20 4755 4920 436f 6d70 6f6e Prev: GUI Compon │ │ │ │ -00013380: 656e 7473 2c20 2055 703a 2047 7261 7068 ents, Up: Graph │ │ │ │ -00013390: 6963 616c 204d 656e 7520 536f 6674 7761 ical Menu Softwa │ │ │ │ -000133a0: 7265 2044 6573 6967 6e0a 0a31 322e 3420 re Design..12.4 │ │ │ │ -000133b0: 436f 6d6d 616e 6420 4c69 6e65 2057 696e Command Line Win │ │ │ │ -000133c0: 646f 770a 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d dow.============ │ │ │ │ -000133d0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a 5468 ============..Th │ │ │ │ -000133e0: 6520 7465 726d 696e 616c 2077 696e 646f e terminal windo │ │ │ │ -000133f0: 7720 7573 6564 2074 6f20 7072 6f76 6964 w used to provid │ │ │ │ -00013400: 6520 636f 6d6d 616e 6420 6c69 6e65 2061 e command line a │ │ │ │ -00013410: 6363 6573 7320 7769 7468 696e 2074 6865 ccess within the │ │ │ │ -00013420: 0a67 7261 7068 6963 616c 206d 656e 7520 .graphical menu │ │ │ │ -00013430: 6973 206d 616e 6167 6564 2062 7920 2767 is managed by 'g │ │ │ │ -00013440: 6678 6d65 6e75 2f76 6965 772e 6327 2e20 fxmenu/view.c'. │ │ │ │ -00013450: 2054 6865 2027 6766 7874 6572 6d27 2074 The 'gfxterm' t │ │ │ │ -00013460: 6572 6d69 6e61 6c0a 6973 2075 7365 642c erminal.is used, │ │ │ │ -00013470: 2061 6e64 2069 7420 6861 7320 6265 656e and it has been │ │ │ │ -00013480: 206d 6f64 6966 6965 6420 746f 2061 6c6c modified to all │ │ │ │ -00013490: 6f77 2072 656e 6465 7269 6e67 2074 6f20 ow rendering to │ │ │ │ -000134a0: 616e 206f 6666 7363 7265 656e 0a72 656e an offscreen.ren │ │ │ │ -000134b0: 6465 7220 7461 7267 6574 2074 6f20 616c der target to al │ │ │ │ -000134c0: 6c6f 7720 6974 2074 6f20 6265 2063 6f6d low it to be com │ │ │ │ -000134d0: 706f 7365 6420 696e 746f 2074 6865 2064 posed into the d │ │ │ │ -000134e0: 6f75 626c 6520 6275 6666 6572 696e 670a ouble buffering. │ │ │ │ -000134f0: 7379 7374 656d 2074 6861 7420 7468 6520 system that the │ │ │ │ -00013500: 6772 6170 6869 6361 6c20 6d65 6e75 2076 graphical menu v │ │ │ │ -00013510: 6965 7720 7573 6573 2e20 2054 6869 7320 iew uses. This │ │ │ │ -00013520: 6973 2062 6164 2066 6f72 2070 6572 666f is bad for perfo │ │ │ │ -00013530: 726d 616e 6365 2c0a 686f 7765 7665 722c rmance,.however, │ │ │ │ -00013540: 2073 6f20 6974 2077 6f75 6c64 2070 726f so it would pro │ │ │ │ -00013550: 6261 626c 7920 6265 2061 2067 6f6f 6420 bably be a good │ │ │ │ -00013560: 6964 6561 2074 6f20 6d61 6b65 2069 7420 idea to make it │ │ │ │ -00013570: 706f 7373 6962 6c65 2074 6f0a 7465 6d70 possible to.temp │ │ │ │ -00013580: 6f72 6172 696c 7920 6469 7361 626c 6520 orarily disable │ │ │ │ -00013590: 646f 7562 6c65 2062 7566 6665 7269 6e67 double buffering │ │ │ │ -000135a0: 2061 7320 6c6f 6e67 2061 7320 7468 6520 as long as the │ │ │ │ -000135b0: 7465 726d 696e 616c 2077 696e 646f 7720 terminal window │ │ │ │ -000135c0: 6973 0a76 6973 6962 6c65 2e20 2054 6865 is.visible. The │ │ │ │ -000135d0: 7265 2061 7265 2073 7469 6c6c 2075 6e72 re are still unr │ │ │ │ -000135e0: 6573 6f6c 7665 6420 7072 6f62 6c65 6d73 esolved problems │ │ │ │ -000135f0: 2074 6861 7420 6f63 6375 7220 7768 656e that occur when │ │ │ │ -00013600: 2063 6f6d 6d61 6e64 730a 6172 6520 6578 commands.are ex │ │ │ │ -00013610: 6563 7574 6564 2066 726f 6d20 7468 6520 ecuted from the │ │ │ │ -00013620: 7465 726d 696e 616c 2077 696e 646f 7720 terminal window │ │ │ │ -00013630: 7468 6174 2063 6861 6e67 6520 7468 6520 that change the │ │ │ │ -00013640: 6772 6170 6869 6373 206d 6f64 652e 0a49 graphics mode..I │ │ │ │ -00013650: 7427 7320 706f 7373 6962 6c65 2074 6861 t's possible tha │ │ │ │ -00013660: 7420 6d61 6b69 6e67 2027 6772 7562 5f76 t making 'grub_v │ │ │ │ -00013670: 6964 656f 5f72 6573 746f 7265 2829 2720 ideo_restore()' │ │ │ │ -00013680: 7265 7475 726e 2074 6f20 7468 6520 6772 return to the gr │ │ │ │ -00013690: 6170 6869 6373 0a6d 6f64 6520 7468 6174 aphics.mode that │ │ │ │ -000136a0: 2077 6173 2069 6e20 7573 6520 6265 666f was in use befo │ │ │ │ -000136b0: 7265 2027 6772 7562 5f76 6964 656f 5f73 re 'grub_video_s │ │ │ │ -000136c0: 6574 7570 2829 2720 7761 7320 6361 6c6c etup()' was call │ │ │ │ -000136d0: 6564 206d 6967 6874 2066 6978 0a73 6f6d ed might fix.som │ │ │ │ -000136e0: 6520 6f66 2074 6865 2070 726f 626c 656d e of the problem │ │ │ │ -000136f0: 732e 0a0a 1f0a 4669 6c65 3a20 6772 7562 s.....File: grub │ │ │ │ -00013700: 2d64 6576 2e69 6e66 6f2c 2020 4e6f 6465 -dev.info, Node │ │ │ │ -00013710: 3a20 5665 7269 6669 6572 7320 6672 616d : Verifiers fram │ │ │ │ -00013720: 6577 6f72 6b2c 2020 4e65 7874 3a20 4c6f ework, Next: Lo │ │ │ │ -00013730: 636b 646f 776e 2066 7261 6d65 776f 726b ckdown framework │ │ │ │ -00013740: 2c20 2050 7265 763a 2047 7261 7068 6963 , Prev: Graphic │ │ │ │ -00013750: 616c 204d 656e 7520 536f 6674 7761 7265 al Menu Software │ │ │ │ -00013760: 2044 6573 6967 6e2c 2020 5570 3a20 546f Design, Up: To │ │ │ │ -00013770: 700a 0a31 3320 5665 7269 6669 6572 7320 p..13 Verifiers │ │ │ │ -00013780: 6672 616d 6577 6f72 6b0a 2a2a 2a2a 2a2a framework.****** │ │ │ │ +00012280: 2a2a 2a2a 2a2a 2a2a 0a0a 2a20 4d65 6e75 ********..* Menu │ │ │ │ +00012290: 3a0a 0a2a 2049 6e74 726f 6475 6374 696f :..* Introductio │ │ │ │ +000122a0: 6e5f 323a 3a0a 2a20 5374 6172 7475 7020 n_2::.* Startup │ │ │ │ +000122b0: 5365 7175 656e 6365 3a3a 0a2a 2047 5549 Sequence::.* GUI │ │ │ │ +000122c0: 2043 6f6d 706f 6e65 6e74 733a 3a0a 2a20 Components::.* │ │ │ │ +000122d0: 436f 6d6d 616e 6420 4c69 6e65 2057 696e Command Line Win │ │ │ │ +000122e0: 646f 773a 3a0a 0a1f 0a46 696c 653a 2067 dow::....File: g │ │ │ │ +000122f0: 7275 622d 6465 762e 696e 666f 2c20 204e rub-dev.info, N │ │ │ │ +00012300: 6f64 653a 2049 6e74 726f 6475 6374 696f ode: Introductio │ │ │ │ +00012310: 6e5f 322c 2020 4e65 7874 3a20 5374 6172 n_2, Next: Star │ │ │ │ +00012320: 7475 7020 5365 7175 656e 6365 2c20 2055 tup Sequence, U │ │ │ │ +00012330: 703a 2047 7261 7068 6963 616c 204d 656e p: Graphical Men │ │ │ │ +00012340: 7520 536f 6674 7761 7265 2044 6573 6967 u Software Desig │ │ │ │ +00012350: 6e0a 0a31 322e 3120 496e 7472 6f64 7563 n..12.1 Introduc │ │ │ │ +00012360: 7469 6f6e 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d tion.=========== │ │ │ │ +00012370: 3d3d 3d3d 3d3d 0a0a 5468 6520 2767 6678 ======..The 'gfx │ │ │ │ +00012380: 6d65 6e75 2720 6d6f 6475 6c65 2070 726f menu' module pro │ │ │ │ +00012390: 7669 6465 7320 6120 6772 6170 6869 6361 vides a graphica │ │ │ │ +000123a0: 6c20 6d65 6e75 2069 6e74 6572 6661 6365 l menu interface │ │ │ │ +000123b0: 2066 6f72 2047 5255 4220 322e 2020 4974 for GRUB 2. It │ │ │ │ +000123c0: 0a66 756e 6374 696f 6e73 2061 7320 616e .functions as an │ │ │ │ +000123d0: 2061 6c74 6572 6e61 7469 7665 2074 6f20 alternative to │ │ │ │ +000123e0: 7468 6520 6d65 6e75 2069 6e74 6572 6661 the menu interfa │ │ │ │ +000123f0: 6365 2070 726f 7669 6465 6420 6279 2074 ce provided by t │ │ │ │ +00012400: 6865 0a27 6e6f 726d 616c 2720 6d6f 6475 he.'normal' modu │ │ │ │ +00012410: 6c65 2c20 7768 6963 6820 7573 6573 2074 le, which uses t │ │ │ │ +00012420: 6865 2067 7275 6220 7465 726d 696e 616c he grub terminal │ │ │ │ +00012430: 2069 6e74 6572 6661 6365 2074 6f20 6469 interface to di │ │ │ │ +00012440: 7370 6c61 7920 610a 6d65 6e75 206f 6e20 splay a.menu on │ │ │ │ +00012450: 6120 6368 6172 6163 7465 722d 6f72 6965 a character-orie │ │ │ │ +00012460: 6e74 6564 2074 6572 6d69 6e61 6c2e 0a0a nted terminal... │ │ │ │ +00012470: 2020 2054 6865 2067 7261 7068 6963 616c The graphical │ │ │ │ +00012480: 206d 656e 7520 7573 6573 2074 6865 2047 menu uses the G │ │ │ │ +00012490: 5255 4220 7669 6465 6f20 4150 492c 2077 RUB video API, w │ │ │ │ +000124a0: 6869 6368 2069 7320 6375 7272 656e 746c hich is currentl │ │ │ │ +000124b0: 7920 666f 720a 7468 6520 5645 5341 2042 y for.the VESA B │ │ │ │ +000124c0: 494f 5320 6578 7465 6e73 696f 6e73 2028 IOS extensions ( │ │ │ │ +000124d0: 5642 4529 2032 2e30 2b2e 2020 5468 6973 VBE) 2.0+. This │ │ │ │ +000124e0: 2069 7320 7375 7070 6f72 7465 6420 6f6e is supported on │ │ │ │ +000124f0: 2074 6865 2069 3338 362d 7063 0a70 6c61 the i386-pc.pla │ │ │ │ +00012500: 7466 6f72 6d2e 2020 486f 7765 7665 722c tform. However, │ │ │ │ +00012510: 2074 6865 2067 7261 7068 6963 616c 206d the graphical m │ │ │ │ +00012520: 656e 7520 6974 7365 6c66 2064 6f65 7320 enu itself does │ │ │ │ +00012530: 6e6f 7420 6465 7065 6e64 206f 6e20 7573 not depend on us │ │ │ │ +00012540: 696e 670a 5642 452c 2073 6f20 6966 2061 ing.VBE, so if a │ │ │ │ +00012550: 6e6f 7468 6572 2047 5255 4220 7669 6465 nother GRUB vide │ │ │ │ +00012560: 6f20 6472 6976 6572 2077 6572 6520 696d o driver were im │ │ │ │ +00012570: 706c 656d 656e 7465 642c 2074 6865 2027 plemented, the ' │ │ │ │ +00012580: 6766 786d 656e 7527 0a67 7261 7068 6963 gfxmenu'.graphic │ │ │ │ +00012590: 616c 206d 656e 7520 776f 756c 6420 776f al menu would wo │ │ │ │ +000125a0: 726b 206f 6e20 7468 6520 6e65 7720 7669 rk on the new vi │ │ │ │ +000125b0: 6465 6f20 6472 6976 6572 2061 7320 7765 deo driver as we │ │ │ │ +000125c0: 6c6c 2e0a 0a1f 0a46 696c 653a 2067 7275 ll.....File: gru │ │ │ │ +000125d0: 622d 6465 762e 696e 666f 2c20 204e 6f64 b-dev.info, Nod │ │ │ │ +000125e0: 653a 2053 7461 7274 7570 2053 6571 7565 e: Startup Seque │ │ │ │ +000125f0: 6e63 652c 2020 4e65 7874 3a20 4755 4920 nce, Next: GUI │ │ │ │ +00012600: 436f 6d70 6f6e 656e 7473 2c20 2050 7265 Components, Pre │ │ │ │ +00012610: 763a 2049 6e74 726f 6475 6374 696f 6e5f v: Introduction_ │ │ │ │ +00012620: 322c 2020 5570 3a20 4772 6170 6869 6361 2, Up: Graphica │ │ │ │ +00012630: 6c20 4d65 6e75 2053 6f66 7477 6172 6520 l Menu Software │ │ │ │ +00012640: 4465 7369 676e 0a0a 3132 2e32 2053 7461 Design..12.2 Sta │ │ │ │ +00012650: 7274 7570 2053 6571 7565 6e63 650a 3d3d rtup Sequence.== │ │ │ │ +00012660: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ +00012670: 3d3d 3d0a 0a20 2020 2a20 6772 7562 5f65 ===.. * grub_e │ │ │ │ +00012680: 6e74 6572 5f6e 6f72 6d61 6c5f 6d6f 6465 nter_normal_mode │ │ │ │ +00012690: 205b 6e6f 726d 616c 2f6d 6169 6e2e 635d [normal/main.c] │ │ │ │ +000126a0: 0a20 2020 2a20 6772 7562 5f6e 6f72 6d61 . * grub_norma │ │ │ │ +000126b0: 6c5f 6578 6563 7574 6520 5b6e 6f72 6d61 l_execute [norma │ │ │ │ +000126c0: 6c2f 6d61 696e 2e63 5d0a 2020 202a 2072 l/main.c]. * r │ │ │ │ +000126d0: 6561 645f 636f 6e66 6967 5f66 696c 6520 ead_config_file │ │ │ │ +000126e0: 5b6e 6f72 6d61 6c2f 6d61 696e 2e63 5d0a [normal/main.c]. │ │ │ │ +000126f0: 2020 202a 2028 5768 656e 2027 6766 786d * (When 'gfxm │ │ │ │ +00012700: 656e 752e 6d6f 6427 2069 7320 6c6f 6164 enu.mod' is load │ │ │ │ +00012710: 6564 2077 6974 6820 2769 6e73 6d6f 6427 ed with 'insmod' │ │ │ │ +00012720: 2c20 6974 2077 696c 6c20 6361 6c6c 0a20 , it will call. │ │ │ │ +00012730: 2020 2020 2767 7275 625f 6d65 6e75 5f76 'grub_menu_v │ │ │ │ +00012740: 6965 7765 725f 7265 6769 7374 6572 2829 iewer_register() │ │ │ │ +00012750: 2720 746f 2072 6567 6973 7465 7220 6974 ' to register it │ │ │ │ +00012760: 7365 6c66 2e29 0a20 2020 2a20 4752 5542 self.). * GRUB │ │ │ │ +00012770: 5f4d 4f44 5f49 4e49 5420 2867 6678 6d65 _MOD_INIT (gfxme │ │ │ │ +00012780: 6e75 2920 5b67 6678 6d65 6e75 2f67 6678 nu) [gfxmenu/gfx │ │ │ │ +00012790: 6d65 6e75 2e63 5d0a 2020 202a 2067 7275 menu.c]. * gru │ │ │ │ +000127a0: 625f 6d65 6e75 5f76 6965 7765 725f 7265 b_menu_viewer_re │ │ │ │ +000127b0: 6769 7374 6572 205b 6b65 726e 2f6d 656e gister [kern/men │ │ │ │ +000127c0: 755f 7669 6577 6572 2e63 5d0a 2020 202a u_viewer.c]. * │ │ │ │ +000127d0: 2067 7275 625f 6d65 6e75 5f76 6965 7765 grub_menu_viewe │ │ │ │ +000127e0: 725f 7368 6f77 5f6d 656e 7520 5b6b 6572 r_show_menu [ker │ │ │ │ +000127f0: 6e2f 6d65 6e75 5f76 6965 7765 722e 635d n/menu_viewer.c] │ │ │ │ +00012800: 0a20 2020 2a20 6765 745f 6375 7272 656e . * get_curren │ │ │ │ +00012810: 745f 6d65 6e75 5f76 6965 7765 7228 2920 t_menu_viewer() │ │ │ │ +00012820: 5b6b 6572 6e2f 6d65 6e75 5f76 6965 7765 [kern/menu_viewe │ │ │ │ +00012830: 722e 635d 0a20 2020 2a20 7368 6f77 5f6d r.c]. * show_m │ │ │ │ +00012840: 656e 7528 2920 5b67 6678 6d65 6e75 2f67 enu() [gfxmenu/g │ │ │ │ +00012850: 6678 6d65 6e75 2e63 5d0a 2020 202a 2067 fxmenu.c]. * g │ │ │ │ +00012860: 7275 625f 6766 786d 656e 755f 6d6f 6465 rub_gfxmenu_mode │ │ │ │ +00012870: 6c5f 6e65 7720 5b67 6678 6d65 6e75 2f6d l_new [gfxmenu/m │ │ │ │ +00012880: 6f64 656c 2e63 5d0a 2020 202a 2067 7275 odel.c]. * gru │ │ │ │ +00012890: 625f 6766 786d 656e 755f 7669 6577 5f6e b_gfxmenu_view_n │ │ │ │ +000128a0: 6577 205b 6766 786d 656e 752f 7669 6577 ew [gfxmenu/view │ │ │ │ +000128b0: 2e63 5d0a 2020 202a 2073 6574 5f67 7261 .c]. * set_gra │ │ │ │ +000128c0: 7068 6963 735f 6d6f 6465 205b 6766 786d phics_mode [gfxm │ │ │ │ +000128d0: 656e 752f 7669 6577 2e63 5d0a 2020 202a enu/view.c]. * │ │ │ │ +000128e0: 2067 7275 625f 6766 786d 656e 755f 7669 grub_gfxmenu_vi │ │ │ │ +000128f0: 6577 5f6c 6f61 645f 7468 656d 6520 5b67 ew_load_theme [g │ │ │ │ +00012900: 6678 6d65 6e75 2f74 6865 6d65 5f6c 6f61 fxmenu/theme_loa │ │ │ │ +00012910: 6465 722e 635d 0a0a 1f0a 4669 6c65 3a20 der.c]....File: │ │ │ │ +00012920: 6772 7562 2d64 6576 2e69 6e66 6f2c 2020 grub-dev.info, │ │ │ │ +00012930: 4e6f 6465 3a20 4755 4920 436f 6d70 6f6e Node: GUI Compon │ │ │ │ +00012940: 656e 7473 2c20 204e 6578 743a 2043 6f6d ents, Next: Com │ │ │ │ +00012950: 6d61 6e64 204c 696e 6520 5769 6e64 6f77 mand Line Window │ │ │ │ +00012960: 2c20 2050 7265 763a 2053 7461 7274 7570 , Prev: Startup │ │ │ │ +00012970: 2053 6571 7565 6e63 652c 2020 5570 3a20 Sequence, Up: │ │ │ │ +00012980: 4772 6170 6869 6361 6c20 4d65 6e75 2053 Graphical Menu S │ │ │ │ +00012990: 6f66 7477 6172 6520 4465 7369 676e 0a0a oftware Design.. │ │ │ │ +000129a0: 3132 2e33 2047 5549 2043 6f6d 706f 6e65 12.3 GUI Compone │ │ │ │ +000129b0: 6e74 730a 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d nts.============ │ │ │ │ +000129c0: 3d3d 3d3d 3d3d 3d0a 0a54 6865 2067 7261 =======..The gra │ │ │ │ +000129d0: 7068 6963 616c 206d 656e 7520 696d 706c phical menu impl │ │ │ │ +000129e0: 656d 656e 7473 2061 2047 5549 2063 6f6d ements a GUI com │ │ │ │ +000129f0: 706f 6e65 6e74 2073 7973 7465 6d20 7468 ponent system th │ │ │ │ +00012a00: 6174 2073 7570 706f 7274 7320 610a 636f at supports a.co │ │ │ │ +00012a10: 6e74 6169 6e65 722d 6261 7365 6420 6c61 ntainer-based la │ │ │ │ +00012a20: 796f 7574 2073 7973 7465 6d2e 2020 436f yout system. Co │ │ │ │ +00012a30: 6d70 6f6e 656e 7473 2063 616e 2062 6520 mponents can be │ │ │ │ +00012a40: 6164 6465 6420 746f 2063 6f6e 7461 696e added to contain │ │ │ │ +00012a50: 6572 732c 0a61 6e64 2063 6f6e 7461 696e ers,.and contain │ │ │ │ +00012a60: 6572 7320 2877 6869 6368 2061 7265 2061 ers (which are a │ │ │ │ +00012a70: 2074 7970 6520 6f66 2063 6f6d 706f 6e65 type of compone │ │ │ │ +00012a80: 6e74 2920 6361 6e20 7468 656e 2062 6520 nt) can then be │ │ │ │ +00012a90: 6164 6465 6420 746f 0a6f 7468 6572 2063 added to.other c │ │ │ │ +00012aa0: 6f6e 7461 696e 6572 732c 2074 6f20 666f ontainers, to fo │ │ │ │ +00012ab0: 726d 2061 2074 7265 6520 6f66 2063 6f6d rm a tree of com │ │ │ │ +00012ac0: 706f 6e65 6e74 732e 2020 4375 7272 656e ponents. Curren │ │ │ │ +00012ad0: 746c 792c 2074 6865 2072 6f6f 740a 636f tly, the root.co │ │ │ │ +00012ae0: 6d70 6f6e 656e 7420 6f66 2074 6869 7320 mponent of this │ │ │ │ +00012af0: 7472 6565 2069 7320 6120 2763 616e 7661 tree is a 'canva │ │ │ │ +00012b00: 7327 2063 6f6d 706f 6e65 6e74 2c20 7768 s' component, wh │ │ │ │ +00012b10: 6963 6820 616c 6c6f 7773 206d 616e 7561 ich allows manua │ │ │ │ +00012b20: 6c0a 6c61 796f 7574 206f 6620 6974 7320 l.layout of its │ │ │ │ +00012b30: 6368 696c 6420 636f 6d70 6f6e 656e 7473 child components │ │ │ │ +00012b40: 2e0a 0a20 2020 436f 6d70 6f6e 656e 7473 ... Components │ │ │ │ +00012b50: 2028 6e6f 6e2d 636f 6e74 6169 6e65 7229 (non-container) │ │ │ │ +00012b60: 3a0a 0a20 2020 2a20 6c61 6265 6c0a 2020 :.. * label. │ │ │ │ +00012b70: 202a 2069 6d61 6765 0a20 2020 2a20 7072 * image. * pr │ │ │ │ +00012b80: 6f67 7265 7373 5f62 6172 0a20 2020 2a20 ogress_bar. * │ │ │ │ +00012b90: 6369 7263 756c 6172 5f70 726f 6772 6573 circular_progres │ │ │ │ +00012ba0: 730a 2020 202a 206c 6973 7420 2863 7572 s. * list (cur │ │ │ │ +00012bb0: 7265 6e74 6c79 2068 6172 6420 636f 6465 rently hard code │ │ │ │ +00012bc0: 6420 746f 2062 6520 6120 626f 6f74 206d d to be a boot m │ │ │ │ +00012bd0: 656e 7520 6c69 7374 290a 0a20 2020 436f enu list).. Co │ │ │ │ +00012be0: 6e74 6169 6e65 7273 3a0a 0a20 2020 2a20 ntainers:.. * │ │ │ │ +00012bf0: 6361 6e76 6173 0a20 2020 2a20 6862 6f78 canvas. * hbox │ │ │ │ +00012c00: 0a20 2020 2a20 7662 6f78 0a0a 2020 2054 . * vbox.. T │ │ │ │ +00012c10: 6865 2047 5549 2063 6f6d 706f 6e65 6e74 he GUI component │ │ │ │ +00012c20: 2069 6e73 7461 6e63 6573 2061 7265 2063 instances are c │ │ │ │ +00012c30: 7265 6174 6564 2062 7920 7468 6520 7468 reated by the th │ │ │ │ +00012c40: 656d 6520 6c6f 6164 6572 2069 6e0a 2767 eme loader in.'g │ │ │ │ +00012c50: 6678 6d65 6e75 2f74 6865 6d65 5f6c 6f61 fxmenu/theme_loa │ │ │ │ +00012c60: 6465 722e 6327 2077 6865 6e20 6120 7468 der.c' when a th │ │ │ │ +00012c70: 656d 6520 6973 206c 6f61 6465 642e 2020 eme is loaded. │ │ │ │ +00012c80: 5468 656d 6520 6669 6c65 7320 7370 6563 Theme files spec │ │ │ │ +00012c90: 6966 790a 7374 6174 656d 656e 7473 2073 ify.statements s │ │ │ │ +00012ca0: 7563 6820 6173 2027 2b76 626f 787b 202b uch as '+vbox{ + │ │ │ │ +00012cb0: 6c61 6265 6c20 7b20 7465 7874 3d22 4865 label { text="He │ │ │ │ +00012cc0: 6c6c 6f22 207d 202b 6c61 6265 6c7b 2074 llo" } +label{ t │ │ │ │ +00012cd0: 6578 743d 2257 6f72 6c64 220a 7d20 7d27 ext="World".} }' │ │ │ │ +00012ce0: 2074 6f20 6164 6420 636f 6d70 6f6e 656e to add componen │ │ │ │ +00012cf0: 7473 2074 6f20 7468 6520 636f 6d70 6f6e ts to the compon │ │ │ │ +00012d00: 656e 7420 7472 6565 2072 6f6f 742e 2020 ent tree root. │ │ │ │ +00012d10: 4279 206e 6573 7469 6e67 2074 6865 0a63 By nesting the.c │ │ │ │ +00012d20: 6f6d 706f 6e65 6e74 2063 7265 6174 696f omponent creatio │ │ │ │ +00012d30: 6e20 7374 6174 656d 656e 7473 2069 6e20 n statements in │ │ │ │ +00012d40: 7468 6520 7468 656d 6520 6669 6c65 2c20 the theme file, │ │ │ │ +00012d50: 7468 6520 696e 7374 616e 7469 6174 6564 the instantiated │ │ │ │ +00012d60: 0a63 6f6d 706f 6e65 6e74 7320 6172 6520 .components are │ │ │ │ +00012d70: 6e65 7374 6564 2074 6865 2073 616d 6520 nested the same │ │ │ │ +00012d80: 7761 792e 0a0a 2020 2057 6865 6e20 6120 way... When a │ │ │ │ +00012d90: 636f 6d70 6f6e 656e 7420 6973 2061 6464 component is add │ │ │ │ +00012da0: 6564 2074 6f20 6120 636f 6e74 6169 6e65 ed to a containe │ │ │ │ +00012db0: 722c 2074 6861 7420 6e65 7720 6368 696c r, that new chil │ │ │ │ +00012dc0: 6420 6973 0a63 6f6e 7369 6465 7265 6420 d is.considered │ │ │ │ +00012dd0: 2a6f 776e 6564 2a20 6279 2074 6865 2063 *owned* by the c │ │ │ │ +00012de0: 6f6e 7461 696e 6572 2e20 2047 7265 6174 ontainer. Great │ │ │ │ +00012df0: 2063 6172 6520 7368 6f75 6c64 2062 6520 care should be │ │ │ │ +00012e00: 7461 6b65 6e20 6966 2074 6865 0a63 616c taken if the.cal │ │ │ │ +00012e10: 6c65 7220 7265 7461 696e 7320 6120 7265 ler retains a re │ │ │ │ +00012e20: 6665 7265 6e63 6520 746f 2074 6865 2063 ference to the c │ │ │ │ +00012e30: 6869 6c64 2063 6f6d 706f 6e65 6e74 2c20 hild component, │ │ │ │ +00012e40: 7369 6e63 6520 6974 2077 696c 6c20 6265 since it will be │ │ │ │ +00012e50: 0a64 6573 7472 6f79 6564 2069 6620 6974 .destroyed if it │ │ │ │ +00012e60: 7320 7061 7265 6e74 2063 6f6e 7461 696e s parent contain │ │ │ │ +00012e70: 6572 2069 7320 6465 7374 726f 7965 642e er is destroyed. │ │ │ │ +00012e80: 2020 4120 6265 7474 6572 2063 686f 6963 A better choic │ │ │ │ +00012e90: 6520 696e 7374 6561 640a 6f66 2073 746f e instead.of sto │ │ │ │ +00012ea0: 7269 6e67 2061 2070 6f69 6e74 6572 2074 ring a pointer t │ │ │ │ +00012eb0: 6f20 7468 6520 6368 696c 6420 636f 6d70 o the child comp │ │ │ │ +00012ec0: 6f6e 656e 7420 6973 2074 6f20 7573 6520 onent is to use │ │ │ │ +00012ed0: 7468 6520 636f 6d70 6f6e 656e 7420 4944 the component ID │ │ │ │ +00012ee0: 0a74 6f20 6669 6e64 2074 6865 2064 6573 .to find the des │ │ │ │ +00012ef0: 6972 6564 2063 6f6d 706f 6e65 6e74 2e20 ired component. │ │ │ │ +00012f00: 2043 6f6d 706f 6e65 6e74 2049 4473 2064 Component IDs d │ │ │ │ +00012f10: 6f20 6e6f 7420 6861 7665 2074 6f20 6265 o not have to be │ │ │ │ +00012f20: 2075 6e69 7175 650a 2869 7420 6973 206f unique.(it is o │ │ │ │ +00012f30: 6674 656e 2075 7365 6675 6c20 746f 2068 ften useful to h │ │ │ │ +00012f40: 6176 6520 6d75 6c74 6970 6c65 2063 6f6d ave multiple com │ │ │ │ +00012f50: 706f 6e65 6e74 7320 7769 7468 2061 6e20 ponents with an │ │ │ │ +00012f60: 4944 206f 660a 225f 5f74 696d 656f 7574 ID of."__timeout │ │ │ │ +00012f70: 5f5f 222c 2066 6f72 2069 6e73 7461 6e63 __", for instanc │ │ │ │ +00012f80: 6529 2e0a 0a20 2020 496e 206f 7264 6572 e)... In order │ │ │ │ +00012f90: 2074 6f20 6163 6365 7373 2061 6e64 2075 to access and u │ │ │ │ +00012fa0: 7365 2063 6f6d 706f 6e65 6e74 7320 696e se components in │ │ │ │ +00012fb0: 2074 6865 2063 6f6d 706f 6e65 6e74 2074 the component t │ │ │ │ +00012fc0: 7265 652c 2074 6865 7265 0a61 7265 2074 ree, there.are t │ │ │ │ +00012fd0: 776f 2066 756e 6374 696f 6e73 2028 6465 wo functions (de │ │ │ │ +00012fe0: 6669 6e65 6420 696e 2027 6766 786d 656e fined in 'gfxmen │ │ │ │ +00012ff0: 752f 6775 695f 7574 696c 2e63 2729 2074 u/gui_util.c') t │ │ │ │ +00013000: 6861 7420 6172 650a 7061 7274 6963 756c hat are.particul │ │ │ │ +00013010: 6172 6c79 2075 7365 6675 6c3a 0a0a 2020 arly useful:.. │ │ │ │ +00013020: 202a 2027 6772 7562 5f67 7569 5f66 696e * 'grub_gui_fin │ │ │ │ +00013030: 645f 6279 5f69 6420 2872 6f6f 742c 2069 d_by_id (root, i │ │ │ │ +00013040: 642c 2063 616c 6c62 6163 6b2c 2075 7365 d, callback, use │ │ │ │ +00013050: 7264 6174 6129 273a 0a0a 2020 2020 2054 rdata)':.. T │ │ │ │ +00013060: 6869 7320 6675 6e63 7469 6f6e 2065 6375 his function ecu │ │ │ │ +00013070: 7273 6976 656c 7920 7472 6176 6572 7365 rsively traverse │ │ │ │ +00013080: 7320 7468 6520 636f 6d70 6f6e 656e 7420 s the component │ │ │ │ +00013090: 7472 6565 2072 6f6f 7465 6420 6174 0a20 tree rooted at. │ │ │ │ +000130a0: 2020 2020 524f 4f54 2c20 616e 6420 666f ROOT, and fo │ │ │ │ +000130b0: 7220 6576 6572 7920 636f 6d70 6f6e 656e r every componen │ │ │ │ +000130c0: 7420 7468 6174 2068 6173 2061 6e20 4944 t that has an ID │ │ │ │ +000130d0: 2065 7175 616c 2074 6f20 4944 2c20 6361 equal to ID, ca │ │ │ │ +000130e0: 6c6c 7320 7468 650a 2020 2020 2066 756e lls the. fun │ │ │ │ +000130f0: 6374 696f 6e20 706f 696e 7465 6420 746f ction pointed to │ │ │ │ +00013100: 2062 7920 4341 4c4c 4241 434b 2077 6974 by CALLBACK wit │ │ │ │ +00013110: 6820 7468 6520 6d61 7463 6869 6e67 2063 h the matching c │ │ │ │ +00013120: 6f6d 706f 6e65 6e74 2061 6e64 2074 6865 omponent and the │ │ │ │ +00013130: 0a20 2020 2020 766f 6964 2070 6f69 6e74 . void point │ │ │ │ +00013140: 6572 2055 5345 5244 4154 4120 6173 2061 er USERDATA as a │ │ │ │ +00013150: 7267 756d 656e 7473 2e20 2054 6865 2063 rguments. The c │ │ │ │ +00013160: 616c 6c62 6163 6b20 6675 6e63 7469 6f6e allback function │ │ │ │ +00013170: 2063 616e 2064 6f0a 2020 2020 2077 6861 can do. wha │ │ │ │ +00013180: 7465 7665 7220 6973 2064 6573 6972 6564 tever is desired │ │ │ │ +00013190: 2074 6f20 7573 6520 7468 6520 636f 6d70 to use the comp │ │ │ │ +000131a0: 6f6e 656e 7420 7061 7373 6564 2069 6e2e onent passed in. │ │ │ │ +000131b0: 0a0a 2020 202a 2027 6772 7562 5f67 7569 .. * 'grub_gui │ │ │ │ +000131c0: 5f69 7465 7261 7465 5f72 6563 7572 7369 _iterate_recursi │ │ │ │ +000131d0: 7665 6c79 2028 726f 6f74 2c20 6361 6c6c vely (root, call │ │ │ │ +000131e0: 6261 636b 2c20 7573 6572 6461 7461 2927 back, userdata)' │ │ │ │ +000131f0: 3a0a 0a20 2020 2020 5468 6973 2066 756e :.. This fun │ │ │ │ +00013200: 6374 696f 6e20 6361 6c6c 7320 7468 6520 ction calls the │ │ │ │ +00013210: 6675 6e63 7469 6f6e 2070 6f69 6e74 6564 function pointed │ │ │ │ +00013220: 2074 6f20 6279 2043 414c 4c42 4143 4b20 to by CALLBACK │ │ │ │ +00013230: 666f 7220 6576 6572 790a 2020 2020 2063 for every. c │ │ │ │ +00013240: 6f6d 706f 6e65 6e74 2074 6861 7420 6973 omponent that is │ │ │ │ +00013250: 2061 2064 6573 6365 6e64 616e 7420 6f66 a descendant of │ │ │ │ +00013260: 2052 4f4f 5420 696e 2074 6865 2063 6f6d ROOT in the com │ │ │ │ +00013270: 706f 6e65 6e74 2074 7265 652e 2020 5768 ponent tree. Wh │ │ │ │ +00013280: 656e 0a20 2020 2020 7468 6520 6361 6c6c en. the call │ │ │ │ +00013290: 6261 636b 2066 756e 6374 696f 6e20 6973 back function is │ │ │ │ +000132a0: 2063 616c 6c65 642c 2074 6865 2063 6f6d called, the com │ │ │ │ +000132b0: 706f 6e65 6e74 2061 6e64 2074 6865 2076 ponent and the v │ │ │ │ +000132c0: 6f69 6420 706f 696e 7465 720a 2020 2020 oid pointer. │ │ │ │ +000132d0: 2055 5345 5244 4154 4120 6173 2061 7267 USERDATA as arg │ │ │ │ +000132e0: 756d 656e 7473 2e20 2054 6865 2063 616c uments. The cal │ │ │ │ +000132f0: 6c62 6163 6b20 6675 6e63 7469 6f6e 2063 lback function c │ │ │ │ +00013300: 616e 2064 6f20 7768 6174 6576 6572 2069 an do whatever i │ │ │ │ +00013310: 730a 2020 2020 2064 6573 6972 6564 2074 s. desired t │ │ │ │ +00013320: 6f20 7573 6520 7468 6520 636f 6d70 6f6e o use the compon │ │ │ │ +00013330: 656e 7420 7061 7373 6564 2069 6e2e 0a0a ent passed in... │ │ │ │ +00013340: 1f0a 4669 6c65 3a20 6772 7562 2d64 6576 ..File: grub-dev │ │ │ │ +00013350: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 436f .info, Node: Co │ │ │ │ +00013360: 6d6d 616e 6420 4c69 6e65 2057 696e 646f mmand Line Windo │ │ │ │ +00013370: 772c 2020 5072 6576 3a20 4755 4920 436f w, Prev: GUI Co │ │ │ │ +00013380: 6d70 6f6e 656e 7473 2c20 2055 703a 2047 mponents, Up: G │ │ │ │ +00013390: 7261 7068 6963 616c 204d 656e 7520 536f raphical Menu So │ │ │ │ +000133a0: 6674 7761 7265 2044 6573 6967 6e0a 0a31 ftware Design..1 │ │ │ │ +000133b0: 322e 3420 436f 6d6d 616e 6420 4c69 6e65 2.4 Command Line │ │ │ │ +000133c0: 2057 696e 646f 770a 3d3d 3d3d 3d3d 3d3d Window.======== │ │ │ │ +000133d0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ +000133e0: 0a0a 5468 6520 7465 726d 696e 616c 2077 ..The terminal w │ │ │ │ +000133f0: 696e 646f 7720 7573 6564 2074 6f20 7072 indow used to pr │ │ │ │ +00013400: 6f76 6964 6520 636f 6d6d 616e 6420 6c69 ovide command li │ │ │ │ +00013410: 6e65 2061 6363 6573 7320 7769 7468 696e ne access within │ │ │ │ +00013420: 2074 6865 0a67 7261 7068 6963 616c 206d the.graphical m │ │ │ │ +00013430: 656e 7520 6973 206d 616e 6167 6564 2062 enu is managed b │ │ │ │ +00013440: 7920 2767 6678 6d65 6e75 2f76 6965 772e y 'gfxmenu/view. │ │ │ │ +00013450: 6327 2e20 2054 6865 2027 6766 7874 6572 c'. The 'gfxter │ │ │ │ +00013460: 6d27 2074 6572 6d69 6e61 6c0a 6973 2075 m' terminal.is u │ │ │ │ +00013470: 7365 642c 2061 6e64 2069 7420 6861 7320 sed, and it has │ │ │ │ +00013480: 6265 656e 206d 6f64 6966 6965 6420 746f been modified to │ │ │ │ +00013490: 2061 6c6c 6f77 2072 656e 6465 7269 6e67 allow rendering │ │ │ │ +000134a0: 2074 6f20 616e 206f 6666 7363 7265 656e to an offscreen │ │ │ │ +000134b0: 0a72 656e 6465 7220 7461 7267 6574 2074 .render target t │ │ │ │ +000134c0: 6f20 616c 6c6f 7720 6974 2074 6f20 6265 o allow it to be │ │ │ │ +000134d0: 2063 6f6d 706f 7365 6420 696e 746f 2074 composed into t │ │ │ │ +000134e0: 6865 2064 6f75 626c 6520 6275 6666 6572 he double buffer │ │ │ │ +000134f0: 696e 670a 7379 7374 656d 2074 6861 7420 ing.system that │ │ │ │ +00013500: 7468 6520 6772 6170 6869 6361 6c20 6d65 the graphical me │ │ │ │ +00013510: 6e75 2076 6965 7720 7573 6573 2e20 2054 nu view uses. T │ │ │ │ +00013520: 6869 7320 6973 2062 6164 2066 6f72 2070 his is bad for p │ │ │ │ +00013530: 6572 666f 726d 616e 6365 2c0a 686f 7765 erformance,.howe │ │ │ │ +00013540: 7665 722c 2073 6f20 6974 2077 6f75 6c64 ver, so it would │ │ │ │ +00013550: 2070 726f 6261 626c 7920 6265 2061 2067 probably be a g │ │ │ │ +00013560: 6f6f 6420 6964 6561 2074 6f20 6d61 6b65 ood idea to make │ │ │ │ +00013570: 2069 7420 706f 7373 6962 6c65 2074 6f0a it possible to. │ │ │ │ +00013580: 7465 6d70 6f72 6172 696c 7920 6469 7361 temporarily disa │ │ │ │ +00013590: 626c 6520 646f 7562 6c65 2062 7566 6665 ble double buffe │ │ │ │ +000135a0: 7269 6e67 2061 7320 6c6f 6e67 2061 7320 ring as long as │ │ │ │ +000135b0: 7468 6520 7465 726d 696e 616c 2077 696e the terminal win │ │ │ │ +000135c0: 646f 7720 6973 0a76 6973 6962 6c65 2e20 dow is.visible. │ │ │ │ +000135d0: 2054 6865 7265 2061 7265 2073 7469 6c6c There are still │ │ │ │ +000135e0: 2075 6e72 6573 6f6c 7665 6420 7072 6f62 unresolved prob │ │ │ │ +000135f0: 6c65 6d73 2074 6861 7420 6f63 6375 7220 lems that occur │ │ │ │ +00013600: 7768 656e 2063 6f6d 6d61 6e64 730a 6172 when commands.ar │ │ │ │ +00013610: 6520 6578 6563 7574 6564 2066 726f 6d20 e executed from │ │ │ │ +00013620: 7468 6520 7465 726d 696e 616c 2077 696e the terminal win │ │ │ │ +00013630: 646f 7720 7468 6174 2063 6861 6e67 6520 dow that change │ │ │ │ +00013640: 7468 6520 6772 6170 6869 6373 206d 6f64 the graphics mod │ │ │ │ +00013650: 652e 0a49 7427 7320 706f 7373 6962 6c65 e..It's possible │ │ │ │ +00013660: 2074 6861 7420 6d61 6b69 6e67 2027 6772 that making 'gr │ │ │ │ +00013670: 7562 5f76 6964 656f 5f72 6573 746f 7265 ub_video_restore │ │ │ │ +00013680: 2829 2720 7265 7475 726e 2074 6f20 7468 ()' return to th │ │ │ │ +00013690: 6520 6772 6170 6869 6373 0a6d 6f64 6520 e graphics.mode │ │ │ │ +000136a0: 7468 6174 2077 6173 2069 6e20 7573 6520 that was in use │ │ │ │ +000136b0: 6265 666f 7265 2027 6772 7562 5f76 6964 before 'grub_vid │ │ │ │ +000136c0: 656f 5f73 6574 7570 2829 2720 7761 7320 eo_setup()' was │ │ │ │ +000136d0: 6361 6c6c 6564 206d 6967 6874 2066 6978 called might fix │ │ │ │ +000136e0: 0a73 6f6d 6520 6f66 2074 6865 2070 726f .some of the pro │ │ │ │ +000136f0: 626c 656d 732e 0a0a 1f0a 4669 6c65 3a20 blems.....File: │ │ │ │ +00013700: 6772 7562 2d64 6576 2e69 6e66 6f2c 2020 grub-dev.info, │ │ │ │ +00013710: 4e6f 6465 3a20 5665 7269 6669 6572 7320 Node: Verifiers │ │ │ │ +00013720: 6672 616d 6577 6f72 6b2c 2020 4e65 7874 framework, Next │ │ │ │ +00013730: 3a20 4c6f 636b 646f 776e 2066 7261 6d65 : Lockdown frame │ │ │ │ +00013740: 776f 726b 2c20 2050 7265 763a 2047 7261 work, Prev: Gra │ │ │ │ +00013750: 7068 6963 616c 204d 656e 7520 536f 6674 phical Menu Soft │ │ │ │ +00013760: 7761 7265 2044 6573 6967 6e2c 2020 5570 ware Design, Up │ │ │ │ +00013770: 3a20 546f 700a 0a31 3320 5665 7269 6669 : Top..13 Verifi │ │ │ │ +00013780: 6572 7320 6672 616d 6577 6f72 6b0a 2a2a ers framework.** │ │ │ │ 00013790: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ -000137a0: 0a0a 546f 2072 6567 6973 7465 7220 796f ..To register yo │ │ │ │ -000137b0: 7572 206f 776e 2076 6572 6966 6965 7220 ur own verifier │ │ │ │ -000137c0: 6361 6c6c 2027 6772 7562 5f76 6572 6966 call 'grub_verif │ │ │ │ -000137d0: 6965 725f 7265 6769 7374 6572 2720 7769 ier_register' wi │ │ │ │ -000137e0: 7468 2061 0a73 7472 7563 7475 7265 2070 th a.structure p │ │ │ │ -000137f0: 6f69 6e74 696e 6720 746f 2079 6f75 7220 ointing to your │ │ │ │ -00013800: 6675 6e63 7469 6f6e 732e 0a0a 2020 2054 functions... T │ │ │ │ -00013810: 6865 2069 6e74 6572 6661 6365 2069 7320 he interface is │ │ │ │ -00013820: 696e 7370 6972 6564 2062 7920 7468 6520 inspired by the │ │ │ │ -00013830: 6861 7368 2069 6e74 6572 6661 6365 2077 hash interface w │ │ │ │ -00013840: 6974 680a 2769 6e69 7427 2f27 7772 6974 ith.'init'/'writ │ │ │ │ -00013850: 6527 2f27 6669 6e69 272e 0a0a 2020 2054 e'/'fini'... T │ │ │ │ -00013860: 6865 7265 2061 7265 2065 7373 656e 7469 here are essenti │ │ │ │ -00013870: 616c 6c79 2032 2077 6179 7320 6f66 2075 ally 2 ways of u │ │ │ │ -00013880: 7369 6e67 2069 742c 2068 6173 6869 6e67 sing it, hashing │ │ │ │ -00013890: 2061 6e64 2077 686f 6c65 2d66 696c 650a and whole-file. │ │ │ │ -000138a0: 7665 7269 6669 6361 7469 6f6e 2e0a 0a20 verification... │ │ │ │ -000138b0: 2020 5769 7468 2074 6865 2068 6173 6869 With the hashi │ │ │ │ -000138c0: 6e67 2061 7070 726f 6163 683a 2044 7572 ng approach: Dur │ │ │ │ -000138d0: 696e 6720 2769 6e69 7427 2079 6f75 2064 ing 'init' you d │ │ │ │ -000138e0: 6563 6964 6520 7768 6574 6865 7220 796f ecide whether yo │ │ │ │ -000138f0: 7520 7761 6e74 0a74 6f20 6368 6563 6b20 u want.to check │ │ │ │ -00013900: 7468 6520 6769 7665 6e20 6669 6c65 2061 the given file a │ │ │ │ -00013910: 6e64 2069 6e69 7420 636f 6e74 6578 742e nd init context. │ │ │ │ -00013920: 2020 496e 2027 7772 6974 6527 2079 6f75 In 'write' you │ │ │ │ -00013930: 2075 7064 6174 6520 796f 7572 0a68 6173 update your.has │ │ │ │ -00013940: 6869 6e67 2073 7461 7465 2e20 2049 6e20 hing state. In │ │ │ │ -00013950: 2766 696e 6927 2079 6f75 2063 6865 636b 'fini' you check │ │ │ │ -00013960: 2074 6861 7420 7468 6520 6861 7368 206d that the hash m │ │ │ │ -00013970: 6174 6368 6573 2074 6865 2065 7870 6563 atches the expec │ │ │ │ -00013980: 7465 640a 7661 6c75 652f 7061 7373 6573 ted.value/passes │ │ │ │ -00013990: 2073 6f6d 6520 6368 6563 6b2f 2e2e 2e0a some check/.... │ │ │ │ -000139a0: 0a20 2020 5769 7468 2077 686f 6c65 2d66 . With whole-f │ │ │ │ -000139b0: 696c 6520 7665 7269 6669 6361 7469 6f6e ile verification │ │ │ │ -000139c0: 3a20 4475 7269 6e67 2027 696e 6974 2720 : During 'init' │ │ │ │ -000139d0: 796f 7520 6465 6369 6465 2077 6865 7468 you decide wheth │ │ │ │ -000139e0: 6572 2079 6f75 0a77 616e 7420 746f 2063 er you.want to c │ │ │ │ -000139f0: 6865 636b 2074 6865 2067 6976 656e 2066 heck the given f │ │ │ │ -00013a00: 696c 6520 616e 6420 696e 6974 2063 6f6e ile and init con │ │ │ │ -00013a10: 7465 7874 2e20 2049 6e20 2777 7269 7465 text. In 'write │ │ │ │ -00013a20: 2720 796f 7520 7665 7269 6679 0a74 6865 ' you verify.the │ │ │ │ -00013a30: 2066 696c 6520 616e 6420 7265 7475 726e file and return │ │ │ │ -00013a40: 2061 6e20 6572 726f 7220 6966 2069 7420 an error if it │ │ │ │ -00013a50: 6661 696c 732e 2020 596f 7520 646f 6e27 fails. You don' │ │ │ │ -00013a60: 7420 6861 7665 2027 6669 6e69 272e 0a0a t have 'fini'... │ │ │ │ -00013a70: 2020 2041 6464 6974 696f 6e61 6c20 2776 Additional 'v │ │ │ │ -00013a80: 6572 6966 795f 7374 7269 6e67 2720 7265 erify_string' re │ │ │ │ -00013a90: 6365 6976 6573 2076 6172 696f 7573 2073 ceives various s │ │ │ │ -00013aa0: 7472 696e 6773 206c 696b 6520 6b65 726e trings like kern │ │ │ │ -00013ab0: 656c 0a70 6172 616d 6574 6572 7320 746f el.parameters to │ │ │ │ -00013ac0: 2076 6572 6966 792e 2020 5265 7475 726e verify. Return │ │ │ │ -00013ad0: 696e 6720 6e6f 2065 7272 6f72 206d 6561 ing no error mea │ │ │ │ -00013ae0: 6e73 2073 7563 6365 7373 6675 6c20 7665 ns successful ve │ │ │ │ -00013af0: 7269 6669 6361 7469 6f6e 0a61 6e64 2061 rification.and a │ │ │ │ -00013b00: 6e20 6572 726f 7220 7374 6f70 7320 7468 n error stops th │ │ │ │ -00013b10: 6520 6375 7272 656e 7420 6163 7469 6f6e e current action │ │ │ │ -00013b20: 2e0a 0a20 2020 4465 7461 696c 6564 2064 ... Detailed d │ │ │ │ -00013b30: 6573 6372 6970 7469 6f6e 206f 6620 7468 escription of th │ │ │ │ -00013b40: 6520 4150 493a 0a0a 2020 2045 7665 7279 e API:.. Every │ │ │ │ -00013b50: 2074 696d 6520 6120 6669 6c65 2069 7320 time a file is │ │ │ │ -00013b60: 6f70 656e 6564 2079 6f75 7220 2769 6e69 opened your 'ini │ │ │ │ -00013b70: 7427 2066 756e 6374 696f 6e20 6973 2063 t' function is c │ │ │ │ -00013b80: 616c 6c65 6420 7769 7468 2066 696c 650a alled with file. │ │ │ │ -00013b90: 6465 7363 7269 7074 6f72 2061 6e64 2066 descriptor and f │ │ │ │ -00013ba0: 696c 6520 7479 7065 2e20 2059 6f75 7220 ile type. Your │ │ │ │ -00013bb0: 6675 6e63 7469 6f6e 2063 616e 2068 6176 function can hav │ │ │ │ -00013bc0: 6520 7468 6520 666f 6c6c 6f77 696e 670a e the following. │ │ │ │ -00013bd0: 6f75 7463 6f6d 6573 3a0a 0a20 2020 2a20 outcomes:.. * │ │ │ │ -00013be0: 7265 7475 726e 696e 6720 6e6f 2065 7272 returning no err │ │ │ │ -00013bf0: 6f72 2061 6e64 2073 6574 7469 6e67 2027 or and setting ' │ │ │ │ -00013c00: 2a66 6c61 6773 2720 746f 0a20 2020 2020 *flags' to. │ │ │ │ -00013c10: 2747 5255 425f 5645 5249 4659 5f46 4c41 'GRUB_VERIFY_FLA │ │ │ │ -00013c20: 4753 5f44 4546 4552 5f41 5554 4827 2e20 GS_DEFER_AUTH'. │ │ │ │ -00013c30: 2049 6e20 7468 6973 2063 6173 6520 7665 In this case ve │ │ │ │ -00013c40: 7269 6669 6361 7469 6f6e 2069 730a 2020 rification is. │ │ │ │ -00013c50: 2020 2064 6566 6572 7265 6420 746f 206f deferred to o │ │ │ │ -00013c60: 7468 6572 2061 6374 6976 6520 7665 7269 ther active veri │ │ │ │ -00013c70: 6669 6572 732e 2020 5665 7269 6669 6361 fiers. Verifica │ │ │ │ -00013c80: 7469 6f6e 2066 6169 6c73 2069 6620 6e6f tion fails if no │ │ │ │ -00013c90: 626f 6479 0a20 2020 2020 6361 7265 7320 body. cares │ │ │ │ -00013ca0: 6f72 2073 656c 6563 7465 6420 7665 7269 or selected veri │ │ │ │ -00013cb0: 6669 6572 2066 6169 6c73 2e0a 0a20 2020 fier fails... │ │ │ │ -00013cc0: 2a20 7265 7475 726e 696e 6720 6e6f 2065 * returning no e │ │ │ │ -00013cd0: 7272 6f72 2061 6e64 2073 6574 7469 6e67 rror and setting │ │ │ │ -00013ce0: 2027 2a66 6c61 6773 2720 746f 0a20 2020 '*flags' to. │ │ │ │ -00013cf0: 2020 2747 5255 425f 5645 5249 4659 5f46 'GRUB_VERIFY_F │ │ │ │ -00013d00: 4c41 4753 5f53 4b49 505f 5645 5249 4649 LAGS_SKIP_VERIFI │ │ │ │ -00013d10: 4341 5449 4f4e 272e 2020 496e 2074 6869 CATION'. In thi │ │ │ │ -00013d20: 7320 6361 7365 2079 6f75 7220 7665 7269 s case your veri │ │ │ │ -00013d30: 6669 6572 0a20 2020 2020 7769 6c6c 206e fier. will n │ │ │ │ -00013d40: 6f74 2062 6520 6361 6c6c 6564 2061 6e79 ot be called any │ │ │ │ -00013d50: 6d6f 7265 2061 6e64 2069 7420 6973 2061 more and it is a │ │ │ │ -00013d60: 7373 756d 6564 2074 6f20 6861 7665 2073 ssumed to have s │ │ │ │ -00013d70: 6b69 7070 6564 0a20 2020 2020 7665 7269 kipped. veri │ │ │ │ -00013d80: 6669 6361 7469 6f6e 2e0a 0a20 2020 2a20 fication... * │ │ │ │ -00013d90: 7265 7475 726e 696e 6720 6e6f 2065 7272 returning no err │ │ │ │ -00013da0: 6f72 2061 6e64 206e 6f74 2073 6574 7469 or and not setti │ │ │ │ -00013db0: 6e67 2027 2a66 6c61 6773 2720 746f 0a20 ng '*flags' to. │ │ │ │ -00013dc0: 2020 2020 2747 5255 425f 5645 5249 4659 'GRUB_VERIFY │ │ │ │ -00013dd0: 5f46 4c41 4753 5f53 4b49 505f 5645 5249 _FLAGS_SKIP_VERI │ │ │ │ -00013de0: 4649 4341 5449 4f4e 2720 496e 2074 6869 FICATION' In thi │ │ │ │ -00013df0: 7320 6361 7365 2076 6572 6966 6963 6174 s case verificat │ │ │ │ -00013e00: 696f 6e20 6973 0a20 2020 2020 646f 6e65 ion is. done │ │ │ │ -00013e10: 2061 7320 6465 7363 7269 6265 6420 696e as described in │ │ │ │ -00013e20: 2074 6865 2066 6f6c 6c6f 7769 6e67 2073 the following s │ │ │ │ -00013e30: 6563 7469 6f6e 2e0a 0a20 2020 2a20 7265 ection... * re │ │ │ │ -00013e40: 7475 726e 696e 6720 616e 2065 7272 6f72 turning an error │ │ │ │ -00013e50: 2e20 2054 6865 6e20 6f70 656e 696e 6720 . Then opening │ │ │ │ -00013e60: 6f66 2074 6865 2066 696c 6520 7769 6c6c of the file will │ │ │ │ -00013e70: 2066 6169 6c20 6475 6520 746f 0a20 2020 fail due to. │ │ │ │ -00013e80: 2020 6661 696c 6564 2076 6572 6966 6963 failed verific │ │ │ │ -00013e90: 6174 696f 6e2e 0a0a 2020 2049 6e20 7468 ation... In th │ │ │ │ -00013ea0: 6520 7468 6972 6420 6361 7365 2079 6f75 e third case you │ │ │ │ -00013eb0: 7220 2777 7269 7465 2720 7769 6c6c 2062 r 'write' will b │ │ │ │ -00013ec0: 6520 6361 6c6c 6564 2077 6974 6820 6368 e called with ch │ │ │ │ -00013ed0: 756e 6b73 206f 6620 7468 650a 6669 6c65 unks of the.file │ │ │ │ -00013ee0: 2e20 2049 6620 796f 7520 6e65 6564 2074 . If you need t │ │ │ │ -00013ef0: 6865 2077 686f 6c65 2066 696c 6520 696e he whole file in │ │ │ │ -00013f00: 2061 2073 696e 676c 6520 6368 756e 6b20 a single chunk │ │ │ │ -00013f10: 7468 656e 2064 7572 696e 6720 2769 6e69 then during 'ini │ │ │ │ -00013f20: 7427 0a73 6574 2074 6865 2062 6974 2027 t'.set the bit ' │ │ │ │ -00013f30: 4752 5542 5f56 4552 4946 595f 464c 4147 GRUB_VERIFY_FLAG │ │ │ │ -00013f40: 535f 5349 4e47 4c45 5f43 4855 4e4b 2720 S_SINGLE_CHUNK' │ │ │ │ -00013f50: 696e 2027 2a66 6c61 6773 272e 2020 4475 in '*flags'. Du │ │ │ │ -00013f60: 7269 6e67 2027 696e 6974 270a 796f 7520 ring 'init'.you │ │ │ │ -00013f70: 6d61 7920 7365 7420 272a 636f 6e74 6578 may set '*contex │ │ │ │ -00013f80: 7427 2069 6620 796f 7520 6e65 6564 2061 t' if you need a │ │ │ │ -00013f90: 6464 6974 696f 6e61 6c20 636f 6e74 6578 dditional contex │ │ │ │ -00013fa0: 742e 2020 4174 2065 7665 7279 0a69 7465 t. At every.ite │ │ │ │ -00013fb0: 7261 7469 6f6e 2079 6f75 206d 6179 2072 ration you may r │ │ │ │ -00013fc0: 6574 7572 6e20 616e 2065 7272 6f72 2061 eturn an error a │ │ │ │ -00013fd0: 6e64 2074 6865 2066 696c 6520 7769 6c6c nd the file will │ │ │ │ -00013fe0: 2062 6520 636f 6e73 6964 6572 6564 2061 be considered a │ │ │ │ -00013ff0: 730a 6861 7669 6e67 2066 6169 6c65 6420 s.having failed │ │ │ │ -00014000: 7468 6520 7665 7269 6669 6361 7469 6f6e the verification │ │ │ │ -00014010: 2e20 2049 6620 796f 7520 7265 7475 726e . If you return │ │ │ │ -00014020: 206e 6f20 6572 726f 7220 7468 656e 0a76 no error then.v │ │ │ │ -00014030: 6572 6966 6963 6174 696f 6e20 636f 6e74 erification cont │ │ │ │ -00014040: 696e 7565 732e 0a0a 2020 204f 7074 696f inues... Optio │ │ │ │ -00014050: 6e61 6c6c 7920 6174 2074 6865 2065 6e64 nally at the end │ │ │ │ -00014060: 206f 6620 7468 6520 6669 6c65 2027 6669 of the file 'fi │ │ │ │ -00014070: 6e69 272c 2069 6620 6974 2065 7869 7374 ni', if it exist │ │ │ │ -00014080: 732c 2069 7320 6361 6c6c 6564 0a77 6974 s, is called.wit │ │ │ │ -00014090: 6820 6a75 7374 2074 6865 2063 6f6e 7465 h just the conte │ │ │ │ -000140a0: 7874 2e20 2049 6620 796f 7520 7265 7475 xt. If you retu │ │ │ │ -000140b0: 726e 206e 6f20 6572 726f 7220 6475 7269 rn no error duri │ │ │ │ -000140c0: 6e67 2061 6e79 206f 6620 2769 6e69 7427 ng any of 'init' │ │ │ │ -000140d0: 2c0a 2777 7269 7465 2720 616e 6420 2766 ,.'write' and 'f │ │ │ │ -000140e0: 696e 6927 2074 6865 6e20 7468 6520 6669 ini' then the fi │ │ │ │ -000140f0: 6c65 2069 7320 636f 6e73 6964 6572 6564 le is considered │ │ │ │ -00014100: 2061 7320 6861 7669 6e67 2073 7563 6365 as having succe │ │ │ │ -00014110: 6465 640a 7665 7269 6669 6361 7469 6f6e ded.verification │ │ │ │ -00014120: 2e0a 0a1f 0a46 696c 653a 2067 7275 622d .....File: grub- │ │ │ │ -00014130: 6465 762e 696e 666f 2c20 204e 6f64 653a dev.info, Node: │ │ │ │ -00014140: 204c 6f63 6b64 6f77 6e20 6672 616d 6577 Lockdown framew │ │ │ │ -00014150: 6f72 6b2c 2020 4e65 7874 3a20 436f 7079 ork, Next: Copy │ │ │ │ -00014160: 696e 6720 5468 6973 204d 616e 7561 6c2c ing This Manual, │ │ │ │ -00014170: 2020 5072 6576 3a20 5665 7269 6669 6572 Prev: Verifier │ │ │ │ -00014180: 7320 6672 616d 6577 6f72 6b2c 2020 5570 s framework, Up │ │ │ │ -00014190: 3a20 546f 700a 0a31 3420 4c6f 636b 646f : Top..14 Lockdo │ │ │ │ -000141a0: 776e 2066 7261 6d65 776f 726b 0a2a 2a2a wn framework.*** │ │ │ │ -000141b0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ -000141c0: 2a2a 0a0a 5468 6520 4752 5542 2063 616e **..The GRUB can │ │ │ │ -000141d0: 2062 6520 6c6f 636b 6564 2064 6f77 6e2c be locked down, │ │ │ │ -000141e0: 2077 6869 6368 2069 7320 6120 7265 7374 which is a rest │ │ │ │ -000141f0: 7269 6374 6564 206d 6f64 6520 7768 6572 ricted mode wher │ │ │ │ -00014200: 6520 736f 6d65 0a6f 7065 7261 7469 6f6e e some.operation │ │ │ │ -00014210: 7320 6172 6520 6e6f 7420 616c 6c6f 7765 s are not allowe │ │ │ │ -00014220: 642e 2020 466f 7220 696e 7374 616e 6365 d. For instance │ │ │ │ -00014230: 2c20 736f 6d65 2063 6f6d 6d61 6e64 7320 , some commands │ │ │ │ -00014240: 6361 6e6e 6f74 2062 6520 7573 6564 0a77 cannot be used.w │ │ │ │ -00014250: 6865 6e20 7468 6520 4752 5542 2069 7320 hen the GRUB is │ │ │ │ -00014260: 6c6f 636b 6564 2064 6f77 6e2e 0a0a 2020 locked down... │ │ │ │ -00014270: 2054 6865 2066 756e 6374 696f 6e20 2767 The function 'g │ │ │ │ -00014280: 7275 625f 6c6f 636b 646f 776e 2829 2720 rub_lockdown()' │ │ │ │ -00014290: 6973 2075 7365 6420 746f 206c 6f63 6b64 is used to lockd │ │ │ │ -000142a0: 6f77 6e20 4752 5542 2061 6e64 2074 6865 own GRUB and the │ │ │ │ -000142b0: 0a66 756e 6374 696f 6e20 2767 7275 625f .function 'grub_ │ │ │ │ -000142c0: 6973 5f6c 6f63 6b64 6f77 6e28 2927 2066 is_lockdown()' f │ │ │ │ -000142d0: 756e 6374 696f 6e20 6361 6e20 6265 2075 unction can be u │ │ │ │ -000142e0: 7365 6420 746f 2063 6865 636b 2077 6865 sed to check whe │ │ │ │ -000142f0: 7468 6572 0a6c 6f63 6b64 6f77 6e20 6973 ther.lockdown is │ │ │ │ -00014300: 2065 6e61 626c 6564 206f 7220 6e6f 742e enabled or not. │ │ │ │ -00014310: 2020 5768 656e 2065 6e61 626c 6564 2c20 When enabled, │ │ │ │ -00014320: 7468 6520 6675 6e63 7469 6f6e 2072 6574 the function ret │ │ │ │ -00014330: 7572 6e73 0a27 4752 5542 5f4c 4f43 4b44 urns.'GRUB_LOCKD │ │ │ │ -00014340: 4f57 4e5f 454e 4142 4c45 4427 2061 6e64 OWN_ENABLED' and │ │ │ │ -00014350: 2027 4752 5542 5f4c 4f43 4b44 4f57 4e5f 'GRUB_LOCKDOWN_ │ │ │ │ -00014360: 4449 5341 424c 4544 2720 7768 656e 2069 DISABLED' when i │ │ │ │ -00014370: 7320 6e6f 740a 656e 6162 6c65 642e 0a0a s not.enabled... │ │ │ │ -00014380: 2020 2054 6865 2066 6f6c 6c6f 7769 6e67 The following │ │ │ │ -00014390: 2066 756e 6374 696f 6e73 2063 616e 2062 functions can b │ │ │ │ -000143a0: 6520 7573 6564 2074 6f20 7265 6769 7374 e used to regist │ │ │ │ -000143b0: 6572 2074 6865 2063 6f6d 6d61 6e64 7320 er the commands │ │ │ │ -000143c0: 7468 6174 2063 616e 0a6f 6e6c 7920 6265 that can.only be │ │ │ │ -000143d0: 2075 7365 6420 7768 656e 206c 6f63 6b64 used when lockd │ │ │ │ -000143e0: 6f77 6e20 6973 2064 6973 6162 6c65 643a own is disabled: │ │ │ │ -000143f0: 0a0a 2020 202a 2027 6772 7562 5f63 6d64 .. * 'grub_cmd │ │ │ │ -00014400: 5f6c 6f63 6b64 6f77 6e28 2927 2072 6567 _lockdown()' reg │ │ │ │ -00014410: 6973 7465 7273 2063 6f6d 6d61 6e64 2077 isters command w │ │ │ │ -00014420: 6869 6368 2073 686f 756c 6420 6e6f 7420 hich should not │ │ │ │ -00014430: 7275 6e20 7768 656e 0a20 2020 2020 7468 run when. th │ │ │ │ -00014440: 6520 4752 5542 2069 7320 696e 206c 6f63 e GRUB is in loc │ │ │ │ -00014450: 6b64 6f77 6e20 6d6f 6465 2e0a 0a20 2020 kdown mode... │ │ │ │ -00014460: 2a20 2767 7275 625f 636d 645f 6c6f 636b * 'grub_cmd_lock │ │ │ │ -00014470: 646f 776e 2829 2720 7265 6769 7374 6572 down()' register │ │ │ │ -00014480: 7320 6578 7465 6e64 6564 2063 6f6d 6d61 s extended comma │ │ │ │ -00014490: 6e64 2077 6869 6368 2073 686f 756c 6420 nd which should │ │ │ │ -000144a0: 6e6f 740a 2020 2020 2072 756e 2077 6865 not. run whe │ │ │ │ -000144b0: 6e20 7468 6520 4752 5542 2069 7320 696e n the GRUB is in │ │ │ │ -000144c0: 206c 6f63 6b64 6f77 6e20 6d6f 6465 2e0a lockdown mode.. │ │ │ │ -000144d0: 0a1f 0a46 696c 653a 2067 7275 622d 6465 ...File: grub-de │ │ │ │ -000144e0: 762e 696e 666f 2c20 204e 6f64 653a 2043 v.info, Node: C │ │ │ │ -000144f0: 6f70 7969 6e67 2054 6869 7320 4d61 6e75 opying This Manu │ │ │ │ -00014500: 616c 2c20 204e 6578 743a 2049 6e64 6578 al, Next: Index │ │ │ │ -00014510: 2c20 2050 7265 763a 204c 6f63 6b64 6f77 , Prev: Lockdow │ │ │ │ -00014520: 6e20 6672 616d 6577 6f72 6b2c 2020 5570 n framework, Up │ │ │ │ -00014530: 3a20 546f 700a 0a41 7070 656e 6469 7820 : Top..Appendix │ │ │ │ -00014540: 4120 436f 7079 696e 6720 5468 6973 204d A Copying This M │ │ │ │ -00014550: 616e 7561 6c0a 2a2a 2a2a 2a2a 2a2a 2a2a anual.********** │ │ │ │ +000137a0: 2a2a 2a2a 0a0a 546f 2072 6567 6973 7465 ****..To registe │ │ │ │ +000137b0: 7220 796f 7572 206f 776e 2076 6572 6966 r your own verif │ │ │ │ +000137c0: 6965 7220 6361 6c6c 2027 6772 7562 5f76 ier call 'grub_v │ │ │ │ +000137d0: 6572 6966 6965 725f 7265 6769 7374 6572 erifier_register │ │ │ │ +000137e0: 2720 7769 7468 2061 0a73 7472 7563 7475 ' with a.structu │ │ │ │ +000137f0: 7265 2070 6f69 6e74 696e 6720 746f 2079 re pointing to y │ │ │ │ +00013800: 6f75 7220 6675 6e63 7469 6f6e 732e 0a0a our functions... │ │ │ │ +00013810: 2020 2054 6865 2069 6e74 6572 6661 6365 The interface │ │ │ │ +00013820: 2069 7320 696e 7370 6972 6564 2062 7920 is inspired by │ │ │ │ +00013830: 7468 6520 6861 7368 2069 6e74 6572 6661 the hash interfa │ │ │ │ +00013840: 6365 2077 6974 680a 2769 6e69 7427 2f27 ce with.'init'/' │ │ │ │ +00013850: 7772 6974 6527 2f27 6669 6e69 272e 0a0a write'/'fini'... │ │ │ │ +00013860: 2020 2054 6865 7265 2061 7265 2065 7373 There are ess │ │ │ │ +00013870: 656e 7469 616c 6c79 2032 2077 6179 7320 entially 2 ways │ │ │ │ +00013880: 6f66 2075 7369 6e67 2069 742c 2068 6173 of using it, has │ │ │ │ +00013890: 6869 6e67 2061 6e64 2077 686f 6c65 2d66 hing and whole-f │ │ │ │ +000138a0: 696c 650a 7665 7269 6669 6361 7469 6f6e ile.verification │ │ │ │ +000138b0: 2e0a 0a20 2020 5769 7468 2074 6865 2068 ... With the h │ │ │ │ +000138c0: 6173 6869 6e67 2061 7070 726f 6163 683a ashing approach: │ │ │ │ +000138d0: 2044 7572 696e 6720 2769 6e69 7427 2079 During 'init' y │ │ │ │ +000138e0: 6f75 2064 6563 6964 6520 7768 6574 6865 ou decide whethe │ │ │ │ +000138f0: 7220 796f 7520 7761 6e74 0a74 6f20 6368 r you want.to ch │ │ │ │ +00013900: 6563 6b20 7468 6520 6769 7665 6e20 6669 eck the given fi │ │ │ │ +00013910: 6c65 2061 6e64 2069 6e69 7420 636f 6e74 le and init cont │ │ │ │ +00013920: 6578 742e 2020 496e 2027 7772 6974 6527 ext. In 'write' │ │ │ │ +00013930: 2079 6f75 2075 7064 6174 6520 796f 7572 you update your │ │ │ │ +00013940: 0a68 6173 6869 6e67 2073 7461 7465 2e20 .hashing state. │ │ │ │ +00013950: 2049 6e20 2766 696e 6927 2079 6f75 2063 In 'fini' you c │ │ │ │ +00013960: 6865 636b 2074 6861 7420 7468 6520 6861 heck that the ha │ │ │ │ +00013970: 7368 206d 6174 6368 6573 2074 6865 2065 sh matches the e │ │ │ │ +00013980: 7870 6563 7465 640a 7661 6c75 652f 7061 xpected.value/pa │ │ │ │ +00013990: 7373 6573 2073 6f6d 6520 6368 6563 6b2f sses some check/ │ │ │ │ +000139a0: 2e2e 2e0a 0a20 2020 5769 7468 2077 686f ..... With who │ │ │ │ +000139b0: 6c65 2d66 696c 6520 7665 7269 6669 6361 le-file verifica │ │ │ │ +000139c0: 7469 6f6e 3a20 4475 7269 6e67 2027 696e tion: During 'in │ │ │ │ +000139d0: 6974 2720 796f 7520 6465 6369 6465 2077 it' you decide w │ │ │ │ +000139e0: 6865 7468 6572 2079 6f75 0a77 616e 7420 hether you.want │ │ │ │ +000139f0: 746f 2063 6865 636b 2074 6865 2067 6976 to check the giv │ │ │ │ +00013a00: 656e 2066 696c 6520 616e 6420 696e 6974 en file and init │ │ │ │ +00013a10: 2063 6f6e 7465 7874 2e20 2049 6e20 2777 context. In 'w │ │ │ │ +00013a20: 7269 7465 2720 796f 7520 7665 7269 6679 rite' you verify │ │ │ │ +00013a30: 0a74 6865 2066 696c 6520 616e 6420 7265 .the file and re │ │ │ │ +00013a40: 7475 726e 2061 6e20 6572 726f 7220 6966 turn an error if │ │ │ │ +00013a50: 2069 7420 6661 696c 732e 2020 596f 7520 it fails. You │ │ │ │ +00013a60: 646f 6e27 7420 6861 7665 2027 6669 6e69 don't have 'fini │ │ │ │ +00013a70: 272e 0a0a 2020 2041 6464 6974 696f 6e61 '... Additiona │ │ │ │ +00013a80: 6c20 2776 6572 6966 795f 7374 7269 6e67 l 'verify_string │ │ │ │ +00013a90: 2720 7265 6365 6976 6573 2076 6172 696f ' receives vario │ │ │ │ +00013aa0: 7573 2073 7472 696e 6773 206c 696b 6520 us strings like │ │ │ │ +00013ab0: 6b65 726e 656c 0a70 6172 616d 6574 6572 kernel.parameter │ │ │ │ +00013ac0: 7320 746f 2076 6572 6966 792e 2020 5265 s to verify. Re │ │ │ │ +00013ad0: 7475 726e 696e 6720 6e6f 2065 7272 6f72 turning no error │ │ │ │ +00013ae0: 206d 6561 6e73 2073 7563 6365 7373 6675 means successfu │ │ │ │ +00013af0: 6c20 7665 7269 6669 6361 7469 6f6e 0a61 l verification.a │ │ │ │ +00013b00: 6e64 2061 6e20 6572 726f 7220 7374 6f70 nd an error stop │ │ │ │ +00013b10: 7320 7468 6520 6375 7272 656e 7420 6163 s the current ac │ │ │ │ +00013b20: 7469 6f6e 2e0a 0a20 2020 4465 7461 696c tion... Detail │ │ │ │ +00013b30: 6564 2064 6573 6372 6970 7469 6f6e 206f ed description o │ │ │ │ +00013b40: 6620 7468 6520 4150 493a 0a0a 2020 2045 f the API:.. E │ │ │ │ +00013b50: 7665 7279 2074 696d 6520 6120 6669 6c65 very time a file │ │ │ │ +00013b60: 2069 7320 6f70 656e 6564 2079 6f75 7220 is opened your │ │ │ │ +00013b70: 2769 6e69 7427 2066 756e 6374 696f 6e20 'init' function │ │ │ │ +00013b80: 6973 2063 616c 6c65 6420 7769 7468 2066 is called with f │ │ │ │ +00013b90: 696c 650a 6465 7363 7269 7074 6f72 2061 ile.descriptor a │ │ │ │ +00013ba0: 6e64 2066 696c 6520 7479 7065 2e20 2059 nd file type. Y │ │ │ │ +00013bb0: 6f75 7220 6675 6e63 7469 6f6e 2063 616e our function can │ │ │ │ +00013bc0: 2068 6176 6520 7468 6520 666f 6c6c 6f77 have the follow │ │ │ │ +00013bd0: 696e 670a 6f75 7463 6f6d 6573 3a0a 0a20 ing.outcomes:.. │ │ │ │ +00013be0: 2020 2a20 7265 7475 726e 696e 6720 6e6f * returning no │ │ │ │ +00013bf0: 2065 7272 6f72 2061 6e64 2073 6574 7469 error and setti │ │ │ │ +00013c00: 6e67 2027 2a66 6c61 6773 2720 746f 0a20 ng '*flags' to. │ │ │ │ +00013c10: 2020 2020 2747 5255 425f 5645 5249 4659 'GRUB_VERIFY │ │ │ │ +00013c20: 5f46 4c41 4753 5f44 4546 4552 5f41 5554 _FLAGS_DEFER_AUT │ │ │ │ +00013c30: 4827 2e20 2049 6e20 7468 6973 2063 6173 H'. In this cas │ │ │ │ +00013c40: 6520 7665 7269 6669 6361 7469 6f6e 2069 e verification i │ │ │ │ +00013c50: 730a 2020 2020 2064 6566 6572 7265 6420 s. deferred │ │ │ │ +00013c60: 746f 206f 7468 6572 2061 6374 6976 6520 to other active │ │ │ │ +00013c70: 7665 7269 6669 6572 732e 2020 5665 7269 verifiers. Veri │ │ │ │ +00013c80: 6669 6361 7469 6f6e 2066 6169 6c73 2069 fication fails i │ │ │ │ +00013c90: 6620 6e6f 626f 6479 0a20 2020 2020 6361 f nobody. ca │ │ │ │ +00013ca0: 7265 7320 6f72 2073 656c 6563 7465 6420 res or selected │ │ │ │ +00013cb0: 7665 7269 6669 6572 2066 6169 6c73 2e0a verifier fails.. │ │ │ │ +00013cc0: 0a20 2020 2a20 7265 7475 726e 696e 6720 . * returning │ │ │ │ +00013cd0: 6e6f 2065 7272 6f72 2061 6e64 2073 6574 no error and set │ │ │ │ +00013ce0: 7469 6e67 2027 2a66 6c61 6773 2720 746f ting '*flags' to │ │ │ │ +00013cf0: 0a20 2020 2020 2747 5255 425f 5645 5249 . 'GRUB_VERI │ │ │ │ +00013d00: 4659 5f46 4c41 4753 5f53 4b49 505f 5645 FY_FLAGS_SKIP_VE │ │ │ │ +00013d10: 5249 4649 4341 5449 4f4e 272e 2020 496e RIFICATION'. In │ │ │ │ +00013d20: 2074 6869 7320 6361 7365 2079 6f75 7220 this case your │ │ │ │ +00013d30: 7665 7269 6669 6572 0a20 2020 2020 7769 verifier. wi │ │ │ │ +00013d40: 6c6c 206e 6f74 2062 6520 6361 6c6c 6564 ll not be called │ │ │ │ +00013d50: 2061 6e79 6d6f 7265 2061 6e64 2069 7420 anymore and it │ │ │ │ +00013d60: 6973 2061 7373 756d 6564 2074 6f20 6861 is assumed to ha │ │ │ │ +00013d70: 7665 2073 6b69 7070 6564 0a20 2020 2020 ve skipped. │ │ │ │ +00013d80: 7665 7269 6669 6361 7469 6f6e 2e0a 0a20 verification... │ │ │ │ +00013d90: 2020 2a20 7265 7475 726e 696e 6720 6e6f * returning no │ │ │ │ +00013da0: 2065 7272 6f72 2061 6e64 206e 6f74 2073 error and not s │ │ │ │ +00013db0: 6574 7469 6e67 2027 2a66 6c61 6773 2720 etting '*flags' │ │ │ │ +00013dc0: 746f 0a20 2020 2020 2747 5255 425f 5645 to. 'GRUB_VE │ │ │ │ +00013dd0: 5249 4659 5f46 4c41 4753 5f53 4b49 505f RIFY_FLAGS_SKIP_ │ │ │ │ +00013de0: 5645 5249 4649 4341 5449 4f4e 2720 496e VERIFICATION' In │ │ │ │ +00013df0: 2074 6869 7320 6361 7365 2076 6572 6966 this case verif │ │ │ │ +00013e00: 6963 6174 696f 6e20 6973 0a20 2020 2020 ication is. │ │ │ │ +00013e10: 646f 6e65 2061 7320 6465 7363 7269 6265 done as describe │ │ │ │ +00013e20: 6420 696e 2074 6865 2066 6f6c 6c6f 7769 d in the followi │ │ │ │ +00013e30: 6e67 2073 6563 7469 6f6e 2e0a 0a20 2020 ng section... │ │ │ │ +00013e40: 2a20 7265 7475 726e 696e 6720 616e 2065 * returning an e │ │ │ │ +00013e50: 7272 6f72 2e20 2054 6865 6e20 6f70 656e rror. Then open │ │ │ │ +00013e60: 696e 6720 6f66 2074 6865 2066 696c 6520 ing of the file │ │ │ │ +00013e70: 7769 6c6c 2066 6169 6c20 6475 6520 746f will fail due to │ │ │ │ +00013e80: 0a20 2020 2020 6661 696c 6564 2076 6572 . failed ver │ │ │ │ +00013e90: 6966 6963 6174 696f 6e2e 0a0a 2020 2049 ification... I │ │ │ │ +00013ea0: 6e20 7468 6520 7468 6972 6420 6361 7365 n the third case │ │ │ │ +00013eb0: 2079 6f75 7220 2777 7269 7465 2720 7769 your 'write' wi │ │ │ │ +00013ec0: 6c6c 2062 6520 6361 6c6c 6564 2077 6974 ll be called wit │ │ │ │ +00013ed0: 6820 6368 756e 6b73 206f 6620 7468 650a h chunks of the. │ │ │ │ +00013ee0: 6669 6c65 2e20 2049 6620 796f 7520 6e65 file. If you ne │ │ │ │ +00013ef0: 6564 2074 6865 2077 686f 6c65 2066 696c ed the whole fil │ │ │ │ +00013f00: 6520 696e 2061 2073 696e 676c 6520 6368 e in a single ch │ │ │ │ +00013f10: 756e 6b20 7468 656e 2064 7572 696e 6720 unk then during │ │ │ │ +00013f20: 2769 6e69 7427 0a73 6574 2074 6865 2062 'init'.set the b │ │ │ │ +00013f30: 6974 2027 4752 5542 5f56 4552 4946 595f it 'GRUB_VERIFY_ │ │ │ │ +00013f40: 464c 4147 535f 5349 4e47 4c45 5f43 4855 FLAGS_SINGLE_CHU │ │ │ │ +00013f50: 4e4b 2720 696e 2027 2a66 6c61 6773 272e NK' in '*flags'. │ │ │ │ +00013f60: 2020 4475 7269 6e67 2027 696e 6974 270a During 'init'. │ │ │ │ +00013f70: 796f 7520 6d61 7920 7365 7420 272a 636f you may set '*co │ │ │ │ +00013f80: 6e74 6578 7427 2069 6620 796f 7520 6e65 ntext' if you ne │ │ │ │ +00013f90: 6564 2061 6464 6974 696f 6e61 6c20 636f ed additional co │ │ │ │ +00013fa0: 6e74 6578 742e 2020 4174 2065 7665 7279 ntext. At every │ │ │ │ +00013fb0: 0a69 7465 7261 7469 6f6e 2079 6f75 206d .iteration you m │ │ │ │ +00013fc0: 6179 2072 6574 7572 6e20 616e 2065 7272 ay return an err │ │ │ │ +00013fd0: 6f72 2061 6e64 2074 6865 2066 696c 6520 or and the file │ │ │ │ +00013fe0: 7769 6c6c 2062 6520 636f 6e73 6964 6572 will be consider │ │ │ │ +00013ff0: 6564 2061 730a 6861 7669 6e67 2066 6169 ed as.having fai │ │ │ │ +00014000: 6c65 6420 7468 6520 7665 7269 6669 6361 led the verifica │ │ │ │ +00014010: 7469 6f6e 2e20 2049 6620 796f 7520 7265 tion. If you re │ │ │ │ +00014020: 7475 726e 206e 6f20 6572 726f 7220 7468 turn no error th │ │ │ │ +00014030: 656e 0a76 6572 6966 6963 6174 696f 6e20 en.verification │ │ │ │ +00014040: 636f 6e74 696e 7565 732e 0a0a 2020 204f continues... O │ │ │ │ +00014050: 7074 696f 6e61 6c6c 7920 6174 2074 6865 ptionally at the │ │ │ │ +00014060: 2065 6e64 206f 6620 7468 6520 6669 6c65 end of the file │ │ │ │ +00014070: 2027 6669 6e69 272c 2069 6620 6974 2065 'fini', if it e │ │ │ │ +00014080: 7869 7374 732c 2069 7320 6361 6c6c 6564 xists, is called │ │ │ │ +00014090: 0a77 6974 6820 6a75 7374 2074 6865 2063 .with just the c │ │ │ │ +000140a0: 6f6e 7465 7874 2e20 2049 6620 796f 7520 ontext. If you │ │ │ │ +000140b0: 7265 7475 726e 206e 6f20 6572 726f 7220 return no error │ │ │ │ +000140c0: 6475 7269 6e67 2061 6e79 206f 6620 2769 during any of 'i │ │ │ │ +000140d0: 6e69 7427 2c0a 2777 7269 7465 2720 616e nit',.'write' an │ │ │ │ +000140e0: 6420 2766 696e 6927 2074 6865 6e20 7468 d 'fini' then th │ │ │ │ +000140f0: 6520 6669 6c65 2069 7320 636f 6e73 6964 e file is consid │ │ │ │ +00014100: 6572 6564 2061 7320 6861 7669 6e67 2073 ered as having s │ │ │ │ +00014110: 7563 6365 6465 640a 7665 7269 6669 6361 ucceded.verifica │ │ │ │ +00014120: 7469 6f6e 2e0a 0a1f 0a46 696c 653a 2067 tion.....File: g │ │ │ │ +00014130: 7275 622d 6465 762e 696e 666f 2c20 204e rub-dev.info, N │ │ │ │ +00014140: 6f64 653a 204c 6f63 6b64 6f77 6e20 6672 ode: Lockdown fr │ │ │ │ +00014150: 616d 6577 6f72 6b2c 2020 4e65 7874 3a20 amework, Next: │ │ │ │ +00014160: 436f 7079 696e 6720 5468 6973 204d 616e Copying This Man │ │ │ │ +00014170: 7561 6c2c 2020 5072 6576 3a20 5665 7269 ual, Prev: Veri │ │ │ │ +00014180: 6669 6572 7320 6672 616d 6577 6f72 6b2c fiers framework, │ │ │ │ +00014190: 2020 5570 3a20 546f 700a 0a31 3420 4c6f Up: Top..14 Lo │ │ │ │ +000141a0: 636b 646f 776e 2066 7261 6d65 776f 726b ckdown framework │ │ │ │ +000141b0: 0a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a .*************** │ │ │ │ +000141c0: 2a2a 2a2a 2a2a 0a0a 5468 6520 4752 5542 ******..The GRUB │ │ │ │ +000141d0: 2063 616e 2062 6520 6c6f 636b 6564 2064 can be locked d │ │ │ │ +000141e0: 6f77 6e2c 2077 6869 6368 2069 7320 6120 own, which is a │ │ │ │ +000141f0: 7265 7374 7269 6374 6564 206d 6f64 6520 restricted mode │ │ │ │ +00014200: 7768 6572 6520 736f 6d65 0a6f 7065 7261 where some.opera │ │ │ │ +00014210: 7469 6f6e 7320 6172 6520 6e6f 7420 616c tions are not al │ │ │ │ +00014220: 6c6f 7765 642e 2020 466f 7220 696e 7374 lowed. For inst │ │ │ │ +00014230: 616e 6365 2c20 736f 6d65 2063 6f6d 6d61 ance, some comma │ │ │ │ +00014240: 6e64 7320 6361 6e6e 6f74 2062 6520 7573 nds cannot be us │ │ │ │ +00014250: 6564 0a77 6865 6e20 7468 6520 4752 5542 ed.when the GRUB │ │ │ │ +00014260: 2069 7320 6c6f 636b 6564 2064 6f77 6e2e is locked down. │ │ │ │ +00014270: 0a0a 2020 2054 6865 2066 756e 6374 696f .. The functio │ │ │ │ +00014280: 6e20 2767 7275 625f 6c6f 636b 646f 776e n 'grub_lockdown │ │ │ │ +00014290: 2829 2720 6973 2075 7365 6420 746f 206c ()' is used to l │ │ │ │ +000142a0: 6f63 6b64 6f77 6e20 4752 5542 2061 6e64 ockdown GRUB and │ │ │ │ +000142b0: 2074 6865 0a66 756e 6374 696f 6e20 2767 the.function 'g │ │ │ │ +000142c0: 7275 625f 6973 5f6c 6f63 6b64 6f77 6e28 rub_is_lockdown( │ │ │ │ +000142d0: 2927 2066 756e 6374 696f 6e20 6361 6e20 )' function can │ │ │ │ +000142e0: 6265 2075 7365 6420 746f 2063 6865 636b be used to check │ │ │ │ +000142f0: 2077 6865 7468 6572 0a6c 6f63 6b64 6f77 whether.lockdow │ │ │ │ +00014300: 6e20 6973 2065 6e61 626c 6564 206f 7220 n is enabled or │ │ │ │ +00014310: 6e6f 742e 2020 5768 656e 2065 6e61 626c not. When enabl │ │ │ │ +00014320: 6564 2c20 7468 6520 6675 6e63 7469 6f6e ed, the function │ │ │ │ +00014330: 2072 6574 7572 6e73 0a27 4752 5542 5f4c returns.'GRUB_L │ │ │ │ +00014340: 4f43 4b44 4f57 4e5f 454e 4142 4c45 4427 OCKDOWN_ENABLED' │ │ │ │ +00014350: 2061 6e64 2027 4752 5542 5f4c 4f43 4b44 and 'GRUB_LOCKD │ │ │ │ +00014360: 4f57 4e5f 4449 5341 424c 4544 2720 7768 OWN_DISABLED' wh │ │ │ │ +00014370: 656e 2069 7320 6e6f 740a 656e 6162 6c65 en is not.enable │ │ │ │ +00014380: 642e 0a0a 2020 2054 6865 2066 6f6c 6c6f d... The follo │ │ │ │ +00014390: 7769 6e67 2066 756e 6374 696f 6e73 2063 wing functions c │ │ │ │ +000143a0: 616e 2062 6520 7573 6564 2074 6f20 7265 an be used to re │ │ │ │ +000143b0: 6769 7374 6572 2074 6865 2063 6f6d 6d61 gister the comma │ │ │ │ +000143c0: 6e64 7320 7468 6174 2063 616e 0a6f 6e6c nds that can.onl │ │ │ │ +000143d0: 7920 6265 2075 7365 6420 7768 656e 206c y be used when l │ │ │ │ +000143e0: 6f63 6b64 6f77 6e20 6973 2064 6973 6162 ockdown is disab │ │ │ │ +000143f0: 6c65 643a 0a0a 2020 202a 2027 6772 7562 led:.. * 'grub │ │ │ │ +00014400: 5f63 6d64 5f6c 6f63 6b64 6f77 6e28 2927 _cmd_lockdown()' │ │ │ │ +00014410: 2072 6567 6973 7465 7273 2063 6f6d 6d61 registers comma │ │ │ │ +00014420: 6e64 2077 6869 6368 2073 686f 756c 6420 nd which should │ │ │ │ +00014430: 6e6f 7420 7275 6e20 7768 656e 0a20 2020 not run when. │ │ │ │ +00014440: 2020 7468 6520 4752 5542 2069 7320 696e the GRUB is in │ │ │ │ +00014450: 206c 6f63 6b64 6f77 6e20 6d6f 6465 2e0a lockdown mode.. │ │ │ │ +00014460: 0a20 2020 2a20 2767 7275 625f 636d 645f . * 'grub_cmd_ │ │ │ │ +00014470: 6c6f 636b 646f 776e 2829 2720 7265 6769 lockdown()' regi │ │ │ │ +00014480: 7374 6572 7320 6578 7465 6e64 6564 2063 sters extended c │ │ │ │ +00014490: 6f6d 6d61 6e64 2077 6869 6368 2073 686f ommand which sho │ │ │ │ +000144a0: 756c 6420 6e6f 740a 2020 2020 2072 756e uld not. run │ │ │ │ +000144b0: 2077 6865 6e20 7468 6520 4752 5542 2069 when the GRUB i │ │ │ │ +000144c0: 7320 696e 206c 6f63 6b64 6f77 6e20 6d6f s in lockdown mo │ │ │ │ +000144d0: 6465 2e0a 0a1f 0a46 696c 653a 2067 7275 de.....File: gru │ │ │ │ +000144e0: 622d 6465 762e 696e 666f 2c20 204e 6f64 b-dev.info, Nod │ │ │ │ +000144f0: 653a 2043 6f70 7969 6e67 2054 6869 7320 e: Copying This │ │ │ │ +00014500: 4d61 6e75 616c 2c20 204e 6578 743a 2049 Manual, Next: I │ │ │ │ +00014510: 6e64 6578 2c20 2050 7265 763a 204c 6f63 ndex, Prev: Loc │ │ │ │ +00014520: 6b64 6f77 6e20 6672 616d 6577 6f72 6b2c kdown framework, │ │ │ │ +00014530: 2020 5570 3a20 546f 700a 0a41 7070 656e Up: Top..Appen │ │ │ │ +00014540: 6469 7820 4120 436f 7079 696e 6720 5468 dix A Copying Th │ │ │ │ +00014550: 6973 204d 616e 7561 6c0a 2a2a 2a2a 2a2a is Manual.****** │ │ │ │ 00014560: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ -00014570: 2a2a 2a2a 0a0a 2a20 4d65 6e75 3a0a 0a2a ****..* Menu:..* │ │ │ │ -00014580: 2047 4e55 2046 7265 6520 446f 6375 6d65 GNU Free Docume │ │ │ │ -00014590: 6e74 6174 696f 6e20 4c69 6365 6e73 653a ntation License: │ │ │ │ -000145a0: 3a20 204c 6963 656e 7365 2066 6f72 2063 : License for c │ │ │ │ -000145b0: 6f70 7969 6e67 2074 6869 7320 6d61 6e75 opying this manu │ │ │ │ -000145c0: 616c 2e0a 0a1f 0a46 696c 653a 2067 7275 al.....File: gru │ │ │ │ -000145d0: 622d 6465 762e 696e 666f 2c20 204e 6f64 b-dev.info, Nod │ │ │ │ -000145e0: 653a 2047 4e55 2046 7265 6520 446f 6375 e: GNU Free Docu │ │ │ │ -000145f0: 6d65 6e74 6174 696f 6e20 4c69 6365 6e73 mentation Licens │ │ │ │ -00014600: 652c 2020 5570 3a20 436f 7079 696e 6720 e, Up: Copying │ │ │ │ -00014610: 5468 6973 204d 616e 7561 6c0a 0a41 2e31 This Manual..A.1 │ │ │ │ -00014620: 2047 4e55 2046 7265 6520 446f 6375 6d65 GNU Free Docume │ │ │ │ -00014630: 6e74 6174 696f 6e20 4c69 6365 6e73 650a ntation License. │ │ │ │ -00014640: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ +00014570: 2a2a 2a2a 2a2a 2a2a 0a0a 2a20 4d65 6e75 ********..* Menu │ │ │ │ +00014580: 3a0a 0a2a 2047 4e55 2046 7265 6520 446f :..* GNU Free Do │ │ │ │ +00014590: 6375 6d65 6e74 6174 696f 6e20 4c69 6365 cumentation Lice │ │ │ │ +000145a0: 6e73 653a 3a20 204c 6963 656e 7365 2066 nse:: License f │ │ │ │ +000145b0: 6f72 2063 6f70 7969 6e67 2074 6869 7320 or copying this │ │ │ │ +000145c0: 6d61 6e75 616c 2e0a 0a1f 0a46 696c 653a manual.....File: │ │ │ │ +000145d0: 2067 7275 622d 6465 762e 696e 666f 2c20 grub-dev.info, │ │ │ │ +000145e0: 204e 6f64 653a 2047 4e55 2046 7265 6520 Node: GNU Free │ │ │ │ +000145f0: 446f 6375 6d65 6e74 6174 696f 6e20 4c69 Documentation Li │ │ │ │ +00014600: 6365 6e73 652c 2020 5570 3a20 436f 7079 cense, Up: Copy │ │ │ │ +00014610: 696e 6720 5468 6973 204d 616e 7561 6c0a ing This Manual. │ │ │ │ +00014620: 0a41 2e31 2047 4e55 2046 7265 6520 446f .A.1 GNU Free Do │ │ │ │ +00014630: 6375 6d65 6e74 6174 696f 6e20 4c69 6365 cumentation Lice │ │ │ │ +00014640: 6e73 650a 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d nse.============ │ │ │ │ 00014650: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ -00014660: 3d3d 0a0a 2020 2020 2020 2020 2020 2020 ==.. │ │ │ │ -00014670: 2020 2020 2020 2020 2020 5665 7273 696f Versio │ │ │ │ -00014680: 6e20 312e 322c 204e 6f76 656d 6265 7220 n 1.2, November │ │ │ │ -00014690: 3230 3032 0a0a 2020 2020 2043 6f70 7972 2002.. Copyr │ │ │ │ -000146a0: 6967 6874 2028 4329 2032 3030 302c 3230 ight (C) 2000,20 │ │ │ │ -000146b0: 3031 2c32 3030 3220 4672 6565 2053 6f66 01,2002 Free Sof │ │ │ │ -000146c0: 7477 6172 6520 466f 756e 6461 7469 6f6e tware Foundation │ │ │ │ -000146d0: 2c20 496e 632e 0a20 2020 2020 3531 2046 , Inc.. 51 F │ │ │ │ -000146e0: 7261 6e6b 6c69 6e20 5374 2c20 4669 6674 ranklin St, Fift │ │ │ │ -000146f0: 6820 466c 6f6f 722c 2042 6f73 746f 6e2c h Floor, Boston, │ │ │ │ -00014700: 204d 4120 2030 3231 3130 2d31 3330 312c MA 02110-1301, │ │ │ │ -00014710: 2055 5341 0a0a 2020 2020 2045 7665 7279 USA.. Every │ │ │ │ -00014720: 6f6e 6520 6973 2070 6572 6d69 7474 6564 one is permitted │ │ │ │ -00014730: 2074 6f20 636f 7079 2061 6e64 2064 6973 to copy and dis │ │ │ │ -00014740: 7472 6962 7574 6520 7665 7262 6174 696d tribute verbatim │ │ │ │ -00014750: 2063 6f70 6965 730a 2020 2020 206f 6620 copies. of │ │ │ │ -00014760: 7468 6973 206c 6963 656e 7365 2064 6f63 this license doc │ │ │ │ -00014770: 756d 656e 742c 2062 7574 2063 6861 6e67 ument, but chang │ │ │ │ -00014780: 696e 6720 6974 2069 7320 6e6f 7420 616c ing it is not al │ │ │ │ -00014790: 6c6f 7765 642e 0a0a 2020 302e 2050 5245 lowed... 0. PRE │ │ │ │ -000147a0: 414d 424c 450a 0a20 2020 2020 5468 6520 AMBLE.. The │ │ │ │ -000147b0: 7075 7270 6f73 6520 6f66 2074 6869 7320 purpose of this │ │ │ │ -000147c0: 4c69 6365 6e73 6520 6973 2074 6f20 6d61 License is to ma │ │ │ │ -000147d0: 6b65 2061 206d 616e 7561 6c2c 2074 6578 ke a manual, tex │ │ │ │ -000147e0: 7462 6f6f 6b2c 206f 7220 6f74 6865 720a tbook, or other. │ │ │ │ -000147f0: 2020 2020 2066 756e 6374 696f 6e61 6c20 functional │ │ │ │ -00014800: 616e 6420 7573 6566 756c 2064 6f63 756d and useful docum │ │ │ │ -00014810: 656e 7420 2266 7265 6522 2069 6e20 7468 ent "free" in th │ │ │ │ -00014820: 6520 7365 6e73 6520 6f66 2066 7265 6564 e sense of freed │ │ │ │ -00014830: 6f6d 3a20 746f 0a20 2020 2020 6173 7375 om: to. assu │ │ │ │ -00014840: 7265 2065 7665 7279 6f6e 6520 7468 6520 re everyone the │ │ │ │ -00014850: 6566 6665 6374 6976 6520 6672 6565 646f effective freedo │ │ │ │ -00014860: 6d20 746f 2063 6f70 7920 616e 6420 7265 m to copy and re │ │ │ │ -00014870: 6469 7374 7269 6275 7465 2069 742c 0a20 distribute it,. │ │ │ │ -00014880: 2020 2020 7769 7468 206f 7220 7769 7468 with or with │ │ │ │ -00014890: 6f75 7420 6d6f 6469 6679 696e 6720 6974 out modifying it │ │ │ │ -000148a0: 2c20 6569 7468 6572 2063 6f6d 6d65 7263 , either commerc │ │ │ │ -000148b0: 6961 6c6c 7920 6f72 0a20 2020 2020 6e6f ially or. no │ │ │ │ -000148c0: 6e63 6f6d 6d65 7263 6961 6c6c 792e 2020 ncommercially. │ │ │ │ -000148d0: 5365 636f 6e64 6172 696c 792c 2074 6869 Secondarily, thi │ │ │ │ -000148e0: 7320 4c69 6365 6e73 6520 7072 6573 6572 s License preser │ │ │ │ -000148f0: 7665 7320 666f 7220 7468 650a 2020 2020 ves for the. │ │ │ │ -00014900: 2061 7574 686f 7220 616e 6420 7075 626c author and publ │ │ │ │ -00014910: 6973 6865 7220 6120 7761 7920 746f 2067 isher a way to g │ │ │ │ -00014920: 6574 2063 7265 6469 7420 666f 7220 7468 et credit for th │ │ │ │ -00014930: 6569 7220 776f 726b 2c20 7768 696c 6520 eir work, while │ │ │ │ -00014940: 6e6f 740a 2020 2020 2062 6569 6e67 2063 not. being c │ │ │ │ -00014950: 6f6e 7369 6465 7265 6420 7265 7370 6f6e onsidered respon │ │ │ │ -00014960: 7369 626c 6520 666f 7220 6d6f 6469 6669 sible for modifi │ │ │ │ -00014970: 6361 7469 6f6e 7320 6d61 6465 2062 7920 cations made by │ │ │ │ -00014980: 6f74 6865 7273 2e0a 0a20 2020 2020 5468 others... Th │ │ │ │ -00014990: 6973 204c 6963 656e 7365 2069 7320 6120 is License is a │ │ │ │ -000149a0: 6b69 6e64 206f 6620 2263 6f70 796c 6566 kind of "copylef │ │ │ │ -000149b0: 7422 2c20 7768 6963 6820 6d65 616e 7320 t", which means │ │ │ │ -000149c0: 7468 6174 2064 6572 6976 6174 6976 650a that derivative. │ │ │ │ -000149d0: 2020 2020 2077 6f72 6b73 206f 6620 7468 works of th │ │ │ │ -000149e0: 6520 646f 6375 6d65 6e74 206d 7573 7420 e document must │ │ │ │ -000149f0: 7468 656d 7365 6c76 6573 2062 6520 6672 themselves be fr │ │ │ │ -00014a00: 6565 2069 6e20 7468 6520 7361 6d65 2073 ee in the same s │ │ │ │ -00014a10: 656e 7365 2e0a 2020 2020 2049 7420 636f ense.. It co │ │ │ │ -00014a20: 6d70 6c65 6d65 6e74 7320 7468 6520 474e mplements the GN │ │ │ │ -00014a30: 5520 4765 6e65 7261 6c20 5075 626c 6963 U General Public │ │ │ │ -00014a40: 204c 6963 656e 7365 2c20 7768 6963 6820 License, which │ │ │ │ -00014a50: 6973 2061 2063 6f70 796c 6566 740a 2020 is a copyleft. │ │ │ │ -00014a60: 2020 206c 6963 656e 7365 2064 6573 6967 license desig │ │ │ │ -00014a70: 6e65 6420 666f 7220 6672 6565 2073 6f66 ned for free sof │ │ │ │ -00014a80: 7477 6172 652e 0a0a 2020 2020 2057 6520 tware... We │ │ │ │ -00014a90: 6861 7665 2064 6573 6967 6e65 6420 7468 have designed th │ │ │ │ -00014aa0: 6973 204c 6963 656e 7365 2069 6e20 6f72 is License in or │ │ │ │ -00014ab0: 6465 7220 746f 2075 7365 2069 7420 666f der to use it fo │ │ │ │ -00014ac0: 7220 6d61 6e75 616c 7320 666f 720a 2020 r manuals for. │ │ │ │ -00014ad0: 2020 2066 7265 6520 736f 6674 7761 7265 free software │ │ │ │ -00014ae0: 2c20 6265 6361 7573 6520 6672 6565 2073 , because free s │ │ │ │ -00014af0: 6f66 7477 6172 6520 6e65 6564 7320 6672 oftware needs fr │ │ │ │ -00014b00: 6565 2064 6f63 756d 656e 7461 7469 6f6e ee documentation │ │ │ │ -00014b10: 3a20 610a 2020 2020 2066 7265 6520 7072 : a. free pr │ │ │ │ -00014b20: 6f67 7261 6d20 7368 6f75 6c64 2063 6f6d ogram should com │ │ │ │ -00014b30: 6520 7769 7468 206d 616e 7561 6c73 2070 e with manuals p │ │ │ │ -00014b40: 726f 7669 6469 6e67 2074 6865 2073 616d roviding the sam │ │ │ │ -00014b50: 6520 6672 6565 646f 6d73 0a20 2020 2020 e freedoms. │ │ │ │ -00014b60: 7468 6174 2074 6865 2073 6f66 7477 6172 that the softwar │ │ │ │ -00014b70: 6520 646f 6573 2e20 2042 7574 2074 6869 e does. But thi │ │ │ │ -00014b80: 7320 4c69 6365 6e73 6520 6973 206e 6f74 s License is not │ │ │ │ -00014b90: 206c 696d 6974 6564 2074 6f0a 2020 2020 limited to. │ │ │ │ -00014ba0: 2073 6f66 7477 6172 6520 6d61 6e75 616c software manual │ │ │ │ -00014bb0: 733b 2069 7420 6361 6e20 6265 2075 7365 s; it can be use │ │ │ │ -00014bc0: 6420 666f 7220 616e 7920 7465 7874 7561 d for any textua │ │ │ │ -00014bd0: 6c20 776f 726b 2c20 7265 6761 7264 6c65 l work, regardle │ │ │ │ -00014be0: 7373 0a20 2020 2020 6f66 2073 7562 6a65 ss. of subje │ │ │ │ -00014bf0: 6374 206d 6174 7465 7220 6f72 2077 6865 ct matter or whe │ │ │ │ -00014c00: 7468 6572 2069 7420 6973 2070 7562 6c69 ther it is publi │ │ │ │ -00014c10: 7368 6564 2061 7320 6120 7072 696e 7465 shed as a printe │ │ │ │ -00014c20: 6420 626f 6f6b 2e20 2057 650a 2020 2020 d book. We. │ │ │ │ -00014c30: 2072 6563 6f6d 6d65 6e64 2074 6869 7320 recommend this │ │ │ │ -00014c40: 4c69 6365 6e73 6520 7072 696e 6369 7061 License principa │ │ │ │ -00014c50: 6c6c 7920 666f 7220 776f 726b 7320 7768 lly for works wh │ │ │ │ -00014c60: 6f73 6520 7075 7270 6f73 6520 6973 0a20 ose purpose is. │ │ │ │ -00014c70: 2020 2020 696e 7374 7275 6374 696f 6e20 instruction │ │ │ │ -00014c80: 6f72 2072 6566 6572 656e 6365 2e0a 0a20 or reference... │ │ │ │ -00014c90: 2031 2e20 4150 504c 4943 4142 494c 4954 1. APPLICABILIT │ │ │ │ -00014ca0: 5920 414e 4420 4445 4649 4e49 5449 4f4e Y AND DEFINITION │ │ │ │ -00014cb0: 530a 0a20 2020 2020 5468 6973 204c 6963 S.. This Lic │ │ │ │ -00014cc0: 656e 7365 2061 7070 6c69 6573 2074 6f20 ense applies to │ │ │ │ -00014cd0: 616e 7920 6d61 6e75 616c 206f 7220 6f74 any manual or ot │ │ │ │ -00014ce0: 6865 7220 776f 726b 2c20 696e 2061 6e79 her work, in any │ │ │ │ -00014cf0: 206d 6564 6975 6d2c 0a20 2020 2020 7468 medium,. th │ │ │ │ -00014d00: 6174 2063 6f6e 7461 696e 7320 6120 6e6f at contains a no │ │ │ │ -00014d10: 7469 6365 2070 6c61 6365 6420 6279 2074 tice placed by t │ │ │ │ -00014d20: 6865 2063 6f70 7972 6967 6874 2068 6f6c he copyright hol │ │ │ │ -00014d30: 6465 7220 7361 7969 6e67 2069 7420 6361 der saying it ca │ │ │ │ -00014d40: 6e0a 2020 2020 2062 6520 6469 7374 7269 n. be distri │ │ │ │ -00014d50: 6275 7465 6420 756e 6465 7220 7468 6520 buted under the │ │ │ │ -00014d60: 7465 726d 7320 6f66 2074 6869 7320 4c69 terms of this Li │ │ │ │ -00014d70: 6365 6e73 652e 2020 5375 6368 2061 206e cense. Such a n │ │ │ │ -00014d80: 6f74 6963 650a 2020 2020 2067 7261 6e74 otice. grant │ │ │ │ -00014d90: 7320 6120 776f 726c 642d 7769 6465 2c20 s a world-wide, │ │ │ │ -00014da0: 726f 7961 6c74 792d 6672 6565 206c 6963 royalty-free lic │ │ │ │ -00014db0: 656e 7365 2c20 756e 6c69 6d69 7465 6420 ense, unlimited │ │ │ │ -00014dc0: 696e 2064 7572 6174 696f 6e2c 0a20 2020 in duration,. │ │ │ │ -00014dd0: 2020 746f 2075 7365 2074 6861 7420 776f to use that wo │ │ │ │ -00014de0: 726b 2075 6e64 6572 2074 6865 2063 6f6e rk under the con │ │ │ │ -00014df0: 6469 7469 6f6e 7320 7374 6174 6564 2068 ditions stated h │ │ │ │ -00014e00: 6572 6569 6e2e 2020 5468 650a 2020 2020 erein. The. │ │ │ │ -00014e10: 2022 446f 6375 6d65 6e74 222c 2062 656c "Document", bel │ │ │ │ -00014e20: 6f77 2c20 7265 6665 7273 2074 6f20 616e ow, refers to an │ │ │ │ -00014e30: 7920 7375 6368 206d 616e 7561 6c20 6f72 y such manual or │ │ │ │ -00014e40: 2077 6f72 6b2e 2020 416e 7920 6d65 6d62 work. Any memb │ │ │ │ -00014e50: 6572 0a20 2020 2020 6f66 2074 6865 2070 er. of the p │ │ │ │ -00014e60: 7562 6c69 6320 6973 2061 206c 6963 656e ublic is a licen │ │ │ │ -00014e70: 7365 652c 2061 6e64 2069 7320 6164 6472 see, and is addr │ │ │ │ -00014e80: 6573 7365 6420 6173 2022 796f 7522 2e20 essed as "you". │ │ │ │ -00014e90: 2059 6f75 2061 6363 6570 740a 2020 2020 You accept. │ │ │ │ -00014ea0: 2074 6865 206c 6963 656e 7365 2069 6620 the license if │ │ │ │ -00014eb0: 796f 7520 636f 7079 2c20 6d6f 6469 6679 you copy, modify │ │ │ │ -00014ec0: 206f 7220 6469 7374 7269 6275 7465 2074 or distribute t │ │ │ │ -00014ed0: 6865 2077 6f72 6b20 696e 2061 2077 6179 he work in a way │ │ │ │ -00014ee0: 0a20 2020 2020 7265 7175 6972 696e 6720 . requiring │ │ │ │ -00014ef0: 7065 726d 6973 7369 6f6e 2075 6e64 6572 permission under │ │ │ │ -00014f00: 2063 6f70 7972 6967 6874 206c 6177 2e0a copyright law.. │ │ │ │ -00014f10: 0a20 2020 2020 4120 224d 6f64 6966 6965 . A "Modifie │ │ │ │ -00014f20: 6420 5665 7273 696f 6e22 206f 6620 7468 d Version" of th │ │ │ │ -00014f30: 6520 446f 6375 6d65 6e74 206d 6561 6e73 e Document means │ │ │ │ -00014f40: 2061 6e79 2077 6f72 6b20 636f 6e74 6169 any work contai │ │ │ │ -00014f50: 6e69 6e67 2074 6865 0a20 2020 2020 446f ning the. Do │ │ │ │ -00014f60: 6375 6d65 6e74 206f 7220 6120 706f 7274 cument or a port │ │ │ │ -00014f70: 696f 6e20 6f66 2069 742c 2065 6974 6865 ion of it, eithe │ │ │ │ -00014f80: 7220 636f 7069 6564 2076 6572 6261 7469 r copied verbati │ │ │ │ -00014f90: 6d2c 206f 7220 7769 7468 0a20 2020 2020 m, or with. │ │ │ │ -00014fa0: 6d6f 6469 6669 6361 7469 6f6e 7320 616e modifications an │ │ │ │ -00014fb0: 642f 6f72 2074 7261 6e73 6c61 7465 6420 d/or translated │ │ │ │ -00014fc0: 696e 746f 2061 6e6f 7468 6572 206c 616e into another lan │ │ │ │ -00014fd0: 6775 6167 652e 0a0a 2020 2020 2041 2022 guage... A " │ │ │ │ -00014fe0: 5365 636f 6e64 6172 7920 5365 6374 696f Secondary Sectio │ │ │ │ -00014ff0: 6e22 2069 7320 6120 6e61 6d65 6420 6170 n" is a named ap │ │ │ │ -00015000: 7065 6e64 6978 206f 7220 6120 6672 6f6e pendix or a fron │ │ │ │ -00015010: 742d 6d61 7474 6572 2073 6563 7469 6f6e t-matter section │ │ │ │ -00015020: 0a20 2020 2020 6f66 2074 6865 2044 6f63 . of the Doc │ │ │ │ -00015030: 756d 656e 7420 7468 6174 2064 6561 6c73 ument that deals │ │ │ │ -00015040: 2065 7863 6c75 7369 7665 6c79 2077 6974 exclusively wit │ │ │ │ -00015050: 6820 7468 6520 7265 6c61 7469 6f6e 7368 h the relationsh │ │ │ │ -00015060: 6970 206f 6620 7468 650a 2020 2020 2070 ip of the. p │ │ │ │ -00015070: 7562 6c69 7368 6572 7320 6f72 2061 7574 ublishers or aut │ │ │ │ -00015080: 686f 7273 206f 6620 7468 6520 446f 6375 hors of the Docu │ │ │ │ -00015090: 6d65 6e74 2074 6f20 7468 6520 446f 6375 ment to the Docu │ │ │ │ -000150a0: 6d65 6e74 2773 206f 7665 7261 6c6c 0a20 ment's overall. │ │ │ │ -000150b0: 2020 2020 7375 626a 6563 7420 286f 7220 subject (or │ │ │ │ -000150c0: 746f 2072 656c 6174 6564 206d 6174 7465 to related matte │ │ │ │ -000150d0: 7273 2920 616e 6420 636f 6e74 6169 6e73 rs) and contains │ │ │ │ -000150e0: 206e 6f74 6869 6e67 2074 6861 7420 636f nothing that co │ │ │ │ -000150f0: 756c 640a 2020 2020 2066 616c 6c20 6469 uld. fall di │ │ │ │ -00015100: 7265 6374 6c79 2077 6974 6869 6e20 7468 rectly within th │ │ │ │ -00015110: 6174 206f 7665 7261 6c6c 2073 7562 6a65 at overall subje │ │ │ │ -00015120: 6374 2e20 2028 5468 7573 2c20 6966 2074 ct. (Thus, if t │ │ │ │ -00015130: 6865 2044 6f63 756d 656e 740a 2020 2020 he Document. │ │ │ │ -00015140: 2069 7320 696e 2070 6172 7420 6120 7465 is in part a te │ │ │ │ -00015150: 7874 626f 6f6b 206f 6620 6d61 7468 656d xtbook of mathem │ │ │ │ -00015160: 6174 6963 732c 2061 2053 6563 6f6e 6461 atics, a Seconda │ │ │ │ -00015170: 7279 2053 6563 7469 6f6e 206d 6179 206e ry Section may n │ │ │ │ -00015180: 6f74 0a20 2020 2020 6578 706c 6169 6e20 ot. explain │ │ │ │ -00015190: 616e 7920 6d61 7468 656d 6174 6963 732e any mathematics. │ │ │ │ -000151a0: 2920 2054 6865 2072 656c 6174 696f 6e73 ) The relations │ │ │ │ -000151b0: 6869 7020 636f 756c 6420 6265 2061 206d hip could be a m │ │ │ │ -000151c0: 6174 7465 7220 6f66 0a20 2020 2020 6869 atter of. hi │ │ │ │ -000151d0: 7374 6f72 6963 616c 2063 6f6e 6e65 6374 storical connect │ │ │ │ -000151e0: 696f 6e20 7769 7468 2074 6865 2073 7562 ion with the sub │ │ │ │ -000151f0: 6a65 6374 206f 7220 7769 7468 2072 656c ject or with rel │ │ │ │ -00015200: 6174 6564 206d 6174 7465 7273 2c20 6f72 ated matters, or │ │ │ │ -00015210: 0a20 2020 2020 6f66 206c 6567 616c 2c20 . of legal, │ │ │ │ -00015220: 636f 6d6d 6572 6369 616c 2c20 7068 696c commercial, phil │ │ │ │ -00015230: 6f73 6f70 6869 6361 6c2c 2065 7468 6963 osophical, ethic │ │ │ │ -00015240: 616c 206f 7220 706f 6c69 7469 6361 6c20 al or political │ │ │ │ -00015250: 706f 7369 7469 6f6e 0a20 2020 2020 7265 position. re │ │ │ │ -00015260: 6761 7264 696e 6720 7468 656d 2e0a 0a20 garding them... │ │ │ │ -00015270: 2020 2020 5468 6520 2249 6e76 6172 6961 The "Invaria │ │ │ │ -00015280: 6e74 2053 6563 7469 6f6e 7322 2061 7265 nt Sections" are │ │ │ │ -00015290: 2063 6572 7461 696e 2053 6563 6f6e 6461 certain Seconda │ │ │ │ -000152a0: 7279 2053 6563 7469 6f6e 7320 7768 6f73 ry Sections whos │ │ │ │ -000152b0: 650a 2020 2020 2074 6974 6c65 7320 6172 e. titles ar │ │ │ │ -000152c0: 6520 6465 7369 676e 6174 6564 2c20 6173 e designated, as │ │ │ │ -000152d0: 2062 6569 6e67 2074 686f 7365 206f 6620 being those of │ │ │ │ -000152e0: 496e 7661 7269 616e 7420 5365 6374 696f Invariant Sectio │ │ │ │ -000152f0: 6e73 2c20 696e 2074 6865 0a20 2020 2020 ns, in the. │ │ │ │ -00015300: 6e6f 7469 6365 2074 6861 7420 7361 7973 notice that says │ │ │ │ -00015310: 2074 6861 7420 7468 6520 446f 6375 6d65 that the Docume │ │ │ │ -00015320: 6e74 2069 7320 7265 6c65 6173 6564 2075 nt is released u │ │ │ │ -00015330: 6e64 6572 2074 6869 7320 4c69 6365 6e73 nder this Licens │ │ │ │ -00015340: 652e 0a20 2020 2020 4966 2061 2073 6563 e.. If a sec │ │ │ │ -00015350: 7469 6f6e 2064 6f65 7320 6e6f 7420 6669 tion does not fi │ │ │ │ -00015360: 7420 7468 6520 6162 6f76 6520 6465 6669 t the above defi │ │ │ │ -00015370: 6e69 7469 6f6e 206f 6620 5365 636f 6e64 nition of Second │ │ │ │ -00015380: 6172 7920 7468 656e 2069 740a 2020 2020 ary then it. │ │ │ │ -00015390: 2069 7320 6e6f 7420 616c 6c6f 7765 6420 is not allowed │ │ │ │ -000153a0: 746f 2062 6520 6465 7369 676e 6174 6564 to be designated │ │ │ │ -000153b0: 2061 7320 496e 7661 7269 616e 742e 2020 as Invariant. │ │ │ │ -000153c0: 5468 6520 446f 6375 6d65 6e74 206d 6179 The Document may │ │ │ │ -000153d0: 0a20 2020 2020 636f 6e74 6169 6e20 7a65 . contain ze │ │ │ │ -000153e0: 726f 2049 6e76 6172 6961 6e74 2053 6563 ro Invariant Sec │ │ │ │ -000153f0: 7469 6f6e 732e 2020 4966 2074 6865 2044 tions. If the D │ │ │ │ -00015400: 6f63 756d 656e 7420 646f 6573 206e 6f74 ocument does not │ │ │ │ -00015410: 2069 6465 6e74 6966 790a 2020 2020 2061 identify. a │ │ │ │ -00015420: 6e79 2049 6e76 6172 6961 6e74 2053 6563 ny Invariant Sec │ │ │ │ -00015430: 7469 6f6e 7320 7468 656e 2074 6865 7265 tions then there │ │ │ │ -00015440: 2061 7265 206e 6f6e 652e 0a0a 2020 2020 are none... │ │ │ │ -00015450: 2054 6865 2022 436f 7665 7220 5465 7874 The "Cover Text │ │ │ │ -00015460: 7322 2061 7265 2063 6572 7461 696e 2073 s" are certain s │ │ │ │ -00015470: 686f 7274 2070 6173 7361 6765 7320 6f66 hort passages of │ │ │ │ -00015480: 2074 6578 7420 7468 6174 2061 7265 0a20 text that are. │ │ │ │ -00015490: 2020 2020 6c69 7374 6564 2c20 6173 2046 listed, as F │ │ │ │ -000154a0: 726f 6e74 2d43 6f76 6572 2054 6578 7473 ront-Cover Texts │ │ │ │ -000154b0: 206f 7220 4261 636b 2d43 6f76 6572 2054 or Back-Cover T │ │ │ │ -000154c0: 6578 7473 2c20 696e 2074 6865 206e 6f74 exts, in the not │ │ │ │ -000154d0: 6963 650a 2020 2020 2074 6861 7420 7361 ice. that sa │ │ │ │ -000154e0: 7973 2074 6861 7420 7468 6520 446f 6375 ys that the Docu │ │ │ │ -000154f0: 6d65 6e74 2069 7320 7265 6c65 6173 6564 ment is released │ │ │ │ -00015500: 2075 6e64 6572 2074 6869 7320 4c69 6365 under this Lice │ │ │ │ -00015510: 6e73 652e 2020 410a 2020 2020 2046 726f nse. A. Fro │ │ │ │ -00015520: 6e74 2d43 6f76 6572 2054 6578 7420 6d61 nt-Cover Text ma │ │ │ │ -00015530: 7920 6265 2061 7420 6d6f 7374 2035 2077 y be at most 5 w │ │ │ │ -00015540: 6f72 6473 2c20 616e 6420 6120 4261 636b ords, and a Back │ │ │ │ -00015550: 2d43 6f76 6572 2054 6578 7420 6d61 790a -Cover Text may. │ │ │ │ -00015560: 2020 2020 2062 6520 6174 206d 6f73 7420 be at most │ │ │ │ -00015570: 3235 2077 6f72 6473 2e0a 0a20 2020 2020 25 words... │ │ │ │ -00015580: 4120 2254 7261 6e73 7061 7265 6e74 2220 A "Transparent" │ │ │ │ -00015590: 636f 7079 206f 6620 7468 6520 446f 6375 copy of the Docu │ │ │ │ -000155a0: 6d65 6e74 206d 6561 6e73 2061 206d 6163 ment means a mac │ │ │ │ -000155b0: 6869 6e65 2d72 6561 6461 626c 6520 636f hine-readable co │ │ │ │ -000155c0: 7079 2c0a 2020 2020 2072 6570 7265 7365 py,. represe │ │ │ │ -000155d0: 6e74 6564 2069 6e20 6120 666f 726d 6174 nted in a format │ │ │ │ -000155e0: 2077 686f 7365 2073 7065 6369 6669 6361 whose specifica │ │ │ │ -000155f0: 7469 6f6e 2069 7320 6176 6169 6c61 626c tion is availabl │ │ │ │ -00015600: 6520 746f 2074 6865 0a20 2020 2020 6765 e to the. ge │ │ │ │ -00015610: 6e65 7261 6c20 7075 626c 6963 2c20 7468 neral public, th │ │ │ │ -00015620: 6174 2069 7320 7375 6974 6162 6c65 2066 at is suitable f │ │ │ │ -00015630: 6f72 2072 6576 6973 696e 6720 7468 6520 or revising the │ │ │ │ -00015640: 646f 6375 6d65 6e74 0a20 2020 2020 7374 document. st │ │ │ │ -00015650: 7261 6967 6874 666f 7277 6172 646c 7920 raightforwardly │ │ │ │ -00015660: 7769 7468 2067 656e 6572 6963 2074 6578 with generic tex │ │ │ │ -00015670: 7420 6564 6974 6f72 7320 6f72 2028 666f t editors or (fo │ │ │ │ -00015680: 7220 696d 6167 6573 2063 6f6d 706f 7365 r images compose │ │ │ │ -00015690: 640a 2020 2020 206f 6620 7069 7865 6c73 d. of pixels │ │ │ │ -000156a0: 2920 6765 6e65 7269 6320 7061 696e 7420 ) generic paint │ │ │ │ -000156b0: 7072 6f67 7261 6d73 206f 7220 2866 6f72 programs or (for │ │ │ │ -000156c0: 2064 7261 7769 6e67 7329 2073 6f6d 6520 drawings) some │ │ │ │ -000156d0: 7769 6465 6c79 0a20 2020 2020 6176 6169 widely. avai │ │ │ │ -000156e0: 6c61 626c 6520 6472 6177 696e 6720 6564 lable drawing ed │ │ │ │ -000156f0: 6974 6f72 2c20 616e 6420 7468 6174 2069 itor, and that i │ │ │ │ -00015700: 7320 7375 6974 6162 6c65 2066 6f72 2069 s suitable for i │ │ │ │ -00015710: 6e70 7574 2074 6f20 7465 7874 0a20 2020 nput to text. │ │ │ │ -00015720: 2020 666f 726d 6174 7465 7273 206f 7220 formatters or │ │ │ │ -00015730: 666f 7220 6175 746f 6d61 7469 6320 7472 for automatic tr │ │ │ │ -00015740: 616e 736c 6174 696f 6e20 746f 2061 2076 anslation to a v │ │ │ │ -00015750: 6172 6965 7479 206f 6620 666f 726d 6174 ariety of format │ │ │ │ -00015760: 730a 2020 2020 2073 7569 7461 626c 6520 s. suitable │ │ │ │ -00015770: 666f 7220 696e 7075 7420 746f 2074 6578 for input to tex │ │ │ │ -00015780: 7420 666f 726d 6174 7465 7273 2e20 2041 t formatters. A │ │ │ │ -00015790: 2063 6f70 7920 6d61 6465 2069 6e20 616e copy made in an │ │ │ │ -000157a0: 206f 7468 6572 7769 7365 0a20 2020 2020 otherwise. │ │ │ │ -000157b0: 5472 616e 7370 6172 656e 7420 6669 6c65 Transparent file │ │ │ │ -000157c0: 2066 6f72 6d61 7420 7768 6f73 6520 6d61 format whose ma │ │ │ │ -000157d0: 726b 7570 2c20 6f72 2061 6273 656e 6365 rkup, or absence │ │ │ │ -000157e0: 206f 6620 6d61 726b 7570 2c20 6861 730a of markup, has. │ │ │ │ -000157f0: 2020 2020 2062 6565 6e20 6172 7261 6e67 been arrang │ │ │ │ -00015800: 6564 2074 6f20 7468 7761 7274 206f 7220 ed to thwart or │ │ │ │ -00015810: 6469 7363 6f75 7261 6765 2073 7562 7365 discourage subse │ │ │ │ -00015820: 7175 656e 7420 6d6f 6469 6669 6361 7469 quent modificati │ │ │ │ -00015830: 6f6e 2062 790a 2020 2020 2072 6561 6465 on by. reade │ │ │ │ -00015840: 7273 2069 7320 6e6f 7420 5472 616e 7370 rs is not Transp │ │ │ │ -00015850: 6172 656e 742e 2020 416e 2069 6d61 6765 arent. An image │ │ │ │ -00015860: 2066 6f72 6d61 7420 6973 206e 6f74 2054 format is not T │ │ │ │ -00015870: 7261 6e73 7061 7265 6e74 2069 660a 2020 ransparent if. │ │ │ │ -00015880: 2020 2075 7365 6420 666f 7220 616e 7920 used for any │ │ │ │ -00015890: 7375 6273 7461 6e74 6961 6c20 616d 6f75 substantial amou │ │ │ │ -000158a0: 6e74 206f 6620 7465 7874 2e20 2041 2063 nt of text. A c │ │ │ │ -000158b0: 6f70 7920 7468 6174 2069 7320 6e6f 740a opy that is not. │ │ │ │ -000158c0: 2020 2020 2022 5472 616e 7370 6172 656e "Transparen │ │ │ │ -000158d0: 7422 2069 7320 6361 6c6c 6564 2022 4f70 t" is called "Op │ │ │ │ -000158e0: 6171 7565 222e 0a0a 2020 2020 2045 7861 aque"... Exa │ │ │ │ -000158f0: 6d70 6c65 7320 6f66 2073 7569 7461 626c mples of suitabl │ │ │ │ -00015900: 6520 666f 726d 6174 7320 666f 7220 5472 e formats for Tr │ │ │ │ -00015910: 616e 7370 6172 656e 7420 636f 7069 6573 ansparent copies │ │ │ │ -00015920: 2069 6e63 6c75 6465 2070 6c61 696e 0a20 include plain. │ │ │ │ -00015930: 2020 2020 4153 4349 4920 7769 7468 6f75 ASCII withou │ │ │ │ -00015940: 7420 6d61 726b 7570 2c20 5465 7869 6e66 t markup, Texinf │ │ │ │ -00015950: 6f20 696e 7075 7420 666f 726d 6174 2c20 o input format, │ │ │ │ -00015960: 4c61 5465 5820 696e 7075 7420 666f 726d LaTeX input form │ │ │ │ -00015970: 6174 2c0a 2020 2020 2053 474d 4c20 6f72 at,. SGML or │ │ │ │ -00015980: 2058 4d4c 2075 7369 6e67 2061 2070 7562 XML using a pub │ │ │ │ -00015990: 6c69 636c 7920 6176 6169 6c61 626c 6520 licly available │ │ │ │ -000159a0: 4454 442c 2061 6e64 2073 7461 6e64 6172 DTD, and standar │ │ │ │ -000159b0: 642d 636f 6e66 6f72 6d69 6e67 0a20 2020 d-conforming. │ │ │ │ -000159c0: 2020 7369 6d70 6c65 2048 544d 4c2c 2050 simple HTML, P │ │ │ │ -000159d0: 6f73 7453 6372 6970 7420 6f72 2050 4446 ostScript or PDF │ │ │ │ -000159e0: 2064 6573 6967 6e65 6420 666f 7220 6875 designed for hu │ │ │ │ -000159f0: 6d61 6e20 6d6f 6469 6669 6361 7469 6f6e man modification │ │ │ │ -00015a00: 2e0a 2020 2020 2045 7861 6d70 6c65 7320 .. Examples │ │ │ │ -00015a10: 6f66 2074 7261 6e73 7061 7265 6e74 2069 of transparent i │ │ │ │ -00015a20: 6d61 6765 2066 6f72 6d61 7473 2069 6e63 mage formats inc │ │ │ │ -00015a30: 6c75 6465 2050 4e47 2c20 5843 4620 616e lude PNG, XCF an │ │ │ │ -00015a40: 6420 4a50 472e 0a20 2020 2020 4f70 6171 d JPG.. Opaq │ │ │ │ -00015a50: 7565 2066 6f72 6d61 7473 2069 6e63 6c75 ue formats inclu │ │ │ │ -00015a60: 6465 2070 726f 7072 6965 7461 7279 2066 de proprietary f │ │ │ │ -00015a70: 6f72 6d61 7473 2074 6861 7420 6361 6e20 ormats that can │ │ │ │ -00015a80: 6265 2072 6561 6420 616e 640a 2020 2020 be read and. │ │ │ │ -00015a90: 2065 6469 7465 6420 6f6e 6c79 2062 7920 edited only by │ │ │ │ -00015aa0: 7072 6f70 7269 6574 6172 7920 776f 7264 proprietary word │ │ │ │ -00015ab0: 2070 726f 6365 7373 6f72 732c 2053 474d processors, SGM │ │ │ │ -00015ac0: 4c20 6f72 2058 4d4c 2066 6f72 2077 6869 L or XML for whi │ │ │ │ -00015ad0: 6368 0a20 2020 2020 7468 6520 4454 4420 ch. the DTD │ │ │ │ -00015ae0: 616e 642f 6f72 2070 726f 6365 7373 696e and/or processin │ │ │ │ -00015af0: 6720 746f 6f6c 7320 6172 6520 6e6f 7420 g tools are not │ │ │ │ -00015b00: 6765 6e65 7261 6c6c 7920 6176 6169 6c61 generally availa │ │ │ │ -00015b10: 626c 652c 2061 6e64 0a20 2020 2020 7468 ble, and. th │ │ │ │ -00015b20: 6520 6d61 6368 696e 652d 6765 6e65 7261 e machine-genera │ │ │ │ -00015b30: 7465 6420 4854 4d4c 2c20 506f 7374 5363 ted HTML, PostSc │ │ │ │ -00015b40: 7269 7074 206f 7220 5044 4620 7072 6f64 ript or PDF prod │ │ │ │ -00015b50: 7563 6564 2062 7920 736f 6d65 2077 6f72 uced by some wor │ │ │ │ -00015b60: 640a 2020 2020 2070 726f 6365 7373 6f72 d. processor │ │ │ │ -00015b70: 7320 666f 7220 6f75 7470 7574 2070 7572 s for output pur │ │ │ │ -00015b80: 706f 7365 7320 6f6e 6c79 2e0a 0a20 2020 poses only... │ │ │ │ -00015b90: 2020 5468 6520 2254 6974 6c65 2050 6167 The "Title Pag │ │ │ │ -00015ba0: 6522 206d 6561 6e73 2c20 666f 7220 6120 e" means, for a │ │ │ │ -00015bb0: 7072 696e 7465 6420 626f 6f6b 2c20 7468 printed book, th │ │ │ │ -00015bc0: 6520 7469 746c 6520 7061 6765 2069 7473 e title page its │ │ │ │ -00015bd0: 656c 662c 0a20 2020 2020 706c 7573 2073 elf,. plus s │ │ │ │ -00015be0: 7563 6820 666f 6c6c 6f77 696e 6720 7061 uch following pa │ │ │ │ -00015bf0: 6765 7320 6173 2061 7265 206e 6565 6465 ges as are neede │ │ │ │ -00015c00: 6420 746f 2068 6f6c 642c 206c 6567 6962 d to hold, legib │ │ │ │ -00015c10: 6c79 2c20 7468 650a 2020 2020 206d 6174 ly, the. mat │ │ │ │ -00015c20: 6572 6961 6c20 7468 6973 204c 6963 656e erial this Licen │ │ │ │ -00015c30: 7365 2072 6571 7569 7265 7320 746f 2061 se requires to a │ │ │ │ -00015c40: 7070 6561 7220 696e 2074 6865 2074 6974 ppear in the tit │ │ │ │ -00015c50: 6c65 2070 6167 652e 2020 466f 720a 2020 le page. For. │ │ │ │ -00015c60: 2020 2077 6f72 6b73 2069 6e20 666f 726d works in form │ │ │ │ -00015c70: 6174 7320 7768 6963 6820 646f 206e 6f74 ats which do not │ │ │ │ -00015c80: 2068 6176 6520 616e 7920 7469 746c 6520 have any title │ │ │ │ -00015c90: 7061 6765 2061 7320 7375 6368 2c20 2254 page as such, "T │ │ │ │ -00015ca0: 6974 6c65 0a20 2020 2020 5061 6765 2220 itle. Page" │ │ │ │ -00015cb0: 6d65 616e 7320 7468 6520 7465 7874 206e means the text n │ │ │ │ -00015cc0: 6561 7220 7468 6520 6d6f 7374 2070 726f ear the most pro │ │ │ │ -00015cd0: 6d69 6e65 6e74 2061 7070 6561 7261 6e63 minent appearanc │ │ │ │ -00015ce0: 6520 6f66 2074 6865 0a20 2020 2020 776f e of the. wo │ │ │ │ -00015cf0: 726b 2773 2074 6974 6c65 2c20 7072 6563 rk's title, prec │ │ │ │ -00015d00: 6564 696e 6720 7468 6520 6265 6769 6e6e eding the beginn │ │ │ │ -00015d10: 696e 6720 6f66 2074 6865 2062 6f64 7920 ing of the body │ │ │ │ -00015d20: 6f66 2074 6865 2074 6578 742e 0a0a 2020 of the text... │ │ │ │ -00015d30: 2020 2041 2073 6563 7469 6f6e 2022 456e A section "En │ │ │ │ -00015d40: 7469 746c 6564 2058 595a 2220 6d65 616e titled XYZ" mean │ │ │ │ -00015d50: 7320 6120 6e61 6d65 6420 7375 6275 6e69 s a named subuni │ │ │ │ -00015d60: 7420 6f66 2074 6865 2044 6f63 756d 656e t of the Documen │ │ │ │ -00015d70: 740a 2020 2020 2077 686f 7365 2074 6974 t. whose tit │ │ │ │ -00015d80: 6c65 2065 6974 6865 7220 6973 2070 7265 le either is pre │ │ │ │ -00015d90: 6369 7365 6c79 2058 595a 206f 7220 636f cisely XYZ or co │ │ │ │ -00015da0: 6e74 6169 6e73 2058 595a 2069 6e20 7061 ntains XYZ in pa │ │ │ │ -00015db0: 7265 6e74 6865 7365 730a 2020 2020 2066 rentheses. f │ │ │ │ -00015dc0: 6f6c 6c6f 7769 6e67 2074 6578 7420 7468 ollowing text th │ │ │ │ -00015dd0: 6174 2074 7261 6e73 6c61 7465 7320 5859 at translates XY │ │ │ │ -00015de0: 5a20 696e 2061 6e6f 7468 6572 206c 616e Z in another lan │ │ │ │ -00015df0: 6775 6167 652e 2020 2848 6572 6520 5859 guage. (Here XY │ │ │ │ -00015e00: 5a0a 2020 2020 2073 7461 6e64 7320 666f Z. stands fo │ │ │ │ -00015e10: 7220 6120 7370 6563 6966 6963 2073 6563 r a specific sec │ │ │ │ -00015e20: 7469 6f6e 206e 616d 6520 6d65 6e74 696f tion name mentio │ │ │ │ -00015e30: 6e65 6420 6265 6c6f 772c 2073 7563 6820 ned below, such │ │ │ │ -00015e40: 6173 0a20 2020 2020 2241 636b 6e6f 776c as. "Acknowl │ │ │ │ -00015e50: 6564 6765 6d65 6e74 7322 2c20 2244 6564 edgements", "Ded │ │ │ │ -00015e60: 6963 6174 696f 6e73 222c 2022 456e 646f ications", "Endo │ │ │ │ -00015e70: 7273 656d 656e 7473 222c 206f 7220 2248 rsements", or "H │ │ │ │ -00015e80: 6973 746f 7279 222e 290a 2020 2020 2054 istory".). T │ │ │ │ -00015e90: 6f20 2250 7265 7365 7276 6520 7468 6520 o "Preserve the │ │ │ │ -00015ea0: 5469 746c 6522 206f 6620 7375 6368 2061 Title" of such a │ │ │ │ -00015eb0: 2073 6563 7469 6f6e 2077 6865 6e20 796f section when yo │ │ │ │ -00015ec0: 7520 6d6f 6469 6679 2074 6865 0a20 2020 u modify the. │ │ │ │ -00015ed0: 2020 446f 6375 6d65 6e74 206d 6561 6e73 Document means │ │ │ │ -00015ee0: 2074 6861 7420 6974 2072 656d 6169 6e73 that it remains │ │ │ │ -00015ef0: 2061 2073 6563 7469 6f6e 2022 456e 7469 a section "Enti │ │ │ │ -00015f00: 746c 6564 2058 595a 2220 6163 636f 7264 tled XYZ" accord │ │ │ │ -00015f10: 696e 670a 2020 2020 2074 6f20 7468 6973 ing. to this │ │ │ │ -00015f20: 2064 6566 696e 6974 696f 6e2e 0a0a 2020 definition... │ │ │ │ -00015f30: 2020 2054 6865 2044 6f63 756d 656e 7420 The Document │ │ │ │ -00015f40: 6d61 7920 696e 636c 7564 6520 5761 7272 may include Warr │ │ │ │ -00015f50: 616e 7479 2044 6973 636c 6169 6d65 7273 anty Disclaimers │ │ │ │ -00015f60: 206e 6578 7420 746f 2074 6865 206e 6f74 next to the not │ │ │ │ -00015f70: 6963 650a 2020 2020 2077 6869 6368 2073 ice. which s │ │ │ │ -00015f80: 7461 7465 7320 7468 6174 2074 6869 7320 tates that this │ │ │ │ -00015f90: 4c69 6365 6e73 6520 6170 706c 6965 7320 License applies │ │ │ │ -00015fa0: 746f 2074 6865 2044 6f63 756d 656e 742e to the Document. │ │ │ │ -00015fb0: 2020 5468 6573 650a 2020 2020 2057 6172 These. War │ │ │ │ -00015fc0: 7261 6e74 7920 4469 7363 6c61 696d 6572 ranty Disclaimer │ │ │ │ -00015fd0: 7320 6172 6520 636f 6e73 6964 6572 6564 s are considered │ │ │ │ -00015fe0: 2074 6f20 6265 2069 6e63 6c75 6465 6420 to be included │ │ │ │ -00015ff0: 6279 2072 6566 6572 656e 6365 2069 6e0a by reference in. │ │ │ │ -00016000: 2020 2020 2074 6869 7320 4c69 6365 6e73 this Licens │ │ │ │ -00016010: 652c 2062 7574 206f 6e6c 7920 6173 2072 e, but only as r │ │ │ │ -00016020: 6567 6172 6473 2064 6973 636c 6169 6d69 egards disclaimi │ │ │ │ -00016030: 6e67 2077 6172 7261 6e74 6965 733a 2061 ng warranties: a │ │ │ │ -00016040: 6e79 206f 7468 6572 0a20 2020 2020 696d ny other. im │ │ │ │ -00016050: 706c 6963 6174 696f 6e20 7468 6174 2074 plication that t │ │ │ │ -00016060: 6865 7365 2057 6172 7261 6e74 7920 4469 hese Warranty Di │ │ │ │ -00016070: 7363 6c61 696d 6572 7320 6d61 7920 6861 sclaimers may ha │ │ │ │ -00016080: 7665 2069 7320 766f 6964 2061 6e64 0a20 ve is void and. │ │ │ │ -00016090: 2020 2020 6861 7320 6e6f 2065 6666 6563 has no effec │ │ │ │ -000160a0: 7420 6f6e 2074 6865 206d 6561 6e69 6e67 t on the meaning │ │ │ │ -000160b0: 206f 6620 7468 6973 204c 6963 656e 7365 of this License │ │ │ │ -000160c0: 2e0a 0a20 2032 2e20 5645 5242 4154 494d ... 2. VERBATIM │ │ │ │ -000160d0: 2043 4f50 5949 4e47 0a0a 2020 2020 2059 COPYING.. Y │ │ │ │ -000160e0: 6f75 206d 6179 2063 6f70 7920 616e 6420 ou may copy and │ │ │ │ -000160f0: 6469 7374 7269 6275 7465 2074 6865 2044 distribute the D │ │ │ │ -00016100: 6f63 756d 656e 7420 696e 2061 6e79 206d ocument in any m │ │ │ │ -00016110: 6564 6975 6d2c 2065 6974 6865 720a 2020 edium, either. │ │ │ │ -00016120: 2020 2063 6f6d 6d65 7263 6961 6c6c 7920 commercially │ │ │ │ -00016130: 6f72 206e 6f6e 636f 6d6d 6572 6369 616c or noncommercial │ │ │ │ -00016140: 6c79 2c20 7072 6f76 6964 6564 2074 6861 ly, provided tha │ │ │ │ -00016150: 7420 7468 6973 204c 6963 656e 7365 2c20 t this License, │ │ │ │ -00016160: 7468 650a 2020 2020 2063 6f70 7972 6967 the. copyrig │ │ │ │ -00016170: 6874 206e 6f74 6963 6573 2c20 616e 6420 ht notices, and │ │ │ │ -00016180: 7468 6520 6c69 6365 6e73 6520 6e6f 7469 the license noti │ │ │ │ -00016190: 6365 2073 6179 696e 6720 7468 6973 204c ce saying this L │ │ │ │ -000161a0: 6963 656e 7365 0a20 2020 2020 6170 706c icense. appl │ │ │ │ -000161b0: 6965 7320 746f 2074 6865 2044 6f63 756d ies to the Docum │ │ │ │ -000161c0: 656e 7420 6172 6520 7265 7072 6f64 7563 ent are reproduc │ │ │ │ -000161d0: 6564 2069 6e20 616c 6c20 636f 7069 6573 ed in all copies │ │ │ │ -000161e0: 2c20 616e 6420 7468 6174 2079 6f75 0a20 , and that you. │ │ │ │ -000161f0: 2020 2020 6164 6420 6e6f 206f 7468 6572 add no other │ │ │ │ -00016200: 2063 6f6e 6469 7469 6f6e 7320 7768 6174 conditions what │ │ │ │ -00016210: 736f 6576 6572 2074 6f20 7468 6f73 6520 soever to those │ │ │ │ -00016220: 6f66 2074 6869 7320 4c69 6365 6e73 652e of this License. │ │ │ │ -00016230: 2020 596f 750a 2020 2020 206d 6179 206e You. may n │ │ │ │ -00016240: 6f74 2075 7365 2074 6563 686e 6963 616c ot use technical │ │ │ │ -00016250: 206d 6561 7375 7265 7320 746f 206f 6273 measures to obs │ │ │ │ -00016260: 7472 7563 7420 6f72 2063 6f6e 7472 6f6c truct or control │ │ │ │ -00016270: 2074 6865 2072 6561 6469 6e67 0a20 2020 the reading. │ │ │ │ -00016280: 2020 6f72 2066 7572 7468 6572 2063 6f70 or further cop │ │ │ │ -00016290: 7969 6e67 206f 6620 7468 6520 636f 7069 ying of the copi │ │ │ │ -000162a0: 6573 2079 6f75 206d 616b 6520 6f72 2064 es you make or d │ │ │ │ -000162b0: 6973 7472 6962 7574 652e 2020 486f 7765 istribute. Howe │ │ │ │ -000162c0: 7665 722c 0a20 2020 2020 796f 7520 6d61 ver,. you ma │ │ │ │ -000162d0: 7920 6163 6365 7074 2063 6f6d 7065 6e73 y accept compens │ │ │ │ -000162e0: 6174 696f 6e20 696e 2065 7863 6861 6e67 ation in exchang │ │ │ │ -000162f0: 6520 666f 7220 636f 7069 6573 2e20 2049 e for copies. I │ │ │ │ -00016300: 6620 796f 750a 2020 2020 2064 6973 7472 f you. distr │ │ │ │ -00016310: 6962 7574 6520 6120 6c61 7267 6520 656e ibute a large en │ │ │ │ -00016320: 6f75 6768 206e 756d 6265 7220 6f66 2063 ough number of c │ │ │ │ -00016330: 6f70 6965 7320 796f 7520 6d75 7374 2061 opies you must a │ │ │ │ -00016340: 6c73 6f20 666f 6c6c 6f77 2074 6865 0a20 lso follow the. │ │ │ │ -00016350: 2020 2020 636f 6e64 6974 696f 6e73 2069 conditions i │ │ │ │ -00016360: 6e20 7365 6374 696f 6e20 332e 0a0a 2020 n section 3... │ │ │ │ -00016370: 2020 2059 6f75 206d 6179 2061 6c73 6f20 You may also │ │ │ │ -00016380: 6c65 6e64 2063 6f70 6965 732c 2075 6e64 lend copies, und │ │ │ │ -00016390: 6572 2074 6865 2073 616d 6520 636f 6e64 er the same cond │ │ │ │ -000163a0: 6974 696f 6e73 2073 7461 7465 6420 6162 itions stated ab │ │ │ │ -000163b0: 6f76 652c 0a20 2020 2020 616e 6420 796f ove,. and yo │ │ │ │ -000163c0: 7520 6d61 7920 7075 626c 6963 6c79 2064 u may publicly d │ │ │ │ -000163d0: 6973 706c 6179 2063 6f70 6965 732e 0a0a isplay copies... │ │ │ │ -000163e0: 2020 332e 2043 4f50 5949 4e47 2049 4e20 3. COPYING IN │ │ │ │ -000163f0: 5155 414e 5449 5459 0a0a 2020 2020 2049 QUANTITY.. I │ │ │ │ -00016400: 6620 796f 7520 7075 626c 6973 6820 7072 f you publish pr │ │ │ │ -00016410: 696e 7465 6420 636f 7069 6573 2028 6f72 inted copies (or │ │ │ │ -00016420: 2063 6f70 6965 7320 696e 206d 6564 6961 copies in media │ │ │ │ -00016430: 2074 6861 7420 636f 6d6d 6f6e 6c79 0a20 that commonly. │ │ │ │ -00016440: 2020 2020 6861 7665 2070 7269 6e74 6564 have printed │ │ │ │ -00016450: 2063 6f76 6572 7329 206f 6620 7468 6520 covers) of the │ │ │ │ -00016460: 446f 6375 6d65 6e74 2c20 6e75 6d62 6572 Document, number │ │ │ │ -00016470: 696e 6720 6d6f 7265 2074 6861 6e20 3130 ing more than 10 │ │ │ │ -00016480: 302c 2061 6e64 0a20 2020 2020 7468 6520 0, and. the │ │ │ │ -00016490: 446f 6375 6d65 6e74 2773 206c 6963 656e Document's licen │ │ │ │ -000164a0: 7365 206e 6f74 6963 6520 7265 7175 6972 se notice requir │ │ │ │ -000164b0: 6573 2043 6f76 6572 2054 6578 7473 2c20 es Cover Texts, │ │ │ │ -000164c0: 796f 7520 6d75 7374 0a20 2020 2020 656e you must. en │ │ │ │ -000164d0: 636c 6f73 6520 7468 6520 636f 7069 6573 close the copies │ │ │ │ -000164e0: 2069 6e20 636f 7665 7273 2074 6861 7420 in covers that │ │ │ │ -000164f0: 6361 7272 792c 2063 6c65 6172 6c79 2061 carry, clearly a │ │ │ │ -00016500: 6e64 206c 6567 6962 6c79 2c20 616c 6c0a nd legibly, all. │ │ │ │ -00016510: 2020 2020 2074 6865 7365 2043 6f76 6572 these Cover │ │ │ │ -00016520: 2054 6578 7473 3a20 4672 6f6e 742d 436f Texts: Front-Co │ │ │ │ -00016530: 7665 7220 5465 7874 7320 6f6e 2074 6865 ver Texts on the │ │ │ │ -00016540: 2066 726f 6e74 2063 6f76 6572 2c20 616e front cover, an │ │ │ │ -00016550: 640a 2020 2020 2042 6163 6b2d 436f 7665 d. Back-Cove │ │ │ │ -00016560: 7220 5465 7874 7320 6f6e 2074 6865 2062 r Texts on the b │ │ │ │ -00016570: 6163 6b20 636f 7665 722e 2020 426f 7468 ack cover. Both │ │ │ │ -00016580: 2063 6f76 6572 7320 6d75 7374 2061 6c73 covers must als │ │ │ │ -00016590: 6f20 636c 6561 726c 790a 2020 2020 2061 o clearly. a │ │ │ │ -000165a0: 6e64 206c 6567 6962 6c79 2069 6465 6e74 nd legibly ident │ │ │ │ -000165b0: 6966 7920 796f 7520 6173 2074 6865 2070 ify you as the p │ │ │ │ -000165c0: 7562 6c69 7368 6572 206f 6620 7468 6573 ublisher of thes │ │ │ │ -000165d0: 6520 636f 7069 6573 2e20 2054 6865 0a20 e copies. The. │ │ │ │ -000165e0: 2020 2020 6672 6f6e 7420 636f 7665 7220 front cover │ │ │ │ -000165f0: 6d75 7374 2070 7265 7365 6e74 2074 6865 must present the │ │ │ │ -00016600: 2066 756c 6c20 7469 746c 6520 7769 7468 full title with │ │ │ │ -00016610: 2061 6c6c 2077 6f72 6473 206f 6620 7468 all words of th │ │ │ │ -00016620: 6520 7469 746c 650a 2020 2020 2065 7175 e title. equ │ │ │ │ -00016630: 616c 6c79 2070 726f 6d69 6e65 6e74 2061 ally prominent a │ │ │ │ -00016640: 6e64 2076 6973 6962 6c65 2e20 2059 6f75 nd visible. You │ │ │ │ -00016650: 206d 6179 2061 6464 206f 7468 6572 206d may add other m │ │ │ │ -00016660: 6174 6572 6961 6c20 6f6e 2074 6865 0a20 aterial on the. │ │ │ │ -00016670: 2020 2020 636f 7665 7273 2069 6e20 6164 covers in ad │ │ │ │ -00016680: 6469 7469 6f6e 2e20 2043 6f70 7969 6e67 dition. Copying │ │ │ │ -00016690: 2077 6974 6820 6368 616e 6765 7320 6c69 with changes li │ │ │ │ -000166a0: 6d69 7465 6420 746f 2074 6865 2063 6f76 mited to the cov │ │ │ │ -000166b0: 6572 732c 2061 730a 2020 2020 206c 6f6e ers, as. lon │ │ │ │ -000166c0: 6720 6173 2074 6865 7920 7072 6573 6572 g as they preser │ │ │ │ -000166d0: 7665 2074 6865 2074 6974 6c65 206f 6620 ve the title of │ │ │ │ -000166e0: 7468 6520 446f 6375 6d65 6e74 2061 6e64 the Document and │ │ │ │ -000166f0: 2073 6174 6973 6679 2074 6865 7365 0a20 satisfy these. │ │ │ │ -00016700: 2020 2020 636f 6e64 6974 696f 6e73 2c20 conditions, │ │ │ │ -00016710: 6361 6e20 6265 2074 7265 6174 6564 2061 can be treated a │ │ │ │ -00016720: 7320 7665 7262 6174 696d 2063 6f70 7969 s verbatim copyi │ │ │ │ -00016730: 6e67 2069 6e20 6f74 6865 7220 7265 7370 ng in other resp │ │ │ │ -00016740: 6563 7473 2e0a 0a20 2020 2020 4966 2074 ects... If t │ │ │ │ -00016750: 6865 2072 6571 7569 7265 6420 7465 7874 he required text │ │ │ │ -00016760: 7320 666f 7220 6569 7468 6572 2063 6f76 s for either cov │ │ │ │ -00016770: 6572 2061 7265 2074 6f6f 2076 6f6c 756d er are too volum │ │ │ │ -00016780: 696e 6f75 7320 746f 2066 6974 0a20 2020 inous to fit. │ │ │ │ -00016790: 2020 6c65 6769 626c 792c 2079 6f75 2073 legibly, you s │ │ │ │ -000167a0: 686f 756c 6420 7075 7420 7468 6520 6669 hould put the fi │ │ │ │ -000167b0: 7273 7420 6f6e 6573 206c 6973 7465 6420 rst ones listed │ │ │ │ -000167c0: 2861 7320 6d61 6e79 2061 7320 6669 740a (as many as fit. │ │ │ │ -000167d0: 2020 2020 2072 6561 736f 6e61 626c 7929 reasonably) │ │ │ │ -000167e0: 206f 6e20 7468 6520 6163 7475 616c 2063 on the actual c │ │ │ │ -000167f0: 6f76 6572 2c20 616e 6420 636f 6e74 696e over, and contin │ │ │ │ -00016800: 7565 2074 6865 2072 6573 7420 6f6e 746f ue the rest onto │ │ │ │ -00016810: 0a20 2020 2020 6164 6a61 6365 6e74 2070 . adjacent p │ │ │ │ -00016820: 6167 6573 2e0a 0a20 2020 2020 4966 2079 ages... If y │ │ │ │ -00016830: 6f75 2070 7562 6c69 7368 206f 7220 6469 ou publish or di │ │ │ │ -00016840: 7374 7269 6275 7465 204f 7061 7175 6520 stribute Opaque │ │ │ │ -00016850: 636f 7069 6573 206f 6620 7468 6520 446f copies of the Do │ │ │ │ -00016860: 6375 6d65 6e74 0a20 2020 2020 6e75 6d62 cument. numb │ │ │ │ -00016870: 6572 696e 6720 6d6f 7265 2074 6861 6e20 ering more than │ │ │ │ -00016880: 3130 302c 2079 6f75 206d 7573 7420 6569 100, you must ei │ │ │ │ -00016890: 7468 6572 2069 6e63 6c75 6465 2061 206d ther include a m │ │ │ │ -000168a0: 6163 6869 6e65 2d72 6561 6461 626c 650a achine-readable. │ │ │ │ -000168b0: 2020 2020 2054 7261 6e73 7061 7265 6e74 Transparent │ │ │ │ -000168c0: 2063 6f70 7920 616c 6f6e 6720 7769 7468 copy along with │ │ │ │ -000168d0: 2065 6163 6820 4f70 6171 7565 2063 6f70 each Opaque cop │ │ │ │ -000168e0: 792c 206f 7220 7374 6174 6520 696e 206f y, or state in o │ │ │ │ -000168f0: 7220 7769 7468 0a20 2020 2020 6561 6368 r with. each │ │ │ │ -00016900: 204f 7061 7175 6520 636f 7079 2061 2063 Opaque copy a c │ │ │ │ -00016910: 6f6d 7075 7465 722d 6e65 7477 6f72 6b20 omputer-network │ │ │ │ -00016920: 6c6f 6361 7469 6f6e 2066 726f 6d20 7768 location from wh │ │ │ │ -00016930: 6963 6820 7468 6520 6765 6e65 7261 6c0a ich the general. │ │ │ │ -00016940: 2020 2020 206e 6574 776f 726b 2d75 7369 network-usi │ │ │ │ -00016950: 6e67 2070 7562 6c69 6320 6861 7320 6163 ng public has ac │ │ │ │ -00016960: 6365 7373 2074 6f20 646f 776e 6c6f 6164 cess to download │ │ │ │ -00016970: 2075 7369 6e67 2070 7562 6c69 632d 7374 using public-st │ │ │ │ -00016980: 616e 6461 7264 0a20 2020 2020 6e65 7477 andard. netw │ │ │ │ -00016990: 6f72 6b20 7072 6f74 6f63 6f6c 7320 6120 ork protocols a │ │ │ │ -000169a0: 636f 6d70 6c65 7465 2054 7261 6e73 7061 complete Transpa │ │ │ │ -000169b0: 7265 6e74 2063 6f70 7920 6f66 2074 6865 rent copy of the │ │ │ │ -000169c0: 2044 6f63 756d 656e 742c 2066 7265 650a Document, free. │ │ │ │ -000169d0: 2020 2020 206f 6620 6164 6465 6420 6d61 of added ma │ │ │ │ -000169e0: 7465 7269 616c 2e20 2049 6620 796f 7520 terial. If you │ │ │ │ -000169f0: 7573 6520 7468 6520 6c61 7474 6572 206f use the latter o │ │ │ │ -00016a00: 7074 696f 6e2c 2079 6f75 206d 7573 7420 ption, you must │ │ │ │ -00016a10: 7461 6b65 0a20 2020 2020 7265 6173 6f6e take. reason │ │ │ │ -00016a20: 6162 6c79 2070 7275 6465 6e74 2073 7465 ably prudent ste │ │ │ │ -00016a30: 7073 2c20 7768 656e 2079 6f75 2062 6567 ps, when you beg │ │ │ │ -00016a40: 696e 2064 6973 7472 6962 7574 696f 6e20 in distribution │ │ │ │ -00016a50: 6f66 204f 7061 7175 650a 2020 2020 2063 of Opaque. c │ │ │ │ -00016a60: 6f70 6965 7320 696e 2071 7561 6e74 6974 opies in quantit │ │ │ │ -00016a70: 792c 2074 6f20 656e 7375 7265 2074 6861 y, to ensure tha │ │ │ │ -00016a80: 7420 7468 6973 2054 7261 6e73 7061 7265 t this Transpare │ │ │ │ -00016a90: 6e74 2063 6f70 7920 7769 6c6c 0a20 2020 nt copy will. │ │ │ │ -00016aa0: 2020 7265 6d61 696e 2074 6875 7320 6163 remain thus ac │ │ │ │ -00016ab0: 6365 7373 6962 6c65 2061 7420 7468 6520 cessible at the │ │ │ │ -00016ac0: 7374 6174 6564 206c 6f63 6174 696f 6e20 stated location │ │ │ │ -00016ad0: 756e 7469 6c20 6174 206c 6561 7374 206f until at least o │ │ │ │ -00016ae0: 6e65 0a20 2020 2020 7965 6172 2061 6674 ne. year aft │ │ │ │ -00016af0: 6572 2074 6865 206c 6173 7420 7469 6d65 er the last time │ │ │ │ -00016b00: 2079 6f75 2064 6973 7472 6962 7574 6520 you distribute │ │ │ │ -00016b10: 616e 204f 7061 7175 6520 636f 7079 2028 an Opaque copy ( │ │ │ │ -00016b20: 6469 7265 6374 6c79 206f 720a 2020 2020 directly or. │ │ │ │ -00016b30: 2074 6872 6f75 6768 2079 6f75 7220 6167 through your ag │ │ │ │ -00016b40: 656e 7473 206f 7220 7265 7461 696c 6572 ents or retailer │ │ │ │ -00016b50: 7329 206f 6620 7468 6174 2065 6469 7469 s) of that editi │ │ │ │ -00016b60: 6f6e 2074 6f20 7468 6520 7075 626c 6963 on to the public │ │ │ │ -00016b70: 2e0a 0a20 2020 2020 4974 2069 7320 7265 ... It is re │ │ │ │ -00016b80: 7175 6573 7465 642c 2062 7574 206e 6f74 quested, but not │ │ │ │ -00016b90: 2072 6571 7569 7265 642c 2074 6861 7420 required, that │ │ │ │ -00016ba0: 796f 7520 636f 6e74 6163 7420 7468 6520 you contact the │ │ │ │ -00016bb0: 6175 7468 6f72 7320 6f66 0a20 2020 2020 authors of. │ │ │ │ -00016bc0: 7468 6520 446f 6375 6d65 6e74 2077 656c the Document wel │ │ │ │ -00016bd0: 6c20 6265 666f 7265 2072 6564 6973 7472 l before redistr │ │ │ │ -00016be0: 6962 7574 696e 6720 616e 7920 6c61 7267 ibuting any larg │ │ │ │ -00016bf0: 6520 6e75 6d62 6572 206f 6620 636f 7069 e number of copi │ │ │ │ -00016c00: 6573 2c0a 2020 2020 2074 6f20 6769 7665 es,. to give │ │ │ │ -00016c10: 2074 6865 6d20 6120 6368 616e 6365 2074 them a chance t │ │ │ │ -00016c20: 6f20 7072 6f76 6964 6520 796f 7520 7769 o provide you wi │ │ │ │ -00016c30: 7468 2061 6e20 7570 6461 7465 6420 7665 th an updated ve │ │ │ │ -00016c40: 7273 696f 6e20 6f66 2074 6865 0a20 2020 rsion of the. │ │ │ │ -00016c50: 2020 446f 6375 6d65 6e74 2e0a 0a20 2034 Document... 4 │ │ │ │ -00016c60: 2e20 4d4f 4449 4649 4341 5449 4f4e 530a . MODIFICATIONS. │ │ │ │ -00016c70: 0a20 2020 2020 596f 7520 6d61 7920 636f . You may co │ │ │ │ -00016c80: 7079 2061 6e64 2064 6973 7472 6962 7574 py and distribut │ │ │ │ -00016c90: 6520 6120 4d6f 6469 6669 6564 2056 6572 e a Modified Ver │ │ │ │ -00016ca0: 7369 6f6e 206f 6620 7468 6520 446f 6375 sion of the Docu │ │ │ │ -00016cb0: 6d65 6e74 0a20 2020 2020 756e 6465 7220 ment. under │ │ │ │ -00016cc0: 7468 6520 636f 6e64 6974 696f 6e73 206f the conditions o │ │ │ │ -00016cd0: 6620 7365 6374 696f 6e73 2032 2061 6e64 f sections 2 and │ │ │ │ -00016ce0: 2033 2061 626f 7665 2c20 7072 6f76 6964 3 above, provid │ │ │ │ -00016cf0: 6564 2074 6861 7420 796f 750a 2020 2020 ed that you. │ │ │ │ -00016d00: 2072 656c 6561 7365 2074 6865 204d 6f64 release the Mod │ │ │ │ -00016d10: 6966 6965 6420 5665 7273 696f 6e20 756e ified Version un │ │ │ │ -00016d20: 6465 7220 7072 6563 6973 656c 7920 7468 der precisely th │ │ │ │ -00016d30: 6973 204c 6963 656e 7365 2c20 7769 7468 is License, with │ │ │ │ -00016d40: 2074 6865 0a20 2020 2020 4d6f 6469 6669 the. Modifi │ │ │ │ -00016d50: 6564 2056 6572 7369 6f6e 2066 696c 6c69 ed Version filli │ │ │ │ -00016d60: 6e67 2074 6865 2072 6f6c 6520 6f66 2074 ng the role of t │ │ │ │ -00016d70: 6865 2044 6f63 756d 656e 742c 2074 6875 he Document, thu │ │ │ │ -00016d80: 7320 6c69 6365 6e73 696e 670a 2020 2020 s licensing. │ │ │ │ -00016d90: 2064 6973 7472 6962 7574 696f 6e20 616e distribution an │ │ │ │ -00016da0: 6420 6d6f 6469 6669 6361 7469 6f6e 206f d modification o │ │ │ │ -00016db0: 6620 7468 6520 4d6f 6469 6669 6564 2056 f the Modified V │ │ │ │ -00016dc0: 6572 7369 6f6e 2074 6f20 7768 6f65 7665 ersion to whoeve │ │ │ │ -00016dd0: 720a 2020 2020 2070 6f73 7365 7373 6573 r. possesses │ │ │ │ -00016de0: 2061 2063 6f70 7920 6f66 2069 742e 2020 a copy of it. │ │ │ │ -00016df0: 496e 2061 6464 6974 696f 6e2c 2079 6f75 In addition, you │ │ │ │ -00016e00: 206d 7573 7420 646f 2074 6865 7365 2074 must do these t │ │ │ │ -00016e10: 6869 6e67 7320 696e 0a20 2020 2020 7468 hings in. th │ │ │ │ -00016e20: 6520 4d6f 6469 6669 6564 2056 6572 7369 e Modified Versi │ │ │ │ -00016e30: 6f6e 3a0a 0a20 2020 2020 2020 412e 2055 on:.. A. U │ │ │ │ -00016e40: 7365 2069 6e20 7468 6520 5469 746c 6520 se in the Title │ │ │ │ -00016e50: 5061 6765 2028 616e 6420 6f6e 2074 6865 Page (and on the │ │ │ │ -00016e60: 2063 6f76 6572 732c 2069 6620 616e 7929 covers, if any) │ │ │ │ -00016e70: 2061 2074 6974 6c65 0a20 2020 2020 2020 a title. │ │ │ │ -00016e80: 2020 2064 6973 7469 6e63 7420 6672 6f6d distinct from │ │ │ │ -00016e90: 2074 6861 7420 6f66 2074 6865 2044 6f63 that of the Doc │ │ │ │ -00016ea0: 756d 656e 742c 2061 6e64 2066 726f 6d20 ument, and from │ │ │ │ -00016eb0: 7468 6f73 6520 6f66 2070 7265 7669 6f75 those of previou │ │ │ │ -00016ec0: 730a 2020 2020 2020 2020 2020 7665 7273 s. vers │ │ │ │ -00016ed0: 696f 6e73 2028 7768 6963 6820 7368 6f75 ions (which shou │ │ │ │ -00016ee0: 6c64 2c20 6966 2074 6865 7265 2077 6572 ld, if there wer │ │ │ │ -00016ef0: 6520 616e 792c 2062 6520 6c69 7374 6564 e any, be listed │ │ │ │ -00016f00: 2069 6e20 7468 650a 2020 2020 2020 2020 in the. │ │ │ │ -00016f10: 2020 4869 7374 6f72 7920 7365 6374 696f History sectio │ │ │ │ -00016f20: 6e20 6f66 2074 6865 2044 6f63 756d 656e n of the Documen │ │ │ │ -00016f30: 7429 2e20 2059 6f75 206d 6179 2075 7365 t). You may use │ │ │ │ -00016f40: 2074 6865 2073 616d 6520 7469 746c 650a the same title. │ │ │ │ -00016f50: 2020 2020 2020 2020 2020 6173 2061 2070 as a p │ │ │ │ -00016f60: 7265 7669 6f75 7320 7665 7273 696f 6e20 revious version │ │ │ │ -00016f70: 6966 2074 6865 206f 7269 6769 6e61 6c20 if the original │ │ │ │ -00016f80: 7075 626c 6973 6865 7220 6f66 2074 6861 publisher of tha │ │ │ │ -00016f90: 740a 2020 2020 2020 2020 2020 7665 7273 t. vers │ │ │ │ -00016fa0: 696f 6e20 6769 7665 7320 7065 726d 6973 ion gives permis │ │ │ │ -00016fb0: 7369 6f6e 2e0a 0a20 2020 2020 2020 422e sion... B. │ │ │ │ -00016fc0: 204c 6973 7420 6f6e 2074 6865 2054 6974 List on the Tit │ │ │ │ -00016fd0: 6c65 2050 6167 652c 2061 7320 6175 7468 le Page, as auth │ │ │ │ -00016fe0: 6f72 732c 206f 6e65 206f 7220 6d6f 7265 ors, one or more │ │ │ │ -00016ff0: 2070 6572 736f 6e73 206f 720a 2020 2020 persons or. │ │ │ │ -00017000: 2020 2020 2020 656e 7469 7469 6573 2072 entities r │ │ │ │ -00017010: 6573 706f 6e73 6962 6c65 2066 6f72 2061 esponsible for a │ │ │ │ -00017020: 7574 686f 7273 6869 7020 6f66 2074 6865 uthorship of the │ │ │ │ -00017030: 206d 6f64 6966 6963 6174 696f 6e73 2069 modifications i │ │ │ │ -00017040: 6e0a 2020 2020 2020 2020 2020 7468 6520 n. the │ │ │ │ -00017050: 4d6f 6469 6669 6564 2056 6572 7369 6f6e Modified Version │ │ │ │ -00017060: 2c20 746f 6765 7468 6572 2077 6974 6820 , together with │ │ │ │ -00017070: 6174 206c 6561 7374 2066 6976 6520 6f66 at least five of │ │ │ │ -00017080: 2074 6865 0a20 2020 2020 2020 2020 2070 the. p │ │ │ │ -00017090: 7269 6e63 6970 616c 2061 7574 686f 7273 rincipal authors │ │ │ │ -000170a0: 206f 6620 7468 6520 446f 6375 6d65 6e74 of the Document │ │ │ │ -000170b0: 2028 616c 6c20 6f66 2069 7473 2070 7269 (all of its pri │ │ │ │ -000170c0: 6e63 6970 616c 0a20 2020 2020 2020 2020 ncipal. │ │ │ │ -000170d0: 2061 7574 686f 7273 2c20 6966 2069 7420 authors, if it │ │ │ │ -000170e0: 6861 7320 6665 7765 7220 7468 616e 2066 has fewer than f │ │ │ │ -000170f0: 6976 6529 2c20 756e 6c65 7373 2074 6865 ive), unless the │ │ │ │ -00017100: 7920 7265 6c65 6173 6520 796f 750a 2020 y release you. │ │ │ │ -00017110: 2020 2020 2020 2020 6672 6f6d 2074 6869 from thi │ │ │ │ -00017120: 7320 7265 7175 6972 656d 656e 742e 0a0a s requirement... │ │ │ │ -00017130: 2020 2020 2020 2043 2e20 5374 6174 6520 C. State │ │ │ │ -00017140: 6f6e 2074 6865 2054 6974 6c65 2070 6167 on the Title pag │ │ │ │ -00017150: 6520 7468 6520 6e61 6d65 206f 6620 7468 e the name of th │ │ │ │ -00017160: 6520 7075 626c 6973 6865 7220 6f66 2074 e publisher of t │ │ │ │ -00017170: 6865 0a20 2020 2020 2020 2020 204d 6f64 he. Mod │ │ │ │ -00017180: 6966 6965 6420 5665 7273 696f 6e2c 2061 ified Version, a │ │ │ │ -00017190: 7320 7468 6520 7075 626c 6973 6865 722e s the publisher. │ │ │ │ -000171a0: 0a0a 2020 2020 2020 2044 2e20 5072 6573 .. D. Pres │ │ │ │ -000171b0: 6572 7665 2061 6c6c 2074 6865 2063 6f70 erve all the cop │ │ │ │ -000171c0: 7972 6967 6874 206e 6f74 6963 6573 206f yright notices o │ │ │ │ -000171d0: 6620 7468 6520 446f 6375 6d65 6e74 2e0a f the Document.. │ │ │ │ -000171e0: 0a20 2020 2020 2020 452e 2041 6464 2061 . E. Add a │ │ │ │ -000171f0: 6e20 6170 7072 6f70 7269 6174 6520 636f n appropriate co │ │ │ │ -00017200: 7079 7269 6768 7420 6e6f 7469 6365 2066 pyright notice f │ │ │ │ -00017210: 6f72 2079 6f75 7220 6d6f 6469 6669 6361 or your modifica │ │ │ │ -00017220: 7469 6f6e 730a 2020 2020 2020 2020 2020 tions. │ │ │ │ -00017230: 6164 6a61 6365 6e74 2074 6f20 7468 6520 adjacent to the │ │ │ │ -00017240: 6f74 6865 7220 636f 7079 7269 6768 7420 other copyright │ │ │ │ -00017250: 6e6f 7469 6365 732e 0a0a 2020 2020 2020 notices... │ │ │ │ -00017260: 2046 2e20 496e 636c 7564 652c 2069 6d6d F. Include, imm │ │ │ │ -00017270: 6564 6961 7465 6c79 2061 6674 6572 2074 ediately after t │ │ │ │ -00017280: 6865 2063 6f70 7972 6967 6874 206e 6f74 he copyright not │ │ │ │ -00017290: 6963 6573 2c20 6120 6c69 6365 6e73 650a ices, a license. │ │ │ │ -000172a0: 2020 2020 2020 2020 2020 6e6f 7469 6365 notice │ │ │ │ -000172b0: 2067 6976 696e 6720 7468 6520 7075 626c giving the publ │ │ │ │ -000172c0: 6963 2070 6572 6d69 7373 696f 6e20 746f ic permission to │ │ │ │ -000172d0: 2075 7365 2074 6865 204d 6f64 6966 6965 use the Modifie │ │ │ │ -000172e0: 640a 2020 2020 2020 2020 2020 5665 7273 d. Vers │ │ │ │ -000172f0: 696f 6e20 756e 6465 7220 7468 6520 7465 ion under the te │ │ │ │ -00017300: 726d 7320 6f66 2074 6869 7320 4c69 6365 rms of this Lice │ │ │ │ -00017310: 6e73 652c 2069 6e20 7468 6520 666f 726d nse, in the form │ │ │ │ -00017320: 2073 686f 776e 2069 6e0a 2020 2020 2020 shown in. │ │ │ │ -00017330: 2020 2020 7468 6520 4164 6465 6e64 756d the Addendum │ │ │ │ -00017340: 2062 656c 6f77 2e0a 0a20 2020 2020 2020 below... │ │ │ │ -00017350: 472e 2050 7265 7365 7276 6520 696e 2074 G. Preserve in t │ │ │ │ -00017360: 6861 7420 6c69 6365 6e73 6520 6e6f 7469 hat license noti │ │ │ │ -00017370: 6365 2074 6865 2066 756c 6c20 6c69 7374 ce the full list │ │ │ │ -00017380: 7320 6f66 2049 6e76 6172 6961 6e74 0a20 s of Invariant. │ │ │ │ -00017390: 2020 2020 2020 2020 2053 6563 7469 6f6e Section │ │ │ │ -000173a0: 7320 616e 6420 7265 7175 6972 6564 2043 s and required C │ │ │ │ -000173b0: 6f76 6572 2054 6578 7473 2067 6976 656e over Texts given │ │ │ │ -000173c0: 2069 6e20 7468 6520 446f 6375 6d65 6e74 in the Document │ │ │ │ -000173d0: 2773 0a20 2020 2020 2020 2020 206c 6963 's. lic │ │ │ │ -000173e0: 656e 7365 206e 6f74 6963 652e 0a0a 2020 ense notice... │ │ │ │ -000173f0: 2020 2020 2048 2e20 496e 636c 7564 6520 H. Include │ │ │ │ -00017400: 616e 2075 6e61 6c74 6572 6564 2063 6f70 an unaltered cop │ │ │ │ -00017410: 7920 6f66 2074 6869 7320 4c69 6365 6e73 y of this Licens │ │ │ │ -00017420: 652e 0a0a 2020 2020 2020 2049 2e20 5072 e... I. Pr │ │ │ │ -00017430: 6573 6572 7665 2074 6865 2073 6563 7469 eserve the secti │ │ │ │ -00017440: 6f6e 2045 6e74 6974 6c65 6420 2248 6973 on Entitled "His │ │ │ │ -00017450: 746f 7279 222c 2050 7265 7365 7276 6520 tory", Preserve │ │ │ │ -00017460: 6974 7320 5469 746c 652c 0a20 2020 2020 its Title,. │ │ │ │ -00017470: 2020 2020 2061 6e64 2061 6464 2074 6f20 and add to │ │ │ │ -00017480: 6974 2061 6e20 6974 656d 2073 7461 7469 it an item stati │ │ │ │ -00017490: 6e67 2061 7420 6c65 6173 7420 7468 6520 ng at least the │ │ │ │ -000174a0: 7469 746c 652c 2079 6561 722c 206e 6577 title, year, new │ │ │ │ -000174b0: 0a20 2020 2020 2020 2020 2061 7574 686f . autho │ │ │ │ -000174c0: 7273 2c20 616e 6420 7075 626c 6973 6865 rs, and publishe │ │ │ │ -000174d0: 7220 6f66 2074 6865 204d 6f64 6966 6965 r of the Modifie │ │ │ │ -000174e0: 6420 5665 7273 696f 6e20 6173 2067 6976 d Version as giv │ │ │ │ -000174f0: 656e 206f 6e20 7468 650a 2020 2020 2020 en on the. │ │ │ │ -00017500: 2020 2020 5469 746c 6520 5061 6765 2e20 Title Page. │ │ │ │ -00017510: 2049 6620 7468 6572 6520 6973 206e 6f20 If there is no │ │ │ │ -00017520: 7365 6374 696f 6e20 456e 7469 746c 6564 section Entitled │ │ │ │ -00017530: 2022 4869 7374 6f72 7922 2069 6e20 7468 "History" in th │ │ │ │ -00017540: 650a 2020 2020 2020 2020 2020 446f 6375 e. Docu │ │ │ │ -00017550: 6d65 6e74 2c20 6372 6561 7465 206f 6e65 ment, create one │ │ │ │ -00017560: 2073 7461 7469 6e67 2074 6865 2074 6974 stating the tit │ │ │ │ -00017570: 6c65 2c20 7965 6172 2c20 6175 7468 6f72 le, year, author │ │ │ │ -00017580: 732c 2061 6e64 0a20 2020 2020 2020 2020 s, and. │ │ │ │ -00017590: 2070 7562 6c69 7368 6572 206f 6620 7468 publisher of th │ │ │ │ -000175a0: 6520 446f 6375 6d65 6e74 2061 7320 6769 e Document as gi │ │ │ │ -000175b0: 7665 6e20 6f6e 2069 7473 2054 6974 6c65 ven on its Title │ │ │ │ -000175c0: 2050 6167 652c 2074 6865 6e20 6164 640a Page, then add. │ │ │ │ -000175d0: 2020 2020 2020 2020 2020 616e 2069 7465 an ite │ │ │ │ -000175e0: 6d20 6465 7363 7269 6269 6e67 2074 6865 m describing the │ │ │ │ -000175f0: 204d 6f64 6966 6965 6420 5665 7273 696f Modified Versio │ │ │ │ -00017600: 6e20 6173 2073 7461 7465 6420 696e 2074 n as stated in t │ │ │ │ -00017610: 6865 0a20 2020 2020 2020 2020 2070 7265 he. pre │ │ │ │ -00017620: 7669 6f75 7320 7365 6e74 656e 6365 2e0a vious sentence.. │ │ │ │ -00017630: 0a20 2020 2020 2020 4a2e 2050 7265 7365 . J. Prese │ │ │ │ -00017640: 7276 6520 7468 6520 6e65 7477 6f72 6b20 rve the network │ │ │ │ -00017650: 6c6f 6361 7469 6f6e 2c20 6966 2061 6e79 location, if any │ │ │ │ -00017660: 2c20 6769 7665 6e20 696e 2074 6865 2044 , given in the D │ │ │ │ -00017670: 6f63 756d 656e 740a 2020 2020 2020 2020 ocument. │ │ │ │ -00017680: 2020 666f 7220 7075 626c 6963 2061 6363 for public acc │ │ │ │ -00017690: 6573 7320 746f 2061 2054 7261 6e73 7061 ess to a Transpa │ │ │ │ -000176a0: 7265 6e74 2063 6f70 7920 6f66 2074 6865 rent copy of the │ │ │ │ -000176b0: 2044 6f63 756d 656e 742c 2061 6e64 0a20 Document, and. │ │ │ │ -000176c0: 2020 2020 2020 2020 206c 696b 6577 6973 likewis │ │ │ │ -000176d0: 6520 7468 6520 6e65 7477 6f72 6b20 6c6f e the network lo │ │ │ │ -000176e0: 6361 7469 6f6e 7320 6769 7665 6e20 696e cations given in │ │ │ │ -000176f0: 2074 6865 2044 6f63 756d 656e 7420 666f the Document fo │ │ │ │ -00017700: 720a 2020 2020 2020 2020 2020 7072 6576 r. prev │ │ │ │ -00017710: 696f 7573 2076 6572 7369 6f6e 7320 6974 ious versions it │ │ │ │ -00017720: 2077 6173 2062 6173 6564 206f 6e2e 2020 was based on. │ │ │ │ -00017730: 5468 6573 6520 6d61 7920 6265 2070 6c61 These may be pla │ │ │ │ -00017740: 6365 6420 696e 2074 6865 0a20 2020 2020 ced in the. │ │ │ │ -00017750: 2020 2020 2022 4869 7374 6f72 7922 2073 "History" s │ │ │ │ -00017760: 6563 7469 6f6e 2e20 2059 6f75 206d 6179 ection. You may │ │ │ │ -00017770: 206f 6d69 7420 6120 6e65 7477 6f72 6b20 omit a network │ │ │ │ -00017780: 6c6f 6361 7469 6f6e 2066 6f72 2061 2077 location for a w │ │ │ │ -00017790: 6f72 6b0a 2020 2020 2020 2020 2020 7468 ork. th │ │ │ │ -000177a0: 6174 2077 6173 2070 7562 6c69 7368 6564 at was published │ │ │ │ -000177b0: 2061 7420 6c65 6173 7420 666f 7572 2079 at least four y │ │ │ │ -000177c0: 6561 7273 2062 6566 6f72 6520 7468 6520 ears before the │ │ │ │ -000177d0: 446f 6375 6d65 6e74 0a20 2020 2020 2020 Document. │ │ │ │ -000177e0: 2020 2069 7473 656c 662c 206f 7220 6966 itself, or if │ │ │ │ -000177f0: 2074 6865 206f 7269 6769 6e61 6c20 7075 the original pu │ │ │ │ -00017800: 626c 6973 6865 7220 6f66 2074 6865 2076 blisher of the v │ │ │ │ -00017810: 6572 7369 6f6e 2069 7420 7265 6665 7273 ersion it refers │ │ │ │ -00017820: 0a20 2020 2020 2020 2020 2074 6f20 6769 . to gi │ │ │ │ -00017830: 7665 7320 7065 726d 6973 7369 6f6e 2e0a ves permission.. │ │ │ │ -00017840: 0a20 2020 2020 2020 4b2e 2046 6f72 2061 . K. For a │ │ │ │ -00017850: 6e79 2073 6563 7469 6f6e 2045 6e74 6974 ny section Entit │ │ │ │ -00017860: 6c65 6420 2241 636b 6e6f 776c 6564 6765 led "Acknowledge │ │ │ │ -00017870: 6d65 6e74 7322 206f 7220 2244 6564 6963 ments" or "Dedic │ │ │ │ -00017880: 6174 696f 6e73 222c 0a20 2020 2020 2020 ations",. │ │ │ │ -00017890: 2020 2050 7265 7365 7276 6520 7468 6520 Preserve the │ │ │ │ -000178a0: 5469 746c 6520 6f66 2074 6865 2073 6563 Title of the sec │ │ │ │ -000178b0: 7469 6f6e 2c20 616e 6420 7072 6573 6572 tion, and preser │ │ │ │ -000178c0: 7665 2069 6e20 7468 6520 7365 6374 696f ve in the sectio │ │ │ │ -000178d0: 6e0a 2020 2020 2020 2020 2020 616c 6c20 n. all │ │ │ │ -000178e0: 7468 6520 7375 6273 7461 6e63 6520 616e the substance an │ │ │ │ -000178f0: 6420 746f 6e65 206f 6620 6561 6368 206f d tone of each o │ │ │ │ -00017900: 6620 7468 6520 636f 6e74 7269 6275 746f f the contributo │ │ │ │ -00017910: 720a 2020 2020 2020 2020 2020 6163 6b6e r. ackn │ │ │ │ -00017920: 6f77 6c65 6467 656d 656e 7473 2061 6e64 owledgements and │ │ │ │ -00017930: 2f6f 7220 6465 6469 6361 7469 6f6e 7320 /or dedications │ │ │ │ -00017940: 6769 7665 6e20 7468 6572 6569 6e2e 0a0a given therein... │ │ │ │ -00017950: 2020 2020 2020 204c 2e20 5072 6573 6572 L. Preser │ │ │ │ -00017960: 7665 2061 6c6c 2074 6865 2049 6e76 6172 ve all the Invar │ │ │ │ -00017970: 6961 6e74 2053 6563 7469 6f6e 7320 6f66 iant Sections of │ │ │ │ -00017980: 2074 6865 2044 6f63 756d 656e 742c 2075 the Document, u │ │ │ │ -00017990: 6e61 6c74 6572 6564 0a20 2020 2020 2020 naltered. │ │ │ │ -000179a0: 2020 2069 6e20 7468 6569 7220 7465 7874 in their text │ │ │ │ -000179b0: 2061 6e64 2069 6e20 7468 6569 7220 7469 and in their ti │ │ │ │ -000179c0: 746c 6573 2e20 2053 6563 7469 6f6e 206e tles. Section n │ │ │ │ -000179d0: 756d 6265 7273 206f 7220 7468 650a 2020 umbers or the. │ │ │ │ -000179e0: 2020 2020 2020 2020 6571 7569 7661 6c65 equivale │ │ │ │ -000179f0: 6e74 2061 7265 206e 6f74 2063 6f6e 7369 nt are not consi │ │ │ │ -00017a00: 6465 7265 6420 7061 7274 206f 6620 7468 dered part of th │ │ │ │ -00017a10: 6520 7365 6374 696f 6e20 7469 746c 6573 e section titles │ │ │ │ -00017a20: 2e0a 0a20 2020 2020 2020 4d2e 2044 656c ... M. Del │ │ │ │ -00017a30: 6574 6520 616e 7920 7365 6374 696f 6e20 ete any section │ │ │ │ -00017a40: 456e 7469 746c 6564 2022 456e 646f 7273 Entitled "Endors │ │ │ │ -00017a50: 656d 656e 7473 222e 2020 5375 6368 2061 ements". Such a │ │ │ │ -00017a60: 2073 6563 7469 6f6e 0a20 2020 2020 2020 section. │ │ │ │ -00017a70: 2020 206d 6179 206e 6f74 2062 6520 696e may not be in │ │ │ │ -00017a80: 636c 7564 6564 2069 6e20 7468 6520 4d6f cluded in the Mo │ │ │ │ -00017a90: 6469 6669 6564 2056 6572 7369 6f6e 2e0a dified Version.. │ │ │ │ -00017aa0: 0a20 2020 2020 2020 4e2e 2044 6f20 6e6f . N. Do no │ │ │ │ -00017ab0: 7420 7265 7469 746c 6520 616e 7920 6578 t retitle any ex │ │ │ │ -00017ac0: 6973 7469 6e67 2073 6563 7469 6f6e 2074 isting section t │ │ │ │ -00017ad0: 6f20 6265 2045 6e74 6974 6c65 640a 2020 o be Entitled. │ │ │ │ -00017ae0: 2020 2020 2020 2020 2245 6e64 6f72 7365 "Endorse │ │ │ │ -00017af0: 6d65 6e74 7322 206f 7220 746f 2063 6f6e ments" or to con │ │ │ │ -00017b00: 666c 6963 7420 696e 2074 6974 6c65 2077 flict in title w │ │ │ │ -00017b10: 6974 6820 616e 7920 496e 7661 7269 616e ith any Invarian │ │ │ │ -00017b20: 740a 2020 2020 2020 2020 2020 5365 6374 t. Sect │ │ │ │ -00017b30: 696f 6e2e 0a0a 2020 2020 2020 204f 2e20 ion... O. │ │ │ │ -00017b40: 5072 6573 6572 7665 2061 6e79 2057 6172 Preserve any War │ │ │ │ -00017b50: 7261 6e74 7920 4469 7363 6c61 696d 6572 ranty Disclaimer │ │ │ │ -00017b60: 732e 0a0a 2020 2020 2049 6620 7468 6520 s... If the │ │ │ │ -00017b70: 4d6f 6469 6669 6564 2056 6572 7369 6f6e Modified Version │ │ │ │ -00017b80: 2069 6e63 6c75 6465 7320 6e65 7720 6672 includes new fr │ │ │ │ -00017b90: 6f6e 742d 6d61 7474 6572 2073 6563 7469 ont-matter secti │ │ │ │ -00017ba0: 6f6e 7320 6f72 0a20 2020 2020 6170 7065 ons or. appe │ │ │ │ -00017bb0: 6e64 6963 6573 2074 6861 7420 7175 616c ndices that qual │ │ │ │ -00017bc0: 6966 7920 6173 2053 6563 6f6e 6461 7279 ify as Secondary │ │ │ │ -00017bd0: 2053 6563 7469 6f6e 7320 616e 6420 636f Sections and co │ │ │ │ -00017be0: 6e74 6169 6e20 6e6f 0a20 2020 2020 6d61 ntain no. ma │ │ │ │ -00017bf0: 7465 7269 616c 2063 6f70 6965 6420 6672 terial copied fr │ │ │ │ -00017c00: 6f6d 2074 6865 2044 6f63 756d 656e 742c om the Document, │ │ │ │ -00017c10: 2079 6f75 206d 6179 2061 7420 796f 7572 you may at your │ │ │ │ -00017c20: 206f 7074 696f 6e20 6465 7369 676e 6174 option designat │ │ │ │ -00017c30: 650a 2020 2020 2073 6f6d 6520 6f72 2061 e. some or a │ │ │ │ -00017c40: 6c6c 206f 6620 7468 6573 6520 7365 6374 ll of these sect │ │ │ │ -00017c50: 696f 6e73 2061 7320 696e 7661 7269 616e ions as invarian │ │ │ │ -00017c60: 742e 2020 546f 2064 6f20 7468 6973 2c20 t. To do this, │ │ │ │ -00017c70: 6164 6420 7468 6569 720a 2020 2020 2074 add their. t │ │ │ │ -00017c80: 6974 6c65 7320 746f 2074 6865 206c 6973 itles to the lis │ │ │ │ -00017c90: 7420 6f66 2049 6e76 6172 6961 6e74 2053 t of Invariant S │ │ │ │ -00017ca0: 6563 7469 6f6e 7320 696e 2074 6865 204d ections in the M │ │ │ │ -00017cb0: 6f64 6966 6965 6420 5665 7273 696f 6e27 odified Version' │ │ │ │ -00017cc0: 730a 2020 2020 206c 6963 656e 7365 206e s. license n │ │ │ │ -00017cd0: 6f74 6963 652e 2020 5468 6573 6520 7469 otice. These ti │ │ │ │ -00017ce0: 746c 6573 206d 7573 7420 6265 2064 6973 tles must be dis │ │ │ │ -00017cf0: 7469 6e63 7420 6672 6f6d 2061 6e79 206f tinct from any o │ │ │ │ -00017d00: 7468 6572 0a20 2020 2020 7365 6374 696f ther. sectio │ │ │ │ -00017d10: 6e20 7469 746c 6573 2e0a 0a20 2020 2020 n titles... │ │ │ │ -00017d20: 596f 7520 6d61 7920 6164 6420 6120 7365 You may add a se │ │ │ │ -00017d30: 6374 696f 6e20 456e 7469 746c 6564 2022 ction Entitled " │ │ │ │ -00017d40: 456e 646f 7273 656d 656e 7473 222c 2070 Endorsements", p │ │ │ │ -00017d50: 726f 7669 6465 6420 6974 2063 6f6e 7461 rovided it conta │ │ │ │ -00017d60: 696e 730a 2020 2020 206e 6f74 6869 6e67 ins. nothing │ │ │ │ -00017d70: 2062 7574 2065 6e64 6f72 7365 6d65 6e74 but endorsement │ │ │ │ -00017d80: 7320 6f66 2079 6f75 7220 4d6f 6469 6669 s of your Modifi │ │ │ │ -00017d90: 6564 2056 6572 7369 6f6e 2062 7920 7661 ed Version by va │ │ │ │ -00017da0: 7269 6f75 730a 2020 2020 2070 6172 7469 rious. parti │ │ │ │ -00017db0: 6573 2d2d 666f 7220 6578 616d 706c 652c es--for example, │ │ │ │ -00017dc0: 2073 7461 7465 6d65 6e74 7320 6f66 2070 statements of p │ │ │ │ -00017dd0: 6565 7220 7265 7669 6577 206f 7220 7468 eer review or th │ │ │ │ -00017de0: 6174 2074 6865 2074 6578 740a 2020 2020 at the text. │ │ │ │ -00017df0: 2068 6173 2062 6565 6e20 6170 7072 6f76 has been approv │ │ │ │ -00017e00: 6564 2062 7920 616e 206f 7267 616e 697a ed by an organiz │ │ │ │ -00017e10: 6174 696f 6e20 6173 2074 6865 2061 7574 ation as the aut │ │ │ │ -00017e20: 686f 7269 7461 7469 7665 0a20 2020 2020 horitative. │ │ │ │ -00017e30: 6465 6669 6e69 7469 6f6e 206f 6620 6120 definition of a │ │ │ │ -00017e40: 7374 616e 6461 7264 2e0a 0a20 2020 2020 standard... │ │ │ │ -00017e50: 596f 7520 6d61 7920 6164 6420 6120 7061 You may add a pa │ │ │ │ -00017e60: 7373 6167 6520 6f66 2075 7020 746f 2066 ssage of up to f │ │ │ │ -00017e70: 6976 6520 776f 7264 7320 6173 2061 2046 ive words as a F │ │ │ │ -00017e80: 726f 6e74 2d43 6f76 6572 2054 6578 742c ront-Cover Text, │ │ │ │ -00017e90: 0a20 2020 2020 616e 6420 6120 7061 7373 . and a pass │ │ │ │ -00017ea0: 6167 6520 6f66 2075 7020 746f 2032 3520 age of up to 25 │ │ │ │ -00017eb0: 776f 7264 7320 6173 2061 2042 6163 6b2d words as a Back- │ │ │ │ -00017ec0: 436f 7665 7220 5465 7874 2c20 746f 2074 Cover Text, to t │ │ │ │ -00017ed0: 6865 2065 6e64 206f 660a 2020 2020 2074 he end of. t │ │ │ │ -00017ee0: 6865 206c 6973 7420 6f66 2043 6f76 6572 he list of Cover │ │ │ │ -00017ef0: 2054 6578 7473 2069 6e20 7468 6520 4d6f Texts in the Mo │ │ │ │ -00017f00: 6469 6669 6564 2056 6572 7369 6f6e 2e20 dified Version. │ │ │ │ -00017f10: 204f 6e6c 7920 6f6e 6520 7061 7373 6167 Only one passag │ │ │ │ -00017f20: 650a 2020 2020 206f 6620 4672 6f6e 742d e. of Front- │ │ │ │ -00017f30: 436f 7665 7220 5465 7874 2061 6e64 206f Cover Text and o │ │ │ │ -00017f40: 6e65 206f 6620 4261 636b 2d43 6f76 6572 ne of Back-Cover │ │ │ │ -00017f50: 2054 6578 7420 6d61 7920 6265 2061 6464 Text may be add │ │ │ │ -00017f60: 6564 2062 7920 286f 720a 2020 2020 2074 ed by (or. t │ │ │ │ -00017f70: 6872 6f75 6768 2061 7272 616e 6765 6d65 hrough arrangeme │ │ │ │ -00017f80: 6e74 7320 6d61 6465 2062 7929 2061 6e79 nts made by) any │ │ │ │ -00017f90: 206f 6e65 2065 6e74 6974 792e 2020 4966 one entity. If │ │ │ │ -00017fa0: 2074 6865 2044 6f63 756d 656e 740a 2020 the Document. │ │ │ │ -00017fb0: 2020 2061 6c72 6561 6479 2069 6e63 6c75 already inclu │ │ │ │ -00017fc0: 6465 7320 6120 636f 7665 7220 7465 7874 des a cover text │ │ │ │ -00017fd0: 2066 6f72 2074 6865 2073 616d 6520 636f for the same co │ │ │ │ -00017fe0: 7665 722c 2070 7265 7669 6f75 736c 7920 ver, previously │ │ │ │ -00017ff0: 6164 6465 640a 2020 2020 2062 7920 796f added. by yo │ │ │ │ -00018000: 7520 6f72 2062 7920 6172 7261 6e67 656d u or by arrangem │ │ │ │ -00018010: 656e 7420 6d61 6465 2062 7920 7468 6520 ent made by the │ │ │ │ -00018020: 7361 6d65 2065 6e74 6974 7920 796f 7520 same entity you │ │ │ │ -00018030: 6172 6520 6163 7469 6e67 206f 6e0a 2020 are acting on. │ │ │ │ -00018040: 2020 2062 6568 616c 6620 6f66 2c20 796f behalf of, yo │ │ │ │ -00018050: 7520 6d61 7920 6e6f 7420 6164 6420 616e u may not add an │ │ │ │ -00018060: 6f74 6865 723b 2062 7574 2079 6f75 206d other; but you m │ │ │ │ -00018070: 6179 2072 6570 6c61 6365 2074 6865 206f ay replace the o │ │ │ │ -00018080: 6c64 0a20 2020 2020 6f6e 652c 206f 6e20 ld. one, on │ │ │ │ -00018090: 6578 706c 6963 6974 2070 6572 6d69 7373 explicit permiss │ │ │ │ -000180a0: 696f 6e20 6672 6f6d 2074 6865 2070 7265 ion from the pre │ │ │ │ -000180b0: 7669 6f75 7320 7075 626c 6973 6865 7220 vious publisher │ │ │ │ -000180c0: 7468 6174 2061 6464 6564 0a20 2020 2020 that added. │ │ │ │ -000180d0: 7468 6520 6f6c 6420 6f6e 652e 0a0a 2020 the old one... │ │ │ │ -000180e0: 2020 2054 6865 2061 7574 686f 7228 7329 The author(s) │ │ │ │ -000180f0: 2061 6e64 2070 7562 6c69 7368 6572 2873 and publisher(s │ │ │ │ -00018100: 2920 6f66 2074 6865 2044 6f63 756d 656e ) of the Documen │ │ │ │ -00018110: 7420 646f 206e 6f74 2062 7920 7468 6973 t do not by this │ │ │ │ -00018120: 0a20 2020 2020 4c69 6365 6e73 6520 6769 . License gi │ │ │ │ -00018130: 7665 2070 6572 6d69 7373 696f 6e20 746f ve permission to │ │ │ │ -00018140: 2075 7365 2074 6865 6972 206e 616d 6573 use their names │ │ │ │ -00018150: 2066 6f72 2070 7562 6c69 6369 7479 2066 for publicity f │ │ │ │ -00018160: 6f72 206f 7220 746f 0a20 2020 2020 6173 or or to. as │ │ │ │ -00018170: 7365 7274 206f 7220 696d 706c 7920 656e sert or imply en │ │ │ │ -00018180: 646f 7273 656d 656e 7420 6f66 2061 6e79 dorsement of any │ │ │ │ -00018190: 204d 6f64 6966 6965 6420 5665 7273 696f Modified Versio │ │ │ │ -000181a0: 6e2e 0a0a 2020 352e 2043 4f4d 4249 4e49 n... 5. COMBINI │ │ │ │ -000181b0: 4e47 2044 4f43 554d 454e 5453 0a0a 2020 NG DOCUMENTS.. │ │ │ │ -000181c0: 2020 2059 6f75 206d 6179 2063 6f6d 6269 You may combi │ │ │ │ -000181d0: 6e65 2074 6865 2044 6f63 756d 656e 7420 ne the Document │ │ │ │ -000181e0: 7769 7468 206f 7468 6572 2064 6f63 756d with other docum │ │ │ │ -000181f0: 656e 7473 2072 656c 6561 7365 6420 756e ents released un │ │ │ │ -00018200: 6465 720a 2020 2020 2074 6869 7320 4c69 der. this Li │ │ │ │ -00018210: 6365 6e73 652c 2075 6e64 6572 2074 6865 cense, under the │ │ │ │ -00018220: 2074 6572 6d73 2064 6566 696e 6564 2069 terms defined i │ │ │ │ -00018230: 6e20 7365 6374 696f 6e20 3420 6162 6f76 n section 4 abov │ │ │ │ -00018240: 6520 666f 720a 2020 2020 206d 6f64 6966 e for. modif │ │ │ │ -00018250: 6965 6420 7665 7273 696f 6e73 2c20 7072 ied versions, pr │ │ │ │ -00018260: 6f76 6964 6564 2074 6861 7420 796f 7520 ovided that you │ │ │ │ -00018270: 696e 636c 7564 6520 696e 2074 6865 2063 include in the c │ │ │ │ -00018280: 6f6d 6269 6e61 7469 6f6e 2061 6c6c 0a20 ombination all. │ │ │ │ -00018290: 2020 2020 6f66 2074 6865 2049 6e76 6172 of the Invar │ │ │ │ -000182a0: 6961 6e74 2053 6563 7469 6f6e 7320 6f66 iant Sections of │ │ │ │ -000182b0: 2061 6c6c 206f 6620 7468 6520 6f72 6967 all of the orig │ │ │ │ -000182c0: 696e 616c 2064 6f63 756d 656e 7473 2c0a inal documents,. │ │ │ │ -000182d0: 2020 2020 2075 6e6d 6f64 6966 6965 642c unmodified, │ │ │ │ -000182e0: 2061 6e64 206c 6973 7420 7468 656d 2061 and list them a │ │ │ │ -000182f0: 6c6c 2061 7320 496e 7661 7269 616e 7420 ll as Invariant │ │ │ │ -00018300: 5365 6374 696f 6e73 206f 6620 796f 7572 Sections of your │ │ │ │ -00018310: 0a20 2020 2020 636f 6d62 696e 6564 2077 . combined w │ │ │ │ -00018320: 6f72 6b20 696e 2069 7473 206c 6963 656e ork in its licen │ │ │ │ -00018330: 7365 206e 6f74 6963 652c 2061 6e64 2074 se notice, and t │ │ │ │ -00018340: 6861 7420 796f 7520 7072 6573 6572 7665 hat you preserve │ │ │ │ -00018350: 2061 6c6c 0a20 2020 2020 7468 6569 7220 all. their │ │ │ │ -00018360: 5761 7272 616e 7479 2044 6973 636c 6169 Warranty Disclai │ │ │ │ -00018370: 6d65 7273 2e0a 0a20 2020 2020 5468 6520 mers... The │ │ │ │ -00018380: 636f 6d62 696e 6564 2077 6f72 6b20 6e65 combined work ne │ │ │ │ -00018390: 6564 206f 6e6c 7920 636f 6e74 6169 6e20 ed only contain │ │ │ │ -000183a0: 6f6e 6520 636f 7079 206f 6620 7468 6973 one copy of this │ │ │ │ -000183b0: 204c 6963 656e 7365 2c20 616e 640a 2020 License, and. │ │ │ │ -000183c0: 2020 206d 756c 7469 706c 6520 6964 656e multiple iden │ │ │ │ -000183d0: 7469 6361 6c20 496e 7661 7269 616e 7420 tical Invariant │ │ │ │ -000183e0: 5365 6374 696f 6e73 206d 6179 2062 6520 Sections may be │ │ │ │ -000183f0: 7265 706c 6163 6564 2077 6974 6820 6120 replaced with a │ │ │ │ -00018400: 7369 6e67 6c65 0a20 2020 2020 636f 7079 single. copy │ │ │ │ -00018410: 2e20 2049 6620 7468 6572 6520 6172 6520 . If there are │ │ │ │ -00018420: 6d75 6c74 6970 6c65 2049 6e76 6172 6961 multiple Invaria │ │ │ │ -00018430: 6e74 2053 6563 7469 6f6e 7320 7769 7468 nt Sections with │ │ │ │ -00018440: 2074 6865 2073 616d 6520 6e61 6d65 0a20 the same name. │ │ │ │ -00018450: 2020 2020 6275 7420 6469 6666 6572 656e but differen │ │ │ │ -00018460: 7420 636f 6e74 656e 7473 2c20 6d61 6b65 t contents, make │ │ │ │ -00018470: 2074 6865 2074 6974 6c65 206f 6620 6561 the title of ea │ │ │ │ -00018480: 6368 2073 7563 6820 7365 6374 696f 6e20 ch such section │ │ │ │ -00018490: 756e 6971 7565 0a20 2020 2020 6279 2061 unique. by a │ │ │ │ -000184a0: 6464 696e 6720 6174 2074 6865 2065 6e64 dding at the end │ │ │ │ -000184b0: 206f 6620 6974 2c20 696e 2070 6172 656e of it, in paren │ │ │ │ -000184c0: 7468 6573 6573 2c20 7468 6520 6e61 6d65 theses, the name │ │ │ │ -000184d0: 206f 6620 7468 650a 2020 2020 206f 7269 of the. ori │ │ │ │ -000184e0: 6769 6e61 6c20 6175 7468 6f72 206f 7220 ginal author or │ │ │ │ -000184f0: 7075 626c 6973 6865 7220 6f66 2074 6861 publisher of tha │ │ │ │ -00018500: 7420 7365 6374 696f 6e20 6966 206b 6e6f t section if kno │ │ │ │ -00018510: 776e 2c20 6f72 2065 6c73 6520 610a 2020 wn, or else a. │ │ │ │ -00018520: 2020 2075 6e69 7175 6520 6e75 6d62 6572 unique number │ │ │ │ -00018530: 2e20 204d 616b 6520 7468 6520 7361 6d65 . Make the same │ │ │ │ -00018540: 2061 646a 7573 746d 656e 7420 746f 2074 adjustment to t │ │ │ │ -00018550: 6865 2073 6563 7469 6f6e 2074 6974 6c65 he section title │ │ │ │ -00018560: 7320 696e 0a20 2020 2020 7468 6520 6c69 s in. the li │ │ │ │ -00018570: 7374 206f 6620 496e 7661 7269 616e 7420 st of Invariant │ │ │ │ -00018580: 5365 6374 696f 6e73 2069 6e20 7468 6520 Sections in the │ │ │ │ -00018590: 6c69 6365 6e73 6520 6e6f 7469 6365 206f license notice o │ │ │ │ -000185a0: 6620 7468 650a 2020 2020 2063 6f6d 6269 f the. combi │ │ │ │ -000185b0: 6e65 6420 776f 726b 2e0a 0a20 2020 2020 ned work... │ │ │ │ -000185c0: 496e 2074 6865 2063 6f6d 6269 6e61 7469 In the combinati │ │ │ │ -000185d0: 6f6e 2c20 796f 7520 6d75 7374 2063 6f6d on, you must com │ │ │ │ -000185e0: 6269 6e65 2061 6e79 2073 6563 7469 6f6e bine any section │ │ │ │ -000185f0: 7320 456e 7469 746c 6564 0a20 2020 2020 s Entitled. │ │ │ │ -00018600: 2248 6973 746f 7279 2220 696e 2074 6865 "History" in the │ │ │ │ -00018610: 2076 6172 696f 7573 206f 7269 6769 6e61 various origina │ │ │ │ -00018620: 6c20 646f 6375 6d65 6e74 732c 2066 6f72 l documents, for │ │ │ │ -00018630: 6d69 6e67 206f 6e65 2073 6563 7469 6f6e ming one section │ │ │ │ -00018640: 0a20 2020 2020 456e 7469 746c 6564 2022 . Entitled " │ │ │ │ -00018650: 4869 7374 6f72 7922 3b20 6c69 6b65 7769 History"; likewi │ │ │ │ -00018660: 7365 2063 6f6d 6269 6e65 2061 6e79 2073 se combine any s │ │ │ │ -00018670: 6563 7469 6f6e 7320 456e 7469 746c 6564 ections Entitled │ │ │ │ -00018680: 0a20 2020 2020 2241 636b 6e6f 776c 6564 . "Acknowled │ │ │ │ -00018690: 6765 6d65 6e74 7322 2c20 616e 6420 616e gements", and an │ │ │ │ -000186a0: 7920 7365 6374 696f 6e73 2045 6e74 6974 y sections Entit │ │ │ │ -000186b0: 6c65 6420 2244 6564 6963 6174 696f 6e73 led "Dedications │ │ │ │ -000186c0: 222e 2020 596f 750a 2020 2020 206d 7573 ". You. mus │ │ │ │ -000186d0: 7420 6465 6c65 7465 2061 6c6c 2073 6563 t delete all sec │ │ │ │ -000186e0: 7469 6f6e 7320 456e 7469 746c 6564 2022 tions Entitled " │ │ │ │ -000186f0: 456e 646f 7273 656d 656e 7473 2e22 0a0a Endorsements.".. │ │ │ │ -00018700: 2020 362e 2043 4f4c 4c45 4354 494f 4e53 6. COLLECTIONS │ │ │ │ -00018710: 204f 4620 444f 4355 4d45 4e54 530a 0a20 OF DOCUMENTS.. │ │ │ │ -00018720: 2020 2020 596f 7520 6d61 7920 6d61 6b65 You may make │ │ │ │ -00018730: 2061 2063 6f6c 6c65 6374 696f 6e20 636f a collection co │ │ │ │ -00018740: 6e73 6973 7469 6e67 206f 6620 7468 6520 nsisting of the │ │ │ │ -00018750: 446f 6375 6d65 6e74 2061 6e64 206f 7468 Document and oth │ │ │ │ -00018760: 6572 0a20 2020 2020 646f 6375 6d65 6e74 er. document │ │ │ │ -00018770: 7320 7265 6c65 6173 6564 2075 6e64 6572 s released under │ │ │ │ -00018780: 2074 6869 7320 4c69 6365 6e73 652c 2061 this License, a │ │ │ │ -00018790: 6e64 2072 6570 6c61 6365 2074 6865 2069 nd replace the i │ │ │ │ -000187a0: 6e64 6976 6964 7561 6c0a 2020 2020 2063 ndividual. c │ │ │ │ -000187b0: 6f70 6965 7320 6f66 2074 6869 7320 4c69 opies of this Li │ │ │ │ -000187c0: 6365 6e73 6520 696e 2074 6865 2076 6172 cense in the var │ │ │ │ -000187d0: 696f 7573 2064 6f63 756d 656e 7473 2077 ious documents w │ │ │ │ -000187e0: 6974 6820 6120 7369 6e67 6c65 2063 6f70 ith a single cop │ │ │ │ -000187f0: 790a 2020 2020 2074 6861 7420 6973 2069 y. that is i │ │ │ │ -00018800: 6e63 6c75 6465 6420 696e 2074 6865 2063 ncluded in the c │ │ │ │ -00018810: 6f6c 6c65 6374 696f 6e2c 2070 726f 7669 ollection, provi │ │ │ │ -00018820: 6465 6420 7468 6174 2079 6f75 2066 6f6c ded that you fol │ │ │ │ -00018830: 6c6f 7720 7468 650a 2020 2020 2072 756c low the. rul │ │ │ │ -00018840: 6573 206f 6620 7468 6973 204c 6963 656e es of this Licen │ │ │ │ -00018850: 7365 2066 6f72 2076 6572 6261 7469 6d20 se for verbatim │ │ │ │ -00018860: 636f 7079 696e 6720 6f66 2065 6163 6820 copying of each │ │ │ │ -00018870: 6f66 2074 6865 2064 6f63 756d 656e 7473 of the documents │ │ │ │ -00018880: 0a20 2020 2020 696e 2061 6c6c 206f 7468 . in all oth │ │ │ │ -00018890: 6572 2072 6573 7065 6374 732e 0a0a 2020 er respects... │ │ │ │ -000188a0: 2020 2059 6f75 206d 6179 2065 7874 7261 You may extra │ │ │ │ -000188b0: 6374 2061 2073 696e 676c 6520 646f 6375 ct a single docu │ │ │ │ -000188c0: 6d65 6e74 2066 726f 6d20 7375 6368 2061 ment from such a │ │ │ │ -000188d0: 2063 6f6c 6c65 6374 696f 6e2c 2061 6e64 collection, and │ │ │ │ -000188e0: 0a20 2020 2020 6469 7374 7269 6275 7465 . distribute │ │ │ │ -000188f0: 2069 7420 696e 6469 7669 6475 616c 6c79 it individually │ │ │ │ -00018900: 2075 6e64 6572 2074 6869 7320 4c69 6365 under this Lice │ │ │ │ -00018910: 6e73 652c 2070 726f 7669 6465 6420 796f nse, provided yo │ │ │ │ -00018920: 7520 696e 7365 7274 0a20 2020 2020 6120 u insert. a │ │ │ │ -00018930: 636f 7079 206f 6620 7468 6973 204c 6963 copy of this Lic │ │ │ │ -00018940: 656e 7365 2069 6e74 6f20 7468 6520 6578 ense into the ex │ │ │ │ -00018950: 7472 6163 7465 6420 646f 6375 6d65 6e74 tracted document │ │ │ │ -00018960: 2c20 616e 6420 666f 6c6c 6f77 2074 6869 , and follow thi │ │ │ │ -00018970: 730a 2020 2020 204c 6963 656e 7365 2069 s. License i │ │ │ │ -00018980: 6e20 616c 6c20 6f74 6865 7220 7265 7370 n all other resp │ │ │ │ -00018990: 6563 7473 2072 6567 6172 6469 6e67 2076 ects regarding v │ │ │ │ -000189a0: 6572 6261 7469 6d20 636f 7079 696e 6720 erbatim copying │ │ │ │ -000189b0: 6f66 2074 6861 740a 2020 2020 2064 6f63 of that. doc │ │ │ │ -000189c0: 756d 656e 742e 0a0a 2020 372e 2041 4747 ument... 7. AGG │ │ │ │ -000189d0: 5245 4741 5449 4f4e 2057 4954 4820 494e REGATION WITH IN │ │ │ │ -000189e0: 4445 5045 4e44 454e 5420 574f 524b 530a DEPENDENT WORKS. │ │ │ │ -000189f0: 0a20 2020 2020 4120 636f 6d70 696c 6174 . A compilat │ │ │ │ -00018a00: 696f 6e20 6f66 2074 6865 2044 6f63 756d ion of the Docum │ │ │ │ -00018a10: 656e 7420 6f72 2069 7473 2064 6572 6976 ent or its deriv │ │ │ │ -00018a20: 6174 6976 6573 2077 6974 6820 6f74 6865 atives with othe │ │ │ │ -00018a30: 720a 2020 2020 2073 6570 6172 6174 6520 r. separate │ │ │ │ -00018a40: 616e 6420 696e 6465 7065 6e64 656e 7420 and independent │ │ │ │ -00018a50: 646f 6375 6d65 6e74 7320 6f72 2077 6f72 documents or wor │ │ │ │ -00018a60: 6b73 2c20 696e 206f 7220 6f6e 2061 2076 ks, in or on a v │ │ │ │ -00018a70: 6f6c 756d 6520 6f66 2061 0a20 2020 2020 olume of a. │ │ │ │ -00018a80: 7374 6f72 6167 6520 6f72 2064 6973 7472 storage or distr │ │ │ │ -00018a90: 6962 7574 696f 6e20 6d65 6469 756d 2c20 ibution medium, │ │ │ │ -00018aa0: 6973 2063 616c 6c65 6420 616e 2022 6167 is called an "ag │ │ │ │ -00018ab0: 6772 6567 6174 6522 2069 6620 7468 650a gregate" if the. │ │ │ │ -00018ac0: 2020 2020 2063 6f70 7972 6967 6874 2072 copyright r │ │ │ │ -00018ad0: 6573 756c 7469 6e67 2066 726f 6d20 7468 esulting from th │ │ │ │ -00018ae0: 6520 636f 6d70 696c 6174 696f 6e20 6973 e compilation is │ │ │ │ -00018af0: 206e 6f74 2075 7365 6420 746f 206c 696d not used to lim │ │ │ │ -00018b00: 6974 2074 6865 0a20 2020 2020 6c65 6761 it the. lega │ │ │ │ -00018b10: 6c20 7269 6768 7473 206f 6620 7468 6520 l rights of the │ │ │ │ -00018b20: 636f 6d70 696c 6174 696f 6e27 7320 7573 compilation's us │ │ │ │ -00018b30: 6572 7320 6265 796f 6e64 2077 6861 7420 ers beyond what │ │ │ │ -00018b40: 7468 6520 696e 6469 7669 6475 616c 0a20 the individual. │ │ │ │ -00018b50: 2020 2020 776f 726b 7320 7065 726d 6974 works permit │ │ │ │ -00018b60: 2e20 2057 6865 6e20 7468 6520 446f 6375 . When the Docu │ │ │ │ -00018b70: 6d65 6e74 2069 7320 696e 636c 7564 6564 ment is included │ │ │ │ -00018b80: 2069 6e20 616e 2061 6767 7265 6761 7465 in an aggregate │ │ │ │ -00018b90: 2c20 7468 6973 0a20 2020 2020 4c69 6365 , this. Lice │ │ │ │ -00018ba0: 6e73 6520 646f 6573 206e 6f74 2061 7070 nse does not app │ │ │ │ -00018bb0: 6c79 2074 6f20 7468 6520 6f74 6865 7220 ly to the other │ │ │ │ -00018bc0: 776f 726b 7320 696e 2074 6865 2061 6767 works in the agg │ │ │ │ -00018bd0: 7265 6761 7465 2077 6869 6368 0a20 2020 regate which. │ │ │ │ -00018be0: 2020 6172 6520 6e6f 7420 7468 656d 7365 are not themse │ │ │ │ -00018bf0: 6c76 6573 2064 6572 6976 6174 6976 6520 lves derivative │ │ │ │ -00018c00: 776f 726b 7320 6f66 2074 6865 2044 6f63 works of the Doc │ │ │ │ -00018c10: 756d 656e 742e 0a0a 2020 2020 2049 6620 ument... If │ │ │ │ -00018c20: 7468 6520 436f 7665 7220 5465 7874 2072 the Cover Text r │ │ │ │ -00018c30: 6571 7569 7265 6d65 6e74 206f 6620 7365 equirement of se │ │ │ │ -00018c40: 6374 696f 6e20 3320 6973 2061 7070 6c69 ction 3 is appli │ │ │ │ -00018c50: 6361 626c 6520 746f 2074 6865 7365 0a20 cable to these. │ │ │ │ -00018c60: 2020 2020 636f 7069 6573 206f 6620 7468 copies of th │ │ │ │ -00018c70: 6520 446f 6375 6d65 6e74 2c20 7468 656e e Document, then │ │ │ │ -00018c80: 2069 6620 7468 6520 446f 6375 6d65 6e74 if the Document │ │ │ │ -00018c90: 2069 7320 6c65 7373 2074 6861 6e20 6f6e is less than on │ │ │ │ -00018ca0: 6520 6861 6c66 0a20 2020 2020 6f66 2074 e half. of t │ │ │ │ -00018cb0: 6865 2065 6e74 6972 6520 6167 6772 6567 he entire aggreg │ │ │ │ -00018cc0: 6174 652c 2074 6865 2044 6f63 756d 656e ate, the Documen │ │ │ │ -00018cd0: 7427 7320 436f 7665 7220 5465 7874 7320 t's Cover Texts │ │ │ │ -00018ce0: 6d61 7920 6265 2070 6c61 6365 640a 2020 may be placed. │ │ │ │ -00018cf0: 2020 206f 6e20 636f 7665 7273 2074 6861 on covers tha │ │ │ │ -00018d00: 7420 6272 6163 6b65 7420 7468 6520 446f t bracket the Do │ │ │ │ -00018d10: 6375 6d65 6e74 2077 6974 6869 6e20 7468 cument within th │ │ │ │ -00018d20: 6520 6167 6772 6567 6174 652c 206f 7220 e aggregate, or │ │ │ │ -00018d30: 7468 650a 2020 2020 2065 6c65 6374 726f the. electro │ │ │ │ -00018d40: 6e69 6320 6571 7569 7661 6c65 6e74 206f nic equivalent o │ │ │ │ -00018d50: 6620 636f 7665 7273 2069 6620 7468 6520 f covers if the │ │ │ │ -00018d60: 446f 6375 6d65 6e74 2069 7320 696e 2065 Document is in e │ │ │ │ -00018d70: 6c65 6374 726f 6e69 630a 2020 2020 2066 lectronic. f │ │ │ │ -00018d80: 6f72 6d2e 2020 4f74 6865 7277 6973 6520 orm. Otherwise │ │ │ │ -00018d90: 7468 6579 206d 7573 7420 6170 7065 6172 they must appear │ │ │ │ -00018da0: 206f 6e20 7072 696e 7465 6420 636f 7665 on printed cove │ │ │ │ -00018db0: 7273 2074 6861 7420 6272 6163 6b65 740a rs that bracket. │ │ │ │ -00018dc0: 2020 2020 2074 6865 2077 686f 6c65 2061 the whole a │ │ │ │ -00018dd0: 6767 7265 6761 7465 2e0a 0a20 2038 2e20 ggregate... 8. │ │ │ │ -00018de0: 5452 414e 534c 4154 494f 4e0a 0a20 2020 TRANSLATION.. │ │ │ │ -00018df0: 2020 5472 616e 736c 6174 696f 6e20 6973 Translation is │ │ │ │ -00018e00: 2063 6f6e 7369 6465 7265 6420 6120 6b69 considered a ki │ │ │ │ -00018e10: 6e64 206f 6620 6d6f 6469 6669 6361 7469 nd of modificati │ │ │ │ -00018e20: 6f6e 2c20 736f 2079 6f75 206d 6179 0a20 on, so you may. │ │ │ │ -00018e30: 2020 2020 6469 7374 7269 6275 7465 2074 distribute t │ │ │ │ -00018e40: 7261 6e73 6c61 7469 6f6e 7320 6f66 2074 ranslations of t │ │ │ │ -00018e50: 6865 2044 6f63 756d 656e 7420 756e 6465 he Document unde │ │ │ │ -00018e60: 7220 7468 6520 7465 726d 7320 6f66 2073 r the terms of s │ │ │ │ -00018e70: 6563 7469 6f6e 0a20 2020 2020 342e 2020 ection. 4. │ │ │ │ -00018e80: 5265 706c 6163 696e 6720 496e 7661 7269 Replacing Invari │ │ │ │ -00018e90: 616e 7420 5365 6374 696f 6e73 2077 6974 ant Sections wit │ │ │ │ -00018ea0: 6820 7472 616e 736c 6174 696f 6e73 2072 h translations r │ │ │ │ -00018eb0: 6571 7569 7265 7320 7370 6563 6961 6c0a equires special. │ │ │ │ -00018ec0: 2020 2020 2070 6572 6d69 7373 696f 6e20 permission │ │ │ │ -00018ed0: 6672 6f6d 2074 6865 6972 2063 6f70 7972 from their copyr │ │ │ │ -00018ee0: 6967 6874 2068 6f6c 6465 7273 2c20 6275 ight holders, bu │ │ │ │ -00018ef0: 7420 796f 7520 6d61 7920 696e 636c 7564 t you may includ │ │ │ │ -00018f00: 650a 2020 2020 2074 7261 6e73 6c61 7469 e. translati │ │ │ │ -00018f10: 6f6e 7320 6f66 2073 6f6d 6520 6f72 2061 ons of some or a │ │ │ │ -00018f20: 6c6c 2049 6e76 6172 6961 6e74 2053 6563 ll Invariant Sec │ │ │ │ -00018f30: 7469 6f6e 7320 696e 2061 6464 6974 696f tions in additio │ │ │ │ -00018f40: 6e20 746f 2074 6865 0a20 2020 2020 6f72 n to the. or │ │ │ │ -00018f50: 6967 696e 616c 2076 6572 7369 6f6e 7320 iginal versions │ │ │ │ -00018f60: 6f66 2074 6865 7365 2049 6e76 6172 6961 of these Invaria │ │ │ │ -00018f70: 6e74 2053 6563 7469 6f6e 732e 2020 596f nt Sections. Yo │ │ │ │ -00018f80: 7520 6d61 7920 696e 636c 7564 6520 610a u may include a. │ │ │ │ -00018f90: 2020 2020 2074 7261 6e73 6c61 7469 6f6e translation │ │ │ │ -00018fa0: 206f 6620 7468 6973 204c 6963 656e 7365 of this License │ │ │ │ -00018fb0: 2c20 616e 6420 616c 6c20 7468 6520 6c69 , and all the li │ │ │ │ -00018fc0: 6365 6e73 6520 6e6f 7469 6365 7320 696e cense notices in │ │ │ │ -00018fd0: 2074 6865 0a20 2020 2020 446f 6375 6d65 the. Docume │ │ │ │ -00018fe0: 6e74 2c20 616e 6420 616e 7920 5761 7272 nt, and any Warr │ │ │ │ -00018ff0: 616e 7479 2044 6973 636c 6169 6d65 7273 anty Disclaimers │ │ │ │ -00019000: 2c20 7072 6f76 6964 6564 2074 6861 7420 , provided that │ │ │ │ -00019010: 796f 7520 616c 736f 0a20 2020 2020 696e you also. in │ │ │ │ -00019020: 636c 7564 6520 7468 6520 6f72 6967 696e clude the origin │ │ │ │ -00019030: 616c 2045 6e67 6c69 7368 2076 6572 7369 al English versi │ │ │ │ -00019040: 6f6e 206f 6620 7468 6973 204c 6963 656e on of this Licen │ │ │ │ -00019050: 7365 2061 6e64 2074 6865 0a20 2020 2020 se and the. │ │ │ │ -00019060: 6f72 6967 696e 616c 2076 6572 7369 6f6e original version │ │ │ │ -00019070: 7320 6f66 2074 686f 7365 206e 6f74 6963 s of those notic │ │ │ │ -00019080: 6573 2061 6e64 2064 6973 636c 6169 6d65 es and disclaime │ │ │ │ -00019090: 7273 2e20 2049 6e20 6361 7365 206f 6620 rs. In case of │ │ │ │ -000190a0: 610a 2020 2020 2064 6973 6167 7265 656d a. disagreem │ │ │ │ -000190b0: 656e 7420 6265 7477 6565 6e20 7468 6520 ent between the │ │ │ │ -000190c0: 7472 616e 736c 6174 696f 6e20 616e 6420 translation and │ │ │ │ -000190d0: 7468 6520 6f72 6967 696e 616c 2076 6572 the original ver │ │ │ │ -000190e0: 7369 6f6e 206f 660a 2020 2020 2074 6869 sion of. thi │ │ │ │ -000190f0: 7320 4c69 6365 6e73 6520 6f72 2061 206e s License or a n │ │ │ │ -00019100: 6f74 6963 6520 6f72 2064 6973 636c 6169 otice or disclai │ │ │ │ -00019110: 6d65 722c 2074 6865 206f 7269 6769 6e61 mer, the origina │ │ │ │ -00019120: 6c20 7665 7273 696f 6e20 7769 6c6c 0a20 l version will. │ │ │ │ -00019130: 2020 2020 7072 6576 6169 6c2e 0a0a 2020 prevail... │ │ │ │ -00019140: 2020 2049 6620 6120 7365 6374 696f 6e20 If a section │ │ │ │ -00019150: 696e 2074 6865 2044 6f63 756d 656e 7420 in the Document │ │ │ │ -00019160: 6973 2045 6e74 6974 6c65 6420 2241 636b is Entitled "Ack │ │ │ │ -00019170: 6e6f 776c 6564 6765 6d65 6e74 7322 2c0a nowledgements",. │ │ │ │ -00019180: 2020 2020 2022 4465 6469 6361 7469 6f6e "Dedication │ │ │ │ -00019190: 7322 2c20 6f72 2022 4869 7374 6f72 7922 s", or "History" │ │ │ │ -000191a0: 2c20 7468 6520 7265 7175 6972 656d 656e , the requiremen │ │ │ │ -000191b0: 7420 2873 6563 7469 6f6e 2034 2920 746f t (section 4) to │ │ │ │ -000191c0: 0a20 2020 2020 5072 6573 6572 7665 2069 . Preserve i │ │ │ │ -000191d0: 7473 2054 6974 6c65 2028 7365 6374 696f ts Title (sectio │ │ │ │ -000191e0: 6e20 3129 2077 696c 6c20 7479 7069 6361 n 1) will typica │ │ │ │ -000191f0: 6c6c 7920 7265 7175 6972 6520 6368 616e lly require chan │ │ │ │ -00019200: 6769 6e67 2074 6865 0a20 2020 2020 6163 ging the. ac │ │ │ │ -00019210: 7475 616c 2074 6974 6c65 2e0a 0a20 2039 tual title... 9 │ │ │ │ -00019220: 2e20 5445 524d 494e 4154 494f 4e0a 0a20 . TERMINATION.. │ │ │ │ -00019230: 2020 2020 596f 7520 6d61 7920 6e6f 7420 You may not │ │ │ │ -00019240: 636f 7079 2c20 6d6f 6469 6679 2c20 7375 copy, modify, su │ │ │ │ -00019250: 626c 6963 656e 7365 2c20 6f72 2064 6973 blicense, or dis │ │ │ │ -00019260: 7472 6962 7574 6520 7468 6520 446f 6375 tribute the Docu │ │ │ │ -00019270: 6d65 6e74 0a20 2020 2020 6578 6365 7074 ment. except │ │ │ │ -00019280: 2061 7320 6578 7072 6573 736c 7920 7072 as expressly pr │ │ │ │ -00019290: 6f76 6964 6564 2066 6f72 2075 6e64 6572 ovided for under │ │ │ │ -000192a0: 2074 6869 7320 4c69 6365 6e73 652e 2020 this License. │ │ │ │ -000192b0: 416e 7920 6f74 6865 720a 2020 2020 2061 Any other. a │ │ │ │ -000192c0: 7474 656d 7074 2074 6f20 636f 7079 2c20 ttempt to copy, │ │ │ │ -000192d0: 6d6f 6469 6679 2c20 7375 626c 6963 656e modify, sublicen │ │ │ │ -000192e0: 7365 206f 7220 6469 7374 7269 6275 7465 se or distribute │ │ │ │ -000192f0: 2074 6865 2044 6f63 756d 656e 7420 6973 the Document is │ │ │ │ -00019300: 0a20 2020 2020 766f 6964 2c20 616e 6420 . void, and │ │ │ │ -00019310: 7769 6c6c 2061 7574 6f6d 6174 6963 616c will automatical │ │ │ │ -00019320: 6c79 2074 6572 6d69 6e61 7465 2079 6f75 ly terminate you │ │ │ │ -00019330: 7220 7269 6768 7473 2075 6e64 6572 2074 r rights under t │ │ │ │ -00019340: 6869 730a 2020 2020 204c 6963 656e 7365 his. License │ │ │ │ -00019350: 2e20 2048 6f77 6576 6572 2c20 7061 7274 . However, part │ │ │ │ -00019360: 6965 7320 7768 6f20 6861 7665 2072 6563 ies who have rec │ │ │ │ -00019370: 6569 7665 6420 636f 7069 6573 2c20 6f72 eived copies, or │ │ │ │ -00019380: 2072 6967 6874 732c 0a20 2020 2020 6672 rights,. fr │ │ │ │ -00019390: 6f6d 2079 6f75 2075 6e64 6572 2074 6869 om you under thi │ │ │ │ -000193a0: 7320 4c69 6365 6e73 6520 7769 6c6c 206e s License will n │ │ │ │ -000193b0: 6f74 2068 6176 6520 7468 6569 7220 6c69 ot have their li │ │ │ │ -000193c0: 6365 6e73 6573 2074 6572 6d69 6e61 7465 censes terminate │ │ │ │ -000193d0: 640a 2020 2020 2073 6f20 6c6f 6e67 2061 d. so long a │ │ │ │ -000193e0: 7320 7375 6368 2070 6172 7469 6573 2072 s such parties r │ │ │ │ -000193f0: 656d 6169 6e20 696e 2066 756c 6c20 636f emain in full co │ │ │ │ -00019400: 6d70 6c69 616e 6365 2e0a 0a20 2031 302e mpliance... 10. │ │ │ │ -00019410: 2046 5554 5552 4520 5245 5649 5349 4f4e FUTURE REVISION │ │ │ │ -00019420: 5320 4f46 2054 4849 5320 4c49 4345 4e53 S OF THIS LICENS │ │ │ │ -00019430: 450a 0a20 2020 2020 5468 6520 4672 6565 E.. The Free │ │ │ │ -00019440: 2053 6f66 7477 6172 6520 466f 756e 6461 Software Founda │ │ │ │ -00019450: 7469 6f6e 206d 6179 2070 7562 6c69 7368 tion may publish │ │ │ │ -00019460: 206e 6577 2c20 7265 7669 7365 6420 7665 new, revised ve │ │ │ │ -00019470: 7273 696f 6e73 206f 660a 2020 2020 2074 rsions of. t │ │ │ │ -00019480: 6865 2047 4e55 2046 7265 6520 446f 6375 he GNU Free Docu │ │ │ │ -00019490: 6d65 6e74 6174 696f 6e20 4c69 6365 6e73 mentation Licens │ │ │ │ -000194a0: 6520 6672 6f6d 2074 696d 6520 746f 2074 e from time to t │ │ │ │ -000194b0: 696d 652e 2020 5375 6368 206e 6577 0a20 ime. Such new. │ │ │ │ -000194c0: 2020 2020 7665 7273 696f 6e73 2077 696c versions wil │ │ │ │ -000194d0: 6c20 6265 2073 696d 696c 6172 2069 6e20 l be similar in │ │ │ │ -000194e0: 7370 6972 6974 2074 6f20 7468 6520 7072 spirit to the pr │ │ │ │ -000194f0: 6573 656e 7420 7665 7273 696f 6e2c 2062 esent version, b │ │ │ │ -00019500: 7574 206d 6179 0a20 2020 2020 6469 6666 ut may. diff │ │ │ │ -00019510: 6572 2069 6e20 6465 7461 696c 2074 6f20 er in detail to │ │ │ │ -00019520: 6164 6472 6573 7320 6e65 7720 7072 6f62 address new prob │ │ │ │ -00019530: 6c65 6d73 206f 7220 636f 6e63 6572 6e73 lems or concerns │ │ │ │ -00019540: 2e20 2053 6565 0a20 2020 2020 3c68 7474 . See. ... │ │ │ │ -00019570: 2020 4561 6368 2076 6572 7369 6f6e 206f Each version o │ │ │ │ -00019580: 6620 7468 6520 4c69 6365 6e73 6520 6973 f the License is │ │ │ │ -00019590: 2067 6976 656e 2061 2064 6973 7469 6e67 given a disting │ │ │ │ -000195a0: 7569 7368 696e 6720 7665 7273 696f 6e0a uishing version. │ │ │ │ -000195b0: 2020 2020 206e 756d 6265 722e 2020 4966 number. If │ │ │ │ -000195c0: 2074 6865 2044 6f63 756d 656e 7420 7370 the Document sp │ │ │ │ -000195d0: 6563 6966 6965 7320 7468 6174 2061 2070 ecifies that a p │ │ │ │ -000195e0: 6172 7469 6375 6c61 7220 6e75 6d62 6572 articular number │ │ │ │ -000195f0: 6564 0a20 2020 2020 7665 7273 696f 6e20 ed. version │ │ │ │ -00019600: 6f66 2074 6869 7320 4c69 6365 6e73 6520 of this License │ │ │ │ -00019610: 226f 7220 616e 7920 6c61 7465 7220 7665 "or any later ve │ │ │ │ -00019620: 7273 696f 6e22 2061 7070 6c69 6573 2074 rsion" applies t │ │ │ │ -00019630: 6f20 6974 2c20 796f 750a 2020 2020 2068 o it, you. h │ │ │ │ -00019640: 6176 6520 7468 6520 6f70 7469 6f6e 206f ave the option o │ │ │ │ -00019650: 6620 666f 6c6c 6f77 696e 6720 7468 6520 f following the │ │ │ │ -00019660: 7465 726d 7320 616e 6420 636f 6e64 6974 terms and condit │ │ │ │ -00019670: 696f 6e73 2065 6974 6865 7220 6f66 0a20 ions either of. │ │ │ │ -00019680: 2020 2020 7468 6174 2073 7065 6369 6669 that specifi │ │ │ │ -00019690: 6564 2076 6572 7369 6f6e 206f 7220 6f66 ed version or of │ │ │ │ -000196a0: 2061 6e79 206c 6174 6572 2076 6572 7369 any later versi │ │ │ │ -000196b0: 6f6e 2074 6861 7420 6861 7320 6265 656e on that has been │ │ │ │ -000196c0: 0a20 2020 2020 7075 626c 6973 6865 6420 . published │ │ │ │ -000196d0: 286e 6f74 2061 7320 6120 6472 6166 7429 (not as a draft) │ │ │ │ -000196e0: 2062 7920 7468 6520 4672 6565 2053 6f66 by the Free Sof │ │ │ │ -000196f0: 7477 6172 6520 466f 756e 6461 7469 6f6e tware Foundation │ │ │ │ -00019700: 2e20 2049 6620 7468 650a 2020 2020 2044 . If the. D │ │ │ │ -00019710: 6f63 756d 656e 7420 646f 6573 206e 6f74 ocument does not │ │ │ │ -00019720: 2073 7065 6369 6679 2061 2076 6572 7369 specify a versi │ │ │ │ -00019730: 6f6e 206e 756d 6265 7220 6f66 2074 6869 on number of thi │ │ │ │ -00019740: 7320 4c69 6365 6e73 652c 2079 6f75 206d s License, you m │ │ │ │ -00019750: 6179 0a20 2020 2020 6368 6f6f 7365 2061 ay. choose a │ │ │ │ -00019760: 6e79 2076 6572 7369 6f6e 2065 7665 7220 ny version ever │ │ │ │ -00019770: 7075 626c 6973 6865 6420 286e 6f74 2061 published (not a │ │ │ │ -00019780: 7320 6120 6472 6166 7429 2062 7920 7468 s a draft) by th │ │ │ │ -00019790: 6520 4672 6565 0a20 2020 2020 536f 6674 e Free. Soft │ │ │ │ -000197a0: 7761 7265 2046 6f75 6e64 6174 696f 6e2e ware Foundation. │ │ │ │ -000197b0: 0a0a 412e 312e 3120 4144 4445 4e44 554d ..A.1.1 ADDENDUM │ │ │ │ -000197c0: 3a20 486f 7720 746f 2075 7365 2074 6869 : How to use thi │ │ │ │ -000197d0: 7320 4c69 6365 6e73 6520 666f 7220 796f s License for yo │ │ │ │ -000197e0: 7572 2064 6f63 756d 656e 7473 0a2d 2d2d ur documents.--- │ │ │ │ -000197f0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ +00014660: 3d3d 3d3d 3d3d 0a0a 2020 2020 2020 2020 ======.. │ │ │ │ +00014670: 2020 2020 2020 2020 2020 2020 2020 5665 Ve │ │ │ │ +00014680: 7273 696f 6e20 312e 322c 204e 6f76 656d rsion 1.2, Novem │ │ │ │ +00014690: 6265 7220 3230 3032 0a0a 2020 2020 2043 ber 2002.. C │ │ │ │ +000146a0: 6f70 7972 6967 6874 2028 4329 2032 3030 opyright (C) 200 │ │ │ │ +000146b0: 302c 3230 3031 2c32 3030 3220 4672 6565 0,2001,2002 Free │ │ │ │ +000146c0: 2053 6f66 7477 6172 6520 466f 756e 6461 Software Founda │ │ │ │ +000146d0: 7469 6f6e 2c20 496e 632e 0a20 2020 2020 tion, Inc.. │ │ │ │ +000146e0: 3531 2046 7261 6e6b 6c69 6e20 5374 2c20 51 Franklin St, │ │ │ │ +000146f0: 4669 6674 6820 466c 6f6f 722c 2042 6f73 Fifth Floor, Bos │ │ │ │ +00014700: 746f 6e2c 204d 4120 2030 3231 3130 2d31 ton, MA 02110-1 │ │ │ │ +00014710: 3330 312c 2055 5341 0a0a 2020 2020 2045 301, USA.. E │ │ │ │ +00014720: 7665 7279 6f6e 6520 6973 2070 6572 6d69 veryone is permi │ │ │ │ +00014730: 7474 6564 2074 6f20 636f 7079 2061 6e64 tted to copy and │ │ │ │ +00014740: 2064 6973 7472 6962 7574 6520 7665 7262 distribute verb │ │ │ │ +00014750: 6174 696d 2063 6f70 6965 730a 2020 2020 atim copies. │ │ │ │ +00014760: 206f 6620 7468 6973 206c 6963 656e 7365 of this license │ │ │ │ +00014770: 2064 6f63 756d 656e 742c 2062 7574 2063 document, but c │ │ │ │ +00014780: 6861 6e67 696e 6720 6974 2069 7320 6e6f hanging it is no │ │ │ │ +00014790: 7420 616c 6c6f 7765 642e 0a0a 2020 302e t allowed... 0. │ │ │ │ +000147a0: 2050 5245 414d 424c 450a 0a20 2020 2020 PREAMBLE.. │ │ │ │ +000147b0: 5468 6520 7075 7270 6f73 6520 6f66 2074 The purpose of t │ │ │ │ +000147c0: 6869 7320 4c69 6365 6e73 6520 6973 2074 his License is t │ │ │ │ +000147d0: 6f20 6d61 6b65 2061 206d 616e 7561 6c2c o make a manual, │ │ │ │ +000147e0: 2074 6578 7462 6f6f 6b2c 206f 7220 6f74 textbook, or ot │ │ │ │ +000147f0: 6865 720a 2020 2020 2066 756e 6374 696f her. functio │ │ │ │ +00014800: 6e61 6c20 616e 6420 7573 6566 756c 2064 nal and useful d │ │ │ │ +00014810: 6f63 756d 656e 7420 2266 7265 6522 2069 ocument "free" i │ │ │ │ +00014820: 6e20 7468 6520 7365 6e73 6520 6f66 2066 n the sense of f │ │ │ │ +00014830: 7265 6564 6f6d 3a20 746f 0a20 2020 2020 reedom: to. │ │ │ │ +00014840: 6173 7375 7265 2065 7665 7279 6f6e 6520 assure everyone │ │ │ │ +00014850: 7468 6520 6566 6665 6374 6976 6520 6672 the effective fr │ │ │ │ +00014860: 6565 646f 6d20 746f 2063 6f70 7920 616e eedom to copy an │ │ │ │ +00014870: 6420 7265 6469 7374 7269 6275 7465 2069 d redistribute i │ │ │ │ +00014880: 742c 0a20 2020 2020 7769 7468 206f 7220 t,. with or │ │ │ │ +00014890: 7769 7468 6f75 7420 6d6f 6469 6679 696e without modifyin │ │ │ │ +000148a0: 6720 6974 2c20 6569 7468 6572 2063 6f6d g it, either com │ │ │ │ +000148b0: 6d65 7263 6961 6c6c 7920 6f72 0a20 2020 mercially or. │ │ │ │ +000148c0: 2020 6e6f 6e63 6f6d 6d65 7263 6961 6c6c noncommerciall │ │ │ │ +000148d0: 792e 2020 5365 636f 6e64 6172 696c 792c y. Secondarily, │ │ │ │ +000148e0: 2074 6869 7320 4c69 6365 6e73 6520 7072 this License pr │ │ │ │ +000148f0: 6573 6572 7665 7320 666f 7220 7468 650a eserves for the. │ │ │ │ +00014900: 2020 2020 2061 7574 686f 7220 616e 6420 author and │ │ │ │ +00014910: 7075 626c 6973 6865 7220 6120 7761 7920 publisher a way │ │ │ │ +00014920: 746f 2067 6574 2063 7265 6469 7420 666f to get credit fo │ │ │ │ +00014930: 7220 7468 6569 7220 776f 726b 2c20 7768 r their work, wh │ │ │ │ +00014940: 696c 6520 6e6f 740a 2020 2020 2062 6569 ile not. bei │ │ │ │ +00014950: 6e67 2063 6f6e 7369 6465 7265 6420 7265 ng considered re │ │ │ │ +00014960: 7370 6f6e 7369 626c 6520 666f 7220 6d6f sponsible for mo │ │ │ │ +00014970: 6469 6669 6361 7469 6f6e 7320 6d61 6465 difications made │ │ │ │ +00014980: 2062 7920 6f74 6865 7273 2e0a 0a20 2020 by others... │ │ │ │ +00014990: 2020 5468 6973 204c 6963 656e 7365 2069 This License i │ │ │ │ +000149a0: 7320 6120 6b69 6e64 206f 6620 2263 6f70 s a kind of "cop │ │ │ │ +000149b0: 796c 6566 7422 2c20 7768 6963 6820 6d65 yleft", which me │ │ │ │ +000149c0: 616e 7320 7468 6174 2064 6572 6976 6174 ans that derivat │ │ │ │ +000149d0: 6976 650a 2020 2020 2077 6f72 6b73 206f ive. works o │ │ │ │ +000149e0: 6620 7468 6520 646f 6375 6d65 6e74 206d f the document m │ │ │ │ +000149f0: 7573 7420 7468 656d 7365 6c76 6573 2062 ust themselves b │ │ │ │ +00014a00: 6520 6672 6565 2069 6e20 7468 6520 7361 e free in the sa │ │ │ │ +00014a10: 6d65 2073 656e 7365 2e0a 2020 2020 2049 me sense.. I │ │ │ │ +00014a20: 7420 636f 6d70 6c65 6d65 6e74 7320 7468 t complements th │ │ │ │ +00014a30: 6520 474e 5520 4765 6e65 7261 6c20 5075 e GNU General Pu │ │ │ │ +00014a40: 626c 6963 204c 6963 656e 7365 2c20 7768 blic License, wh │ │ │ │ +00014a50: 6963 6820 6973 2061 2063 6f70 796c 6566 ich is a copylef │ │ │ │ +00014a60: 740a 2020 2020 206c 6963 656e 7365 2064 t. license d │ │ │ │ +00014a70: 6573 6967 6e65 6420 666f 7220 6672 6565 esigned for free │ │ │ │ +00014a80: 2073 6f66 7477 6172 652e 0a0a 2020 2020 software... │ │ │ │ +00014a90: 2057 6520 6861 7665 2064 6573 6967 6e65 We have designe │ │ │ │ +00014aa0: 6420 7468 6973 204c 6963 656e 7365 2069 d this License i │ │ │ │ +00014ab0: 6e20 6f72 6465 7220 746f 2075 7365 2069 n order to use i │ │ │ │ +00014ac0: 7420 666f 7220 6d61 6e75 616c 7320 666f t for manuals fo │ │ │ │ +00014ad0: 720a 2020 2020 2066 7265 6520 736f 6674 r. free soft │ │ │ │ +00014ae0: 7761 7265 2c20 6265 6361 7573 6520 6672 ware, because fr │ │ │ │ +00014af0: 6565 2073 6f66 7477 6172 6520 6e65 6564 ee software need │ │ │ │ +00014b00: 7320 6672 6565 2064 6f63 756d 656e 7461 s free documenta │ │ │ │ +00014b10: 7469 6f6e 3a20 610a 2020 2020 2066 7265 tion: a. fre │ │ │ │ +00014b20: 6520 7072 6f67 7261 6d20 7368 6f75 6c64 e program should │ │ │ │ +00014b30: 2063 6f6d 6520 7769 7468 206d 616e 7561 come with manua │ │ │ │ +00014b40: 6c73 2070 726f 7669 6469 6e67 2074 6865 ls providing the │ │ │ │ +00014b50: 2073 616d 6520 6672 6565 646f 6d73 0a20 same freedoms. │ │ │ │ +00014b60: 2020 2020 7468 6174 2074 6865 2073 6f66 that the sof │ │ │ │ +00014b70: 7477 6172 6520 646f 6573 2e20 2042 7574 tware does. But │ │ │ │ +00014b80: 2074 6869 7320 4c69 6365 6e73 6520 6973 this License is │ │ │ │ +00014b90: 206e 6f74 206c 696d 6974 6564 2074 6f0a not limited to. │ │ │ │ +00014ba0: 2020 2020 2073 6f66 7477 6172 6520 6d61 software ma │ │ │ │ +00014bb0: 6e75 616c 733b 2069 7420 6361 6e20 6265 nuals; it can be │ │ │ │ +00014bc0: 2075 7365 6420 666f 7220 616e 7920 7465 used for any te │ │ │ │ +00014bd0: 7874 7561 6c20 776f 726b 2c20 7265 6761 xtual work, rega │ │ │ │ +00014be0: 7264 6c65 7373 0a20 2020 2020 6f66 2073 rdless. of s │ │ │ │ +00014bf0: 7562 6a65 6374 206d 6174 7465 7220 6f72 ubject matter or │ │ │ │ +00014c00: 2077 6865 7468 6572 2069 7420 6973 2070 whether it is p │ │ │ │ +00014c10: 7562 6c69 7368 6564 2061 7320 6120 7072 ublished as a pr │ │ │ │ +00014c20: 696e 7465 6420 626f 6f6b 2e20 2057 650a inted book. We. │ │ │ │ +00014c30: 2020 2020 2072 6563 6f6d 6d65 6e64 2074 recommend t │ │ │ │ +00014c40: 6869 7320 4c69 6365 6e73 6520 7072 696e his License prin │ │ │ │ +00014c50: 6369 7061 6c6c 7920 666f 7220 776f 726b cipally for work │ │ │ │ +00014c60: 7320 7768 6f73 6520 7075 7270 6f73 6520 s whose purpose │ │ │ │ +00014c70: 6973 0a20 2020 2020 696e 7374 7275 6374 is. instruct │ │ │ │ +00014c80: 696f 6e20 6f72 2072 6566 6572 656e 6365 ion or reference │ │ │ │ +00014c90: 2e0a 0a20 2031 2e20 4150 504c 4943 4142 ... 1. APPLICAB │ │ │ │ +00014ca0: 494c 4954 5920 414e 4420 4445 4649 4e49 ILITY AND DEFINI │ │ │ │ +00014cb0: 5449 4f4e 530a 0a20 2020 2020 5468 6973 TIONS.. This │ │ │ │ +00014cc0: 204c 6963 656e 7365 2061 7070 6c69 6573 License applies │ │ │ │ +00014cd0: 2074 6f20 616e 7920 6d61 6e75 616c 206f to any manual o │ │ │ │ +00014ce0: 7220 6f74 6865 7220 776f 726b 2c20 696e r other work, in │ │ │ │ +00014cf0: 2061 6e79 206d 6564 6975 6d2c 0a20 2020 any medium,. │ │ │ │ +00014d00: 2020 7468 6174 2063 6f6e 7461 696e 7320 that contains │ │ │ │ +00014d10: 6120 6e6f 7469 6365 2070 6c61 6365 6420 a notice placed │ │ │ │ +00014d20: 6279 2074 6865 2063 6f70 7972 6967 6874 by the copyright │ │ │ │ +00014d30: 2068 6f6c 6465 7220 7361 7969 6e67 2069 holder saying i │ │ │ │ +00014d40: 7420 6361 6e0a 2020 2020 2062 6520 6469 t can. be di │ │ │ │ +00014d50: 7374 7269 6275 7465 6420 756e 6465 7220 stributed under │ │ │ │ +00014d60: 7468 6520 7465 726d 7320 6f66 2074 6869 the terms of thi │ │ │ │ +00014d70: 7320 4c69 6365 6e73 652e 2020 5375 6368 s License. Such │ │ │ │ +00014d80: 2061 206e 6f74 6963 650a 2020 2020 2067 a notice. g │ │ │ │ +00014d90: 7261 6e74 7320 6120 776f 726c 642d 7769 rants a world-wi │ │ │ │ +00014da0: 6465 2c20 726f 7961 6c74 792d 6672 6565 de, royalty-free │ │ │ │ +00014db0: 206c 6963 656e 7365 2c20 756e 6c69 6d69 license, unlimi │ │ │ │ +00014dc0: 7465 6420 696e 2064 7572 6174 696f 6e2c ted in duration, │ │ │ │ +00014dd0: 0a20 2020 2020 746f 2075 7365 2074 6861 . to use tha │ │ │ │ +00014de0: 7420 776f 726b 2075 6e64 6572 2074 6865 t work under the │ │ │ │ +00014df0: 2063 6f6e 6469 7469 6f6e 7320 7374 6174 conditions stat │ │ │ │ +00014e00: 6564 2068 6572 6569 6e2e 2020 5468 650a ed herein. The. │ │ │ │ +00014e10: 2020 2020 2022 446f 6375 6d65 6e74 222c "Document", │ │ │ │ +00014e20: 2062 656c 6f77 2c20 7265 6665 7273 2074 below, refers t │ │ │ │ +00014e30: 6f20 616e 7920 7375 6368 206d 616e 7561 o any such manua │ │ │ │ +00014e40: 6c20 6f72 2077 6f72 6b2e 2020 416e 7920 l or work. Any │ │ │ │ +00014e50: 6d65 6d62 6572 0a20 2020 2020 6f66 2074 member. of t │ │ │ │ +00014e60: 6865 2070 7562 6c69 6320 6973 2061 206c he public is a l │ │ │ │ +00014e70: 6963 656e 7365 652c 2061 6e64 2069 7320 icensee, and is │ │ │ │ +00014e80: 6164 6472 6573 7365 6420 6173 2022 796f addressed as "yo │ │ │ │ +00014e90: 7522 2e20 2059 6f75 2061 6363 6570 740a u". You accept. │ │ │ │ +00014ea0: 2020 2020 2074 6865 206c 6963 656e 7365 the license │ │ │ │ +00014eb0: 2069 6620 796f 7520 636f 7079 2c20 6d6f if you copy, mo │ │ │ │ +00014ec0: 6469 6679 206f 7220 6469 7374 7269 6275 dify or distribu │ │ │ │ +00014ed0: 7465 2074 6865 2077 6f72 6b20 696e 2061 te the work in a │ │ │ │ +00014ee0: 2077 6179 0a20 2020 2020 7265 7175 6972 way. requir │ │ │ │ +00014ef0: 696e 6720 7065 726d 6973 7369 6f6e 2075 ing permission u │ │ │ │ +00014f00: 6e64 6572 2063 6f70 7972 6967 6874 206c nder copyright l │ │ │ │ +00014f10: 6177 2e0a 0a20 2020 2020 4120 224d 6f64 aw... A "Mod │ │ │ │ +00014f20: 6966 6965 6420 5665 7273 696f 6e22 206f ified Version" o │ │ │ │ +00014f30: 6620 7468 6520 446f 6375 6d65 6e74 206d f the Document m │ │ │ │ +00014f40: 6561 6e73 2061 6e79 2077 6f72 6b20 636f eans any work co │ │ │ │ +00014f50: 6e74 6169 6e69 6e67 2074 6865 0a20 2020 ntaining the. │ │ │ │ +00014f60: 2020 446f 6375 6d65 6e74 206f 7220 6120 Document or a │ │ │ │ +00014f70: 706f 7274 696f 6e20 6f66 2069 742c 2065 portion of it, e │ │ │ │ +00014f80: 6974 6865 7220 636f 7069 6564 2076 6572 ither copied ver │ │ │ │ +00014f90: 6261 7469 6d2c 206f 7220 7769 7468 0a20 batim, or with. │ │ │ │ +00014fa0: 2020 2020 6d6f 6469 6669 6361 7469 6f6e modification │ │ │ │ +00014fb0: 7320 616e 642f 6f72 2074 7261 6e73 6c61 s and/or transla │ │ │ │ +00014fc0: 7465 6420 696e 746f 2061 6e6f 7468 6572 ted into another │ │ │ │ +00014fd0: 206c 616e 6775 6167 652e 0a0a 2020 2020 language... │ │ │ │ +00014fe0: 2041 2022 5365 636f 6e64 6172 7920 5365 A "Secondary Se │ │ │ │ +00014ff0: 6374 696f 6e22 2069 7320 6120 6e61 6d65 ction" is a name │ │ │ │ +00015000: 6420 6170 7065 6e64 6978 206f 7220 6120 d appendix or a │ │ │ │ +00015010: 6672 6f6e 742d 6d61 7474 6572 2073 6563 front-matter sec │ │ │ │ +00015020: 7469 6f6e 0a20 2020 2020 6f66 2074 6865 tion. of the │ │ │ │ +00015030: 2044 6f63 756d 656e 7420 7468 6174 2064 Document that d │ │ │ │ +00015040: 6561 6c73 2065 7863 6c75 7369 7665 6c79 eals exclusively │ │ │ │ +00015050: 2077 6974 6820 7468 6520 7265 6c61 7469 with the relati │ │ │ │ +00015060: 6f6e 7368 6970 206f 6620 7468 650a 2020 onship of the. │ │ │ │ +00015070: 2020 2070 7562 6c69 7368 6572 7320 6f72 publishers or │ │ │ │ +00015080: 2061 7574 686f 7273 206f 6620 7468 6520 authors of the │ │ │ │ +00015090: 446f 6375 6d65 6e74 2074 6f20 7468 6520 Document to the │ │ │ │ +000150a0: 446f 6375 6d65 6e74 2773 206f 7665 7261 Document's overa │ │ │ │ +000150b0: 6c6c 0a20 2020 2020 7375 626a 6563 7420 ll. subject │ │ │ │ +000150c0: 286f 7220 746f 2072 656c 6174 6564 206d (or to related m │ │ │ │ +000150d0: 6174 7465 7273 2920 616e 6420 636f 6e74 atters) and cont │ │ │ │ +000150e0: 6169 6e73 206e 6f74 6869 6e67 2074 6861 ains nothing tha │ │ │ │ +000150f0: 7420 636f 756c 640a 2020 2020 2066 616c t could. fal │ │ │ │ +00015100: 6c20 6469 7265 6374 6c79 2077 6974 6869 l directly withi │ │ │ │ +00015110: 6e20 7468 6174 206f 7665 7261 6c6c 2073 n that overall s │ │ │ │ +00015120: 7562 6a65 6374 2e20 2028 5468 7573 2c20 ubject. (Thus, │ │ │ │ +00015130: 6966 2074 6865 2044 6f63 756d 656e 740a if the Document. │ │ │ │ +00015140: 2020 2020 2069 7320 696e 2070 6172 7420 is in part │ │ │ │ +00015150: 6120 7465 7874 626f 6f6b 206f 6620 6d61 a textbook of ma │ │ │ │ +00015160: 7468 656d 6174 6963 732c 2061 2053 6563 thematics, a Sec │ │ │ │ +00015170: 6f6e 6461 7279 2053 6563 7469 6f6e 206d ondary Section m │ │ │ │ +00015180: 6179 206e 6f74 0a20 2020 2020 6578 706c ay not. expl │ │ │ │ +00015190: 6169 6e20 616e 7920 6d61 7468 656d 6174 ain any mathemat │ │ │ │ +000151a0: 6963 732e 2920 2054 6865 2072 656c 6174 ics.) The relat │ │ │ │ +000151b0: 696f 6e73 6869 7020 636f 756c 6420 6265 ionship could be │ │ │ │ +000151c0: 2061 206d 6174 7465 7220 6f66 0a20 2020 a matter of. │ │ │ │ +000151d0: 2020 6869 7374 6f72 6963 616c 2063 6f6e historical con │ │ │ │ +000151e0: 6e65 6374 696f 6e20 7769 7468 2074 6865 nection with the │ │ │ │ +000151f0: 2073 7562 6a65 6374 206f 7220 7769 7468 subject or with │ │ │ │ +00015200: 2072 656c 6174 6564 206d 6174 7465 7273 related matters │ │ │ │ +00015210: 2c20 6f72 0a20 2020 2020 6f66 206c 6567 , or. of leg │ │ │ │ +00015220: 616c 2c20 636f 6d6d 6572 6369 616c 2c20 al, commercial, │ │ │ │ +00015230: 7068 696c 6f73 6f70 6869 6361 6c2c 2065 philosophical, e │ │ │ │ +00015240: 7468 6963 616c 206f 7220 706f 6c69 7469 thical or politi │ │ │ │ +00015250: 6361 6c20 706f 7369 7469 6f6e 0a20 2020 cal position. │ │ │ │ +00015260: 2020 7265 6761 7264 696e 6720 7468 656d regarding them │ │ │ │ +00015270: 2e0a 0a20 2020 2020 5468 6520 2249 6e76 ... The "Inv │ │ │ │ +00015280: 6172 6961 6e74 2053 6563 7469 6f6e 7322 ariant Sections" │ │ │ │ +00015290: 2061 7265 2063 6572 7461 696e 2053 6563 are certain Sec │ │ │ │ +000152a0: 6f6e 6461 7279 2053 6563 7469 6f6e 7320 ondary Sections │ │ │ │ +000152b0: 7768 6f73 650a 2020 2020 2074 6974 6c65 whose. title │ │ │ │ +000152c0: 7320 6172 6520 6465 7369 676e 6174 6564 s are designated │ │ │ │ +000152d0: 2c20 6173 2062 6569 6e67 2074 686f 7365 , as being those │ │ │ │ +000152e0: 206f 6620 496e 7661 7269 616e 7420 5365 of Invariant Se │ │ │ │ +000152f0: 6374 696f 6e73 2c20 696e 2074 6865 0a20 ctions, in the. │ │ │ │ +00015300: 2020 2020 6e6f 7469 6365 2074 6861 7420 notice that │ │ │ │ +00015310: 7361 7973 2074 6861 7420 7468 6520 446f says that the Do │ │ │ │ +00015320: 6375 6d65 6e74 2069 7320 7265 6c65 6173 cument is releas │ │ │ │ +00015330: 6564 2075 6e64 6572 2074 6869 7320 4c69 ed under this Li │ │ │ │ +00015340: 6365 6e73 652e 0a20 2020 2020 4966 2061 cense.. If a │ │ │ │ +00015350: 2073 6563 7469 6f6e 2064 6f65 7320 6e6f section does no │ │ │ │ +00015360: 7420 6669 7420 7468 6520 6162 6f76 6520 t fit the above │ │ │ │ +00015370: 6465 6669 6e69 7469 6f6e 206f 6620 5365 definition of Se │ │ │ │ +00015380: 636f 6e64 6172 7920 7468 656e 2069 740a condary then it. │ │ │ │ +00015390: 2020 2020 2069 7320 6e6f 7420 616c 6c6f is not allo │ │ │ │ +000153a0: 7765 6420 746f 2062 6520 6465 7369 676e wed to be design │ │ │ │ +000153b0: 6174 6564 2061 7320 496e 7661 7269 616e ated as Invarian │ │ │ │ +000153c0: 742e 2020 5468 6520 446f 6375 6d65 6e74 t. The Document │ │ │ │ +000153d0: 206d 6179 0a20 2020 2020 636f 6e74 6169 may. contai │ │ │ │ +000153e0: 6e20 7a65 726f 2049 6e76 6172 6961 6e74 n zero Invariant │ │ │ │ +000153f0: 2053 6563 7469 6f6e 732e 2020 4966 2074 Sections. If t │ │ │ │ +00015400: 6865 2044 6f63 756d 656e 7420 646f 6573 he Document does │ │ │ │ +00015410: 206e 6f74 2069 6465 6e74 6966 790a 2020 not identify. │ │ │ │ +00015420: 2020 2061 6e79 2049 6e76 6172 6961 6e74 any Invariant │ │ │ │ +00015430: 2053 6563 7469 6f6e 7320 7468 656e 2074 Sections then t │ │ │ │ +00015440: 6865 7265 2061 7265 206e 6f6e 652e 0a0a here are none... │ │ │ │ +00015450: 2020 2020 2054 6865 2022 436f 7665 7220 The "Cover │ │ │ │ +00015460: 5465 7874 7322 2061 7265 2063 6572 7461 Texts" are certa │ │ │ │ +00015470: 696e 2073 686f 7274 2070 6173 7361 6765 in short passage │ │ │ │ +00015480: 7320 6f66 2074 6578 7420 7468 6174 2061 s of text that a │ │ │ │ +00015490: 7265 0a20 2020 2020 6c69 7374 6564 2c20 re. listed, │ │ │ │ +000154a0: 6173 2046 726f 6e74 2d43 6f76 6572 2054 as Front-Cover T │ │ │ │ +000154b0: 6578 7473 206f 7220 4261 636b 2d43 6f76 exts or Back-Cov │ │ │ │ +000154c0: 6572 2054 6578 7473 2c20 696e 2074 6865 er Texts, in the │ │ │ │ +000154d0: 206e 6f74 6963 650a 2020 2020 2074 6861 notice. tha │ │ │ │ +000154e0: 7420 7361 7973 2074 6861 7420 7468 6520 t says that the │ │ │ │ +000154f0: 446f 6375 6d65 6e74 2069 7320 7265 6c65 Document is rele │ │ │ │ +00015500: 6173 6564 2075 6e64 6572 2074 6869 7320 ased under this │ │ │ │ +00015510: 4c69 6365 6e73 652e 2020 410a 2020 2020 License. A. │ │ │ │ +00015520: 2046 726f 6e74 2d43 6f76 6572 2054 6578 Front-Cover Tex │ │ │ │ +00015530: 7420 6d61 7920 6265 2061 7420 6d6f 7374 t may be at most │ │ │ │ +00015540: 2035 2077 6f72 6473 2c20 616e 6420 6120 5 words, and a │ │ │ │ +00015550: 4261 636b 2d43 6f76 6572 2054 6578 7420 Back-Cover Text │ │ │ │ +00015560: 6d61 790a 2020 2020 2062 6520 6174 206d may. be at m │ │ │ │ +00015570: 6f73 7420 3235 2077 6f72 6473 2e0a 0a20 ost 25 words... │ │ │ │ +00015580: 2020 2020 4120 2254 7261 6e73 7061 7265 A "Transpare │ │ │ │ +00015590: 6e74 2220 636f 7079 206f 6620 7468 6520 nt" copy of the │ │ │ │ +000155a0: 446f 6375 6d65 6e74 206d 6561 6e73 2061 Document means a │ │ │ │ +000155b0: 206d 6163 6869 6e65 2d72 6561 6461 626c machine-readabl │ │ │ │ +000155c0: 6520 636f 7079 2c0a 2020 2020 2072 6570 e copy,. rep │ │ │ │ +000155d0: 7265 7365 6e74 6564 2069 6e20 6120 666f resented in a fo │ │ │ │ +000155e0: 726d 6174 2077 686f 7365 2073 7065 6369 rmat whose speci │ │ │ │ +000155f0: 6669 6361 7469 6f6e 2069 7320 6176 6169 fication is avai │ │ │ │ +00015600: 6c61 626c 6520 746f 2074 6865 0a20 2020 lable to the. │ │ │ │ +00015610: 2020 6765 6e65 7261 6c20 7075 626c 6963 general public │ │ │ │ +00015620: 2c20 7468 6174 2069 7320 7375 6974 6162 , that is suitab │ │ │ │ +00015630: 6c65 2066 6f72 2072 6576 6973 696e 6720 le for revising │ │ │ │ +00015640: 7468 6520 646f 6375 6d65 6e74 0a20 2020 the document. │ │ │ │ +00015650: 2020 7374 7261 6967 6874 666f 7277 6172 straightforwar │ │ │ │ +00015660: 646c 7920 7769 7468 2067 656e 6572 6963 dly with generic │ │ │ │ +00015670: 2074 6578 7420 6564 6974 6f72 7320 6f72 text editors or │ │ │ │ +00015680: 2028 666f 7220 696d 6167 6573 2063 6f6d (for images com │ │ │ │ +00015690: 706f 7365 640a 2020 2020 206f 6620 7069 posed. of pi │ │ │ │ +000156a0: 7865 6c73 2920 6765 6e65 7269 6320 7061 xels) generic pa │ │ │ │ +000156b0: 696e 7420 7072 6f67 7261 6d73 206f 7220 int programs or │ │ │ │ +000156c0: 2866 6f72 2064 7261 7769 6e67 7329 2073 (for drawings) s │ │ │ │ +000156d0: 6f6d 6520 7769 6465 6c79 0a20 2020 2020 ome widely. │ │ │ │ +000156e0: 6176 6169 6c61 626c 6520 6472 6177 696e available drawin │ │ │ │ +000156f0: 6720 6564 6974 6f72 2c20 616e 6420 7468 g editor, and th │ │ │ │ +00015700: 6174 2069 7320 7375 6974 6162 6c65 2066 at is suitable f │ │ │ │ +00015710: 6f72 2069 6e70 7574 2074 6f20 7465 7874 or input to text │ │ │ │ +00015720: 0a20 2020 2020 666f 726d 6174 7465 7273 . formatters │ │ │ │ +00015730: 206f 7220 666f 7220 6175 746f 6d61 7469 or for automati │ │ │ │ +00015740: 6320 7472 616e 736c 6174 696f 6e20 746f c translation to │ │ │ │ +00015750: 2061 2076 6172 6965 7479 206f 6620 666f a variety of fo │ │ │ │ +00015760: 726d 6174 730a 2020 2020 2073 7569 7461 rmats. suita │ │ │ │ +00015770: 626c 6520 666f 7220 696e 7075 7420 746f ble for input to │ │ │ │ +00015780: 2074 6578 7420 666f 726d 6174 7465 7273 text formatters │ │ │ │ +00015790: 2e20 2041 2063 6f70 7920 6d61 6465 2069 . A copy made i │ │ │ │ +000157a0: 6e20 616e 206f 7468 6572 7769 7365 0a20 n an otherwise. │ │ │ │ +000157b0: 2020 2020 5472 616e 7370 6172 656e 7420 Transparent │ │ │ │ +000157c0: 6669 6c65 2066 6f72 6d61 7420 7768 6f73 file format whos │ │ │ │ +000157d0: 6520 6d61 726b 7570 2c20 6f72 2061 6273 e markup, or abs │ │ │ │ +000157e0: 656e 6365 206f 6620 6d61 726b 7570 2c20 ence of markup, │ │ │ │ +000157f0: 6861 730a 2020 2020 2062 6565 6e20 6172 has. been ar │ │ │ │ +00015800: 7261 6e67 6564 2074 6f20 7468 7761 7274 ranged to thwart │ │ │ │ +00015810: 206f 7220 6469 7363 6f75 7261 6765 2073 or discourage s │ │ │ │ +00015820: 7562 7365 7175 656e 7420 6d6f 6469 6669 ubsequent modifi │ │ │ │ +00015830: 6361 7469 6f6e 2062 790a 2020 2020 2072 cation by. r │ │ │ │ +00015840: 6561 6465 7273 2069 7320 6e6f 7420 5472 eaders is not Tr │ │ │ │ +00015850: 616e 7370 6172 656e 742e 2020 416e 2069 ansparent. An i │ │ │ │ +00015860: 6d61 6765 2066 6f72 6d61 7420 6973 206e mage format is n │ │ │ │ +00015870: 6f74 2054 7261 6e73 7061 7265 6e74 2069 ot Transparent i │ │ │ │ +00015880: 660a 2020 2020 2075 7365 6420 666f 7220 f. used for │ │ │ │ +00015890: 616e 7920 7375 6273 7461 6e74 6961 6c20 any substantial │ │ │ │ +000158a0: 616d 6f75 6e74 206f 6620 7465 7874 2e20 amount of text. │ │ │ │ +000158b0: 2041 2063 6f70 7920 7468 6174 2069 7320 A copy that is │ │ │ │ +000158c0: 6e6f 740a 2020 2020 2022 5472 616e 7370 not. "Transp │ │ │ │ +000158d0: 6172 656e 7422 2069 7320 6361 6c6c 6564 arent" is called │ │ │ │ +000158e0: 2022 4f70 6171 7565 222e 0a0a 2020 2020 "Opaque"... │ │ │ │ +000158f0: 2045 7861 6d70 6c65 7320 6f66 2073 7569 Examples of sui │ │ │ │ +00015900: 7461 626c 6520 666f 726d 6174 7320 666f table formats fo │ │ │ │ +00015910: 7220 5472 616e 7370 6172 656e 7420 636f r Transparent co │ │ │ │ +00015920: 7069 6573 2069 6e63 6c75 6465 2070 6c61 pies include pla │ │ │ │ +00015930: 696e 0a20 2020 2020 4153 4349 4920 7769 in. ASCII wi │ │ │ │ +00015940: 7468 6f75 7420 6d61 726b 7570 2c20 5465 thout markup, Te │ │ │ │ +00015950: 7869 6e66 6f20 696e 7075 7420 666f 726d xinfo input form │ │ │ │ +00015960: 6174 2c20 4c61 5465 5820 696e 7075 7420 at, LaTeX input │ │ │ │ +00015970: 666f 726d 6174 2c0a 2020 2020 2053 474d format,. SGM │ │ │ │ +00015980: 4c20 6f72 2058 4d4c 2075 7369 6e67 2061 L or XML using a │ │ │ │ +00015990: 2070 7562 6c69 636c 7920 6176 6169 6c61 publicly availa │ │ │ │ +000159a0: 626c 6520 4454 442c 2061 6e64 2073 7461 ble DTD, and sta │ │ │ │ +000159b0: 6e64 6172 642d 636f 6e66 6f72 6d69 6e67 ndard-conforming │ │ │ │ +000159c0: 0a20 2020 2020 7369 6d70 6c65 2048 544d . simple HTM │ │ │ │ +000159d0: 4c2c 2050 6f73 7453 6372 6970 7420 6f72 L, PostScript or │ │ │ │ +000159e0: 2050 4446 2064 6573 6967 6e65 6420 666f PDF designed fo │ │ │ │ +000159f0: 7220 6875 6d61 6e20 6d6f 6469 6669 6361 r human modifica │ │ │ │ +00015a00: 7469 6f6e 2e0a 2020 2020 2045 7861 6d70 tion.. Examp │ │ │ │ +00015a10: 6c65 7320 6f66 2074 7261 6e73 7061 7265 les of transpare │ │ │ │ +00015a20: 6e74 2069 6d61 6765 2066 6f72 6d61 7473 nt image formats │ │ │ │ +00015a30: 2069 6e63 6c75 6465 2050 4e47 2c20 5843 include PNG, XC │ │ │ │ +00015a40: 4620 616e 6420 4a50 472e 0a20 2020 2020 F and JPG.. │ │ │ │ +00015a50: 4f70 6171 7565 2066 6f72 6d61 7473 2069 Opaque formats i │ │ │ │ +00015a60: 6e63 6c75 6465 2070 726f 7072 6965 7461 nclude proprieta │ │ │ │ +00015a70: 7279 2066 6f72 6d61 7473 2074 6861 7420 ry formats that │ │ │ │ +00015a80: 6361 6e20 6265 2072 6561 6420 616e 640a can be read and. │ │ │ │ +00015a90: 2020 2020 2065 6469 7465 6420 6f6e 6c79 edited only │ │ │ │ +00015aa0: 2062 7920 7072 6f70 7269 6574 6172 7920 by proprietary │ │ │ │ +00015ab0: 776f 7264 2070 726f 6365 7373 6f72 732c word processors, │ │ │ │ +00015ac0: 2053 474d 4c20 6f72 2058 4d4c 2066 6f72 SGML or XML for │ │ │ │ +00015ad0: 2077 6869 6368 0a20 2020 2020 7468 6520 which. the │ │ │ │ +00015ae0: 4454 4420 616e 642f 6f72 2070 726f 6365 DTD and/or proce │ │ │ │ +00015af0: 7373 696e 6720 746f 6f6c 7320 6172 6520 ssing tools are │ │ │ │ +00015b00: 6e6f 7420 6765 6e65 7261 6c6c 7920 6176 not generally av │ │ │ │ +00015b10: 6169 6c61 626c 652c 2061 6e64 0a20 2020 ailable, and. │ │ │ │ +00015b20: 2020 7468 6520 6d61 6368 696e 652d 6765 the machine-ge │ │ │ │ +00015b30: 6e65 7261 7465 6420 4854 4d4c 2c20 506f nerated HTML, Po │ │ │ │ +00015b40: 7374 5363 7269 7074 206f 7220 5044 4620 stScript or PDF │ │ │ │ +00015b50: 7072 6f64 7563 6564 2062 7920 736f 6d65 produced by some │ │ │ │ +00015b60: 2077 6f72 640a 2020 2020 2070 726f 6365 word. proce │ │ │ │ +00015b70: 7373 6f72 7320 666f 7220 6f75 7470 7574 ssors for output │ │ │ │ +00015b80: 2070 7572 706f 7365 7320 6f6e 6c79 2e0a purposes only.. │ │ │ │ +00015b90: 0a20 2020 2020 5468 6520 2254 6974 6c65 . The "Title │ │ │ │ +00015ba0: 2050 6167 6522 206d 6561 6e73 2c20 666f Page" means, fo │ │ │ │ +00015bb0: 7220 6120 7072 696e 7465 6420 626f 6f6b r a printed book │ │ │ │ +00015bc0: 2c20 7468 6520 7469 746c 6520 7061 6765 , the title page │ │ │ │ +00015bd0: 2069 7473 656c 662c 0a20 2020 2020 706c itself,. pl │ │ │ │ +00015be0: 7573 2073 7563 6820 666f 6c6c 6f77 696e us such followin │ │ │ │ +00015bf0: 6720 7061 6765 7320 6173 2061 7265 206e g pages as are n │ │ │ │ +00015c00: 6565 6465 6420 746f 2068 6f6c 642c 206c eeded to hold, l │ │ │ │ +00015c10: 6567 6962 6c79 2c20 7468 650a 2020 2020 egibly, the. │ │ │ │ +00015c20: 206d 6174 6572 6961 6c20 7468 6973 204c material this L │ │ │ │ +00015c30: 6963 656e 7365 2072 6571 7569 7265 7320 icense requires │ │ │ │ +00015c40: 746f 2061 7070 6561 7220 696e 2074 6865 to appear in the │ │ │ │ +00015c50: 2074 6974 6c65 2070 6167 652e 2020 466f title page. Fo │ │ │ │ +00015c60: 720a 2020 2020 2077 6f72 6b73 2069 6e20 r. works in │ │ │ │ +00015c70: 666f 726d 6174 7320 7768 6963 6820 646f formats which do │ │ │ │ +00015c80: 206e 6f74 2068 6176 6520 616e 7920 7469 not have any ti │ │ │ │ +00015c90: 746c 6520 7061 6765 2061 7320 7375 6368 tle page as such │ │ │ │ +00015ca0: 2c20 2254 6974 6c65 0a20 2020 2020 5061 , "Title. Pa │ │ │ │ +00015cb0: 6765 2220 6d65 616e 7320 7468 6520 7465 ge" means the te │ │ │ │ +00015cc0: 7874 206e 6561 7220 7468 6520 6d6f 7374 xt near the most │ │ │ │ +00015cd0: 2070 726f 6d69 6e65 6e74 2061 7070 6561 prominent appea │ │ │ │ +00015ce0: 7261 6e63 6520 6f66 2074 6865 0a20 2020 rance of the. │ │ │ │ +00015cf0: 2020 776f 726b 2773 2074 6974 6c65 2c20 work's title, │ │ │ │ +00015d00: 7072 6563 6564 696e 6720 7468 6520 6265 preceding the be │ │ │ │ +00015d10: 6769 6e6e 696e 6720 6f66 2074 6865 2062 ginning of the b │ │ │ │ +00015d20: 6f64 7920 6f66 2074 6865 2074 6578 742e ody of the text. │ │ │ │ +00015d30: 0a0a 2020 2020 2041 2073 6563 7469 6f6e .. A section │ │ │ │ +00015d40: 2022 456e 7469 746c 6564 2058 595a 2220 "Entitled XYZ" │ │ │ │ +00015d50: 6d65 616e 7320 6120 6e61 6d65 6420 7375 means a named su │ │ │ │ +00015d60: 6275 6e69 7420 6f66 2074 6865 2044 6f63 bunit of the Doc │ │ │ │ +00015d70: 756d 656e 740a 2020 2020 2077 686f 7365 ument. whose │ │ │ │ +00015d80: 2074 6974 6c65 2065 6974 6865 7220 6973 title either is │ │ │ │ +00015d90: 2070 7265 6369 7365 6c79 2058 595a 206f precisely XYZ o │ │ │ │ +00015da0: 7220 636f 6e74 6169 6e73 2058 595a 2069 r contains XYZ i │ │ │ │ +00015db0: 6e20 7061 7265 6e74 6865 7365 730a 2020 n parentheses. │ │ │ │ +00015dc0: 2020 2066 6f6c 6c6f 7769 6e67 2074 6578 following tex │ │ │ │ +00015dd0: 7420 7468 6174 2074 7261 6e73 6c61 7465 t that translate │ │ │ │ +00015de0: 7320 5859 5a20 696e 2061 6e6f 7468 6572 s XYZ in another │ │ │ │ +00015df0: 206c 616e 6775 6167 652e 2020 2848 6572 language. (Her │ │ │ │ +00015e00: 6520 5859 5a0a 2020 2020 2073 7461 6e64 e XYZ. stand │ │ │ │ +00015e10: 7320 666f 7220 6120 7370 6563 6966 6963 s for a specific │ │ │ │ +00015e20: 2073 6563 7469 6f6e 206e 616d 6520 6d65 section name me │ │ │ │ +00015e30: 6e74 696f 6e65 6420 6265 6c6f 772c 2073 ntioned below, s │ │ │ │ +00015e40: 7563 6820 6173 0a20 2020 2020 2241 636b uch as. "Ack │ │ │ │ +00015e50: 6e6f 776c 6564 6765 6d65 6e74 7322 2c20 nowledgements", │ │ │ │ +00015e60: 2244 6564 6963 6174 696f 6e73 222c 2022 "Dedications", " │ │ │ │ +00015e70: 456e 646f 7273 656d 656e 7473 222c 206f Endorsements", o │ │ │ │ +00015e80: 7220 2248 6973 746f 7279 222e 290a 2020 r "History".). │ │ │ │ +00015e90: 2020 2054 6f20 2250 7265 7365 7276 6520 To "Preserve │ │ │ │ +00015ea0: 7468 6520 5469 746c 6522 206f 6620 7375 the Title" of su │ │ │ │ +00015eb0: 6368 2061 2073 6563 7469 6f6e 2077 6865 ch a section whe │ │ │ │ +00015ec0: 6e20 796f 7520 6d6f 6469 6679 2074 6865 n you modify the │ │ │ │ +00015ed0: 0a20 2020 2020 446f 6375 6d65 6e74 206d . Document m │ │ │ │ +00015ee0: 6561 6e73 2074 6861 7420 6974 2072 656d eans that it rem │ │ │ │ +00015ef0: 6169 6e73 2061 2073 6563 7469 6f6e 2022 ains a section " │ │ │ │ +00015f00: 456e 7469 746c 6564 2058 595a 2220 6163 Entitled XYZ" ac │ │ │ │ +00015f10: 636f 7264 696e 670a 2020 2020 2074 6f20 cording. to │ │ │ │ +00015f20: 7468 6973 2064 6566 696e 6974 696f 6e2e this definition. │ │ │ │ +00015f30: 0a0a 2020 2020 2054 6865 2044 6f63 756d .. The Docum │ │ │ │ +00015f40: 656e 7420 6d61 7920 696e 636c 7564 6520 ent may include │ │ │ │ +00015f50: 5761 7272 616e 7479 2044 6973 636c 6169 Warranty Disclai │ │ │ │ +00015f60: 6d65 7273 206e 6578 7420 746f 2074 6865 mers next to the │ │ │ │ +00015f70: 206e 6f74 6963 650a 2020 2020 2077 6869 notice. whi │ │ │ │ +00015f80: 6368 2073 7461 7465 7320 7468 6174 2074 ch states that t │ │ │ │ +00015f90: 6869 7320 4c69 6365 6e73 6520 6170 706c his License appl │ │ │ │ +00015fa0: 6965 7320 746f 2074 6865 2044 6f63 756d ies to the Docum │ │ │ │ +00015fb0: 656e 742e 2020 5468 6573 650a 2020 2020 ent. These. │ │ │ │ +00015fc0: 2057 6172 7261 6e74 7920 4469 7363 6c61 Warranty Discla │ │ │ │ +00015fd0: 696d 6572 7320 6172 6520 636f 6e73 6964 imers are consid │ │ │ │ +00015fe0: 6572 6564 2074 6f20 6265 2069 6e63 6c75 ered to be inclu │ │ │ │ +00015ff0: 6465 6420 6279 2072 6566 6572 656e 6365 ded by reference │ │ │ │ +00016000: 2069 6e0a 2020 2020 2074 6869 7320 4c69 in. this Li │ │ │ │ +00016010: 6365 6e73 652c 2062 7574 206f 6e6c 7920 cense, but only │ │ │ │ +00016020: 6173 2072 6567 6172 6473 2064 6973 636c as regards discl │ │ │ │ +00016030: 6169 6d69 6e67 2077 6172 7261 6e74 6965 aiming warrantie │ │ │ │ +00016040: 733a 2061 6e79 206f 7468 6572 0a20 2020 s: any other. │ │ │ │ +00016050: 2020 696d 706c 6963 6174 696f 6e20 7468 implication th │ │ │ │ +00016060: 6174 2074 6865 7365 2057 6172 7261 6e74 at these Warrant │ │ │ │ +00016070: 7920 4469 7363 6c61 696d 6572 7320 6d61 y Disclaimers ma │ │ │ │ +00016080: 7920 6861 7665 2069 7320 766f 6964 2061 y have is void a │ │ │ │ +00016090: 6e64 0a20 2020 2020 6861 7320 6e6f 2065 nd. has no e │ │ │ │ +000160a0: 6666 6563 7420 6f6e 2074 6865 206d 6561 ffect on the mea │ │ │ │ +000160b0: 6e69 6e67 206f 6620 7468 6973 204c 6963 ning of this Lic │ │ │ │ +000160c0: 656e 7365 2e0a 0a20 2032 2e20 5645 5242 ense... 2. VERB │ │ │ │ +000160d0: 4154 494d 2043 4f50 5949 4e47 0a0a 2020 ATIM COPYING.. │ │ │ │ +000160e0: 2020 2059 6f75 206d 6179 2063 6f70 7920 You may copy │ │ │ │ +000160f0: 616e 6420 6469 7374 7269 6275 7465 2074 and distribute t │ │ │ │ +00016100: 6865 2044 6f63 756d 656e 7420 696e 2061 he Document in a │ │ │ │ +00016110: 6e79 206d 6564 6975 6d2c 2065 6974 6865 ny medium, eithe │ │ │ │ +00016120: 720a 2020 2020 2063 6f6d 6d65 7263 6961 r. commercia │ │ │ │ +00016130: 6c6c 7920 6f72 206e 6f6e 636f 6d6d 6572 lly or noncommer │ │ │ │ +00016140: 6369 616c 6c79 2c20 7072 6f76 6964 6564 cially, provided │ │ │ │ +00016150: 2074 6861 7420 7468 6973 204c 6963 656e that this Licen │ │ │ │ +00016160: 7365 2c20 7468 650a 2020 2020 2063 6f70 se, the. cop │ │ │ │ +00016170: 7972 6967 6874 206e 6f74 6963 6573 2c20 yright notices, │ │ │ │ +00016180: 616e 6420 7468 6520 6c69 6365 6e73 6520 and the license │ │ │ │ +00016190: 6e6f 7469 6365 2073 6179 696e 6720 7468 notice saying th │ │ │ │ +000161a0: 6973 204c 6963 656e 7365 0a20 2020 2020 is License. │ │ │ │ +000161b0: 6170 706c 6965 7320 746f 2074 6865 2044 applies to the D │ │ │ │ +000161c0: 6f63 756d 656e 7420 6172 6520 7265 7072 ocument are repr │ │ │ │ +000161d0: 6f64 7563 6564 2069 6e20 616c 6c20 636f oduced in all co │ │ │ │ +000161e0: 7069 6573 2c20 616e 6420 7468 6174 2079 pies, and that y │ │ │ │ +000161f0: 6f75 0a20 2020 2020 6164 6420 6e6f 206f ou. add no o │ │ │ │ +00016200: 7468 6572 2063 6f6e 6469 7469 6f6e 7320 ther conditions │ │ │ │ +00016210: 7768 6174 736f 6576 6572 2074 6f20 7468 whatsoever to th │ │ │ │ +00016220: 6f73 6520 6f66 2074 6869 7320 4c69 6365 ose of this Lice │ │ │ │ +00016230: 6e73 652e 2020 596f 750a 2020 2020 206d nse. You. m │ │ │ │ +00016240: 6179 206e 6f74 2075 7365 2074 6563 686e ay not use techn │ │ │ │ +00016250: 6963 616c 206d 6561 7375 7265 7320 746f ical measures to │ │ │ │ +00016260: 206f 6273 7472 7563 7420 6f72 2063 6f6e obstruct or con │ │ │ │ +00016270: 7472 6f6c 2074 6865 2072 6561 6469 6e67 trol the reading │ │ │ │ +00016280: 0a20 2020 2020 6f72 2066 7572 7468 6572 . or further │ │ │ │ +00016290: 2063 6f70 7969 6e67 206f 6620 7468 6520 copying of the │ │ │ │ +000162a0: 636f 7069 6573 2079 6f75 206d 616b 6520 copies you make │ │ │ │ +000162b0: 6f72 2064 6973 7472 6962 7574 652e 2020 or distribute. │ │ │ │ +000162c0: 486f 7765 7665 722c 0a20 2020 2020 796f However,. yo │ │ │ │ +000162d0: 7520 6d61 7920 6163 6365 7074 2063 6f6d u may accept com │ │ │ │ +000162e0: 7065 6e73 6174 696f 6e20 696e 2065 7863 pensation in exc │ │ │ │ +000162f0: 6861 6e67 6520 666f 7220 636f 7069 6573 hange for copies │ │ │ │ +00016300: 2e20 2049 6620 796f 750a 2020 2020 2064 . If you. d │ │ │ │ +00016310: 6973 7472 6962 7574 6520 6120 6c61 7267 istribute a larg │ │ │ │ +00016320: 6520 656e 6f75 6768 206e 756d 6265 7220 e enough number │ │ │ │ +00016330: 6f66 2063 6f70 6965 7320 796f 7520 6d75 of copies you mu │ │ │ │ +00016340: 7374 2061 6c73 6f20 666f 6c6c 6f77 2074 st also follow t │ │ │ │ +00016350: 6865 0a20 2020 2020 636f 6e64 6974 696f he. conditio │ │ │ │ +00016360: 6e73 2069 6e20 7365 6374 696f 6e20 332e ns in section 3. │ │ │ │ +00016370: 0a0a 2020 2020 2059 6f75 206d 6179 2061 .. You may a │ │ │ │ +00016380: 6c73 6f20 6c65 6e64 2063 6f70 6965 732c lso lend copies, │ │ │ │ +00016390: 2075 6e64 6572 2074 6865 2073 616d 6520 under the same │ │ │ │ +000163a0: 636f 6e64 6974 696f 6e73 2073 7461 7465 conditions state │ │ │ │ +000163b0: 6420 6162 6f76 652c 0a20 2020 2020 616e d above,. an │ │ │ │ +000163c0: 6420 796f 7520 6d61 7920 7075 626c 6963 d you may public │ │ │ │ +000163d0: 6c79 2064 6973 706c 6179 2063 6f70 6965 ly display copie │ │ │ │ +000163e0: 732e 0a0a 2020 332e 2043 4f50 5949 4e47 s... 3. COPYING │ │ │ │ +000163f0: 2049 4e20 5155 414e 5449 5459 0a0a 2020 IN QUANTITY.. │ │ │ │ +00016400: 2020 2049 6620 796f 7520 7075 626c 6973 If you publis │ │ │ │ +00016410: 6820 7072 696e 7465 6420 636f 7069 6573 h printed copies │ │ │ │ +00016420: 2028 6f72 2063 6f70 6965 7320 696e 206d (or copies in m │ │ │ │ +00016430: 6564 6961 2074 6861 7420 636f 6d6d 6f6e edia that common │ │ │ │ +00016440: 6c79 0a20 2020 2020 6861 7665 2070 7269 ly. have pri │ │ │ │ +00016450: 6e74 6564 2063 6f76 6572 7329 206f 6620 nted covers) of │ │ │ │ +00016460: 7468 6520 446f 6375 6d65 6e74 2c20 6e75 the Document, nu │ │ │ │ +00016470: 6d62 6572 696e 6720 6d6f 7265 2074 6861 mbering more tha │ │ │ │ +00016480: 6e20 3130 302c 2061 6e64 0a20 2020 2020 n 100, and. │ │ │ │ +00016490: 7468 6520 446f 6375 6d65 6e74 2773 206c the Document's l │ │ │ │ +000164a0: 6963 656e 7365 206e 6f74 6963 6520 7265 icense notice re │ │ │ │ +000164b0: 7175 6972 6573 2043 6f76 6572 2054 6578 quires Cover Tex │ │ │ │ +000164c0: 7473 2c20 796f 7520 6d75 7374 0a20 2020 ts, you must. │ │ │ │ +000164d0: 2020 656e 636c 6f73 6520 7468 6520 636f enclose the co │ │ │ │ +000164e0: 7069 6573 2069 6e20 636f 7665 7273 2074 pies in covers t │ │ │ │ +000164f0: 6861 7420 6361 7272 792c 2063 6c65 6172 hat carry, clear │ │ │ │ +00016500: 6c79 2061 6e64 206c 6567 6962 6c79 2c20 ly and legibly, │ │ │ │ +00016510: 616c 6c0a 2020 2020 2074 6865 7365 2043 all. these C │ │ │ │ +00016520: 6f76 6572 2054 6578 7473 3a20 4672 6f6e over Texts: Fron │ │ │ │ +00016530: 742d 436f 7665 7220 5465 7874 7320 6f6e t-Cover Texts on │ │ │ │ +00016540: 2074 6865 2066 726f 6e74 2063 6f76 6572 the front cover │ │ │ │ +00016550: 2c20 616e 640a 2020 2020 2042 6163 6b2d , and. Back- │ │ │ │ +00016560: 436f 7665 7220 5465 7874 7320 6f6e 2074 Cover Texts on t │ │ │ │ +00016570: 6865 2062 6163 6b20 636f 7665 722e 2020 he back cover. │ │ │ │ +00016580: 426f 7468 2063 6f76 6572 7320 6d75 7374 Both covers must │ │ │ │ +00016590: 2061 6c73 6f20 636c 6561 726c 790a 2020 also clearly. │ │ │ │ +000165a0: 2020 2061 6e64 206c 6567 6962 6c79 2069 and legibly i │ │ │ │ +000165b0: 6465 6e74 6966 7920 796f 7520 6173 2074 dentify you as t │ │ │ │ +000165c0: 6865 2070 7562 6c69 7368 6572 206f 6620 he publisher of │ │ │ │ +000165d0: 7468 6573 6520 636f 7069 6573 2e20 2054 these copies. T │ │ │ │ +000165e0: 6865 0a20 2020 2020 6672 6f6e 7420 636f he. front co │ │ │ │ +000165f0: 7665 7220 6d75 7374 2070 7265 7365 6e74 ver must present │ │ │ │ +00016600: 2074 6865 2066 756c 6c20 7469 746c 6520 the full title │ │ │ │ +00016610: 7769 7468 2061 6c6c 2077 6f72 6473 206f with all words o │ │ │ │ +00016620: 6620 7468 6520 7469 746c 650a 2020 2020 f the title. │ │ │ │ +00016630: 2065 7175 616c 6c79 2070 726f 6d69 6e65 equally promine │ │ │ │ +00016640: 6e74 2061 6e64 2076 6973 6962 6c65 2e20 nt and visible. │ │ │ │ +00016650: 2059 6f75 206d 6179 2061 6464 206f 7468 You may add oth │ │ │ │ +00016660: 6572 206d 6174 6572 6961 6c20 6f6e 2074 er material on t │ │ │ │ +00016670: 6865 0a20 2020 2020 636f 7665 7273 2069 he. covers i │ │ │ │ +00016680: 6e20 6164 6469 7469 6f6e 2e20 2043 6f70 n addition. Cop │ │ │ │ +00016690: 7969 6e67 2077 6974 6820 6368 616e 6765 ying with change │ │ │ │ +000166a0: 7320 6c69 6d69 7465 6420 746f 2074 6865 s limited to the │ │ │ │ +000166b0: 2063 6f76 6572 732c 2061 730a 2020 2020 covers, as. │ │ │ │ +000166c0: 206c 6f6e 6720 6173 2074 6865 7920 7072 long as they pr │ │ │ │ +000166d0: 6573 6572 7665 2074 6865 2074 6974 6c65 eserve the title │ │ │ │ +000166e0: 206f 6620 7468 6520 446f 6375 6d65 6e74 of the Document │ │ │ │ +000166f0: 2061 6e64 2073 6174 6973 6679 2074 6865 and satisfy the │ │ │ │ +00016700: 7365 0a20 2020 2020 636f 6e64 6974 696f se. conditio │ │ │ │ +00016710: 6e73 2c20 6361 6e20 6265 2074 7265 6174 ns, can be treat │ │ │ │ +00016720: 6564 2061 7320 7665 7262 6174 696d 2063 ed as verbatim c │ │ │ │ +00016730: 6f70 7969 6e67 2069 6e20 6f74 6865 7220 opying in other │ │ │ │ +00016740: 7265 7370 6563 7473 2e0a 0a20 2020 2020 respects... │ │ │ │ +00016750: 4966 2074 6865 2072 6571 7569 7265 6420 If the required │ │ │ │ +00016760: 7465 7874 7320 666f 7220 6569 7468 6572 texts for either │ │ │ │ +00016770: 2063 6f76 6572 2061 7265 2074 6f6f 2076 cover are too v │ │ │ │ +00016780: 6f6c 756d 696e 6f75 7320 746f 2066 6974 oluminous to fit │ │ │ │ +00016790: 0a20 2020 2020 6c65 6769 626c 792c 2079 . legibly, y │ │ │ │ +000167a0: 6f75 2073 686f 756c 6420 7075 7420 7468 ou should put th │ │ │ │ +000167b0: 6520 6669 7273 7420 6f6e 6573 206c 6973 e first ones lis │ │ │ │ +000167c0: 7465 6420 2861 7320 6d61 6e79 2061 7320 ted (as many as │ │ │ │ +000167d0: 6669 740a 2020 2020 2072 6561 736f 6e61 fit. reasona │ │ │ │ +000167e0: 626c 7929 206f 6e20 7468 6520 6163 7475 bly) on the actu │ │ │ │ +000167f0: 616c 2063 6f76 6572 2c20 616e 6420 636f al cover, and co │ │ │ │ +00016800: 6e74 696e 7565 2074 6865 2072 6573 7420 ntinue the rest │ │ │ │ +00016810: 6f6e 746f 0a20 2020 2020 6164 6a61 6365 onto. adjace │ │ │ │ +00016820: 6e74 2070 6167 6573 2e0a 0a20 2020 2020 nt pages... │ │ │ │ +00016830: 4966 2079 6f75 2070 7562 6c69 7368 206f If you publish o │ │ │ │ +00016840: 7220 6469 7374 7269 6275 7465 204f 7061 r distribute Opa │ │ │ │ +00016850: 7175 6520 636f 7069 6573 206f 6620 7468 que copies of th │ │ │ │ +00016860: 6520 446f 6375 6d65 6e74 0a20 2020 2020 e Document. │ │ │ │ +00016870: 6e75 6d62 6572 696e 6720 6d6f 7265 2074 numbering more t │ │ │ │ +00016880: 6861 6e20 3130 302c 2079 6f75 206d 7573 han 100, you mus │ │ │ │ +00016890: 7420 6569 7468 6572 2069 6e63 6c75 6465 t either include │ │ │ │ +000168a0: 2061 206d 6163 6869 6e65 2d72 6561 6461 a machine-reada │ │ │ │ +000168b0: 626c 650a 2020 2020 2054 7261 6e73 7061 ble. Transpa │ │ │ │ +000168c0: 7265 6e74 2063 6f70 7920 616c 6f6e 6720 rent copy along │ │ │ │ +000168d0: 7769 7468 2065 6163 6820 4f70 6171 7565 with each Opaque │ │ │ │ +000168e0: 2063 6f70 792c 206f 7220 7374 6174 6520 copy, or state │ │ │ │ +000168f0: 696e 206f 7220 7769 7468 0a20 2020 2020 in or with. │ │ │ │ +00016900: 6561 6368 204f 7061 7175 6520 636f 7079 each Opaque copy │ │ │ │ +00016910: 2061 2063 6f6d 7075 7465 722d 6e65 7477 a computer-netw │ │ │ │ +00016920: 6f72 6b20 6c6f 6361 7469 6f6e 2066 726f ork location fro │ │ │ │ +00016930: 6d20 7768 6963 6820 7468 6520 6765 6e65 m which the gene │ │ │ │ +00016940: 7261 6c0a 2020 2020 206e 6574 776f 726b ral. network │ │ │ │ +00016950: 2d75 7369 6e67 2070 7562 6c69 6320 6861 -using public ha │ │ │ │ +00016960: 7320 6163 6365 7373 2074 6f20 646f 776e s access to down │ │ │ │ +00016970: 6c6f 6164 2075 7369 6e67 2070 7562 6c69 load using publi │ │ │ │ +00016980: 632d 7374 616e 6461 7264 0a20 2020 2020 c-standard. │ │ │ │ +00016990: 6e65 7477 6f72 6b20 7072 6f74 6f63 6f6c network protocol │ │ │ │ +000169a0: 7320 6120 636f 6d70 6c65 7465 2054 7261 s a complete Tra │ │ │ │ +000169b0: 6e73 7061 7265 6e74 2063 6f70 7920 6f66 nsparent copy of │ │ │ │ +000169c0: 2074 6865 2044 6f63 756d 656e 742c 2066 the Document, f │ │ │ │ +000169d0: 7265 650a 2020 2020 206f 6620 6164 6465 ree. of adde │ │ │ │ +000169e0: 6420 6d61 7465 7269 616c 2e20 2049 6620 d material. If │ │ │ │ +000169f0: 796f 7520 7573 6520 7468 6520 6c61 7474 you use the latt │ │ │ │ +00016a00: 6572 206f 7074 696f 6e2c 2079 6f75 206d er option, you m │ │ │ │ +00016a10: 7573 7420 7461 6b65 0a20 2020 2020 7265 ust take. re │ │ │ │ +00016a20: 6173 6f6e 6162 6c79 2070 7275 6465 6e74 asonably prudent │ │ │ │ +00016a30: 2073 7465 7073 2c20 7768 656e 2079 6f75 steps, when you │ │ │ │ +00016a40: 2062 6567 696e 2064 6973 7472 6962 7574 begin distribut │ │ │ │ +00016a50: 696f 6e20 6f66 204f 7061 7175 650a 2020 ion of Opaque. │ │ │ │ +00016a60: 2020 2063 6f70 6965 7320 696e 2071 7561 copies in qua │ │ │ │ +00016a70: 6e74 6974 792c 2074 6f20 656e 7375 7265 ntity, to ensure │ │ │ │ +00016a80: 2074 6861 7420 7468 6973 2054 7261 6e73 that this Trans │ │ │ │ +00016a90: 7061 7265 6e74 2063 6f70 7920 7769 6c6c parent copy will │ │ │ │ +00016aa0: 0a20 2020 2020 7265 6d61 696e 2074 6875 . remain thu │ │ │ │ +00016ab0: 7320 6163 6365 7373 6962 6c65 2061 7420 s accessible at │ │ │ │ +00016ac0: 7468 6520 7374 6174 6564 206c 6f63 6174 the stated locat │ │ │ │ +00016ad0: 696f 6e20 756e 7469 6c20 6174 206c 6561 ion until at lea │ │ │ │ +00016ae0: 7374 206f 6e65 0a20 2020 2020 7965 6172 st one. year │ │ │ │ +00016af0: 2061 6674 6572 2074 6865 206c 6173 7420 after the last │ │ │ │ +00016b00: 7469 6d65 2079 6f75 2064 6973 7472 6962 time you distrib │ │ │ │ +00016b10: 7574 6520 616e 204f 7061 7175 6520 636f ute an Opaque co │ │ │ │ +00016b20: 7079 2028 6469 7265 6374 6c79 206f 720a py (directly or. │ │ │ │ +00016b30: 2020 2020 2074 6872 6f75 6768 2079 6f75 through you │ │ │ │ +00016b40: 7220 6167 656e 7473 206f 7220 7265 7461 r agents or reta │ │ │ │ +00016b50: 696c 6572 7329 206f 6620 7468 6174 2065 ilers) of that e │ │ │ │ +00016b60: 6469 7469 6f6e 2074 6f20 7468 6520 7075 dition to the pu │ │ │ │ +00016b70: 626c 6963 2e0a 0a20 2020 2020 4974 2069 blic... It i │ │ │ │ +00016b80: 7320 7265 7175 6573 7465 642c 2062 7574 s requested, but │ │ │ │ +00016b90: 206e 6f74 2072 6571 7569 7265 642c 2074 not required, t │ │ │ │ +00016ba0: 6861 7420 796f 7520 636f 6e74 6163 7420 hat you contact │ │ │ │ +00016bb0: 7468 6520 6175 7468 6f72 7320 6f66 0a20 the authors of. │ │ │ │ +00016bc0: 2020 2020 7468 6520 446f 6375 6d65 6e74 the Document │ │ │ │ +00016bd0: 2077 656c 6c20 6265 666f 7265 2072 6564 well before red │ │ │ │ +00016be0: 6973 7472 6962 7574 696e 6720 616e 7920 istributing any │ │ │ │ +00016bf0: 6c61 7267 6520 6e75 6d62 6572 206f 6620 large number of │ │ │ │ +00016c00: 636f 7069 6573 2c0a 2020 2020 2074 6f20 copies,. to │ │ │ │ +00016c10: 6769 7665 2074 6865 6d20 6120 6368 616e give them a chan │ │ │ │ +00016c20: 6365 2074 6f20 7072 6f76 6964 6520 796f ce to provide yo │ │ │ │ +00016c30: 7520 7769 7468 2061 6e20 7570 6461 7465 u with an update │ │ │ │ +00016c40: 6420 7665 7273 696f 6e20 6f66 2074 6865 d version of the │ │ │ │ +00016c50: 0a20 2020 2020 446f 6375 6d65 6e74 2e0a . Document.. │ │ │ │ +00016c60: 0a20 2034 2e20 4d4f 4449 4649 4341 5449 . 4. MODIFICATI │ │ │ │ +00016c70: 4f4e 530a 0a20 2020 2020 596f 7520 6d61 ONS.. You ma │ │ │ │ +00016c80: 7920 636f 7079 2061 6e64 2064 6973 7472 y copy and distr │ │ │ │ +00016c90: 6962 7574 6520 6120 4d6f 6469 6669 6564 ibute a Modified │ │ │ │ +00016ca0: 2056 6572 7369 6f6e 206f 6620 7468 6520 Version of the │ │ │ │ +00016cb0: 446f 6375 6d65 6e74 0a20 2020 2020 756e Document. un │ │ │ │ +00016cc0: 6465 7220 7468 6520 636f 6e64 6974 696f der the conditio │ │ │ │ +00016cd0: 6e73 206f 6620 7365 6374 696f 6e73 2032 ns of sections 2 │ │ │ │ +00016ce0: 2061 6e64 2033 2061 626f 7665 2c20 7072 and 3 above, pr │ │ │ │ +00016cf0: 6f76 6964 6564 2074 6861 7420 796f 750a ovided that you. │ │ │ │ +00016d00: 2020 2020 2072 656c 6561 7365 2074 6865 release the │ │ │ │ +00016d10: 204d 6f64 6966 6965 6420 5665 7273 696f Modified Versio │ │ │ │ +00016d20: 6e20 756e 6465 7220 7072 6563 6973 656c n under precisel │ │ │ │ +00016d30: 7920 7468 6973 204c 6963 656e 7365 2c20 y this License, │ │ │ │ +00016d40: 7769 7468 2074 6865 0a20 2020 2020 4d6f with the. Mo │ │ │ │ +00016d50: 6469 6669 6564 2056 6572 7369 6f6e 2066 dified Version f │ │ │ │ +00016d60: 696c 6c69 6e67 2074 6865 2072 6f6c 6520 illing the role │ │ │ │ +00016d70: 6f66 2074 6865 2044 6f63 756d 656e 742c of the Document, │ │ │ │ +00016d80: 2074 6875 7320 6c69 6365 6e73 696e 670a thus licensing. │ │ │ │ +00016d90: 2020 2020 2064 6973 7472 6962 7574 696f distributio │ │ │ │ +00016da0: 6e20 616e 6420 6d6f 6469 6669 6361 7469 n and modificati │ │ │ │ +00016db0: 6f6e 206f 6620 7468 6520 4d6f 6469 6669 on of the Modifi │ │ │ │ +00016dc0: 6564 2056 6572 7369 6f6e 2074 6f20 7768 ed Version to wh │ │ │ │ +00016dd0: 6f65 7665 720a 2020 2020 2070 6f73 7365 oever. posse │ │ │ │ +00016de0: 7373 6573 2061 2063 6f70 7920 6f66 2069 sses a copy of i │ │ │ │ +00016df0: 742e 2020 496e 2061 6464 6974 696f 6e2c t. In addition, │ │ │ │ +00016e00: 2079 6f75 206d 7573 7420 646f 2074 6865 you must do the │ │ │ │ +00016e10: 7365 2074 6869 6e67 7320 696e 0a20 2020 se things in. │ │ │ │ +00016e20: 2020 7468 6520 4d6f 6469 6669 6564 2056 the Modified V │ │ │ │ +00016e30: 6572 7369 6f6e 3a0a 0a20 2020 2020 2020 ersion:.. │ │ │ │ +00016e40: 412e 2055 7365 2069 6e20 7468 6520 5469 A. Use in the Ti │ │ │ │ +00016e50: 746c 6520 5061 6765 2028 616e 6420 6f6e tle Page (and on │ │ │ │ +00016e60: 2074 6865 2063 6f76 6572 732c 2069 6620 the covers, if │ │ │ │ +00016e70: 616e 7929 2061 2074 6974 6c65 0a20 2020 any) a title. │ │ │ │ +00016e80: 2020 2020 2020 2064 6973 7469 6e63 7420 distinct │ │ │ │ +00016e90: 6672 6f6d 2074 6861 7420 6f66 2074 6865 from that of the │ │ │ │ +00016ea0: 2044 6f63 756d 656e 742c 2061 6e64 2066 Document, and f │ │ │ │ +00016eb0: 726f 6d20 7468 6f73 6520 6f66 2070 7265 rom those of pre │ │ │ │ +00016ec0: 7669 6f75 730a 2020 2020 2020 2020 2020 vious. │ │ │ │ +00016ed0: 7665 7273 696f 6e73 2028 7768 6963 6820 versions (which │ │ │ │ +00016ee0: 7368 6f75 6c64 2c20 6966 2074 6865 7265 should, if there │ │ │ │ +00016ef0: 2077 6572 6520 616e 792c 2062 6520 6c69 were any, be li │ │ │ │ +00016f00: 7374 6564 2069 6e20 7468 650a 2020 2020 sted in the. │ │ │ │ +00016f10: 2020 2020 2020 4869 7374 6f72 7920 7365 History se │ │ │ │ +00016f20: 6374 696f 6e20 6f66 2074 6865 2044 6f63 ction of the Doc │ │ │ │ +00016f30: 756d 656e 7429 2e20 2059 6f75 206d 6179 ument). You may │ │ │ │ +00016f40: 2075 7365 2074 6865 2073 616d 6520 7469 use the same ti │ │ │ │ +00016f50: 746c 650a 2020 2020 2020 2020 2020 6173 tle. as │ │ │ │ +00016f60: 2061 2070 7265 7669 6f75 7320 7665 7273 a previous vers │ │ │ │ +00016f70: 696f 6e20 6966 2074 6865 206f 7269 6769 ion if the origi │ │ │ │ +00016f80: 6e61 6c20 7075 626c 6973 6865 7220 6f66 nal publisher of │ │ │ │ +00016f90: 2074 6861 740a 2020 2020 2020 2020 2020 that. │ │ │ │ +00016fa0: 7665 7273 696f 6e20 6769 7665 7320 7065 version gives pe │ │ │ │ +00016fb0: 726d 6973 7369 6f6e 2e0a 0a20 2020 2020 rmission... │ │ │ │ +00016fc0: 2020 422e 204c 6973 7420 6f6e 2074 6865 B. List on the │ │ │ │ +00016fd0: 2054 6974 6c65 2050 6167 652c 2061 7320 Title Page, as │ │ │ │ +00016fe0: 6175 7468 6f72 732c 206f 6e65 206f 7220 authors, one or │ │ │ │ +00016ff0: 6d6f 7265 2070 6572 736f 6e73 206f 720a more persons or. │ │ │ │ +00017000: 2020 2020 2020 2020 2020 656e 7469 7469 entiti │ │ │ │ +00017010: 6573 2072 6573 706f 6e73 6962 6c65 2066 es responsible f │ │ │ │ +00017020: 6f72 2061 7574 686f 7273 6869 7020 6f66 or authorship of │ │ │ │ +00017030: 2074 6865 206d 6f64 6966 6963 6174 696f the modificatio │ │ │ │ +00017040: 6e73 2069 6e0a 2020 2020 2020 2020 2020 ns in. │ │ │ │ +00017050: 7468 6520 4d6f 6469 6669 6564 2056 6572 the Modified Ver │ │ │ │ +00017060: 7369 6f6e 2c20 746f 6765 7468 6572 2077 sion, together w │ │ │ │ +00017070: 6974 6820 6174 206c 6561 7374 2066 6976 ith at least fiv │ │ │ │ +00017080: 6520 6f66 2074 6865 0a20 2020 2020 2020 e of the. │ │ │ │ +00017090: 2020 2070 7269 6e63 6970 616c 2061 7574 principal aut │ │ │ │ +000170a0: 686f 7273 206f 6620 7468 6520 446f 6375 hors of the Docu │ │ │ │ +000170b0: 6d65 6e74 2028 616c 6c20 6f66 2069 7473 ment (all of its │ │ │ │ +000170c0: 2070 7269 6e63 6970 616c 0a20 2020 2020 principal. │ │ │ │ +000170d0: 2020 2020 2061 7574 686f 7273 2c20 6966 authors, if │ │ │ │ +000170e0: 2069 7420 6861 7320 6665 7765 7220 7468 it has fewer th │ │ │ │ +000170f0: 616e 2066 6976 6529 2c20 756e 6c65 7373 an five), unless │ │ │ │ +00017100: 2074 6865 7920 7265 6c65 6173 6520 796f they release yo │ │ │ │ +00017110: 750a 2020 2020 2020 2020 2020 6672 6f6d u. from │ │ │ │ +00017120: 2074 6869 7320 7265 7175 6972 656d 656e this requiremen │ │ │ │ +00017130: 742e 0a0a 2020 2020 2020 2043 2e20 5374 t... C. St │ │ │ │ +00017140: 6174 6520 6f6e 2074 6865 2054 6974 6c65 ate on the Title │ │ │ │ +00017150: 2070 6167 6520 7468 6520 6e61 6d65 206f page the name o │ │ │ │ +00017160: 6620 7468 6520 7075 626c 6973 6865 7220 f the publisher │ │ │ │ +00017170: 6f66 2074 6865 0a20 2020 2020 2020 2020 of the. │ │ │ │ +00017180: 204d 6f64 6966 6965 6420 5665 7273 696f Modified Versio │ │ │ │ +00017190: 6e2c 2061 7320 7468 6520 7075 626c 6973 n, as the publis │ │ │ │ +000171a0: 6865 722e 0a0a 2020 2020 2020 2044 2e20 her... D. │ │ │ │ +000171b0: 5072 6573 6572 7665 2061 6c6c 2074 6865 Preserve all the │ │ │ │ +000171c0: 2063 6f70 7972 6967 6874 206e 6f74 6963 copyright notic │ │ │ │ +000171d0: 6573 206f 6620 7468 6520 446f 6375 6d65 es of the Docume │ │ │ │ +000171e0: 6e74 2e0a 0a20 2020 2020 2020 452e 2041 nt... E. A │ │ │ │ +000171f0: 6464 2061 6e20 6170 7072 6f70 7269 6174 dd an appropriat │ │ │ │ +00017200: 6520 636f 7079 7269 6768 7420 6e6f 7469 e copyright noti │ │ │ │ +00017210: 6365 2066 6f72 2079 6f75 7220 6d6f 6469 ce for your modi │ │ │ │ +00017220: 6669 6361 7469 6f6e 730a 2020 2020 2020 fications. │ │ │ │ +00017230: 2020 2020 6164 6a61 6365 6e74 2074 6f20 adjacent to │ │ │ │ +00017240: 7468 6520 6f74 6865 7220 636f 7079 7269 the other copyri │ │ │ │ +00017250: 6768 7420 6e6f 7469 6365 732e 0a0a 2020 ght notices... │ │ │ │ +00017260: 2020 2020 2046 2e20 496e 636c 7564 652c F. Include, │ │ │ │ +00017270: 2069 6d6d 6564 6961 7465 6c79 2061 6674 immediately aft │ │ │ │ +00017280: 6572 2074 6865 2063 6f70 7972 6967 6874 er the copyright │ │ │ │ +00017290: 206e 6f74 6963 6573 2c20 6120 6c69 6365 notices, a lice │ │ │ │ +000172a0: 6e73 650a 2020 2020 2020 2020 2020 6e6f nse. no │ │ │ │ +000172b0: 7469 6365 2067 6976 696e 6720 7468 6520 tice giving the │ │ │ │ +000172c0: 7075 626c 6963 2070 6572 6d69 7373 696f public permissio │ │ │ │ +000172d0: 6e20 746f 2075 7365 2074 6865 204d 6f64 n to use the Mod │ │ │ │ +000172e0: 6966 6965 640a 2020 2020 2020 2020 2020 ified. │ │ │ │ +000172f0: 5665 7273 696f 6e20 756e 6465 7220 7468 Version under th │ │ │ │ +00017300: 6520 7465 726d 7320 6f66 2074 6869 7320 e terms of this │ │ │ │ +00017310: 4c69 6365 6e73 652c 2069 6e20 7468 6520 License, in the │ │ │ │ +00017320: 666f 726d 2073 686f 776e 2069 6e0a 2020 form shown in. │ │ │ │ +00017330: 2020 2020 2020 2020 7468 6520 4164 6465 the Adde │ │ │ │ +00017340: 6e64 756d 2062 656c 6f77 2e0a 0a20 2020 ndum below... │ │ │ │ +00017350: 2020 2020 472e 2050 7265 7365 7276 6520 G. Preserve │ │ │ │ +00017360: 696e 2074 6861 7420 6c69 6365 6e73 6520 in that license │ │ │ │ +00017370: 6e6f 7469 6365 2074 6865 2066 756c 6c20 notice the full │ │ │ │ +00017380: 6c69 7374 7320 6f66 2049 6e76 6172 6961 lists of Invaria │ │ │ │ +00017390: 6e74 0a20 2020 2020 2020 2020 2053 6563 nt. Sec │ │ │ │ +000173a0: 7469 6f6e 7320 616e 6420 7265 7175 6972 tions and requir │ │ │ │ +000173b0: 6564 2043 6f76 6572 2054 6578 7473 2067 ed Cover Texts g │ │ │ │ +000173c0: 6976 656e 2069 6e20 7468 6520 446f 6375 iven in the Docu │ │ │ │ +000173d0: 6d65 6e74 2773 0a20 2020 2020 2020 2020 ment's. │ │ │ │ +000173e0: 206c 6963 656e 7365 206e 6f74 6963 652e license notice. │ │ │ │ +000173f0: 0a0a 2020 2020 2020 2048 2e20 496e 636c .. H. Incl │ │ │ │ +00017400: 7564 6520 616e 2075 6e61 6c74 6572 6564 ude an unaltered │ │ │ │ +00017410: 2063 6f70 7920 6f66 2074 6869 7320 4c69 copy of this Li │ │ │ │ +00017420: 6365 6e73 652e 0a0a 2020 2020 2020 2049 cense... I │ │ │ │ +00017430: 2e20 5072 6573 6572 7665 2074 6865 2073 . Preserve the s │ │ │ │ +00017440: 6563 7469 6f6e 2045 6e74 6974 6c65 6420 ection Entitled │ │ │ │ +00017450: 2248 6973 746f 7279 222c 2050 7265 7365 "History", Prese │ │ │ │ +00017460: 7276 6520 6974 7320 5469 746c 652c 0a20 rve its Title,. │ │ │ │ +00017470: 2020 2020 2020 2020 2061 6e64 2061 6464 and add │ │ │ │ +00017480: 2074 6f20 6974 2061 6e20 6974 656d 2073 to it an item s │ │ │ │ +00017490: 7461 7469 6e67 2061 7420 6c65 6173 7420 tating at least │ │ │ │ +000174a0: 7468 6520 7469 746c 652c 2079 6561 722c the title, year, │ │ │ │ +000174b0: 206e 6577 0a20 2020 2020 2020 2020 2061 new. a │ │ │ │ +000174c0: 7574 686f 7273 2c20 616e 6420 7075 626c uthors, and publ │ │ │ │ +000174d0: 6973 6865 7220 6f66 2074 6865 204d 6f64 isher of the Mod │ │ │ │ +000174e0: 6966 6965 6420 5665 7273 696f 6e20 6173 ified Version as │ │ │ │ +000174f0: 2067 6976 656e 206f 6e20 7468 650a 2020 given on the. │ │ │ │ +00017500: 2020 2020 2020 2020 5469 746c 6520 5061 Title Pa │ │ │ │ +00017510: 6765 2e20 2049 6620 7468 6572 6520 6973 ge. If there is │ │ │ │ +00017520: 206e 6f20 7365 6374 696f 6e20 456e 7469 no section Enti │ │ │ │ +00017530: 746c 6564 2022 4869 7374 6f72 7922 2069 tled "History" i │ │ │ │ +00017540: 6e20 7468 650a 2020 2020 2020 2020 2020 n the. │ │ │ │ +00017550: 446f 6375 6d65 6e74 2c20 6372 6561 7465 Document, create │ │ │ │ +00017560: 206f 6e65 2073 7461 7469 6e67 2074 6865 one stating the │ │ │ │ +00017570: 2074 6974 6c65 2c20 7965 6172 2c20 6175 title, year, au │ │ │ │ +00017580: 7468 6f72 732c 2061 6e64 0a20 2020 2020 thors, and. │ │ │ │ +00017590: 2020 2020 2070 7562 6c69 7368 6572 206f publisher o │ │ │ │ +000175a0: 6620 7468 6520 446f 6375 6d65 6e74 2061 f the Document a │ │ │ │ +000175b0: 7320 6769 7665 6e20 6f6e 2069 7473 2054 s given on its T │ │ │ │ +000175c0: 6974 6c65 2050 6167 652c 2074 6865 6e20 itle Page, then │ │ │ │ +000175d0: 6164 640a 2020 2020 2020 2020 2020 616e add. an │ │ │ │ +000175e0: 2069 7465 6d20 6465 7363 7269 6269 6e67 item describing │ │ │ │ +000175f0: 2074 6865 204d 6f64 6966 6965 6420 5665 the Modified Ve │ │ │ │ +00017600: 7273 696f 6e20 6173 2073 7461 7465 6420 rsion as stated │ │ │ │ +00017610: 696e 2074 6865 0a20 2020 2020 2020 2020 in the. │ │ │ │ +00017620: 2070 7265 7669 6f75 7320 7365 6e74 656e previous senten │ │ │ │ +00017630: 6365 2e0a 0a20 2020 2020 2020 4a2e 2050 ce... J. P │ │ │ │ +00017640: 7265 7365 7276 6520 7468 6520 6e65 7477 reserve the netw │ │ │ │ +00017650: 6f72 6b20 6c6f 6361 7469 6f6e 2c20 6966 ork location, if │ │ │ │ +00017660: 2061 6e79 2c20 6769 7665 6e20 696e 2074 any, given in t │ │ │ │ +00017670: 6865 2044 6f63 756d 656e 740a 2020 2020 he Document. │ │ │ │ +00017680: 2020 2020 2020 666f 7220 7075 626c 6963 for public │ │ │ │ +00017690: 2061 6363 6573 7320 746f 2061 2054 7261 access to a Tra │ │ │ │ +000176a0: 6e73 7061 7265 6e74 2063 6f70 7920 6f66 nsparent copy of │ │ │ │ +000176b0: 2074 6865 2044 6f63 756d 656e 742c 2061 the Document, a │ │ │ │ +000176c0: 6e64 0a20 2020 2020 2020 2020 206c 696b nd. lik │ │ │ │ +000176d0: 6577 6973 6520 7468 6520 6e65 7477 6f72 ewise the networ │ │ │ │ +000176e0: 6b20 6c6f 6361 7469 6f6e 7320 6769 7665 k locations give │ │ │ │ +000176f0: 6e20 696e 2074 6865 2044 6f63 756d 656e n in the Documen │ │ │ │ +00017700: 7420 666f 720a 2020 2020 2020 2020 2020 t for. │ │ │ │ +00017710: 7072 6576 696f 7573 2076 6572 7369 6f6e previous version │ │ │ │ +00017720: 7320 6974 2077 6173 2062 6173 6564 206f s it was based o │ │ │ │ +00017730: 6e2e 2020 5468 6573 6520 6d61 7920 6265 n. These may be │ │ │ │ +00017740: 2070 6c61 6365 6420 696e 2074 6865 0a20 placed in the. │ │ │ │ +00017750: 2020 2020 2020 2020 2022 4869 7374 6f72 "Histor │ │ │ │ +00017760: 7922 2073 6563 7469 6f6e 2e20 2059 6f75 y" section. You │ │ │ │ +00017770: 206d 6179 206f 6d69 7420 6120 6e65 7477 may omit a netw │ │ │ │ +00017780: 6f72 6b20 6c6f 6361 7469 6f6e 2066 6f72 ork location for │ │ │ │ +00017790: 2061 2077 6f72 6b0a 2020 2020 2020 2020 a work. │ │ │ │ +000177a0: 2020 7468 6174 2077 6173 2070 7562 6c69 that was publi │ │ │ │ +000177b0: 7368 6564 2061 7420 6c65 6173 7420 666f shed at least fo │ │ │ │ +000177c0: 7572 2079 6561 7273 2062 6566 6f72 6520 ur years before │ │ │ │ +000177d0: 7468 6520 446f 6375 6d65 6e74 0a20 2020 the Document. │ │ │ │ +000177e0: 2020 2020 2020 2069 7473 656c 662c 206f itself, o │ │ │ │ +000177f0: 7220 6966 2074 6865 206f 7269 6769 6e61 r if the origina │ │ │ │ +00017800: 6c20 7075 626c 6973 6865 7220 6f66 2074 l publisher of t │ │ │ │ +00017810: 6865 2076 6572 7369 6f6e 2069 7420 7265 he version it re │ │ │ │ +00017820: 6665 7273 0a20 2020 2020 2020 2020 2074 fers. t │ │ │ │ +00017830: 6f20 6769 7665 7320 7065 726d 6973 7369 o gives permissi │ │ │ │ +00017840: 6f6e 2e0a 0a20 2020 2020 2020 4b2e 2046 on... K. F │ │ │ │ +00017850: 6f72 2061 6e79 2073 6563 7469 6f6e 2045 or any section E │ │ │ │ +00017860: 6e74 6974 6c65 6420 2241 636b 6e6f 776c ntitled "Acknowl │ │ │ │ +00017870: 6564 6765 6d65 6e74 7322 206f 7220 2244 edgements" or "D │ │ │ │ +00017880: 6564 6963 6174 696f 6e73 222c 0a20 2020 edications",. │ │ │ │ +00017890: 2020 2020 2020 2050 7265 7365 7276 6520 Preserve │ │ │ │ +000178a0: 7468 6520 5469 746c 6520 6f66 2074 6865 the Title of the │ │ │ │ +000178b0: 2073 6563 7469 6f6e 2c20 616e 6420 7072 section, and pr │ │ │ │ +000178c0: 6573 6572 7665 2069 6e20 7468 6520 7365 eserve in the se │ │ │ │ +000178d0: 6374 696f 6e0a 2020 2020 2020 2020 2020 ction. │ │ │ │ +000178e0: 616c 6c20 7468 6520 7375 6273 7461 6e63 all the substanc │ │ │ │ +000178f0: 6520 616e 6420 746f 6e65 206f 6620 6561 e and tone of ea │ │ │ │ +00017900: 6368 206f 6620 7468 6520 636f 6e74 7269 ch of the contri │ │ │ │ +00017910: 6275 746f 720a 2020 2020 2020 2020 2020 butor. │ │ │ │ +00017920: 6163 6b6e 6f77 6c65 6467 656d 656e 7473 acknowledgements │ │ │ │ +00017930: 2061 6e64 2f6f 7220 6465 6469 6361 7469 and/or dedicati │ │ │ │ +00017940: 6f6e 7320 6769 7665 6e20 7468 6572 6569 ons given therei │ │ │ │ +00017950: 6e2e 0a0a 2020 2020 2020 204c 2e20 5072 n... L. Pr │ │ │ │ +00017960: 6573 6572 7665 2061 6c6c 2074 6865 2049 eserve all the I │ │ │ │ +00017970: 6e76 6172 6961 6e74 2053 6563 7469 6f6e nvariant Section │ │ │ │ +00017980: 7320 6f66 2074 6865 2044 6f63 756d 656e s of the Documen │ │ │ │ +00017990: 742c 2075 6e61 6c74 6572 6564 0a20 2020 t, unaltered. │ │ │ │ +000179a0: 2020 2020 2020 2069 6e20 7468 6569 7220 in their │ │ │ │ +000179b0: 7465 7874 2061 6e64 2069 6e20 7468 6569 text and in thei │ │ │ │ +000179c0: 7220 7469 746c 6573 2e20 2053 6563 7469 r titles. Secti │ │ │ │ +000179d0: 6f6e 206e 756d 6265 7273 206f 7220 7468 on numbers or th │ │ │ │ +000179e0: 650a 2020 2020 2020 2020 2020 6571 7569 e. equi │ │ │ │ +000179f0: 7661 6c65 6e74 2061 7265 206e 6f74 2063 valent are not c │ │ │ │ +00017a00: 6f6e 7369 6465 7265 6420 7061 7274 206f onsidered part o │ │ │ │ +00017a10: 6620 7468 6520 7365 6374 696f 6e20 7469 f the section ti │ │ │ │ +00017a20: 746c 6573 2e0a 0a20 2020 2020 2020 4d2e tles... M. │ │ │ │ +00017a30: 2044 656c 6574 6520 616e 7920 7365 6374 Delete any sect │ │ │ │ +00017a40: 696f 6e20 456e 7469 746c 6564 2022 456e ion Entitled "En │ │ │ │ +00017a50: 646f 7273 656d 656e 7473 222e 2020 5375 dorsements". Su │ │ │ │ +00017a60: 6368 2061 2073 6563 7469 6f6e 0a20 2020 ch a section. │ │ │ │ +00017a70: 2020 2020 2020 206d 6179 206e 6f74 2062 may not b │ │ │ │ +00017a80: 6520 696e 636c 7564 6564 2069 6e20 7468 e included in th │ │ │ │ +00017a90: 6520 4d6f 6469 6669 6564 2056 6572 7369 e Modified Versi │ │ │ │ +00017aa0: 6f6e 2e0a 0a20 2020 2020 2020 4e2e 2044 on... N. D │ │ │ │ +00017ab0: 6f20 6e6f 7420 7265 7469 746c 6520 616e o not retitle an │ │ │ │ +00017ac0: 7920 6578 6973 7469 6e67 2073 6563 7469 y existing secti │ │ │ │ +00017ad0: 6f6e 2074 6f20 6265 2045 6e74 6974 6c65 on to be Entitle │ │ │ │ +00017ae0: 640a 2020 2020 2020 2020 2020 2245 6e64 d. "End │ │ │ │ +00017af0: 6f72 7365 6d65 6e74 7322 206f 7220 746f orsements" or to │ │ │ │ +00017b00: 2063 6f6e 666c 6963 7420 696e 2074 6974 conflict in tit │ │ │ │ +00017b10: 6c65 2077 6974 6820 616e 7920 496e 7661 le with any Inva │ │ │ │ +00017b20: 7269 616e 740a 2020 2020 2020 2020 2020 riant. │ │ │ │ +00017b30: 5365 6374 696f 6e2e 0a0a 2020 2020 2020 Section... │ │ │ │ +00017b40: 204f 2e20 5072 6573 6572 7665 2061 6e79 O. Preserve any │ │ │ │ +00017b50: 2057 6172 7261 6e74 7920 4469 7363 6c61 Warranty Discla │ │ │ │ +00017b60: 696d 6572 732e 0a0a 2020 2020 2049 6620 imers... If │ │ │ │ +00017b70: 7468 6520 4d6f 6469 6669 6564 2056 6572 the Modified Ver │ │ │ │ +00017b80: 7369 6f6e 2069 6e63 6c75 6465 7320 6e65 sion includes ne │ │ │ │ +00017b90: 7720 6672 6f6e 742d 6d61 7474 6572 2073 w front-matter s │ │ │ │ +00017ba0: 6563 7469 6f6e 7320 6f72 0a20 2020 2020 ections or. │ │ │ │ +00017bb0: 6170 7065 6e64 6963 6573 2074 6861 7420 appendices that │ │ │ │ +00017bc0: 7175 616c 6966 7920 6173 2053 6563 6f6e qualify as Secon │ │ │ │ +00017bd0: 6461 7279 2053 6563 7469 6f6e 7320 616e dary Sections an │ │ │ │ +00017be0: 6420 636f 6e74 6169 6e20 6e6f 0a20 2020 d contain no. │ │ │ │ +00017bf0: 2020 6d61 7465 7269 616c 2063 6f70 6965 material copie │ │ │ │ +00017c00: 6420 6672 6f6d 2074 6865 2044 6f63 756d d from the Docum │ │ │ │ +00017c10: 656e 742c 2079 6f75 206d 6179 2061 7420 ent, you may at │ │ │ │ +00017c20: 796f 7572 206f 7074 696f 6e20 6465 7369 your option desi │ │ │ │ +00017c30: 676e 6174 650a 2020 2020 2073 6f6d 6520 gnate. some │ │ │ │ +00017c40: 6f72 2061 6c6c 206f 6620 7468 6573 6520 or all of these │ │ │ │ +00017c50: 7365 6374 696f 6e73 2061 7320 696e 7661 sections as inva │ │ │ │ +00017c60: 7269 616e 742e 2020 546f 2064 6f20 7468 riant. To do th │ │ │ │ +00017c70: 6973 2c20 6164 6420 7468 6569 720a 2020 is, add their. │ │ │ │ +00017c80: 2020 2074 6974 6c65 7320 746f 2074 6865 titles to the │ │ │ │ +00017c90: 206c 6973 7420 6f66 2049 6e76 6172 6961 list of Invaria │ │ │ │ +00017ca0: 6e74 2053 6563 7469 6f6e 7320 696e 2074 nt Sections in t │ │ │ │ +00017cb0: 6865 204d 6f64 6966 6965 6420 5665 7273 he Modified Vers │ │ │ │ +00017cc0: 696f 6e27 730a 2020 2020 206c 6963 656e ion's. licen │ │ │ │ +00017cd0: 7365 206e 6f74 6963 652e 2020 5468 6573 se notice. Thes │ │ │ │ +00017ce0: 6520 7469 746c 6573 206d 7573 7420 6265 e titles must be │ │ │ │ +00017cf0: 2064 6973 7469 6e63 7420 6672 6f6d 2061 distinct from a │ │ │ │ +00017d00: 6e79 206f 7468 6572 0a20 2020 2020 7365 ny other. se │ │ │ │ +00017d10: 6374 696f 6e20 7469 746c 6573 2e0a 0a20 ction titles... │ │ │ │ +00017d20: 2020 2020 596f 7520 6d61 7920 6164 6420 You may add │ │ │ │ +00017d30: 6120 7365 6374 696f 6e20 456e 7469 746c a section Entitl │ │ │ │ +00017d40: 6564 2022 456e 646f 7273 656d 656e 7473 ed "Endorsements │ │ │ │ +00017d50: 222c 2070 726f 7669 6465 6420 6974 2063 ", provided it c │ │ │ │ +00017d60: 6f6e 7461 696e 730a 2020 2020 206e 6f74 ontains. not │ │ │ │ +00017d70: 6869 6e67 2062 7574 2065 6e64 6f72 7365 hing but endorse │ │ │ │ +00017d80: 6d65 6e74 7320 6f66 2079 6f75 7220 4d6f ments of your Mo │ │ │ │ +00017d90: 6469 6669 6564 2056 6572 7369 6f6e 2062 dified Version b │ │ │ │ +00017da0: 7920 7661 7269 6f75 730a 2020 2020 2070 y various. p │ │ │ │ +00017db0: 6172 7469 6573 2d2d 666f 7220 6578 616d arties--for exam │ │ │ │ +00017dc0: 706c 652c 2073 7461 7465 6d65 6e74 7320 ple, statements │ │ │ │ +00017dd0: 6f66 2070 6565 7220 7265 7669 6577 206f of peer review o │ │ │ │ +00017de0: 7220 7468 6174 2074 6865 2074 6578 740a r that the text. │ │ │ │ +00017df0: 2020 2020 2068 6173 2062 6565 6e20 6170 has been ap │ │ │ │ +00017e00: 7072 6f76 6564 2062 7920 616e 206f 7267 proved by an org │ │ │ │ +00017e10: 616e 697a 6174 696f 6e20 6173 2074 6865 anization as the │ │ │ │ +00017e20: 2061 7574 686f 7269 7461 7469 7665 0a20 authoritative. │ │ │ │ +00017e30: 2020 2020 6465 6669 6e69 7469 6f6e 206f definition o │ │ │ │ +00017e40: 6620 6120 7374 616e 6461 7264 2e0a 0a20 f a standard... │ │ │ │ +00017e50: 2020 2020 596f 7520 6d61 7920 6164 6420 You may add │ │ │ │ +00017e60: 6120 7061 7373 6167 6520 6f66 2075 7020 a passage of up │ │ │ │ +00017e70: 746f 2066 6976 6520 776f 7264 7320 6173 to five words as │ │ │ │ +00017e80: 2061 2046 726f 6e74 2d43 6f76 6572 2054 a Front-Cover T │ │ │ │ +00017e90: 6578 742c 0a20 2020 2020 616e 6420 6120 ext,. and a │ │ │ │ +00017ea0: 7061 7373 6167 6520 6f66 2075 7020 746f passage of up to │ │ │ │ +00017eb0: 2032 3520 776f 7264 7320 6173 2061 2042 25 words as a B │ │ │ │ +00017ec0: 6163 6b2d 436f 7665 7220 5465 7874 2c20 ack-Cover Text, │ │ │ │ +00017ed0: 746f 2074 6865 2065 6e64 206f 660a 2020 to the end of. │ │ │ │ +00017ee0: 2020 2074 6865 206c 6973 7420 6f66 2043 the list of C │ │ │ │ +00017ef0: 6f76 6572 2054 6578 7473 2069 6e20 7468 over Texts in th │ │ │ │ +00017f00: 6520 4d6f 6469 6669 6564 2056 6572 7369 e Modified Versi │ │ │ │ +00017f10: 6f6e 2e20 204f 6e6c 7920 6f6e 6520 7061 on. Only one pa │ │ │ │ +00017f20: 7373 6167 650a 2020 2020 206f 6620 4672 ssage. of Fr │ │ │ │ +00017f30: 6f6e 742d 436f 7665 7220 5465 7874 2061 ont-Cover Text a │ │ │ │ +00017f40: 6e64 206f 6e65 206f 6620 4261 636b 2d43 nd one of Back-C │ │ │ │ +00017f50: 6f76 6572 2054 6578 7420 6d61 7920 6265 over Text may be │ │ │ │ +00017f60: 2061 6464 6564 2062 7920 286f 720a 2020 added by (or. │ │ │ │ +00017f70: 2020 2074 6872 6f75 6768 2061 7272 616e through arran │ │ │ │ +00017f80: 6765 6d65 6e74 7320 6d61 6465 2062 7929 gements made by) │ │ │ │ +00017f90: 2061 6e79 206f 6e65 2065 6e74 6974 792e any one entity. │ │ │ │ +00017fa0: 2020 4966 2074 6865 2044 6f63 756d 656e If the Documen │ │ │ │ +00017fb0: 740a 2020 2020 2061 6c72 6561 6479 2069 t. already i │ │ │ │ +00017fc0: 6e63 6c75 6465 7320 6120 636f 7665 7220 ncludes a cover │ │ │ │ +00017fd0: 7465 7874 2066 6f72 2074 6865 2073 616d text for the sam │ │ │ │ +00017fe0: 6520 636f 7665 722c 2070 7265 7669 6f75 e cover, previou │ │ │ │ +00017ff0: 736c 7920 6164 6465 640a 2020 2020 2062 sly added. b │ │ │ │ +00018000: 7920 796f 7520 6f72 2062 7920 6172 7261 y you or by arra │ │ │ │ +00018010: 6e67 656d 656e 7420 6d61 6465 2062 7920 ngement made by │ │ │ │ +00018020: 7468 6520 7361 6d65 2065 6e74 6974 7920 the same entity │ │ │ │ +00018030: 796f 7520 6172 6520 6163 7469 6e67 206f you are acting o │ │ │ │ +00018040: 6e0a 2020 2020 2062 6568 616c 6620 6f66 n. behalf of │ │ │ │ +00018050: 2c20 796f 7520 6d61 7920 6e6f 7420 6164 , you may not ad │ │ │ │ +00018060: 6420 616e 6f74 6865 723b 2062 7574 2079 d another; but y │ │ │ │ +00018070: 6f75 206d 6179 2072 6570 6c61 6365 2074 ou may replace t │ │ │ │ +00018080: 6865 206f 6c64 0a20 2020 2020 6f6e 652c he old. one, │ │ │ │ +00018090: 206f 6e20 6578 706c 6963 6974 2070 6572 on explicit per │ │ │ │ +000180a0: 6d69 7373 696f 6e20 6672 6f6d 2074 6865 mission from the │ │ │ │ +000180b0: 2070 7265 7669 6f75 7320 7075 626c 6973 previous publis │ │ │ │ +000180c0: 6865 7220 7468 6174 2061 6464 6564 0a20 her that added. │ │ │ │ +000180d0: 2020 2020 7468 6520 6f6c 6420 6f6e 652e the old one. │ │ │ │ +000180e0: 0a0a 2020 2020 2054 6865 2061 7574 686f .. The autho │ │ │ │ +000180f0: 7228 7329 2061 6e64 2070 7562 6c69 7368 r(s) and publish │ │ │ │ +00018100: 6572 2873 2920 6f66 2074 6865 2044 6f63 er(s) of the Doc │ │ │ │ +00018110: 756d 656e 7420 646f 206e 6f74 2062 7920 ument do not by │ │ │ │ +00018120: 7468 6973 0a20 2020 2020 4c69 6365 6e73 this. Licens │ │ │ │ +00018130: 6520 6769 7665 2070 6572 6d69 7373 696f e give permissio │ │ │ │ +00018140: 6e20 746f 2075 7365 2074 6865 6972 206e n to use their n │ │ │ │ +00018150: 616d 6573 2066 6f72 2070 7562 6c69 6369 ames for publici │ │ │ │ +00018160: 7479 2066 6f72 206f 7220 746f 0a20 2020 ty for or to. │ │ │ │ +00018170: 2020 6173 7365 7274 206f 7220 696d 706c assert or impl │ │ │ │ +00018180: 7920 656e 646f 7273 656d 656e 7420 6f66 y endorsement of │ │ │ │ +00018190: 2061 6e79 204d 6f64 6966 6965 6420 5665 any Modified Ve │ │ │ │ +000181a0: 7273 696f 6e2e 0a0a 2020 352e 2043 4f4d rsion... 5. COM │ │ │ │ +000181b0: 4249 4e49 4e47 2044 4f43 554d 454e 5453 BINING DOCUMENTS │ │ │ │ +000181c0: 0a0a 2020 2020 2059 6f75 206d 6179 2063 .. You may c │ │ │ │ +000181d0: 6f6d 6269 6e65 2074 6865 2044 6f63 756d ombine the Docum │ │ │ │ +000181e0: 656e 7420 7769 7468 206f 7468 6572 2064 ent with other d │ │ │ │ +000181f0: 6f63 756d 656e 7473 2072 656c 6561 7365 ocuments release │ │ │ │ +00018200: 6420 756e 6465 720a 2020 2020 2074 6869 d under. thi │ │ │ │ +00018210: 7320 4c69 6365 6e73 652c 2075 6e64 6572 s License, under │ │ │ │ +00018220: 2074 6865 2074 6572 6d73 2064 6566 696e the terms defin │ │ │ │ +00018230: 6564 2069 6e20 7365 6374 696f 6e20 3420 ed in section 4 │ │ │ │ +00018240: 6162 6f76 6520 666f 720a 2020 2020 206d above for. m │ │ │ │ +00018250: 6f64 6966 6965 6420 7665 7273 696f 6e73 odified versions │ │ │ │ +00018260: 2c20 7072 6f76 6964 6564 2074 6861 7420 , provided that │ │ │ │ +00018270: 796f 7520 696e 636c 7564 6520 696e 2074 you include in t │ │ │ │ +00018280: 6865 2063 6f6d 6269 6e61 7469 6f6e 2061 he combination a │ │ │ │ +00018290: 6c6c 0a20 2020 2020 6f66 2074 6865 2049 ll. of the I │ │ │ │ +000182a0: 6e76 6172 6961 6e74 2053 6563 7469 6f6e nvariant Section │ │ │ │ +000182b0: 7320 6f66 2061 6c6c 206f 6620 7468 6520 s of all of the │ │ │ │ +000182c0: 6f72 6967 696e 616c 2064 6f63 756d 656e original documen │ │ │ │ +000182d0: 7473 2c0a 2020 2020 2075 6e6d 6f64 6966 ts,. unmodif │ │ │ │ +000182e0: 6965 642c 2061 6e64 206c 6973 7420 7468 ied, and list th │ │ │ │ +000182f0: 656d 2061 6c6c 2061 7320 496e 7661 7269 em all as Invari │ │ │ │ +00018300: 616e 7420 5365 6374 696f 6e73 206f 6620 ant Sections of │ │ │ │ +00018310: 796f 7572 0a20 2020 2020 636f 6d62 696e your. combin │ │ │ │ +00018320: 6564 2077 6f72 6b20 696e 2069 7473 206c ed work in its l │ │ │ │ +00018330: 6963 656e 7365 206e 6f74 6963 652c 2061 icense notice, a │ │ │ │ +00018340: 6e64 2074 6861 7420 796f 7520 7072 6573 nd that you pres │ │ │ │ +00018350: 6572 7665 2061 6c6c 0a20 2020 2020 7468 erve all. th │ │ │ │ +00018360: 6569 7220 5761 7272 616e 7479 2044 6973 eir Warranty Dis │ │ │ │ +00018370: 636c 6169 6d65 7273 2e0a 0a20 2020 2020 claimers... │ │ │ │ +00018380: 5468 6520 636f 6d62 696e 6564 2077 6f72 The combined wor │ │ │ │ +00018390: 6b20 6e65 6564 206f 6e6c 7920 636f 6e74 k need only cont │ │ │ │ +000183a0: 6169 6e20 6f6e 6520 636f 7079 206f 6620 ain one copy of │ │ │ │ +000183b0: 7468 6973 204c 6963 656e 7365 2c20 616e this License, an │ │ │ │ +000183c0: 640a 2020 2020 206d 756c 7469 706c 6520 d. multiple │ │ │ │ +000183d0: 6964 656e 7469 6361 6c20 496e 7661 7269 identical Invari │ │ │ │ +000183e0: 616e 7420 5365 6374 696f 6e73 206d 6179 ant Sections may │ │ │ │ +000183f0: 2062 6520 7265 706c 6163 6564 2077 6974 be replaced wit │ │ │ │ +00018400: 6820 6120 7369 6e67 6c65 0a20 2020 2020 h a single. │ │ │ │ +00018410: 636f 7079 2e20 2049 6620 7468 6572 6520 copy. If there │ │ │ │ +00018420: 6172 6520 6d75 6c74 6970 6c65 2049 6e76 are multiple Inv │ │ │ │ +00018430: 6172 6961 6e74 2053 6563 7469 6f6e 7320 ariant Sections │ │ │ │ +00018440: 7769 7468 2074 6865 2073 616d 6520 6e61 with the same na │ │ │ │ +00018450: 6d65 0a20 2020 2020 6275 7420 6469 6666 me. but diff │ │ │ │ +00018460: 6572 656e 7420 636f 6e74 656e 7473 2c20 erent contents, │ │ │ │ +00018470: 6d61 6b65 2074 6865 2074 6974 6c65 206f make the title o │ │ │ │ +00018480: 6620 6561 6368 2073 7563 6820 7365 6374 f each such sect │ │ │ │ +00018490: 696f 6e20 756e 6971 7565 0a20 2020 2020 ion unique. │ │ │ │ +000184a0: 6279 2061 6464 696e 6720 6174 2074 6865 by adding at the │ │ │ │ +000184b0: 2065 6e64 206f 6620 6974 2c20 696e 2070 end of it, in p │ │ │ │ +000184c0: 6172 656e 7468 6573 6573 2c20 7468 6520 arentheses, the │ │ │ │ +000184d0: 6e61 6d65 206f 6620 7468 650a 2020 2020 name of the. │ │ │ │ +000184e0: 206f 7269 6769 6e61 6c20 6175 7468 6f72 original author │ │ │ │ +000184f0: 206f 7220 7075 626c 6973 6865 7220 6f66 or publisher of │ │ │ │ +00018500: 2074 6861 7420 7365 6374 696f 6e20 6966 that section if │ │ │ │ +00018510: 206b 6e6f 776e 2c20 6f72 2065 6c73 6520 known, or else │ │ │ │ +00018520: 610a 2020 2020 2075 6e69 7175 6520 6e75 a. unique nu │ │ │ │ +00018530: 6d62 6572 2e20 204d 616b 6520 7468 6520 mber. Make the │ │ │ │ +00018540: 7361 6d65 2061 646a 7573 746d 656e 7420 same adjustment │ │ │ │ +00018550: 746f 2074 6865 2073 6563 7469 6f6e 2074 to the section t │ │ │ │ +00018560: 6974 6c65 7320 696e 0a20 2020 2020 7468 itles in. th │ │ │ │ +00018570: 6520 6c69 7374 206f 6620 496e 7661 7269 e list of Invari │ │ │ │ +00018580: 616e 7420 5365 6374 696f 6e73 2069 6e20 ant Sections in │ │ │ │ +00018590: 7468 6520 6c69 6365 6e73 6520 6e6f 7469 the license noti │ │ │ │ +000185a0: 6365 206f 6620 7468 650a 2020 2020 2063 ce of the. c │ │ │ │ +000185b0: 6f6d 6269 6e65 6420 776f 726b 2e0a 0a20 ombined work... │ │ │ │ +000185c0: 2020 2020 496e 2074 6865 2063 6f6d 6269 In the combi │ │ │ │ +000185d0: 6e61 7469 6f6e 2c20 796f 7520 6d75 7374 nation, you must │ │ │ │ +000185e0: 2063 6f6d 6269 6e65 2061 6e79 2073 6563 combine any sec │ │ │ │ +000185f0: 7469 6f6e 7320 456e 7469 746c 6564 0a20 tions Entitled. │ │ │ │ +00018600: 2020 2020 2248 6973 746f 7279 2220 696e "History" in │ │ │ │ +00018610: 2074 6865 2076 6172 696f 7573 206f 7269 the various ori │ │ │ │ +00018620: 6769 6e61 6c20 646f 6375 6d65 6e74 732c ginal documents, │ │ │ │ +00018630: 2066 6f72 6d69 6e67 206f 6e65 2073 6563 forming one sec │ │ │ │ +00018640: 7469 6f6e 0a20 2020 2020 456e 7469 746c tion. Entitl │ │ │ │ +00018650: 6564 2022 4869 7374 6f72 7922 3b20 6c69 ed "History"; li │ │ │ │ +00018660: 6b65 7769 7365 2063 6f6d 6269 6e65 2061 kewise combine a │ │ │ │ +00018670: 6e79 2073 6563 7469 6f6e 7320 456e 7469 ny sections Enti │ │ │ │ +00018680: 746c 6564 0a20 2020 2020 2241 636b 6e6f tled. "Ackno │ │ │ │ +00018690: 776c 6564 6765 6d65 6e74 7322 2c20 616e wledgements", an │ │ │ │ +000186a0: 6420 616e 7920 7365 6374 696f 6e73 2045 d any sections E │ │ │ │ +000186b0: 6e74 6974 6c65 6420 2244 6564 6963 6174 ntitled "Dedicat │ │ │ │ +000186c0: 696f 6e73 222e 2020 596f 750a 2020 2020 ions". You. │ │ │ │ +000186d0: 206d 7573 7420 6465 6c65 7465 2061 6c6c must delete all │ │ │ │ +000186e0: 2073 6563 7469 6f6e 7320 456e 7469 746c sections Entitl │ │ │ │ +000186f0: 6564 2022 456e 646f 7273 656d 656e 7473 ed "Endorsements │ │ │ │ +00018700: 2e22 0a0a 2020 362e 2043 4f4c 4c45 4354 .".. 6. COLLECT │ │ │ │ +00018710: 494f 4e53 204f 4620 444f 4355 4d45 4e54 IONS OF DOCUMENT │ │ │ │ +00018720: 530a 0a20 2020 2020 596f 7520 6d61 7920 S.. You may │ │ │ │ +00018730: 6d61 6b65 2061 2063 6f6c 6c65 6374 696f make a collectio │ │ │ │ +00018740: 6e20 636f 6e73 6973 7469 6e67 206f 6620 n consisting of │ │ │ │ +00018750: 7468 6520 446f 6375 6d65 6e74 2061 6e64 the Document and │ │ │ │ +00018760: 206f 7468 6572 0a20 2020 2020 646f 6375 other. docu │ │ │ │ +00018770: 6d65 6e74 7320 7265 6c65 6173 6564 2075 ments released u │ │ │ │ +00018780: 6e64 6572 2074 6869 7320 4c69 6365 6e73 nder this Licens │ │ │ │ +00018790: 652c 2061 6e64 2072 6570 6c61 6365 2074 e, and replace t │ │ │ │ +000187a0: 6865 2069 6e64 6976 6964 7561 6c0a 2020 he individual. │ │ │ │ +000187b0: 2020 2063 6f70 6965 7320 6f66 2074 6869 copies of thi │ │ │ │ +000187c0: 7320 4c69 6365 6e73 6520 696e 2074 6865 s License in the │ │ │ │ +000187d0: 2076 6172 696f 7573 2064 6f63 756d 656e various documen │ │ │ │ +000187e0: 7473 2077 6974 6820 6120 7369 6e67 6c65 ts with a single │ │ │ │ +000187f0: 2063 6f70 790a 2020 2020 2074 6861 7420 copy. that │ │ │ │ +00018800: 6973 2069 6e63 6c75 6465 6420 696e 2074 is included in t │ │ │ │ +00018810: 6865 2063 6f6c 6c65 6374 696f 6e2c 2070 he collection, p │ │ │ │ +00018820: 726f 7669 6465 6420 7468 6174 2079 6f75 rovided that you │ │ │ │ +00018830: 2066 6f6c 6c6f 7720 7468 650a 2020 2020 follow the. │ │ │ │ +00018840: 2072 756c 6573 206f 6620 7468 6973 204c rules of this L │ │ │ │ +00018850: 6963 656e 7365 2066 6f72 2076 6572 6261 icense for verba │ │ │ │ +00018860: 7469 6d20 636f 7079 696e 6720 6f66 2065 tim copying of e │ │ │ │ +00018870: 6163 6820 6f66 2074 6865 2064 6f63 756d ach of the docum │ │ │ │ +00018880: 656e 7473 0a20 2020 2020 696e 2061 6c6c ents. in all │ │ │ │ +00018890: 206f 7468 6572 2072 6573 7065 6374 732e other respects. │ │ │ │ +000188a0: 0a0a 2020 2020 2059 6f75 206d 6179 2065 .. You may e │ │ │ │ +000188b0: 7874 7261 6374 2061 2073 696e 676c 6520 xtract a single │ │ │ │ +000188c0: 646f 6375 6d65 6e74 2066 726f 6d20 7375 document from su │ │ │ │ +000188d0: 6368 2061 2063 6f6c 6c65 6374 696f 6e2c ch a collection, │ │ │ │ +000188e0: 2061 6e64 0a20 2020 2020 6469 7374 7269 and. distri │ │ │ │ +000188f0: 6275 7465 2069 7420 696e 6469 7669 6475 bute it individu │ │ │ │ +00018900: 616c 6c79 2075 6e64 6572 2074 6869 7320 ally under this │ │ │ │ +00018910: 4c69 6365 6e73 652c 2070 726f 7669 6465 License, provide │ │ │ │ +00018920: 6420 796f 7520 696e 7365 7274 0a20 2020 d you insert. │ │ │ │ +00018930: 2020 6120 636f 7079 206f 6620 7468 6973 a copy of this │ │ │ │ +00018940: 204c 6963 656e 7365 2069 6e74 6f20 7468 License into th │ │ │ │ +00018950: 6520 6578 7472 6163 7465 6420 646f 6375 e extracted docu │ │ │ │ +00018960: 6d65 6e74 2c20 616e 6420 666f 6c6c 6f77 ment, and follow │ │ │ │ +00018970: 2074 6869 730a 2020 2020 204c 6963 656e this. Licen │ │ │ │ +00018980: 7365 2069 6e20 616c 6c20 6f74 6865 7220 se in all other │ │ │ │ +00018990: 7265 7370 6563 7473 2072 6567 6172 6469 respects regardi │ │ │ │ +000189a0: 6e67 2076 6572 6261 7469 6d20 636f 7079 ng verbatim copy │ │ │ │ +000189b0: 696e 6720 6f66 2074 6861 740a 2020 2020 ing of that. │ │ │ │ +000189c0: 2064 6f63 756d 656e 742e 0a0a 2020 372e document... 7. │ │ │ │ +000189d0: 2041 4747 5245 4741 5449 4f4e 2057 4954 AGGREGATION WIT │ │ │ │ +000189e0: 4820 494e 4445 5045 4e44 454e 5420 574f H INDEPENDENT WO │ │ │ │ +000189f0: 524b 530a 0a20 2020 2020 4120 636f 6d70 RKS.. A comp │ │ │ │ +00018a00: 696c 6174 696f 6e20 6f66 2074 6865 2044 ilation of the D │ │ │ │ +00018a10: 6f63 756d 656e 7420 6f72 2069 7473 2064 ocument or its d │ │ │ │ +00018a20: 6572 6976 6174 6976 6573 2077 6974 6820 erivatives with │ │ │ │ +00018a30: 6f74 6865 720a 2020 2020 2073 6570 6172 other. separ │ │ │ │ +00018a40: 6174 6520 616e 6420 696e 6465 7065 6e64 ate and independ │ │ │ │ +00018a50: 656e 7420 646f 6375 6d65 6e74 7320 6f72 ent documents or │ │ │ │ +00018a60: 2077 6f72 6b73 2c20 696e 206f 7220 6f6e works, in or on │ │ │ │ +00018a70: 2061 2076 6f6c 756d 6520 6f66 2061 0a20 a volume of a. │ │ │ │ +00018a80: 2020 2020 7374 6f72 6167 6520 6f72 2064 storage or d │ │ │ │ +00018a90: 6973 7472 6962 7574 696f 6e20 6d65 6469 istribution medi │ │ │ │ +00018aa0: 756d 2c20 6973 2063 616c 6c65 6420 616e um, is called an │ │ │ │ +00018ab0: 2022 6167 6772 6567 6174 6522 2069 6620 "aggregate" if │ │ │ │ +00018ac0: 7468 650a 2020 2020 2063 6f70 7972 6967 the. copyrig │ │ │ │ +00018ad0: 6874 2072 6573 756c 7469 6e67 2066 726f ht resulting fro │ │ │ │ +00018ae0: 6d20 7468 6520 636f 6d70 696c 6174 696f m the compilatio │ │ │ │ +00018af0: 6e20 6973 206e 6f74 2075 7365 6420 746f n is not used to │ │ │ │ +00018b00: 206c 696d 6974 2074 6865 0a20 2020 2020 limit the. │ │ │ │ +00018b10: 6c65 6761 6c20 7269 6768 7473 206f 6620 legal rights of │ │ │ │ +00018b20: 7468 6520 636f 6d70 696c 6174 696f 6e27 the compilation' │ │ │ │ +00018b30: 7320 7573 6572 7320 6265 796f 6e64 2077 s users beyond w │ │ │ │ +00018b40: 6861 7420 7468 6520 696e 6469 7669 6475 hat the individu │ │ │ │ +00018b50: 616c 0a20 2020 2020 776f 726b 7320 7065 al. works pe │ │ │ │ +00018b60: 726d 6974 2e20 2057 6865 6e20 7468 6520 rmit. When the │ │ │ │ +00018b70: 446f 6375 6d65 6e74 2069 7320 696e 636c Document is incl │ │ │ │ +00018b80: 7564 6564 2069 6e20 616e 2061 6767 7265 uded in an aggre │ │ │ │ +00018b90: 6761 7465 2c20 7468 6973 0a20 2020 2020 gate, this. │ │ │ │ +00018ba0: 4c69 6365 6e73 6520 646f 6573 206e 6f74 License does not │ │ │ │ +00018bb0: 2061 7070 6c79 2074 6f20 7468 6520 6f74 apply to the ot │ │ │ │ +00018bc0: 6865 7220 776f 726b 7320 696e 2074 6865 her works in the │ │ │ │ +00018bd0: 2061 6767 7265 6761 7465 2077 6869 6368 aggregate which │ │ │ │ +00018be0: 0a20 2020 2020 6172 6520 6e6f 7420 7468 . are not th │ │ │ │ +00018bf0: 656d 7365 6c76 6573 2064 6572 6976 6174 emselves derivat │ │ │ │ +00018c00: 6976 6520 776f 726b 7320 6f66 2074 6865 ive works of the │ │ │ │ +00018c10: 2044 6f63 756d 656e 742e 0a0a 2020 2020 Document... │ │ │ │ +00018c20: 2049 6620 7468 6520 436f 7665 7220 5465 If the Cover Te │ │ │ │ +00018c30: 7874 2072 6571 7569 7265 6d65 6e74 206f xt requirement o │ │ │ │ +00018c40: 6620 7365 6374 696f 6e20 3320 6973 2061 f section 3 is a │ │ │ │ +00018c50: 7070 6c69 6361 626c 6520 746f 2074 6865 pplicable to the │ │ │ │ +00018c60: 7365 0a20 2020 2020 636f 7069 6573 206f se. copies o │ │ │ │ +00018c70: 6620 7468 6520 446f 6375 6d65 6e74 2c20 f the Document, │ │ │ │ +00018c80: 7468 656e 2069 6620 7468 6520 446f 6375 then if the Docu │ │ │ │ +00018c90: 6d65 6e74 2069 7320 6c65 7373 2074 6861 ment is less tha │ │ │ │ +00018ca0: 6e20 6f6e 6520 6861 6c66 0a20 2020 2020 n one half. │ │ │ │ +00018cb0: 6f66 2074 6865 2065 6e74 6972 6520 6167 of the entire ag │ │ │ │ +00018cc0: 6772 6567 6174 652c 2074 6865 2044 6f63 gregate, the Doc │ │ │ │ +00018cd0: 756d 656e 7427 7320 436f 7665 7220 5465 ument's Cover Te │ │ │ │ +00018ce0: 7874 7320 6d61 7920 6265 2070 6c61 6365 xts may be place │ │ │ │ +00018cf0: 640a 2020 2020 206f 6e20 636f 7665 7273 d. on covers │ │ │ │ +00018d00: 2074 6861 7420 6272 6163 6b65 7420 7468 that bracket th │ │ │ │ +00018d10: 6520 446f 6375 6d65 6e74 2077 6974 6869 e Document withi │ │ │ │ +00018d20: 6e20 7468 6520 6167 6772 6567 6174 652c n the aggregate, │ │ │ │ +00018d30: 206f 7220 7468 650a 2020 2020 2065 6c65 or the. ele │ │ │ │ +00018d40: 6374 726f 6e69 6320 6571 7569 7661 6c65 ctronic equivale │ │ │ │ +00018d50: 6e74 206f 6620 636f 7665 7273 2069 6620 nt of covers if │ │ │ │ +00018d60: 7468 6520 446f 6375 6d65 6e74 2069 7320 the Document is │ │ │ │ +00018d70: 696e 2065 6c65 6374 726f 6e69 630a 2020 in electronic. │ │ │ │ +00018d80: 2020 2066 6f72 6d2e 2020 4f74 6865 7277 form. Otherw │ │ │ │ +00018d90: 6973 6520 7468 6579 206d 7573 7420 6170 ise they must ap │ │ │ │ +00018da0: 7065 6172 206f 6e20 7072 696e 7465 6420 pear on printed │ │ │ │ +00018db0: 636f 7665 7273 2074 6861 7420 6272 6163 covers that brac │ │ │ │ +00018dc0: 6b65 740a 2020 2020 2074 6865 2077 686f ket. the who │ │ │ │ +00018dd0: 6c65 2061 6767 7265 6761 7465 2e0a 0a20 le aggregate... │ │ │ │ +00018de0: 2038 2e20 5452 414e 534c 4154 494f 4e0a 8. TRANSLATION. │ │ │ │ +00018df0: 0a20 2020 2020 5472 616e 736c 6174 696f . Translatio │ │ │ │ +00018e00: 6e20 6973 2063 6f6e 7369 6465 7265 6420 n is considered │ │ │ │ +00018e10: 6120 6b69 6e64 206f 6620 6d6f 6469 6669 a kind of modifi │ │ │ │ +00018e20: 6361 7469 6f6e 2c20 736f 2079 6f75 206d cation, so you m │ │ │ │ +00018e30: 6179 0a20 2020 2020 6469 7374 7269 6275 ay. distribu │ │ │ │ +00018e40: 7465 2074 7261 6e73 6c61 7469 6f6e 7320 te translations │ │ │ │ +00018e50: 6f66 2074 6865 2044 6f63 756d 656e 7420 of the Document │ │ │ │ +00018e60: 756e 6465 7220 7468 6520 7465 726d 7320 under the terms │ │ │ │ +00018e70: 6f66 2073 6563 7469 6f6e 0a20 2020 2020 of section. │ │ │ │ +00018e80: 342e 2020 5265 706c 6163 696e 6720 496e 4. Replacing In │ │ │ │ +00018e90: 7661 7269 616e 7420 5365 6374 696f 6e73 variant Sections │ │ │ │ +00018ea0: 2077 6974 6820 7472 616e 736c 6174 696f with translatio │ │ │ │ +00018eb0: 6e73 2072 6571 7569 7265 7320 7370 6563 ns requires spec │ │ │ │ +00018ec0: 6961 6c0a 2020 2020 2070 6572 6d69 7373 ial. permiss │ │ │ │ +00018ed0: 696f 6e20 6672 6f6d 2074 6865 6972 2063 ion from their c │ │ │ │ +00018ee0: 6f70 7972 6967 6874 2068 6f6c 6465 7273 opyright holders │ │ │ │ +00018ef0: 2c20 6275 7420 796f 7520 6d61 7920 696e , but you may in │ │ │ │ +00018f00: 636c 7564 650a 2020 2020 2074 7261 6e73 clude. trans │ │ │ │ +00018f10: 6c61 7469 6f6e 7320 6f66 2073 6f6d 6520 lations of some │ │ │ │ +00018f20: 6f72 2061 6c6c 2049 6e76 6172 6961 6e74 or all Invariant │ │ │ │ +00018f30: 2053 6563 7469 6f6e 7320 696e 2061 6464 Sections in add │ │ │ │ +00018f40: 6974 696f 6e20 746f 2074 6865 0a20 2020 ition to the. │ │ │ │ +00018f50: 2020 6f72 6967 696e 616c 2076 6572 7369 original versi │ │ │ │ +00018f60: 6f6e 7320 6f66 2074 6865 7365 2049 6e76 ons of these Inv │ │ │ │ +00018f70: 6172 6961 6e74 2053 6563 7469 6f6e 732e ariant Sections. │ │ │ │ +00018f80: 2020 596f 7520 6d61 7920 696e 636c 7564 You may includ │ │ │ │ +00018f90: 6520 610a 2020 2020 2074 7261 6e73 6c61 e a. transla │ │ │ │ +00018fa0: 7469 6f6e 206f 6620 7468 6973 204c 6963 tion of this Lic │ │ │ │ +00018fb0: 656e 7365 2c20 616e 6420 616c 6c20 7468 ense, and all th │ │ │ │ +00018fc0: 6520 6c69 6365 6e73 6520 6e6f 7469 6365 e license notice │ │ │ │ +00018fd0: 7320 696e 2074 6865 0a20 2020 2020 446f s in the. Do │ │ │ │ +00018fe0: 6375 6d65 6e74 2c20 616e 6420 616e 7920 cument, and any │ │ │ │ +00018ff0: 5761 7272 616e 7479 2044 6973 636c 6169 Warranty Disclai │ │ │ │ +00019000: 6d65 7273 2c20 7072 6f76 6964 6564 2074 mers, provided t │ │ │ │ +00019010: 6861 7420 796f 7520 616c 736f 0a20 2020 hat you also. │ │ │ │ +00019020: 2020 696e 636c 7564 6520 7468 6520 6f72 include the or │ │ │ │ +00019030: 6967 696e 616c 2045 6e67 6c69 7368 2076 iginal English v │ │ │ │ +00019040: 6572 7369 6f6e 206f 6620 7468 6973 204c ersion of this L │ │ │ │ +00019050: 6963 656e 7365 2061 6e64 2074 6865 0a20 icense and the. │ │ │ │ +00019060: 2020 2020 6f72 6967 696e 616c 2076 6572 original ver │ │ │ │ +00019070: 7369 6f6e 7320 6f66 2074 686f 7365 206e sions of those n │ │ │ │ +00019080: 6f74 6963 6573 2061 6e64 2064 6973 636c otices and discl │ │ │ │ +00019090: 6169 6d65 7273 2e20 2049 6e20 6361 7365 aimers. In case │ │ │ │ +000190a0: 206f 6620 610a 2020 2020 2064 6973 6167 of a. disag │ │ │ │ +000190b0: 7265 656d 656e 7420 6265 7477 6565 6e20 reement between │ │ │ │ +000190c0: 7468 6520 7472 616e 736c 6174 696f 6e20 the translation │ │ │ │ +000190d0: 616e 6420 7468 6520 6f72 6967 696e 616c and the original │ │ │ │ +000190e0: 2076 6572 7369 6f6e 206f 660a 2020 2020 version of. │ │ │ │ +000190f0: 2074 6869 7320 4c69 6365 6e73 6520 6f72 this License or │ │ │ │ +00019100: 2061 206e 6f74 6963 6520 6f72 2064 6973 a notice or dis │ │ │ │ +00019110: 636c 6169 6d65 722c 2074 6865 206f 7269 claimer, the ori │ │ │ │ +00019120: 6769 6e61 6c20 7665 7273 696f 6e20 7769 ginal version wi │ │ │ │ +00019130: 6c6c 0a20 2020 2020 7072 6576 6169 6c2e ll. prevail. │ │ │ │ +00019140: 0a0a 2020 2020 2049 6620 6120 7365 6374 .. If a sect │ │ │ │ +00019150: 696f 6e20 696e 2074 6865 2044 6f63 756d ion in the Docum │ │ │ │ +00019160: 656e 7420 6973 2045 6e74 6974 6c65 6420 ent is Entitled │ │ │ │ +00019170: 2241 636b 6e6f 776c 6564 6765 6d65 6e74 "Acknowledgement │ │ │ │ +00019180: 7322 2c0a 2020 2020 2022 4465 6469 6361 s",. "Dedica │ │ │ │ +00019190: 7469 6f6e 7322 2c20 6f72 2022 4869 7374 tions", or "Hist │ │ │ │ +000191a0: 6f72 7922 2c20 7468 6520 7265 7175 6972 ory", the requir │ │ │ │ +000191b0: 656d 656e 7420 2873 6563 7469 6f6e 2034 ement (section 4 │ │ │ │ +000191c0: 2920 746f 0a20 2020 2020 5072 6573 6572 ) to. Preser │ │ │ │ +000191d0: 7665 2069 7473 2054 6974 6c65 2028 7365 ve its Title (se │ │ │ │ +000191e0: 6374 696f 6e20 3129 2077 696c 6c20 7479 ction 1) will ty │ │ │ │ +000191f0: 7069 6361 6c6c 7920 7265 7175 6972 6520 pically require │ │ │ │ +00019200: 6368 616e 6769 6e67 2074 6865 0a20 2020 changing the. │ │ │ │ +00019210: 2020 6163 7475 616c 2074 6974 6c65 2e0a actual title.. │ │ │ │ +00019220: 0a20 2039 2e20 5445 524d 494e 4154 494f . 9. TERMINATIO │ │ │ │ +00019230: 4e0a 0a20 2020 2020 596f 7520 6d61 7920 N.. You may │ │ │ │ +00019240: 6e6f 7420 636f 7079 2c20 6d6f 6469 6679 not copy, modify │ │ │ │ +00019250: 2c20 7375 626c 6963 656e 7365 2c20 6f72 , sublicense, or │ │ │ │ +00019260: 2064 6973 7472 6962 7574 6520 7468 6520 distribute the │ │ │ │ +00019270: 446f 6375 6d65 6e74 0a20 2020 2020 6578 Document. ex │ │ │ │ +00019280: 6365 7074 2061 7320 6578 7072 6573 736c cept as expressl │ │ │ │ +00019290: 7920 7072 6f76 6964 6564 2066 6f72 2075 y provided for u │ │ │ │ +000192a0: 6e64 6572 2074 6869 7320 4c69 6365 6e73 nder this Licens │ │ │ │ +000192b0: 652e 2020 416e 7920 6f74 6865 720a 2020 e. Any other. │ │ │ │ +000192c0: 2020 2061 7474 656d 7074 2074 6f20 636f attempt to co │ │ │ │ +000192d0: 7079 2c20 6d6f 6469 6679 2c20 7375 626c py, modify, subl │ │ │ │ +000192e0: 6963 656e 7365 206f 7220 6469 7374 7269 icense or distri │ │ │ │ +000192f0: 6275 7465 2074 6865 2044 6f63 756d 656e bute the Documen │ │ │ │ +00019300: 7420 6973 0a20 2020 2020 766f 6964 2c20 t is. void, │ │ │ │ +00019310: 616e 6420 7769 6c6c 2061 7574 6f6d 6174 and will automat │ │ │ │ +00019320: 6963 616c 6c79 2074 6572 6d69 6e61 7465 ically terminate │ │ │ │ +00019330: 2079 6f75 7220 7269 6768 7473 2075 6e64 your rights und │ │ │ │ +00019340: 6572 2074 6869 730a 2020 2020 204c 6963 er this. Lic │ │ │ │ +00019350: 656e 7365 2e20 2048 6f77 6576 6572 2c20 ense. However, │ │ │ │ +00019360: 7061 7274 6965 7320 7768 6f20 6861 7665 parties who have │ │ │ │ +00019370: 2072 6563 6569 7665 6420 636f 7069 6573 received copies │ │ │ │ +00019380: 2c20 6f72 2072 6967 6874 732c 0a20 2020 , or rights,. │ │ │ │ +00019390: 2020 6672 6f6d 2079 6f75 2075 6e64 6572 from you under │ │ │ │ +000193a0: 2074 6869 7320 4c69 6365 6e73 6520 7769 this License wi │ │ │ │ +000193b0: 6c6c 206e 6f74 2068 6176 6520 7468 6569 ll not have thei │ │ │ │ +000193c0: 7220 6c69 6365 6e73 6573 2074 6572 6d69 r licenses termi │ │ │ │ +000193d0: 6e61 7465 640a 2020 2020 2073 6f20 6c6f nated. so lo │ │ │ │ +000193e0: 6e67 2061 7320 7375 6368 2070 6172 7469 ng as such parti │ │ │ │ +000193f0: 6573 2072 656d 6169 6e20 696e 2066 756c es remain in ful │ │ │ │ +00019400: 6c20 636f 6d70 6c69 616e 6365 2e0a 0a20 l compliance... │ │ │ │ +00019410: 2031 302e 2046 5554 5552 4520 5245 5649 10. FUTURE REVI │ │ │ │ +00019420: 5349 4f4e 5320 4f46 2054 4849 5320 4c49 SIONS OF THIS LI │ │ │ │ +00019430: 4345 4e53 450a 0a20 2020 2020 5468 6520 CENSE.. The │ │ │ │ +00019440: 4672 6565 2053 6f66 7477 6172 6520 466f Free Software Fo │ │ │ │ +00019450: 756e 6461 7469 6f6e 206d 6179 2070 7562 undation may pub │ │ │ │ +00019460: 6c69 7368 206e 6577 2c20 7265 7669 7365 lish new, revise │ │ │ │ +00019470: 6420 7665 7273 696f 6e73 206f 660a 2020 d versions of. │ │ │ │ +00019480: 2020 2074 6865 2047 4e55 2046 7265 6520 the GNU Free │ │ │ │ +00019490: 446f 6375 6d65 6e74 6174 696f 6e20 4c69 Documentation Li │ │ │ │ +000194a0: 6365 6e73 6520 6672 6f6d 2074 696d 6520 cense from time │ │ │ │ +000194b0: 746f 2074 696d 652e 2020 5375 6368 206e to time. Such n │ │ │ │ +000194c0: 6577 0a20 2020 2020 7665 7273 696f 6e73 ew. versions │ │ │ │ +000194d0: 2077 696c 6c20 6265 2073 696d 696c 6172 will be similar │ │ │ │ +000194e0: 2069 6e20 7370 6972 6974 2074 6f20 7468 in spirit to th │ │ │ │ +000194f0: 6520 7072 6573 656e 7420 7665 7273 696f e present versio │ │ │ │ +00019500: 6e2c 2062 7574 206d 6179 0a20 2020 2020 n, but may. │ │ │ │ +00019510: 6469 6666 6572 2069 6e20 6465 7461 696c differ in detail │ │ │ │ +00019520: 2074 6f20 6164 6472 6573 7320 6e65 7720 to address new │ │ │ │ +00019530: 7072 6f62 6c65 6d73 206f 7220 636f 6e63 problems or conc │ │ │ │ +00019540: 6572 6e73 2e20 2053 6565 0a20 2020 2020 erns. See. │ │ │ │ +00019550: 3c68 7474 703a 2f2f 7777 772e 676e 752e .. │ │ │ │ +00019570: 0a20 2020 2020 4561 6368 2076 6572 7369 . Each versi │ │ │ │ +00019580: 6f6e 206f 6620 7468 6520 4c69 6365 6e73 on of the Licens │ │ │ │ +00019590: 6520 6973 2067 6976 656e 2061 2064 6973 e is given a dis │ │ │ │ +000195a0: 7469 6e67 7569 7368 696e 6720 7665 7273 tinguishing vers │ │ │ │ +000195b0: 696f 6e0a 2020 2020 206e 756d 6265 722e ion. number. │ │ │ │ +000195c0: 2020 4966 2074 6865 2044 6f63 756d 656e If the Documen │ │ │ │ +000195d0: 7420 7370 6563 6966 6965 7320 7468 6174 t specifies that │ │ │ │ +000195e0: 2061 2070 6172 7469 6375 6c61 7220 6e75 a particular nu │ │ │ │ +000195f0: 6d62 6572 6564 0a20 2020 2020 7665 7273 mbered. vers │ │ │ │ +00019600: 696f 6e20 6f66 2074 6869 7320 4c69 6365 ion of this Lice │ │ │ │ +00019610: 6e73 6520 226f 7220 616e 7920 6c61 7465 nse "or any late │ │ │ │ +00019620: 7220 7665 7273 696f 6e22 2061 7070 6c69 r version" appli │ │ │ │ +00019630: 6573 2074 6f20 6974 2c20 796f 750a 2020 es to it, you. │ │ │ │ +00019640: 2020 2068 6176 6520 7468 6520 6f70 7469 have the opti │ │ │ │ +00019650: 6f6e 206f 6620 666f 6c6c 6f77 696e 6720 on of following │ │ │ │ +00019660: 7468 6520 7465 726d 7320 616e 6420 636f the terms and co │ │ │ │ +00019670: 6e64 6974 696f 6e73 2065 6974 6865 7220 nditions either │ │ │ │ +00019680: 6f66 0a20 2020 2020 7468 6174 2073 7065 of. that spe │ │ │ │ +00019690: 6369 6669 6564 2076 6572 7369 6f6e 206f cified version o │ │ │ │ +000196a0: 7220 6f66 2061 6e79 206c 6174 6572 2076 r of any later v │ │ │ │ +000196b0: 6572 7369 6f6e 2074 6861 7420 6861 7320 ersion that has │ │ │ │ +000196c0: 6265 656e 0a20 2020 2020 7075 626c 6973 been. publis │ │ │ │ +000196d0: 6865 6420 286e 6f74 2061 7320 6120 6472 hed (not as a dr │ │ │ │ +000196e0: 6166 7429 2062 7920 7468 6520 4672 6565 aft) by the Free │ │ │ │ +000196f0: 2053 6f66 7477 6172 6520 466f 756e 6461 Software Founda │ │ │ │ +00019700: 7469 6f6e 2e20 2049 6620 7468 650a 2020 tion. If the. │ │ │ │ +00019710: 2020 2044 6f63 756d 656e 7420 646f 6573 Document does │ │ │ │ +00019720: 206e 6f74 2073 7065 6369 6679 2061 2076 not specify a v │ │ │ │ +00019730: 6572 7369 6f6e 206e 756d 6265 7220 6f66 ersion number of │ │ │ │ +00019740: 2074 6869 7320 4c69 6365 6e73 652c 2079 this License, y │ │ │ │ +00019750: 6f75 206d 6179 0a20 2020 2020 6368 6f6f ou may. choo │ │ │ │ +00019760: 7365 2061 6e79 2076 6572 7369 6f6e 2065 se any version e │ │ │ │ +00019770: 7665 7220 7075 626c 6973 6865 6420 286e ver published (n │ │ │ │ +00019780: 6f74 2061 7320 6120 6472 6166 7429 2062 ot as a draft) b │ │ │ │ +00019790: 7920 7468 6520 4672 6565 0a20 2020 2020 y the Free. │ │ │ │ +000197a0: 536f 6674 7761 7265 2046 6f75 6e64 6174 Software Foundat │ │ │ │ +000197b0: 696f 6e2e 0a0a 412e 312e 3120 4144 4445 ion...A.1.1 ADDE │ │ │ │ +000197c0: 4e44 554d 3a20 486f 7720 746f 2075 7365 NDUM: How to use │ │ │ │ +000197d0: 2074 6869 7320 4c69 6365 6e73 6520 666f this License fo │ │ │ │ +000197e0: 7220 796f 7572 2064 6f63 756d 656e 7473 r your documents │ │ │ │ +000197f0: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d .--------------- │ │ │ │ 00019800: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ 00019810: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ -00019820: 2d2d 2d2d 2d2d 2d0a 0a54 6f20 7573 6520 -------..To use │ │ │ │ -00019830: 7468 6973 204c 6963 656e 7365 2069 6e20 this License in │ │ │ │ -00019840: 6120 646f 6375 6d65 6e74 2079 6f75 2068 a document you h │ │ │ │ -00019850: 6176 6520 7772 6974 7465 6e2c 2069 6e63 ave written, inc │ │ │ │ -00019860: 6c75 6465 2061 2063 6f70 7920 6f66 0a74 lude a copy of.t │ │ │ │ -00019870: 6865 204c 6963 656e 7365 2069 6e20 7468 he License in th │ │ │ │ -00019880: 6520 646f 6375 6d65 6e74 2061 6e64 2070 e document and p │ │ │ │ -00019890: 7574 2074 6865 2066 6f6c 6c6f 7769 6e67 ut the following │ │ │ │ -000198a0: 2063 6f70 7972 6967 6874 2061 6e64 206c copyright and l │ │ │ │ -000198b0: 6963 656e 7365 0a6e 6f74 6963 6573 206a icense.notices j │ │ │ │ -000198c0: 7573 7420 6166 7465 7220 7468 6520 7469 ust after the ti │ │ │ │ -000198d0: 746c 6520 7061 6765 3a0a 0a20 2020 2020 tle page:.. │ │ │ │ -000198e0: 2020 436f 7079 7269 6768 7420 2843 2920 Copyright (C) │ │ │ │ -000198f0: 2059 4541 5220 2059 4f55 5220 4e41 4d45 YEAR YOUR NAME │ │ │ │ -00019900: 2e0a 2020 2020 2020 2050 6572 6d69 7373 .. Permiss │ │ │ │ -00019910: 696f 6e20 6973 2067 7261 6e74 6564 2074 ion is granted t │ │ │ │ -00019920: 6f20 636f 7079 2c20 6469 7374 7269 6275 o copy, distribu │ │ │ │ -00019930: 7465 2061 6e64 2f6f 7220 6d6f 6469 6679 te and/or modify │ │ │ │ -00019940: 2074 6869 7320 646f 6375 6d65 6e74 0a20 this document. │ │ │ │ -00019950: 2020 2020 2020 756e 6465 7220 7468 6520 under the │ │ │ │ -00019960: 7465 726d 7320 6f66 2074 6865 2047 4e55 terms of the GNU │ │ │ │ -00019970: 2046 7265 6520 446f 6375 6d65 6e74 6174 Free Documentat │ │ │ │ -00019980: 696f 6e20 4c69 6365 6e73 652c 2056 6572 ion License, Ver │ │ │ │ -00019990: 7369 6f6e 2031 2e32 0a20 2020 2020 2020 sion 1.2. │ │ │ │ -000199a0: 6f72 2061 6e79 206c 6174 6572 2076 6572 or any later ver │ │ │ │ -000199b0: 7369 6f6e 2070 7562 6c69 7368 6564 2062 sion published b │ │ │ │ -000199c0: 7920 7468 6520 4672 6565 2053 6f66 7477 y the Free Softw │ │ │ │ -000199d0: 6172 6520 466f 756e 6461 7469 6f6e 3b0a are Foundation;. │ │ │ │ -000199e0: 2020 2020 2020 2077 6974 6820 6e6f 2049 with no I │ │ │ │ -000199f0: 6e76 6172 6961 6e74 2053 6563 7469 6f6e nvariant Section │ │ │ │ -00019a00: 732c 206e 6f20 4672 6f6e 742d 436f 7665 s, no Front-Cove │ │ │ │ -00019a10: 7220 5465 7874 732c 2061 6e64 206e 6f20 r Texts, and no │ │ │ │ -00019a20: 4261 636b 2d43 6f76 6572 0a20 2020 2020 Back-Cover. │ │ │ │ -00019a30: 2020 5465 7874 732e 2020 4120 636f 7079 Texts. A copy │ │ │ │ -00019a40: 206f 6620 7468 6520 6c69 6365 6e73 6520 of the license │ │ │ │ -00019a50: 6973 2069 6e63 6c75 6465 6420 696e 2074 is included in t │ │ │ │ -00019a60: 6865 2073 6563 7469 6f6e 2065 6e74 6974 he section entit │ │ │ │ -00019a70: 6c65 6420 6060 474e 550a 2020 2020 2020 led ``GNU. │ │ │ │ -00019a80: 2046 7265 6520 446f 6375 6d65 6e74 6174 Free Documentat │ │ │ │ -00019a90: 696f 6e20 4c69 6365 6e73 6527 272e 0a0a ion License''... │ │ │ │ -00019aa0: 2020 2049 6620 796f 7520 6861 7665 2049 If you have I │ │ │ │ -00019ab0: 6e76 6172 6961 6e74 2053 6563 7469 6f6e nvariant Section │ │ │ │ -00019ac0: 732c 2046 726f 6e74 2d43 6f76 6572 2054 s, Front-Cover T │ │ │ │ -00019ad0: 6578 7473 2061 6e64 2042 6163 6b2d 436f exts and Back-Co │ │ │ │ -00019ae0: 7665 720a 5465 7874 732c 2072 6570 6c61 ver.Texts, repla │ │ │ │ -00019af0: 6365 2074 6865 2022 7769 7468 2e2e 2e54 ce the "with...T │ │ │ │ -00019b00: 6578 7473 2e22 2020 6c69 6e65 2077 6974 exts." line wit │ │ │ │ -00019b10: 6820 7468 6973 3a0a 0a20 2020 2020 2020 h this:.. │ │ │ │ -00019b20: 2020 7769 7468 2074 6865 2049 6e76 6172 with the Invar │ │ │ │ -00019b30: 6961 6e74 2053 6563 7469 6f6e 7320 6265 iant Sections be │ │ │ │ -00019b40: 696e 6720 4c49 5354 2054 4845 4952 2054 ing LIST THEIR T │ │ │ │ -00019b50: 4954 4c45 532c 2077 6974 680a 2020 2020 ITLES, with. │ │ │ │ -00019b60: 2020 2020 2074 6865 2046 726f 6e74 2d43 the Front-C │ │ │ │ -00019b70: 6f76 6572 2054 6578 7473 2062 6569 6e67 over Texts being │ │ │ │ -00019b80: 204c 4953 542c 2061 6e64 2077 6974 6820 LIST, and with │ │ │ │ -00019b90: 7468 6520 4261 636b 2d43 6f76 6572 2054 the Back-Cover T │ │ │ │ -00019ba0: 6578 7473 0a20 2020 2020 2020 2020 6265 exts. be │ │ │ │ -00019bb0: 696e 6720 4c49 5354 2e0a 0a20 2020 4966 ing LIST... If │ │ │ │ -00019bc0: 2079 6f75 2068 6176 6520 496e 7661 7269 you have Invari │ │ │ │ -00019bd0: 616e 7420 5365 6374 696f 6e73 2077 6974 ant Sections wit │ │ │ │ -00019be0: 686f 7574 2043 6f76 6572 2054 6578 7473 hout Cover Texts │ │ │ │ -00019bf0: 2c20 6f72 2073 6f6d 6520 6f74 6865 720a , or some other. │ │ │ │ -00019c00: 636f 6d62 696e 6174 696f 6e20 6f66 2074 combination of t │ │ │ │ -00019c10: 6865 2074 6872 6565 2c20 6d65 7267 6520 he three, merge │ │ │ │ -00019c20: 7468 6f73 6520 7477 6f20 616c 7465 726e those two altern │ │ │ │ -00019c30: 6174 6976 6573 2074 6f20 7375 6974 2074 atives to suit t │ │ │ │ -00019c40: 6865 0a73 6974 7561 7469 6f6e 2e0a 0a20 he.situation... │ │ │ │ -00019c50: 2020 4966 2079 6f75 7220 646f 6375 6d65 If your docume │ │ │ │ -00019c60: 6e74 2063 6f6e 7461 696e 7320 6e6f 6e74 nt contains nont │ │ │ │ -00019c70: 7269 7669 616c 2065 7861 6d70 6c65 7320 rivial examples │ │ │ │ -00019c80: 6f66 2070 726f 6772 616d 2063 6f64 652c of program code, │ │ │ │ -00019c90: 2077 650a 7265 636f 6d6d 656e 6420 7265 we.recommend re │ │ │ │ -00019ca0: 6c65 6173 696e 6720 7468 6573 6520 6578 leasing these ex │ │ │ │ -00019cb0: 616d 706c 6573 2069 6e20 7061 7261 6c6c amples in parall │ │ │ │ -00019cc0: 656c 2075 6e64 6572 2079 6f75 7220 6368 el under your ch │ │ │ │ -00019cd0: 6f69 6365 206f 6620 6672 6565 0a73 6f66 oice of free.sof │ │ │ │ -00019ce0: 7477 6172 6520 6c69 6365 6e73 652c 2073 tware license, s │ │ │ │ -00019cf0: 7563 6820 6173 2074 6865 2047 4e55 2047 uch as the GNU G │ │ │ │ -00019d00: 656e 6572 616c 2050 7562 6c69 6320 4c69 eneral Public Li │ │ │ │ -00019d10: 6365 6e73 652c 2074 6f20 7065 726d 6974 cense, to permit │ │ │ │ -00019d20: 0a74 6865 6972 2075 7365 2069 6e20 6672 .their use in fr │ │ │ │ -00019d30: 6565 2073 6f66 7477 6172 652e 0a0a 1f0a ee software..... │ │ │ │ -00019d40: 4669 6c65 3a20 6772 7562 2d64 6576 2e69 File: grub-dev.i │ │ │ │ -00019d50: 6e66 6f2c 2020 4e6f 6465 3a20 496e 6465 nfo, Node: Inde │ │ │ │ -00019d60: 782c 2020 5072 6576 3a20 436f 7079 696e x, Prev: Copyin │ │ │ │ -00019d70: 6720 5468 6973 204d 616e 7561 6c2c 2020 g This Manual, │ │ │ │ -00019d80: 5570 3a20 546f 700a 0a49 6e64 6578 0a2a Up: Top..Index.* │ │ │ │ -00019d90: 2a2a 2a2a 0a0a 0008 5b69 6e64 6578 0008 ****....[index.. │ │ │ │ -00019da0: 5d0a 2a20 4d65 6e75 3a0a 0a2a 2046 444c ].* Menu:..* FDL │ │ │ │ -00019db0: 2c20 474e 5520 4672 6565 2044 6f63 756d , GNU Free Docum │ │ │ │ -00019dc0: 656e 7461 7469 6f6e 204c 6963 656e 7365 entation License │ │ │ │ -00019dd0: 3a20 2020 474e 5520 4672 6565 2044 6f63 : GNU Free Doc │ │ │ │ -00019de0: 756d 656e 7461 7469 6f6e 204c 6963 656e umentation Licen │ │ │ │ -00019df0: 7365 2e0a 2020 2020 2020 2020 2020 2020 se.. │ │ │ │ +00019820: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a54 6f20 -----------..To │ │ │ │ +00019830: 7573 6520 7468 6973 204c 6963 656e 7365 use this License │ │ │ │ +00019840: 2069 6e20 6120 646f 6375 6d65 6e74 2079 in a document y │ │ │ │ +00019850: 6f75 2068 6176 6520 7772 6974 7465 6e2c ou have written, │ │ │ │ +00019860: 2069 6e63 6c75 6465 2061 2063 6f70 7920 include a copy │ │ │ │ +00019870: 6f66 0a74 6865 204c 6963 656e 7365 2069 of.the License i │ │ │ │ +00019880: 6e20 7468 6520 646f 6375 6d65 6e74 2061 n the document a │ │ │ │ +00019890: 6e64 2070 7574 2074 6865 2066 6f6c 6c6f nd put the follo │ │ │ │ +000198a0: 7769 6e67 2063 6f70 7972 6967 6874 2061 wing copyright a │ │ │ │ +000198b0: 6e64 206c 6963 656e 7365 0a6e 6f74 6963 nd license.notic │ │ │ │ +000198c0: 6573 206a 7573 7420 6166 7465 7220 7468 es just after th │ │ │ │ +000198d0: 6520 7469 746c 6520 7061 6765 3a0a 0a20 e title page:.. │ │ │ │ +000198e0: 2020 2020 2020 436f 7079 7269 6768 7420 Copyright │ │ │ │ +000198f0: 2843 2920 2059 4541 5220 2059 4f55 5220 (C) YEAR YOUR │ │ │ │ +00019900: 4e41 4d45 2e0a 2020 2020 2020 2050 6572 NAME.. Per │ │ │ │ +00019910: 6d69 7373 696f 6e20 6973 2067 7261 6e74 mission is grant │ │ │ │ +00019920: 6564 2074 6f20 636f 7079 2c20 6469 7374 ed to copy, dist │ │ │ │ +00019930: 7269 6275 7465 2061 6e64 2f6f 7220 6d6f ribute and/or mo │ │ │ │ +00019940: 6469 6679 2074 6869 7320 646f 6375 6d65 dify this docume │ │ │ │ +00019950: 6e74 0a20 2020 2020 2020 756e 6465 7220 nt. under │ │ │ │ +00019960: 7468 6520 7465 726d 7320 6f66 2074 6865 the terms of the │ │ │ │ +00019970: 2047 4e55 2046 7265 6520 446f 6375 6d65 GNU Free Docume │ │ │ │ +00019980: 6e74 6174 696f 6e20 4c69 6365 6e73 652c ntation License, │ │ │ │ +00019990: 2056 6572 7369 6f6e 2031 2e32 0a20 2020 Version 1.2. │ │ │ │ +000199a0: 2020 2020 6f72 2061 6e79 206c 6174 6572 or any later │ │ │ │ +000199b0: 2076 6572 7369 6f6e 2070 7562 6c69 7368 version publish │ │ │ │ +000199c0: 6564 2062 7920 7468 6520 4672 6565 2053 ed by the Free S │ │ │ │ +000199d0: 6f66 7477 6172 6520 466f 756e 6461 7469 oftware Foundati │ │ │ │ +000199e0: 6f6e 3b0a 2020 2020 2020 2077 6974 6820 on;. with │ │ │ │ +000199f0: 6e6f 2049 6e76 6172 6961 6e74 2053 6563 no Invariant Sec │ │ │ │ +00019a00: 7469 6f6e 732c 206e 6f20 4672 6f6e 742d tions, no Front- │ │ │ │ +00019a10: 436f 7665 7220 5465 7874 732c 2061 6e64 Cover Texts, and │ │ │ │ +00019a20: 206e 6f20 4261 636b 2d43 6f76 6572 0a20 no Back-Cover. │ │ │ │ +00019a30: 2020 2020 2020 5465 7874 732e 2020 4120 Texts. A │ │ │ │ +00019a40: 636f 7079 206f 6620 7468 6520 6c69 6365 copy of the lice │ │ │ │ +00019a50: 6e73 6520 6973 2069 6e63 6c75 6465 6420 nse is included │ │ │ │ +00019a60: 696e 2074 6865 2073 6563 7469 6f6e 2065 in the section e │ │ │ │ +00019a70: 6e74 6974 6c65 6420 6060 474e 550a 2020 ntitled ``GNU. │ │ │ │ +00019a80: 2020 2020 2046 7265 6520 446f 6375 6d65 Free Docume │ │ │ │ +00019a90: 6e74 6174 696f 6e20 4c69 6365 6e73 6527 ntation License' │ │ │ │ +00019aa0: 272e 0a0a 2020 2049 6620 796f 7520 6861 '... If you ha │ │ │ │ +00019ab0: 7665 2049 6e76 6172 6961 6e74 2053 6563 ve Invariant Sec │ │ │ │ +00019ac0: 7469 6f6e 732c 2046 726f 6e74 2d43 6f76 tions, Front-Cov │ │ │ │ +00019ad0: 6572 2054 6578 7473 2061 6e64 2042 6163 er Texts and Bac │ │ │ │ +00019ae0: 6b2d 436f 7665 720a 5465 7874 732c 2072 k-Cover.Texts, r │ │ │ │ +00019af0: 6570 6c61 6365 2074 6865 2022 7769 7468 eplace the "with │ │ │ │ +00019b00: 2e2e 2e54 6578 7473 2e22 2020 6c69 6e65 ...Texts." line │ │ │ │ +00019b10: 2077 6974 6820 7468 6973 3a0a 0a20 2020 with this:.. │ │ │ │ +00019b20: 2020 2020 2020 7769 7468 2074 6865 2049 with the I │ │ │ │ +00019b30: 6e76 6172 6961 6e74 2053 6563 7469 6f6e nvariant Section │ │ │ │ +00019b40: 7320 6265 696e 6720 4c49 5354 2054 4845 s being LIST THE │ │ │ │ +00019b50: 4952 2054 4954 4c45 532c 2077 6974 680a IR TITLES, with. │ │ │ │ +00019b60: 2020 2020 2020 2020 2074 6865 2046 726f the Fro │ │ │ │ +00019b70: 6e74 2d43 6f76 6572 2054 6578 7473 2062 nt-Cover Texts b │ │ │ │ +00019b80: 6569 6e67 204c 4953 542c 2061 6e64 2077 eing LIST, and w │ │ │ │ +00019b90: 6974 6820 7468 6520 4261 636b 2d43 6f76 ith the Back-Cov │ │ │ │ +00019ba0: 6572 2054 6578 7473 0a20 2020 2020 2020 er Texts. │ │ │ │ +00019bb0: 2020 6265 696e 6720 4c49 5354 2e0a 0a20 being LIST... │ │ │ │ +00019bc0: 2020 4966 2079 6f75 2068 6176 6520 496e If you have In │ │ │ │ +00019bd0: 7661 7269 616e 7420 5365 6374 696f 6e73 variant Sections │ │ │ │ +00019be0: 2077 6974 686f 7574 2043 6f76 6572 2054 without Cover T │ │ │ │ +00019bf0: 6578 7473 2c20 6f72 2073 6f6d 6520 6f74 exts, or some ot │ │ │ │ +00019c00: 6865 720a 636f 6d62 696e 6174 696f 6e20 her.combination │ │ │ │ +00019c10: 6f66 2074 6865 2074 6872 6565 2c20 6d65 of the three, me │ │ │ │ +00019c20: 7267 6520 7468 6f73 6520 7477 6f20 616c rge those two al │ │ │ │ +00019c30: 7465 726e 6174 6976 6573 2074 6f20 7375 ternatives to su │ │ │ │ +00019c40: 6974 2074 6865 0a73 6974 7561 7469 6f6e it the.situation │ │ │ │ +00019c50: 2e0a 0a20 2020 4966 2079 6f75 7220 646f ... If your do │ │ │ │ +00019c60: 6375 6d65 6e74 2063 6f6e 7461 696e 7320 cument contains │ │ │ │ +00019c70: 6e6f 6e74 7269 7669 616c 2065 7861 6d70 nontrivial examp │ │ │ │ +00019c80: 6c65 7320 6f66 2070 726f 6772 616d 2063 les of program c │ │ │ │ +00019c90: 6f64 652c 2077 650a 7265 636f 6d6d 656e ode, we.recommen │ │ │ │ +00019ca0: 6420 7265 6c65 6173 696e 6720 7468 6573 d releasing thes │ │ │ │ +00019cb0: 6520 6578 616d 706c 6573 2069 6e20 7061 e examples in pa │ │ │ │ +00019cc0: 7261 6c6c 656c 2075 6e64 6572 2079 6f75 rallel under you │ │ │ │ +00019cd0: 7220 6368 6f69 6365 206f 6620 6672 6565 r choice of free │ │ │ │ +00019ce0: 0a73 6f66 7477 6172 6520 6c69 6365 6e73 .software licens │ │ │ │ +00019cf0: 652c 2073 7563 6820 6173 2074 6865 2047 e, such as the G │ │ │ │ +00019d00: 4e55 2047 656e 6572 616c 2050 7562 6c69 NU General Publi │ │ │ │ +00019d10: 6320 4c69 6365 6e73 652c 2074 6f20 7065 c License, to pe │ │ │ │ +00019d20: 726d 6974 0a74 6865 6972 2075 7365 2069 rmit.their use i │ │ │ │ +00019d30: 6e20 6672 6565 2073 6f66 7477 6172 652e n free software. │ │ │ │ +00019d40: 0a0a 1f0a 4669 6c65 3a20 6772 7562 2d64 ....File: grub-d │ │ │ │ +00019d50: 6576 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ev.info, Node: │ │ │ │ +00019d60: 496e 6465 782c 2020 5072 6576 3a20 436f Index, Prev: Co │ │ │ │ +00019d70: 7079 696e 6720 5468 6973 204d 616e 7561 pying This Manua │ │ │ │ +00019d80: 6c2c 2020 5570 3a20 546f 700a 0a49 6e64 l, Up: Top..Ind │ │ │ │ +00019d90: 6578 0a2a 2a2a 2a2a 0a0a 0008 5b69 6e64 ex.*****....[ind │ │ │ │ +00019da0: 6578 0008 5d0a 2a20 4d65 6e75 3a0a 0a2a ex..].* Menu:..* │ │ │ │ +00019db0: 2046 444c 2c20 474e 5520 4672 6565 2044 FDL, GNU Free D │ │ │ │ +00019dc0: 6f63 756d 656e 7461 7469 6f6e 204c 6963 ocumentation Lic │ │ │ │ +00019dd0: 656e 7365 3a20 2020 474e 5520 4672 6565 ense: GNU Free │ │ │ │ +00019de0: 2044 6f63 756d 656e 7461 7469 6f6e 204c Documentation L │ │ │ │ +00019df0: 6963 656e 7365 2e0a 2020 2020 2020 2020 icense.. │ │ │ │ 00019e00: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ 00019e10: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ 00019e20: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00019e30: 2020 2020 286c 696e 6520 3629 0a0a 0a1f (line 6).... │ │ │ │ -00019e40: 0a54 6167 2054 6162 6c65 3a0a 4e6f 6465 .Tag Table:.Node │ │ │ │ -00019e50: 3a20 546f 707f 3633 370a 4e6f 6465 3a20 : Top.637.Node: │ │ │ │ -00019e60: 4765 7474 696e 6720 7468 6520 736f 7572 Getting the sour │ │ │ │ -00019e70: 6365 2063 6f64 657f 3138 3030 0a4e 6f64 ce code.1800.Nod │ │ │ │ -00019e80: 653a 2043 6f64 696e 6720 7374 796c 657f e: Coding style. │ │ │ │ -00019e90: 3237 3631 0a4e 6f64 653a 204e 616d 696e 2761.Node: Namin │ │ │ │ -00019ea0: 6720 436f 6e76 656e 7469 6f6e 737f 3331 g Conventions.31 │ │ │ │ -00019eb0: 3730 0a4e 6f64 653a 2046 756e 6374 696f 70.Node: Functio │ │ │ │ -00019ec0: 6e73 7f33 3435 350a 4e6f 6465 3a20 5661 ns.3455.Node: Va │ │ │ │ -00019ed0: 7269 6162 6c65 737f 3433 3239 0a4e 6f64 riables.4329.Nod │ │ │ │ -00019ee0: 653a 2054 7970 6573 7f35 3434 340a 4e6f e: Types.5444.No │ │ │ │ -00019ef0: 6465 3a20 4d61 6372 6f73 7f36 3034 350a de: Macros.6045. │ │ │ │ -00019f00: 4e6f 6465 3a20 436f 6d6d 656e 7473 7f36 Node: Comments.6 │ │ │ │ -00019f10: 3337 370a 4e6f 6465 3a20 4d75 6c74 692d 377.Node: Multi- │ │ │ │ -00019f20: 4c69 6e65 2043 6f6d 6d65 6e74 737f 3639 Line Comments.69 │ │ │ │ -00019f30: 3836 0a4e 6f64 653a 2046 696e 6469 6e67 86.Node: Finding │ │ │ │ -00019f40: 2079 6f75 7220 7761 7920 6172 6f75 6e64 your way around │ │ │ │ -00019f50: 7f37 3931 310a 4e6f 6465 3a20 436f 6e74 .7911.Node: Cont │ │ │ │ -00019f60: 7269 6275 7469 6e67 2043 6861 6e67 6573 ributing Changes │ │ │ │ -00019f70: 7f31 3132 3237 0a4e 6f64 653a 2047 6574 .11227.Node: Get │ │ │ │ -00019f80: 7469 6e67 2073 7461 7274 6564 7f31 3233 ting started.123 │ │ │ │ -00019f90: 3332 0a4e 6f64 653a 2054 7970 6963 616c 32.Node: Typical │ │ │ │ -00019fa0: 2044 6576 656c 6f70 6572 2045 7870 6572 Developer Exper │ │ │ │ -00019fb0: 6965 6e63 657f 3136 3338 340a 4e6f 6465 ience.16384.Node │ │ │ │ -00019fc0: 3a20 5768 656e 2079 6f75 2061 7265 2061 : When you are a │ │ │ │ -00019fd0: 7070 726f 7665 6420 666f 7220 7772 6974 pproved for writ │ │ │ │ -00019fe0: 6520 6163 6365 7373 2074 6f20 7072 6f6a e access to proj │ │ │ │ -00019ff0: 6563 7427 7320 6669 6c65 737f 3137 3432 ect's files.1742 │ │ │ │ -0001a000: 360a 4e6f 6465 3a20 5570 6461 7469 6e67 6.Node: Updating │ │ │ │ -0001a010: 2045 7874 6572 6e61 6c20 436f 6465 7f31 External Code.1 │ │ │ │ -0001a020: 3838 3539 0a4e 6f64 653a 2047 6e75 6c69 8859.Node: Gnuli │ │ │ │ -0001a030: 627f 3139 3133 300a 4e6f 6465 3a20 506f b.19130.Node: Po │ │ │ │ -0001a040: 7274 696e 677f 3230 3939 320a 4e6f 6465 rting.20992.Node │ │ │ │ -0001a050: 3a20 4572 726f 7220 4861 6e64 6c69 6e67 : Error Handling │ │ │ │ -0001a060: 7f33 3237 3536 0a4e 6f64 653a 2053 7461 .32756.Node: Sta │ │ │ │ -0001a070: 636b 2061 6e64 2068 6561 7020 7369 7a65 ck and heap size │ │ │ │ -0001a080: 7f33 3738 3438 0a4e 6f64 653a 2042 494f .37848.Node: BIO │ │ │ │ -0001a090: 5320 706f 7274 206d 656d 6f72 7920 6d61 S port memory ma │ │ │ │ -0001a0a0: 707f 3430 3438 310a 4e6f 6465 3a20 5669 p.40481.Node: Vi │ │ │ │ -0001a0b0: 6465 6f20 5375 6273 7973 7465 6d7f 3431 deo Subsystem.41 │ │ │ │ -0001a0c0: 3333 300a 4e6f 6465 3a20 5669 6465 6f20 330.Node: Video │ │ │ │ -0001a0d0: 4150 497f 3431 3830 340a 4e6f 6465 3a20 API.41804.Node: │ │ │ │ -0001a0e0: 4578 616d 706c 6520 7573 6167 6520 6f66 Example usage of │ │ │ │ -0001a0f0: 2056 6964 656f 2041 5049 7f36 3232 3533 Video API.62253 │ │ │ │ -0001a100: 0a4e 6f64 653a 2042 6974 6d61 7020 4150 .Node: Bitmap AP │ │ │ │ -0001a110: 497f 3633 3833 330a 4e6f 6465 3a20 5046 I.63833.Node: PF │ │ │ │ -0001a120: 4632 2046 6f6e 7420 4669 6c65 2046 6f72 F2 Font File For │ │ │ │ -0001a130: 6d61 747f 3636 3336 360a 4e6f 6465 3a20 mat.66366.Node: │ │ │ │ -0001a140: 496e 7472 6f64 7563 7469 6f6e 7f36 3636 Introduction.666 │ │ │ │ -0001a150: 3036 0a4e 6f64 653a 2046 696c 6520 5374 06.Node: File St │ │ │ │ -0001a160: 7275 6374 7572 657f 3638 3130 390a 4e6f ructure.68109.No │ │ │ │ -0001a170: 6465 3a20 466f 6e74 204d 6574 7269 6373 de: Font Metrics │ │ │ │ -0001a180: 7f37 3330 3237 0a4e 6f64 653a 2047 7261 .73027.Node: Gra │ │ │ │ -0001a190: 7068 6963 616c 204d 656e 7520 536f 6674 phical Menu Soft │ │ │ │ -0001a1a0: 7761 7265 2044 6573 6967 6e7f 3734 3137 ware Design.7417 │ │ │ │ -0001a1b0: 350a 4e6f 6465 3a20 496e 7472 6f64 7563 5.Node: Introduc │ │ │ │ -0001a1c0: 7469 6f6e 5f32 7f37 3434 3637 0a4e 6f64 tion_2.74467.Nod │ │ │ │ -0001a1d0: 653a 2053 7461 7274 7570 2053 6571 7565 e: Startup Seque │ │ │ │ -0001a1e0: 6e63 657f 3735 3230 310a 4e6f 6465 3a20 nce.75201.Node: │ │ │ │ -0001a1f0: 4755 4920 436f 6d70 6f6e 656e 7473 7f37 GUI Components.7 │ │ │ │ -0001a200: 3630 3532 0a4e 6f64 653a 2043 6f6d 6d61 6052.Node: Comma │ │ │ │ -0001a210: 6e64 204c 696e 6520 5769 6e64 6f77 7f37 nd Line Window.7 │ │ │ │ -0001a220: 3836 3532 0a4e 6f64 653a 2056 6572 6966 8652.Node: Verif │ │ │ │ -0001a230: 6965 7273 2066 7261 6d65 776f 726b 7f37 iers framework.7 │ │ │ │ -0001a240: 3936 3034 0a4e 6f64 653a 204c 6f63 6b64 9604.Node: Lockd │ │ │ │ -0001a250: 6f77 6e20 6672 616d 6577 6f72 6b7f 3832 own framework.82 │ │ │ │ -0001a260: 3231 310a 4e6f 6465 3a20 436f 7079 696e 211.Node: Copyin │ │ │ │ -0001a270: 6720 5468 6973 204d 616e 7561 6c7f 3833 g This Manual.83 │ │ │ │ -0001a280: 3135 330a 4e6f 6465 3a20 474e 5520 4672 153.Node: GNU Fr │ │ │ │ -0001a290: 6565 2044 6f63 756d 656e 7461 7469 6f6e ee Documentation │ │ │ │ -0001a2a0: 204c 6963 656e 7365 7f38 3333 3937 0a4e License.83397.N │ │ │ │ -0001a2b0: 6f64 653a 2049 6e64 6578 7f31 3035 3739 ode: Index.10579 │ │ │ │ -0001a2c0: 300a 1f0a 456e 6420 5461 6720 5461 626c 0...End Tag Tabl │ │ │ │ -0001a2d0: 650a 0a1f 0a4c 6f63 616c 2056 6172 6961 e....Local Varia │ │ │ │ -0001a2e0: 626c 6573 3a0a 636f 6469 6e67 3a20 7574 bles:.coding: ut │ │ │ │ -0001a2f0: 662d 380a 456e 643a 0a f-8.End:. │ │ │ │ +00019e30: 2020 2020 2020 2020 286c 696e 6520 3629 (line 6) │ │ │ │ +00019e40: 0a0a 0a1f 0a54 6167 2054 6162 6c65 3a0a .....Tag Table:. │ │ │ │ +00019e50: 4e6f 6465 3a20 546f 707f 3633 390a 4e6f Node: Top.639.No │ │ │ │ +00019e60: 6465 3a20 4765 7474 696e 6720 7468 6520 de: Getting the │ │ │ │ +00019e70: 736f 7572 6365 2063 6f64 657f 3138 3034 source code.1804 │ │ │ │ +00019e80: 0a4e 6f64 653a 2043 6f64 696e 6720 7374 .Node: Coding st │ │ │ │ +00019e90: 796c 657f 3237 3635 0a4e 6f64 653a 204e yle.2765.Node: N │ │ │ │ +00019ea0: 616d 696e 6720 436f 6e76 656e 7469 6f6e aming Convention │ │ │ │ +00019eb0: 737f 3331 3734 0a4e 6f64 653a 2046 756e s.3174.Node: Fun │ │ │ │ +00019ec0: 6374 696f 6e73 7f33 3435 390a 4e6f 6465 ctions.3459.Node │ │ │ │ +00019ed0: 3a20 5661 7269 6162 6c65 737f 3433 3333 : Variables.4333 │ │ │ │ +00019ee0: 0a4e 6f64 653a 2054 7970 6573 7f35 3434 .Node: Types.544 │ │ │ │ +00019ef0: 380a 4e6f 6465 3a20 4d61 6372 6f73 7f36 8.Node: Macros.6 │ │ │ │ +00019f00: 3034 390a 4e6f 6465 3a20 436f 6d6d 656e 049.Node: Commen │ │ │ │ +00019f10: 7473 7f36 3338 310a 4e6f 6465 3a20 4d75 ts.6381.Node: Mu │ │ │ │ +00019f20: 6c74 692d 4c69 6e65 2043 6f6d 6d65 6e74 lti-Line Comment │ │ │ │ +00019f30: 737f 3639 3930 0a4e 6f64 653a 2046 696e s.6990.Node: Fin │ │ │ │ +00019f40: 6469 6e67 2079 6f75 7220 7761 7920 6172 ding your way ar │ │ │ │ +00019f50: 6f75 6e64 7f37 3931 350a 4e6f 6465 3a20 ound.7915.Node: │ │ │ │ +00019f60: 436f 6e74 7269 6275 7469 6e67 2043 6861 Contributing Cha │ │ │ │ +00019f70: 6e67 6573 7f31 3132 3331 0a4e 6f64 653a nges.11231.Node: │ │ │ │ +00019f80: 2047 6574 7469 6e67 2073 7461 7274 6564 Getting started │ │ │ │ +00019f90: 7f31 3233 3336 0a4e 6f64 653a 2054 7970 .12336.Node: Typ │ │ │ │ +00019fa0: 6963 616c 2044 6576 656c 6f70 6572 2045 ical Developer E │ │ │ │ +00019fb0: 7870 6572 6965 6e63 657f 3136 3338 380a xperience.16388. │ │ │ │ +00019fc0: 4e6f 6465 3a20 5768 656e 2079 6f75 2061 Node: When you a │ │ │ │ +00019fd0: 7265 2061 7070 726f 7665 6420 666f 7220 re approved for │ │ │ │ +00019fe0: 7772 6974 6520 6163 6365 7373 2074 6f20 write access to │ │ │ │ +00019ff0: 7072 6f6a 6563 7427 7320 6669 6c65 737f project's files. │ │ │ │ +0001a000: 3137 3433 300a 4e6f 6465 3a20 5570 6461 17430.Node: Upda │ │ │ │ +0001a010: 7469 6e67 2045 7874 6572 6e61 6c20 436f ting External Co │ │ │ │ +0001a020: 6465 7f31 3838 3633 0a4e 6f64 653a 2047 de.18863.Node: G │ │ │ │ +0001a030: 6e75 6c69 627f 3139 3133 340a 4e6f 6465 nulib.19134.Node │ │ │ │ +0001a040: 3a20 506f 7274 696e 677f 3230 3939 360a : Porting.20996. │ │ │ │ +0001a050: 4e6f 6465 3a20 4572 726f 7220 4861 6e64 Node: Error Hand │ │ │ │ +0001a060: 6c69 6e67 7f33 3237 3630 0a4e 6f64 653a ling.32760.Node: │ │ │ │ +0001a070: 2053 7461 636b 2061 6e64 2068 6561 7020 Stack and heap │ │ │ │ +0001a080: 7369 7a65 7f33 3738 3532 0a4e 6f64 653a size.37852.Node: │ │ │ │ +0001a090: 2042 494f 5320 706f 7274 206d 656d 6f72 BIOS port memor │ │ │ │ +0001a0a0: 7920 6d61 707f 3430 3438 350a 4e6f 6465 y map.40485.Node │ │ │ │ +0001a0b0: 3a20 5669 6465 6f20 5375 6273 7973 7465 : Video Subsyste │ │ │ │ +0001a0c0: 6d7f 3431 3333 340a 4e6f 6465 3a20 5669 m.41334.Node: Vi │ │ │ │ +0001a0d0: 6465 6f20 4150 497f 3431 3830 380a 4e6f deo API.41808.No │ │ │ │ +0001a0e0: 6465 3a20 4578 616d 706c 6520 7573 6167 de: Example usag │ │ │ │ +0001a0f0: 6520 6f66 2056 6964 656f 2041 5049 7f36 e of Video API.6 │ │ │ │ +0001a100: 3232 3537 0a4e 6f64 653a 2042 6974 6d61 2257.Node: Bitma │ │ │ │ +0001a110: 7020 4150 497f 3633 3833 370a 4e6f 6465 p API.63837.Node │ │ │ │ +0001a120: 3a20 5046 4632 2046 6f6e 7420 4669 6c65 : PFF2 Font File │ │ │ │ +0001a130: 2046 6f72 6d61 747f 3636 3337 300a 4e6f Format.66370.No │ │ │ │ +0001a140: 6465 3a20 496e 7472 6f64 7563 7469 6f6e de: Introduction │ │ │ │ +0001a150: 7f36 3636 3130 0a4e 6f64 653a 2046 696c .66610.Node: Fil │ │ │ │ +0001a160: 6520 5374 7275 6374 7572 657f 3638 3131 e Structure.6811 │ │ │ │ +0001a170: 330a 4e6f 6465 3a20 466f 6e74 204d 6574 3.Node: Font Met │ │ │ │ +0001a180: 7269 6373 7f37 3330 3331 0a4e 6f64 653a rics.73031.Node: │ │ │ │ +0001a190: 2047 7261 7068 6963 616c 204d 656e 7520 Graphical Menu │ │ │ │ +0001a1a0: 536f 6674 7761 7265 2044 6573 6967 6e7f Software Design. │ │ │ │ +0001a1b0: 3734 3137 390a 4e6f 6465 3a20 496e 7472 74179.Node: Intr │ │ │ │ +0001a1c0: 6f64 7563 7469 6f6e 5f32 7f37 3434 3731 oduction_2.74471 │ │ │ │ +0001a1d0: 0a4e 6f64 653a 2053 7461 7274 7570 2053 .Node: Startup S │ │ │ │ +0001a1e0: 6571 7565 6e63 657f 3735 3230 350a 4e6f equence.75205.No │ │ │ │ +0001a1f0: 6465 3a20 4755 4920 436f 6d70 6f6e 656e de: GUI Componen │ │ │ │ +0001a200: 7473 7f37 3630 3536 0a4e 6f64 653a 2043 ts.76056.Node: C │ │ │ │ +0001a210: 6f6d 6d61 6e64 204c 696e 6520 5769 6e64 ommand Line Wind │ │ │ │ +0001a220: 6f77 7f37 3836 3536 0a4e 6f64 653a 2056 ow.78656.Node: V │ │ │ │ +0001a230: 6572 6966 6965 7273 2066 7261 6d65 776f erifiers framewo │ │ │ │ +0001a240: 726b 7f37 3936 3038 0a4e 6f64 653a 204c rk.79608.Node: L │ │ │ │ +0001a250: 6f63 6b64 6f77 6e20 6672 616d 6577 6f72 ockdown framewor │ │ │ │ +0001a260: 6b7f 3832 3231 350a 4e6f 6465 3a20 436f k.82215.Node: Co │ │ │ │ +0001a270: 7079 696e 6720 5468 6973 204d 616e 7561 pying This Manua │ │ │ │ +0001a280: 6c7f 3833 3135 370a 4e6f 6465 3a20 474e l.83157.Node: GN │ │ │ │ +0001a290: 5520 4672 6565 2044 6f63 756d 656e 7461 U Free Documenta │ │ │ │ +0001a2a0: 7469 6f6e 204c 6963 656e 7365 7f38 3334 tion License.834 │ │ │ │ +0001a2b0: 3031 0a4e 6f64 653a 2049 6e64 6578 7f31 01.Node: Index.1 │ │ │ │ +0001a2c0: 3035 3739 340a 1f0a 456e 6420 5461 6720 05794...End Tag │ │ │ │ +0001a2d0: 5461 626c 650a 0a1f 0a4c 6f63 616c 2056 Table....Local V │ │ │ │ +0001a2e0: 6172 6961 626c 6573 3a0a 636f 6469 6e67 ariables:.coding │ │ │ │ +0001a2f0: 3a20 7574 662d 380a 456e 643a 0a : utf-8.End:. │ │ ├── ./usr/share/info/grub.info-1.gz │ │ │ ├── grub.info-1 │ │ │ │ @@ -1,18896 +1,18896 @@ │ │ │ │ 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 3720 6672 6f6d 2067 7275 622e 7465 6.7 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 3034 2c20 (version 2.04, │ │ │ │ -00000070: 3130 204a 756c 7920 3230 3231 292e 0a0a 10 July 2021)... │ │ │ │ -00000080: 2020 2043 6f70 7972 6967 6874 2028 4329 Copyright (C) │ │ │ │ -00000090: 0a31 3939 392c 3230 3030 2c32 3030 312c .1999,2000,2001, │ │ │ │ -000000a0: 3230 3032 2c32 3030 342c 3230 3036 2c32 2002,2004,2006,2 │ │ │ │ -000000b0: 3030 382c 3230 3039 2c32 3031 302c 3230 008,2009,2010,20 │ │ │ │ -000000c0: 3131 2c32 3031 322c 3230 3133 2046 7265 11,2012,2013 Fre │ │ │ │ -000000d0: 650a 536f 6674 7761 7265 2046 6f75 6e64 e.Software Found │ │ │ │ -000000e0: 6174 696f 6e2c 2049 6e63 2e0a 0a20 2020 ation, Inc... │ │ │ │ -000000f0: 2020 5065 726d 6973 7369 6f6e 2069 7320 Permission is │ │ │ │ -00000100: 6772 616e 7465 6420 746f 2063 6f70 792c granted to copy, │ │ │ │ -00000110: 2064 6973 7472 6962 7574 6520 616e 642f distribute and/ │ │ │ │ -00000120: 6f72 206d 6f64 6966 7920 7468 6973 0a20 or modify this. │ │ │ │ -00000130: 2020 2020 646f 6375 6d65 6e74 2075 6e64 document und │ │ │ │ -00000140: 6572 2074 6865 2074 6572 6d73 206f 6620 er the terms of │ │ │ │ -00000150: 7468 6520 474e 5520 4672 6565 2044 6f63 the GNU Free Doc │ │ │ │ -00000160: 756d 656e 7461 7469 6f6e 204c 6963 656e umentation Licen │ │ │ │ -00000170: 7365 2c0a 2020 2020 2056 6572 7369 6f6e se,. Version │ │ │ │ -00000180: 2031 2e32 206f 7220 616e 7920 6c61 7465 1.2 or any late │ │ │ │ -00000190: 7220 7665 7273 696f 6e20 7075 626c 6973 r version publis │ │ │ │ -000001a0: 6865 6420 6279 2074 6865 2046 7265 6520 hed by the Free │ │ │ │ -000001b0: 536f 6674 7761 7265 0a20 2020 2020 466f Software. Fo │ │ │ │ -000001c0: 756e 6461 7469 6f6e 3b20 7769 7468 206e undation; with n │ │ │ │ -000001d0: 6f20 496e 7661 7269 616e 7420 5365 6374 o Invariant Sect │ │ │ │ -000001e0: 696f 6e73 2e0a 494e 464f 2d44 4952 2d53 ions..INFO-DIR-S │ │ │ │ -000001f0: 4543 5449 4f4e 204b 6572 6e65 6c0a 5354 ECTION Kernel.ST │ │ │ │ -00000200: 4152 542d 494e 464f 2d44 4952 2d45 4e54 ART-INFO-DIR-ENT │ │ │ │ -00000210: 5259 0a2a 2047 5255 423a 2028 6772 7562 RY.* GRUB: (grub │ │ │ │ -00000220: 292e 2020 2020 2020 2020 2020 2020 2020 ). │ │ │ │ -00000230: 2020 2054 6865 2047 5261 6e64 2055 6e69 The GRand Uni │ │ │ │ -00000240: 6669 6564 2042 6f6f 746c 6f61 6465 720a fied Bootloader. │ │ │ │ -00000250: 2a20 6772 7562 2d69 6e73 7461 6c6c 3a20 * grub-install: │ │ │ │ -00000260: 2867 7275 6229 496e 766f 6b69 6e67 2067 (grub)Invoking g │ │ │ │ -00000270: 7275 622d 696e 7374 616c 6c2e 2020 2020 rub-install. │ │ │ │ -00000280: 496e 7374 616c 6c20 4752 5542 206f 6e20 Install GRUB on │ │ │ │ -00000290: 796f 7572 2064 7269 7665 0a2a 2067 7275 your drive.* gru │ │ │ │ -000002a0: 622d 6d6b 636f 6e66 6967 3a20 2867 7275 b-mkconfig: (gru │ │ │ │ -000002b0: 6229 496e 766f 6b69 6e67 2067 7275 622d b)Invoking grub- │ │ │ │ -000002c0: 6d6b 636f 6e66 6967 2e20 2047 656e 6572 mkconfig. Gener │ │ │ │ -000002d0: 6174 6520 4752 5542 2063 6f6e 6669 6775 ate GRUB configu │ │ │ │ -000002e0: 7261 7469 6f6e 0a2a 2067 7275 622d 6d6b ration.* grub-mk │ │ │ │ -000002f0: 7061 7373 7764 2d70 626b 6466 323a 2028 passwd-pbkdf2: ( │ │ │ │ -00000300: 6772 7562 2949 6e76 6f6b 696e 6720 6772 grub)Invoking gr │ │ │ │ -00000310: 7562 2d6d 6b70 6173 7377 642d 7062 6b64 ub-mkpasswd-pbkd │ │ │ │ -00000320: 6632 2e0a 2a20 6772 7562 2d6d 6b72 656c f2..* grub-mkrel │ │ │ │ -00000330: 7061 7468 3a20 2867 7275 6229 496e 766f path: (grub)Invo │ │ │ │ -00000340: 6b69 6e67 2067 7275 622d 6d6b 7265 6c70 king grub-mkrelp │ │ │ │ -00000350: 6174 682e 0a2a 2067 7275 622d 6d6b 7265 ath..* grub-mkre │ │ │ │ -00000360: 7363 7565 3a20 2867 7275 6229 496e 766f scue: (grub)Invo │ │ │ │ -00000370: 6b69 6e67 2067 7275 622d 6d6b 7265 7363 king grub-mkresc │ │ │ │ -00000380: 7565 2e20 204d 616b 6520 6120 4752 5542 ue. Make a GRUB │ │ │ │ -00000390: 2072 6573 6375 6520 696d 6167 650a 2a20 rescue image.* │ │ │ │ -000003a0: 6772 7562 2d6d 6f75 6e74 3a20 2867 7275 grub-mount: (gru │ │ │ │ -000003b0: 6229 496e 766f 6b69 6e67 2067 7275 622d b)Invoking grub- │ │ │ │ -000003c0: 6d6f 756e 742e 2020 2020 2020 2020 4d6f mount. Mo │ │ │ │ -000003d0: 756e 7420 6120 6669 6c65 2073 7973 7465 unt a file syste │ │ │ │ -000003e0: 6d20 7573 696e 6720 4752 5542 0a2a 2067 m using GRUB.* g │ │ │ │ -000003f0: 7275 622d 7072 6f62 653a 2028 6772 7562 rub-probe: (grub │ │ │ │ -00000400: 2949 6e76 6f6b 696e 6720 6772 7562 2d70 )Invoking grub-p │ │ │ │ -00000410: 726f 6265 2e20 2020 2020 2020 2050 726f robe. Pro │ │ │ │ -00000420: 6265 2064 6576 6963 6520 696e 666f 726d be device inform │ │ │ │ -00000430: 6174 696f 6e0a 2a20 6772 7562 2d73 6372 ation.* grub-scr │ │ │ │ -00000440: 6970 742d 6368 6563 6b3a 2028 6772 7562 ipt-check: (grub │ │ │ │ -00000450: 2949 6e76 6f6b 696e 6720 6772 7562 2d73 )Invoking grub-s │ │ │ │ -00000460: 6372 6970 742d 6368 6563 6b2e 0a45 4e44 cript-check..END │ │ │ │ -00000470: 2d49 4e46 4f2d 4449 522d 454e 5452 590a -INFO-DIR-ENTRY. │ │ │ │ -00000480: 0a1f 0a46 696c 653a 2067 7275 622e 696e ...File: grub.in │ │ │ │ -00000490: 666f 2c20 204e 6f64 653a 2054 6f70 2c20 fo, Node: Top, │ │ │ │ -000004a0: 204e 6578 743a 2049 6e74 726f 6475 6374 Next: Introduct │ │ │ │ -000004b0: 696f 6e2c 2020 5570 3a20 2864 6972 290a ion, Up: (dir). │ │ │ │ -000004c0: 0a47 4e55 2047 5255 4220 6d61 6e75 616c .GNU GRUB manual │ │ │ │ -000004d0: 0a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a .*************** │ │ │ │ -000004e0: 0a0a 5468 6973 2069 7320 7468 6520 646f ..This is the do │ │ │ │ -000004f0: 6375 6d65 6e74 6174 696f 6e20 6f66 2047 cumentation of G │ │ │ │ -00000500: 4e55 2047 5255 422c 2074 6865 2047 5261 NU GRUB, the GRa │ │ │ │ -00000510: 6e64 2055 6e69 6669 6564 2042 6f6f 746c nd Unified Bootl │ │ │ │ -00000520: 6f61 6465 722c 2061 0a66 6c65 7869 626c oader, a.flexibl │ │ │ │ -00000530: 6520 616e 6420 706f 7765 7266 756c 2062 e and powerful b │ │ │ │ -00000540: 6f6f 7420 6c6f 6164 6572 2070 726f 6772 oot loader progr │ │ │ │ -00000550: 616d 2066 6f72 2061 2077 6964 6520 7261 am for a wide ra │ │ │ │ -00000560: 6e67 6520 6f66 0a61 7263 6869 7465 6374 nge of.architect │ │ │ │ -00000570: 7572 6573 2e0a 0a20 2020 5468 6973 2065 ures... This e │ │ │ │ -00000580: 6469 7469 6f6e 2064 6f63 756d 656e 7473 dition documents │ │ │ │ -00000590: 2076 6572 7369 6f6e 2032 2e30 342e 0a0a version 2.04... │ │ │ │ -000005a0: 2020 2054 6869 7320 6d61 6e75 616c 2069 This manual i │ │ │ │ -000005b0: 7320 666f 7220 474e 5520 4752 5542 2028 s for GNU GRUB ( │ │ │ │ -000005c0: 7665 7273 696f 6e20 322e 3034 2c20 3130 version 2.04, 10 │ │ │ │ -000005d0: 204a 756c 7920 3230 3231 292e 0a0a 2020 July 2021)... │ │ │ │ -000005e0: 2043 6f70 7972 6967 6874 2028 4329 0a31 Copyright (C).1 │ │ │ │ -000005f0: 3939 392c 3230 3030 2c32 3030 312c 3230 999,2000,2001,20 │ │ │ │ -00000600: 3032 2c32 3030 342c 3230 3036 2c32 3030 02,2004,2006,200 │ │ │ │ -00000610: 382c 3230 3039 2c32 3031 302c 3230 3131 8,2009,2010,2011 │ │ │ │ -00000620: 2c32 3031 322c 3230 3133 2046 7265 650a ,2012,2013 Free. │ │ │ │ -00000630: 536f 6674 7761 7265 2046 6f75 6e64 6174 Software Foundat │ │ │ │ -00000640: 696f 6e2c 2049 6e63 2e0a 0a20 2020 2020 ion, Inc... │ │ │ │ -00000650: 5065 726d 6973 7369 6f6e 2069 7320 6772 Permission is gr │ │ │ │ -00000660: 616e 7465 6420 746f 2063 6f70 792c 2064 anted to copy, d │ │ │ │ -00000670: 6973 7472 6962 7574 6520 616e 642f 6f72 istribute and/or │ │ │ │ -00000680: 206d 6f64 6966 7920 7468 6973 0a20 2020 modify this. │ │ │ │ -00000690: 2020 646f 6375 6d65 6e74 2075 6e64 6572 document under │ │ │ │ -000006a0: 2074 6865 2074 6572 6d73 206f 6620 7468 the terms of th │ │ │ │ -000006b0: 6520 474e 5520 4672 6565 2044 6f63 756d e GNU Free Docum │ │ │ │ -000006c0: 656e 7461 7469 6f6e 204c 6963 656e 7365 entation License │ │ │ │ -000006d0: 2c0a 2020 2020 2056 6572 7369 6f6e 2031 ,. Version 1 │ │ │ │ -000006e0: 2e32 206f 7220 616e 7920 6c61 7465 7220 .2 or any later │ │ │ │ -000006f0: 7665 7273 696f 6e20 7075 626c 6973 6865 version publishe │ │ │ │ -00000700: 6420 6279 2074 6865 2046 7265 6520 536f d by the Free So │ │ │ │ -00000710: 6674 7761 7265 0a20 2020 2020 466f 756e ftware. Foun │ │ │ │ -00000720: 6461 7469 6f6e 3b20 7769 7468 206e 6f20 dation; with no │ │ │ │ -00000730: 496e 7661 7269 616e 7420 5365 6374 696f Invariant Sectio │ │ │ │ -00000740: 6e73 2e0a 0a2a 204d 656e 753a 0a0a 2a20 ns...* Menu:..* │ │ │ │ -00000750: 496e 7472 6f64 7563 7469 6f6e 3a3a 2020 Introduction:: │ │ │ │ -00000760: 2020 2020 2020 2020 2020 2020 2020 4361 Ca │ │ │ │ -00000770: 7074 7572 696e 6720 7468 6520 7370 6972 pturing the spir │ │ │ │ -00000780: 6974 206f 6620 4752 5542 0a2a 204e 616d it of GRUB.* Nam │ │ │ │ -00000790: 696e 6720 636f 6e76 656e 7469 6f6e 3a3a ing convention:: │ │ │ │ -000007a0: 2020 2020 2020 2020 2020 204e 616d 6573 Names │ │ │ │ -000007b0: 206f 6620 796f 7572 2064 7269 7665 7320 of your drives │ │ │ │ -000007c0: 696e 2047 5255 420a 2a20 4f53 2d73 7065 in GRUB.* OS-spe │ │ │ │ -000007d0: 6369 6669 6320 6e6f 7465 7320 6162 6f75 cific notes abou │ │ │ │ -000007e0: 7420 6772 7562 2074 6f6f 6c73 3a3a 0a20 t grub tools::. │ │ │ │ -000007f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00000800: 2020 2020 2020 2020 2020 2020 2020 2053 S │ │ │ │ -00000810: 6f6d 6520 6e6f 7465 7320 6162 6f75 7420 ome notes about │ │ │ │ -00000820: 4f53 2d73 7065 6369 6669 6320 6265 6861 OS-specific beha │ │ │ │ -00000830: 7669 6f75 7220 6f66 2047 5255 420a 2020 viour of GRUB. │ │ │ │ -00000840: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00000850: 2020 2020 2020 2020 2020 2020 2020 746f to │ │ │ │ -00000860: 6f6c 730a 2a20 496e 7374 616c 6c61 7469 ols.* Installati │ │ │ │ -00000870: 6f6e 3a3a 2020 2020 2020 2020 2020 2020 on:: │ │ │ │ -00000880: 2020 2020 496e 7374 616c 6c69 6e67 2047 Installing G │ │ │ │ -00000890: 5255 4220 6f6e 2079 6f75 7220 6472 6976 RUB on your driv │ │ │ │ -000008a0: 650a 2a20 426f 6f74 696e 673a 3a20 2020 e.* Booting:: │ │ │ │ -000008b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -000008c0: 2020 486f 7720 746f 2062 6f6f 7420 6469 How to boot di │ │ │ │ -000008d0: 6666 6572 656e 7420 6f70 6572 6174 696e fferent operatin │ │ │ │ -000008e0: 6720 7379 7374 656d 730a 2a20 436f 6e66 g systems.* Conf │ │ │ │ -000008f0: 6967 7572 6174 696f 6e3a 3a20 2020 2020 iguration:: │ │ │ │ -00000900: 2020 2020 2020 2020 2020 5772 6974 696e Writin │ │ │ │ -00000910: 6720 796f 7572 206f 776e 2063 6f6e 6669 g your own confi │ │ │ │ -00000920: 6775 7261 7469 6f6e 2066 696c 650a 2a20 guration file.* │ │ │ │ -00000930: 5468 656d 6520 6669 6c65 2066 6f72 6d61 Theme file forma │ │ │ │ -00000940: 743a 3a20 2020 2020 2020 2020 2020 466f t:: Fo │ │ │ │ -00000950: 726d 6174 206f 6620 4752 5542 2074 6865 rmat of GRUB the │ │ │ │ -00000960: 6d65 2066 696c 6573 0a2a 204e 6574 776f me files.* Netwo │ │ │ │ -00000970: 726b 3a3a 2020 2020 2020 2020 2020 2020 rk:: │ │ │ │ -00000980: 2020 2020 2020 2020 2044 6f77 6e6c 6f61 Downloa │ │ │ │ -00000990: 6469 6e67 204f 5320 696d 6167 6573 2066 ding OS images f │ │ │ │ -000009a0: 726f 6d20 6120 6e65 7477 6f72 6b0a 2a20 rom a network.* │ │ │ │ -000009b0: 5365 7269 616c 2074 6572 6d69 6e61 6c3a Serial terminal: │ │ │ │ -000009c0: 3a20 2020 2020 2020 2020 2020 2020 5573 : Us │ │ │ │ -000009d0: 696e 6720 4752 5542 2076 6961 2061 2073 ing GRUB via a s │ │ │ │ -000009e0: 6572 6961 6c20 6c69 6e65 0a2a 2056 656e erial line.* Ven │ │ │ │ -000009f0: 646f 7220 706f 7765 722d 6f6e 206b 6579 dor power-on key │ │ │ │ -00000a00: 733a 3a20 2020 2020 2020 2043 6861 6e67 s:: Chang │ │ │ │ -00000a10: 696e 6720 4752 5542 2062 6568 6176 696f ing GRUB behavio │ │ │ │ -00000a20: 7572 206f 6e20 7665 6e64 6f72 2070 6f77 ur on vendor pow │ │ │ │ -00000a30: 6572 2d6f 6e20 6b65 7973 0a2a 2049 6d61 er-on keys.* Ima │ │ │ │ -00000a40: 6765 733a 3a20 2020 2020 2020 2020 2020 ges:: │ │ │ │ -00000a50: 2020 2020 2020 2020 2020 2047 5255 4220 GRUB │ │ │ │ -00000a60: 696d 6167 6520 6669 6c65 730a 2a20 436f image files.* Co │ │ │ │ -00000a70: 7265 2069 6d61 6765 2073 697a 6520 6c69 re image size li │ │ │ │ -00000a80: 6d69 7461 7469 6f6e 3a3a 2020 4752 5542 mitation:: GRUB │ │ │ │ -00000a90: 2069 6d61 6765 2066 696c 6573 2073 697a image files siz │ │ │ │ -00000aa0: 6520 6c69 6d69 7461 7469 6f6e 730a 2a20 e limitations.* │ │ │ │ -00000ab0: 4669 6c65 7379 7374 656d 3a3a 2020 2020 Filesystem:: │ │ │ │ -00000ac0: 2020 2020 2020 2020 2020 2020 2020 4669 Fi │ │ │ │ -00000ad0: 6c65 7379 7374 656d 2073 796e 7461 7820 lesystem syntax │ │ │ │ -00000ae0: 616e 6420 7365 6d61 6e74 6963 730a 2a20 and semantics.* │ │ │ │ -00000af0: 496e 7465 7266 6163 653a 3a20 2020 2020 Interface:: │ │ │ │ -00000b00: 2020 2020 2020 2020 2020 2020 2020 5468 Th │ │ │ │ -00000b10: 6520 6d65 6e75 2061 6e64 2074 6865 2063 e menu and the c │ │ │ │ -00000b20: 6f6d 6d61 6e64 2d6c 696e 650a 2a20 456e ommand-line.* En │ │ │ │ -00000b30: 7669 726f 6e6d 656e 743a 3a20 2020 2020 vironment:: │ │ │ │ -00000b40: 2020 2020 2020 2020 2020 2020 4752 5542 GRUB │ │ │ │ -00000b50: 2065 6e76 6972 6f6e 6d65 6e74 2076 6172 environment var │ │ │ │ -00000b60: 6961 626c 6573 0a2a 2043 6f6d 6d61 6e64 iables.* Command │ │ │ │ -00000b70: 733a 3a20 2020 2020 2020 2020 2020 2020 s:: │ │ │ │ -00000b80: 2020 2020 2020 2054 6865 206c 6973 7420 The list │ │ │ │ -00000b90: 6f66 2061 7661 696c 6162 6c65 2062 7569 of available bui │ │ │ │ -00000ba0: 6c74 696e 2063 6f6d 6d61 6e64 730a 2a20 ltin commands.* │ │ │ │ -00000bb0: 496e 7465 726e 6174 696f 6e61 6c69 7361 Internationalisa │ │ │ │ -00000bc0: 7469 6f6e 3a3a 2020 2020 2020 2020 546f tion:: To │ │ │ │ -00000bd0: 7069 6373 2072 656c 6174 696e 6720 746f pics relating to │ │ │ │ -00000be0: 206c 616e 6775 6167 6520 7375 7070 6f72 language suppor │ │ │ │ -00000bf0: 740a 2a20 5365 6375 7269 7479 3a3a 2020 t.* Security:: │ │ │ │ -00000c00: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00000c10: 2020 4175 7468 656e 7469 6361 7469 6f6e Authentication │ │ │ │ -00000c20: 2c20 6175 7468 6f72 6973 6174 696f 6e2c , authorisation, │ │ │ │ -00000c30: 2061 6e64 2073 6967 6e61 7475 7265 730a and signatures. │ │ │ │ -00000c40: 2a20 506c 6174 666f 726d 206c 696d 6974 * Platform limit │ │ │ │ -00000c50: 6174 696f 6e73 3a3a 2020 2020 2020 2020 ations:: │ │ │ │ -00000c60: 5468 6520 6c69 7374 206f 6620 706c 6174 The list of plat │ │ │ │ -00000c70: 666f 726d 2d73 7065 6369 6669 6320 6c69 form-specific li │ │ │ │ -00000c80: 6d69 7461 7469 6f6e 730a 2a20 506c 6174 mitations.* Plat │ │ │ │ -00000c90: 666f 726d 2d73 7065 6369 6669 6320 6f70 form-specific op │ │ │ │ -00000ca0: 6572 6174 696f 6e73 3a3a 2050 6c61 7466 erations:: Platf │ │ │ │ -00000cb0: 6f72 6d2d 7370 6563 6966 6963 206f 7065 orm-specific ope │ │ │ │ -00000cc0: 7261 7469 6f6e 730a 2a20 5375 7070 6f72 rations.* Suppor │ │ │ │ -00000cd0: 7465 6420 6b65 726e 656c 733a 3a20 2020 ted kernels:: │ │ │ │ -00000ce0: 2020 2020 2020 2020 5468 6520 6c69 7374 The list │ │ │ │ -00000cf0: 206f 6620 7375 7070 6f72 7465 6420 6b65 of supported ke │ │ │ │ -00000d00: 726e 656c 730a 2a20 5472 6f75 626c 6573 rnels.* Troubles │ │ │ │ -00000d10: 686f 6f74 696e 673a 3a20 2020 2020 2020 hooting:: │ │ │ │ -00000d20: 2020 2020 2020 4572 726f 7220 6d65 7373 Error mess │ │ │ │ -00000d30: 6167 6573 2070 726f 6475 6365 6420 6279 ages produced by │ │ │ │ -00000d40: 2047 5255 420a 2a20 496e 766f 6b69 6e67 GRUB.* Invoking │ │ │ │ -00000d50: 2067 7275 622d 696e 7374 616c 6c3a 3a20 grub-install:: │ │ │ │ -00000d60: 2020 2020 2020 486f 7720 746f 2075 7365 How to use │ │ │ │ -00000d70: 2074 6865 2047 5255 4220 696e 7374 616c the GRUB instal │ │ │ │ -00000d80: 6c65 720a 2a20 496e 766f 6b69 6e67 2067 ler.* Invoking g │ │ │ │ -00000d90: 7275 622d 6d6b 636f 6e66 6967 3a3a 2020 rub-mkconfig:: │ │ │ │ -00000da0: 2020 2020 4765 6e65 7261 7465 2061 2047 Generate a G │ │ │ │ -00000db0: 5255 4220 636f 6e66 6967 7572 6174 696f RUB configuratio │ │ │ │ -00000dc0: 6e20 6669 6c65 0a2a 2049 6e76 6f6b 696e n file.* Invokin │ │ │ │ -00000dd0: 6720 6772 7562 2d6d 6b70 6173 7377 642d g grub-mkpasswd- │ │ │ │ -00000de0: 7062 6b64 6632 3a3a 0a20 2020 2020 2020 pbkdf2::. │ │ │ │ +00000070: 3320 4f63 746f 6265 7220 3230 3231 292e 3 October 2021). │ │ │ │ +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 342e ts version 2.04. │ │ │ │ +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 3034 2c20 (version 2.04, │ │ │ │ +000005d0: 3320 4f63 746f 6265 7220 3230 3231 292e 3 October 2021). │ │ │ │ +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 ::. │ │ │ │ +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. │ │ │ │ +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::. │ │ │ │ 00000df0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00000e00: 2020 2020 2020 2020 2047 656e 6572 6174 Generat │ │ │ │ -00000e10: 6520 4752 5542 2070 6173 7377 6f72 6420 e GRUB password │ │ │ │ -00000e20: 6861 7368 6573 0a2a 2049 6e76 6f6b 696e hashes.* Invokin │ │ │ │ -00000e30: 6720 6772 7562 2d6d 6b72 656c 7061 7468 g grub-mkrelpath │ │ │ │ -00000e40: 3a3a 2020 2020 204d 616b 6520 7379 7374 :: Make syst │ │ │ │ -00000e50: 656d 2070 6174 6820 7265 6c61 7469 7665 em path relative │ │ │ │ -00000e60: 2074 6f20 6974 7320 726f 6f74 0a2a 2049 to its root.* I │ │ │ │ -00000e70: 6e76 6f6b 696e 6720 6772 7562 2d6d 6b72 nvoking grub-mkr │ │ │ │ -00000e80: 6573 6375 653a 3a20 2020 2020 204d 616b escue:: Mak │ │ │ │ -00000e90: 6520 6120 4752 5542 2072 6573 6375 6520 e a GRUB rescue │ │ │ │ -00000ea0: 696d 6167 650a 2a20 496e 766f 6b69 6e67 image.* Invoking │ │ │ │ -00000eb0: 2067 7275 622d 6d6f 756e 743a 3a20 2020 grub-mount:: │ │ │ │ -00000ec0: 2020 2020 2020 4d6f 756e 7420 6120 6669 Mount a fi │ │ │ │ -00000ed0: 6c65 2073 7973 7465 6d20 7573 696e 6720 le system using │ │ │ │ -00000ee0: 4752 5542 0a2a 2049 6e76 6f6b 696e 6720 GRUB.* Invoking │ │ │ │ -00000ef0: 6772 7562 2d70 726f 6265 3a3a 2020 2020 grub-probe:: │ │ │ │ -00000f00: 2020 2020 2050 726f 6265 2064 6576 6963 Probe devic │ │ │ │ -00000f10: 6520 696e 666f 726d 6174 696f 6e20 666f e information fo │ │ │ │ -00000f20: 7220 4752 5542 0a2a 2049 6e76 6f6b 696e r GRUB.* Invokin │ │ │ │ -00000f30: 6720 6772 7562 2d73 6372 6970 742d 6368 g grub-script-ch │ │ │ │ -00000f40: 6563 6b3a 3a20 2043 6865 636b 2047 5255 eck:: Check GRU │ │ │ │ -00000f50: 4220 7363 7269 7074 2066 696c 6520 666f B script file fo │ │ │ │ -00000f60: 7220 7379 6e74 6178 2065 7272 6f72 730a r syntax errors. │ │ │ │ -00000f70: 2a20 4f62 7461 696e 696e 6720 616e 6420 * Obtaining and │ │ │ │ -00000f80: 4275 696c 6469 6e67 2047 5255 423a 3a20 Building GRUB:: │ │ │ │ -00000f90: 486f 7720 746f 206f 6274 6169 6e20 616e How to obtain an │ │ │ │ -00000fa0: 6420 6275 696c 6420 4752 5542 0a2a 2052 d build GRUB.* R │ │ │ │ -00000fb0: 6570 6f72 7469 6e67 2062 7567 733a 3a20 eporting bugs:: │ │ │ │ -00000fc0: 2020 2020 2020 2020 2020 2020 2057 6865 Whe │ │ │ │ -00000fd0: 7265 2079 6f75 2073 686f 756c 6420 7365 re you should se │ │ │ │ -00000fe0: 6e64 2061 2062 7567 2072 6570 6f72 740a nd a bug report. │ │ │ │ -00000ff0: 2a20 4675 7475 7265 3a3a 2020 2020 2020 * Future:: │ │ │ │ +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:: │ │ │ │ 00001000: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00001010: 536f 6d65 2066 7574 7572 6520 706c 616e Some future plan │ │ │ │ -00001020: 7320 6f6e 2047 5255 420a 2a20 436f 7079 s on GRUB.* Copy │ │ │ │ -00001030: 696e 6720 5468 6973 204d 616e 7561 6c3a ing This Manual: │ │ │ │ -00001040: 3a20 2020 2020 2020 2020 436f 7079 696e : Copyin │ │ │ │ -00001050: 6720 5468 6973 204d 616e 7561 6c0a 2a20 g This Manual.* │ │ │ │ -00001060: 496e 6465 783a 3a0a 0a1f 0a46 696c 653a Index::....File: │ │ │ │ -00001070: 2067 7275 622e 696e 666f 2c20 204e 6f64 grub.info, Nod │ │ │ │ -00001080: 653a 2049 6e74 726f 6475 6374 696f 6e2c e: Introduction, │ │ │ │ -00001090: 2020 4e65 7874 3a20 4e61 6d69 6e67 2063 Next: Naming c │ │ │ │ -000010a0: 6f6e 7665 6e74 696f 6e2c 2020 5072 6576 onvention, Prev │ │ │ │ -000010b0: 3a20 546f 702c 2020 5570 3a20 546f 700a : Top, Up: Top. │ │ │ │ -000010c0: 0a31 2049 6e74 726f 6475 6374 696f 6e20 .1 Introduction │ │ │ │ -000010d0: 746f 2047 5255 420a 2a2a 2a2a 2a2a 2a2a to GRUB.******** │ │ │ │ -000010e0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 0a0a **************.. │ │ │ │ -000010f0: 2a20 4d65 6e75 3a0a 0a2a 204f 7665 7276 * Menu:..* Overv │ │ │ │ -00001100: 6965 773a 3a20 2020 2020 2020 2020 2020 iew:: │ │ │ │ -00001110: 2020 2020 2020 2020 2057 6861 7420 6578 What ex │ │ │ │ -00001120: 6163 746c 7920 4752 5542 2069 7320 616e actly GRUB is an │ │ │ │ -00001130: 6420 686f 7720 746f 2075 7365 2069 740a d how to use it. │ │ │ │ -00001140: 2a20 4869 7374 6f72 793a 3a20 2020 2020 * History:: │ │ │ │ +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.**** │ │ │ │ +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: 4672 6f6d 206d 6167 676f 7420 746f 2068 From maggot to h │ │ │ │ -00001170: 6f75 7365 2066 6c79 0a2a 2043 6861 6e67 ouse fly.* Chang │ │ │ │ -00001180: 6573 2066 726f 6d20 4752 5542 204c 6567 es from GRUB Leg │ │ │ │ -00001190: 6163 793a 3a20 2020 2044 6966 6665 7265 acy:: Differe │ │ │ │ -000011a0: 6e63 6573 2066 726f 6d20 7072 6576 696f nces from previo │ │ │ │ -000011b0: 7573 2076 6572 7369 6f6e 730a 2a20 4665 us versions.* Fe │ │ │ │ -000011c0: 6174 7572 6573 3a3a 2020 2020 2020 2020 atures:: │ │ │ │ -000011d0: 2020 2020 2020 2020 2020 2020 4752 5542 GRUB │ │ │ │ -000011e0: 2066 6561 7475 7265 730a 2a20 526f 6c65 features.* Role │ │ │ │ -000011f0: 206f 6620 6120 626f 6f74 206c 6f61 6465 of a boot loade │ │ │ │ -00001200: 723a 3a20 2020 2020 2020 5468 6520 726f r:: The ro │ │ │ │ -00001210: 6c65 206f 6620 6120 626f 6f74 206c 6f61 le of a boot loa │ │ │ │ -00001220: 6465 720a 0a1f 0a46 696c 653a 2067 7275 der....File: gru │ │ │ │ -00001230: 622e 696e 666f 2c20 204e 6f64 653a 204f b.info, Node: O │ │ │ │ -00001240: 7665 7276 6965 772c 2020 4e65 7874 3a20 verview, Next: │ │ │ │ -00001250: 4869 7374 6f72 792c 2020 5570 3a20 496e History, Up: In │ │ │ │ -00001260: 7472 6f64 7563 7469 6f6e 0a0a 312e 3120 troduction..1.1 │ │ │ │ -00001270: 4f76 6572 7669 6577 0a3d 3d3d 3d3d 3d3d Overview.======= │ │ │ │ -00001280: 3d3d 3d3d 3d0a 0a42 7269 6566 6c79 2c20 =====..Briefly, │ │ │ │ -00001290: 6120 2262 6f6f 7420 6c6f 6164 6572 2220 a "boot loader" │ │ │ │ -000012a0: 6973 2074 6865 2066 6972 7374 2073 6f66 is the first sof │ │ │ │ -000012b0: 7477 6172 6520 7072 6f67 7261 6d20 7468 tware program th │ │ │ │ -000012c0: 6174 2072 756e 7320 7768 656e 2061 0a63 at runs when a.c │ │ │ │ -000012d0: 6f6d 7075 7465 7220 7374 6172 7473 2e20 omputer starts. │ │ │ │ -000012e0: 2049 7420 6973 2072 6573 706f 6e73 6962 It is responsib │ │ │ │ -000012f0: 6c65 2066 6f72 206c 6f61 6469 6e67 2061 le for loading a │ │ │ │ -00001300: 6e64 2074 7261 6e73 6665 7272 696e 6720 nd transferring │ │ │ │ -00001310: 636f 6e74 726f 6c0a 746f 2061 6e20 6f70 control.to an op │ │ │ │ -00001320: 6572 6174 696e 6720 7379 7374 656d 2022 erating system " │ │ │ │ -00001330: 6b65 726e 656c 2220 736f 6674 7761 7265 kernel" software │ │ │ │ -00001340: 2028 7375 6368 2061 7320 4c69 6e75 7820 (such as Linux │ │ │ │ -00001350: 6f72 2047 4e55 204d 6163 6829 2e0a 5468 or GNU Mach)..Th │ │ │ │ -00001360: 6520 6b65 726e 656c 2c20 696e 2074 7572 e kernel, in tur │ │ │ │ -00001370: 6e2c 2069 6e69 7469 616c 697a 6573 2074 n, initializes t │ │ │ │ -00001380: 6865 2072 6573 7420 6f66 2074 6865 206f he rest of the o │ │ │ │ -00001390: 7065 7261 7469 6e67 2073 7973 7465 6d20 perating system │ │ │ │ -000013a0: 2865 2e67 2e0a 6120 474e 5520 7379 7374 (e.g..a GNU syst │ │ │ │ -000013b0: 656d 292e 0a0a 2020 2047 4e55 2047 5255 em)... GNU GRU │ │ │ │ -000013c0: 4220 6973 2061 2076 6572 7920 706f 7765 B is a very powe │ │ │ │ -000013d0: 7266 756c 2062 6f6f 7420 6c6f 6164 6572 rful boot loader │ │ │ │ -000013e0: 2c20 7768 6963 6820 6361 6e20 6c6f 6164 , which can load │ │ │ │ -000013f0: 2061 2077 6964 650a 7661 7269 6574 7920 a wide.variety │ │ │ │ -00001400: 6f66 2066 7265 6520 6f70 6572 6174 696e of free operatin │ │ │ │ -00001410: 6720 7379 7374 656d 732c 2061 7320 7765 g systems, as we │ │ │ │ -00001420: 6c6c 2061 7320 7072 6f70 7269 6574 6172 ll as proprietar │ │ │ │ -00001430: 7920 6f70 6572 6174 696e 670a 7379 7374 y operating.syst │ │ │ │ -00001440: 656d 7320 7769 7468 2063 6861 696e 2d6c ems with chain-l │ │ │ │ -00001450: 6f61 6469 6e67 2831 2920 282a 6e6f 7465 oading(1) (*note │ │ │ │ -00001460: 204f 7665 7276 6965 772d 466f 6f74 6e6f Overview-Footno │ │ │ │ -00001470: 7465 2d31 3a3a 292e 2020 4752 5542 2069 te-1::). GRUB i │ │ │ │ -00001480: 730a 6465 7369 676e 6564 2074 6f20 6164 s.designed to ad │ │ │ │ -00001490: 6472 6573 7320 7468 6520 636f 6d70 6c65 dress the comple │ │ │ │ -000014a0: 7869 7479 206f 6620 626f 6f74 696e 6720 xity of booting │ │ │ │ -000014b0: 6120 7065 7273 6f6e 616c 2063 6f6d 7075 a personal compu │ │ │ │ -000014c0: 7465 723b 2062 6f74 680a 7468 6520 7072 ter; both.the pr │ │ │ │ -000014d0: 6f67 7261 6d20 616e 6420 7468 6973 206d ogram and this m │ │ │ │ -000014e0: 616e 7561 6c20 6172 6520 7469 6768 746c anual are tightl │ │ │ │ -000014f0: 7920 626f 756e 6420 746f 2074 6861 7420 y bound to that │ │ │ │ -00001500: 636f 6d70 7574 6572 2070 6c61 7466 6f72 computer platfor │ │ │ │ -00001510: 6d2c 0a61 6c74 686f 7567 6820 706f 7274 m,.although port │ │ │ │ -00001520: 696e 6720 746f 206f 7468 6572 2070 6c61 ing to other pla │ │ │ │ -00001530: 7466 6f72 6d73 206d 6179 2062 6520 6164 tforms may be ad │ │ │ │ -00001540: 6472 6573 7365 6420 696e 2074 6865 2066 dressed in the f │ │ │ │ -00001550: 7574 7572 652e 0a0a 2020 204f 6e65 206f uture... One o │ │ │ │ -00001560: 6620 7468 6520 696d 706f 7274 616e 7420 f the important │ │ │ │ -00001570: 6665 6174 7572 6573 2069 6e20 4752 5542 features in GRUB │ │ │ │ -00001580: 2069 7320 666c 6578 6962 696c 6974 793b is flexibility; │ │ │ │ -00001590: 2047 5255 420a 756e 6465 7273 7461 6e64 GRUB.understand │ │ │ │ -000015a0: 7320 6669 6c65 7379 7374 656d 7320 616e s filesystems an │ │ │ │ -000015b0: 6420 6b65 726e 656c 2065 7865 6375 7461 d kernel executa │ │ │ │ -000015c0: 626c 6520 666f 726d 6174 732c 2073 6f20 ble formats, so │ │ │ │ -000015d0: 796f 7520 6361 6e20 6c6f 6164 0a61 6e20 you can load.an │ │ │ │ -000015e0: 6172 6269 7472 6172 7920 6f70 6572 6174 arbitrary operat │ │ │ │ -000015f0: 696e 6720 7379 7374 656d 2074 6865 2077 ing system the w │ │ │ │ -00001600: 6179 2079 6f75 206c 696b 652c 2077 6974 ay you like, wit │ │ │ │ -00001610: 686f 7574 2072 6563 6f72 6469 6e67 2074 hout recording t │ │ │ │ -00001620: 6865 0a70 6879 7369 6361 6c20 706f 7369 he.physical posi │ │ │ │ -00001630: 7469 6f6e 206f 6620 796f 7572 206b 6572 tion of your ker │ │ │ │ -00001640: 6e65 6c20 6f6e 2074 6865 2064 6973 6b2e nel on the disk. │ │ │ │ -00001650: 2020 5468 7573 2079 6f75 2063 616e 206c Thus you can l │ │ │ │ -00001660: 6f61 6420 7468 650a 6b65 726e 656c 206a oad the.kernel j │ │ │ │ -00001670: 7573 7420 6279 2073 7065 6369 6679 696e ust by specifyin │ │ │ │ -00001680: 6720 6974 7320 6669 6c65 206e 616d 6520 g its file name │ │ │ │ -00001690: 616e 6420 7468 6520 6472 6976 6520 616e and the drive an │ │ │ │ -000016a0: 6420 7061 7274 6974 696f 6e0a 7768 6572 d partition.wher │ │ │ │ -000016b0: 6520 7468 6520 6b65 726e 656c 2072 6573 e the kernel res │ │ │ │ -000016c0: 6964 6573 2e0a 0a20 2020 5768 656e 2062 ides... When b │ │ │ │ -000016d0: 6f6f 7469 6e67 2077 6974 6820 4752 5542 ooting with GRUB │ │ │ │ -000016e0: 2c20 796f 7520 6361 6e20 7573 6520 6569 , you can use ei │ │ │ │ -000016f0: 7468 6572 2061 2063 6f6d 6d61 6e64 2d6c ther a command-l │ │ │ │ -00001700: 696e 6520 696e 7465 7266 6163 650a 282a ine interface.(* │ │ │ │ -00001710: 6e6f 7465 2043 6f6d 6d61 6e64 2d6c 696e note Command-lin │ │ │ │ -00001720: 6520 696e 7465 7266 6163 653a 3a29 2c20 e interface::), │ │ │ │ -00001730: 6f72 2061 206d 656e 7520 696e 7465 7266 or a menu interf │ │ │ │ -00001740: 6163 6520 282a 6e6f 7465 204d 656e 750a ace (*note Menu. │ │ │ │ -00001750: 696e 7465 7266 6163 653a 3a29 2e20 2055 interface::). U │ │ │ │ -00001760: 7369 6e67 2074 6865 2063 6f6d 6d61 6e64 sing the command │ │ │ │ -00001770: 2d6c 696e 6520 696e 7465 7266 6163 652c -line interface, │ │ │ │ -00001780: 2079 6f75 2074 7970 6520 7468 6520 6472 you type the dr │ │ │ │ -00001790: 6976 650a 7370 6563 6966 6963 6174 696f ive.specificatio │ │ │ │ -000017a0: 6e20 616e 6420 6669 6c65 206e 616d 6520 n and file name │ │ │ │ -000017b0: 6f66 2074 6865 206b 6572 6e65 6c20 6d61 of the kernel ma │ │ │ │ -000017c0: 6e75 616c 6c79 2e20 2049 6e20 7468 6520 nually. In the │ │ │ │ -000017d0: 6d65 6e75 0a69 6e74 6572 6661 6365 2c20 menu.interface, │ │ │ │ -000017e0: 796f 7520 6a75 7374 2073 656c 6563 7420 you just select │ │ │ │ -000017f0: 616e 204f 5320 7573 696e 6720 7468 6520 an OS using the │ │ │ │ -00001800: 6172 726f 7720 6b65 7973 2e20 2054 6865 arrow keys. The │ │ │ │ -00001810: 206d 656e 7520 6973 0a62 6173 6564 206f menu is.based o │ │ │ │ -00001820: 6e20 6120 636f 6e66 6967 7572 6174 696f n a configuratio │ │ │ │ -00001830: 6e20 6669 6c65 2077 6869 6368 2079 6f75 n file which you │ │ │ │ -00001840: 2070 7265 7061 7265 2062 6566 6f72 6568 prepare beforeh │ │ │ │ -00001850: 616e 6420 282a 6e6f 7465 0a43 6f6e 6669 and (*note.Confi │ │ │ │ -00001860: 6775 7261 7469 6f6e 3a3a 292e 2020 5768 guration::). Wh │ │ │ │ -00001870: 696c 6520 696e 2074 6865 206d 656e 752c ile in the menu, │ │ │ │ -00001880: 2079 6f75 2063 616e 2073 7769 7463 6820 you can switch │ │ │ │ -00001890: 746f 2074 6865 2063 6f6d 6d61 6e64 2d6c to the command-l │ │ │ │ -000018a0: 696e 650a 6d6f 6465 2c20 616e 6420 7669 ine.mode, and vi │ │ │ │ -000018b0: 6365 2d76 6572 7361 2e20 2059 6f75 2063 ce-versa. You c │ │ │ │ -000018c0: 616e 2065 7665 6e20 6564 6974 206d 656e an even edit men │ │ │ │ -000018d0: 7520 656e 7472 6965 7320 6265 666f 7265 u entries before │ │ │ │ -000018e0: 2075 7369 6e67 2074 6865 6d2e 0a0a 2020 using them... │ │ │ │ -000018f0: 2049 6e20 7468 6520 666f 6c6c 6f77 696e In the followin │ │ │ │ -00001900: 6720 6368 6170 7465 7273 2c20 796f 7520 g chapters, you │ │ │ │ -00001910: 7769 6c6c 206c 6561 726e 2068 6f77 2074 will learn how t │ │ │ │ -00001920: 6f20 7370 6563 6966 7920 6120 6472 6976 o specify a driv │ │ │ │ -00001930: 652c 2061 0a70 6172 7469 7469 6f6e 2c20 e, a.partition, │ │ │ │ -00001940: 616e 6420 6120 6669 6c65 206e 616d 6520 and a file name │ │ │ │ -00001950: 282a 6e6f 7465 204e 616d 696e 6720 636f (*note Naming co │ │ │ │ -00001960: 6e76 656e 7469 6f6e 3a3a 2920 746f 2047 nvention::) to G │ │ │ │ -00001970: 5255 422c 2068 6f77 2074 6f0a 696e 7374 RUB, how to.inst │ │ │ │ -00001980: 616c 6c20 4752 5542 206f 6e20 796f 7572 all GRUB on your │ │ │ │ -00001990: 2064 7269 7665 2028 2a6e 6f74 6520 496e drive (*note In │ │ │ │ -000019a0: 7374 616c 6c61 7469 6f6e 3a3a 292c 2061 stallation::), a │ │ │ │ -000019b0: 6e64 2068 6f77 2074 6f20 626f 6f74 2079 nd how to boot y │ │ │ │ -000019c0: 6f75 720a 4f53 6573 2028 2a6e 6f74 6520 our.OSes (*note │ │ │ │ -000019d0: 426f 6f74 696e 673a 3a29 2c20 7374 6570 Booting::), step │ │ │ │ -000019e0: 2062 7920 7374 6570 2e0a 0a1f 0a46 696c by step.....Fil │ │ │ │ -000019f0: 653a 2067 7275 622e 696e 666f 2c20 204e e: grub.info, N │ │ │ │ -00001a00: 6f64 653a 204f 7665 7276 6965 772d 466f ode: Overview-Fo │ │ │ │ -00001a10: 6f74 6e6f 7465 732c 2020 5570 3a20 4f76 otnotes, Up: Ov │ │ │ │ -00001a20: 6572 7669 6577 0a0a 2020 2028 3129 2022 erview.. (1) " │ │ │ │ -00001a30: 6368 6169 6e2d 6c6f 6164 2220 6973 2074 chain-load" is t │ │ │ │ -00001a40: 6865 206d 6563 6861 6e69 736d 2066 6f72 he mechanism for │ │ │ │ -00001a50: 206c 6f61 6469 6e67 2075 6e73 7570 706f loading unsuppo │ │ │ │ -00001a60: 7274 6564 206f 7065 7261 7469 6e67 0a73 rted operating.s │ │ │ │ -00001a70: 7973 7465 6d73 2062 7920 6c6f 6164 696e ystems by loadin │ │ │ │ -00001a80: 6720 616e 6f74 6865 7220 626f 6f74 206c g another boot l │ │ │ │ -00001a90: 6f61 6465 722e 2020 4974 2069 7320 7479 oader. It is ty │ │ │ │ -00001aa0: 7069 6361 6c6c 7920 7573 6564 2066 6f72 pically used for │ │ │ │ -00001ab0: 0a6c 6f61 6469 6e67 2044 4f53 206f 7220 .loading DOS or │ │ │ │ -00001ac0: 5769 6e64 6f77 732e 0a0a 1f0a 4669 6c65 Windows.....File │ │ │ │ -00001ad0: 3a20 6772 7562 2e69 6e66 6f2c 2020 4e6f : grub.info, No │ │ │ │ -00001ae0: 6465 3a20 4869 7374 6f72 792c 2020 4e65 de: History, Ne │ │ │ │ -00001af0: 7874 3a20 4368 616e 6765 7320 6672 6f6d xt: Changes from │ │ │ │ -00001b00: 2047 5255 4220 4c65 6761 6379 2c20 2050 GRUB Legacy, P │ │ │ │ -00001b10: 7265 763a 204f 7665 7276 6965 772c 2020 rev: Overview, │ │ │ │ -00001b20: 5570 3a20 496e 7472 6f64 7563 7469 6f6e Up: Introduction │ │ │ │ -00001b30: 0a0a 312e 3220 4869 7374 6f72 7920 6f66 ..1.2 History of │ │ │ │ -00001b40: 2047 5255 420a 3d3d 3d3d 3d3d 3d3d 3d3d GRUB.========== │ │ │ │ -00001b50: 3d3d 3d3d 3d3d 3d3d 3d0a 0a47 5255 4220 =========..GRUB │ │ │ │ -00001b60: 6f72 6967 696e 6174 6564 2069 6e20 3139 originated in 19 │ │ │ │ -00001b70: 3935 2077 6865 6e20 4572 6963 6820 426f 95 when Erich Bo │ │ │ │ -00001b80: 6c65 796e 2077 6173 2074 7279 696e 6720 leyn was trying │ │ │ │ -00001b90: 746f 2062 6f6f 7420 7468 6520 474e 550a to boot the GNU. │ │ │ │ -00001ba0: 4875 7264 2077 6974 6820 7468 6520 556e Hurd with the Un │ │ │ │ -00001bb0: 6976 6572 7369 7479 206f 6620 5574 6168 iversity of Utah │ │ │ │ -00001bc0: 2773 204d 6163 6820 3420 6d69 6372 6f6b 's Mach 4 microk │ │ │ │ -00001bd0: 6572 6e65 6c20 286e 6f77 206b 6e6f 776e ernel (now known │ │ │ │ -00001be0: 2061 7320 474e 550a 4d61 6368 292e 2020 as GNU.Mach). │ │ │ │ -00001bf0: 4572 6963 6820 616e 6420 4272 6961 6e20 Erich and Brian │ │ │ │ -00001c00: 466f 7264 2064 6573 6967 6e65 6420 7468 Ford designed th │ │ │ │ -00001c10: 6520 4d75 6c74 6962 6f6f 7420 5370 6563 e Multiboot Spec │ │ │ │ -00001c20: 6966 6963 6174 696f 6e20 282a 6e6f 7465 ification (*note │ │ │ │ -00001c30: 0a4d 756c 7469 626f 6f74 2053 7065 6369 .Multiboot Speci │ │ │ │ -00001c40: 6669 6361 7469 6f6e 3a20 286d 756c 7469 fication: (multi │ │ │ │ -00001c50: 626f 6f74 2954 6f70 2e29 2c20 6265 6361 boot)Top.), beca │ │ │ │ -00001c60: 7573 6520 7468 6579 2077 6572 6520 6465 use they were de │ │ │ │ -00001c70: 7465 726d 696e 6564 0a6e 6f74 2074 6f20 termined.not to │ │ │ │ -00001c80: 6164 6420 746f 2074 6865 206c 6172 6765 add to the large │ │ │ │ -00001c90: 206e 756d 6265 7220 6f66 206d 7574 7561 number of mutua │ │ │ │ -00001ca0: 6c6c 792d 696e 636f 6d70 6174 6962 6c65 lly-incompatible │ │ │ │ -00001cb0: 2050 4320 626f 6f74 206d 6574 686f 6473 PC boot methods │ │ │ │ -00001cc0: 2e0a 0a20 2020 4572 6963 6820 7468 656e ... Erich then │ │ │ │ -00001cd0: 2062 6567 616e 206d 6f64 6966 7969 6e67 began modifying │ │ │ │ -00001ce0: 2074 6865 2046 7265 6542 5344 2062 6f6f the FreeBSD boo │ │ │ │ -00001cf0: 7420 6c6f 6164 6572 2073 6f20 7468 6174 t loader so that │ │ │ │ -00001d00: 2069 7420 776f 756c 640a 756e 6465 7273 it would.unders │ │ │ │ -00001d10: 7461 6e64 204d 756c 7469 626f 6f74 2e20 tand Multiboot. │ │ │ │ -00001d20: 2048 6520 736f 6f6e 2072 6561 6c69 7a65 He soon realize │ │ │ │ -00001d30: 6420 7468 6174 2069 7420 776f 756c 6420 d that it would │ │ │ │ -00001d40: 6265 2061 206c 6f74 2065 6173 6965 7220 be a lot easier │ │ │ │ -00001d50: 746f 0a77 7269 7465 2068 6973 206f 776e to.write his own │ │ │ │ -00001d60: 2062 6f6f 7420 6c6f 6164 6572 2066 726f boot loader fro │ │ │ │ -00001d70: 6d20 7363 7261 7463 6820 7468 616e 2074 m scratch than t │ │ │ │ -00001d80: 6f20 6b65 6570 2077 6f72 6b69 6e67 206f o keep working o │ │ │ │ -00001d90: 6e20 7468 650a 4672 6565 4253 4420 626f n the.FreeBSD bo │ │ │ │ -00001da0: 6f74 206c 6f61 6465 722c 2061 6e64 2073 ot loader, and s │ │ │ │ -00001db0: 6f20 4752 5542 2077 6173 2062 6f72 6e2e o GRUB was born. │ │ │ │ -00001dc0: 0a0a 2020 2045 7269 6368 2061 6464 6564 .. Erich added │ │ │ │ -00001dd0: 206d 616e 7920 6665 6174 7572 6573 2074 many features t │ │ │ │ -00001de0: 6f20 4752 5542 2c20 6275 7420 6f74 6865 o GRUB, but othe │ │ │ │ -00001df0: 7220 7072 696f 7269 7469 6573 2070 7265 r priorities pre │ │ │ │ -00001e00: 7665 6e74 6564 2068 696d 0a66 726f 6d20 vented him.from │ │ │ │ -00001e10: 6b65 6570 696e 6720 7570 2077 6974 6820 keeping up with │ │ │ │ -00001e20: 7468 6520 6465 6d61 6e64 7320 6f66 2069 the demands of i │ │ │ │ -00001e30: 7473 2071 7569 636b 6c79 2d65 7870 616e ts quickly-expan │ │ │ │ -00001e40: 6469 6e67 2075 7365 7220 6261 7365 2e20 ding user base. │ │ │ │ -00001e50: 2049 6e0a 3139 3939 2c20 476f 7264 6f6e In.1999, Gordon │ │ │ │ -00001e60: 204d 6174 7a69 676b 6569 7420 616e 6420 Matzigkeit and │ │ │ │ -00001e70: 596f 7368 696e 6f72 6920 4b2e 204f 6b75 Yoshinori K. Oku │ │ │ │ -00001e80: 6a69 2061 646f 7074 6564 2047 5255 4220 ji adopted GRUB │ │ │ │ -00001e90: 6173 2061 6e0a 6f66 6669 6369 616c 2047 as an.official G │ │ │ │ -00001ea0: 4e55 2070 6163 6b61 6765 2c20 616e 6420 NU package, and │ │ │ │ -00001eb0: 6f70 656e 6564 2069 7473 2064 6576 656c opened its devel │ │ │ │ -00001ec0: 6f70 6d65 6e74 2062 7920 6d61 6b69 6e67 opment by making │ │ │ │ -00001ed0: 2074 6865 206c 6174 6573 740a 736f 7572 the latest.sour │ │ │ │ -00001ee0: 6365 7320 6176 6169 6c61 626c 6520 7669 ces available vi │ │ │ │ -00001ef0: 6120 616e 6f6e 796d 6f75 7320 4356 532e a anonymous CVS. │ │ │ │ -00001f00: 202a 4e6f 7465 204f 6274 6169 6e69 6e67 *Note Obtaining │ │ │ │ -00001f10: 2061 6e64 2042 7569 6c64 696e 670a 4752 and Building.GR │ │ │ │ -00001f20: 5542 3a3a 2c20 666f 7220 6d6f 7265 2069 UB::, for more i │ │ │ │ -00001f30: 6e66 6f72 6d61 7469 6f6e 2e0a 0a20 2020 nformation... │ │ │ │ -00001f40: 4f76 6572 2074 6865 206e 6578 7420 6665 Over the next fe │ │ │ │ -00001f50: 7720 7965 6172 732c 2047 5255 4220 7761 w years, GRUB wa │ │ │ │ -00001f60: 7320 6578 7465 6e64 6564 2074 6f20 6d65 s extended to me │ │ │ │ -00001f70: 6574 206d 616e 7920 6e65 6564 732c 2062 et many needs, b │ │ │ │ -00001f80: 7574 2069 740a 7175 6963 6b6c 7920 6265 ut it.quickly be │ │ │ │ -00001f90: 6361 6d65 2063 6c65 6172 2074 6861 7420 came clear that │ │ │ │ -00001fa0: 6974 7320 6465 7369 676e 2077 6173 206e its design was n │ │ │ │ -00001fb0: 6f74 206b 6565 7069 6e67 2075 7020 7769 ot keeping up wi │ │ │ │ -00001fc0: 7468 2074 6865 0a65 7874 656e 7369 6f6e th the.extension │ │ │ │ -00001fd0: 7320 6265 696e 6720 6d61 6465 2074 6f20 s being made to │ │ │ │ -00001fe0: 6974 2c20 616e 6420 7765 2072 6561 6368 it, and we reach │ │ │ │ -00001ff0: 6564 2074 6865 2070 6f69 6e74 2077 6865 ed the point whe │ │ │ │ -00002000: 7265 2069 7420 7761 7320 7665 7279 0a64 re it was very.d │ │ │ │ -00002010: 6966 6669 6375 6c74 2074 6f20 6d61 6b65 ifficult to make │ │ │ │ -00002020: 2061 6e79 2066 7572 7468 6572 2063 6861 any further cha │ │ │ │ -00002030: 6e67 6573 2077 6974 686f 7574 2062 7265 nges without bre │ │ │ │ -00002040: 616b 696e 6720 6578 6973 7469 6e67 0a66 aking existing.f │ │ │ │ -00002050: 6561 7475 7265 732e 2020 4172 6f75 6e64 eatures. Around │ │ │ │ -00002060: 2032 3030 322c 2059 6f73 6869 6e6f 7269 2002, Yoshinori │ │ │ │ -00002070: 204b 2e20 4f6b 756a 6920 7374 6172 7465 K. Okuji starte │ │ │ │ -00002080: 6420 776f 726b 206f 6e20 5055 5041 0a28 d work on PUPA.( │ │ │ │ -00002090: 5072 656c 696d 696e 6172 7920 556e 6976 Preliminary Univ │ │ │ │ -000020a0: 6572 7361 6c20 5072 6f67 7261 6d6d 696e ersal Programmin │ │ │ │ -000020b0: 6720 4172 6368 6974 6563 7475 7265 2066 g Architecture f │ │ │ │ -000020c0: 6f72 2047 4e55 2047 5255 4229 2c20 6169 or GNU GRUB), ai │ │ │ │ -000020d0: 6d69 6e67 2074 6f0a 7265 7772 6974 6520 ming to.rewrite │ │ │ │ -000020e0: 7468 6520 636f 7265 206f 6620 4752 5542 the core of GRUB │ │ │ │ -000020f0: 2074 6f20 6d61 6b65 2069 7420 636c 6561 to make it clea │ │ │ │ -00002100: 6e65 722c 2073 6166 6572 2c20 6d6f 7265 ner, safer, more │ │ │ │ -00002110: 2072 6f62 7573 742c 2061 6e64 0a6d 6f72 robust, and.mor │ │ │ │ -00002120: 6520 706f 7765 7266 756c 2e20 2050 5550 e powerful. PUP │ │ │ │ -00002130: 4120 7761 7320 6576 656e 7475 616c 6c79 A was eventually │ │ │ │ -00002140: 2072 656e 616d 6564 2074 6f20 4752 5542 renamed to GRUB │ │ │ │ -00002150: 2032 2c20 616e 6420 7468 6520 6f72 6967 2, and the orig │ │ │ │ -00002160: 696e 616c 0a76 6572 7369 6f6e 206f 6620 inal.version of │ │ │ │ -00002170: 4752 5542 2077 6173 2072 656e 616d 6564 GRUB was renamed │ │ │ │ -00002180: 2074 6f20 4752 5542 204c 6567 6163 792e to GRUB Legacy. │ │ │ │ -00002190: 2020 536d 616c 6c20 616d 6f75 6e74 7320 Small amounts │ │ │ │ -000021a0: 6f66 0a6d 6169 6e74 656e 616e 6365 2063 of.maintenance c │ │ │ │ -000021b0: 6f6e 7469 6e75 6564 2074 6f20 6265 2064 ontinued to be d │ │ │ │ -000021c0: 6f6e 6520 6f6e 2047 5255 4220 4c65 6761 one on GRUB Lega │ │ │ │ -000021d0: 6379 2c20 6275 7420 7468 6520 6c61 7374 cy, but the last │ │ │ │ -000021e0: 2072 656c 6561 7365 0a28 302e 3937 2920 release.(0.97) │ │ │ │ -000021f0: 7761 7320 6d61 6465 2069 6e20 3230 3035 was made in 2005 │ │ │ │ -00002200: 2061 6e64 2061 7420 7468 6520 7469 6d65 and at the time │ │ │ │ -00002210: 206f 6620 7772 6974 696e 6720 6974 2073 of writing it s │ │ │ │ -00002220: 6565 6d73 2075 6e6c 696b 656c 790a 7468 eems unlikely.th │ │ │ │ -00002230: 6174 2074 6865 7265 2077 696c 6c20 6265 at there will be │ │ │ │ -00002240: 2061 6e6f 7468 6572 2e0a 0a20 2020 4279 another... By │ │ │ │ -00002250: 2061 726f 756e 6420 3230 3037 2c20 474e around 2007, GN │ │ │ │ -00002260: 552f 4c69 6e75 7820 6469 7374 7269 6275 U/Linux distribu │ │ │ │ -00002270: 7469 6f6e 7320 7374 6172 7465 6420 746f tions started to │ │ │ │ -00002280: 2075 7365 2047 5255 4220 3220 746f 0a6c use GRUB 2 to.l │ │ │ │ -00002290: 696d 6974 6564 2065 7874 656e 7473 2c20 imited extents, │ │ │ │ -000022a0: 616e 6420 6279 2074 6865 2065 6e64 206f and by the end o │ │ │ │ -000022b0: 6620 3230 3039 206d 756c 7469 706c 6520 f 2009 multiple │ │ │ │ -000022c0: 6d61 6a6f 7220 6469 7374 7269 6275 7469 major distributi │ │ │ │ -000022d0: 6f6e 730a 7765 7265 2069 6e73 7461 6c6c ons.were install │ │ │ │ -000022e0: 696e 6720 6974 2062 7920 6465 6661 756c ing it by defaul │ │ │ │ -000022f0: 742e 0a0a 1f0a 4669 6c65 3a20 6772 7562 t.....File: grub │ │ │ │ -00002300: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 4368 .info, Node: Ch │ │ │ │ -00002310: 616e 6765 7320 6672 6f6d 2047 5255 4220 anges from GRUB │ │ │ │ -00002320: 4c65 6761 6379 2c20 204e 6578 743a 2046 Legacy, Next: F │ │ │ │ -00002330: 6561 7475 7265 732c 2020 5072 6576 3a20 eatures, Prev: │ │ │ │ -00002340: 4869 7374 6f72 792c 2020 5570 3a20 496e History, Up: In │ │ │ │ -00002350: 7472 6f64 7563 7469 6f6e 0a0a 312e 3320 troduction..1.3 │ │ │ │ -00002360: 4469 6666 6572 656e 6365 7320 6672 6f6d Differences from │ │ │ │ -00002370: 2070 7265 7669 6f75 7320 7665 7273 696f previous versio │ │ │ │ -00002380: 6e73 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ns.============= │ │ │ │ +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:: │ │ │ │ +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.========= │ │ │ │ 00002390: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ -000023a0: 3d3d 3d3d 3d3d 3d3d 3d0a 0a47 5255 4220 =========..GRUB │ │ │ │ -000023b0: 3220 6973 2061 2072 6577 7269 7465 206f 2 is a rewrite o │ │ │ │ -000023c0: 6620 4752 5542 2028 2a6e 6f74 6520 4869 f GRUB (*note Hi │ │ │ │ -000023d0: 7374 6f72 793a 3a29 2c20 616c 7468 6f75 story::), althou │ │ │ │ -000023e0: 6768 2069 7420 7368 6172 6573 206d 616e gh it shares man │ │ │ │ -000023f0: 790a 6368 6172 6163 7465 7269 7374 6963 y.characteristic │ │ │ │ -00002400: 7320 7769 7468 2074 6865 2070 7265 7669 s with the previ │ │ │ │ -00002410: 6f75 7320 7665 7273 696f 6e2c 206e 6f77 ous version, now │ │ │ │ -00002420: 206b 6e6f 776e 2061 7320 4752 5542 204c known as GRUB L │ │ │ │ -00002430: 6567 6163 792e 0a55 7365 7273 206f 6620 egacy..Users of │ │ │ │ -00002440: 4752 5542 204c 6567 6163 7920 6d61 7920 GRUB Legacy may │ │ │ │ -00002450: 6e65 6564 2073 6f6d 6520 6775 6964 616e need some guidan │ │ │ │ -00002460: 6365 2074 6f20 6669 6e64 2074 6865 6972 ce to find their │ │ │ │ -00002470: 2077 6179 2061 726f 756e 640a 7468 6973 way around.this │ │ │ │ -00002480: 206e 6577 2076 6572 7369 6f6e 2e0a 0a20 new version... │ │ │ │ -00002490: 2020 2a20 5468 6520 636f 6e66 6967 7572 * The configur │ │ │ │ -000024a0: 6174 696f 6e20 6669 6c65 2068 6173 2061 ation file has a │ │ │ │ -000024b0: 206e 6577 206e 616d 6520 2827 6772 7562 new name ('grub │ │ │ │ -000024c0: 2e63 6667 2720 7261 7468 6572 2074 6861 .cfg' rather tha │ │ │ │ -000024d0: 6e0a 2020 2020 2027 6d65 6e75 2e6c 7374 n. 'menu.lst │ │ │ │ -000024e0: 2720 6f72 2027 6772 7562 2e63 6f6e 6627 ' or 'grub.conf' │ │ │ │ -000024f0: 292c 206e 6577 2073 796e 7461 7820 282a ), new syntax (* │ │ │ │ -00002500: 6e6f 7465 2043 6f6e 6669 6775 7261 7469 note Configurati │ │ │ │ -00002510: 6f6e 3a3a 2920 616e 640a 2020 2020 206d on::) and. m │ │ │ │ -00002520: 616e 7920 6e65 7720 636f 6d6d 616e 6473 any new commands │ │ │ │ -00002530: 2028 2a6e 6f74 6520 436f 6d6d 616e 6473 (*note Commands │ │ │ │ -00002540: 3a3a 292e 2020 436f 6e66 6967 7572 6174 ::). Configurat │ │ │ │ -00002550: 696f 6e20 6361 6e6e 6f74 2062 650a 2020 ion cannot be. │ │ │ │ -00002560: 2020 2063 6f70 6965 6420 6f76 6572 2064 copied over d │ │ │ │ -00002570: 6972 6563 746c 792c 2061 6c74 686f 7567 irectly, althoug │ │ │ │ -00002580: 6820 6d6f 7374 2047 5255 4220 4c65 6761 h most GRUB Lega │ │ │ │ -00002590: 6379 2075 7365 7273 2073 686f 756c 6420 cy users should │ │ │ │ -000025a0: 6e6f 740a 2020 2020 2066 696e 6420 7468 not. find th │ │ │ │ -000025b0: 6520 7379 6e74 6178 2074 6f6f 2073 7572 e syntax too sur │ │ │ │ -000025c0: 7072 6973 696e 672e 0a0a 2020 202a 2027 prising... * ' │ │ │ │ -000025d0: 6772 7562 2e63 6667 2720 6973 2074 7970 grub.cfg' is typ │ │ │ │ -000025e0: 6963 616c 6c79 2061 7574 6f6d 6174 6963 ically automatic │ │ │ │ -000025f0: 616c 6c79 2067 656e 6572 6174 6564 2062 ally generated b │ │ │ │ -00002600: 7920 2767 7275 622d 6d6b 636f 6e66 6967 y 'grub-mkconfig │ │ │ │ -00002610: 270a 2020 2020 2028 2a6e 6f74 6520 5369 '. (*note Si │ │ │ │ -00002620: 6d70 6c65 2063 6f6e 6669 6775 7261 7469 mple configurati │ │ │ │ -00002630: 6f6e 3a3a 292e 2020 5468 6973 206d 616b on::). This mak │ │ │ │ -00002640: 6573 2069 7420 6561 7369 6572 2074 6f20 es it easier to │ │ │ │ -00002650: 6861 6e64 6c65 0a20 2020 2020 7665 7273 handle. vers │ │ │ │ -00002660: 696f 6e65 6420 6b65 726e 656c 2075 7067 ioned kernel upg │ │ │ │ -00002670: 7261 6465 732e 0a0a 2020 202a 2050 6172 rades... * Par │ │ │ │ -00002680: 7469 7469 6f6e 206e 756d 6265 7273 2069 tition numbers i │ │ │ │ -00002690: 6e20 4752 5542 2064 6576 6963 6520 6e61 n GRUB device na │ │ │ │ -000026a0: 6d65 7320 6e6f 7720 7374 6172 7420 6174 mes now start at │ │ │ │ -000026b0: 2031 2c20 6e6f 7420 3020 282a 6e6f 7465 1, not 0 (*note │ │ │ │ -000026c0: 0a20 2020 2020 4e61 6d69 6e67 2063 6f6e . Naming con │ │ │ │ -000026d0: 7665 6e74 696f 6e3a 3a29 2e0a 0a20 2020 vention::)... │ │ │ │ -000026e0: 2a20 5468 6520 636f 6e66 6967 7572 6174 * The configurat │ │ │ │ -000026f0: 696f 6e20 6669 6c65 2069 7320 6e6f 7720 ion file is now │ │ │ │ -00002700: 7772 6974 7465 6e20 696e 2073 6f6d 6574 written in somet │ │ │ │ -00002710: 6869 6e67 2063 6c6f 7365 7220 746f 2061 hing closer to a │ │ │ │ -00002720: 2066 756c 6c0a 2020 2020 2073 6372 6970 full. scrip │ │ │ │ -00002730: 7469 6e67 206c 616e 6775 6167 653a 2076 ting language: v │ │ │ │ -00002740: 6172 6961 626c 6573 2c20 636f 6e64 6974 ariables, condit │ │ │ │ -00002750: 696f 6e61 6c73 2c20 616e 6420 6c6f 6f70 ionals, and loop │ │ │ │ -00002760: 7320 6172 650a 2020 2020 2061 7661 696c s are. avail │ │ │ │ -00002770: 6162 6c65 2e0a 0a20 2020 2a20 4120 736d able... * A sm │ │ │ │ -00002780: 616c 6c20 616d 6f75 6e74 206f 6620 7065 all amount of pe │ │ │ │ -00002790: 7273 6973 7465 6e74 2073 746f 7261 6765 rsistent storage │ │ │ │ -000027a0: 2069 7320 6176 6169 6c61 626c 6520 6163 is available ac │ │ │ │ -000027b0: 726f 7373 2072 6562 6f6f 7473 2c0a 2020 ross reboots,. │ │ │ │ -000027c0: 2020 2075 7369 6e67 2074 6865 2027 7361 using the 'sa │ │ │ │ -000027d0: 7665 5f65 6e76 2720 616e 6420 276c 6f61 ve_env' and 'loa │ │ │ │ -000027e0: 645f 656e 7627 2063 6f6d 6d61 6e64 7320 d_env' commands │ │ │ │ -000027f0: 696e 2047 5255 4220 616e 6420 7468 650a in GRUB and the. │ │ │ │ -00002800: 2020 2020 2027 6772 7562 2d65 6469 7465 'grub-edite │ │ │ │ -00002810: 6e76 2720 7574 696c 6974 792e 2020 5468 nv' utility. Th │ │ │ │ -00002820: 6973 2069 7320 6e6f 7420 6176 6169 6c61 is is not availa │ │ │ │ -00002830: 626c 6520 696e 2061 6c6c 0a20 2020 2020 ble in all. │ │ │ │ -00002840: 636f 6e66 6967 7572 6174 696f 6e73 2028 configurations ( │ │ │ │ -00002850: 2a6e 6f74 6520 456e 7669 726f 6e6d 656e *note Environmen │ │ │ │ -00002860: 7420 626c 6f63 6b3a 3a29 2e0a 0a20 2020 t block::)... │ │ │ │ -00002870: 2a20 4752 5542 2032 2068 6173 206d 6f72 * GRUB 2 has mor │ │ │ │ -00002880: 6520 7265 6c69 6162 6c65 2077 6179 7320 e reliable ways │ │ │ │ -00002890: 746f 2066 696e 6420 6974 7320 6f77 6e20 to find its own │ │ │ │ -000028a0: 6669 6c65 7320 616e 6420 7468 6f73 6520 files and those │ │ │ │ -000028b0: 6f66 0a20 2020 2020 7461 7267 6574 206b of. target k │ │ │ │ -000028c0: 6572 6e65 6c73 206f 6e20 6d75 6c74 6970 ernels on multip │ │ │ │ -000028d0: 6c65 2d64 6973 6b20 7379 7374 656d 732c le-disk systems, │ │ │ │ -000028e0: 2061 6e64 2068 6173 2063 6f6d 6d61 6e64 and has command │ │ │ │ -000028f0: 7320 282a 6e6f 7465 0a20 2020 2020 7365 s (*note. se │ │ │ │ -00002900: 6172 6368 3a3a 2920 746f 2066 696e 6420 arch::) to find │ │ │ │ -00002910: 6465 7669 6365 7320 7573 696e 6720 6669 devices using fi │ │ │ │ -00002920: 6c65 2073 7973 7465 6d20 6c61 6265 6c73 le system labels │ │ │ │ -00002930: 206f 7220 556e 6976 6572 7361 6c6c 790a or Universally. │ │ │ │ -00002940: 2020 2020 2055 6e69 7175 6520 4964 656e Unique Iden │ │ │ │ -00002950: 7469 6669 6572 7320 2855 5549 4473 292e tifiers (UUIDs). │ │ │ │ -00002960: 0a0a 2020 202a 2047 5255 4220 3220 6973 .. * GRUB 2 is │ │ │ │ -00002970: 2061 7661 696c 6162 6c65 2066 6f72 2073 available for s │ │ │ │ -00002980: 6576 6572 616c 206f 7468 6572 2074 7970 everal other typ │ │ │ │ -00002990: 6573 206f 6620 7379 7374 656d 2069 6e20 es of system in │ │ │ │ -000029a0: 6164 6469 7469 6f6e 0a20 2020 2020 746f addition. to │ │ │ │ -000029b0: 2074 6865 2050 4320 4249 4f53 2073 7973 the PC BIOS sys │ │ │ │ -000029c0: 7465 6d73 2073 7570 706f 7274 6564 2062 tems supported b │ │ │ │ -000029d0: 7920 4752 5542 204c 6567 6163 793a 2050 y GRUB Legacy: P │ │ │ │ -000029e0: 4320 4546 492c 2050 430a 2020 2020 2063 C EFI, PC. c │ │ │ │ -000029f0: 6f72 6562 6f6f 742c 2050 6f77 6572 5043 oreboot, PowerPC │ │ │ │ -00002a00: 2c20 5350 4152 432c 2061 6e64 204d 4950 , SPARC, and MIP │ │ │ │ -00002a10: 5320 4c65 6d6f 7465 2059 6565 6c6f 6f6e S Lemote Yeeloon │ │ │ │ -00002a20: 6720 6172 6520 616c 6c0a 2020 2020 2073 g are all. s │ │ │ │ -00002a30: 7570 706f 7274 6564 2e0a 0a20 2020 2a20 upported... * │ │ │ │ -00002a40: 4d61 6e79 206d 6f72 6520 6669 6c65 2073 Many more file s │ │ │ │ -00002a50: 7973 7465 6d73 2061 7265 2073 7570 706f ystems are suppo │ │ │ │ -00002a60: 7274 6564 2c20 696e 636c 7564 696e 6720 rted, including │ │ │ │ -00002a70: 6275 7420 6e6f 7420 6c69 6d69 7465 6420 but not limited │ │ │ │ -00002a80: 746f 0a20 2020 2020 6578 7434 2c20 4846 to. ext4, HF │ │ │ │ -00002a90: 532b 2c20 616e 6420 4e54 4653 2e0a 0a20 S+, and NTFS... │ │ │ │ -00002aa0: 2020 2a20 4752 5542 2032 2063 616e 2072 * GRUB 2 can r │ │ │ │ -00002ab0: 6561 6420 6669 6c65 7320 6469 7265 6374 ead files direct │ │ │ │ -00002ac0: 6c79 2066 726f 6d20 4c56 4d20 616e 6420 ly from LVM and │ │ │ │ -00002ad0: 5241 4944 2064 6576 6963 6573 2e0a 0a20 RAID devices... │ │ │ │ -00002ae0: 2020 2a20 4120 6772 6170 6869 6361 6c20 * A graphical │ │ │ │ -00002af0: 7465 726d 696e 616c 2061 6e64 2061 2067 terminal and a g │ │ │ │ -00002b00: 7261 7068 6963 616c 206d 656e 7520 7379 raphical menu sy │ │ │ │ -00002b10: 7374 656d 2061 7265 2061 7661 696c 6162 stem are availab │ │ │ │ -00002b20: 6c65 2e0a 0a20 2020 2a20 4752 5542 2032 le... * GRUB 2 │ │ │ │ -00002b30: 2773 2069 6e74 6572 6661 6365 2063 616e 's interface can │ │ │ │ -00002b40: 2062 6520 7472 616e 736c 6174 6564 2c20 be translated, │ │ │ │ -00002b50: 696e 636c 7564 696e 6720 6d65 6e75 2065 including menu e │ │ │ │ -00002b60: 6e74 7279 206e 616d 6573 2e0a 0a20 2020 ntry names... │ │ │ │ -00002b70: 2a20 5468 6520 696d 6167 6520 6669 6c65 * The image file │ │ │ │ -00002b80: 7320 282a 6e6f 7465 2049 6d61 6765 733a s (*note Images: │ │ │ │ -00002b90: 3a29 2074 6861 7420 6d61 6b65 2075 7020 :) that make up │ │ │ │ -00002ba0: 4752 5542 2068 6176 6520 6265 656e 0a20 GRUB have been. │ │ │ │ -00002bb0: 2020 2020 7265 6f72 6761 6e69 7365 643b reorganised; │ │ │ │ -00002bc0: 2053 7461 6765 2031 2c20 5374 6167 6520 Stage 1, Stage │ │ │ │ -00002bd0: 312e 352c 2061 6e64 2053 7461 6765 2032 1.5, and Stage 2 │ │ │ │ -00002be0: 2061 7265 206e 6f20 6d6f 7265 2e0a 0a20 are no more... │ │ │ │ -00002bf0: 2020 2a20 4752 5542 2032 2070 7574 7320 * GRUB 2 puts │ │ │ │ -00002c00: 6d61 6e79 2066 6163 696c 6974 6965 7320 many facilities │ │ │ │ -00002c10: 696e 2064 796e 616d 6963 616c 6c79 206c in dynamically l │ │ │ │ -00002c20: 6f61 6465 6420 6d6f 6475 6c65 732c 2061 oaded modules, a │ │ │ │ -00002c30: 6c6c 6f77 696e 670a 2020 2020 2074 6865 llowing. the │ │ │ │ -00002c40: 2063 6f72 6520 696d 6167 6520 746f 2062 core image to b │ │ │ │ -00002c50: 6520 736d 616c 6c65 722c 2061 6e64 2061 e smaller, and a │ │ │ │ -00002c60: 6c6c 6f77 696e 6720 7468 6520 636f 7265 llowing the core │ │ │ │ -00002c70: 2069 6d61 6765 2074 6f20 6265 0a20 2020 image to be. │ │ │ │ -00002c80: 2020 6275 696c 7420 696e 206d 6f72 6520 built in more │ │ │ │ -00002c90: 666c 6578 6962 6c65 2077 6179 732e 0a0a flexible ways... │ │ │ │ -00002ca0: 1f0a 4669 6c65 3a20 6772 7562 2e69 6e66 ..File: grub.inf │ │ │ │ -00002cb0: 6f2c 2020 4e6f 6465 3a20 4665 6174 7572 o, Node: Featur │ │ │ │ -00002cc0: 6573 2c20 204e 6578 743a 2052 6f6c 6520 es, Next: Role │ │ │ │ -00002cd0: 6f66 2061 2062 6f6f 7420 6c6f 6164 6572 of a boot loader │ │ │ │ -00002ce0: 2c20 2050 7265 763a 2043 6861 6e67 6573 , Prev: Changes │ │ │ │ -00002cf0: 2066 726f 6d20 4752 5542 204c 6567 6163 from GRUB Legac │ │ │ │ -00002d00: 792c 2020 5570 3a20 496e 7472 6f64 7563 y, Up: Introduc │ │ │ │ -00002d10: 7469 6f6e 0a0a 312e 3420 4752 5542 2066 tion..1.4 GRUB f │ │ │ │ -00002d20: 6561 7475 7265 730a 3d3d 3d3d 3d3d 3d3d eatures.======== │ │ │ │ -00002d30: 3d3d 3d3d 3d3d 3d3d 3d0a 0a54 6865 2070 =========..The p │ │ │ │ -00002d40: 7269 6d61 7279 2072 6571 7569 7265 6d65 rimary requireme │ │ │ │ -00002d50: 6e74 2066 6f72 2047 5255 4220 6973 2074 nt for GRUB is t │ │ │ │ -00002d60: 6861 7420 6974 2062 6520 636f 6d70 6c69 hat it be compli │ │ │ │ -00002d70: 616e 7420 7769 7468 2074 6865 0a22 4d75 ant with the."Mu │ │ │ │ -00002d80: 6c74 6962 6f6f 7420 5370 6563 6966 6963 ltiboot Specific │ │ │ │ -00002d90: 6174 696f 6e22 2c20 7768 6963 6820 6973 ation", which is │ │ │ │ -00002da0: 2064 6573 6372 6962 6564 2069 6e20 2a6e described in *n │ │ │ │ -00002db0: 6f74 6520 4d75 6c74 6962 6f6f 740a 5370 ote Multiboot.Sp │ │ │ │ -00002dc0: 6563 6966 6963 6174 696f 6e3a 2028 6d75 ecification: (mu │ │ │ │ -00002dd0: 6c74 6962 6f6f 7429 546f 702e 0a0a 2020 ltiboot)Top... │ │ │ │ -00002de0: 2054 6865 206f 7468 6572 2067 6f61 6c73 The other goals │ │ │ │ -00002df0: 2c20 6c69 7374 6564 2069 6e20 6170 7072 , listed in appr │ │ │ │ -00002e00: 6f78 696d 6174 6520 6f72 6465 7220 6f66 oximate order of │ │ │ │ -00002e10: 2069 6d70 6f72 7461 6e63 652c 2061 7265 importance, are │ │ │ │ -00002e20: 3a0a 0a20 2020 2a20 4261 7369 6320 6675 :.. * Basic fu │ │ │ │ -00002e30: 6e63 7469 6f6e 7320 6d75 7374 2062 6520 nctions must be │ │ │ │ -00002e40: 7374 7261 6967 6874 666f 7277 6172 6420 straightforward │ │ │ │ -00002e50: 666f 7220 656e 642d 7573 6572 732e 0a0a for end-users... │ │ │ │ -00002e60: 2020 202a 2052 6963 6820 6675 6e63 7469 * Rich functi │ │ │ │ -00002e70: 6f6e 616c 6974 7920 746f 2073 7570 706f onality to suppo │ │ │ │ -00002e80: 7274 206b 6572 6e65 6c20 6578 7065 7274 rt kernel expert │ │ │ │ -00002e90: 7320 616e 6420 6465 7369 676e 6572 732e s and designers. │ │ │ │ -00002ea0: 0a0a 2020 202a 2042 6163 6b77 6172 6420 .. * Backward │ │ │ │ -00002eb0: 636f 6d70 6174 6962 696c 6974 7920 666f compatibility fo │ │ │ │ -00002ec0: 7220 626f 6f74 696e 6720 4672 6565 4253 r booting FreeBS │ │ │ │ -00002ed0: 442c 204e 6574 4253 442c 204f 7065 6e42 D, NetBSD, OpenB │ │ │ │ -00002ee0: 5344 2c20 616e 640a 2020 2020 204c 696e SD, and. Lin │ │ │ │ -00002ef0: 7578 2e20 2050 726f 7072 6965 7461 7279 ux. Proprietary │ │ │ │ -00002f00: 206b 6572 6e65 6c73 2028 7375 6368 2061 kernels (such a │ │ │ │ -00002f10: 7320 444f 532c 2057 696e 646f 7773 204e s DOS, Windows N │ │ │ │ -00002f20: 542c 2061 6e64 204f 532f 3229 2061 7265 T, and OS/2) are │ │ │ │ -00002f30: 0a20 2020 2020 7375 7070 6f72 7465 6420 . supported │ │ │ │ -00002f40: 7669 6120 6120 6368 6169 6e2d 6c6f 6164 via a chain-load │ │ │ │ -00002f50: 696e 6720 6675 6e63 7469 6f6e 2e0a 0a20 ing function... │ │ │ │ -00002f60: 2020 4578 6365 7074 2066 6f72 2073 7065 Except for spe │ │ │ │ -00002f70: 6369 6669 6320 636f 6d70 6174 6962 696c cific compatibil │ │ │ │ -00002f80: 6974 7920 6d6f 6465 7320 2863 6861 696e ity modes (chain │ │ │ │ -00002f90: 2d6c 6f61 6469 6e67 2061 6e64 2074 6865 -loading and the │ │ │ │ -00002fa0: 204c 696e 7578 0a22 7069 6767 7962 6163 Linux."piggybac │ │ │ │ -00002fb0: 6b22 2066 6f72 6d61 7429 2c20 616c 6c20 k" format), all │ │ │ │ -00002fc0: 6b65 726e 656c 7320 7769 6c6c 2062 6520 kernels will be │ │ │ │ -00002fd0: 7374 6172 7465 6420 696e 206d 7563 6820 started in much │ │ │ │ -00002fe0: 7468 6520 7361 6d65 2073 7461 7465 0a61 the same state.a │ │ │ │ -00002ff0: 7320 696e 2074 6865 204d 756c 7469 626f s in the Multibo │ │ │ │ -00003000: 6f74 2053 7065 6369 6669 6361 7469 6f6e ot Specification │ │ │ │ -00003010: 2e20 204f 6e6c 7920 6b65 726e 656c 7320 . Only kernels │ │ │ │ -00003020: 6c6f 6164 6564 2061 7420 3120 6d65 6761 loaded at 1 mega │ │ │ │ -00003030: 6279 7465 206f 720a 6162 6f76 6520 6172 byte or.above ar │ │ │ │ -00003040: 6520 7072 6573 656e 746c 7920 7375 7070 e presently supp │ │ │ │ -00003050: 6f72 7465 642e 2020 416e 7920 6174 7465 orted. Any atte │ │ │ │ -00003060: 6d70 7420 746f 206c 6f61 6420 6265 6c6f mpt to load belo │ │ │ │ -00003070: 7720 7468 6174 2062 6f75 6e64 6172 790a w that boundary. │ │ │ │ -00003080: 7769 6c6c 2073 696d 706c 7920 7265 7375 will simply resu │ │ │ │ -00003090: 6c74 2069 6e20 696d 6d65 6469 6174 6520 lt in immediate │ │ │ │ -000030a0: 6661 696c 7572 6520 616e 6420 616e 2065 failure and an e │ │ │ │ -000030b0: 7272 6f72 206d 6573 7361 6765 2072 6570 rror message rep │ │ │ │ -000030c0: 6f72 7469 6e67 0a74 6865 2070 726f 626c orting.the probl │ │ │ │ -000030d0: 656d 2e0a 0a20 2020 496e 2061 6464 6974 em... In addit │ │ │ │ -000030e0: 696f 6e20 746f 2074 6865 2072 6571 7569 ion to the requi │ │ │ │ -000030f0: 7265 6d65 6e74 7320 6162 6f76 652c 2047 rements above, G │ │ │ │ -00003100: 5255 4220 6861 7320 7468 6520 666f 6c6c RUB has the foll │ │ │ │ -00003110: 6f77 696e 670a 6665 6174 7572 6573 2028 owing.features ( │ │ │ │ -00003120: 6e6f 7465 2074 6861 7420 7468 6520 4d75 note that the Mu │ │ │ │ -00003130: 6c74 6962 6f6f 7420 5370 6563 6966 6963 ltiboot Specific │ │ │ │ -00003140: 6174 696f 6e20 646f 6573 6e27 7420 7265 ation doesn't re │ │ │ │ -00003150: 7175 6972 6520 616c 6c20 7468 650a 6665 quire all the.fe │ │ │ │ -00003160: 6174 7572 6573 2074 6861 7420 4752 5542 atures that GRUB │ │ │ │ -00003170: 2073 7570 706f 7274 7329 3a0a 0a52 6563 supports):..Rec │ │ │ │ -00003180: 6f67 6e69 7a65 206d 756c 7469 706c 6520 ognize multiple │ │ │ │ -00003190: 6578 6563 7574 6162 6c65 2066 6f72 6d61 executable forma │ │ │ │ -000031a0: 7473 0a20 2020 2020 5375 7070 6f72 7420 ts. Support │ │ │ │ -000031b0: 6d61 6e79 206f 6620 7468 6520 2261 2e6f many of the "a.o │ │ │ │ -000031c0: 7574 2220 7661 7269 616e 7473 2070 6c75 ut" variants plu │ │ │ │ -000031d0: 7320 2245 4c46 222e 2053 796d 626f 6c20 s "ELF". Symbol │ │ │ │ -000031e0: 7461 626c 6573 2061 7265 0a20 2020 2020 tables are. │ │ │ │ -000031f0: 616c 736f 206c 6f61 6465 642e 0a0a 5375 also loaded...Su │ │ │ │ -00003200: 7070 6f72 7420 6e6f 6e2d 4d75 6c74 6962 pport non-Multib │ │ │ │ -00003210: 6f6f 7420 6b65 726e 656c 730a 2020 2020 oot kernels. │ │ │ │ -00003220: 2053 7570 706f 7274 206d 616e 7920 6f66 Support many of │ │ │ │ -00003230: 2074 6865 2076 6172 696f 7573 2066 7265 the various fre │ │ │ │ -00003240: 6520 3332 2d62 6974 206b 6572 6e65 6c73 e 32-bit kernels │ │ │ │ -00003250: 2074 6861 7420 6c61 636b 204d 756c 7469 that lack Multi │ │ │ │ -00003260: 626f 6f74 0a20 2020 2020 636f 6d70 6c69 boot. compli │ │ │ │ -00003270: 616e 6365 2028 7072 696d 6172 696c 7920 ance (primarily │ │ │ │ -00003280: 4672 6565 4253 442c 204e 6574 4253 4428 FreeBSD, NetBSD( │ │ │ │ -00003290: 3129 2028 2a6e 6f74 650a 2020 2020 2046 1) (*note. F │ │ │ │ -000032a0: 6561 7475 7265 732d 466f 6f74 6e6f 7465 eatures-Footnote │ │ │ │ -000032b0: 2d31 3a3a 292c 204f 7065 6e42 5344 2c20 -1::), OpenBSD, │ │ │ │ -000032c0: 616e 6420 4c69 6e75 7829 2e20 2043 6861 and Linux). Cha │ │ │ │ -000032d0: 696e 2d6c 6f61 6469 6e67 206f 660a 2020 in-loading of. │ │ │ │ -000032e0: 2020 206f 7468 6572 2062 6f6f 7420 6c6f other boot lo │ │ │ │ -000032f0: 6164 6572 7320 6973 2061 6c73 6f20 7375 aders is also su │ │ │ │ -00003300: 7070 6f72 7465 642e 0a0a 4c6f 6164 206d pported...Load m │ │ │ │ -00003310: 756c 7469 706c 6573 206d 6f64 756c 6573 ultiples modules │ │ │ │ -00003320: 0a20 2020 2020 4675 6c6c 7920 7375 7070 . Fully supp │ │ │ │ -00003330: 6f72 7420 7468 6520 4d75 6c74 6962 6f6f ort the Multiboo │ │ │ │ -00003340: 7420 6665 6174 7572 6520 6f66 206c 6f61 t feature of loa │ │ │ │ -00003350: 6469 6e67 206d 756c 7469 706c 6520 6d6f ding multiple mo │ │ │ │ -00003360: 6475 6c65 732e 0a0a 4c6f 6164 2061 2063 dules...Load a c │ │ │ │ -00003370: 6f6e 6669 6775 7261 7469 6f6e 2066 696c onfiguration fil │ │ │ │ -00003380: 650a 2020 2020 2053 7570 706f 7274 2061 e. Support a │ │ │ │ -00003390: 2068 756d 616e 2d72 6561 6461 626c 6520 human-readable │ │ │ │ -000033a0: 7465 7874 2063 6f6e 6669 6775 7261 7469 text configurati │ │ │ │ -000033b0: 6f6e 2066 696c 6520 7769 7468 2070 7265 on file with pre │ │ │ │ -000033c0: 7365 7420 626f 6f74 0a20 2020 2020 636f set boot. co │ │ │ │ -000033d0: 6d6d 616e 6473 2e20 2059 6f75 2063 616e mmands. You can │ │ │ │ -000033e0: 2061 6c73 6f20 6c6f 6164 2061 6e6f 7468 also load anoth │ │ │ │ -000033f0: 6572 2063 6f6e 6669 6775 7261 7469 6f6e er configuration │ │ │ │ -00003400: 2066 696c 6520 6479 6e61 6d69 6361 6c6c file dynamicall │ │ │ │ -00003410: 790a 2020 2020 2061 6e64 2065 6d62 6564 y. and embed │ │ │ │ -00003420: 2061 2070 7265 7365 7420 636f 6e66 6967 a preset config │ │ │ │ -00003430: 7572 6174 696f 6e20 6669 6c65 2069 6e20 uration file in │ │ │ │ -00003440: 6120 4752 5542 2069 6d61 6765 2066 696c a GRUB image fil │ │ │ │ -00003450: 652e 2020 5468 650a 2020 2020 206c 6973 e. The. lis │ │ │ │ -00003460: 7420 6f66 2063 6f6d 6d61 6e64 7320 282a t of commands (* │ │ │ │ -00003470: 6e6f 7465 2043 6f6d 6d61 6e64 733a 3a29 note Commands::) │ │ │ │ -00003480: 2061 7265 2061 2073 7570 6572 7365 7420 are a superset │ │ │ │ -00003490: 6f66 2074 686f 7365 0a20 2020 2020 7375 of those. su │ │ │ │ -000034a0: 7070 6f72 7465 6420 6f6e 2074 6865 2063 pported on the c │ │ │ │ -000034b0: 6f6d 6d61 6e64 2d6c 696e 652e 2020 416e ommand-line. An │ │ │ │ -000034c0: 2065 7861 6d70 6c65 2063 6f6e 6669 6775 example configu │ │ │ │ -000034d0: 7261 7469 6f6e 2066 696c 6520 6973 0a20 ration file is. │ │ │ │ -000034e0: 2020 2020 7072 6f76 6964 6564 2069 6e20 provided in │ │ │ │ -000034f0: 2a6e 6f74 6520 436f 6e66 6967 7572 6174 *note Configurat │ │ │ │ -00003500: 696f 6e3a 3a2e 0a0a 5072 6f76 6964 6520 ion::...Provide │ │ │ │ -00003510: 6120 6d65 6e75 2069 6e74 6572 6661 6365 a menu interface │ │ │ │ -00003520: 0a20 2020 2020 4120 6d65 6e75 2069 6e74 . A menu int │ │ │ │ -00003530: 6572 6661 6365 206c 6973 7469 6e67 2070 erface listing p │ │ │ │ -00003540: 7265 7365 7420 626f 6f74 2063 6f6d 6d61 reset boot comma │ │ │ │ -00003550: 6e64 732c 2077 6974 6820 6120 7072 6f67 nds, with a prog │ │ │ │ -00003560: 7261 6d6d 6162 6c65 0a20 2020 2020 7469 rammable. ti │ │ │ │ -00003570: 6d65 6f75 742c 2069 7320 6176 6169 6c61 meout, is availa │ │ │ │ -00003580: 626c 652e 2020 5468 6572 6520 6973 206e ble. There is n │ │ │ │ -00003590: 6f20 6669 7865 6420 6c69 6d69 7420 6f6e o fixed limit on │ │ │ │ -000035a0: 2074 6865 206e 756d 6265 7220 6f66 0a20 the number of. │ │ │ │ -000035b0: 2020 2020 626f 6f74 2065 6e74 7269 6573 boot entries │ │ │ │ -000035c0: 2c20 616e 6420 7468 6520 6375 7272 656e , and the curren │ │ │ │ -000035d0: 7420 696d 706c 656d 656e 7461 7469 6f6e t implementation │ │ │ │ -000035e0: 2068 6173 2073 7061 6365 2066 6f72 2073 has space for s │ │ │ │ -000035f0: 6576 6572 616c 0a20 2020 2020 6875 6e64 everal. hund │ │ │ │ -00003600: 7265 642e 0a0a 4861 7665 2061 2066 6c65 red...Have a fle │ │ │ │ -00003610: 7869 626c 6520 636f 6d6d 616e 642d 6c69 xible command-li │ │ │ │ -00003620: 6e65 2069 6e74 6572 6661 6365 0a20 2020 ne interface. │ │ │ │ -00003630: 2020 4120 6661 6972 6c79 2066 6c65 7869 A fairly flexi │ │ │ │ -00003640: 626c 6520 636f 6d6d 616e 642d 6c69 6e65 ble command-line │ │ │ │ -00003650: 2069 6e74 6572 6661 6365 2c20 6163 6365 interface, acce │ │ │ │ -00003660: 7373 6962 6c65 2066 726f 6d20 7468 6520 ssible from the │ │ │ │ -00003670: 6d65 6e75 2c0a 2020 2020 2069 7320 6176 menu,. is av │ │ │ │ -00003680: 6169 6c61 626c 6520 746f 2065 6469 7420 ailable to edit │ │ │ │ -00003690: 616e 7920 7072 6573 6574 2063 6f6d 6d61 any preset comma │ │ │ │ -000036a0: 6e64 732c 206f 7220 7772 6974 6520 6120 nds, or write a │ │ │ │ -000036b0: 6e65 7720 626f 6f74 0a20 2020 2020 636f new boot. co │ │ │ │ -000036c0: 6d6d 616e 6420 7365 7420 6672 6f6d 2073 mmand set from s │ │ │ │ -000036d0: 6372 6174 6368 2e20 2049 6620 6e6f 2063 cratch. If no c │ │ │ │ -000036e0: 6f6e 6669 6775 7261 7469 6f6e 2066 696c onfiguration fil │ │ │ │ -000036f0: 6520 6973 2070 7265 7365 6e74 2c0a 2020 e is present,. │ │ │ │ -00003700: 2020 2047 5255 4220 6472 6f70 7320 746f GRUB drops to │ │ │ │ -00003710: 2074 6865 2063 6f6d 6d61 6e64 2d6c 696e the command-lin │ │ │ │ -00003720: 652e 0a0a 2020 2020 2054 6865 206c 6973 e... The lis │ │ │ │ -00003730: 7420 6f66 2063 6f6d 6d61 6e64 7320 282a t of commands (* │ │ │ │ -00003740: 6e6f 7465 2043 6f6d 6d61 6e64 733a 3a29 note Commands::) │ │ │ │ -00003750: 2061 7265 2061 2073 7562 7365 7420 6f66 are a subset of │ │ │ │ -00003760: 2074 686f 7365 0a20 2020 2020 7375 7070 those. supp │ │ │ │ -00003770: 6f72 7465 6420 666f 7220 636f 6e66 6967 orted for config │ │ │ │ -00003780: 7572 6174 696f 6e20 6669 6c65 732e 2020 uration files. │ │ │ │ -00003790: 4564 6974 696e 6720 636f 6d6d 616e 6473 Editing commands │ │ │ │ -000037a0: 2063 6c6f 7365 6c79 0a20 2020 2020 7265 closely. re │ │ │ │ -000037b0: 7365 6d62 6c65 7320 7468 6520 4261 7368 sembles the Bash │ │ │ │ -000037c0: 2063 6f6d 6d61 6e64 2d6c 696e 6520 282a command-line (* │ │ │ │ -000037d0: 6e6f 7465 2042 6173 683a 2028 6665 6174 note Bash: (feat │ │ │ │ -000037e0: 7572 6573 2943 6f6d 6d61 6e64 204c 696e ures)Command Lin │ │ │ │ -000037f0: 650a 2020 2020 2045 6469 7469 6e67 2e29 e. Editing.) │ │ │ │ -00003800: 2c20 7769 7468 203c 5441 423e 2d63 6f6d , with -com │ │ │ │ -00003810: 706c 6574 696f 6e20 6f66 2063 6f6d 6d61 pletion of comma │ │ │ │ -00003820: 6e64 732c 2064 6576 6963 6573 2c20 7061 nds, devices, pa │ │ │ │ -00003830: 7274 6974 696f 6e73 2c0a 2020 2020 2061 rtitions,. a │ │ │ │ -00003840: 6e64 2066 696c 6573 2069 6e20 6120 6469 nd files in a di │ │ │ │ -00003850: 7265 6374 6f72 7920 6465 7065 6e64 696e rectory dependin │ │ │ │ -00003860: 6720 6f6e 2063 6f6e 7465 7874 2e0a 0a53 g on context...S │ │ │ │ -00003870: 7570 706f 7274 206d 756c 7469 706c 6520 upport multiple │ │ │ │ -00003880: 6669 6c65 7379 7374 656d 2074 7970 6573 filesystem types │ │ │ │ -00003890: 0a20 2020 2020 5375 7070 6f72 7420 6d75 . Support mu │ │ │ │ -000038a0: 6c74 6970 6c65 2066 696c 6573 7973 7465 ltiple filesyste │ │ │ │ -000038b0: 6d20 7479 7065 7320 7472 616e 7370 6172 m types transpar │ │ │ │ -000038c0: 656e 746c 792c 2070 6c75 7320 6120 7573 ently, plus a us │ │ │ │ -000038d0: 6566 756c 0a20 2020 2020 6578 706c 6963 eful. explic │ │ │ │ -000038e0: 6974 2062 6c6f 636b 6c69 7374 206e 6f74 it blocklist not │ │ │ │ -000038f0: 6174 696f 6e2e 2020 5468 6520 6375 7272 ation. The curr │ │ │ │ -00003900: 656e 746c 7920 7375 7070 6f72 7465 6420 ently supported │ │ │ │ -00003910: 6669 6c65 7379 7374 656d 0a20 2020 2020 filesystem. │ │ │ │ -00003920: 7479 7065 7320 6172 6520 2241 6d69 6761 types are "Amiga │ │ │ │ -00003930: 2046 6173 7420 4669 6c65 5379 7374 656d Fast FileSystem │ │ │ │ -00003940: 2028 4146 4653 2922 2c20 2241 7468 654f (AFFS)", "AtheO │ │ │ │ -00003950: 5320 6673 222c 2022 4265 4653 222c 0a20 S fs", "BeFS",. │ │ │ │ -00003960: 2020 2020 2242 7472 4653 2220 2869 6e63 "BtrFS" (inc │ │ │ │ -00003970: 6c75 6469 6e67 2072 6169 6430 2c20 7261 luding raid0, ra │ │ │ │ -00003980: 6964 312c 2072 6169 6431 302c 2067 7a69 id1, raid10, gzi │ │ │ │ -00003990: 7020 616e 6420 6c7a 6f29 2c20 2263 7069 p and lzo), "cpi │ │ │ │ -000039a0: 6f22 0a20 2020 2020 286c 6974 746c 652d o". (little- │ │ │ │ -000039b0: 2061 6e64 2062 6967 2d65 6e64 6961 6e20 and big-endian │ │ │ │ -000039c0: 6269 6e2c 206f 6463 2061 6e64 206e 6577 bin, odc and new │ │ │ │ -000039d0: 6320 7661 7269 616e 7473 292c 2022 4c69 c variants), "Li │ │ │ │ -000039e0: 6e75 780a 2020 2020 2065 7874 322f 6578 nux. ext2/ex │ │ │ │ -000039f0: 7433 2f65 7874 3422 2c20 2244 4f53 2046 t3/ext4", "DOS F │ │ │ │ -00003a00: 4154 3132 2f46 4154 3136 2f46 4154 3332 AT12/FAT16/FAT32 │ │ │ │ -00003a10: 222c 2022 6578 4641 5422 2c20 2246 3246 ", "exFAT", "F2F │ │ │ │ -00003a20: 5322 2c20 2248 4653 222c 0a20 2020 2020 S", "HFS",. │ │ │ │ -00003a30: 2248 4653 2b22 2c20 2249 534f 3936 3630 "HFS+", "ISO9660 │ │ │ │ -00003a40: 2220 2869 6e63 6c75 6469 6e67 204a 6f6c " (including Jol │ │ │ │ -00003a50: 6965 742c 2052 6f63 6b2d 7269 6467 6520 iet, Rock-ridge │ │ │ │ -00003a60: 616e 6420 6d75 6c74 692d 6368 756e 6b0a and multi-chunk. │ │ │ │ -00003a70: 2020 2020 2066 696c 6573 292c 2022 4a46 files), "JF │ │ │ │ -00003a80: 5322 2c20 224d 696e 6978 2066 7322 2028 S", "Minix fs" ( │ │ │ │ -00003a90: 7665 7273 696f 6e73 2031 2c20 3220 616e versions 1, 2 an │ │ │ │ -00003aa0: 6420 3329 2c20 226e 696c 6673 3222 2c20 d 3), "nilfs2", │ │ │ │ -00003ab0: 224e 5446 5322 0a20 2020 2020 2869 6e63 "NTFS". (inc │ │ │ │ -00003ac0: 6c75 6469 6e67 2063 6f6d 7072 6573 7369 luding compressi │ │ │ │ -00003ad0: 6f6e 292c 2022 5265 6973 6572 4653 222c on), "ReiserFS", │ │ │ │ -00003ae0: 2022 524f 4d46 5322 2c20 2241 6d69 6761 "ROMFS", "Amiga │ │ │ │ -00003af0: 2053 6d61 7274 0a20 2020 2020 4669 6c65 Smart. File │ │ │ │ -00003b00: 5379 7374 656d 2028 5346 5329 222c 2022 System (SFS)", " │ │ │ │ -00003b10: 5371 7561 7368 3422 2c20 2274 6172 222c Squash4", "tar", │ │ │ │ -00003b20: 2022 5544 4622 2c20 2242 5344 2055 4653 "UDF", "BSD UFS │ │ │ │ -00003b30: 2f55 4653 3222 2c20 2258 4653 222c 0a20 /UFS2", "XFS",. │ │ │ │ -00003b40: 2020 2020 616e 6420 225a 4653 2220 2869 and "ZFS" (i │ │ │ │ -00003b50: 6e63 6c75 6469 6e67 206c 7a6a 622c 2067 ncluding lzjb, g │ │ │ │ -00003b60: 7a69 702c 207a 6c65 2c20 6d69 7272 6f72 zip, zle, mirror │ │ │ │ -00003b70: 2c20 7374 7269 7065 2c20 7261 6964 7a31 , stripe, raidz1 │ │ │ │ -00003b80: 2f32 2f33 0a20 2020 2020 616e 6420 656e /2/3. and en │ │ │ │ -00003b90: 6372 7970 7469 6f6e 2069 6e20 4145 532d cryption in AES- │ │ │ │ -00003ba0: 4343 4d20 616e 6420 4145 532d 4743 4d29 CCM and AES-GCM) │ │ │ │ -00003bb0: 2e20 2a4e 6f74 6520 4669 6c65 7379 7374 . *Note Filesyst │ │ │ │ -00003bc0: 656d 3a3a 2c20 666f 720a 2020 2020 206d em::, for. m │ │ │ │ -00003bd0: 6f72 6520 696e 666f 726d 6174 696f 6e2e ore information. │ │ │ │ -00003be0: 0a0a 5375 7070 6f72 7420 6175 746f 6d61 ..Support automa │ │ │ │ -00003bf0: 7469 6320 6465 636f 6d70 7265 7373 696f tic decompressio │ │ │ │ -00003c00: 6e0a 2020 2020 2043 616e 2064 6563 6f6d n. Can decom │ │ │ │ -00003c10: 7072 6573 7320 6669 6c65 7320 7768 6963 press files whic │ │ │ │ -00003c20: 6820 7765 7265 2063 6f6d 7072 6573 7365 h were compresse │ │ │ │ -00003c30: 6420 6279 2027 677a 6970 2720 6f72 2027 d by 'gzip' or ' │ │ │ │ -00003c40: 787a 2728 3229 0a20 2020 2020 282a 6e6f xz'(2). (*no │ │ │ │ -00003c50: 7465 2046 6561 7475 7265 732d 466f 6f74 te Features-Foot │ │ │ │ -00003c60: 6e6f 7465 2d32 3a3a 292e 2020 5468 6973 note-2::). This │ │ │ │ -00003c70: 2066 756e 6374 696f 6e20 6973 2062 6f74 function is bot │ │ │ │ -00003c80: 6820 6175 746f 6d61 7469 6320 616e 640a h automatic and. │ │ │ │ -00003c90: 2020 2020 2074 7261 6e73 7061 7265 6e74 transparent │ │ │ │ -00003ca0: 2074 6f20 7468 6520 7573 6572 2028 692e to the user (i. │ │ │ │ -00003cb0: 652e 2020 616c 6c20 6675 6e63 7469 6f6e e. all function │ │ │ │ -00003cc0: 7320 6f70 6572 6174 6520 7570 6f6e 2074 s operate upon t │ │ │ │ -00003cd0: 6865 0a20 2020 2020 756e 636f 6d70 7265 he. uncompre │ │ │ │ -00003ce0: 7373 6564 2063 6f6e 7465 6e74 7320 6f66 ssed contents of │ │ │ │ -00003cf0: 2074 6865 2073 7065 6369 6669 6564 2066 the specified f │ │ │ │ -00003d00: 696c 6573 292e 2020 5468 6973 2067 7265 iles). This gre │ │ │ │ -00003d10: 6174 6c79 0a20 2020 2020 7265 6475 6365 atly. reduce │ │ │ │ -00003d20: 7320 6120 6669 6c65 2073 697a 6520 616e s a file size an │ │ │ │ -00003d30: 6420 6c6f 6164 696e 6720 7469 6d65 2c20 d loading time, │ │ │ │ -00003d40: 6120 7061 7274 6963 756c 6172 6c79 2067 a particularly g │ │ │ │ -00003d50: 7265 6174 2062 656e 6566 6974 0a20 2020 reat benefit. │ │ │ │ -00003d60: 2020 666f 7220 666c 6f70 7069 6573 2e28 for floppies.( │ │ │ │ -00003d70: 3329 2020 282a 6e6f 7465 2046 6561 7475 3) (*note Featu │ │ │ │ -00003d80: 7265 732d 466f 6f74 6e6f 7465 2d33 3a3a res-Footnote-3:: │ │ │ │ -00003d90: 290a 0a20 2020 2020 4974 2069 7320 636f ).. It is co │ │ │ │ -00003da0: 6e63 6569 7661 626c 6520 7468 6174 2073 nceivable that s │ │ │ │ -00003db0: 6f6d 6520 6b65 726e 656c 206d 6f64 756c ome kernel modul │ │ │ │ -00003dc0: 6573 2073 686f 756c 6420 6265 206c 6f61 es should be loa │ │ │ │ -00003dd0: 6465 6420 696e 2061 0a20 2020 2020 636f ded in a. co │ │ │ │ -00003de0: 6d70 7265 7373 6564 2073 7461 7465 2c20 mpressed state, │ │ │ │ -00003df0: 736f 2061 2064 6966 6665 7265 6e74 206d so a different m │ │ │ │ -00003e00: 6f64 756c 652d 6c6f 6164 696e 6720 636f odule-loading co │ │ │ │ -00003e10: 6d6d 616e 6420 6361 6e20 6265 0a20 2020 mmand can be. │ │ │ │ -00003e20: 2020 7370 6563 6966 6965 6420 746f 2061 specified to a │ │ │ │ -00003e30: 766f 6964 2075 6e63 6f6d 7072 6573 7369 void uncompressi │ │ │ │ -00003e40: 6e67 2074 6865 206d 6f64 756c 6573 2e0a ng the modules.. │ │ │ │ -00003e50: 0a41 6363 6573 7320 6461 7461 206f 6e20 .Access data on │ │ │ │ -00003e60: 616e 7920 696e 7374 616c 6c65 6420 6465 any installed de │ │ │ │ -00003e70: 7669 6365 0a20 2020 2020 5375 7070 6f72 vice. Suppor │ │ │ │ -00003e80: 7420 7265 6164 696e 6720 6461 7461 2066 t reading data f │ │ │ │ -00003e90: 726f 6d20 616e 7920 6f72 2061 6c6c 2066 rom any or all f │ │ │ │ -00003ea0: 6c6f 7070 6965 7320 6f72 2068 6172 6420 loppies or hard │ │ │ │ -00003eb0: 6469 736b 2873 290a 2020 2020 2072 6563 disk(s). rec │ │ │ │ -00003ec0: 6f67 6e69 7a65 6420 6279 2074 6865 2042 ognized by the B │ │ │ │ -00003ed0: 494f 532c 2069 6e64 6570 656e 6465 6e74 IOS, independent │ │ │ │ -00003ee0: 206f 6620 7468 6520 7365 7474 696e 6720 of the setting │ │ │ │ -00003ef0: 6f66 2074 6865 2072 6f6f 740a 2020 2020 of the root. │ │ │ │ -00003f00: 2064 6576 6963 652e 0a0a 4265 2069 6e64 device...Be ind │ │ │ │ -00003f10: 6570 656e 6465 6e74 206f 6620 6472 6976 ependent of driv │ │ │ │ -00003f20: 6520 6765 6f6d 6574 7279 2074 7261 6e73 e geometry trans │ │ │ │ -00003f30: 6c61 7469 6f6e 730a 2020 2020 2055 6e6c lations. Unl │ │ │ │ -00003f40: 696b 6520 6d61 6e79 206f 7468 6572 2062 ike many other b │ │ │ │ -00003f50: 6f6f 7420 6c6f 6164 6572 732c 2047 5255 oot loaders, GRU │ │ │ │ -00003f60: 4220 6d61 6b65 7320 7468 6520 7061 7274 B makes the part │ │ │ │ -00003f70: 6963 756c 6172 2064 7269 7665 0a20 2020 icular drive. │ │ │ │ -00003f80: 2020 7472 616e 736c 6174 696f 6e20 6972 translation ir │ │ │ │ -00003f90: 7265 6c65 7661 6e74 2e20 2041 2064 7269 relevant. A dri │ │ │ │ -00003fa0: 7665 2069 6e73 7461 6c6c 6564 2061 6e64 ve installed and │ │ │ │ -00003fb0: 2072 756e 6e69 6e67 2077 6974 6820 6f6e running with on │ │ │ │ -00003fc0: 650a 2020 2020 2074 7261 6e73 6c61 7469 e. translati │ │ │ │ -00003fd0: 6f6e 206d 6179 2062 6520 636f 6e76 6572 on may be conver │ │ │ │ -00003fe0: 7465 6420 746f 2061 6e6f 7468 6572 2074 ted to another t │ │ │ │ -00003ff0: 7261 6e73 6c61 7469 6f6e 2077 6974 686f ranslation witho │ │ │ │ -00004000: 7574 2061 6e79 0a20 2020 2020 6164 7665 ut any. adve │ │ │ │ -00004010: 7273 6520 6566 6665 6374 7320 6f72 2063 rse effects or c │ │ │ │ -00004020: 6861 6e67 6573 2069 6e20 4752 5542 2773 hanges in GRUB's │ │ │ │ -00004030: 2063 6f6e 6669 6775 7261 7469 6f6e 2e0a configuration.. │ │ │ │ -00004040: 0a44 6574 6563 7420 616c 6c20 696e 7374 .Detect all inst │ │ │ │ -00004050: 616c 6c65 6420 5241 4d0a 2020 2020 2047 alled RAM. G │ │ │ │ -00004060: 5255 4220 6361 6e20 6765 6e65 7261 6c6c RUB can generall │ │ │ │ -00004070: 7920 6669 6e64 2061 6c6c 2074 6865 2069 y find all the i │ │ │ │ -00004080: 6e73 7461 6c6c 6564 2052 414d 206f 6e20 nstalled RAM on │ │ │ │ -00004090: 6120 5043 2d63 6f6d 7061 7469 626c 650a a PC-compatible. │ │ │ │ -000040a0: 2020 2020 206d 6163 6869 6e65 2e20 2049 machine. I │ │ │ │ -000040b0: 7420 7573 6573 2061 6e20 6164 7661 6e63 t uses an advanc │ │ │ │ -000040c0: 6564 2042 494f 5320 7175 6572 7920 7465 ed BIOS query te │ │ │ │ -000040d0: 6368 6e69 7175 6520 666f 7220 6669 6e64 chnique for find │ │ │ │ -000040e0: 696e 6720 616c 6c0a 2020 2020 206d 656d ing all. mem │ │ │ │ -000040f0: 6f72 7920 7265 6769 6f6e 732e 2020 4173 ory regions. As │ │ │ │ -00004100: 2064 6573 6372 6962 6564 206f 6e20 7468 described on th │ │ │ │ -00004110: 6520 4d75 6c74 6962 6f6f 7420 5370 6563 e Multiboot Spec │ │ │ │ -00004120: 6966 6963 6174 696f 6e20 282a 6e6f 7465 ification (*note │ │ │ │ -00004130: 0a20 2020 2020 4d75 6c74 6962 6f6f 7420 . Multiboot │ │ │ │ -00004140: 5370 6563 6966 6963 6174 696f 6e3a 2028 Specification: ( │ │ │ │ -00004150: 6d75 6c74 6962 6f6f 7429 546f 702e 292c multiboot)Top.), │ │ │ │ -00004160: 206e 6f74 2061 6c6c 206b 6572 6e65 6c73 not all kernels │ │ │ │ -00004170: 206d 616b 6520 7573 650a 2020 2020 206f make use. o │ │ │ │ -00004180: 6620 7468 6973 2069 6e66 6f72 6d61 7469 f this informati │ │ │ │ -00004190: 6f6e 2c20 6275 7420 4752 5542 2070 726f on, but GRUB pro │ │ │ │ -000041a0: 7669 6465 7320 6974 2066 6f72 2074 686f vides it for tho │ │ │ │ -000041b0: 7365 2077 686f 2064 6f2e 0a0a 5375 7070 se who do...Supp │ │ │ │ -000041c0: 6f72 7420 4c6f 6769 6361 6c20 426c 6f63 ort Logical Bloc │ │ │ │ -000041d0: 6b20 4164 6472 6573 7320 6d6f 6465 0a20 k Address mode. │ │ │ │ -000041e0: 2020 2020 496e 2074 7261 6469 7469 6f6e In tradition │ │ │ │ -000041f0: 616c 2064 6973 6b20 6361 6c6c 7320 2863 al disk calls (c │ │ │ │ -00004200: 616c 6c65 6420 2243 4853 206d 6f64 6522 alled "CHS mode" │ │ │ │ -00004210: 292c 2074 6865 7265 2069 7320 6120 6765 ), there is a ge │ │ │ │ -00004220: 6f6d 6574 7279 0a20 2020 2020 7472 616e ometry. tran │ │ │ │ -00004230: 736c 6174 696f 6e20 7072 6f62 6c65 6d2c slation problem, │ │ │ │ -00004240: 2074 6861 7420 6973 2c20 7468 6520 4249 that is, the BI │ │ │ │ -00004250: 4f53 2063 616e 6e6f 7420 6163 6365 7373 OS cannot access │ │ │ │ -00004260: 206f 7665 7220 3130 3234 0a20 2020 2020 over 1024. │ │ │ │ -00004270: 6379 6c69 6e64 6572 732c 2073 6f20 7468 cylinders, so th │ │ │ │ -00004280: 6520 6163 6365 7373 6962 6c65 2073 7061 e accessible spa │ │ │ │ -00004290: 6365 2069 7320 6c69 6d69 7465 6420 746f ce is limited to │ │ │ │ -000042a0: 2061 7420 6c65 6173 7420 3530 3820 4d42 at least 508 MB │ │ │ │ -000042b0: 0a20 2020 2020 616e 6420 746f 2061 7420 . and to at │ │ │ │ -000042c0: 6d6f 7374 2038 4742 2e20 4752 5542 2063 most 8GB. GRUB c │ │ │ │ -000042d0: 616e 2774 2075 6e69 7665 7273 616c 6c79 an't universally │ │ │ │ -000042e0: 2073 6f6c 7665 2074 6869 7320 7072 6f62 solve this prob │ │ │ │ -000042f0: 6c65 6d2c 2061 730a 2020 2020 2074 6865 lem, as. the │ │ │ │ -00004300: 7265 2069 7320 6e6f 2073 7461 6e64 6172 re is no standar │ │ │ │ -00004310: 6420 696e 7465 7266 6163 6520 7573 6564 d interface used │ │ │ │ -00004320: 2069 6e20 616c 6c20 6d61 6368 696e 6573 in all machines │ │ │ │ -00004330: 2e20 2048 6f77 6576 6572 2c0a 2020 2020 . However,. │ │ │ │ -00004340: 2073 6576 6572 616c 206e 6577 6572 206d several newer m │ │ │ │ -00004350: 6163 6869 6e65 7320 6861 7665 2074 6865 achines have the │ │ │ │ -00004360: 206e 6577 2069 6e74 6572 6661 6365 2c20 new interface, │ │ │ │ -00004370: 4c6f 6769 6361 6c20 426c 6f63 6b0a 2020 Logical Block. │ │ │ │ -00004380: 2020 2041 6464 7265 7373 2028 224c 4241 Address ("LBA │ │ │ │ -00004390: 2229 206d 6f64 652e 2020 4752 5542 2061 ") mode. GRUB a │ │ │ │ -000043a0: 7574 6f6d 6174 6963 616c 6c79 2064 6574 utomatically det │ │ │ │ -000043b0: 6563 7473 2069 6620 4c42 4120 6d6f 6465 ects if LBA mode │ │ │ │ -000043c0: 2069 730a 2020 2020 2061 7661 696c 6162 is. availab │ │ │ │ -000043d0: 6c65 2061 6e64 2075 7365 7320 6974 2069 le and uses it i │ │ │ │ -000043e0: 6620 6176 6169 6c61 626c 652e 2020 496e f available. In │ │ │ │ -000043f0: 204c 4241 206d 6f64 652c 2047 5255 4220 LBA mode, GRUB │ │ │ │ -00004400: 6361 6e20 6163 6365 7373 0a20 2020 2020 can access. │ │ │ │ -00004410: 7468 6520 656e 7469 7265 2064 6973 6b2e the entire disk. │ │ │ │ -00004420: 0a0a 5375 7070 6f72 7420 6e65 7477 6f72 ..Support networ │ │ │ │ -00004430: 6b20 626f 6f74 696e 670a 2020 2020 2047 k booting. G │ │ │ │ -00004440: 5255 4220 6973 2062 6173 6963 616c 6c79 RUB is basically │ │ │ │ -00004450: 2061 2064 6973 6b2d 6261 7365 6420 626f a disk-based bo │ │ │ │ -00004460: 6f74 206c 6f61 6465 7220 6275 7420 616c ot loader but al │ │ │ │ -00004470: 736f 2068 6173 206e 6574 776f 726b 0a20 so has network. │ │ │ │ -00004480: 2020 2020 7375 7070 6f72 742e 2020 596f support. Yo │ │ │ │ -00004490: 7520 6361 6e20 6c6f 6164 204f 5320 696d u can load OS im │ │ │ │ -000044a0: 6167 6573 2066 726f 6d20 6120 6e65 7477 ages from a netw │ │ │ │ -000044b0: 6f72 6b20 6279 2075 7369 6e67 2074 6865 ork by using the │ │ │ │ -000044c0: 2022 5446 5450 220a 2020 2020 2070 726f "TFTP". pro │ │ │ │ -000044d0: 746f 636f 6c2e 0a0a 5375 7070 6f72 7420 tocol...Support │ │ │ │ -000044e0: 7265 6d6f 7465 2074 6572 6d69 6e61 6c73 remote terminals │ │ │ │ -000044f0: 0a20 2020 2020 546f 2073 7570 706f 7274 . To support │ │ │ │ -00004500: 2063 6f6d 7075 7465 7273 2077 6974 6820 computers with │ │ │ │ -00004510: 6e6f 2063 6f6e 736f 6c65 2c20 4752 5542 no console, GRUB │ │ │ │ -00004520: 2070 726f 7669 6465 7320 7265 6d6f 7465 provides remote │ │ │ │ -00004530: 2074 6572 6d69 6e61 6c0a 2020 2020 2073 terminal. s │ │ │ │ -00004540: 7570 706f 7274 2c20 736f 2074 6861 7420 upport, so that │ │ │ │ -00004550: 796f 7520 6361 6e20 636f 6e74 726f 6c20 you can control │ │ │ │ -00004560: 4752 5542 2066 726f 6d20 6120 7265 6d6f GRUB from a remo │ │ │ │ -00004570: 7465 2068 6f73 742e 2020 4f6e 6c79 0a20 te host. Only. │ │ │ │ -00004580: 2020 2020 7365 7269 616c 2074 6572 6d69 serial termi │ │ │ │ -00004590: 6e61 6c20 7375 7070 6f72 7420 6973 2069 nal support is i │ │ │ │ -000045a0: 6d70 6c65 6d65 6e74 6564 2061 7420 7468 mplemented at th │ │ │ │ -000045b0: 6520 6d6f 6d65 6e74 2e0a 0a1f 0a46 696c e moment.....Fil │ │ │ │ -000045c0: 653a 2067 7275 622e 696e 666f 2c20 204e e: grub.info, N │ │ │ │ -000045d0: 6f64 653a 2046 6561 7475 7265 732d 466f ode: Features-Fo │ │ │ │ -000045e0: 6f74 6e6f 7465 732c 2020 5570 3a20 4665 otnotes, Up: Fe │ │ │ │ -000045f0: 6174 7572 6573 0a0a 2020 2028 3129 2054 atures.. (1) T │ │ │ │ -00004600: 6865 204e 6574 4253 442f 6933 3836 206b he NetBSD/i386 k │ │ │ │ -00004610: 6572 6e65 6c20 6973 204d 756c 7469 626f ernel is Multibo │ │ │ │ -00004620: 6f74 2d63 6f6d 706c 6961 6e74 2c20 6275 ot-compliant, bu │ │ │ │ -00004630: 7420 6c61 636b 7320 7375 7070 6f72 740a t lacks support. │ │ │ │ -00004640: 666f 7220 4d75 6c74 6962 6f6f 7420 6d6f for Multiboot mo │ │ │ │ -00004650: 6475 6c65 732e 0a0a 2020 2028 3229 204f dules... (2) O │ │ │ │ -00004660: 6e6c 7920 4352 4333 3220 6461 7461 2069 nly CRC32 data i │ │ │ │ -00004670: 6e74 6567 7269 7479 2063 6865 636b 2069 ntegrity check i │ │ │ │ -00004680: 7320 7375 7070 6f72 7465 6420 2878 7a20 s supported (xz │ │ │ │ -00004690: 6465 6661 756c 7420 6973 2043 5243 3634 default is CRC64 │ │ │ │ -000046a0: 0a73 6f20 6f6e 6520 7368 6f75 6c64 2075 .so one should u │ │ │ │ -000046b0: 7365 202d 6368 6563 6b3d 6372 6333 3220 se -check=crc32 │ │ │ │ -000046c0: 6f70 7469 6f6e 292e 2020 4c5a 4d41 2042 option). LZMA B │ │ │ │ -000046d0: 434a 2066 696c 7465 7273 2061 7265 2073 CJ filters are s │ │ │ │ -000046e0: 7570 706f 7274 6564 2e0a 0a20 2020 2833 upported... (3 │ │ │ │ -000046f0: 2920 5468 6572 6520 6172 6520 6120 6665 ) There are a fe │ │ │ │ -00004700: 7720 7061 7468 6f6c 6f67 6963 616c 2063 w pathological c │ │ │ │ -00004710: 6173 6573 2077 6865 7265 206c 6f61 6469 ases where loadi │ │ │ │ -00004720: 6e67 2061 2076 6572 7920 6261 646c 790a ng a very badly. │ │ │ │ -00004730: 6f72 6761 6e69 7a65 6420 454c 4620 6b65 organized ELF ke │ │ │ │ -00004740: 726e 656c 206d 6967 6874 2074 616b 6520 rnel might take │ │ │ │ -00004750: 6c6f 6e67 6572 2c20 6275 7420 696e 2070 longer, but in p │ │ │ │ -00004760: 7261 6374 6963 6520 7468 6973 206e 6576 ractice this nev │ │ │ │ -00004770: 6572 0a68 6170 7065 6e2e 0a0a 1f0a 4669 er.happen.....Fi │ │ │ │ -00004780: 6c65 3a20 6772 7562 2e69 6e66 6f2c 2020 le: grub.info, │ │ │ │ -00004790: 4e6f 6465 3a20 526f 6c65 206f 6620 6120 Node: Role of a │ │ │ │ -000047a0: 626f 6f74 206c 6f61 6465 722c 2020 5072 boot loader, Pr │ │ │ │ -000047b0: 6576 3a20 4665 6174 7572 6573 2c20 2055 ev: Features, U │ │ │ │ -000047c0: 703a 2049 6e74 726f 6475 6374 696f 6e0a p: Introduction. │ │ │ │ -000047d0: 0a31 2e35 2054 6865 2072 6f6c 6520 6f66 .1.5 The role of │ │ │ │ -000047e0: 2061 2062 6f6f 7420 6c6f 6164 6572 0a3d a boot loader.= │ │ │ │ -000047f0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ -00004800: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a 5468 ============..Th │ │ │ │ -00004810: 6520 666f 6c6c 6f77 696e 6720 6973 2061 e following is a │ │ │ │ -00004820: 2071 756f 7461 7469 6f6e 2066 726f 6d20 quotation from │ │ │ │ -00004830: 476f 7264 6f6e 204d 6174 7a69 676b 6569 Gordon Matzigkei │ │ │ │ -00004840: 742c 2061 2047 5255 4220 6661 6e61 7469 t, a GRUB fanati │ │ │ │ -00004850: 633a 0a0a 2020 2020 2053 6f6d 6520 7065 c:.. Some pe │ │ │ │ -00004860: 6f70 6c65 206c 696b 6520 746f 2061 636b ople like to ack │ │ │ │ -00004870: 6e6f 776c 6564 6765 2062 6f74 6820 7468 nowledge both th │ │ │ │ -00004880: 6520 6f70 6572 6174 696e 6720 7379 7374 e operating syst │ │ │ │ -00004890: 656d 2061 6e64 0a20 2020 2020 6b65 726e em and. kern │ │ │ │ -000048a0: 656c 2077 6865 6e20 7468 6579 2074 616c el when they tal │ │ │ │ -000048b0: 6b20 6162 6f75 7420 7468 6569 7220 636f k about their co │ │ │ │ -000048c0: 6d70 7574 6572 732c 2073 6f20 7468 6579 mputers, so they │ │ │ │ -000048d0: 206d 6967 6874 2073 6179 2074 6865 790a might say they. │ │ │ │ -000048e0: 2020 2020 2075 7365 2022 474e 552f 4c69 use "GNU/Li │ │ │ │ -000048f0: 6e75 7822 206f 7220 2247 4e55 2f48 7572 nux" or "GNU/Hur │ │ │ │ -00004900: 6422 2e20 204f 7468 6572 2070 656f 706c d". Other peopl │ │ │ │ -00004910: 6520 7365 656d 2074 6f20 7468 696e 6b20 e seem to think │ │ │ │ -00004920: 7468 6174 2074 6865 0a20 2020 2020 6b65 that the. ke │ │ │ │ -00004930: 726e 656c 2069 7320 7468 6520 6d6f 7374 rnel is the most │ │ │ │ -00004940: 2069 6d70 6f72 7461 6e74 2070 6172 7420 important part │ │ │ │ -00004950: 6f66 2074 6865 2073 7973 7465 6d2c 2073 of the system, s │ │ │ │ -00004960: 6f20 7468 6579 206c 696b 6520 746f 0a20 o they like to. │ │ │ │ -00004970: 2020 2020 6361 6c6c 2074 6865 6972 2047 call their G │ │ │ │ -00004980: 4e55 206f 7065 7261 7469 6e67 2073 7973 NU operating sys │ │ │ │ -00004990: 7465 6d73 2022 4c69 6e75 7820 7379 7374 tems "Linux syst │ │ │ │ -000049a0: 656d 732e 220a 0a20 2020 2020 492c 2070 ems.".. I, p │ │ │ │ -000049b0: 6572 736f 6e61 6c6c 792c 2062 656c 6965 ersonally, belie │ │ │ │ -000049c0: 7665 2074 6861 7420 7468 6973 2069 7320 ve that this is │ │ │ │ -000049d0: 6120 6772 6176 6520 696e 6a75 7374 6963 a grave injustic │ │ │ │ -000049e0: 652c 2062 6563 6175 7365 2074 6865 0a20 e, because the. │ │ │ │ -000049f0: 2020 2020 5f62 6f6f 7420 6c6f 6164 6572 _boot loader │ │ │ │ -00004a00: 5f20 6973 2074 6865 206d 6f73 7420 696d _ is the most im │ │ │ │ -00004a10: 706f 7274 616e 7420 736f 6674 7761 7265 portant software │ │ │ │ -00004a20: 206f 6620 616c 6c2e 2020 4920 7573 6564 of all. I used │ │ │ │ -00004a30: 2074 6f0a 2020 2020 2072 6566 6572 2074 to. refer t │ │ │ │ -00004a40: 6f20 7468 6520 6162 6f76 6520 7379 7374 o the above syst │ │ │ │ -00004a50: 656d 7320 6173 2065 6974 6865 7220 224c ems as either "L │ │ │ │ -00004a60: 494c 4f22 2831 2920 282a 6e6f 7465 2052 ILO"(1) (*note R │ │ │ │ -00004a70: 6f6c 6520 6f66 2061 0a20 2020 2020 626f ole of a. bo │ │ │ │ -00004a80: 6f74 206c 6f61 6465 722d 466f 6f74 6e6f ot loader-Footno │ │ │ │ -00004a90: 7465 2d31 3a3a 2920 6f72 2022 4752 5542 te-1::) or "GRUB │ │ │ │ -00004aa0: 2220 7379 7374 656d 732e 0a0a 2020 2020 " systems... │ │ │ │ -00004ab0: 2055 6e66 6f72 7475 6e61 7465 6c79 2c20 Unfortunately, │ │ │ │ -00004ac0: 6e6f 626f 6479 2065 7665 7220 756e 6465 nobody ever unde │ │ │ │ -00004ad0: 7273 746f 6f64 2077 6861 7420 4920 7761 rstood what I wa │ │ │ │ -00004ae0: 7320 7461 6c6b 696e 6720 6162 6f75 743b s talking about; │ │ │ │ -00004af0: 206e 6f77 0a20 2020 2020 4920 6a75 7374 now. I just │ │ │ │ -00004b00: 2075 7365 2074 6865 2077 6f72 6420 2247 use the word "G │ │ │ │ -00004b10: 4e55 2220 6173 2061 2070 7365 7564 6f6e NU" as a pseudon │ │ │ │ -00004b20: 796d 2066 6f72 2047 5255 422e 0a0a 2020 ym for GRUB... │ │ │ │ -00004b30: 2020 2053 6f2c 2069 6620 796f 7520 6576 So, if you ev │ │ │ │ -00004b40: 6572 2068 6561 7220 7065 6f70 6c65 2074 er hear people t │ │ │ │ -00004b50: 616c 6b69 6e67 2061 626f 7574 2074 6865 alking about the │ │ │ │ -00004b60: 6972 2061 6c6c 6567 6564 2022 474e 5522 ir alleged "GNU" │ │ │ │ -00004b70: 0a20 2020 2020 7379 7374 656d 732c 2072 . systems, r │ │ │ │ -00004b80: 656d 656d 6265 7220 7468 6174 2074 6865 emember that the │ │ │ │ -00004b90: 7920 6172 6520 6163 7475 616c 6c79 2070 y are actually p │ │ │ │ -00004ba0: 6179 696e 6720 686f 6d61 6765 2074 6f20 aying homage to │ │ │ │ -00004bb0: 7468 6520 6265 7374 0a20 2020 2020 626f the best. bo │ │ │ │ -00004bc0: 6f74 206c 6f61 6465 7220 6172 6f75 6e64 ot loader around │ │ │ │ -00004bd0: 2e2e 2e20 4752 5542 210a 0a20 2020 5765 ... GRUB!.. We │ │ │ │ -00004be0: 2c20 7468 6520 4752 5542 206d 6169 6e74 , the GRUB maint │ │ │ │ -00004bf0: 6169 6e65 7273 2c20 646f 206e 6f74 2028 ainers, do not ( │ │ │ │ -00004c00: 7573 7561 6c6c 7929 2065 6e63 6f75 7261 usually) encoura │ │ │ │ -00004c10: 6765 2047 6f72 646f 6e27 7320 6c65 7665 ge Gordon's leve │ │ │ │ -00004c20: 6c0a 6f66 2066 616e 6174 6963 6973 6d2c l.of fanaticism, │ │ │ │ -00004c30: 2062 7574 2069 7420 6865 6c70 7320 746f but it helps to │ │ │ │ -00004c40: 2072 656d 656d 6265 7220 7468 6174 2062 remember that b │ │ │ │ -00004c50: 6f6f 7420 6c6f 6164 6572 7320 6465 7365 oot loaders dese │ │ │ │ -00004c60: 7276 650a 7265 636f 676e 6974 696f 6e2e rve.recognition. │ │ │ │ -00004c70: 2020 5765 2068 6f70 6520 7468 6174 2079 We hope that y │ │ │ │ -00004c80: 6f75 2065 6e6a 6f79 2075 7369 6e67 2047 ou enjoy using G │ │ │ │ -00004c90: 4e55 2047 5255 4220 6173 206d 7563 6820 NU GRUB as much │ │ │ │ -00004ca0: 6173 2077 6520 6469 640a 7772 6974 696e as we did.writin │ │ │ │ -00004cb0: 6720 6974 2e0a 0a1f 0a46 696c 653a 2067 g it.....File: g │ │ │ │ -00004cc0: 7275 622e 696e 666f 2c20 204e 6f64 653a rub.info, Node: │ │ │ │ -00004cd0: 2052 6f6c 6520 6f66 2061 2062 6f6f 7420 Role of a boot │ │ │ │ -00004ce0: 6c6f 6164 6572 2d46 6f6f 746e 6f74 6573 loader-Footnotes │ │ │ │ -00004cf0: 2c20 2055 703a 2052 6f6c 6520 6f66 2061 , Up: Role of a │ │ │ │ -00004d00: 2062 6f6f 7420 6c6f 6164 6572 0a0a 2020 boot loader.. │ │ │ │ -00004d10: 2028 3129 2054 6865 204c 496e 7578 204c (1) The LInux L │ │ │ │ -00004d20: 4f61 6465 722c 2061 2062 6f6f 7420 6c6f Oader, a boot lo │ │ │ │ -00004d30: 6164 6572 2074 6861 7420 6576 6572 7962 ader that everyb │ │ │ │ -00004d40: 6f64 7920 7573 6573 2c20 6275 7420 6e6f ody uses, but no │ │ │ │ -00004d50: 626f 6479 0a6c 696b 6573 2e0a 0a1f 0a46 body.likes.....F │ │ │ │ -00004d60: 696c 653a 2067 7275 622e 696e 666f 2c20 ile: grub.info, │ │ │ │ -00004d70: 204e 6f64 653a 204e 616d 696e 6720 636f Node: Naming co │ │ │ │ -00004d80: 6e76 656e 7469 6f6e 2c20 204e 6578 743a nvention, Next: │ │ │ │ -00004d90: 204f 532d 7370 6563 6966 6963 206e 6f74 OS-specific not │ │ │ │ -00004da0: 6573 2061 626f 7574 2067 7275 6220 746f es about grub to │ │ │ │ -00004db0: 6f6c 732c 2020 5072 6576 3a20 496e 7472 ols, Prev: Intr │ │ │ │ -00004dc0: 6f64 7563 7469 6f6e 2c20 2055 703a 2054 oduction, Up: T │ │ │ │ -00004dd0: 6f70 0a0a 3220 4e61 6d69 6e67 2063 6f6e op..2 Naming con │ │ │ │ -00004de0: 7665 6e74 696f 6e0a 2a2a 2a2a 2a2a 2a2a vention.******** │ │ │ │ -00004df0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a0a 0a54 6865 ***********..The │ │ │ │ -00004e00: 2064 6576 6963 6520 7379 6e74 6178 2075 device syntax u │ │ │ │ -00004e10: 7365 6420 696e 2047 5255 4220 6973 2061 sed in GRUB is a │ │ │ │ -00004e20: 2077 6565 2062 6974 2064 6966 6665 7265 wee bit differe │ │ │ │ -00004e30: 6e74 2066 726f 6d20 7768 6174 2079 6f75 nt from what you │ │ │ │ -00004e40: 206d 6179 0a68 6176 6520 7365 656e 2062 may.have seen b │ │ │ │ -00004e50: 6566 6f72 6520 696e 2079 6f75 7220 6f70 efore in your op │ │ │ │ -00004e60: 6572 6174 696e 6720 7379 7374 656d 2873 erating system(s │ │ │ │ -00004e70: 292c 2061 6e64 2079 6f75 206e 6565 6420 ), and you need │ │ │ │ -00004e80: 746f 206b 6e6f 7720 6974 2073 6f0a 7468 to know it so.th │ │ │ │ -00004e90: 6174 2079 6f75 2063 616e 2073 7065 6369 at you can speci │ │ │ │ -00004ea0: 6679 2061 2064 7269 7665 2f70 6172 7469 fy a drive/parti │ │ │ │ -00004eb0: 7469 6f6e 2e0a 0a20 2020 4c6f 6f6b 2061 tion... Look a │ │ │ │ -00004ec0: 7420 7468 6520 666f 6c6c 6f77 696e 6720 t the following │ │ │ │ -00004ed0: 6578 616d 706c 6573 2061 6e64 2065 7870 examples and exp │ │ │ │ -00004ee0: 6c61 6e61 7469 6f6e 733a 0a0a 2020 2020 lanations:.. │ │ │ │ -00004ef0: 2028 6664 3029 0a0a 2020 2046 6972 7374 (fd0).. First │ │ │ │ -00004f00: 206f 6620 616c 6c2c 2047 5255 4220 7265 of all, GRUB re │ │ │ │ -00004f10: 7175 6972 6573 2074 6861 7420 7468 6520 quires that the │ │ │ │ -00004f20: 6465 7669 6365 206e 616d 6520 6265 2065 device name be e │ │ │ │ -00004f30: 6e63 6c6f 7365 6420 7769 7468 2027 2827 nclosed with '(' │ │ │ │ -00004f40: 0a61 6e64 2027 2927 2e20 2054 6865 2027 .and ')'. The ' │ │ │ │ -00004f50: 6664 2720 7061 7274 206d 6561 6e73 2074 fd' part means t │ │ │ │ -00004f60: 6861 7420 6974 2069 7320 6120 666c 6f70 hat it is a flop │ │ │ │ -00004f70: 7079 2064 6973 6b2e 2020 5468 6520 6e75 py disk. The nu │ │ │ │ -00004f80: 6d62 6572 2027 3027 0a69 7320 7468 6520 mber '0'.is the │ │ │ │ -00004f90: 6472 6976 6520 6e75 6d62 6572 2c20 7768 drive number, wh │ │ │ │ -00004fa0: 6963 6820 6973 2063 6f75 6e74 6564 2066 ich is counted f │ │ │ │ -00004fb0: 726f 6d20 5f7a 6572 6f5f 2e20 2054 6869 rom _zero_. Thi │ │ │ │ -00004fc0: 7320 6578 7072 6573 7369 6f6e 0a6d 6561 s expression.mea │ │ │ │ -00004fd0: 6e73 2074 6861 7420 4752 5542 2077 696c ns that GRUB wil │ │ │ │ -00004fe0: 6c20 7573 6520 7468 6520 7768 6f6c 6520 l use the whole │ │ │ │ -00004ff0: 666c 6f70 7079 2064 6973 6b2e 0a0a 2020 floppy disk... │ │ │ │ -00005000: 2020 2028 6864 302c 6d73 646f 7332 290a (hd0,msdos2). │ │ │ │ -00005010: 0a20 2020 4865 7265 2c20 2768 6427 206d . Here, 'hd' m │ │ │ │ -00005020: 6561 6e73 2069 7420 6973 2061 2068 6172 eans it is a har │ │ │ │ -00005030: 6420 6469 736b 2064 7269 7665 2e20 2054 d disk drive. T │ │ │ │ -00005040: 6865 2066 6972 7374 2069 6e74 6567 6572 he first integer │ │ │ │ -00005050: 2027 3027 0a69 6e64 6963 6174 6573 2074 '0'.indicates t │ │ │ │ -00005060: 6865 2064 7269 7665 206e 756d 6265 722c he drive number, │ │ │ │ -00005070: 2074 6861 7420 6973 2c20 7468 6520 6669 that is, the fi │ │ │ │ -00005080: 7273 7420 6861 7264 2064 6973 6b2c 2074 rst hard disk, t │ │ │ │ -00005090: 6865 2073 7472 696e 670a 276d 7364 6f73 he string.'msdos │ │ │ │ -000050a0: 2720 696e 6469 6361 7465 7320 7468 6520 ' indicates the │ │ │ │ -000050b0: 7061 7274 6974 696f 6e20 7363 6865 6d65 partition scheme │ │ │ │ -000050c0: 2c20 7768 696c 6520 7468 6520 7365 636f , while the seco │ │ │ │ -000050d0: 6e64 2069 6e74 6567 6572 2c20 2732 272c nd integer, '2', │ │ │ │ -000050e0: 0a69 6e64 6963 6174 6573 2074 6865 2070 .indicates the p │ │ │ │ -000050f0: 6172 7469 7469 6f6e 206e 756d 6265 7220 artition number │ │ │ │ -00005100: 286f 7220 7468 6520 5043 2073 6c69 6365 (or the PC slice │ │ │ │ -00005110: 206e 756d 6265 7220 696e 2074 6865 2042 number in the B │ │ │ │ -00005120: 5344 0a74 6572 6d69 6e6f 6c6f 6779 292e SD.terminology). │ │ │ │ -00005130: 2020 5468 6520 7061 7274 6974 696f 6e20 The partition │ │ │ │ -00005140: 6e75 6d62 6572 7320 6172 6520 636f 756e numbers are coun │ │ │ │ -00005150: 7465 6420 6672 6f6d 205f 6f6e 655f 2c20 ted from _one_, │ │ │ │ -00005160: 6e6f 7420 6672 6f6d 0a7a 6572 6f20 2861 not from.zero (a │ │ │ │ -00005170: 7320 7761 7320 7468 6520 6361 7365 2069 s was the case i │ │ │ │ -00005180: 6e20 7072 6576 696f 7573 2076 6572 7369 n previous versi │ │ │ │ -00005190: 6f6e 7320 6f66 2047 5255 4229 2e20 5468 ons of GRUB). Th │ │ │ │ -000051a0: 6973 2065 7870 7265 7373 696f 6e0a 6d65 is expression.me │ │ │ │ -000051b0: 616e 7320 7468 6520 7365 636f 6e64 2070 ans the second p │ │ │ │ -000051c0: 6172 7469 7469 6f6e 206f 6620 7468 6520 artition of the │ │ │ │ -000051d0: 6669 7273 7420 6861 7264 2064 6973 6b20 first hard disk │ │ │ │ -000051e0: 6472 6976 652e 2020 496e 2074 6869 7320 drive. In this │ │ │ │ -000051f0: 6361 7365 2c0a 4752 5542 2075 7365 7320 case,.GRUB uses │ │ │ │ -00005200: 6f6e 6520 7061 7274 6974 696f 6e20 6f66 one partition of │ │ │ │ -00005210: 2074 6865 2064 6973 6b2c 2069 6e73 7465 the disk, inste │ │ │ │ -00005220: 6164 206f 6620 7468 6520 7768 6f6c 6520 ad of the whole │ │ │ │ -00005230: 6469 736b 2e0a 0a20 2020 2020 2868 6430 disk... (hd0 │ │ │ │ -00005240: 2c6d 7364 6f73 3529 0a0a 2020 2054 6869 ,msdos5).. Thi │ │ │ │ -00005250: 7320 7370 6563 6966 6965 7320 7468 6520 s specifies the │ │ │ │ -00005260: 6669 7273 7420 2265 7874 656e 6465 6420 first "extended │ │ │ │ -00005270: 7061 7274 6974 696f 6e22 206f 6620 7468 partition" of th │ │ │ │ -00005280: 6520 6669 7273 7420 6861 7264 2064 6973 e first hard dis │ │ │ │ -00005290: 6b0a 6472 6976 652e 2020 4e6f 7465 2074 k.drive. Note t │ │ │ │ -000052a0: 6861 7420 7468 6520 7061 7274 6974 696f hat the partitio │ │ │ │ -000052b0: 6e20 6e75 6d62 6572 7320 666f 7220 6578 n numbers for ex │ │ │ │ -000052c0: 7465 6e64 6564 2070 6172 7469 7469 6f6e tended partition │ │ │ │ -000052d0: 7320 6172 650a 636f 756e 7465 6420 6672 s are.counted fr │ │ │ │ -000052e0: 6f6d 2027 3527 2c20 7265 6761 7264 6c65 om '5', regardle │ │ │ │ -000052f0: 7373 206f 6620 7468 6520 6163 7475 616c ss of the actual │ │ │ │ -00005300: 206e 756d 6265 7220 6f66 2070 7269 6d61 number of prima │ │ │ │ -00005310: 7279 2070 6172 7469 7469 6f6e 730a 6f6e ry partitions.on │ │ │ │ -00005320: 2079 6f75 7220 6861 7264 2064 6973 6b2e your hard disk. │ │ │ │ -00005330: 0a0a 2020 2020 2028 6864 312c 6d73 646f .. (hd1,msdo │ │ │ │ -00005340: 7331 2c62 7364 3129 0a0a 2020 2054 6869 s1,bsd1).. Thi │ │ │ │ -00005350: 7320 6d65 616e 7320 7468 6520 4253 4420 s means the BSD │ │ │ │ -00005360: 2761 2720 7061 7274 6974 696f 6e20 6f6e 'a' partition on │ │ │ │ -00005370: 2066 6972 7374 2050 4320 736c 6963 6520 first PC slice │ │ │ │ -00005380: 6e75 6d62 6572 206f 6620 7468 650a 7365 number of the.se │ │ │ │ -00005390: 636f 6e64 2068 6172 6420 6469 736b 2e0a cond hard disk.. │ │ │ │ -000053a0: 0a20 2020 4f66 2063 6f75 7273 652c 2074 . Of course, t │ │ │ │ -000053b0: 6f20 6163 7475 616c 6c79 2061 6363 6573 o actually acces │ │ │ │ -000053c0: 7320 7468 6520 6469 736b 7320 6f72 2070 s the disks or p │ │ │ │ -000053d0: 6172 7469 7469 6f6e 7320 7769 7468 2047 artitions with G │ │ │ │ -000053e0: 5255 422c 2079 6f75 0a6e 6565 6420 746f RUB, you.need to │ │ │ │ -000053f0: 2075 7365 2074 6865 2064 6576 6963 6520 use the device │ │ │ │ -00005400: 7370 6563 6966 6963 6174 696f 6e20 696e specification in │ │ │ │ -00005410: 2061 2063 6f6d 6d61 6e64 2c20 6c69 6b65 a command, like │ │ │ │ -00005420: 2027 7365 7420 726f 6f74 3d28 6664 3029 'set root=(fd0) │ │ │ │ -00005430: 270a 6f72 2027 7061 7274 746f 6f6c 2028 '.or 'parttool ( │ │ │ │ -00005440: 6864 302c 6d73 646f 7333 2920 6869 6464 hd0,msdos3) hidd │ │ │ │ -00005450: 656e 2d27 2e20 2054 6f20 6865 6c70 2079 en-'. To help y │ │ │ │ -00005460: 6f75 2066 696e 6420 6f75 7420 7768 6963 ou find out whic │ │ │ │ -00005470: 6820 6e75 6d62 6572 0a73 7065 6369 6669 h number.specifi │ │ │ │ -00005480: 6573 2061 2070 6172 7469 7469 6f6e 2079 es a partition y │ │ │ │ -00005490: 6f75 2077 616e 742c 2074 6865 2047 5255 ou want, the GRU │ │ │ │ -000054a0: 4220 636f 6d6d 616e 642d 6c69 6e65 2028 B command-line ( │ │ │ │ -000054b0: 2a6e 6f74 650a 436f 6d6d 616e 642d 6c69 *note.Command-li │ │ │ │ -000054c0: 6e65 2069 6e74 6572 6661 6365 3a3a 2920 ne interface::) │ │ │ │ -000054d0: 6f70 7469 6f6e 7320 6861 7665 2061 7267 options have arg │ │ │ │ -000054e0: 756d 656e 7420 636f 6d70 6c65 7469 6f6e ument completion │ │ │ │ -000054f0: 2e20 2054 6869 7320 6d65 616e 730a 7468 . This means.th │ │ │ │ -00005500: 6174 2c20 666f 7220 6578 616d 706c 652c at, for example, │ │ │ │ -00005510: 2079 6f75 206f 6e6c 7920 6e65 6564 2074 you only need t │ │ │ │ -00005520: 6f20 7479 7065 0a0a 2020 2020 2073 6574 o type.. set │ │ │ │ -00005530: 2072 6f6f 743d 280a 0a20 2020 666f 6c6c root=(.. foll │ │ │ │ -00005540: 6f77 6564 2062 7920 6120 3c54 4142 3e2c owed by a , │ │ │ │ -00005550: 2061 6e64 2047 5255 4220 7769 6c6c 2064 and GRUB will d │ │ │ │ -00005560: 6973 706c 6179 2074 6865 206c 6973 7420 isplay the list │ │ │ │ -00005570: 6f66 2064 7269 7665 732c 0a70 6172 7469 of drives,.parti │ │ │ │ -00005580: 7469 6f6e 732c 206f 7220 6669 6c65 206e tions, or file n │ │ │ │ -00005590: 616d 6573 2e20 2053 6f20 6974 2073 686f ames. So it sho │ │ │ │ -000055a0: 756c 6420 6265 2071 7569 7465 2065 6173 uld be quite eas │ │ │ │ -000055b0: 7920 746f 2064 6574 6572 6d69 6e65 2074 y to determine t │ │ │ │ -000055c0: 6865 0a6e 616d 6520 6f66 2079 6f75 7220 he.name of your │ │ │ │ -000055d0: 7461 7267 6574 2070 6172 7469 7469 6f6e target partition │ │ │ │ -000055e0: 2c20 6576 656e 2077 6974 6820 6d69 6e69 , even with mini │ │ │ │ -000055f0: 6d61 6c20 6b6e 6f77 6c65 6467 6520 6f66 mal knowledge of │ │ │ │ -00005600: 2074 6865 0a73 796e 7461 782e 0a0a 2020 the.syntax... │ │ │ │ -00005610: 204e 6f74 6520 7468 6174 2047 5255 4220 Note that GRUB │ │ │ │ -00005620: 646f 6573 205f 6e6f 745f 2064 6973 7469 does _not_ disti │ │ │ │ -00005630: 6e67 7569 7368 2049 4445 2066 726f 6d20 nguish IDE from │ │ │ │ -00005640: 5343 5349 202d 2069 7420 7369 6d70 6c79 SCSI - it simply │ │ │ │ -00005650: 0a63 6f75 6e74 7320 7468 6520 6472 6976 .counts the driv │ │ │ │ -00005660: 6520 6e75 6d62 6572 7320 6672 6f6d 207a e numbers from z │ │ │ │ -00005670: 6572 6f2c 2072 6567 6172 646c 6573 7320 ero, regardless │ │ │ │ -00005680: 6f66 2074 6865 6972 2074 7970 652e 2020 of their type. │ │ │ │ -00005690: 4e6f 726d 616c 6c79 2c0a 616e 7920 4944 Normally,.any ID │ │ │ │ -000056a0: 4520 6472 6976 6520 6e75 6d62 6572 2069 E drive number i │ │ │ │ -000056b0: 7320 6c65 7373 2074 6861 6e20 616e 7920 s less than any │ │ │ │ -000056c0: 5343 5349 2064 7269 7665 206e 756d 6265 SCSI drive numbe │ │ │ │ -000056d0: 722c 2061 6c74 686f 7567 6820 7468 6174 r, although that │ │ │ │ -000056e0: 0a69 7320 6e6f 7420 7472 7565 2069 6620 .is not true if │ │ │ │ -000056f0: 796f 7520 6368 616e 6765 2074 6865 2062 you change the b │ │ │ │ -00005700: 6f6f 7420 7365 7175 656e 6365 2062 7920 oot sequence by │ │ │ │ -00005710: 7377 6170 7069 6e67 2049 4445 2061 6e64 swapping IDE and │ │ │ │ -00005720: 2053 4353 490a 6472 6976 6573 2069 6e20 SCSI.drives in │ │ │ │ -00005730: 796f 7572 2042 494f 532e 0a0a 2020 204e your BIOS... N │ │ │ │ -00005740: 6f77 2074 6865 2071 7565 7374 696f 6e20 ow the question │ │ │ │ -00005750: 6973 2c20 686f 7720 746f 2073 7065 6369 is, how to speci │ │ │ │ -00005760: 6679 2061 2066 696c 653f 2020 4167 6169 fy a file? Agai │ │ │ │ -00005770: 6e2c 2063 6f6e 7369 6465 7220 616e 0a65 n, consider an.e │ │ │ │ -00005780: 7861 6d70 6c65 3a0a 0a20 2020 2020 2868 xample:.. (h │ │ │ │ -00005790: 6430 2c6d 7364 6f73 3129 2f76 6d6c 696e d0,msdos1)/vmlin │ │ │ │ -000057a0: 757a 0a0a 2020 2054 6869 7320 7370 6563 uz.. This spec │ │ │ │ -000057b0: 6966 6965 7320 7468 6520 6669 6c65 206e ifies the file n │ │ │ │ -000057c0: 616d 6564 2027 766d 6c69 6e75 7a27 2c20 amed 'vmlinuz', │ │ │ │ -000057d0: 666f 756e 6420 6f6e 2074 6865 2066 6972 found on the fir │ │ │ │ -000057e0: 7374 2070 6172 7469 7469 6f6e 0a6f 6620 st partition.of │ │ │ │ -000057f0: 7468 6520 6669 7273 7420 6861 7264 2064 the first hard d │ │ │ │ -00005800: 6973 6b20 6472 6976 652e 2020 4e6f 7465 isk drive. Note │ │ │ │ -00005810: 2074 6861 7420 7468 6520 6172 6775 6d65 that the argume │ │ │ │ -00005820: 6e74 2063 6f6d 706c 6574 696f 6e20 776f nt completion wo │ │ │ │ -00005830: 726b 730a 7769 7468 2066 696c 6520 6e61 rks.with file na │ │ │ │ -00005840: 6d65 732c 2074 6f6f 2e0a 0a20 2020 5468 mes, too... Th │ │ │ │ -00005850: 6174 2077 6173 2065 6173 792c 2061 646d at was easy, adm │ │ │ │ -00005860: 6974 2069 742e 2020 4e6f 7720 7265 6164 it it. Now read │ │ │ │ -00005870: 2074 6865 206e 6578 7420 6368 6170 7465 the next chapte │ │ │ │ -00005880: 722c 2074 6f20 6669 6e64 206f 7574 2068 r, to find out h │ │ │ │ -00005890: 6f77 0a74 6f20 6163 7475 616c 6c79 2069 ow.to actually i │ │ │ │ -000058a0: 6e73 7461 6c6c 2047 5255 4220 6f6e 2079 nstall GRUB on y │ │ │ │ -000058b0: 6f75 7220 6472 6976 652e 0a0a 1f0a 4669 our drive.....Fi │ │ │ │ -000058c0: 6c65 3a20 6772 7562 2e69 6e66 6f2c 2020 le: grub.info, │ │ │ │ -000058d0: 4e6f 6465 3a20 4f53 2d73 7065 6369 6669 Node: OS-specifi │ │ │ │ -000058e0: 6320 6e6f 7465 7320 6162 6f75 7420 6772 c notes about gr │ │ │ │ -000058f0: 7562 2074 6f6f 6c73 2c20 204e 6578 743a ub tools, Next: │ │ │ │ -00005900: 2049 6e73 7461 6c6c 6174 696f 6e2c 2020 Installation, │ │ │ │ -00005910: 5072 6576 3a20 4e61 6d69 6e67 2063 6f6e Prev: Naming con │ │ │ │ -00005920: 7665 6e74 696f 6e2c 2020 5570 3a20 546f vention, Up: To │ │ │ │ -00005930: 700a 0a33 204f 532d 7370 6563 6966 6963 p..3 OS-specific │ │ │ │ -00005940: 206e 6f74 6573 2061 626f 7574 2067 7275 notes about gru │ │ │ │ -00005950: 6220 746f 6f6c 730a 2a2a 2a2a 2a2a 2a2a b tools.******** │ │ │ │ +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.============= │ │ │ │ +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.**** │ │ │ │ 00005960: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ -00005970: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 0a0a 4f6e ************..On │ │ │ │ -00005980: 204f 5320 7768 6963 6820 6861 7665 2064 OS which have d │ │ │ │ -00005990: 6576 6963 6520 6e6f 6465 7320 7369 6d69 evice nodes simi │ │ │ │ -000059a0: 6c61 7220 746f 2055 6e69 782d 6c69 6b65 lar to Unix-like │ │ │ │ -000059b0: 204f 5320 4752 5542 2074 6f6f 6c73 2075 OS GRUB tools u │ │ │ │ -000059c0: 7365 2074 6865 0a4f 5320 6e61 6d65 2e20 se the.OS name. │ │ │ │ -000059d0: 2045 2e67 2e20 2066 6f72 2047 4e55 2f4c E.g. for GNU/L │ │ │ │ -000059e0: 696e 7578 3a0a 0a20 2020 2020 2320 6772 inux:.. # gr │ │ │ │ -000059f0: 7562 2d69 6e73 7461 6c6c 202f 6465 762f ub-install /dev/ │ │ │ │ -00005a00: 7364 610a 0a20 2020 4f6e 2041 524f 5320 sda.. On AROS │ │ │ │ -00005a10: 7765 2075 7365 2061 6e6f 7468 6572 2073 we use another s │ │ │ │ -00005a20: 796e 7461 782e 2020 466f 7220 766f 6c75 yntax. For volu │ │ │ │ -00005a30: 6d65 733a 0a0a 2020 2020 202f 2f3a 3c76 mes:.. //:.. │ │ │ │ -00005a50: 452e 672e 0a0a 2020 2020 202f 2f3a 4448 E.g... //:DH │ │ │ │ -00005a60: 300a 0a20 2020 466f 7220 6469 736b 7320 0.. For disks │ │ │ │ -00005a70: 7765 2075 7365 2073 796e 7461 783a 0a20 we use syntax:. │ │ │ │ -00005a80: 2020 2020 2f2f 3a3c 6472 6976 6572 206e //:/unit/flags. │ │ │ │ -00005aa0: 0a20 2020 452e 672e 0a0a 2020 2020 2023 . E.g... # │ │ │ │ -00005ab0: 2067 7275 622d 696e 7374 616c 6c20 2f2f grub-install // │ │ │ │ -00005ac0: 3a61 7461 2e64 6576 6963 652f 302f 300a :ata.device/0/0. │ │ │ │ -00005ad0: 0a20 2020 4f6e 2057 696e 646f 7773 2077 . On Windows w │ │ │ │ -00005ae0: 6520 7573 6520 554e 4320 7061 7468 2e20 e use UNC path. │ │ │ │ -00005af0: 2046 6f72 2076 6f6c 756d 6573 2069 7427 For volumes it' │ │ │ │ -00005b00: 7320 7479 7069 6361 6c6c 790a 0a20 2020 s typically.. │ │ │ │ -00005b10: 2020 5c5c 3f5c 566f 6c75 6d65 7b3c 4755 \\?\Volume{}. \\?\:.. │ │ │ │ -00005b40: 2020 452e 672e 0a0a 2020 2020 205c 5c3f E.g... \\? │ │ │ │ -00005b50: 5c56 6f6c 756d 657b 3137 6633 3464 3530 \Volume{17f34d50 │ │ │ │ -00005b60: 2d63 6636 342d 3462 3032 2d38 3030 652d -cf64-4b02-800e- │ │ │ │ -00005b70: 3531 6437 3963 3361 6132 6666 7d0a 2020 51d79c3aa2ff}. │ │ │ │ -00005b80: 2020 205c 5c3f 5c43 3a0a 0a20 2020 466f \\?\C:.. Fo │ │ │ │ -00005b90: 7220 6469 736b 7320 6974 2773 0a0a 2020 r disks it's.. │ │ │ │ -00005ba0: 2020 205c 5c3f 5c50 6879 7369 6361 6c44 \\?\PhysicalD │ │ │ │ -00005bb0: 7269 7665 3c6e 756d 6265 723e 0a0a 2020 rive.. │ │ │ │ -00005bc0: 2045 2e67 2e0a 0a20 2020 2020 2320 6772 E.g... # gr │ │ │ │ -00005bd0: 7562 2d69 6e73 7461 6c6c 205c 5c3f 5c50 ub-install \\?\P │ │ │ │ -00005be0: 6879 7369 6361 6c44 7269 7665 300a 0a20 hysicalDrive0.. │ │ │ │ -00005bf0: 2020 4265 7761 7265 2074 6861 7420 796f Beware that yo │ │ │ │ -00005c00: 7520 6d61 7920 6e65 6564 2074 6f20 6675 u may need to fu │ │ │ │ -00005c10: 7274 6865 7220 6573 6361 7065 2074 6865 rther escape the │ │ │ │ -00005c20: 2062 6163 6b73 6c61 7368 6573 2064 6570 backslashes dep │ │ │ │ -00005c30: 656e 6469 6e67 0a6f 6e20 796f 7572 2073 ending.on your s │ │ │ │ -00005c40: 6865 6c6c 2e0a 0a20 2020 5768 656e 2063 hell... When c │ │ │ │ -00005c50: 6f6d 7069 6c65 6420 7769 7468 2063 7967 ompiled with cyg │ │ │ │ -00005c60: 7769 6e20 7375 7070 6f72 7420 7468 656e win support then │ │ │ │ -00005c70: 2063 7967 7769 6e20 6472 6976 6520 6e61 cygwin drive na │ │ │ │ -00005c80: 6d65 7320 6172 650a 6175 746f 6d61 7469 mes are.automati │ │ │ │ -00005c90: 6361 6c6c 7920 7768 656e 206e 6565 6465 cally when neede │ │ │ │ -00005ca0: 642e 2020 452e 672e 0a0a 2020 2020 2023 d. E.g... # │ │ │ │ -00005cb0: 2067 7275 622d 696e 7374 616c 6c20 2f64 grub-install /d │ │ │ │ -00005cc0: 6576 2f73 6461 0a0a 1f0a 4669 6c65 3a20 ev/sda....File: │ │ │ │ -00005cd0: 6772 7562 2e69 6e66 6f2c 2020 4e6f 6465 grub.info, Node │ │ │ │ -00005ce0: 3a20 496e 7374 616c 6c61 7469 6f6e 2c20 : Installation, │ │ │ │ -00005cf0: 204e 6578 743a 2042 6f6f 7469 6e67 2c20 Next: Booting, │ │ │ │ -00005d00: 2050 7265 763a 204f 532d 7370 6563 6966 Prev: OS-specif │ │ │ │ -00005d10: 6963 206e 6f74 6573 2061 626f 7574 2067 ic notes about g │ │ │ │ -00005d20: 7275 6220 746f 6f6c 732c 2020 5570 3a20 rub tools, Up: │ │ │ │ -00005d30: 546f 700a 0a34 2049 6e73 7461 6c6c 6174 Top..4 Installat │ │ │ │ -00005d40: 696f 6e0a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a ion.************ │ │ │ │ -00005d50: 2a2a 0a0a 496e 206f 7264 6572 2074 6f20 **..In order to │ │ │ │ -00005d60: 696e 7374 616c 6c20 4752 5542 2061 7320 install GRUB as │ │ │ │ -00005d70: 796f 7572 2062 6f6f 7420 6c6f 6164 6572 your boot loader │ │ │ │ -00005d80: 2c20 796f 7520 6e65 6564 2074 6f20 6669 , you need to fi │ │ │ │ -00005d90: 7273 7420 696e 7374 616c 6c0a 7468 6520 rst install.the │ │ │ │ -00005da0: 4752 5542 2073 7973 7465 6d20 616e 6420 GRUB system and │ │ │ │ -00005db0: 7574 696c 6974 6965 7320 756e 6465 7220 utilities under │ │ │ │ -00005dc0: 796f 7572 2055 4e49 582d 6c69 6b65 206f your UNIX-like o │ │ │ │ -00005dd0: 7065 7261 7469 6e67 2073 7973 7465 6d0a perating system. │ │ │ │ -00005de0: 282a 6e6f 7465 204f 6274 6169 6e69 6e67 (*note Obtaining │ │ │ │ -00005df0: 2061 6e64 2042 7569 6c64 696e 6720 4752 and Building GR │ │ │ │ -00005e00: 5542 3a3a 292e 2020 596f 7520 6361 6e20 UB::). You can │ │ │ │ -00005e10: 646f 2074 6869 7320 6569 7468 6572 2066 do this either f │ │ │ │ -00005e20: 726f 6d20 7468 650a 736f 7572 6365 2074 rom the.source t │ │ │ │ -00005e30: 6172 6261 6c6c 2c20 6f72 2061 7320 6120 arball, or as a │ │ │ │ -00005e40: 7061 636b 6167 6520 666f 7220 796f 7572 package for your │ │ │ │ -00005e50: 204f 532e 0a0a 2020 2041 6674 6572 2079 OS... After y │ │ │ │ -00005e60: 6f75 2068 6176 6520 646f 6e65 2074 6861 ou have done tha │ │ │ │ -00005e70: 742c 2079 6f75 206e 6565 6420 746f 2069 t, you need to i │ │ │ │ -00005e80: 6e73 7461 6c6c 2074 6865 2062 6f6f 7420 nstall the boot │ │ │ │ -00005e90: 6c6f 6164 6572 206f 6e20 610a 6472 6976 loader on a.driv │ │ │ │ -00005ea0: 6520 2866 6c6f 7070 7920 6f72 2068 6172 e (floppy or har │ │ │ │ -00005eb0: 6420 6469 736b 2920 6279 2075 7369 6e67 d disk) by using │ │ │ │ -00005ec0: 2074 6865 2075 7469 6c69 7479 2027 6772 the utility 'gr │ │ │ │ -00005ed0: 7562 2d69 6e73 7461 6c6c 2720 282a 6e6f ub-install' (*no │ │ │ │ -00005ee0: 7465 0a49 6e76 6f6b 696e 6720 6772 7562 te.Invoking grub │ │ │ │ -00005ef0: 2d69 6e73 7461 6c6c 3a3a 2920 6f6e 2061 -install::) on a │ │ │ │ -00005f00: 2055 4e49 582d 6c69 6b65 204f 532e 0a0a UNIX-like OS... │ │ │ │ -00005f10: 2020 2047 5255 4220 636f 6d65 7320 7769 GRUB comes wi │ │ │ │ -00005f20: 7468 2062 6f6f 7420 696d 6167 6573 2c20 th boot images, │ │ │ │ -00005f30: 7768 6963 6820 6172 6520 6e6f 726d 616c which are normal │ │ │ │ -00005f40: 6c79 2070 7574 2069 6e20 7468 6520 6469 ly put in the di │ │ │ │ -00005f50: 7265 6374 6f72 790a 272f 7573 722f 6c69 rectory.'/usr/li │ │ │ │ -00005f60: 622f 6772 7562 2f3c 6370 753e 2d3c 706c b/grub/-' (for BI │ │ │ │ -00005f80: 4f53 2d62 6173 6564 206d 6163 6869 6e65 OS-based machine │ │ │ │ -00005f90: 730a 272f 7573 722f 6c69 622f 6772 7562 s.'/usr/lib/grub │ │ │ │ -00005fa0: 2f69 3338 362d 7063 2729 2e20 2048 6572 /i386-pc'). Her │ │ │ │ -00005fb0: 6561 6674 6572 2c20 7468 6520 6469 7265 eafter, the dire │ │ │ │ -00005fc0: 6374 6f72 7920 7768 6572 6520 4752 5542 ctory where GRUB │ │ │ │ -00005fd0: 2069 6d61 6765 730a 6172 6520 696e 6974 images.are init │ │ │ │ -00005fe0: 6961 6c6c 7920 706c 6163 6564 2028 6e6f ially placed (no │ │ │ │ -00005ff0: 726d 616c 6c79 2027 2f75 7372 2f6c 6962 rmally '/usr/lib │ │ │ │ -00006000: 2f67 7275 622f 3c63 7075 3e2d 3c70 6c61 /grub/-') will be │ │ │ │ -00006020: 0a63 616c 6c65 6420 7468 6520 2269 6d61 .called the "ima │ │ │ │ -00006030: 6765 2064 6972 6563 746f 7279 222c 2061 ge directory", a │ │ │ │ -00006040: 6e64 2074 6865 2064 6972 6563 746f 7279 nd the directory │ │ │ │ -00006050: 2077 6865 7265 2074 6865 2062 6f6f 7420 where the boot │ │ │ │ -00006060: 6c6f 6164 6572 0a6e 6565 6473 2074 6f20 loader.needs to │ │ │ │ -00006070: 6669 6e64 2074 6865 6d20 2875 7375 616c find them (usual │ │ │ │ -00006080: 6c79 2027 2f62 6f6f 7427 2920 7769 6c6c ly '/boot') will │ │ │ │ -00006090: 2062 6520 6361 6c6c 6564 2074 6865 2022 be called the " │ │ │ │ -000060a0: 626f 6f74 0a64 6972 6563 746f 7279 222e boot.directory". │ │ │ │ -000060b0: 0a0a 2a20 4d65 6e75 3a0a 0a2a 2049 6e73 ..* Menu:..* Ins │ │ │ │ -000060c0: 7461 6c6c 696e 6720 4752 5542 2075 7369 talling GRUB usi │ │ │ │ -000060d0: 6e67 2067 7275 622d 696e 7374 616c 6c3a ng grub-install: │ │ │ │ -000060e0: 3a0a 2a20 4d61 6b69 6e67 2061 2047 5255 :.* Making a GRU │ │ │ │ -000060f0: 4220 626f 6f74 6162 6c65 2043 442d 524f B bootable CD-RO │ │ │ │ -00006100: 4d3a 3a0a 2a20 4465 7669 6365 206d 6170 M::.* Device map │ │ │ │ -00006110: 3a3a 0a2a 2042 494f 5320 696e 7374 616c ::.* BIOS instal │ │ │ │ -00006120: 6c61 7469 6f6e 3a3a 0a0a 1f0a 4669 6c65 lation::....File │ │ │ │ -00006130: 3a20 6772 7562 2e69 6e66 6f2c 2020 4e6f : grub.info, No │ │ │ │ -00006140: 6465 3a20 496e 7374 616c 6c69 6e67 2047 de: Installing G │ │ │ │ -00006150: 5255 4220 7573 696e 6720 6772 7562 2d69 RUB using grub-i │ │ │ │ -00006160: 6e73 7461 6c6c 2c20 204e 6578 743a 204d nstall, Next: M │ │ │ │ -00006170: 616b 696e 6720 6120 4752 5542 2062 6f6f aking a GRUB boo │ │ │ │ -00006180: 7461 626c 6520 4344 2d52 4f4d 2c20 2055 table CD-ROM, U │ │ │ │ -00006190: 703a 2049 6e73 7461 6c6c 6174 696f 6e0a p: Installation. │ │ │ │ -000061a0: 0a34 2e31 2049 6e73 7461 6c6c 696e 6720 .4.1 Installing │ │ │ │ -000061b0: 4752 5542 2075 7369 6e67 2067 7275 622d GRUB using grub- │ │ │ │ -000061c0: 696e 7374 616c 6c0a 3d3d 3d3d 3d3d 3d3d install.======== │ │ │ │ +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.==== │ │ │ │ 000061d0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ -000061e0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a ==============.. │ │ │ │ -000061f0: 466f 7220 696e 666f 726d 6174 696f 6e20 For information │ │ │ │ -00006200: 6f6e 2077 6865 7265 2047 5255 4220 7368 on where GRUB sh │ │ │ │ -00006210: 6f75 6c64 2062 6520 696e 7374 616c 6c65 ould be installe │ │ │ │ -00006220: 6420 6f6e 2050 4320 4249 4f53 2070 6c61 d on PC BIOS pla │ │ │ │ -00006230: 7466 6f72 6d73 2c0a 2a6e 6f74 6520 4249 tforms,.*note BI │ │ │ │ -00006240: 4f53 2069 6e73 7461 6c6c 6174 696f 6e3a OS installation: │ │ │ │ -00006250: 3a2e 0a0a 2020 2049 6e20 6f72 6465 7220 :... In order │ │ │ │ -00006260: 746f 2069 6e73 7461 6c6c 2047 5255 4220 to install GRUB │ │ │ │ -00006270: 756e 6465 7220 6120 554e 4958 2d6c 696b under a UNIX-lik │ │ │ │ -00006280: 6520 4f53 2028 7375 6368 2061 7320 474e e OS (such as GN │ │ │ │ -00006290: 5529 2c20 696e 766f 6b65 0a74 6865 2070 U), invoke.the p │ │ │ │ -000062a0: 726f 6772 616d 2027 6772 7562 2d69 6e73 rogram 'grub-ins │ │ │ │ -000062b0: 7461 6c6c 2720 282a 6e6f 7465 2049 6e76 tall' (*note Inv │ │ │ │ -000062c0: 6f6b 696e 6720 6772 7562 2d69 6e73 7461 oking grub-insta │ │ │ │ -000062d0: 6c6c 3a3a 2920 6173 2074 6865 0a73 7570 ll::) as the.sup │ │ │ │ -000062e0: 6572 7573 6572 2028 2272 6f6f 7422 292e eruser ("root"). │ │ │ │ -000062f0: 0a0a 2020 2054 6865 2075 7361 6765 2069 .. The usage i │ │ │ │ -00006300: 7320 6261 7369 6361 6c6c 7920 7665 7279 s basically very │ │ │ │ -00006310: 2073 696d 706c 652e 2020 596f 7520 6f6e simple. You on │ │ │ │ -00006320: 6c79 206e 6565 6420 746f 2073 7065 6369 ly need to speci │ │ │ │ -00006330: 6679 206f 6e65 0a61 7267 756d 656e 7420 fy one.argument │ │ │ │ -00006340: 746f 2074 6865 2070 726f 6772 616d 2c20 to the program, │ │ │ │ -00006350: 6e61 6d65 6c79 2c20 7768 6572 6520 746f namely, where to │ │ │ │ -00006360: 2069 6e73 7461 6c6c 2074 6865 2062 6f6f install the boo │ │ │ │ -00006370: 7420 6c6f 6164 6572 2e20 2054 6865 0a61 t loader. The.a │ │ │ │ -00006380: 7267 756d 656e 7420 6861 7320 746f 2062 rgument has to b │ │ │ │ -00006390: 6520 6569 7468 6572 2061 2064 6576 6963 e either a devic │ │ │ │ -000063a0: 6520 6669 6c65 2028 6c69 6b65 2027 2f64 e file (like '/d │ │ │ │ -000063b0: 6576 2f68 6461 2729 2e20 2046 6f72 2065 ev/hda'). For e │ │ │ │ -000063c0: 7861 6d70 6c65 2c0a 756e 6465 7220 4c69 xample,.under Li │ │ │ │ -000063d0: 6e75 7820 7468 6520 666f 6c6c 6f77 696e nux the followin │ │ │ │ -000063e0: 6720 7769 6c6c 2069 6e73 7461 6c6c 2047 g will install G │ │ │ │ -000063f0: 5255 4220 696e 746f 2074 6865 204d 4252 RUB into the MBR │ │ │ │ -00006400: 206f 6620 7468 6520 6669 7273 740a 4944 of the first.ID │ │ │ │ -00006410: 4520 6469 736b 3a0a 0a20 2020 2020 2320 E disk:.. # │ │ │ │ -00006420: 6772 7562 2d69 6e73 7461 6c6c 202f 6465 grub-install /de │ │ │ │ -00006430: 762f 7364 610a 0a20 2020 4c69 6b65 7769 v/sda.. Likewi │ │ │ │ -00006440: 7365 2c20 756e 6465 7220 474e 552f 4875 se, under GNU/Hu │ │ │ │ -00006450: 7264 2c20 7468 6973 2068 6173 2074 6865 rd, this has the │ │ │ │ -00006460: 2073 616d 6520 6566 6665 6374 3a0a 0a20 same effect:.. │ │ │ │ -00006470: 2020 2020 2320 6772 7562 2d69 6e73 7461 # grub-insta │ │ │ │ -00006480: 6c6c 202f 6465 762f 6864 300a 0a20 2020 ll /dev/hd0.. │ │ │ │ -00006490: 4275 7420 616c 6c20 7468 6520 6162 6f76 But all the abov │ │ │ │ -000064a0: 6520 6578 616d 706c 6573 2061 7373 756d e examples assum │ │ │ │ -000064b0: 6520 7468 6174 2047 5255 4220 7368 6f75 e that GRUB shou │ │ │ │ -000064c0: 6c64 2070 7574 2069 6d61 6765 7320 756e ld put images un │ │ │ │ -000064d0: 6465 720a 7468 6520 272f 626f 6f74 2720 der.the '/boot' │ │ │ │ -000064e0: 6469 7265 6374 6f72 792e 2020 4966 2079 directory. If y │ │ │ │ -000064f0: 6f75 2077 616e 7420 4752 5542 2074 6f20 ou want GRUB to │ │ │ │ -00006500: 7075 7420 696d 6167 6573 2075 6e64 6572 put images under │ │ │ │ -00006510: 2061 2064 6972 6563 746f 7279 0a6f 7468 a directory.oth │ │ │ │ -00006520: 6572 2074 6861 6e20 272f 626f 6f74 272c er than '/boot', │ │ │ │ -00006530: 2079 6f75 206e 6565 6420 746f 2073 7065 you need to spe │ │ │ │ -00006540: 6369 6679 2074 6865 206f 7074 696f 6e20 cify the option │ │ │ │ -00006550: 272d 2d62 6f6f 742d 6469 7265 6374 6f72 '--boot-director │ │ │ │ -00006560: 7927 2e0a 5468 6520 7479 7069 6361 6c20 y'..The typical │ │ │ │ -00006570: 7573 6167 6520 6973 2074 6861 7420 796f usage is that yo │ │ │ │ -00006580: 7520 6372 6561 7465 2061 2047 5255 4220 u create a GRUB │ │ │ │ -00006590: 626f 6f74 2066 6c6f 7070 7920 7769 7468 boot floppy with │ │ │ │ -000065a0: 2061 0a66 696c 6573 7973 7465 6d2e 2020 a.filesystem. │ │ │ │ -000065b0: 4865 7265 2069 7320 616e 2065 7861 6d70 Here is an examp │ │ │ │ -000065c0: 6c65 3a0a 0a20 2020 2020 2320 6d6b 6532 le:.. # mke2 │ │ │ │ -000065d0: 6673 202f 6465 762f 6664 300a 2020 2020 fs /dev/fd0. │ │ │ │ -000065e0: 2023 206d 6f75 6e74 202d 7420 6578 7432 # mount -t ext2 │ │ │ │ -000065f0: 202f 6465 762f 6664 3020 2f6d 6e74 0a20 /dev/fd0 /mnt. │ │ │ │ -00006600: 2020 2020 2320 6d6b 6469 7220 2f6d 6e74 # mkdir /mnt │ │ │ │ -00006610: 2f62 6f6f 740a 2020 2020 2023 2067 7275 /boot. # gru │ │ │ │ -00006620: 622d 696e 7374 616c 6c20 2d2d 626f 6f74 b-install --boot │ │ │ │ -00006630: 2d64 6972 6563 746f 7279 3d2f 6d6e 742f -directory=/mnt/ │ │ │ │ -00006640: 626f 6f74 202f 6465 762f 6664 300a 2020 boot /dev/fd0. │ │ │ │ -00006650: 2020 2023 2075 6d6f 756e 7420 2f6d 6e74 # umount /mnt │ │ │ │ -00006660: 0a0a 2020 2053 6f6d 6520 4249 4f53 6573 .. Some BIOSes │ │ │ │ -00006670: 2068 6176 6520 6120 6275 6720 6f66 2065 have a bug of e │ │ │ │ -00006680: 7870 6f73 696e 6720 7468 6520 6669 7273 xposing the firs │ │ │ │ -00006690: 7420 7061 7274 6974 696f 6e20 6f66 2061 t partition of a │ │ │ │ -000066a0: 2055 5342 2064 7269 7665 0a61 7320 6120 USB drive.as a │ │ │ │ -000066b0: 666c 6f70 7079 2069 6e73 7465 6164 206f floppy instead o │ │ │ │ -000066c0: 6620 6578 706f 7369 6e67 2074 6865 2055 f exposing the U │ │ │ │ -000066d0: 5342 2064 7269 7665 2061 7320 6120 6861 SB drive as a ha │ │ │ │ -000066e0: 7264 2064 6973 6b20 2874 6865 7920 6361 rd disk (they ca │ │ │ │ -000066f0: 6c6c 0a69 7420 2255 5342 2d46 4444 2220 ll.it "USB-FDD" │ │ │ │ -00006700: 626f 6f74 292e 2020 496e 2073 7563 6820 boot). In such │ │ │ │ -00006710: 6361 7365 732c 2079 6f75 206e 6565 6420 cases, you need │ │ │ │ -00006720: 746f 2069 6e73 7461 6c6c 206c 696b 6520 to install like │ │ │ │ -00006730: 7468 6973 3a0a 0a20 2020 2020 2320 6c6f this:.. # lo │ │ │ │ -00006740: 7365 7475 7020 2f64 6576 2f6c 6f6f 7030 setup /dev/loop0 │ │ │ │ -00006750: 202f 6465 762f 7364 6231 0a20 2020 2020 /dev/sdb1. │ │ │ │ -00006760: 2320 6d6f 756e 7420 2f64 6576 2f6c 6f6f # mount /dev/loo │ │ │ │ -00006770: 7030 202f 6d6e 742f 7573 620a 2020 2020 p0 /mnt/usb. │ │ │ │ -00006780: 2023 2067 7275 622d 696e 7374 616c 6c20 # grub-install │ │ │ │ -00006790: 2d2d 626f 6f74 2d64 6972 6563 746f 7279 --boot-directory │ │ │ │ -000067a0: 3d2f 6d6e 742f 7573 622f 6275 6762 696f =/mnt/usb/bugbio │ │ │ │ -000067b0: 7320 2d2d 666f 7263 6520 2d2d 616c 6c6f s --force --allo │ │ │ │ -000067c0: 772d 666c 6f70 7079 202f 6465 762f 6c6f w-floppy /dev/lo │ │ │ │ -000067d0: 6f70 300a 0a20 2020 5468 6973 2069 6e73 op0.. This ins │ │ │ │ -000067e0: 7461 6c6c 2064 6f65 736e 2774 2063 6f6e tall doesn't con │ │ │ │ -000067f0: 666c 6963 7420 7769 7468 2073 7461 6e64 flict with stand │ │ │ │ -00006800: 6172 6420 696e 7374 616c 6c20 6173 206c ard install as l │ │ │ │ -00006810: 6f6e 6720 6173 2074 6865 790a 6172 6520 ong as they.are │ │ │ │ -00006820: 696e 2073 6570 6172 6174 6520 6469 7265 in separate dire │ │ │ │ -00006830: 6374 6f72 6965 732e 0a0a 2020 204e 6f74 ctories... Not │ │ │ │ -00006840: 6520 7468 6174 2027 6772 7562 2d69 6e73 e that 'grub-ins │ │ │ │ -00006850: 7461 6c6c 2720 6973 2061 6374 7561 6c6c tall' is actuall │ │ │ │ -00006860: 7920 6a75 7374 2061 2073 6865 6c6c 2073 y just a shell s │ │ │ │ -00006870: 6372 6970 7420 616e 6420 7468 6520 7265 cript and the re │ │ │ │ -00006880: 616c 0a74 6173 6b20 6973 2064 6f6e 6520 al.task is done │ │ │ │ -00006890: 6279 206f 7468 6572 2074 6f6f 6c73 2073 by other tools s │ │ │ │ -000068a0: 7563 6820 6173 2027 6772 7562 2d6d 6b69 uch as 'grub-mki │ │ │ │ -000068b0: 6d61 6765 272e 2020 5468 6572 6566 6f72 mage'. Therefor │ │ │ │ -000068c0: 652c 2079 6f75 206d 6179 0a72 756e 2074 e, you may.run t │ │ │ │ -000068d0: 686f 7365 2063 6f6d 6d61 6e64 7320 6469 hose commands di │ │ │ │ -000068e0: 7265 6374 6c79 2074 6f20 696e 7374 616c rectly to instal │ │ │ │ -000068f0: 6c20 4752 5542 2c20 7769 7468 6f75 7420 l GRUB, without │ │ │ │ -00006900: 7573 696e 670a 2767 7275 622d 696e 7374 using.'grub-inst │ │ │ │ -00006910: 616c 6c27 2e20 2044 6f6e 2774 2064 6f20 all'. Don't do │ │ │ │ -00006920: 7468 6174 2c20 686f 7765 7665 722c 2075 that, however, u │ │ │ │ -00006930: 6e6c 6573 7320 796f 7520 6172 6520 7665 nless you are ve │ │ │ │ -00006940: 7279 2066 616d 696c 6961 720a 7769 7468 ry familiar.with │ │ │ │ -00006950: 2074 6865 2069 6e74 6572 6e61 6c73 206f the internals o │ │ │ │ -00006960: 6620 4752 5542 2e20 496e 7374 616c 6c69 f GRUB. Installi │ │ │ │ -00006970: 6e67 2061 2062 6f6f 7420 6c6f 6164 6572 ng a boot loader │ │ │ │ -00006980: 206f 6e20 6120 7275 6e6e 696e 6720 4f53 on a running OS │ │ │ │ -00006990: 206d 6179 0a62 6520 6578 7472 656d 656c may.be extremel │ │ │ │ -000069a0: 7920 6461 6e67 6572 6f75 732e 0a0a 2020 y dangerous... │ │ │ │ -000069b0: 204f 6e20 4546 4920 7379 7374 656d 7320 On EFI systems │ │ │ │ -000069c0: 666f 7220 6669 7865 6420 6469 736b 2069 for fixed disk i │ │ │ │ -000069d0: 6e73 7461 6c6c 2079 6f75 2068 6176 6520 nstall you have │ │ │ │ -000069e0: 746f 206d 6f75 6e74 2045 4649 2053 7973 to mount EFI Sys │ │ │ │ -000069f0: 7465 6d0a 5061 7274 6974 696f 6e2e 2020 tem.Partition. │ │ │ │ -00006a00: 4966 2079 6f75 206d 6f75 6e74 2069 7420 If you mount it │ │ │ │ -00006a10: 6174 2027 2f62 6f6f 742f 6566 6927 2074 at '/boot/efi' t │ │ │ │ -00006a20: 6865 6e20 796f 7520 646f 6e27 7420 6e65 hen you don't ne │ │ │ │ -00006a30: 6564 2061 6e79 0a73 7065 6369 616c 2061 ed any.special a │ │ │ │ -00006a40: 7267 756d 656e 7473 3a0a 0a20 2020 2020 rguments:.. │ │ │ │ -00006a50: 2320 6772 7562 2d69 6e73 7461 6c6c 0a0a # grub-install.. │ │ │ │ -00006a60: 2020 204f 7468 6572 7769 7365 2079 6f75 Otherwise you │ │ │ │ -00006a70: 206e 6565 6420 746f 2073 7065 6369 6679 need to specify │ │ │ │ -00006a80: 2077 6865 7265 2079 6f75 7220 4546 4920 where your EFI │ │ │ │ -00006a90: 5379 7374 656d 2070 6172 7469 7469 6f6e System partition │ │ │ │ -00006aa0: 2069 730a 6d6f 756e 7465 643a 0a0a 2020 is.mounted:.. │ │ │ │ -00006ab0: 2020 2023 2067 7275 622d 696e 7374 616c # grub-instal │ │ │ │ -00006ac0: 6c20 2d2d 6566 692d 6469 7265 6374 6f72 l --efi-director │ │ │ │ -00006ad0: 793d 2f6d 6e74 2f65 6669 0a0a 2020 2046 y=/mnt/efi.. F │ │ │ │ -00006ae0: 6f72 2072 656d 6f76 6162 6c65 2069 6e73 or removable ins │ │ │ │ -00006af0: 7461 6c6c 7320 796f 7520 6861 7665 2074 talls you have t │ │ │ │ -00006b00: 6f20 7573 6520 272d 2d72 656d 6f76 6162 o use '--removab │ │ │ │ -00006b10: 6c65 2720 616e 6420 7370 6563 6966 7920 le' and specify │ │ │ │ -00006b20: 626f 7468 0a27 2d2d 626f 6f74 2d64 6972 both.'--boot-dir │ │ │ │ -00006b30: 6563 746f 7279 2720 616e 6420 272d 2d65 ectory' and '--e │ │ │ │ -00006b40: 6669 2d64 6972 6563 746f 7279 273a 0a0a fi-directory':.. │ │ │ │ -00006b50: 2020 2020 2023 2067 7275 622d 696e 7374 # grub-inst │ │ │ │ -00006b60: 616c 6c20 2d2d 6566 692d 6469 7265 6374 all --efi-direct │ │ │ │ -00006b70: 6f72 793d 2f6d 6e74 2f75 7362 202d 2d62 ory=/mnt/usb --b │ │ │ │ -00006b80: 6f6f 742d 6469 7265 6374 6f72 793d 2f6d oot-directory=/m │ │ │ │ -00006b90: 6e74 2f75 7362 2f62 6f6f 7420 2d2d 7265 nt/usb/boot --re │ │ │ │ -00006ba0: 6d6f 7661 626c 650a 0a1f 0a46 696c 653a movable....File: │ │ │ │ -00006bb0: 2067 7275 622e 696e 666f 2c20 204e 6f64 grub.info, Nod │ │ │ │ -00006bc0: 653a 204d 616b 696e 6720 6120 4752 5542 e: Making a GRUB │ │ │ │ -00006bd0: 2062 6f6f 7461 626c 6520 4344 2d52 4f4d bootable CD-ROM │ │ │ │ -00006be0: 2c20 204e 6578 743a 2044 6576 6963 6520 , Next: Device │ │ │ │ -00006bf0: 6d61 702c 2020 5072 6576 3a20 496e 7374 map, Prev: Inst │ │ │ │ -00006c00: 616c 6c69 6e67 2047 5255 4220 7573 696e alling GRUB usin │ │ │ │ -00006c10: 6720 6772 7562 2d69 6e73 7461 6c6c 2c20 g grub-install, │ │ │ │ -00006c20: 2055 703a 2049 6e73 7461 6c6c 6174 696f Up: Installatio │ │ │ │ -00006c30: 6e0a 0a34 2e32 204d 616b 696e 6720 6120 n..4.2 Making a │ │ │ │ -00006c40: 4752 5542 2062 6f6f 7461 626c 6520 4344 GRUB bootable CD │ │ │ │ -00006c50: 2d52 4f4d 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d -ROM.=========== │ │ │ │ +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: 204e 6f74 6520 7468 6174 2027 6772 7562 Note that 'grub │ │ │ │ +00006850: 2d69 6e73 7461 6c6c 2720 6973 2061 6374 -install' is act │ │ │ │ +00006860: 7561 6c6c 7920 6a75 7374 2061 2073 6865 ually just a she │ │ │ │ +00006870: 6c6c 2073 6372 6970 7420 616e 6420 7468 ll script and th │ │ │ │ +00006880: 6520 7265 616c 0a74 6173 6b20 6973 2064 e real.task is d │ │ │ │ +00006890: 6f6e 6520 6279 206f 7468 6572 2074 6f6f one by other too │ │ │ │ +000068a0: 6c73 2073 7563 6820 6173 2027 6772 7562 ls such as 'grub │ │ │ │ +000068b0: 2d6d 6b69 6d61 6765 272e 2020 5468 6572 -mkimage'. Ther │ │ │ │ +000068c0: 6566 6f72 652c 2079 6f75 206d 6179 0a72 efore, you may.r │ │ │ │ +000068d0: 756e 2074 686f 7365 2063 6f6d 6d61 6e64 un those command │ │ │ │ +000068e0: 7320 6469 7265 6374 6c79 2074 6f20 696e s directly to in │ │ │ │ +000068f0: 7374 616c 6c20 4752 5542 2c20 7769 7468 stall GRUB, with │ │ │ │ +00006900: 6f75 7420 7573 696e 670a 2767 7275 622d out using.'grub- │ │ │ │ +00006910: 696e 7374 616c 6c27 2e20 2044 6f6e 2774 install'. Don't │ │ │ │ +00006920: 2064 6f20 7468 6174 2c20 686f 7765 7665 do that, howeve │ │ │ │ +00006930: 722c 2075 6e6c 6573 7320 796f 7520 6172 r, unless you ar │ │ │ │ +00006940: 6520 7665 7279 2066 616d 696c 6961 720a e very familiar. │ │ │ │ +00006950: 7769 7468 2074 6865 2069 6e74 6572 6e61 with the interna │ │ │ │ +00006960: 6c73 206f 6620 4752 5542 2e20 496e 7374 ls of GRUB. Inst │ │ │ │ +00006970: 616c 6c69 6e67 2061 2062 6f6f 7420 6c6f alling a boot lo │ │ │ │ +00006980: 6164 6572 206f 6e20 6120 7275 6e6e 696e ader on a runnin │ │ │ │ +00006990: 6720 4f53 206d 6179 0a62 6520 6578 7472 g OS may.be extr │ │ │ │ +000069a0: 656d 656c 7920 6461 6e67 6572 6f75 732e emely dangerous. │ │ │ │ +000069b0: 0a0a 2020 204f 6e20 4546 4920 7379 7374 .. On EFI syst │ │ │ │ +000069c0: 656d 7320 666f 7220 6669 7865 6420 6469 ems for fixed di │ │ │ │ +000069d0: 736b 2069 6e73 7461 6c6c 2079 6f75 2068 sk install you h │ │ │ │ +000069e0: 6176 6520 746f 206d 6f75 6e74 2045 4649 ave to mount EFI │ │ │ │ +000069f0: 2053 7973 7465 6d0a 5061 7274 6974 696f System.Partitio │ │ │ │ +00006a00: 6e2e 2020 4966 2079 6f75 206d 6f75 6e74 n. If you mount │ │ │ │ +00006a10: 2069 7420 6174 2027 2f62 6f6f 742f 6566 it at '/boot/ef │ │ │ │ +00006a20: 6927 2074 6865 6e20 796f 7520 646f 6e27 i' then you don' │ │ │ │ +00006a30: 7420 6e65 6564 2061 6e79 0a73 7065 6369 t need any.speci │ │ │ │ +00006a40: 616c 2061 7267 756d 656e 7473 3a0a 0a20 al arguments:.. │ │ │ │ +00006a50: 2020 2020 2320 6772 7562 2d69 6e73 7461 # grub-insta │ │ │ │ +00006a60: 6c6c 0a0a 2020 204f 7468 6572 7769 7365 ll.. Otherwise │ │ │ │ +00006a70: 2079 6f75 206e 6565 6420 746f 2073 7065 you need to spe │ │ │ │ +00006a80: 6369 6679 2077 6865 7265 2079 6f75 7220 cify where your │ │ │ │ +00006a90: 4546 4920 5379 7374 656d 2070 6172 7469 EFI System parti │ │ │ │ +00006aa0: 7469 6f6e 2069 730a 6d6f 756e 7465 643a tion is.mounted: │ │ │ │ +00006ab0: 0a0a 2020 2020 2023 2067 7275 622d 696e .. # grub-in │ │ │ │ +00006ac0: 7374 616c 6c20 2d2d 6566 692d 6469 7265 stall --efi-dire │ │ │ │ +00006ad0: 6374 6f72 793d 2f6d 6e74 2f65 6669 0a0a ctory=/mnt/efi.. │ │ │ │ +00006ae0: 2020 2046 6f72 2072 656d 6f76 6162 6c65 For removable │ │ │ │ +00006af0: 2069 6e73 7461 6c6c 7320 796f 7520 6861 installs you ha │ │ │ │ +00006b00: 7665 2074 6f20 7573 6520 272d 2d72 656d ve to use '--rem │ │ │ │ +00006b10: 6f76 6162 6c65 2720 616e 6420 7370 6563 ovable' and spec │ │ │ │ +00006b20: 6966 7920 626f 7468 0a27 2d2d 626f 6f74 ify both.'--boot │ │ │ │ +00006b30: 2d64 6972 6563 746f 7279 2720 616e 6420 -directory' and │ │ │ │ +00006b40: 272d 2d65 6669 2d64 6972 6563 746f 7279 '--efi-directory │ │ │ │ +00006b50: 273a 0a0a 2020 2020 2023 2067 7275 622d ':.. # grub- │ │ │ │ +00006b60: 696e 7374 616c 6c20 2d2d 6566 692d 6469 install --efi-di │ │ │ │ +00006b70: 7265 6374 6f72 793d 2f6d 6e74 2f75 7362 rectory=/mnt/usb │ │ │ │ +00006b80: 202d 2d62 6f6f 742d 6469 7265 6374 6f72 --boot-director │ │ │ │ +00006b90: 793d 2f6d 6e74 2f75 7362 2f62 6f6f 7420 y=/mnt/usb/boot │ │ │ │ +00006ba0: 2d2d 7265 6d6f 7661 626c 650a 0a1f 0a46 --removable....F │ │ │ │ +00006bb0: 696c 653a 2067 7275 622e 696e 666f 2c20 ile: grub.info, │ │ │ │ +00006bc0: 204e 6f64 653a 204d 616b 696e 6720 6120 Node: Making a │ │ │ │ +00006bd0: 4752 5542 2062 6f6f 7461 626c 6520 4344 GRUB bootable CD │ │ │ │ +00006be0: 2d52 4f4d 2c20 204e 6578 743a 2044 6576 -ROM, Next: Dev │ │ │ │ +00006bf0: 6963 6520 6d61 702c 2020 5072 6576 3a20 ice map, Prev: │ │ │ │ +00006c00: 496e 7374 616c 6c69 6e67 2047 5255 4220 Installing GRUB │ │ │ │ +00006c10: 7573 696e 6720 6772 7562 2d69 6e73 7461 using grub-insta │ │ │ │ +00006c20: 6c6c 2c20 2055 703a 2049 6e73 7461 6c6c ll, Up: Install │ │ │ │ +00006c30: 6174 696f 6e0a 0a34 2e32 204d 616b 696e ation..4.2 Makin │ │ │ │ +00006c40: 6720 6120 4752 5542 2062 6f6f 7461 626c g a GRUB bootabl │ │ │ │ +00006c50: 6520 4344 2d52 4f4d 0a3d 3d3d 3d3d 3d3d e CD-ROM.======= │ │ │ │ 00006c60: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ -00006c70: 3d3d 3d3d 3d3d 0a0a 4752 5542 2073 7570 ======..GRUB sup │ │ │ │ -00006c80: 706f 7274 7320 7468 6520 226e 6f20 656d ports the "no em │ │ │ │ -00006c90: 756c 6174 696f 6e20 6d6f 6465 2220 696e ulation mode" in │ │ │ │ -00006ca0: 2074 6865 2045 6c20 546f 7269 746f 2073 the El Torito s │ │ │ │ -00006cb0: 7065 6369 6669 6361 7469 6f6e 2831 290a pecification(1). │ │ │ │ -00006cc0: 282a 6e6f 7465 204d 616b 696e 6720 6120 (*note Making a │ │ │ │ -00006cd0: 4752 5542 2062 6f6f 7461 626c 6520 4344 GRUB bootable CD │ │ │ │ -00006ce0: 2d52 4f4d 2d46 6f6f 746e 6f74 652d 313a -ROM-Footnote-1: │ │ │ │ -00006cf0: 3a29 2e20 2054 6869 7320 6d65 616e 7320 :). This means │ │ │ │ -00006d00: 7468 6174 2079 6f75 0a63 616e 2075 7365 that you.can use │ │ │ │ -00006d10: 2074 6865 2077 686f 6c65 2043 442d 524f the whole CD-RO │ │ │ │ -00006d20: 4d20 6672 6f6d 2047 5255 4220 616e 6420 M from GRUB and │ │ │ │ -00006d30: 796f 7520 646f 6e27 7420 6861 7665 2074 you don't have t │ │ │ │ -00006d40: 6f20 6d61 6b65 2061 2066 6c6f 7070 790a o make a floppy. │ │ │ │ -00006d50: 6f72 2068 6172 6420 6469 736b 2069 6d61 or hard disk ima │ │ │ │ -00006d60: 6765 2066 696c 652c 2077 6869 6368 2063 ge file, which c │ │ │ │ -00006d70: 616e 2063 6175 7365 2063 6f6d 7061 7469 an cause compati │ │ │ │ -00006d80: 6269 6c69 7479 2070 726f 626c 656d 732e bility problems. │ │ │ │ -00006d90: 0a0a 2020 2046 6f72 2062 6f6f 7469 6e67 .. For booting │ │ │ │ -00006da0: 2066 726f 6d20 6120 4344 2d52 4f4d 2c20 from a CD-ROM, │ │ │ │ -00006db0: 4752 5542 2075 7365 7320 6120 7370 6563 GRUB uses a spec │ │ │ │ -00006dc0: 6961 6c20 696d 6167 6520 6361 6c6c 6564 ial image called │ │ │ │ -00006dd0: 0a27 6364 626f 6f74 2e69 6d67 272c 2077 .'cdboot.img', w │ │ │ │ -00006de0: 6869 6368 2069 7320 636f 6e63 6174 656e hich is concaten │ │ │ │ -00006df0: 6174 6564 2077 6974 6820 2763 6f72 652e ated with 'core. │ │ │ │ -00006e00: 696d 6727 2e20 2054 6865 2027 636f 7265 img'. The 'core │ │ │ │ -00006e10: 2e69 6d67 270a 7573 6564 2066 6f72 2074 .img'.used for t │ │ │ │ -00006e20: 6869 7320 7368 6f75 6c64 2062 6520 6275 his should be bu │ │ │ │ -00006e30: 696c 7420 7769 7468 2061 7420 6c65 6173 ilt with at leas │ │ │ │ -00006e40: 7420 7468 6520 2769 736f 3936 3630 2720 t the 'iso9660' │ │ │ │ -00006e50: 616e 6420 2762 696f 7364 6973 6b27 0a6d and 'biosdisk'.m │ │ │ │ -00006e60: 6f64 756c 6573 2e20 2059 6f75 7220 626f odules. Your bo │ │ │ │ -00006e70: 6f74 6162 6c65 2043 442d 524f 4d20 7769 otable CD-ROM wi │ │ │ │ -00006e80: 6c6c 2075 7375 616c 6c79 2061 6c73 6f20 ll usually also │ │ │ │ -00006e90: 6e65 6564 2074 6f20 696e 636c 7564 6520 need to include │ │ │ │ -00006ea0: 610a 636f 6e66 6967 7572 6174 696f 6e20 a.configuration │ │ │ │ -00006eb0: 6669 6c65 2027 6772 7562 2e63 6667 2720 file 'grub.cfg' │ │ │ │ -00006ec0: 616e 6420 736f 6d65 206f 7468 6572 2047 and some other G │ │ │ │ -00006ed0: 5255 4220 6d6f 6475 6c65 732e 0a0a 2020 RUB modules... │ │ │ │ -00006ee0: 2054 6f20 6d61 6b65 2061 2073 696d 706c To make a simpl │ │ │ │ -00006ef0: 6520 6765 6e65 7269 6320 4752 5542 2072 e generic GRUB r │ │ │ │ -00006f00: 6573 6375 6520 4344 2c20 796f 7520 6361 escue CD, you ca │ │ │ │ -00006f10: 6e20 7573 6520 7468 650a 2767 7275 622d n use the.'grub- │ │ │ │ -00006f20: 6d6b 7265 7363 7565 2720 7072 6f67 7261 mkrescue' progra │ │ │ │ -00006f30: 6d20 282a 6e6f 7465 2049 6e76 6f6b 696e m (*note Invokin │ │ │ │ -00006f40: 6720 6772 7562 2d6d 6b72 6573 6375 653a g grub-mkrescue: │ │ │ │ -00006f50: 3a29 3a0a 0a20 2020 2020 2420 6772 7562 :):.. $ grub │ │ │ │ -00006f60: 2d6d 6b72 6573 6375 6520 2d6f 2067 7275 -mkrescue -o gru │ │ │ │ -00006f70: 622e 6973 6f0a 0a20 2020 596f 7520 7769 b.iso.. You wi │ │ │ │ -00006f80: 6c6c 206f 6674 656e 206e 6565 6420 746f ll often need to │ │ │ │ -00006f90: 2069 6e63 6c75 6465 206f 7468 6572 2066 include other f │ │ │ │ -00006fa0: 696c 6573 2069 6e20 796f 7572 2069 6d61 iles in your ima │ │ │ │ -00006fb0: 6765 2e20 2054 6f20 646f 0a74 6869 732c ge. To do.this, │ │ │ │ -00006fc0: 2066 6972 7374 206d 616b 6520 6120 746f first make a to │ │ │ │ -00006fd0: 7020 6469 7265 6374 6f72 7920 666f 7220 p directory for │ │ │ │ -00006fe0: 7468 6520 626f 6f74 6162 6c65 2069 6d61 the bootable ima │ │ │ │ -00006ff0: 6765 2c20 7361 792c 2027 6973 6f27 3a0a ge, say, 'iso':. │ │ │ │ -00007000: 0a20 2020 2020 2420 6d6b 6469 7220 6973 . $ mkdir is │ │ │ │ -00007010: 6f0a 0a20 2020 4d61 6b65 2061 2064 6972 o.. Make a dir │ │ │ │ -00007020: 6563 746f 7279 2066 6f72 2047 5255 423a ectory for GRUB: │ │ │ │ -00007030: 0a0a 2020 2020 2024 206d 6b64 6972 202d .. $ mkdir - │ │ │ │ -00007040: 7020 6973 6f2f 626f 6f74 2f67 7275 620a p iso/boot/grub. │ │ │ │ -00007050: 0a20 2020 4966 2064 6573 6972 6564 2c20 . If desired, │ │ │ │ -00007060: 6d61 6b65 2074 6865 2063 6f6e 6669 6720 make the config │ │ │ │ -00007070: 6669 6c65 2027 6772 7562 2e63 6667 2720 file 'grub.cfg' │ │ │ │ -00007080: 756e 6465 7220 2769 736f 2f62 6f6f 742f under 'iso/boot/ │ │ │ │ -00007090: 6772 7562 270a 282a 6e6f 7465 2043 6f6e grub'.(*note Con │ │ │ │ -000070a0: 6669 6775 7261 7469 6f6e 3a3a 292c 2061 figuration::), a │ │ │ │ -000070b0: 6e64 2063 6f70 7920 616e 7920 6669 6c65 nd copy any file │ │ │ │ -000070c0: 7320 616e 6420 6469 7265 6374 6f72 6965 s and directorie │ │ │ │ -000070d0: 7320 666f 7220 7468 6520 6469 7363 0a74 s for the disc.t │ │ │ │ -000070e0: 6f20 7468 6520 6469 7265 6374 6f72 7920 o the directory │ │ │ │ -000070f0: 2769 736f 2f27 2e0a 0a20 2020 4669 6e61 'iso/'... Fina │ │ │ │ -00007100: 6c6c 792c 206d 616b 6520 7468 6520 696d lly, make the im │ │ │ │ -00007110: 6167 653a 0a0a 2020 2020 2024 2067 7275 age:.. $ gru │ │ │ │ -00007120: 622d 6d6b 7265 7363 7565 202d 6f20 6772 b-mkrescue -o gr │ │ │ │ -00007130: 7562 2e69 736f 2069 736f 0a0a 2020 2054 ub.iso iso.. T │ │ │ │ -00007140: 6869 7320 7072 6f64 7563 6573 2061 2066 his produces a f │ │ │ │ -00007150: 696c 6520 6e61 6d65 6420 2767 7275 622e ile named 'grub. │ │ │ │ -00007160: 6973 6f27 2c20 7768 6963 6820 7468 656e iso', which then │ │ │ │ -00007170: 2063 616e 2062 6520 6275 726e 6564 2069 can be burned i │ │ │ │ -00007180: 6e74 6f0a 6120 4344 2028 6f72 2061 2044 nto.a CD (or a D │ │ │ │ -00007190: 5644 292c 206f 7220 7772 6974 7465 6e20 VD), or written │ │ │ │ -000071a0: 746f 2061 2055 5342 206d 6173 7320 7374 to a USB mass st │ │ │ │ -000071b0: 6f72 6167 6520 6465 7669 6365 2e0a 0a20 orage device... │ │ │ │ -000071c0: 2020 5468 6520 726f 6f74 2064 6576 6963 The root devic │ │ │ │ -000071d0: 6520 7769 6c6c 2062 6520 7365 7420 7570 e will be set up │ │ │ │ -000071e0: 2061 7070 726f 7072 6961 7465 6c79 206f appropriately o │ │ │ │ -000071f0: 6e20 656e 7465 7269 6e67 2079 6f75 720a n entering your. │ │ │ │ -00007200: 2767 7275 622e 6366 6727 2063 6f6e 6669 'grub.cfg' confi │ │ │ │ -00007210: 6775 7261 7469 6f6e 2066 696c 652c 2073 guration file, s │ │ │ │ -00007220: 6f20 796f 7520 6361 6e20 7265 6665 7220 o you can refer │ │ │ │ -00007230: 746f 2066 696c 6520 6e61 6d65 7320 6f6e to file names on │ │ │ │ -00007240: 2074 6865 2043 440a 7769 7468 6f75 7420 the CD.without │ │ │ │ -00007250: 6e65 6564 696e 6720 746f 2075 7365 2061 needing to use a │ │ │ │ -00007260: 6e20 6578 706c 6963 6974 2064 6576 6963 n explicit devic │ │ │ │ -00007270: 6520 6e61 6d65 2e20 2054 6869 7320 6d61 e name. This ma │ │ │ │ -00007280: 6b65 7320 6974 2065 6173 6965 7220 746f kes it easier to │ │ │ │ -00007290: 0a70 726f 6475 6365 2072 6573 6375 6520 .produce rescue │ │ │ │ -000072a0: 696d 6167 6573 2074 6861 7420 7769 6c6c images that will │ │ │ │ -000072b0: 2077 6f72 6b20 6f6e 2062 6f74 6820 6f70 work on both op │ │ │ │ -000072c0: 7469 6361 6c20 6472 6976 6573 2061 6e64 tical drives and │ │ │ │ -000072d0: 2055 5342 206d 6173 730a 7374 6f72 6167 USB mass.storag │ │ │ │ -000072e0: 6520 6465 7669 6365 732e 0a0a 1f0a 4669 e devices.....Fi │ │ │ │ -000072f0: 6c65 3a20 6772 7562 2e69 6e66 6f2c 2020 le: grub.info, │ │ │ │ -00007300: 4e6f 6465 3a20 4d61 6b69 6e67 2061 2047 Node: Making a G │ │ │ │ -00007310: 5255 4220 626f 6f74 6162 6c65 2043 442d RUB bootable CD- │ │ │ │ -00007320: 524f 4d2d 466f 6f74 6e6f 7465 732c 2020 ROM-Footnotes, │ │ │ │ -00007330: 5570 3a20 4d61 6b69 6e67 2061 2047 5255 Up: Making a GRU │ │ │ │ -00007340: 4220 626f 6f74 6162 6c65 2043 442d 524f B bootable CD-RO │ │ │ │ -00007350: 4d0a 0a20 2020 2831 2920 456c 2054 6f72 M.. (1) El Tor │ │ │ │ -00007360: 6974 6f20 6973 2061 2073 7065 6369 6669 ito is a specifi │ │ │ │ -00007370: 6361 7469 6f6e 2066 6f72 2062 6f6f 7461 cation for boota │ │ │ │ -00007380: 626c 6520 4344 2075 7369 6e67 2042 494f ble CD using BIO │ │ │ │ -00007390: 530a 6675 6e63 7469 6f6e 732e 0a0a 1f0a S.functions..... │ │ │ │ -000073a0: 4669 6c65 3a20 6772 7562 2e69 6e66 6f2c File: grub.info, │ │ │ │ -000073b0: 2020 4e6f 6465 3a20 4465 7669 6365 206d Node: Device m │ │ │ │ -000073c0: 6170 2c20 204e 6578 743a 2042 494f 5320 ap, Next: BIOS │ │ │ │ -000073d0: 696e 7374 616c 6c61 7469 6f6e 2c20 2050 installation, P │ │ │ │ -000073e0: 7265 763a 204d 616b 696e 6720 6120 4752 rev: Making a GR │ │ │ │ -000073f0: 5542 2062 6f6f 7461 626c 6520 4344 2d52 UB bootable CD-R │ │ │ │ -00007400: 4f4d 2c20 2055 703a 2049 6e73 7461 6c6c OM, Up: Install │ │ │ │ -00007410: 6174 696f 6e0a 0a34 2e33 2054 6865 206d ation..4.3 The m │ │ │ │ -00007420: 6170 2062 6574 7765 656e 2042 494f 5320 ap between BIOS │ │ │ │ -00007430: 6472 6976 6573 2061 6e64 204f 5320 6465 drives and OS de │ │ │ │ -00007440: 7669 6365 730a 3d3d 3d3d 3d3d 3d3d 3d3d vices.========== │ │ │ │ +00006c70: 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a 4752 5542 ==========..GRUB │ │ │ │ +00006c80: 2073 7570 706f 7274 7320 7468 6520 226e supports the "n │ │ │ │ +00006c90: 6f20 656d 756c 6174 696f 6e20 6d6f 6465 o emulation mode │ │ │ │ +00006ca0: 2220 696e 2074 6865 2045 6c20 546f 7269 " in the El Tori │ │ │ │ +00006cb0: 746f 2073 7065 6369 6669 6361 7469 6f6e to specification │ │ │ │ +00006cc0: 2831 290a 282a 6e6f 7465 204d 616b 696e (1).(*note Makin │ │ │ │ +00006cd0: 6720 6120 4752 5542 2062 6f6f 7461 626c g a GRUB bootabl │ │ │ │ +00006ce0: 6520 4344 2d52 4f4d 2d46 6f6f 746e 6f74 e CD-ROM-Footnot │ │ │ │ +00006cf0: 652d 313a 3a29 2e20 2054 6869 7320 6d65 e-1::). This me │ │ │ │ +00006d00: 616e 7320 7468 6174 2079 6f75 0a63 616e ans that you.can │ │ │ │ +00006d10: 2075 7365 2074 6865 2077 686f 6c65 2043 use the whole C │ │ │ │ +00006d20: 442d 524f 4d20 6672 6f6d 2047 5255 4220 D-ROM from GRUB │ │ │ │ +00006d30: 616e 6420 796f 7520 646f 6e27 7420 6861 and you don't ha │ │ │ │ +00006d40: 7665 2074 6f20 6d61 6b65 2061 2066 6c6f ve to make a flo │ │ │ │ +00006d50: 7070 790a 6f72 2068 6172 6420 6469 736b ppy.or hard disk │ │ │ │ +00006d60: 2069 6d61 6765 2066 696c 652c 2077 6869 image file, whi │ │ │ │ +00006d70: 6368 2063 616e 2063 6175 7365 2063 6f6d ch can cause com │ │ │ │ +00006d80: 7061 7469 6269 6c69 7479 2070 726f 626c patibility probl │ │ │ │ +00006d90: 656d 732e 0a0a 2020 2046 6f72 2062 6f6f ems... For boo │ │ │ │ +00006da0: 7469 6e67 2066 726f 6d20 6120 4344 2d52 ting from a CD-R │ │ │ │ +00006db0: 4f4d 2c20 4752 5542 2075 7365 7320 6120 OM, GRUB uses a │ │ │ │ +00006dc0: 7370 6563 6961 6c20 696d 6167 6520 6361 special image ca │ │ │ │ +00006dd0: 6c6c 6564 0a27 6364 626f 6f74 2e69 6d67 lled.'cdboot.img │ │ │ │ +00006de0: 272c 2077 6869 6368 2069 7320 636f 6e63 ', which is conc │ │ │ │ +00006df0: 6174 656e 6174 6564 2077 6974 6820 2763 atenated with 'c │ │ │ │ +00006e00: 6f72 652e 696d 6727 2e20 2054 6865 2027 ore.img'. The ' │ │ │ │ +00006e10: 636f 7265 2e69 6d67 270a 7573 6564 2066 core.img'.used f │ │ │ │ +00006e20: 6f72 2074 6869 7320 7368 6f75 6c64 2062 or this should b │ │ │ │ +00006e30: 6520 6275 696c 7420 7769 7468 2061 7420 e built with at │ │ │ │ +00006e40: 6c65 6173 7420 7468 6520 2769 736f 3936 least the 'iso96 │ │ │ │ +00006e50: 3630 2720 616e 6420 2762 696f 7364 6973 60' and 'biosdis │ │ │ │ +00006e60: 6b27 0a6d 6f64 756c 6573 2e20 2059 6f75 k'.modules. You │ │ │ │ +00006e70: 7220 626f 6f74 6162 6c65 2043 442d 524f r bootable CD-RO │ │ │ │ +00006e80: 4d20 7769 6c6c 2075 7375 616c 6c79 2061 M will usually a │ │ │ │ +00006e90: 6c73 6f20 6e65 6564 2074 6f20 696e 636c lso need to incl │ │ │ │ +00006ea0: 7564 6520 610a 636f 6e66 6967 7572 6174 ude a.configurat │ │ │ │ +00006eb0: 696f 6e20 6669 6c65 2027 6772 7562 2e63 ion file 'grub.c │ │ │ │ +00006ec0: 6667 2720 616e 6420 736f 6d65 206f 7468 fg' and some oth │ │ │ │ +00006ed0: 6572 2047 5255 4220 6d6f 6475 6c65 732e er GRUB modules. │ │ │ │ +00006ee0: 0a0a 2020 2054 6f20 6d61 6b65 2061 2073 .. To make a s │ │ │ │ +00006ef0: 696d 706c 6520 6765 6e65 7269 6320 4752 imple generic GR │ │ │ │ +00006f00: 5542 2072 6573 6375 6520 4344 2c20 796f UB rescue CD, yo │ │ │ │ +00006f10: 7520 6361 6e20 7573 6520 7468 650a 2767 u can use the.'g │ │ │ │ +00006f20: 7275 622d 6d6b 7265 7363 7565 2720 7072 rub-mkrescue' pr │ │ │ │ +00006f30: 6f67 7261 6d20 282a 6e6f 7465 2049 6e76 ogram (*note Inv │ │ │ │ +00006f40: 6f6b 696e 6720 6772 7562 2d6d 6b72 6573 oking grub-mkres │ │ │ │ +00006f50: 6375 653a 3a29 3a0a 0a20 2020 2020 2420 cue::):.. $ │ │ │ │ +00006f60: 6772 7562 2d6d 6b72 6573 6375 6520 2d6f grub-mkrescue -o │ │ │ │ +00006f70: 2067 7275 622e 6973 6f0a 0a20 2020 596f grub.iso.. Yo │ │ │ │ +00006f80: 7520 7769 6c6c 206f 6674 656e 206e 6565 u will often nee │ │ │ │ +00006f90: 6420 746f 2069 6e63 6c75 6465 206f 7468 d to include oth │ │ │ │ +00006fa0: 6572 2066 696c 6573 2069 6e20 796f 7572 er files in your │ │ │ │ +00006fb0: 2069 6d61 6765 2e20 2054 6f20 646f 0a74 image. To do.t │ │ │ │ +00006fc0: 6869 732c 2066 6972 7374 206d 616b 6520 his, first make │ │ │ │ +00006fd0: 6120 746f 7020 6469 7265 6374 6f72 7920 a top directory │ │ │ │ +00006fe0: 666f 7220 7468 6520 626f 6f74 6162 6c65 for the bootable │ │ │ │ +00006ff0: 2069 6d61 6765 2c20 7361 792c 2027 6973 image, say, 'is │ │ │ │ +00007000: 6f27 3a0a 0a20 2020 2020 2420 6d6b 6469 o':.. $ mkdi │ │ │ │ +00007010: 7220 6973 6f0a 0a20 2020 4d61 6b65 2061 r iso.. Make a │ │ │ │ +00007020: 2064 6972 6563 746f 7279 2066 6f72 2047 directory for G │ │ │ │ +00007030: 5255 423a 0a0a 2020 2020 2024 206d 6b64 RUB:.. $ mkd │ │ │ │ +00007040: 6972 202d 7020 6973 6f2f 626f 6f74 2f67 ir -p iso/boot/g │ │ │ │ +00007050: 7275 620a 0a20 2020 4966 2064 6573 6972 rub.. If desir │ │ │ │ +00007060: 6564 2c20 6d61 6b65 2074 6865 2063 6f6e ed, make the con │ │ │ │ +00007070: 6669 6720 6669 6c65 2027 6772 7562 2e63 fig file 'grub.c │ │ │ │ +00007080: 6667 2720 756e 6465 7220 2769 736f 2f62 fg' under 'iso/b │ │ │ │ +00007090: 6f6f 742f 6772 7562 270a 282a 6e6f 7465 oot/grub'.(*note │ │ │ │ +000070a0: 2043 6f6e 6669 6775 7261 7469 6f6e 3a3a Configuration:: │ │ │ │ +000070b0: 292c 2061 6e64 2063 6f70 7920 616e 7920 ), and copy any │ │ │ │ +000070c0: 6669 6c65 7320 616e 6420 6469 7265 6374 files and direct │ │ │ │ +000070d0: 6f72 6965 7320 666f 7220 7468 6520 6469 ories for the di │ │ │ │ +000070e0: 7363 0a74 6f20 7468 6520 6469 7265 6374 sc.to the direct │ │ │ │ +000070f0: 6f72 7920 2769 736f 2f27 2e0a 0a20 2020 ory 'iso/'... │ │ │ │ +00007100: 4669 6e61 6c6c 792c 206d 616b 6520 7468 Finally, make th │ │ │ │ +00007110: 6520 696d 6167 653a 0a0a 2020 2020 2024 e image:.. $ │ │ │ │ +00007120: 2067 7275 622d 6d6b 7265 7363 7565 202d grub-mkrescue - │ │ │ │ +00007130: 6f20 6772 7562 2e69 736f 2069 736f 0a0a o grub.iso iso.. │ │ │ │ +00007140: 2020 2054 6869 7320 7072 6f64 7563 6573 This produces │ │ │ │ +00007150: 2061 2066 696c 6520 6e61 6d65 6420 2767 a file named 'g │ │ │ │ +00007160: 7275 622e 6973 6f27 2c20 7768 6963 6820 rub.iso', which │ │ │ │ +00007170: 7468 656e 2063 616e 2062 6520 6275 726e then can be burn │ │ │ │ +00007180: 6564 2069 6e74 6f0a 6120 4344 2028 6f72 ed into.a CD (or │ │ │ │ +00007190: 2061 2044 5644 292c 206f 7220 7772 6974 a DVD), or writ │ │ │ │ +000071a0: 7465 6e20 746f 2061 2055 5342 206d 6173 ten to a USB mas │ │ │ │ +000071b0: 7320 7374 6f72 6167 6520 6465 7669 6365 s storage device │ │ │ │ +000071c0: 2e0a 0a20 2020 5468 6520 726f 6f74 2064 ... The root d │ │ │ │ +000071d0: 6576 6963 6520 7769 6c6c 2062 6520 7365 evice will be se │ │ │ │ +000071e0: 7420 7570 2061 7070 726f 7072 6961 7465 t up appropriate │ │ │ │ +000071f0: 6c79 206f 6e20 656e 7465 7269 6e67 2079 ly on entering y │ │ │ │ +00007200: 6f75 720a 2767 7275 622e 6366 6727 2063 our.'grub.cfg' c │ │ │ │ +00007210: 6f6e 6669 6775 7261 7469 6f6e 2066 696c onfiguration fil │ │ │ │ +00007220: 652c 2073 6f20 796f 7520 6361 6e20 7265 e, so you can re │ │ │ │ +00007230: 6665 7220 746f 2066 696c 6520 6e61 6d65 fer to file name │ │ │ │ +00007240: 7320 6f6e 2074 6865 2043 440a 7769 7468 s on the CD.with │ │ │ │ +00007250: 6f75 7420 6e65 6564 696e 6720 746f 2075 out needing to u │ │ │ │ +00007260: 7365 2061 6e20 6578 706c 6963 6974 2064 se an explicit d │ │ │ │ +00007270: 6576 6963 6520 6e61 6d65 2e20 2054 6869 evice name. Thi │ │ │ │ +00007280: 7320 6d61 6b65 7320 6974 2065 6173 6965 s makes it easie │ │ │ │ +00007290: 7220 746f 0a70 726f 6475 6365 2072 6573 r to.produce res │ │ │ │ +000072a0: 6375 6520 696d 6167 6573 2074 6861 7420 cue images that │ │ │ │ +000072b0: 7769 6c6c 2077 6f72 6b20 6f6e 2062 6f74 will work on bot │ │ │ │ +000072c0: 6820 6f70 7469 6361 6c20 6472 6976 6573 h optical drives │ │ │ │ +000072d0: 2061 6e64 2055 5342 206d 6173 730a 7374 and USB mass.st │ │ │ │ +000072e0: 6f72 6167 6520 6465 7669 6365 732e 0a0a orage devices... │ │ │ │ +000072f0: 1f0a 4669 6c65 3a20 6772 7562 2e69 6e66 ..File: grub.inf │ │ │ │ +00007300: 6f2c 2020 4e6f 6465 3a20 4d61 6b69 6e67 o, Node: Making │ │ │ │ +00007310: 2061 2047 5255 4220 626f 6f74 6162 6c65 a GRUB bootable │ │ │ │ +00007320: 2043 442d 524f 4d2d 466f 6f74 6e6f 7465 CD-ROM-Footnote │ │ │ │ +00007330: 732c 2020 5570 3a20 4d61 6b69 6e67 2061 s, Up: Making a │ │ │ │ +00007340: 2047 5255 4220 626f 6f74 6162 6c65 2043 GRUB bootable C │ │ │ │ +00007350: 442d 524f 4d0a 0a20 2020 2831 2920 456c D-ROM.. (1) El │ │ │ │ +00007360: 2054 6f72 6974 6f20 6973 2061 2073 7065 Torito is a spe │ │ │ │ +00007370: 6369 6669 6361 7469 6f6e 2066 6f72 2062 cification for b │ │ │ │ +00007380: 6f6f 7461 626c 6520 4344 2075 7369 6e67 ootable CD using │ │ │ │ +00007390: 2042 494f 530a 6675 6e63 7469 6f6e 732e BIOS.functions. │ │ │ │ +000073a0: 0a0a 1f0a 4669 6c65 3a20 6772 7562 2e69 ....File: grub.i │ │ │ │ +000073b0: 6e66 6f2c 2020 4e6f 6465 3a20 4465 7669 nfo, Node: Devi │ │ │ │ +000073c0: 6365 206d 6170 2c20 204e 6578 743a 2042 ce map, Next: B │ │ │ │ +000073d0: 494f 5320 696e 7374 616c 6c61 7469 6f6e IOS installation │ │ │ │ +000073e0: 2c20 2050 7265 763a 204d 616b 696e 6720 , Prev: Making │ │ │ │ +000073f0: 6120 4752 5542 2062 6f6f 7461 626c 6520 a GRUB bootable │ │ │ │ +00007400: 4344 2d52 4f4d 2c20 2055 703a 2049 6e73 CD-ROM, Up: Ins │ │ │ │ +00007410: 7461 6c6c 6174 696f 6e0a 0a34 2e33 2054 tallation..4.3 T │ │ │ │ +00007420: 6865 206d 6170 2062 6574 7765 656e 2042 he map between B │ │ │ │ +00007430: 494f 5320 6472 6976 6573 2061 6e64 204f IOS drives and O │ │ │ │ +00007440: 5320 6465 7669 6365 730a 3d3d 3d3d 3d3d S devices.====== │ │ │ │ 00007450: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ 00007460: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ -00007470: 3d3d 3d3d 0a0a 4966 2074 6865 2064 6576 ====..If the dev │ │ │ │ -00007480: 6963 6520 6d61 7020 6669 6c65 2065 7869 ice map file exi │ │ │ │ -00007490: 7374 732c 2074 6865 2047 5255 4220 7574 sts, the GRUB ut │ │ │ │ -000074a0: 696c 6974 6965 7320 2827 6772 7562 2d70 ilities ('grub-p │ │ │ │ -000074b0: 726f 6265 272c 2065 7463 2e29 0a72 6561 robe', etc.).rea │ │ │ │ -000074c0: 6420 6974 2074 6f20 6d61 7020 4249 4f53 d it to map BIOS │ │ │ │ -000074d0: 2064 7269 7665 7320 746f 204f 5320 6465 drives to OS de │ │ │ │ -000074e0: 7669 6365 732e 2020 5468 6973 2066 696c vices. This fil │ │ │ │ -000074f0: 6520 636f 6e73 6973 7473 206f 6620 6c69 e consists of li │ │ │ │ -00007500: 6e65 730a 6c69 6b65 2074 6869 733a 0a0a nes.like this:.. │ │ │ │ -00007510: 2020 2020 2028 4445 5649 4345 2920 4649 (DEVICE) FI │ │ │ │ -00007520: 4c45 0a0a 2020 2044 4556 4943 4520 6973 LE.. DEVICE is │ │ │ │ -00007530: 2061 2064 7269 7665 2073 7065 6369 6669 a drive specifi │ │ │ │ -00007540: 6564 2069 6e20 7468 6520 4752 5542 2073 ed in the GRUB s │ │ │ │ -00007550: 796e 7461 7820 282a 6e6f 7465 2044 6576 yntax (*note Dev │ │ │ │ -00007560: 6963 650a 7379 6e74 6178 3a3a 292c 2061 ice.syntax::), a │ │ │ │ -00007570: 6e64 2046 494c 4520 6973 2061 6e20 4f53 nd FILE is an OS │ │ │ │ -00007580: 2066 696c 652c 2077 6869 6368 2069 7320 file, which is │ │ │ │ -00007590: 6e6f 726d 616c 6c79 2061 2064 6576 6963 normally a devic │ │ │ │ -000075a0: 6520 6669 6c65 2e0a 0a20 2020 4869 7374 e file... Hist │ │ │ │ -000075b0: 6f72 6963 616c 6c79 2c20 7468 6520 6465 orically, the de │ │ │ │ -000075c0: 7669 6365 206d 6170 2066 696c 6520 7761 vice map file wa │ │ │ │ -000075d0: 7320 7573 6564 2062 6563 6175 7365 2047 s used because G │ │ │ │ -000075e0: 5255 4220 6465 7669 6365 206e 616d 6573 RUB device names │ │ │ │ -000075f0: 0a68 6164 2074 6f20 6265 2075 7365 6420 .had to be used │ │ │ │ -00007600: 696e 2074 6865 2063 6f6e 6669 6775 7261 in the configura │ │ │ │ -00007610: 7469 6f6e 2066 696c 652c 2061 6e64 2074 tion file, and t │ │ │ │ -00007620: 6865 7920 7765 7265 2064 6572 6976 6564 hey were derived │ │ │ │ -00007630: 2066 726f 6d0a 4249 4f53 2064 7269 7665 from.BIOS drive │ │ │ │ -00007640: 206e 756d 6265 7273 2e20 2054 6865 206d numbers. The m │ │ │ │ -00007650: 6170 2062 6574 7765 656e 2042 494f 5320 ap between BIOS │ │ │ │ -00007660: 6472 6976 6573 2061 6e64 204f 5320 6465 drives and OS de │ │ │ │ -00007670: 7669 6365 7320 6361 6e6e 6f74 0a61 6c77 vices cannot.alw │ │ │ │ -00007680: 6179 7320 6265 2067 7565 7373 6564 2063 ays be guessed c │ │ │ │ -00007690: 6f72 7265 6374 6c79 3a20 666f 7220 6578 orrectly: for ex │ │ │ │ -000076a0: 616d 706c 652c 2047 5255 4220 7769 6c6c ample, GRUB will │ │ │ │ -000076b0: 2067 6574 2074 6865 206f 7264 6572 2077 get the order w │ │ │ │ -000076c0: 726f 6e67 0a69 6620 796f 7520 6578 6368 rong.if you exch │ │ │ │ -000076d0: 616e 6765 2074 6865 2062 6f6f 7420 7365 ange the boot se │ │ │ │ -000076e0: 7175 656e 6365 2062 6574 7765 656e 2049 quence between I │ │ │ │ -000076f0: 4445 2061 6e64 2053 4353 4920 696e 2079 DE and SCSI in y │ │ │ │ -00007700: 6f75 7220 4249 4f53 2e0a 0a20 2020 556e our BIOS... Un │ │ │ │ -00007710: 666f 7274 756e 6174 656c 792c 2065 7665 fortunately, eve │ │ │ │ -00007720: 6e20 4f53 2064 6576 6963 6520 6e61 6d65 n OS device name │ │ │ │ -00007730: 7320 6172 6520 6e6f 7420 616c 7761 7973 s are not always │ │ │ │ -00007740: 2073 7461 626c 652e 2020 4d6f 6465 726e stable. Modern │ │ │ │ -00007750: 0a76 6572 7369 6f6e 7320 6f66 2074 6865 .versions of the │ │ │ │ -00007760: 204c 696e 7578 206b 6572 6e65 6c20 6d61 Linux kernel ma │ │ │ │ -00007770: 7920 7072 6f62 6520 6472 6976 6573 2069 y probe drives i │ │ │ │ -00007780: 6e20 6120 6469 6666 6572 656e 7420 6f72 n a different or │ │ │ │ -00007790: 6465 7220 6672 6f6d 0a62 6f6f 7420 746f der from.boot to │ │ │ │ -000077a0: 2062 6f6f 742c 2061 6e64 2074 6865 2070 boot, and the p │ │ │ │ -000077b0: 7265 6669 7820 2827 2f64 6576 2f68 642a refix ('/dev/hd* │ │ │ │ -000077c0: 2720 7665 7273 7573 2027 2f64 6576 2f73 ' versus '/dev/s │ │ │ │ -000077d0: 642a 2729 206d 6179 2063 6861 6e67 650a d*') may change. │ │ │ │ -000077e0: 6465 7065 6e64 696e 6720 6f6e 2074 6865 depending on the │ │ │ │ -000077f0: 2064 7269 7665 7220 7375 6273 7973 7465 driver subsyste │ │ │ │ -00007800: 6d20 696e 2075 7365 2e20 2041 7320 6120 m in use. As a │ │ │ │ -00007810: 7265 7375 6c74 2c20 7468 6520 6465 7669 result, the devi │ │ │ │ -00007820: 6365 206d 6170 0a66 696c 6520 7265 7175 ce map.file requ │ │ │ │ -00007830: 6972 6564 2066 7265 7175 656e 7420 6564 ired frequent ed │ │ │ │ -00007840: 6974 696e 6720 6f6e 2073 6f6d 6520 7379 iting on some sy │ │ │ │ -00007850: 7374 656d 732e 0a0a 2020 2047 5255 4220 stems... GRUB │ │ │ │ -00007860: 6176 6f69 6473 2074 6869 7320 7072 6f62 avoids this prob │ │ │ │ -00007870: 6c65 6d20 6e6f 7761 6461 7973 2062 7920 lem nowadays by │ │ │ │ -00007880: 7573 696e 6720 5555 4944 7320 6f72 2066 using UUIDs or f │ │ │ │ -00007890: 696c 6520 7379 7374 656d 0a6c 6162 656c ile system.label │ │ │ │ -000078a0: 7320 7768 656e 2067 656e 6572 6174 696e s when generatin │ │ │ │ -000078b0: 6720 2767 7275 622e 6366 6727 2c20 616e g 'grub.cfg', an │ │ │ │ -000078c0: 6420 7765 2061 6476 6973 6520 7468 6174 d we advise that │ │ │ │ -000078d0: 2079 6f75 2064 6f20 7468 6520 7361 6d65 you do the same │ │ │ │ -000078e0: 0a66 6f72 2061 6e79 2063 7573 746f 6d20 .for any custom │ │ │ │ -000078f0: 6d65 6e75 2065 6e74 7269 6573 2079 6f75 menu entries you │ │ │ │ -00007900: 2077 7269 7465 2e20 2049 6620 7468 6520 write. If the │ │ │ │ -00007910: 6465 7669 6365 206d 6170 2066 696c 6520 device map file │ │ │ │ -00007920: 646f 6573 206e 6f74 0a65 7869 7374 2c20 does not.exist, │ │ │ │ -00007930: 7468 656e 2074 6865 2047 5255 4220 7574 then the GRUB ut │ │ │ │ -00007940: 696c 6974 6965 7320 7769 6c6c 2061 7373 ilities will ass │ │ │ │ -00007950: 756d 6520 6120 7465 6d70 6f72 6172 7920 ume a temporary │ │ │ │ -00007960: 6465 7669 6365 206d 6170 206f 6e20 7468 device map on th │ │ │ │ -00007970: 650a 666c 792e 2020 5468 6973 2069 7320 e.fly. This is │ │ │ │ -00007980: 6f66 7465 6e20 676f 6f64 2065 6e6f 7567 often good enoug │ │ │ │ -00007990: 682c 2070 6172 7469 6375 6c61 726c 7920 h, particularly │ │ │ │ -000079a0: 696e 2074 6865 2063 6f6d 6d6f 6e20 6361 in the common ca │ │ │ │ -000079b0: 7365 206f 660a 7369 6e67 6c65 2d64 6973 se of.single-dis │ │ │ │ -000079c0: 6b20 7379 7374 656d 732e 0a0a 2020 2048 k systems... H │ │ │ │ -000079d0: 6f77 6576 6572 2c20 7468 6520 6465 7669 owever, the devi │ │ │ │ -000079e0: 6365 206d 6170 2066 696c 6520 6973 206e ce map file is n │ │ │ │ -000079f0: 6f74 2065 6e74 6972 656c 7920 6f62 736f ot entirely obso │ │ │ │ -00007a00: 6c65 7465 2079 6574 2c20 616e 6420 6974 lete yet, and it │ │ │ │ -00007a10: 2069 730a 7573 6564 2066 6f72 206f 7665 is.used for ove │ │ │ │ -00007a20: 7272 6964 696e 6720 7768 656e 2063 7572 rriding when cur │ │ │ │ -00007a30: 7265 6e74 2065 6e76 6972 6f6e 6d65 6e74 rent environment │ │ │ │ -00007a40: 2069 7320 6469 6666 6572 656e 7420 6672 is different fr │ │ │ │ -00007a50: 6f6d 2074 6865 206f 6e65 0a6f 6e20 626f om the one.on bo │ │ │ │ -00007a60: 6f74 2e20 204d 6f73 7420 636f 6d6d 6f6e ot. Most common │ │ │ │ -00007a70: 2063 6173 6520 6973 2069 6620 796f 7520 case is if you │ │ │ │ -00007a80: 7573 6520 6120 7061 7274 6974 696f 6e20 use a partition │ │ │ │ -00007a90: 6f72 206c 6f67 6963 616c 2076 6f6c 756d or logical volum │ │ │ │ -00007aa0: 650a 6173 2061 2064 6973 6b20 666f 7220 e.as a disk for │ │ │ │ -00007ab0: 7669 7274 7561 6c20 6d61 6368 696e 652e virtual machine. │ │ │ │ -00007ac0: 2020 596f 7520 6361 6e20 7075 7420 616e You can put an │ │ │ │ -00007ad0: 7920 636f 6d6d 656e 7473 2069 6e20 7468 y comments in th │ │ │ │ -00007ae0: 6520 6669 6c65 2069 660a 6e65 6564 6564 e file if.needed │ │ │ │ -00007af0: 2c20 6173 2074 6865 2047 5255 4220 7574 , as the GRUB ut │ │ │ │ -00007b00: 696c 6974 6965 7320 6173 7375 6d65 2074 ilities assume t │ │ │ │ -00007b10: 6861 7420 6120 6c69 6e65 2069 7320 6a75 hat a line is ju │ │ │ │ -00007b20: 7374 2061 2063 6f6d 6d65 6e74 2069 660a st a comment if. │ │ │ │ -00007b30: 7468 6520 6669 7273 7420 6368 6172 6163 the first charac │ │ │ │ -00007b40: 7465 7220 6973 2027 2327 2e0a 0a1f 0a46 ter is '#'.....F │ │ │ │ -00007b50: 696c 653a 2067 7275 622e 696e 666f 2c20 ile: grub.info, │ │ │ │ -00007b60: 204e 6f64 653a 2042 494f 5320 696e 7374 Node: BIOS inst │ │ │ │ -00007b70: 616c 6c61 7469 6f6e 2c20 2050 7265 763a allation, Prev: │ │ │ │ -00007b80: 2044 6576 6963 6520 6d61 702c 2020 5570 Device map, Up │ │ │ │ -00007b90: 3a20 496e 7374 616c 6c61 7469 6f6e 0a0a : Installation.. │ │ │ │ -00007ba0: 342e 3420 4249 4f53 2069 6e73 7461 6c6c 4.4 BIOS install │ │ │ │ -00007bb0: 6174 696f 6e0a 3d3d 3d3d 3d3d 3d3d 3d3d ation.========== │ │ │ │ -00007bc0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a4d 4252 ===========..MBR │ │ │ │ -00007bd0: 0a3d 3d3d 0a0a 5468 6520 7061 7274 6974 .===..The partit │ │ │ │ -00007be0: 696f 6e20 7461 626c 6520 666f 726d 6174 ion table format │ │ │ │ -00007bf0: 2074 7261 6469 7469 6f6e 616c 6c79 2075 traditionally u │ │ │ │ -00007c00: 7365 6420 6f6e 2050 4320 4249 4f53 2070 sed on PC BIOS p │ │ │ │ -00007c10: 6c61 7466 6f72 6d73 2069 730a 6361 6c6c latforms is.call │ │ │ │ -00007c20: 6564 2074 6865 204d 6173 7465 7220 426f ed the Master Bo │ │ │ │ -00007c30: 6f74 2052 6563 6f72 6420 284d 4252 2920 ot Record (MBR) │ │ │ │ -00007c40: 666f 726d 6174 3b20 7468 6973 2069 7320 format; this is │ │ │ │ -00007c50: 7468 6520 666f 726d 6174 2074 6861 740a the format that. │ │ │ │ -00007c60: 616c 6c6f 7773 2075 7020 746f 2066 6f75 allows up to fou │ │ │ │ -00007c70: 7220 7072 696d 6172 7920 7061 7274 6974 r primary partit │ │ │ │ -00007c80: 696f 6e73 2061 6e64 2061 6464 6974 696f ions and additio │ │ │ │ -00007c90: 6e61 6c20 6c6f 6769 6361 6c20 7061 7274 nal logical part │ │ │ │ -00007ca0: 6974 696f 6e73 2e0a 5769 7468 2074 6869 itions..With thi │ │ │ │ -00007cb0: 7320 7061 7274 6974 696f 6e20 7461 626c s partition tabl │ │ │ │ -00007cc0: 6520 666f 726d 6174 2c20 7468 6572 6520 e format, there │ │ │ │ -00007cd0: 6172 6520 7477 6f20 7761 7973 2074 6f20 are two ways to │ │ │ │ -00007ce0: 696e 7374 616c 6c20 4752 5542 3a20 6974 install GRUB: it │ │ │ │ -00007cf0: 0a63 616e 2062 6520 656d 6265 6464 6564 .can be embedded │ │ │ │ -00007d00: 2069 6e20 7468 6520 6172 6561 2062 6574 in the area bet │ │ │ │ -00007d10: 7765 656e 2074 6865 204d 4252 2061 6e64 ween the MBR and │ │ │ │ -00007d20: 2074 6865 2066 6972 7374 2070 6172 7469 the first parti │ │ │ │ -00007d30: 7469 6f6e 0a28 6361 6c6c 6564 2062 7920 tion.(called by │ │ │ │ -00007d40: 7661 7269 6f75 7320 6e61 6d65 732c 2073 various names, s │ │ │ │ -00007d50: 7563 6820 6173 2074 6865 2022 626f 6f74 uch as the "boot │ │ │ │ -00007d60: 2074 7261 636b 222c 2022 4d42 5220 6761 track", "MBR ga │ │ │ │ -00007d70: 7022 2c20 6f72 0a22 656d 6265 6464 696e p", or."embeddin │ │ │ │ -00007d80: 6720 6172 6561 222c 2061 6e64 2077 6869 g area", and whi │ │ │ │ -00007d90: 6368 2069 7320 7573 7561 6c6c 7920 6174 ch is usually at │ │ │ │ -00007da0: 206c 6561 7374 2033 3120 4b69 4229 2c20 least 31 KiB), │ │ │ │ -00007db0: 6f72 2074 6865 2063 6f72 650a 696d 6167 or the core.imag │ │ │ │ -00007dc0: 6520 6361 6e20 6265 2069 6e73 7461 6c6c e can be install │ │ │ │ -00007dd0: 6564 2069 6e20 6120 6669 6c65 2073 7973 ed in a file sys │ │ │ │ -00007de0: 7465 6d20 616e 6420 6120 6c69 7374 206f tem and a list o │ │ │ │ -00007df0: 6620 7468 6520 626c 6f63 6b73 2074 6861 f the blocks tha │ │ │ │ -00007e00: 740a 6d61 6b65 2069 7420 7570 2063 616e t.make it up can │ │ │ │ -00007e10: 2062 6520 7374 6f72 6564 2069 6e20 7468 be stored in th │ │ │ │ -00007e20: 6520 6669 7273 7420 7365 6374 6f72 206f e first sector o │ │ │ │ -00007e30: 6620 7468 6174 2070 6172 7469 7469 6f6e f that partition │ │ │ │ -00007e40: 2e0a 0a20 2020 4561 6368 206f 6620 7468 ... Each of th │ │ │ │ -00007e50: 6573 6520 6861 7320 6469 6666 6572 656e ese has differen │ │ │ │ -00007e60: 7420 7072 6f62 6c65 6d73 2e20 2054 6865 t problems. The │ │ │ │ -00007e70: 7265 2069 7320 6e6f 2077 6179 2074 6f20 re is no way to │ │ │ │ -00007e80: 7265 7365 7276 650a 7370 6163 6520 696e reserve.space in │ │ │ │ -00007e90: 2074 6865 2065 6d62 6564 6469 6e67 2061 the embedding a │ │ │ │ -00007ea0: 7265 6120 7769 7468 2063 6f6d 706c 6574 rea with complet │ │ │ │ -00007eb0: 6520 7361 6665 7479 2c20 616e 6420 736f e safety, and so │ │ │ │ -00007ec0: 6d65 2070 726f 7072 6965 7461 7279 0a73 me proprietary.s │ │ │ │ -00007ed0: 6f66 7477 6172 6520 6973 206b 6e6f 776e oftware is known │ │ │ │ -00007ee0: 2074 6f20 7573 6520 6974 2074 6f20 6d61 to use it to ma │ │ │ │ -00007ef0: 6b65 2069 7420 6469 6666 6963 756c 7420 ke it difficult │ │ │ │ -00007f00: 666f 7220 7573 6572 7320 746f 2077 6f72 for users to wor │ │ │ │ -00007f10: 6b0a 6172 6f75 6e64 206c 6963 656e 7369 k.around licensi │ │ │ │ -00007f20: 6e67 2072 6573 7472 6963 7469 6f6e 733b ng restrictions; │ │ │ │ -00007f30: 2061 6e64 2073 7973 7465 6d73 2061 7265 and systems are │ │ │ │ -00007f40: 2073 6f6d 6574 696d 6573 2070 6172 7469 sometimes parti │ │ │ │ -00007f50: 7469 6f6e 6564 0a77 6974 686f 7574 206c tioned.without l │ │ │ │ -00007f60: 6561 7669 6e67 2065 6e6f 7567 6820 7370 eaving enough sp │ │ │ │ -00007f70: 6163 6520 6265 666f 7265 2074 6865 2066 ace before the f │ │ │ │ -00007f80: 6972 7374 2070 6172 7469 7469 6f6e 2e20 irst partition. │ │ │ │ -00007f90: 204f 6e20 7468 6520 6f74 6865 720a 6861 On the other.ha │ │ │ │ -00007fa0: 6e64 2c20 696e 7374 616c 6c69 6e67 2074 nd, installing t │ │ │ │ -00007fb0: 6f20 6120 6669 6c65 7379 7374 656d 206d o a filesystem m │ │ │ │ -00007fc0: 6561 6e73 2074 6861 7420 4752 5542 2069 eans that GRUB i │ │ │ │ -00007fd0: 7320 7675 6c6e 6572 6162 6c65 2074 6f20 s vulnerable to │ │ │ │ -00007fe0: 6974 730a 626c 6f63 6b73 2062 6569 6e67 its.blocks being │ │ │ │ -00007ff0: 206d 6f76 6564 2061 726f 756e 6420 6279 moved around by │ │ │ │ -00008000: 2066 696c 6573 7973 7465 6d20 6665 6174 filesystem feat │ │ │ │ -00008010: 7572 6573 2073 7563 6820 6173 2074 6169 ures such as tai │ │ │ │ -00008020: 6c20 7061 636b 696e 672c 0a6f 7220 6576 l packing,.or ev │ │ │ │ -00008030: 656e 2062 7920 6167 6772 6573 7369 7665 en by aggressive │ │ │ │ -00008040: 2066 7363 6b20 696d 706c 656d 656e 7461 fsck implementa │ │ │ │ -00008050: 7469 6f6e 732c 2073 6f20 7468 6973 2061 tions, so this a │ │ │ │ -00008060: 7070 726f 6163 6820 6973 2071 7569 7465 pproach is quite │ │ │ │ -00008070: 0a66 7261 6769 6c65 3b20 616e 6420 7468 .fragile; and th │ │ │ │ -00008080: 6973 2061 7070 726f 6163 6820 6361 6e20 is approach can │ │ │ │ -00008090: 6f6e 6c79 2062 6520 7573 6564 2069 6620 only be used if │ │ │ │ -000080a0: 7468 6520 272f 626f 6f74 2720 6669 6c65 the '/boot' file │ │ │ │ -000080b0: 7379 7374 656d 2069 730a 6f6e 2074 6865 system is.on the │ │ │ │ -000080c0: 2073 616d 6520 6469 736b 2074 6861 7420 same disk that │ │ │ │ -000080d0: 7468 6520 4249 4f53 2062 6f6f 7473 2066 the BIOS boots f │ │ │ │ -000080e0: 726f 6d2c 2073 6f20 7468 6174 2047 5255 rom, so that GRU │ │ │ │ -000080f0: 4220 646f 6573 206e 6f74 2068 6176 6520 B does not have │ │ │ │ -00008100: 746f 0a72 656c 7920 6f6e 2067 7565 7373 to.rely on guess │ │ │ │ -00008110: 696e 6720 4249 4f53 2064 7269 7665 206e ing BIOS drive n │ │ │ │ -00008120: 756d 6265 7273 2e0a 0a20 2020 5468 6520 umbers... The │ │ │ │ -00008130: 4752 5542 2064 6576 656c 6f70 6d65 6e74 GRUB development │ │ │ │ -00008140: 2074 6561 6d20 6765 6e65 7261 6c6c 7920 team generally │ │ │ │ -00008150: 7265 636f 6d6d 656e 6473 2065 6d62 6564 recommends embed │ │ │ │ -00008160: 6469 6e67 2047 5255 4220 6265 666f 7265 ding GRUB before │ │ │ │ -00008170: 0a74 6865 2066 6972 7374 2070 6172 7469 .the first parti │ │ │ │ -00008180: 7469 6f6e 2c20 756e 6c65 7373 2079 6f75 tion, unless you │ │ │ │ -00008190: 2068 6176 6520 7370 6563 6961 6c20 7265 have special re │ │ │ │ -000081a0: 7175 6972 656d 656e 7473 2e20 2059 6f75 quirements. You │ │ │ │ -000081b0: 206d 7573 740a 656e 7375 7265 2074 6861 must.ensure tha │ │ │ │ -000081c0: 7420 7468 6520 6669 7273 7420 7061 7274 t the first part │ │ │ │ -000081d0: 6974 696f 6e20 7374 6172 7473 2061 7420 ition starts at │ │ │ │ -000081e0: 6c65 6173 7420 3331 204b 6942 2028 3633 least 31 KiB (63 │ │ │ │ -000081f0: 2073 6563 746f 7273 2920 6672 6f6d 0a74 sectors) from.t │ │ │ │ -00008200: 6865 2073 7461 7274 206f 6620 7468 6520 he start of the │ │ │ │ -00008210: 6469 736b 3b20 6f6e 206d 6f64 6572 6e20 disk; on modern │ │ │ │ -00008220: 6469 736b 732c 2069 7420 6973 206f 6674 disks, it is oft │ │ │ │ -00008230: 656e 2061 2070 6572 666f 726d 616e 6365 en a performance │ │ │ │ -00008240: 0a61 6476 616e 7461 6765 2074 6f20 616c .advantage to al │ │ │ │ -00008250: 6967 6e20 7061 7274 6974 696f 6e73 206f ign partitions o │ │ │ │ -00008260: 6e20 6c61 7267 6572 2062 6f75 6e64 6172 n larger boundar │ │ │ │ -00008270: 6965 7320 616e 7977 6179 2c20 736f 2074 ies anyway, so t │ │ │ │ -00008280: 6865 2066 6972 7374 0a70 6172 7469 7469 he first.partiti │ │ │ │ -00008290: 6f6e 206d 6967 6874 2073 7461 7274 2031 on might start 1 │ │ │ │ -000082a0: 204d 6942 2066 726f 6d20 7468 6520 7374 MiB from the st │ │ │ │ -000082b0: 6172 7420 6f66 2074 6865 2064 6973 6b2e art of the disk. │ │ │ │ -000082c0: 0a0a 4750 540a 3d3d 3d0a 0a53 6f6d 6520 ..GPT.===..Some │ │ │ │ -000082d0: 6e65 7765 7220 7379 7374 656d 7320 7573 newer systems us │ │ │ │ -000082e0: 6520 7468 6520 4755 4944 2050 6172 7469 e the GUID Parti │ │ │ │ -000082f0: 7469 6f6e 2054 6162 6c65 2028 4750 5429 tion Table (GPT) │ │ │ │ -00008300: 2066 6f72 6d61 742e 2020 5468 6973 2077 format. This w │ │ │ │ -00008310: 6173 0a73 7065 6369 6669 6564 2061 7320 as.specified as │ │ │ │ -00008320: 7061 7274 206f 6620 7468 6520 4578 7465 part of the Exte │ │ │ │ -00008330: 6e73 6962 6c65 2046 6972 6d77 6172 6520 nsible Firmware │ │ │ │ -00008340: 496e 7465 7266 6163 6520 2845 4649 292c Interface (EFI), │ │ │ │ -00008350: 2062 7574 2069 7420 6361 6e0a 616c 736f but it can.also │ │ │ │ -00008360: 2062 6520 7573 6564 206f 6e20 4249 4f53 be used on BIOS │ │ │ │ -00008370: 2070 6c61 7466 6f72 6d73 2069 6620 7379 platforms if sy │ │ │ │ -00008380: 7374 656d 2073 6f66 7477 6172 6520 7375 stem software su │ │ │ │ -00008390: 7070 6f72 7473 2069 743b 2066 6f72 0a65 pports it; for.e │ │ │ │ -000083a0: 7861 6d70 6c65 2c20 4752 5542 2061 6e64 xample, GRUB and │ │ │ │ -000083b0: 2047 4e55 2f4c 696e 7578 2063 616e 2062 GNU/Linux can b │ │ │ │ -000083c0: 6520 7573 6564 2069 6e20 7468 6973 2063 e used in this c │ │ │ │ -000083d0: 6f6e 6669 6775 7261 7469 6f6e 2e20 2057 onfiguration. W │ │ │ │ -000083e0: 6974 680a 7468 6973 2066 6f72 6d61 742c ith.this format, │ │ │ │ -000083f0: 2069 7420 6973 2070 6f73 7369 626c 6520 it is possible │ │ │ │ -00008400: 746f 2072 6573 6572 7665 2061 2077 686f to reserve a who │ │ │ │ -00008410: 6c65 2070 6172 7469 7469 6f6e 2066 6f72 le partition for │ │ │ │ -00008420: 2047 5255 422c 0a63 616c 6c65 6420 7468 GRUB,.called th │ │ │ │ -00008430: 6520 4249 4f53 2042 6f6f 7420 5061 7274 e BIOS Boot Part │ │ │ │ -00008440: 6974 696f 6e2e 2020 4752 5542 2063 616e ition. GRUB can │ │ │ │ -00008450: 2074 6865 6e20 6265 2065 6d62 6564 6465 then be embedde │ │ │ │ -00008460: 6420 696e 746f 2074 6861 740a 7061 7274 d into that.part │ │ │ │ -00008470: 6974 696f 6e20 7769 7468 6f75 7420 7468 ition without th │ │ │ │ -00008480: 6520 7269 736b 206f 6620 6265 696e 6720 e risk of being │ │ │ │ -00008490: 6f76 6572 7772 6974 7465 6e20 6279 206f overwritten by o │ │ │ │ -000084a0: 7468 6572 2073 6f66 7477 6172 6520 616e ther software an │ │ │ │ -000084b0: 640a 7769 7468 6f75 7420 6265 696e 6720 d.without being │ │ │ │ -000084c0: 636f 6e74 6169 6e65 6420 696e 2061 2066 contained in a f │ │ │ │ -000084d0: 696c 6573 7973 7465 6d20 7768 6963 6820 ilesystem which │ │ │ │ -000084e0: 6d69 6768 7420 6d6f 7665 2069 7473 2062 might move its b │ │ │ │ -000084f0: 6c6f 636b 730a 6172 6f75 6e64 2e0a 0a20 locks.around... │ │ │ │ -00008500: 2020 5768 656e 2063 7265 6174 696e 6720 When creating │ │ │ │ -00008510: 6120 4249 4f53 2042 6f6f 7420 5061 7274 a BIOS Boot Part │ │ │ │ -00008520: 6974 696f 6e20 6f6e 2061 2047 5054 2073 ition on a GPT s │ │ │ │ -00008530: 7973 7465 6d2c 2079 6f75 2073 686f 756c ystem, you shoul │ │ │ │ -00008540: 6420 6d61 6b65 0a73 7572 6520 7468 6174 d make.sure that │ │ │ │ -00008550: 2069 7420 6973 2061 7420 6c65 6173 7420 it is at least │ │ │ │ -00008560: 3331 204b 6942 2069 6e20 7369 7a65 2e20 31 KiB in size. │ │ │ │ -00008570: 2028 4750 542d 666f 726d 6174 7465 6420 (GPT-formatted │ │ │ │ -00008580: 6469 736b 7320 6172 6520 6e6f 740a 7573 disks are not.us │ │ │ │ -00008590: 7561 6c6c 7920 7061 7274 6963 756c 6172 ually particular │ │ │ │ -000085a0: 6c79 2073 6d61 6c6c 2c20 736f 2077 6520 ly small, so we │ │ │ │ -000085b0: 7265 636f 6d6d 656e 6420 7468 6174 2079 recommend that y │ │ │ │ -000085c0: 6f75 206d 616b 6520 6974 206c 6172 6765 ou make it large │ │ │ │ -000085d0: 7220 7468 616e 0a74 6865 2062 6172 6520 r than.the bare │ │ │ │ -000085e0: 6d69 6e69 6d75 6d2c 2073 7563 6820 6173 minimum, such as │ │ │ │ -000085f0: 2031 204d 6942 2c20 746f 2061 6c6c 6f77 1 MiB, to allow │ │ │ │ -00008600: 2070 6c65 6e74 7920 6f66 2072 6f6f 6d20 plenty of room │ │ │ │ -00008610: 666f 7220 6772 6f77 7468 2e29 0a59 6f75 for growth.).You │ │ │ │ -00008620: 206d 7573 7420 616c 736f 206d 616b 6520 must also make │ │ │ │ -00008630: 7375 7265 2074 6861 7420 6974 2068 6173 sure that it has │ │ │ │ -00008640: 2074 6865 2070 726f 7065 7220 7061 7274 the proper part │ │ │ │ -00008650: 6974 696f 6e20 7479 7065 2e20 2055 7369 ition type. Usi │ │ │ │ -00008660: 6e67 0a47 4e55 2050 6172 7465 642c 2079 ng.GNU Parted, y │ │ │ │ -00008670: 6f75 2063 616e 2073 6574 2074 6869 7320 ou can set this │ │ │ │ -00008680: 7573 696e 6720 6120 636f 6d6d 616e 6420 using a command │ │ │ │ -00008690: 7375 6368 2061 7320 7468 6520 666f 6c6c such as the foll │ │ │ │ -000086a0: 6f77 696e 673a 0a0a 2020 2020 2023 2070 owing:.. # p │ │ │ │ -000086b0: 6172 7465 6420 2f64 6576 2f44 4953 4b20 arted /dev/DISK │ │ │ │ -000086c0: 7365 7420 5041 5254 4954 494f 4e2d 4e55 set PARTITION-NU │ │ │ │ -000086d0: 4d42 4552 2062 696f 735f 6772 7562 206f MBER bios_grub o │ │ │ │ -000086e0: 6e0a 0a20 2020 4966 2079 6f75 2061 7265 n.. If you are │ │ │ │ -000086f0: 2075 7369 6e67 2067 6469 736b 2c20 7365 using gdisk, se │ │ │ │ -00008700: 7420 7468 6520 7061 7274 6974 696f 6e20 t the partition │ │ │ │ -00008710: 7479 7065 2074 6f20 2730 7845 4630 3227 type to '0xEF02' │ │ │ │ -00008720: 2e20 2057 6974 680a 7061 7274 6974 696f . With.partitio │ │ │ │ -00008730: 6e69 6e67 2070 726f 6772 616d 7320 7468 ning programs th │ │ │ │ -00008740: 6174 2072 6571 7569 7265 2073 6574 7469 at require setti │ │ │ │ -00008750: 6e67 2074 6865 2047 5549 4420 6469 7265 ng the GUID dire │ │ │ │ -00008760: 6374 6c79 2c20 6974 2073 686f 756c 640a ctly, it should. │ │ │ │ -00008770: 6265 2027 3231 3638 3631 3438 2d36 3434 be '21686148-644 │ │ │ │ -00008780: 392d 3665 3666 2d37 3434 6536 3536 3536 9-6e6f-744e65656 │ │ │ │ -00008790: 3434 3534 3634 3927 2e0a 0a20 2020 2a43 4454649'... *C │ │ │ │ -000087a0: 6175 7469 6f6e 3a2a 2042 6520 7665 7279 aution:* Be very │ │ │ │ -000087b0: 2063 6172 6566 756c 2077 6869 6368 2070 careful which p │ │ │ │ -000087c0: 6172 7469 7469 6f6e 2079 6f75 2073 656c artition you sel │ │ │ │ -000087d0: 6563 7421 2020 5768 656e 2047 5255 420a ect! When GRUB. │ │ │ │ -000087e0: 6669 6e64 7320 6120 4249 4f53 2042 6f6f finds a BIOS Boo │ │ │ │ -000087f0: 7420 5061 7274 6974 696f 6e20 6475 7269 t Partition duri │ │ │ │ -00008800: 6e67 2069 6e73 7461 6c6c 6174 696f 6e2c ng installation, │ │ │ │ -00008810: 2069 7420 7769 6c6c 2061 7574 6f6d 6174 it will automat │ │ │ │ -00008820: 6963 616c 6c79 0a6f 7665 7277 7269 7465 ically.overwrite │ │ │ │ -00008830: 2070 6172 7420 6f66 2069 742e 2020 4d61 part of it. Ma │ │ │ │ -00008840: 6b65 2073 7572 6520 7468 6174 2074 6865 ke sure that the │ │ │ │ -00008850: 2070 6172 7469 7469 6f6e 2064 6f65 7320 partition does │ │ │ │ -00008860: 6e6f 7420 636f 6e74 6169 6e20 616e 790a not contain any. │ │ │ │ -00008870: 6f74 6865 7220 6461 7461 2e0a 0a1f 0a46 other data.....F │ │ │ │ -00008880: 696c 653a 2067 7275 622e 696e 666f 2c20 ile: grub.info, │ │ │ │ -00008890: 204e 6f64 653a 2042 6f6f 7469 6e67 2c20 Node: Booting, │ │ │ │ -000088a0: 204e 6578 743a 2043 6f6e 6669 6775 7261 Next: Configura │ │ │ │ -000088b0: 7469 6f6e 2c20 2050 7265 763a 2049 6e73 tion, Prev: Ins │ │ │ │ -000088c0: 7461 6c6c 6174 696f 6e2c 2020 5570 3a20 tallation, Up: │ │ │ │ -000088d0: 546f 700a 0a35 2042 6f6f 7469 6e67 0a2a Top..5 Booting.* │ │ │ │ -000088e0: 2a2a 2a2a 2a2a 2a2a 0a0a 4752 5542 2063 ********..GRUB c │ │ │ │ -000088f0: 616e 206c 6f61 6420 4d75 6c74 6962 6f6f an load Multiboo │ │ │ │ -00008900: 742d 636f 6d70 6c69 616e 7420 6b65 726e t-compliant kern │ │ │ │ -00008910: 656c 7320 696e 2061 2063 6f6e 7369 7374 els in a consist │ │ │ │ -00008920: 656e 7420 7761 792c 2062 7574 2066 6f72 ent way, but for │ │ │ │ -00008930: 0a73 6f6d 6520 6672 6565 206f 7065 7261 .some free opera │ │ │ │ -00008940: 7469 6e67 2073 7973 7465 6d73 2079 6f75 ting systems you │ │ │ │ -00008950: 206e 6565 6420 746f 2075 7365 2073 6f6d need to use som │ │ │ │ -00008960: 6520 4f53 2d73 7065 6369 6669 6320 6d61 e OS-specific ma │ │ │ │ -00008970: 6769 632e 0a0a 2a20 4d65 6e75 3a0a 0a2a gic...* Menu:..* │ │ │ │ -00008980: 2047 656e 6572 616c 2062 6f6f 7420 6d65 General boot me │ │ │ │ -00008990: 7468 6f64 733a 3a20 2020 2020 2020 2048 thods:: H │ │ │ │ -000089a0: 6f77 2074 6f20 626f 6f74 204f 5365 7320 ow to boot OSes │ │ │ │ -000089b0: 7769 7468 2047 5255 4220 6765 6e65 7261 with GRUB genera │ │ │ │ -000089c0: 6c6c 790a 2a20 4c6f 6f70 6261 636b 2062 lly.* Loopback b │ │ │ │ -000089d0: 6f6f 7469 6e67 3a3a 2020 2020 2020 2020 ooting:: │ │ │ │ -000089e0: 2020 2020 4e6f 7465 7320 6f6e 2062 6f6f Notes on boo │ │ │ │ -000089f0: 7469 6e67 2066 726f 6d20 6c6f 6f70 6261 ting from loopba │ │ │ │ -00008a00: 636b 730a 2a20 4f53 2d73 7065 6369 6669 cks.* OS-specifi │ │ │ │ -00008a10: 6320 6e6f 7465 733a 3a20 2020 2020 2020 c notes:: │ │ │ │ -00008a20: 2020 2020 4e6f 7465 7320 6f6e 2073 6f6d Notes on som │ │ │ │ -00008a30: 6520 6f70 6572 6174 696e 6720 7379 7374 e operating syst │ │ │ │ -00008a40: 656d 730a 0a1f 0a46 696c 653a 2067 7275 ems....File: gru │ │ │ │ -00008a50: 622e 696e 666f 2c20 204e 6f64 653a 2047 b.info, Node: G │ │ │ │ -00008a60: 656e 6572 616c 2062 6f6f 7420 6d65 7468 eneral boot meth │ │ │ │ -00008a70: 6f64 732c 2020 4e65 7874 3a20 4c6f 6f70 ods, Next: Loop │ │ │ │ -00008a80: 6261 636b 2062 6f6f 7469 6e67 2c20 2055 back booting, U │ │ │ │ -00008a90: 703a 2042 6f6f 7469 6e67 0a0a 352e 3120 p: Booting..5.1 │ │ │ │ -00008aa0: 486f 7720 746f 2062 6f6f 7420 6f70 6572 How to boot oper │ │ │ │ -00008ab0: 6174 696e 6720 7379 7374 656d 730a 3d3d ating systems.== │ │ │ │ -00008ac0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ -00008ad0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a ===============. │ │ │ │ -00008ae0: 0a47 5255 4220 6861 7320 7477 6f20 6469 .GRUB has two di │ │ │ │ -00008af0: 7374 696e 6374 2062 6f6f 7420 6d65 7468 stinct boot meth │ │ │ │ -00008b00: 6f64 732e 2020 4f6e 6520 6f66 2074 6865 ods. One of the │ │ │ │ -00008b10: 2074 776f 2069 7320 746f 206c 6f61 6420 two is to load │ │ │ │ -00008b20: 616e 0a6f 7065 7261 7469 6e67 2073 7973 an.operating sys │ │ │ │ -00008b30: 7465 6d20 6469 7265 6374 6c79 2c20 616e tem directly, an │ │ │ │ -00008b40: 6420 7468 6520 6f74 6865 7220 6973 2074 d the other is t │ │ │ │ -00008b50: 6f20 6368 6169 6e2d 6c6f 6164 2061 6e6f o chain-load ano │ │ │ │ -00008b60: 7468 6572 2062 6f6f 740a 6c6f 6164 6572 ther boot.loader │ │ │ │ -00008b70: 2077 6869 6368 2074 6865 6e20 7769 6c6c which then will │ │ │ │ -00008b80: 206c 6f61 6420 616e 206f 7065 7261 7469 load an operati │ │ │ │ -00008b90: 6e67 2073 7973 7465 6d20 6163 7475 616c ng system actual │ │ │ │ -00008ba0: 6c79 2e20 2047 656e 6572 616c 6c79 0a73 ly. Generally.s │ │ │ │ -00008bb0: 7065 616b 696e 672c 2074 6865 2066 6f72 peaking, the for │ │ │ │ -00008bc0: 6d65 7220 6973 206d 6f72 6520 6465 7369 mer is more desi │ │ │ │ -00008bd0: 7261 626c 652c 2062 6563 6175 7365 2079 rable, because y │ │ │ │ -00008be0: 6f75 2064 6f6e 2774 206e 6565 6420 746f ou don't need to │ │ │ │ -00008bf0: 0a69 6e73 7461 6c6c 206f 7220 6d61 696e .install or main │ │ │ │ -00008c00: 7461 696e 206f 7468 6572 2062 6f6f 7420 tain other boot │ │ │ │ -00008c10: 6c6f 6164 6572 7320 616e 6420 4752 5542 loaders and GRUB │ │ │ │ -00008c20: 2069 7320 666c 6578 6962 6c65 2065 6e6f is flexible eno │ │ │ │ -00008c30: 7567 6820 746f 0a6c 6f61 6420 616e 206f ugh to.load an o │ │ │ │ -00008c40: 7065 7261 7469 6e67 2073 7973 7465 6d20 perating system │ │ │ │ -00008c50: 6672 6f6d 2061 6e20 6172 6269 7472 6172 from an arbitrar │ │ │ │ -00008c60: 7920 6469 736b 2f70 6172 7469 7469 6f6e y disk/partition │ │ │ │ -00008c70: 2e20 2048 6f77 6576 6572 2c20 7468 650a . However, the. │ │ │ │ -00008c80: 6c61 7474 6572 2069 7320 736f 6d65 7469 latter is someti │ │ │ │ -00008c90: 6d65 7320 7265 7175 6972 6564 2c20 7369 mes required, si │ │ │ │ -00008ca0: 6e63 6520 4752 5542 2064 6f65 736e 2774 nce GRUB doesn't │ │ │ │ -00008cb0: 2073 7570 706f 7274 2061 6c6c 2074 6865 support all the │ │ │ │ -00008cc0: 0a65 7869 7374 696e 6720 6f70 6572 6174 .existing operat │ │ │ │ -00008cd0: 696e 6720 7379 7374 656d 7320 6e61 7469 ing systems nati │ │ │ │ -00008ce0: 7665 6c79 2e0a 0a2a 204d 656e 753a 0a0a vely...* Menu:.. │ │ │ │ -00008cf0: 2a20 4c6f 6164 696e 6720 616e 206f 7065 * Loading an ope │ │ │ │ -00008d00: 7261 7469 6e67 2073 7973 7465 6d20 6469 rating system di │ │ │ │ -00008d10: 7265 6374 6c79 3a3a 0a2a 2043 6861 696e rectly::.* Chain │ │ │ │ -00008d20: 2d6c 6f61 6469 6e67 3a3a 0a0a 1f0a 4669 -loading::....Fi │ │ │ │ -00008d30: 6c65 3a20 6772 7562 2e69 6e66 6f2c 2020 le: grub.info, │ │ │ │ -00008d40: 4e6f 6465 3a20 4c6f 6164 696e 6720 616e Node: Loading an │ │ │ │ -00008d50: 206f 7065 7261 7469 6e67 2073 7973 7465 operating syste │ │ │ │ -00008d60: 6d20 6469 7265 6374 6c79 2c20 204e 6578 m directly, Nex │ │ │ │ -00008d70: 743a 2043 6861 696e 2d6c 6f61 6469 6e67 t: Chain-loading │ │ │ │ -00008d80: 2c20 2055 703a 2047 656e 6572 616c 2062 , Up: General b │ │ │ │ -00008d90: 6f6f 7420 6d65 7468 6f64 730a 0a35 2e31 oot methods..5.1 │ │ │ │ -00008da0: 2e31 2048 6f77 2074 6f20 626f 6f74 2061 .1 How to boot a │ │ │ │ -00008db0: 6e20 4f53 2064 6972 6563 746c 7920 7769 n OS directly wi │ │ │ │ -00008dc0: 7468 2047 5255 420a 2d2d 2d2d 2d2d 2d2d th GRUB.-------- │ │ │ │ +00007470: 3d3d 3d3d 3d3d 3d3d 0a0a 4966 2074 6865 ========..If the │ │ │ │ +00007480: 2064 6576 6963 6520 6d61 7020 6669 6c65 device map file │ │ │ │ +00007490: 2065 7869 7374 732c 2074 6865 2047 5255 exists, the GRU │ │ │ │ +000074a0: 4220 7574 696c 6974 6965 7320 2827 6772 B utilities ('gr │ │ │ │ +000074b0: 7562 2d70 726f 6265 272c 2065 7463 2e29 ub-probe', etc.) │ │ │ │ +000074c0: 0a72 6561 6420 6974 2074 6f20 6d61 7020 .read it to map │ │ │ │ +000074d0: 4249 4f53 2064 7269 7665 7320 746f 204f BIOS drives to O │ │ │ │ +000074e0: 5320 6465 7669 6365 732e 2020 5468 6973 S devices. This │ │ │ │ +000074f0: 2066 696c 6520 636f 6e73 6973 7473 206f file consists o │ │ │ │ +00007500: 6620 6c69 6e65 730a 6c69 6b65 2074 6869 f lines.like thi │ │ │ │ +00007510: 733a 0a0a 2020 2020 2028 4445 5649 4345 s:.. (DEVICE │ │ │ │ +00007520: 2920 4649 4c45 0a0a 2020 2044 4556 4943 ) FILE.. DEVIC │ │ │ │ +00007530: 4520 6973 2061 2064 7269 7665 2073 7065 E is a drive spe │ │ │ │ +00007540: 6369 6669 6564 2069 6e20 7468 6520 4752 cified in the GR │ │ │ │ +00007550: 5542 2073 796e 7461 7820 282a 6e6f 7465 UB syntax (*note │ │ │ │ +00007560: 2044 6576 6963 650a 7379 6e74 6178 3a3a Device.syntax:: │ │ │ │ +00007570: 292c 2061 6e64 2046 494c 4520 6973 2061 ), and FILE is a │ │ │ │ +00007580: 6e20 4f53 2066 696c 652c 2077 6869 6368 n OS file, which │ │ │ │ +00007590: 2069 7320 6e6f 726d 616c 6c79 2061 2064 is normally a d │ │ │ │ +000075a0: 6576 6963 6520 6669 6c65 2e0a 0a20 2020 evice file... │ │ │ │ +000075b0: 4869 7374 6f72 6963 616c 6c79 2c20 7468 Historically, th │ │ │ │ +000075c0: 6520 6465 7669 6365 206d 6170 2066 696c e device map fil │ │ │ │ +000075d0: 6520 7761 7320 7573 6564 2062 6563 6175 e was used becau │ │ │ │ +000075e0: 7365 2047 5255 4220 6465 7669 6365 206e se GRUB device n │ │ │ │ +000075f0: 616d 6573 0a68 6164 2074 6f20 6265 2075 ames.had to be u │ │ │ │ +00007600: 7365 6420 696e 2074 6865 2063 6f6e 6669 sed in the confi │ │ │ │ +00007610: 6775 7261 7469 6f6e 2066 696c 652c 2061 guration file, a │ │ │ │ +00007620: 6e64 2074 6865 7920 7765 7265 2064 6572 nd they were der │ │ │ │ +00007630: 6976 6564 2066 726f 6d0a 4249 4f53 2064 ived from.BIOS d │ │ │ │ +00007640: 7269 7665 206e 756d 6265 7273 2e20 2054 rive numbers. T │ │ │ │ +00007650: 6865 206d 6170 2062 6574 7765 656e 2042 he map between B │ │ │ │ +00007660: 494f 5320 6472 6976 6573 2061 6e64 204f IOS drives and O │ │ │ │ +00007670: 5320 6465 7669 6365 7320 6361 6e6e 6f74 S devices cannot │ │ │ │ +00007680: 0a61 6c77 6179 7320 6265 2067 7565 7373 .always be guess │ │ │ │ +00007690: 6564 2063 6f72 7265 6374 6c79 3a20 666f ed correctly: fo │ │ │ │ +000076a0: 7220 6578 616d 706c 652c 2047 5255 4220 r example, GRUB │ │ │ │ +000076b0: 7769 6c6c 2067 6574 2074 6865 206f 7264 will get the ord │ │ │ │ +000076c0: 6572 2077 726f 6e67 0a69 6620 796f 7520 er wrong.if you │ │ │ │ +000076d0: 6578 6368 616e 6765 2074 6865 2062 6f6f exchange the boo │ │ │ │ +000076e0: 7420 7365 7175 656e 6365 2062 6574 7765 t sequence betwe │ │ │ │ +000076f0: 656e 2049 4445 2061 6e64 2053 4353 4920 en IDE and SCSI │ │ │ │ +00007700: 696e 2079 6f75 7220 4249 4f53 2e0a 0a20 in your BIOS... │ │ │ │ +00007710: 2020 556e 666f 7274 756e 6174 656c 792c Unfortunately, │ │ │ │ +00007720: 2065 7665 6e20 4f53 2064 6576 6963 6520 even OS device │ │ │ │ +00007730: 6e61 6d65 7320 6172 6520 6e6f 7420 616c names are not al │ │ │ │ +00007740: 7761 7973 2073 7461 626c 652e 2020 4d6f ways stable. Mo │ │ │ │ +00007750: 6465 726e 0a76 6572 7369 6f6e 7320 6f66 dern.versions of │ │ │ │ +00007760: 2074 6865 204c 696e 7578 206b 6572 6e65 the Linux kerne │ │ │ │ +00007770: 6c20 6d61 7920 7072 6f62 6520 6472 6976 l may probe driv │ │ │ │ +00007780: 6573 2069 6e20 6120 6469 6666 6572 656e es in a differen │ │ │ │ +00007790: 7420 6f72 6465 7220 6672 6f6d 0a62 6f6f t order from.boo │ │ │ │ +000077a0: 7420 746f 2062 6f6f 742c 2061 6e64 2074 t to boot, and t │ │ │ │ +000077b0: 6865 2070 7265 6669 7820 2827 2f64 6576 he prefix ('/dev │ │ │ │ +000077c0: 2f68 642a 2720 7665 7273 7573 2027 2f64 /hd*' versus '/d │ │ │ │ +000077d0: 6576 2f73 642a 2729 206d 6179 2063 6861 ev/sd*') may cha │ │ │ │ +000077e0: 6e67 650a 6465 7065 6e64 696e 6720 6f6e nge.depending on │ │ │ │ +000077f0: 2074 6865 2064 7269 7665 7220 7375 6273 the driver subs │ │ │ │ +00007800: 7973 7465 6d20 696e 2075 7365 2e20 2041 ystem in use. A │ │ │ │ +00007810: 7320 6120 7265 7375 6c74 2c20 7468 6520 s a result, the │ │ │ │ +00007820: 6465 7669 6365 206d 6170 0a66 696c 6520 device map.file │ │ │ │ +00007830: 7265 7175 6972 6564 2066 7265 7175 656e required frequen │ │ │ │ +00007840: 7420 6564 6974 696e 6720 6f6e 2073 6f6d t editing on som │ │ │ │ +00007850: 6520 7379 7374 656d 732e 0a0a 2020 2047 e systems... G │ │ │ │ +00007860: 5255 4220 6176 6f69 6473 2074 6869 7320 RUB avoids this │ │ │ │ +00007870: 7072 6f62 6c65 6d20 6e6f 7761 6461 7973 problem nowadays │ │ │ │ +00007880: 2062 7920 7573 696e 6720 5555 4944 7320 by using UUIDs │ │ │ │ +00007890: 6f72 2066 696c 6520 7379 7374 656d 0a6c or file system.l │ │ │ │ +000078a0: 6162 656c 7320 7768 656e 2067 656e 6572 abels when gener │ │ │ │ +000078b0: 6174 696e 6720 2767 7275 622e 6366 6727 ating 'grub.cfg' │ │ │ │ +000078c0: 2c20 616e 6420 7765 2061 6476 6973 6520 , and we advise │ │ │ │ +000078d0: 7468 6174 2079 6f75 2064 6f20 7468 6520 that you do the │ │ │ │ +000078e0: 7361 6d65 0a66 6f72 2061 6e79 2063 7573 same.for any cus │ │ │ │ +000078f0: 746f 6d20 6d65 6e75 2065 6e74 7269 6573 tom menu entries │ │ │ │ +00007900: 2079 6f75 2077 7269 7465 2e20 2049 6620 you write. If │ │ │ │ +00007910: 7468 6520 6465 7669 6365 206d 6170 2066 the device map f │ │ │ │ +00007920: 696c 6520 646f 6573 206e 6f74 0a65 7869 ile does not.exi │ │ │ │ +00007930: 7374 2c20 7468 656e 2074 6865 2047 5255 st, then the GRU │ │ │ │ +00007940: 4220 7574 696c 6974 6965 7320 7769 6c6c B utilities will │ │ │ │ +00007950: 2061 7373 756d 6520 6120 7465 6d70 6f72 assume a tempor │ │ │ │ +00007960: 6172 7920 6465 7669 6365 206d 6170 206f ary device map o │ │ │ │ +00007970: 6e20 7468 650a 666c 792e 2020 5468 6973 n the.fly. This │ │ │ │ +00007980: 2069 7320 6f66 7465 6e20 676f 6f64 2065 is often good e │ │ │ │ +00007990: 6e6f 7567 682c 2070 6172 7469 6375 6c61 nough, particula │ │ │ │ +000079a0: 726c 7920 696e 2074 6865 2063 6f6d 6d6f rly in the commo │ │ │ │ +000079b0: 6e20 6361 7365 206f 660a 7369 6e67 6c65 n case of.single │ │ │ │ +000079c0: 2d64 6973 6b20 7379 7374 656d 732e 0a0a -disk systems... │ │ │ │ +000079d0: 2020 2048 6f77 6576 6572 2c20 7468 6520 However, the │ │ │ │ +000079e0: 6465 7669 6365 206d 6170 2066 696c 6520 device map file │ │ │ │ +000079f0: 6973 206e 6f74 2065 6e74 6972 656c 7920 is not entirely │ │ │ │ +00007a00: 6f62 736f 6c65 7465 2079 6574 2c20 616e obsolete yet, an │ │ │ │ +00007a10: 6420 6974 2069 730a 7573 6564 2066 6f72 d it is.used for │ │ │ │ +00007a20: 206f 7665 7272 6964 696e 6720 7768 656e overriding when │ │ │ │ +00007a30: 2063 7572 7265 6e74 2065 6e76 6972 6f6e current environ │ │ │ │ +00007a40: 6d65 6e74 2069 7320 6469 6666 6572 656e ment is differen │ │ │ │ +00007a50: 7420 6672 6f6d 2074 6865 206f 6e65 0a6f t from the one.o │ │ │ │ +00007a60: 6e20 626f 6f74 2e20 204d 6f73 7420 636f n boot. Most co │ │ │ │ +00007a70: 6d6d 6f6e 2063 6173 6520 6973 2069 6620 mmon case is if │ │ │ │ +00007a80: 796f 7520 7573 6520 6120 7061 7274 6974 you use a partit │ │ │ │ +00007a90: 696f 6e20 6f72 206c 6f67 6963 616c 2076 ion or logical v │ │ │ │ +00007aa0: 6f6c 756d 650a 6173 2061 2064 6973 6b20 olume.as a disk │ │ │ │ +00007ab0: 666f 7220 7669 7274 7561 6c20 6d61 6368 for virtual mach │ │ │ │ +00007ac0: 696e 652e 2020 596f 7520 6361 6e20 7075 ine. You can pu │ │ │ │ +00007ad0: 7420 616e 7920 636f 6d6d 656e 7473 2069 t any comments i │ │ │ │ +00007ae0: 6e20 7468 6520 6669 6c65 2069 660a 6e65 n the file if.ne │ │ │ │ +00007af0: 6564 6564 2c20 6173 2074 6865 2047 5255 eded, as the GRU │ │ │ │ +00007b00: 4220 7574 696c 6974 6965 7320 6173 7375 B utilities assu │ │ │ │ +00007b10: 6d65 2074 6861 7420 6120 6c69 6e65 2069 me that a line i │ │ │ │ +00007b20: 7320 6a75 7374 2061 2063 6f6d 6d65 6e74 s just a comment │ │ │ │ +00007b30: 2069 660a 7468 6520 6669 7273 7420 6368 if.the first ch │ │ │ │ +00007b40: 6172 6163 7465 7220 6973 2027 2327 2e0a aracter is '#'.. │ │ │ │ +00007b50: 0a1f 0a46 696c 653a 2067 7275 622e 696e ...File: grub.in │ │ │ │ +00007b60: 666f 2c20 204e 6f64 653a 2042 494f 5320 fo, Node: BIOS │ │ │ │ +00007b70: 696e 7374 616c 6c61 7469 6f6e 2c20 2050 installation, P │ │ │ │ +00007b80: 7265 763a 2044 6576 6963 6520 6d61 702c rev: Device map, │ │ │ │ +00007b90: 2020 5570 3a20 496e 7374 616c 6c61 7469 Up: Installati │ │ │ │ +00007ba0: 6f6e 0a0a 342e 3420 4249 4f53 2069 6e73 on..4.4 BIOS ins │ │ │ │ +00007bb0: 7461 6c6c 6174 696f 6e0a 3d3d 3d3d 3d3d tallation.====== │ │ │ │ +00007bc0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a ===============. │ │ │ │ +00007bd0: 0a4d 4252 0a3d 3d3d 0a0a 5468 6520 7061 .MBR.===..The pa │ │ │ │ +00007be0: 7274 6974 696f 6e20 7461 626c 6520 666f rtition table fo │ │ │ │ +00007bf0: 726d 6174 2074 7261 6469 7469 6f6e 616c rmat traditional │ │ │ │ +00007c00: 6c79 2075 7365 6420 6f6e 2050 4320 4249 ly used on PC BI │ │ │ │ +00007c10: 4f53 2070 6c61 7466 6f72 6d73 2069 730a OS platforms is. │ │ │ │ +00007c20: 6361 6c6c 6564 2074 6865 204d 6173 7465 called the Maste │ │ │ │ +00007c30: 7220 426f 6f74 2052 6563 6f72 6420 284d r Boot Record (M │ │ │ │ +00007c40: 4252 2920 666f 726d 6174 3b20 7468 6973 BR) format; this │ │ │ │ +00007c50: 2069 7320 7468 6520 666f 726d 6174 2074 is the format t │ │ │ │ +00007c60: 6861 740a 616c 6c6f 7773 2075 7020 746f hat.allows up to │ │ │ │ +00007c70: 2066 6f75 7220 7072 696d 6172 7920 7061 four primary pa │ │ │ │ +00007c80: 7274 6974 696f 6e73 2061 6e64 2061 6464 rtitions and add │ │ │ │ +00007c90: 6974 696f 6e61 6c20 6c6f 6769 6361 6c20 itional logical │ │ │ │ +00007ca0: 7061 7274 6974 696f 6e73 2e0a 5769 7468 partitions..With │ │ │ │ +00007cb0: 2074 6869 7320 7061 7274 6974 696f 6e20 this partition │ │ │ │ +00007cc0: 7461 626c 6520 666f 726d 6174 2c20 7468 table format, th │ │ │ │ +00007cd0: 6572 6520 6172 6520 7477 6f20 7761 7973 ere are two ways │ │ │ │ +00007ce0: 2074 6f20 696e 7374 616c 6c20 4752 5542 to install GRUB │ │ │ │ +00007cf0: 3a20 6974 0a63 616e 2062 6520 656d 6265 : it.can be embe │ │ │ │ +00007d00: 6464 6564 2069 6e20 7468 6520 6172 6561 dded in the area │ │ │ │ +00007d10: 2062 6574 7765 656e 2074 6865 204d 4252 between the MBR │ │ │ │ +00007d20: 2061 6e64 2074 6865 2066 6972 7374 2070 and the first p │ │ │ │ +00007d30: 6172 7469 7469 6f6e 0a28 6361 6c6c 6564 artition.(called │ │ │ │ +00007d40: 2062 7920 7661 7269 6f75 7320 6e61 6d65 by various name │ │ │ │ +00007d50: 732c 2073 7563 6820 6173 2074 6865 2022 s, such as the " │ │ │ │ +00007d60: 626f 6f74 2074 7261 636b 222c 2022 4d42 boot track", "MB │ │ │ │ +00007d70: 5220 6761 7022 2c20 6f72 0a22 656d 6265 R gap", or."embe │ │ │ │ +00007d80: 6464 696e 6720 6172 6561 222c 2061 6e64 dding area", and │ │ │ │ +00007d90: 2077 6869 6368 2069 7320 7573 7561 6c6c which is usuall │ │ │ │ +00007da0: 7920 6174 206c 6561 7374 2033 3120 4b69 y at least 31 Ki │ │ │ │ +00007db0: 4229 2c20 6f72 2074 6865 2063 6f72 650a B), or the core. │ │ │ │ +00007dc0: 696d 6167 6520 6361 6e20 6265 2069 6e73 image can be ins │ │ │ │ +00007dd0: 7461 6c6c 6564 2069 6e20 6120 6669 6c65 talled in a file │ │ │ │ +00007de0: 2073 7973 7465 6d20 616e 6420 6120 6c69 system and a li │ │ │ │ +00007df0: 7374 206f 6620 7468 6520 626c 6f63 6b73 st of the blocks │ │ │ │ +00007e00: 2074 6861 740a 6d61 6b65 2069 7420 7570 that.make it up │ │ │ │ +00007e10: 2063 616e 2062 6520 7374 6f72 6564 2069 can be stored i │ │ │ │ +00007e20: 6e20 7468 6520 6669 7273 7420 7365 6374 n the first sect │ │ │ │ +00007e30: 6f72 206f 6620 7468 6174 2070 6172 7469 or of that parti │ │ │ │ +00007e40: 7469 6f6e 2e0a 0a20 2020 4561 6368 206f tion... Each o │ │ │ │ +00007e50: 6620 7468 6573 6520 6861 7320 6469 6666 f these has diff │ │ │ │ +00007e60: 6572 656e 7420 7072 6f62 6c65 6d73 2e20 erent problems. │ │ │ │ +00007e70: 2054 6865 7265 2069 7320 6e6f 2077 6179 There is no way │ │ │ │ +00007e80: 2074 6f20 7265 7365 7276 650a 7370 6163 to reserve.spac │ │ │ │ +00007e90: 6520 696e 2074 6865 2065 6d62 6564 6469 e in the embeddi │ │ │ │ +00007ea0: 6e67 2061 7265 6120 7769 7468 2063 6f6d ng area with com │ │ │ │ +00007eb0: 706c 6574 6520 7361 6665 7479 2c20 616e plete safety, an │ │ │ │ +00007ec0: 6420 736f 6d65 2070 726f 7072 6965 7461 d some proprieta │ │ │ │ +00007ed0: 7279 0a73 6f66 7477 6172 6520 6973 206b ry.software is k │ │ │ │ +00007ee0: 6e6f 776e 2074 6f20 7573 6520 6974 2074 nown to use it t │ │ │ │ +00007ef0: 6f20 6d61 6b65 2069 7420 6469 6666 6963 o make it diffic │ │ │ │ +00007f00: 756c 7420 666f 7220 7573 6572 7320 746f ult for users to │ │ │ │ +00007f10: 2077 6f72 6b0a 6172 6f75 6e64 206c 6963 work.around lic │ │ │ │ +00007f20: 656e 7369 6e67 2072 6573 7472 6963 7469 ensing restricti │ │ │ │ +00007f30: 6f6e 733b 2061 6e64 2073 7973 7465 6d73 ons; and systems │ │ │ │ +00007f40: 2061 7265 2073 6f6d 6574 696d 6573 2070 are sometimes p │ │ │ │ +00007f50: 6172 7469 7469 6f6e 6564 0a77 6974 686f artitioned.witho │ │ │ │ +00007f60: 7574 206c 6561 7669 6e67 2065 6e6f 7567 ut leaving enoug │ │ │ │ +00007f70: 6820 7370 6163 6520 6265 666f 7265 2074 h space before t │ │ │ │ +00007f80: 6865 2066 6972 7374 2070 6172 7469 7469 he first partiti │ │ │ │ +00007f90: 6f6e 2e20 204f 6e20 7468 6520 6f74 6865 on. On the othe │ │ │ │ +00007fa0: 720a 6861 6e64 2c20 696e 7374 616c 6c69 r.hand, installi │ │ │ │ +00007fb0: 6e67 2074 6f20 6120 6669 6c65 7379 7374 ng to a filesyst │ │ │ │ +00007fc0: 656d 206d 6561 6e73 2074 6861 7420 4752 em means that GR │ │ │ │ +00007fd0: 5542 2069 7320 7675 6c6e 6572 6162 6c65 UB is vulnerable │ │ │ │ +00007fe0: 2074 6f20 6974 730a 626c 6f63 6b73 2062 to its.blocks b │ │ │ │ +00007ff0: 6569 6e67 206d 6f76 6564 2061 726f 756e eing moved aroun │ │ │ │ +00008000: 6420 6279 2066 696c 6573 7973 7465 6d20 d by filesystem │ │ │ │ +00008010: 6665 6174 7572 6573 2073 7563 6820 6173 features such as │ │ │ │ +00008020: 2074 6169 6c20 7061 636b 696e 672c 0a6f tail packing,.o │ │ │ │ +00008030: 7220 6576 656e 2062 7920 6167 6772 6573 r even by aggres │ │ │ │ +00008040: 7369 7665 2066 7363 6b20 696d 706c 656d sive fsck implem │ │ │ │ +00008050: 656e 7461 7469 6f6e 732c 2073 6f20 7468 entations, so th │ │ │ │ +00008060: 6973 2061 7070 726f 6163 6820 6973 2071 is approach is q │ │ │ │ +00008070: 7569 7465 0a66 7261 6769 6c65 3b20 616e uite.fragile; an │ │ │ │ +00008080: 6420 7468 6973 2061 7070 726f 6163 6820 d this approach │ │ │ │ +00008090: 6361 6e20 6f6e 6c79 2062 6520 7573 6564 can only be used │ │ │ │ +000080a0: 2069 6620 7468 6520 272f 626f 6f74 2720 if the '/boot' │ │ │ │ +000080b0: 6669 6c65 7379 7374 656d 2069 730a 6f6e filesystem is.on │ │ │ │ +000080c0: 2074 6865 2073 616d 6520 6469 736b 2074 the same disk t │ │ │ │ +000080d0: 6861 7420 7468 6520 4249 4f53 2062 6f6f hat the BIOS boo │ │ │ │ +000080e0: 7473 2066 726f 6d2c 2073 6f20 7468 6174 ts from, so that │ │ │ │ +000080f0: 2047 5255 4220 646f 6573 206e 6f74 2068 GRUB does not h │ │ │ │ +00008100: 6176 6520 746f 0a72 656c 7920 6f6e 2067 ave to.rely on g │ │ │ │ +00008110: 7565 7373 696e 6720 4249 4f53 2064 7269 uessing BIOS dri │ │ │ │ +00008120: 7665 206e 756d 6265 7273 2e0a 0a20 2020 ve numbers... │ │ │ │ +00008130: 5468 6520 4752 5542 2064 6576 656c 6f70 The GRUB develop │ │ │ │ +00008140: 6d65 6e74 2074 6561 6d20 6765 6e65 7261 ment team genera │ │ │ │ +00008150: 6c6c 7920 7265 636f 6d6d 656e 6473 2065 lly recommends e │ │ │ │ +00008160: 6d62 6564 6469 6e67 2047 5255 4220 6265 mbedding GRUB be │ │ │ │ +00008170: 666f 7265 0a74 6865 2066 6972 7374 2070 fore.the first p │ │ │ │ +00008180: 6172 7469 7469 6f6e 2c20 756e 6c65 7373 artition, unless │ │ │ │ +00008190: 2079 6f75 2068 6176 6520 7370 6563 6961 you have specia │ │ │ │ +000081a0: 6c20 7265 7175 6972 656d 656e 7473 2e20 l requirements. │ │ │ │ +000081b0: 2059 6f75 206d 7573 740a 656e 7375 7265 You must.ensure │ │ │ │ +000081c0: 2074 6861 7420 7468 6520 6669 7273 7420 that the first │ │ │ │ +000081d0: 7061 7274 6974 696f 6e20 7374 6172 7473 partition starts │ │ │ │ +000081e0: 2061 7420 6c65 6173 7420 3331 204b 6942 at least 31 KiB │ │ │ │ +000081f0: 2028 3633 2073 6563 746f 7273 2920 6672 (63 sectors) fr │ │ │ │ +00008200: 6f6d 0a74 6865 2073 7461 7274 206f 6620 om.the start of │ │ │ │ +00008210: 7468 6520 6469 736b 3b20 6f6e 206d 6f64 the disk; on mod │ │ │ │ +00008220: 6572 6e20 6469 736b 732c 2069 7420 6973 ern disks, it is │ │ │ │ +00008230: 206f 6674 656e 2061 2070 6572 666f 726d often a perform │ │ │ │ +00008240: 616e 6365 0a61 6476 616e 7461 6765 2074 ance.advantage t │ │ │ │ +00008250: 6f20 616c 6967 6e20 7061 7274 6974 696f o align partitio │ │ │ │ +00008260: 6e73 206f 6e20 6c61 7267 6572 2062 6f75 ns on larger bou │ │ │ │ +00008270: 6e64 6172 6965 7320 616e 7977 6179 2c20 ndaries anyway, │ │ │ │ +00008280: 736f 2074 6865 2066 6972 7374 0a70 6172 so the first.par │ │ │ │ +00008290: 7469 7469 6f6e 206d 6967 6874 2073 7461 tition might sta │ │ │ │ +000082a0: 7274 2031 204d 6942 2066 726f 6d20 7468 rt 1 MiB from th │ │ │ │ +000082b0: 6520 7374 6172 7420 6f66 2074 6865 2064 e start of the d │ │ │ │ +000082c0: 6973 6b2e 0a0a 4750 540a 3d3d 3d0a 0a53 isk...GPT.===..S │ │ │ │ +000082d0: 6f6d 6520 6e65 7765 7220 7379 7374 656d ome newer system │ │ │ │ +000082e0: 7320 7573 6520 7468 6520 4755 4944 2050 s use the GUID P │ │ │ │ +000082f0: 6172 7469 7469 6f6e 2054 6162 6c65 2028 artition Table ( │ │ │ │ +00008300: 4750 5429 2066 6f72 6d61 742e 2020 5468 GPT) format. Th │ │ │ │ +00008310: 6973 2077 6173 0a73 7065 6369 6669 6564 is was.specified │ │ │ │ +00008320: 2061 7320 7061 7274 206f 6620 7468 6520 as part of the │ │ │ │ +00008330: 4578 7465 6e73 6962 6c65 2046 6972 6d77 Extensible Firmw │ │ │ │ +00008340: 6172 6520 496e 7465 7266 6163 6520 2845 are Interface (E │ │ │ │ +00008350: 4649 292c 2062 7574 2069 7420 6361 6e0a FI), but it can. │ │ │ │ +00008360: 616c 736f 2062 6520 7573 6564 206f 6e20 also be used on │ │ │ │ +00008370: 4249 4f53 2070 6c61 7466 6f72 6d73 2069 BIOS platforms i │ │ │ │ +00008380: 6620 7379 7374 656d 2073 6f66 7477 6172 f system softwar │ │ │ │ +00008390: 6520 7375 7070 6f72 7473 2069 743b 2066 e supports it; f │ │ │ │ +000083a0: 6f72 0a65 7861 6d70 6c65 2c20 4752 5542 or.example, GRUB │ │ │ │ +000083b0: 2061 6e64 2047 4e55 2f4c 696e 7578 2063 and GNU/Linux c │ │ │ │ +000083c0: 616e 2062 6520 7573 6564 2069 6e20 7468 an be used in th │ │ │ │ +000083d0: 6973 2063 6f6e 6669 6775 7261 7469 6f6e is configuration │ │ │ │ +000083e0: 2e20 2057 6974 680a 7468 6973 2066 6f72 . With.this for │ │ │ │ +000083f0: 6d61 742c 2069 7420 6973 2070 6f73 7369 mat, it is possi │ │ │ │ +00008400: 626c 6520 746f 2072 6573 6572 7665 2061 ble to reserve a │ │ │ │ +00008410: 2077 686f 6c65 2070 6172 7469 7469 6f6e whole partition │ │ │ │ +00008420: 2066 6f72 2047 5255 422c 0a63 616c 6c65 for GRUB,.calle │ │ │ │ +00008430: 6420 7468 6520 4249 4f53 2042 6f6f 7420 d the BIOS Boot │ │ │ │ +00008440: 5061 7274 6974 696f 6e2e 2020 4752 5542 Partition. GRUB │ │ │ │ +00008450: 2063 616e 2074 6865 6e20 6265 2065 6d62 can then be emb │ │ │ │ +00008460: 6564 6465 6420 696e 746f 2074 6861 740a edded into that. │ │ │ │ +00008470: 7061 7274 6974 696f 6e20 7769 7468 6f75 partition withou │ │ │ │ +00008480: 7420 7468 6520 7269 736b 206f 6620 6265 t the risk of be │ │ │ │ +00008490: 696e 6720 6f76 6572 7772 6974 7465 6e20 ing overwritten │ │ │ │ +000084a0: 6279 206f 7468 6572 2073 6f66 7477 6172 by other softwar │ │ │ │ +000084b0: 6520 616e 640a 7769 7468 6f75 7420 6265 e and.without be │ │ │ │ +000084c0: 696e 6720 636f 6e74 6169 6e65 6420 696e ing contained in │ │ │ │ +000084d0: 2061 2066 696c 6573 7973 7465 6d20 7768 a filesystem wh │ │ │ │ +000084e0: 6963 6820 6d69 6768 7420 6d6f 7665 2069 ich might move i │ │ │ │ +000084f0: 7473 2062 6c6f 636b 730a 6172 6f75 6e64 ts blocks.around │ │ │ │ +00008500: 2e0a 0a20 2020 5768 656e 2063 7265 6174 ... When creat │ │ │ │ +00008510: 696e 6720 6120 4249 4f53 2042 6f6f 7420 ing a BIOS Boot │ │ │ │ +00008520: 5061 7274 6974 696f 6e20 6f6e 2061 2047 Partition on a G │ │ │ │ +00008530: 5054 2073 7973 7465 6d2c 2079 6f75 2073 PT system, you s │ │ │ │ +00008540: 686f 756c 6420 6d61 6b65 0a73 7572 6520 hould make.sure │ │ │ │ +00008550: 7468 6174 2069 7420 6973 2061 7420 6c65 that it is at le │ │ │ │ +00008560: 6173 7420 3331 204b 6942 2069 6e20 7369 ast 31 KiB in si │ │ │ │ +00008570: 7a65 2e20 2028 4750 542d 666f 726d 6174 ze. (GPT-format │ │ │ │ +00008580: 7465 6420 6469 736b 7320 6172 6520 6e6f ted disks are no │ │ │ │ +00008590: 740a 7573 7561 6c6c 7920 7061 7274 6963 t.usually partic │ │ │ │ +000085a0: 756c 6172 6c79 2073 6d61 6c6c 2c20 736f ularly small, so │ │ │ │ +000085b0: 2077 6520 7265 636f 6d6d 656e 6420 7468 we recommend th │ │ │ │ +000085c0: 6174 2079 6f75 206d 616b 6520 6974 206c at you make it l │ │ │ │ +000085d0: 6172 6765 7220 7468 616e 0a74 6865 2062 arger than.the b │ │ │ │ +000085e0: 6172 6520 6d69 6e69 6d75 6d2c 2073 7563 are minimum, suc │ │ │ │ +000085f0: 6820 6173 2031 204d 6942 2c20 746f 2061 h as 1 MiB, to a │ │ │ │ +00008600: 6c6c 6f77 2070 6c65 6e74 7920 6f66 2072 llow plenty of r │ │ │ │ +00008610: 6f6f 6d20 666f 7220 6772 6f77 7468 2e29 oom for growth.) │ │ │ │ +00008620: 0a59 6f75 206d 7573 7420 616c 736f 206d .You must also m │ │ │ │ +00008630: 616b 6520 7375 7265 2074 6861 7420 6974 ake sure that it │ │ │ │ +00008640: 2068 6173 2074 6865 2070 726f 7065 7220 has the proper │ │ │ │ +00008650: 7061 7274 6974 696f 6e20 7479 7065 2e20 partition type. │ │ │ │ +00008660: 2055 7369 6e67 0a47 4e55 2050 6172 7465 Using.GNU Parte │ │ │ │ +00008670: 642c 2079 6f75 2063 616e 2073 6574 2074 d, you can set t │ │ │ │ +00008680: 6869 7320 7573 696e 6720 6120 636f 6d6d his using a comm │ │ │ │ +00008690: 616e 6420 7375 6368 2061 7320 7468 6520 and such as the │ │ │ │ +000086a0: 666f 6c6c 6f77 696e 673a 0a0a 2020 2020 following:.. │ │ │ │ +000086b0: 2023 2070 6172 7465 6420 2f64 6576 2f44 # parted /dev/D │ │ │ │ +000086c0: 4953 4b20 7365 7420 5041 5254 4954 494f ISK set PARTITIO │ │ │ │ +000086d0: 4e2d 4e55 4d42 4552 2062 696f 735f 6772 N-NUMBER bios_gr │ │ │ │ +000086e0: 7562 206f 6e0a 0a20 2020 4966 2079 6f75 ub on.. If you │ │ │ │ +000086f0: 2061 7265 2075 7369 6e67 2067 6469 736b are using gdisk │ │ │ │ +00008700: 2c20 7365 7420 7468 6520 7061 7274 6974 , set the partit │ │ │ │ +00008710: 696f 6e20 7479 7065 2074 6f20 2730 7845 ion type to '0xE │ │ │ │ +00008720: 4630 3227 2e20 2057 6974 680a 7061 7274 F02'. With.part │ │ │ │ +00008730: 6974 696f 6e69 6e67 2070 726f 6772 616d itioning program │ │ │ │ +00008740: 7320 7468 6174 2072 6571 7569 7265 2073 s that require s │ │ │ │ +00008750: 6574 7469 6e67 2074 6865 2047 5549 4420 etting the GUID │ │ │ │ +00008760: 6469 7265 6374 6c79 2c20 6974 2073 686f directly, it sho │ │ │ │ +00008770: 756c 640a 6265 2027 3231 3638 3631 3438 uld.be '21686148 │ │ │ │ +00008780: 2d36 3434 392d 3665 3666 2d37 3434 6536 -6449-6e6f-744e6 │ │ │ │ +00008790: 3536 3536 3434 3534 3634 3927 2e0a 0a20 56564454649'... │ │ │ │ +000087a0: 2020 2a43 6175 7469 6f6e 3a2a 2042 6520 *Caution:* Be │ │ │ │ +000087b0: 7665 7279 2063 6172 6566 756c 2077 6869 very careful whi │ │ │ │ +000087c0: 6368 2070 6172 7469 7469 6f6e 2079 6f75 ch partition you │ │ │ │ +000087d0: 2073 656c 6563 7421 2020 5768 656e 2047 select! When G │ │ │ │ +000087e0: 5255 420a 6669 6e64 7320 6120 4249 4f53 RUB.finds a BIOS │ │ │ │ +000087f0: 2042 6f6f 7420 5061 7274 6974 696f 6e20 Boot Partition │ │ │ │ +00008800: 6475 7269 6e67 2069 6e73 7461 6c6c 6174 during installat │ │ │ │ +00008810: 696f 6e2c 2069 7420 7769 6c6c 2061 7574 ion, it will aut │ │ │ │ +00008820: 6f6d 6174 6963 616c 6c79 0a6f 7665 7277 omatically.overw │ │ │ │ +00008830: 7269 7465 2070 6172 7420 6f66 2069 742e rite part of it. │ │ │ │ +00008840: 2020 4d61 6b65 2073 7572 6520 7468 6174 Make sure that │ │ │ │ +00008850: 2074 6865 2070 6172 7469 7469 6f6e 2064 the partition d │ │ │ │ +00008860: 6f65 7320 6e6f 7420 636f 6e74 6169 6e20 oes not contain │ │ │ │ +00008870: 616e 790a 6f74 6865 7220 6461 7461 2e0a any.other data.. │ │ │ │ +00008880: 0a1f 0a46 696c 653a 2067 7275 622e 696e ...File: grub.in │ │ │ │ +00008890: 666f 2c20 204e 6f64 653a 2042 6f6f 7469 fo, Node: Booti │ │ │ │ +000088a0: 6e67 2c20 204e 6578 743a 2043 6f6e 6669 ng, Next: Confi │ │ │ │ +000088b0: 6775 7261 7469 6f6e 2c20 2050 7265 763a guration, Prev: │ │ │ │ +000088c0: 2049 6e73 7461 6c6c 6174 696f 6e2c 2020 Installation, │ │ │ │ +000088d0: 5570 3a20 546f 700a 0a35 2042 6f6f 7469 Up: Top..5 Booti │ │ │ │ +000088e0: 6e67 0a2a 2a2a 2a2a 2a2a 2a2a 0a0a 4752 ng.*********..GR │ │ │ │ +000088f0: 5542 2063 616e 206c 6f61 6420 4d75 6c74 UB can load Mult │ │ │ │ +00008900: 6962 6f6f 742d 636f 6d70 6c69 616e 7420 iboot-compliant │ │ │ │ +00008910: 6b65 726e 656c 7320 696e 2061 2063 6f6e kernels in a con │ │ │ │ +00008920: 7369 7374 656e 7420 7761 792c 2062 7574 sistent way, but │ │ │ │ +00008930: 2066 6f72 0a73 6f6d 6520 6672 6565 206f for.some free o │ │ │ │ +00008940: 7065 7261 7469 6e67 2073 7973 7465 6d73 perating systems │ │ │ │ +00008950: 2079 6f75 206e 6565 6420 746f 2075 7365 you need to use │ │ │ │ +00008960: 2073 6f6d 6520 4f53 2d73 7065 6369 6669 some OS-specifi │ │ │ │ +00008970: 6320 6d61 6769 632e 0a0a 2a20 4d65 6e75 c magic...* Menu │ │ │ │ +00008980: 3a0a 0a2a 2047 656e 6572 616c 2062 6f6f :..* General boo │ │ │ │ +00008990: 7420 6d65 7468 6f64 733a 3a20 2020 2020 t methods:: │ │ │ │ +000089a0: 2020 2048 6f77 2074 6f20 626f 6f74 204f How to boot O │ │ │ │ +000089b0: 5365 7320 7769 7468 2047 5255 4220 6765 Ses with GRUB ge │ │ │ │ +000089c0: 6e65 7261 6c6c 790a 2a20 4c6f 6f70 6261 nerally.* Loopba │ │ │ │ +000089d0: 636b 2062 6f6f 7469 6e67 3a3a 2020 2020 ck booting:: │ │ │ │ +000089e0: 2020 2020 2020 2020 4e6f 7465 7320 6f6e Notes on │ │ │ │ +000089f0: 2062 6f6f 7469 6e67 2066 726f 6d20 6c6f booting from lo │ │ │ │ +00008a00: 6f70 6261 636b 730a 2a20 4f53 2d73 7065 opbacks.* OS-spe │ │ │ │ +00008a10: 6369 6669 6320 6e6f 7465 733a 3a20 2020 cific notes:: │ │ │ │ +00008a20: 2020 2020 2020 2020 4e6f 7465 7320 6f6e Notes on │ │ │ │ +00008a30: 2073 6f6d 6520 6f70 6572 6174 696e 6720 some operating │ │ │ │ +00008a40: 7379 7374 656d 730a 0a1f 0a46 696c 653a systems....File: │ │ │ │ +00008a50: 2067 7275 622e 696e 666f 2c20 204e 6f64 grub.info, Nod │ │ │ │ +00008a60: 653a 2047 656e 6572 616c 2062 6f6f 7420 e: General boot │ │ │ │ +00008a70: 6d65 7468 6f64 732c 2020 4e65 7874 3a20 methods, Next: │ │ │ │ +00008a80: 4c6f 6f70 6261 636b 2062 6f6f 7469 6e67 Loopback booting │ │ │ │ +00008a90: 2c20 2055 703a 2042 6f6f 7469 6e67 0a0a , Up: Booting.. │ │ │ │ +00008aa0: 352e 3120 486f 7720 746f 2062 6f6f 7420 5.1 How to boot │ │ │ │ +00008ab0: 6f70 6572 6174 696e 6720 7379 7374 656d operating system │ │ │ │ +00008ac0: 730a 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d s.============== │ │ │ │ +00008ad0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ +00008ae0: 3d3d 3d0a 0a47 5255 4220 6861 7320 7477 ===..GRUB has tw │ │ │ │ +00008af0: 6f20 6469 7374 696e 6374 2062 6f6f 7420 o distinct boot │ │ │ │ +00008b00: 6d65 7468 6f64 732e 2020 4f6e 6520 6f66 methods. One of │ │ │ │ +00008b10: 2074 6865 2074 776f 2069 7320 746f 206c the two is to l │ │ │ │ +00008b20: 6f61 6420 616e 0a6f 7065 7261 7469 6e67 oad an.operating │ │ │ │ +00008b30: 2073 7973 7465 6d20 6469 7265 6374 6c79 system directly │ │ │ │ +00008b40: 2c20 616e 6420 7468 6520 6f74 6865 7220 , and the other │ │ │ │ +00008b50: 6973 2074 6f20 6368 6169 6e2d 6c6f 6164 is to chain-load │ │ │ │ +00008b60: 2061 6e6f 7468 6572 2062 6f6f 740a 6c6f another boot.lo │ │ │ │ +00008b70: 6164 6572 2077 6869 6368 2074 6865 6e20 ader which then │ │ │ │ +00008b80: 7769 6c6c 206c 6f61 6420 616e 206f 7065 will load an ope │ │ │ │ +00008b90: 7261 7469 6e67 2073 7973 7465 6d20 6163 rating system ac │ │ │ │ +00008ba0: 7475 616c 6c79 2e20 2047 656e 6572 616c tually. General │ │ │ │ +00008bb0: 6c79 0a73 7065 616b 696e 672c 2074 6865 ly.speaking, the │ │ │ │ +00008bc0: 2066 6f72 6d65 7220 6973 206d 6f72 6520 former is more │ │ │ │ +00008bd0: 6465 7369 7261 626c 652c 2062 6563 6175 desirable, becau │ │ │ │ +00008be0: 7365 2079 6f75 2064 6f6e 2774 206e 6565 se you don't nee │ │ │ │ +00008bf0: 6420 746f 0a69 6e73 7461 6c6c 206f 7220 d to.install or │ │ │ │ +00008c00: 6d61 696e 7461 696e 206f 7468 6572 2062 maintain other b │ │ │ │ +00008c10: 6f6f 7420 6c6f 6164 6572 7320 616e 6420 oot loaders and │ │ │ │ +00008c20: 4752 5542 2069 7320 666c 6578 6962 6c65 GRUB is flexible │ │ │ │ +00008c30: 2065 6e6f 7567 6820 746f 0a6c 6f61 6420 enough to.load │ │ │ │ +00008c40: 616e 206f 7065 7261 7469 6e67 2073 7973 an operating sys │ │ │ │ +00008c50: 7465 6d20 6672 6f6d 2061 6e20 6172 6269 tem from an arbi │ │ │ │ +00008c60: 7472 6172 7920 6469 736b 2f70 6172 7469 trary disk/parti │ │ │ │ +00008c70: 7469 6f6e 2e20 2048 6f77 6576 6572 2c20 tion. However, │ │ │ │ +00008c80: 7468 650a 6c61 7474 6572 2069 7320 736f the.latter is so │ │ │ │ +00008c90: 6d65 7469 6d65 7320 7265 7175 6972 6564 metimes required │ │ │ │ +00008ca0: 2c20 7369 6e63 6520 4752 5542 2064 6f65 , since GRUB doe │ │ │ │ +00008cb0: 736e 2774 2073 7570 706f 7274 2061 6c6c sn't support all │ │ │ │ +00008cc0: 2074 6865 0a65 7869 7374 696e 6720 6f70 the.existing op │ │ │ │ +00008cd0: 6572 6174 696e 6720 7379 7374 656d 7320 erating systems │ │ │ │ +00008ce0: 6e61 7469 7665 6c79 2e0a 0a2a 204d 656e natively...* Men │ │ │ │ +00008cf0: 753a 0a0a 2a20 4c6f 6164 696e 6720 616e u:..* Loading an │ │ │ │ +00008d00: 206f 7065 7261 7469 6e67 2073 7973 7465 operating syste │ │ │ │ +00008d10: 6d20 6469 7265 6374 6c79 3a3a 0a2a 2043 m directly::.* C │ │ │ │ +00008d20: 6861 696e 2d6c 6f61 6469 6e67 3a3a 0a0a hain-loading::.. │ │ │ │ +00008d30: 1f0a 4669 6c65 3a20 6772 7562 2e69 6e66 ..File: grub.inf │ │ │ │ +00008d40: 6f2c 2020 4e6f 6465 3a20 4c6f 6164 696e o, Node: Loadin │ │ │ │ +00008d50: 6720 616e 206f 7065 7261 7469 6e67 2073 g an operating s │ │ │ │ +00008d60: 7973 7465 6d20 6469 7265 6374 6c79 2c20 ystem directly, │ │ │ │ +00008d70: 204e 6578 743a 2043 6861 696e 2d6c 6f61 Next: Chain-loa │ │ │ │ +00008d80: 6469 6e67 2c20 2055 703a 2047 656e 6572 ding, Up: Gener │ │ │ │ +00008d90: 616c 2062 6f6f 7420 6d65 7468 6f64 730a al boot methods. │ │ │ │ +00008da0: 0a35 2e31 2e31 2048 6f77 2074 6f20 626f .5.1.1 How to bo │ │ │ │ +00008db0: 6f74 2061 6e20 4f53 2064 6972 6563 746c ot an OS directl │ │ │ │ +00008dc0: 7920 7769 7468 2047 5255 420a 2d2d 2d2d y with GRUB.---- │ │ │ │ 00008dd0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ 00008de0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ -00008df0: 2d2d 0a0a 4d75 6c74 6962 6f6f 7420 282a --..Multiboot (* │ │ │ │ -00008e00: 6e6f 7465 204d 756c 7469 626f 6f74 2053 note Multiboot S │ │ │ │ -00008e10: 7065 6369 6669 6361 7469 6f6e 3a20 286d pecification: (m │ │ │ │ -00008e20: 756c 7469 626f 6f74 2954 6f70 2e29 2069 ultiboot)Top.) i │ │ │ │ -00008e30: 7320 7468 6520 6e61 7469 7665 0a66 6f72 s the native.for │ │ │ │ -00008e40: 6d61 7420 7375 7070 6f72 7465 6420 6279 mat supported by │ │ │ │ -00008e50: 2047 5255 422e 2046 6f72 2074 6865 2073 GRUB. For the s │ │ │ │ -00008e60: 616b 6520 6f66 2063 6f6e 7665 6e69 656e ake of convenien │ │ │ │ -00008e70: 6365 2c20 7468 6572 6520 6973 2061 6c73 ce, there is als │ │ │ │ -00008e80: 6f0a 7375 7070 6f72 7420 666f 7220 4c69 o.support for Li │ │ │ │ -00008e90: 6e75 782c 2046 7265 6542 5344 2c20 4e65 nux, FreeBSD, Ne │ │ │ │ -00008ea0: 7442 5344 2061 6e64 204f 7065 6e42 5344 tBSD and OpenBSD │ │ │ │ -00008eb0: 2e20 4966 2079 6f75 2077 616e 7420 746f . If you want to │ │ │ │ -00008ec0: 2062 6f6f 740a 6f74 6865 7220 6f70 6572 boot.other oper │ │ │ │ -00008ed0: 6174 696e 6720 7379 7374 656d 732c 2079 ating systems, y │ │ │ │ -00008ee0: 6f75 2077 696c 6c20 6861 7665 2074 6f20 ou will have to │ │ │ │ -00008ef0: 6368 6169 6e2d 6c6f 6164 2074 6865 6d20 chain-load them │ │ │ │ -00008f00: 282a 6e6f 7465 0a43 6861 696e 2d6c 6f61 (*note.Chain-loa │ │ │ │ -00008f10: 6469 6e67 3a3a 292e 0a0a 2020 2046 4958 ding::)... FIX │ │ │ │ -00008f20: 4d45 3a20 7468 6973 2073 6563 7469 6f6e ME: this section │ │ │ │ -00008f30: 2069 7320 696e 636f 6d70 6c65 7465 2e0a is incomplete.. │ │ │ │ -00008f40: 0a20 2031 2e20 5275 6e20 7468 6520 636f . 1. Run the co │ │ │ │ -00008f50: 6d6d 616e 6420 2762 6f6f 7427 2028 2a6e mmand 'boot' (*n │ │ │ │ -00008f60: 6f74 6520 626f 6f74 3a3a 292e 0a0a 2020 ote boot::)... │ │ │ │ -00008f70: 2048 6f77 6576 6572 2c20 444f 5320 616e However, DOS an │ │ │ │ -00008f80: 6420 5769 6e64 6f77 7320 6861 7665 2073 d Windows have s │ │ │ │ -00008f90: 6f6d 6520 6465 6669 6369 656e 6369 6573 ome deficiencies │ │ │ │ -00008fa0: 2c20 736f 2079 6f75 206d 6967 6874 2068 , so you might h │ │ │ │ -00008fb0: 6176 6520 746f 0a75 7365 206d 6f72 6520 ave to.use more │ │ │ │ -00008fc0: 636f 6d70 6c69 6361 7465 6420 696e 7374 complicated inst │ │ │ │ -00008fd0: 7275 6374 696f 6e73 2e20 202a 4e6f 7465 ructions. *Note │ │ │ │ -00008fe0: 2044 4f53 2f57 696e 646f 7773 3a3a 2c20 DOS/Windows::, │ │ │ │ -00008ff0: 666f 7220 6d6f 7265 0a69 6e66 6f72 6d61 for more.informa │ │ │ │ -00009000: 7469 6f6e 2e0a 0a1f 0a46 696c 653a 2067 tion.....File: g │ │ │ │ -00009010: 7275 622e 696e 666f 2c20 204e 6f64 653a rub.info, Node: │ │ │ │ -00009020: 2043 6861 696e 2d6c 6f61 6469 6e67 2c20 Chain-loading, │ │ │ │ -00009030: 2050 7265 763a 204c 6f61 6469 6e67 2061 Prev: Loading a │ │ │ │ -00009040: 6e20 6f70 6572 6174 696e 6720 7379 7374 n operating syst │ │ │ │ -00009050: 656d 2064 6972 6563 746c 792c 2020 5570 em directly, Up │ │ │ │ -00009060: 3a20 4765 6e65 7261 6c20 626f 6f74 206d : General boot m │ │ │ │ -00009070: 6574 686f 6473 0a0a 352e 312e 3220 4368 ethods..5.1.2 Ch │ │ │ │ -00009080: 6169 6e2d 6c6f 6164 696e 6720 616e 204f ain-loading an O │ │ │ │ -00009090: 530a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d S.-------------- │ │ │ │ -000090a0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a4f 7065 -----------..Ope │ │ │ │ -000090b0: 7261 7469 6e67 2073 7973 7465 6d73 2074 rating systems t │ │ │ │ -000090c0: 6861 7420 646f 206e 6f74 2073 7570 706f hat do not suppo │ │ │ │ -000090d0: 7274 204d 756c 7469 626f 6f74 2061 6e64 rt Multiboot and │ │ │ │ -000090e0: 2064 6f20 6e6f 7420 6861 7665 2073 7065 do not have spe │ │ │ │ -000090f0: 6369 6669 630a 7375 7070 6f72 7420 696e cific.support in │ │ │ │ -00009100: 2047 5255 4220 2873 7065 6369 6669 6320 GRUB (specific │ │ │ │ -00009110: 7375 7070 6f72 7420 6973 2061 7661 696c support is avail │ │ │ │ -00009120: 6162 6c65 2066 6f72 204c 696e 7578 2c20 able for Linux, │ │ │ │ -00009130: 4672 6565 4253 442c 0a4e 6574 4253 4420 FreeBSD,.NetBSD │ │ │ │ -00009140: 616e 6420 4f70 656e 4253 4429 206d 7573 and OpenBSD) mus │ │ │ │ -00009150: 7420 6265 2063 6861 696e 2d6c 6f61 6465 t be chain-loade │ │ │ │ -00009160: 642c 2077 6869 6368 2069 6e76 6f6c 7665 d, which involve │ │ │ │ -00009170: 7320 6c6f 6164 696e 6720 616e 6f74 6865 s loading anothe │ │ │ │ -00009180: 720a 626f 6f74 206c 6f61 6465 7220 616e r.boot loader an │ │ │ │ -00009190: 6420 6a75 6d70 696e 6720 746f 2069 7420 d jumping to it │ │ │ │ -000091a0: 696e 2072 6561 6c20 6d6f 6465 2e0a 0a20 in real mode... │ │ │ │ -000091b0: 2020 5468 6520 2763 6861 696e 6c6f 6164 The 'chainload │ │ │ │ -000091c0: 6572 2720 636f 6d6d 616e 6420 282a 6e6f er' command (*no │ │ │ │ -000091d0: 7465 2063 6861 696e 6c6f 6164 6572 3a3a te chainloader:: │ │ │ │ -000091e0: 2920 6973 2075 7365 6420 746f 2073 6574 ) is used to set │ │ │ │ -000091f0: 2074 6869 730a 7570 2e20 2049 7420 6973 this.up. It is │ │ │ │ -00009200: 206e 6f72 6d61 6c6c 7920 616c 736f 206e normally also n │ │ │ │ -00009210: 6563 6573 7361 7279 2074 6f20 6c6f 6164 ecessary to load │ │ │ │ -00009220: 2073 6f6d 6520 4752 5542 206d 6f64 756c some GRUB modul │ │ │ │ -00009230: 6573 2061 6e64 2073 6574 2074 6865 0a61 es and set the.a │ │ │ │ -00009240: 7070 726f 7072 6961 7465 2072 6f6f 7420 ppropriate root │ │ │ │ -00009250: 6465 7669 6365 2e20 2050 7574 7469 6e67 device. Putting │ │ │ │ -00009260: 2074 6869 7320 746f 6765 7468 6572 2c20 this together, │ │ │ │ -00009270: 7765 2067 6574 2073 6f6d 6574 6869 6e67 we get something │ │ │ │ -00009280: 206c 696b 650a 7468 6973 2c20 666f 7220 like.this, for │ │ │ │ -00009290: 6120 5769 6e64 6f77 7320 7379 7374 656d a Windows system │ │ │ │ -000092a0: 206f 6e20 7468 6520 6669 7273 7420 7061 on the first pa │ │ │ │ -000092b0: 7274 6974 696f 6e20 6f66 2074 6865 2066 rtition of the f │ │ │ │ -000092c0: 6972 7374 2068 6172 640a 6469 736b 3a0a irst hard.disk:. │ │ │ │ -000092d0: 0a6d 656e 7565 6e74 7279 2022 5769 6e64 .menuentry "Wind │ │ │ │ -000092e0: 6f77 7322 207b 0a09 696e 736d 6f64 2063 ows" {..insmod c │ │ │ │ -000092f0: 6861 696e 0a09 696e 736d 6f64 206e 7466 hain..insmod ntf │ │ │ │ -00009300: 730a 0973 6574 2072 6f6f 743d 2868 6430 s..set root=(hd0 │ │ │ │ -00009310: 2c31 290a 0963 6861 696e 6c6f 6164 6572 ,1)..chainloader │ │ │ │ -00009320: 202b 310a 7d0a 0a20 2020 4f6e 2073 7973 +1.}.. On sys │ │ │ │ -00009330: 7465 6d73 2077 6974 6820 6d75 6c74 6970 tems with multip │ │ │ │ -00009340: 6c65 2068 6172 6420 6469 736b 732c 2061 le hard disks, a │ │ │ │ -00009350: 6e20 6164 6469 7469 6f6e 616c 2077 6f72 n additional wor │ │ │ │ -00009360: 6b61 726f 756e 6420 6d61 7920 6265 0a72 karound may be.r │ │ │ │ -00009370: 6571 7569 7265 642e 2020 2a4e 6f74 6520 equired. *Note │ │ │ │ -00009380: 444f 532f 5769 6e64 6f77 733a 3a2e 0a0a DOS/Windows::... │ │ │ │ -00009390: 2020 2043 6861 696e 2d6c 6f61 6469 6e67 Chain-loading │ │ │ │ -000093a0: 2069 7320 6f6e 6c79 2073 7570 706f 7274 is only support │ │ │ │ -000093b0: 6564 206f 6e20 5043 2042 494f 5320 616e ed on PC BIOS an │ │ │ │ -000093c0: 6420 4546 4920 706c 6174 666f 726d 732e d EFI platforms. │ │ │ │ -000093d0: 0a0a 1f0a 4669 6c65 3a20 6772 7562 2e69 ....File: grub.i │ │ │ │ -000093e0: 6e66 6f2c 2020 4e6f 6465 3a20 4c6f 6f70 nfo, Node: Loop │ │ │ │ -000093f0: 6261 636b 2062 6f6f 7469 6e67 2c20 204e back booting, N │ │ │ │ -00009400: 6578 743a 204f 532d 7370 6563 6966 6963 ext: OS-specific │ │ │ │ -00009410: 206e 6f74 6573 2c20 2050 7265 763a 2047 notes, Prev: G │ │ │ │ -00009420: 656e 6572 616c 2062 6f6f 7420 6d65 7468 eneral boot meth │ │ │ │ -00009430: 6f64 732c 2020 5570 3a20 426f 6f74 696e ods, Up: Bootin │ │ │ │ -00009440: 670a 0a35 2e32 204c 6f6f 7062 6163 6b20 g..5.2 Loopback │ │ │ │ -00009450: 626f 6f74 696e 670a 3d3d 3d3d 3d3d 3d3d booting.======== │ │ │ │ -00009460: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a 4752 ============..GR │ │ │ │ -00009470: 5542 2069 7320 6162 6c65 2074 6f20 7265 UB is able to re │ │ │ │ -00009480: 6164 2066 726f 6d20 616e 2069 6d61 6765 ad from an image │ │ │ │ -00009490: 2028 6265 2069 7420 6f6e 6520 6f66 2043 (be it one of C │ │ │ │ -000094a0: 4420 6f72 2048 4444 2920 7374 6f72 6564 D or HDD) stored │ │ │ │ -000094b0: 206f 6e0a 616e 7920 6f66 2069 7473 2061 on.any of its a │ │ │ │ -000094c0: 6363 6573 7369 626c 6520 7374 6f72 6167 ccessible storag │ │ │ │ -000094d0: 6573 2028 7265 6665 7220 746f 202a 6e6f es (refer to *no │ │ │ │ -000094e0: 7465 206c 6f6f 7062 6163 6b3a 3a20 636f te loopback:: co │ │ │ │ -000094f0: 6d6d 616e 6429 2e0a 486f 7765 7665 7220 mmand)..However │ │ │ │ -00009500: 7468 6520 4f53 2069 7473 656c 6620 7368 the OS itself sh │ │ │ │ -00009510: 6f75 6c64 2062 6520 6162 6c65 2074 6f20 ould be able to │ │ │ │ -00009520: 6669 6e64 2069 7473 2072 6f6f 742e 2020 find its root. │ │ │ │ -00009530: 5468 6973 2075 7375 616c 6c79 0a69 6e76 This usually.inv │ │ │ │ -00009540: 6f6c 7665 7320 7275 6e6e 696e 6720 6120 olves running a │ │ │ │ -00009550: 7573 6572 7370 6163 6520 7072 6f67 7261 userspace progra │ │ │ │ -00009560: 6d20 7275 6e6e 696e 6720 6265 666f 7265 m running before │ │ │ │ -00009570: 2074 6865 2072 6561 6c20 726f 6f74 2069 the real root i │ │ │ │ -00009580: 730a 6469 7363 6f76 6572 6564 2e20 2054 s.discovered. T │ │ │ │ -00009590: 6869 7320 6973 2061 6368 6965 7665 6420 his is achieved │ │ │ │ -000095a0: 6279 2047 5255 4220 6c6f 6164 696e 6720 by GRUB loading │ │ │ │ -000095b0: 6120 7370 6563 6961 6c6c 7920 6d61 6465 a specially made │ │ │ │ -000095c0: 2073 6d61 6c6c 0a69 6d61 6765 2061 6e64 small.image and │ │ │ │ -000095d0: 2070 6173 7369 6e67 2069 7420 6173 2072 passing it as r │ │ │ │ -000095e0: 616d 6469 736b 2074 6f20 7468 6520 6b65 amdisk to the ke │ │ │ │ -000095f0: 726e 656c 2e20 2054 6869 7320 6973 2061 rnel. This is a │ │ │ │ -00009600: 6368 6965 7665 6420 6279 0a63 6f6d 6d61 chieved by.comma │ │ │ │ -00009610: 6e64 7320 276b 6672 6565 6273 645f 6d6f nds 'kfreebsd_mo │ │ │ │ -00009620: 6475 6c65 272c 2027 6b6e 6574 6273 645f dule', 'knetbsd_ │ │ │ │ -00009630: 6d6f 6475 6c65 5f65 6c66 272c 2027 6b6f module_elf', 'ko │ │ │ │ -00009640: 7065 6e62 7364 5f72 616d 6469 736b 272c penbsd_ramdisk', │ │ │ │ -00009650: 0a27 696e 6974 7264 2720 282a 6e6f 7465 .'initrd' (*note │ │ │ │ -00009660: 2069 6e69 7472 643a 3a29 2c20 2769 6e69 initrd::), 'ini │ │ │ │ -00009670: 7472 6431 3627 2028 2a6e 6f74 6520 696e trd16' (*note in │ │ │ │ -00009680: 6974 7264 3a3a 292c 0a27 6d75 6c74 6962 itrd::),.'multib │ │ │ │ -00009690: 6f6f 745f 6d6f 6475 6c65 272c 2027 6d75 oot_module', 'mu │ │ │ │ -000096a0: 6c74 6962 6f6f 7432 5f6d 6f64 756c 6527 ltiboot2_module' │ │ │ │ -000096b0: 206f 7220 2778 6e75 5f72 616d 6469 736b or 'xnu_ramdisk │ │ │ │ -000096c0: 2720 6465 7065 6e64 696e 6720 6f6e 0a74 ' depending on.t │ │ │ │ -000096d0: 6865 206c 6f61 6465 722e 2020 4e6f 7465 he loader. Note │ │ │ │ -000096e0: 2074 6861 7420 666f 7220 6b6e 6574 6273 that for knetbs │ │ │ │ -000096f0: 6420 7468 6520 696d 6167 6520 6d75 7374 d the image must │ │ │ │ -00009700: 2062 6520 7075 7420 696e 7369 6465 0a6d be put inside.m │ │ │ │ -00009710: 696e 6972 6f6f 742e 6b6d 6f64 2061 6e64 iniroot.kmod and │ │ │ │ -00009720: 2074 6865 2077 686f 6c65 206d 696e 6972 the whole minir │ │ │ │ -00009730: 6f6f 742e 6b6d 6f64 2068 6173 2074 6f20 oot.kmod has to │ │ │ │ -00009740: 6265 206c 6f61 6465 642e 2020 496e 206b be loaded. In k │ │ │ │ -00009750: 6f70 656e 6273 640a 7061 796c 6f61 6420 openbsd.payload │ │ │ │ -00009760: 7468 6973 2069 7320 6469 7361 626c 6564 this is disabled │ │ │ │ -00009770: 2062 7920 6465 6661 756c 742e 2020 4164 by default. Ad │ │ │ │ -00009780: 6974 696f 6e61 6c6c 7920 6265 6861 7669 itionally behavi │ │ │ │ -00009790: 6f75 7220 6f66 2069 6e69 7469 616c 0a72 our of initial.r │ │ │ │ -000097a0: 616d 6469 736b 2064 6570 656e 6473 206f amdisk depends o │ │ │ │ -000097b0: 6e20 636f 6d6d 616e 6420 6c69 6e65 206f n command line o │ │ │ │ -000097c0: 7074 696f 6e73 2e20 2053 6576 6572 616c ptions. Several │ │ │ │ -000097d0: 2064 6973 7472 6962 7574 6f72 7320 7072 distributors pr │ │ │ │ -000097e0: 6f76 6964 650a 7468 6520 696d 6167 6520 ovide.the image │ │ │ │ -000097f0: 666f 7220 7468 6973 2070 7572 706f 7365 for this purpose │ │ │ │ -00009800: 206f 7220 6974 2773 2069 6e74 6567 7261 or it's integra │ │ │ │ -00009810: 7465 6420 696e 2074 6865 6972 2073 7461 ted in their sta │ │ │ │ -00009820: 6e64 6172 6420 7261 6d64 6973 6b0a 616e ndard ramdisk.an │ │ │ │ -00009830: 6420 6163 7469 7661 7465 6420 6279 2073 d activated by s │ │ │ │ -00009840: 7065 6369 616c 206f 7074 696f 6e2e 2020 pecial option. │ │ │ │ -00009850: 436f 6e73 756c 7420 796f 7572 206b 6572 Consult your ker │ │ │ │ -00009860: 6e65 6c20 616e 6420 6469 7374 7269 6275 nel and distribu │ │ │ │ -00009870: 7469 6f6e 0a6d 616e 7561 6c20 666f 7220 tion.manual for │ │ │ │ -00009880: 6d6f 7265 2064 6574 6169 6c73 2e20 204f more details. O │ │ │ │ -00009890: 7468 6572 206c 6f61 6465 7273 206c 696b ther loaders lik │ │ │ │ -000098a0: 6520 6170 706c 656c 6f61 6465 722c 2063 e appleloader, c │ │ │ │ -000098b0: 6861 696e 6c6f 6164 6572 0a28 4249 4f53 hainloader.(BIOS │ │ │ │ -000098c0: 2c20 4546 492c 2063 6f72 6562 6f6f 7429 , EFI, coreboot) │ │ │ │ -000098d0: 2c20 6672 6565 646f 732c 206e 746c 6472 , freedos, ntldr │ │ │ │ -000098e0: 2061 6e64 2070 6c61 6e39 2070 726f 7669 and plan9 provi │ │ │ │ -000098f0: 6465 206e 6f20 706f 7373 6962 696c 6974 de no possibilit │ │ │ │ -00009900: 790a 6f66 206c 6f61 6469 6e67 2069 6e69 y.of loading ini │ │ │ │ -00009910: 7469 616c 2072 616d 6469 736b 2061 6e64 tial ramdisk and │ │ │ │ -00009920: 2061 7320 6661 7220 6173 2061 7574 686f as far as autho │ │ │ │ -00009930: 7220 6973 2061 7761 7265 2074 6865 2070 r is aware the p │ │ │ │ -00009940: 6179 6c6f 6164 7320 696e 0a71 7565 7374 ayloads in.quest │ │ │ │ -00009950: 696f 6e20 646f 6e27 7420 7375 7070 6f72 ion don't suppor │ │ │ │ -00009960: 7420 6569 7468 6572 2069 6e69 7469 616c t either initial │ │ │ │ -00009970: 2072 616d 6469 736b 206f 7220 6469 7363 ramdisk or disc │ │ │ │ -00009980: 6f76 6572 696e 6720 6c6f 6f70 6261 636b overing loopback │ │ │ │ -00009990: 0a62 6f6f 7420 696e 206f 7468 6572 2077 .boot in other w │ │ │ │ -000099a0: 6179 2061 6e64 2061 7320 7375 6368 206e ay and as such n │ │ │ │ -000099b0: 6f74 2062 6f6f 7461 626c 6520 7468 6973 ot bootable this │ │ │ │ -000099c0: 2077 6179 2e20 2050 6c65 6173 6520 636f way. Please co │ │ │ │ -000099d0: 6e73 6964 6572 0a61 6c74 6572 6e61 7469 nsider.alternati │ │ │ │ -000099e0: 7665 2062 6f6f 7420 6d65 7468 6f64 7320 ve boot methods │ │ │ │ -000099f0: 6c69 6b65 2063 6f70 7969 6e67 2061 6c6c like copying all │ │ │ │ -00009a00: 2066 696c 6573 2066 726f 6d20 7468 6520 files from the │ │ │ │ -00009a10: 696d 6167 6520 746f 2061 6374 7561 6c0a image to actual. │ │ │ │ -00009a20: 7061 7274 6974 696f 6e2e 2020 436f 6e73 partition. Cons │ │ │ │ -00009a30: 756c 7420 796f 7572 204f 5320 646f 6375 ult your OS docu │ │ │ │ -00009a40: 6d65 6e74 6174 696f 6e20 666f 7220 6d6f mentation for mo │ │ │ │ -00009a50: 7265 2064 6574 6169 6c73 0a0a 1f0a 4669 re details....Fi │ │ │ │ -00009a60: 6c65 3a20 6772 7562 2e69 6e66 6f2c 2020 le: grub.info, │ │ │ │ -00009a70: 4e6f 6465 3a20 4f53 2d73 7065 6369 6669 Node: OS-specifi │ │ │ │ -00009a80: 6320 6e6f 7465 732c 2020 5072 6576 3a20 c notes, Prev: │ │ │ │ -00009a90: 4c6f 6f70 6261 636b 2062 6f6f 7469 6e67 Loopback booting │ │ │ │ -00009aa0: 2c20 2055 703a 2042 6f6f 7469 6e67 0a0a , Up: Booting.. │ │ │ │ -00009ab0: 352e 3320 536f 6d65 2063 6176 6561 7473 5.3 Some caveats │ │ │ │ -00009ac0: 206f 6e20 4f53 2d73 7065 6369 6669 6320 on OS-specific │ │ │ │ -00009ad0: 6973 7375 6573 0a3d 3d3d 3d3d 3d3d 3d3d issues.========= │ │ │ │ +00008df0: 2d2d 2d2d 2d2d 0a0a 4d75 6c74 6962 6f6f ------..Multiboo │ │ │ │ +00008e00: 7420 282a 6e6f 7465 204d 756c 7469 626f t (*note Multibo │ │ │ │ +00008e10: 6f74 2053 7065 6369 6669 6361 7469 6f6e ot Specification │ │ │ │ +00008e20: 3a20 286d 756c 7469 626f 6f74 2954 6f70 : (multiboot)Top │ │ │ │ +00008e30: 2e29 2069 7320 7468 6520 6e61 7469 7665 .) is the native │ │ │ │ +00008e40: 0a66 6f72 6d61 7420 7375 7070 6f72 7465 .format supporte │ │ │ │ +00008e50: 6420 6279 2047 5255 422e 2046 6f72 2074 d by GRUB. For t │ │ │ │ +00008e60: 6865 2073 616b 6520 6f66 2063 6f6e 7665 he sake of conve │ │ │ │ +00008e70: 6e69 656e 6365 2c20 7468 6572 6520 6973 nience, there is │ │ │ │ +00008e80: 2061 6c73 6f0a 7375 7070 6f72 7420 666f also.support fo │ │ │ │ +00008e90: 7220 4c69 6e75 782c 2046 7265 6542 5344 r Linux, FreeBSD │ │ │ │ +00008ea0: 2c20 4e65 7442 5344 2061 6e64 204f 7065 , NetBSD and Ope │ │ │ │ +00008eb0: 6e42 5344 2e20 4966 2079 6f75 2077 616e nBSD. If you wan │ │ │ │ +00008ec0: 7420 746f 2062 6f6f 740a 6f74 6865 7220 t to boot.other │ │ │ │ +00008ed0: 6f70 6572 6174 696e 6720 7379 7374 656d operating system │ │ │ │ +00008ee0: 732c 2079 6f75 2077 696c 6c20 6861 7665 s, you will have │ │ │ │ +00008ef0: 2074 6f20 6368 6169 6e2d 6c6f 6164 2074 to chain-load t │ │ │ │ +00008f00: 6865 6d20 282a 6e6f 7465 0a43 6861 696e hem (*note.Chain │ │ │ │ +00008f10: 2d6c 6f61 6469 6e67 3a3a 292e 0a0a 2020 -loading::)... │ │ │ │ +00008f20: 2046 4958 4d45 3a20 7468 6973 2073 6563 FIXME: this sec │ │ │ │ +00008f30: 7469 6f6e 2069 7320 696e 636f 6d70 6c65 tion is incomple │ │ │ │ +00008f40: 7465 2e0a 0a20 2031 2e20 5275 6e20 7468 te... 1. Run th │ │ │ │ +00008f50: 6520 636f 6d6d 616e 6420 2762 6f6f 7427 e command 'boot' │ │ │ │ +00008f60: 2028 2a6e 6f74 6520 626f 6f74 3a3a 292e (*note boot::). │ │ │ │ +00008f70: 0a0a 2020 2048 6f77 6576 6572 2c20 444f .. However, DO │ │ │ │ +00008f80: 5320 616e 6420 5769 6e64 6f77 7320 6861 S and Windows ha │ │ │ │ +00008f90: 7665 2073 6f6d 6520 6465 6669 6369 656e ve some deficien │ │ │ │ +00008fa0: 6369 6573 2c20 736f 2079 6f75 206d 6967 cies, so you mig │ │ │ │ +00008fb0: 6874 2068 6176 6520 746f 0a75 7365 206d ht have to.use m │ │ │ │ +00008fc0: 6f72 6520 636f 6d70 6c69 6361 7465 6420 ore complicated │ │ │ │ +00008fd0: 696e 7374 7275 6374 696f 6e73 2e20 202a instructions. * │ │ │ │ +00008fe0: 4e6f 7465 2044 4f53 2f57 696e 646f 7773 Note DOS/Windows │ │ │ │ +00008ff0: 3a3a 2c20 666f 7220 6d6f 7265 0a69 6e66 ::, for more.inf │ │ │ │ +00009000: 6f72 6d61 7469 6f6e 2e0a 0a1f 0a46 696c ormation.....Fil │ │ │ │ +00009010: 653a 2067 7275 622e 696e 666f 2c20 204e e: grub.info, N │ │ │ │ +00009020: 6f64 653a 2043 6861 696e 2d6c 6f61 6469 ode: Chain-loadi │ │ │ │ +00009030: 6e67 2c20 2050 7265 763a 204c 6f61 6469 ng, Prev: Loadi │ │ │ │ +00009040: 6e67 2061 6e20 6f70 6572 6174 696e 6720 ng an operating │ │ │ │ +00009050: 7379 7374 656d 2064 6972 6563 746c 792c system directly, │ │ │ │ +00009060: 2020 5570 3a20 4765 6e65 7261 6c20 626f Up: General bo │ │ │ │ +00009070: 6f74 206d 6574 686f 6473 0a0a 352e 312e ot methods..5.1. │ │ │ │ +00009080: 3220 4368 6169 6e2d 6c6f 6164 696e 6720 2 Chain-loading │ │ │ │ +00009090: 616e 204f 530a 2d2d 2d2d 2d2d 2d2d 2d2d an OS.---------- │ │ │ │ +000090a0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a ---------------. │ │ │ │ +000090b0: 0a4f 7065 7261 7469 6e67 2073 7973 7465 .Operating syste │ │ │ │ +000090c0: 6d73 2074 6861 7420 646f 206e 6f74 2073 ms that do not s │ │ │ │ +000090d0: 7570 706f 7274 204d 756c 7469 626f 6f74 upport Multiboot │ │ │ │ +000090e0: 2061 6e64 2064 6f20 6e6f 7420 6861 7665 and do not have │ │ │ │ +000090f0: 2073 7065 6369 6669 630a 7375 7070 6f72 specific.suppor │ │ │ │ +00009100: 7420 696e 2047 5255 4220 2873 7065 6369 t in GRUB (speci │ │ │ │ +00009110: 6669 6320 7375 7070 6f72 7420 6973 2061 fic support is a │ │ │ │ +00009120: 7661 696c 6162 6c65 2066 6f72 204c 696e vailable for Lin │ │ │ │ +00009130: 7578 2c20 4672 6565 4253 442c 0a4e 6574 ux, FreeBSD,.Net │ │ │ │ +00009140: 4253 4420 616e 6420 4f70 656e 4253 4429 BSD and OpenBSD) │ │ │ │ +00009150: 206d 7573 7420 6265 2063 6861 696e 2d6c must be chain-l │ │ │ │ +00009160: 6f61 6465 642c 2077 6869 6368 2069 6e76 oaded, which inv │ │ │ │ +00009170: 6f6c 7665 7320 6c6f 6164 696e 6720 616e olves loading an │ │ │ │ +00009180: 6f74 6865 720a 626f 6f74 206c 6f61 6465 other.boot loade │ │ │ │ +00009190: 7220 616e 6420 6a75 6d70 696e 6720 746f r and jumping to │ │ │ │ +000091a0: 2069 7420 696e 2072 6561 6c20 6d6f 6465 it in real mode │ │ │ │ +000091b0: 2e0a 0a20 2020 5468 6520 2763 6861 696e ... The 'chain │ │ │ │ +000091c0: 6c6f 6164 6572 2720 636f 6d6d 616e 6420 loader' command │ │ │ │ +000091d0: 282a 6e6f 7465 2063 6861 696e 6c6f 6164 (*note chainload │ │ │ │ +000091e0: 6572 3a3a 2920 6973 2075 7365 6420 746f er::) is used to │ │ │ │ +000091f0: 2073 6574 2074 6869 730a 7570 2e20 2049 set this.up. I │ │ │ │ +00009200: 7420 6973 206e 6f72 6d61 6c6c 7920 616c t is normally al │ │ │ │ +00009210: 736f 206e 6563 6573 7361 7279 2074 6f20 so necessary to │ │ │ │ +00009220: 6c6f 6164 2073 6f6d 6520 4752 5542 206d load some GRUB m │ │ │ │ +00009230: 6f64 756c 6573 2061 6e64 2073 6574 2074 odules and set t │ │ │ │ +00009240: 6865 0a61 7070 726f 7072 6961 7465 2072 he.appropriate r │ │ │ │ +00009250: 6f6f 7420 6465 7669 6365 2e20 2050 7574 oot device. Put │ │ │ │ +00009260: 7469 6e67 2074 6869 7320 746f 6765 7468 ting this togeth │ │ │ │ +00009270: 6572 2c20 7765 2067 6574 2073 6f6d 6574 er, we get somet │ │ │ │ +00009280: 6869 6e67 206c 696b 650a 7468 6973 2c20 hing like.this, │ │ │ │ +00009290: 666f 7220 6120 5769 6e64 6f77 7320 7379 for a Windows sy │ │ │ │ +000092a0: 7374 656d 206f 6e20 7468 6520 6669 7273 stem on the firs │ │ │ │ +000092b0: 7420 7061 7274 6974 696f 6e20 6f66 2074 t partition of t │ │ │ │ +000092c0: 6865 2066 6972 7374 2068 6172 640a 6469 he first hard.di │ │ │ │ +000092d0: 736b 3a0a 0a6d 656e 7565 6e74 7279 2022 sk:..menuentry " │ │ │ │ +000092e0: 5769 6e64 6f77 7322 207b 0a09 696e 736d Windows" {..insm │ │ │ │ +000092f0: 6f64 2063 6861 696e 0a09 696e 736d 6f64 od chain..insmod │ │ │ │ +00009300: 206e 7466 730a 0973 6574 2072 6f6f 743d ntfs..set root= │ │ │ │ +00009310: 2868 6430 2c31 290a 0963 6861 696e 6c6f (hd0,1)..chainlo │ │ │ │ +00009320: 6164 6572 202b 310a 7d0a 0a20 2020 4f6e ader +1.}.. On │ │ │ │ +00009330: 2073 7973 7465 6d73 2077 6974 6820 6d75 systems with mu │ │ │ │ +00009340: 6c74 6970 6c65 2068 6172 6420 6469 736b ltiple hard disk │ │ │ │ +00009350: 732c 2061 6e20 6164 6469 7469 6f6e 616c s, an additional │ │ │ │ +00009360: 2077 6f72 6b61 726f 756e 6420 6d61 7920 workaround may │ │ │ │ +00009370: 6265 0a72 6571 7569 7265 642e 2020 2a4e be.required. *N │ │ │ │ +00009380: 6f74 6520 444f 532f 5769 6e64 6f77 733a ote DOS/Windows: │ │ │ │ +00009390: 3a2e 0a0a 2020 2043 6861 696e 2d6c 6f61 :... Chain-loa │ │ │ │ +000093a0: 6469 6e67 2069 7320 6f6e 6c79 2073 7570 ding is only sup │ │ │ │ +000093b0: 706f 7274 6564 206f 6e20 5043 2042 494f ported on PC BIO │ │ │ │ +000093c0: 5320 616e 6420 4546 4920 706c 6174 666f S and EFI platfo │ │ │ │ +000093d0: 726d 732e 0a0a 1f0a 4669 6c65 3a20 6772 rms.....File: gr │ │ │ │ +000093e0: 7562 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ub.info, Node: │ │ │ │ +000093f0: 4c6f 6f70 6261 636b 2062 6f6f 7469 6e67 Loopback booting │ │ │ │ +00009400: 2c20 204e 6578 743a 204f 532d 7370 6563 , Next: OS-spec │ │ │ │ +00009410: 6966 6963 206e 6f74 6573 2c20 2050 7265 ific notes, Pre │ │ │ │ +00009420: 763a 2047 656e 6572 616c 2062 6f6f 7420 v: General boot │ │ │ │ +00009430: 6d65 7468 6f64 732c 2020 5570 3a20 426f methods, Up: Bo │ │ │ │ +00009440: 6f74 696e 670a 0a35 2e32 204c 6f6f 7062 oting..5.2 Loopb │ │ │ │ +00009450: 6163 6b20 626f 6f74 696e 670a 3d3d 3d3d ack booting.==== │ │ │ │ +00009460: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ +00009470: 0a0a 4752 5542 2069 7320 6162 6c65 2074 ..GRUB is able t │ │ │ │ +00009480: 6f20 7265 6164 2066 726f 6d20 616e 2069 o read from an i │ │ │ │ +00009490: 6d61 6765 2028 6265 2069 7420 6f6e 6520 mage (be it one │ │ │ │ +000094a0: 6f66 2043 4420 6f72 2048 4444 2920 7374 of CD or HDD) st │ │ │ │ +000094b0: 6f72 6564 206f 6e0a 616e 7920 6f66 2069 ored on.any of i │ │ │ │ +000094c0: 7473 2061 6363 6573 7369 626c 6520 7374 ts accessible st │ │ │ │ +000094d0: 6f72 6167 6573 2028 7265 6665 7220 746f orages (refer to │ │ │ │ +000094e0: 202a 6e6f 7465 206c 6f6f 7062 6163 6b3a *note loopback: │ │ │ │ +000094f0: 3a20 636f 6d6d 616e 6429 2e0a 486f 7765 : command)..Howe │ │ │ │ +00009500: 7665 7220 7468 6520 4f53 2069 7473 656c ver the OS itsel │ │ │ │ +00009510: 6620 7368 6f75 6c64 2062 6520 6162 6c65 f should be able │ │ │ │ +00009520: 2074 6f20 6669 6e64 2069 7473 2072 6f6f to find its roo │ │ │ │ +00009530: 742e 2020 5468 6973 2075 7375 616c 6c79 t. This usually │ │ │ │ +00009540: 0a69 6e76 6f6c 7665 7320 7275 6e6e 696e .involves runnin │ │ │ │ +00009550: 6720 6120 7573 6572 7370 6163 6520 7072 g a userspace pr │ │ │ │ +00009560: 6f67 7261 6d20 7275 6e6e 696e 6720 6265 ogram running be │ │ │ │ +00009570: 666f 7265 2074 6865 2072 6561 6c20 726f fore the real ro │ │ │ │ +00009580: 6f74 2069 730a 6469 7363 6f76 6572 6564 ot is.discovered │ │ │ │ +00009590: 2e20 2054 6869 7320 6973 2061 6368 6965 . This is achie │ │ │ │ +000095a0: 7665 6420 6279 2047 5255 4220 6c6f 6164 ved by GRUB load │ │ │ │ +000095b0: 696e 6720 6120 7370 6563 6961 6c6c 7920 ing a specially │ │ │ │ +000095c0: 6d61 6465 2073 6d61 6c6c 0a69 6d61 6765 made small.image │ │ │ │ +000095d0: 2061 6e64 2070 6173 7369 6e67 2069 7420 and passing it │ │ │ │ +000095e0: 6173 2072 616d 6469 736b 2074 6f20 7468 as ramdisk to th │ │ │ │ +000095f0: 6520 6b65 726e 656c 2e20 2054 6869 7320 e kernel. This │ │ │ │ +00009600: 6973 2061 6368 6965 7665 6420 6279 0a63 is achieved by.c │ │ │ │ +00009610: 6f6d 6d61 6e64 7320 276b 6672 6565 6273 ommands 'kfreebs │ │ │ │ +00009620: 645f 6d6f 6475 6c65 272c 2027 6b6e 6574 d_module', 'knet │ │ │ │ +00009630: 6273 645f 6d6f 6475 6c65 5f65 6c66 272c bsd_module_elf', │ │ │ │ +00009640: 2027 6b6f 7065 6e62 7364 5f72 616d 6469 'kopenbsd_ramdi │ │ │ │ +00009650: 736b 272c 0a27 696e 6974 7264 2720 282a sk',.'initrd' (* │ │ │ │ +00009660: 6e6f 7465 2069 6e69 7472 643a 3a29 2c20 note initrd::), │ │ │ │ +00009670: 2769 6e69 7472 6431 3627 2028 2a6e 6f74 'initrd16' (*not │ │ │ │ +00009680: 6520 696e 6974 7264 3a3a 292c 0a27 6d75 e initrd::),.'mu │ │ │ │ +00009690: 6c74 6962 6f6f 745f 6d6f 6475 6c65 272c ltiboot_module', │ │ │ │ +000096a0: 2027 6d75 6c74 6962 6f6f 7432 5f6d 6f64 'multiboot2_mod │ │ │ │ +000096b0: 756c 6527 206f 7220 2778 6e75 5f72 616d ule' or 'xnu_ram │ │ │ │ +000096c0: 6469 736b 2720 6465 7065 6e64 696e 6720 disk' depending │ │ │ │ +000096d0: 6f6e 0a74 6865 206c 6f61 6465 722e 2020 on.the loader. │ │ │ │ +000096e0: 4e6f 7465 2074 6861 7420 666f 7220 6b6e Note that for kn │ │ │ │ +000096f0: 6574 6273 6420 7468 6520 696d 6167 6520 etbsd the image │ │ │ │ +00009700: 6d75 7374 2062 6520 7075 7420 696e 7369 must be put insi │ │ │ │ +00009710: 6465 0a6d 696e 6972 6f6f 742e 6b6d 6f64 de.miniroot.kmod │ │ │ │ +00009720: 2061 6e64 2074 6865 2077 686f 6c65 206d and the whole m │ │ │ │ +00009730: 696e 6972 6f6f 742e 6b6d 6f64 2068 6173 iniroot.kmod has │ │ │ │ +00009740: 2074 6f20 6265 206c 6f61 6465 642e 2020 to be loaded. │ │ │ │ +00009750: 496e 206b 6f70 656e 6273 640a 7061 796c In kopenbsd.payl │ │ │ │ +00009760: 6f61 6420 7468 6973 2069 7320 6469 7361 oad this is disa │ │ │ │ +00009770: 626c 6564 2062 7920 6465 6661 756c 742e bled by default. │ │ │ │ +00009780: 2020 4164 6974 696f 6e61 6c6c 7920 6265 Aditionally be │ │ │ │ +00009790: 6861 7669 6f75 7220 6f66 2069 6e69 7469 haviour of initi │ │ │ │ +000097a0: 616c 0a72 616d 6469 736b 2064 6570 656e al.ramdisk depen │ │ │ │ +000097b0: 6473 206f 6e20 636f 6d6d 616e 6420 6c69 ds on command li │ │ │ │ +000097c0: 6e65 206f 7074 696f 6e73 2e20 2053 6576 ne options. Sev │ │ │ │ +000097d0: 6572 616c 2064 6973 7472 6962 7574 6f72 eral distributor │ │ │ │ +000097e0: 7320 7072 6f76 6964 650a 7468 6520 696d s provide.the im │ │ │ │ +000097f0: 6167 6520 666f 7220 7468 6973 2070 7572 age for this pur │ │ │ │ +00009800: 706f 7365 206f 7220 6974 2773 2069 6e74 pose or it's int │ │ │ │ +00009810: 6567 7261 7465 6420 696e 2074 6865 6972 egrated in their │ │ │ │ +00009820: 2073 7461 6e64 6172 6420 7261 6d64 6973 standard ramdis │ │ │ │ +00009830: 6b0a 616e 6420 6163 7469 7661 7465 6420 k.and activated │ │ │ │ +00009840: 6279 2073 7065 6369 616c 206f 7074 696f by special optio │ │ │ │ +00009850: 6e2e 2020 436f 6e73 756c 7420 796f 7572 n. Consult your │ │ │ │ +00009860: 206b 6572 6e65 6c20 616e 6420 6469 7374 kernel and dist │ │ │ │ +00009870: 7269 6275 7469 6f6e 0a6d 616e 7561 6c20 ribution.manual │ │ │ │ +00009880: 666f 7220 6d6f 7265 2064 6574 6169 6c73 for more details │ │ │ │ +00009890: 2e20 204f 7468 6572 206c 6f61 6465 7273 . Other loaders │ │ │ │ +000098a0: 206c 696b 6520 6170 706c 656c 6f61 6465 like appleloade │ │ │ │ +000098b0: 722c 2063 6861 696e 6c6f 6164 6572 0a28 r, chainloader.( │ │ │ │ +000098c0: 4249 4f53 2c20 4546 492c 2063 6f72 6562 BIOS, EFI, coreb │ │ │ │ +000098d0: 6f6f 7429 2c20 6672 6565 646f 732c 206e oot), freedos, n │ │ │ │ +000098e0: 746c 6472 2061 6e64 2070 6c61 6e39 2070 tldr and plan9 p │ │ │ │ +000098f0: 726f 7669 6465 206e 6f20 706f 7373 6962 rovide no possib │ │ │ │ +00009900: 696c 6974 790a 6f66 206c 6f61 6469 6e67 ility.of loading │ │ │ │ +00009910: 2069 6e69 7469 616c 2072 616d 6469 736b initial ramdisk │ │ │ │ +00009920: 2061 6e64 2061 7320 6661 7220 6173 2061 and as far as a │ │ │ │ +00009930: 7574 686f 7220 6973 2061 7761 7265 2074 uthor is aware t │ │ │ │ +00009940: 6865 2070 6179 6c6f 6164 7320 696e 0a71 he payloads in.q │ │ │ │ +00009950: 7565 7374 696f 6e20 646f 6e27 7420 7375 uestion don't su │ │ │ │ +00009960: 7070 6f72 7420 6569 7468 6572 2069 6e69 pport either ini │ │ │ │ +00009970: 7469 616c 2072 616d 6469 736b 206f 7220 tial ramdisk or │ │ │ │ +00009980: 6469 7363 6f76 6572 696e 6720 6c6f 6f70 discovering loop │ │ │ │ +00009990: 6261 636b 0a62 6f6f 7420 696e 206f 7468 back.boot in oth │ │ │ │ +000099a0: 6572 2077 6179 2061 6e64 2061 7320 7375 er way and as su │ │ │ │ +000099b0: 6368 206e 6f74 2062 6f6f 7461 626c 6520 ch not bootable │ │ │ │ +000099c0: 7468 6973 2077 6179 2e20 2050 6c65 6173 this way. Pleas │ │ │ │ +000099d0: 6520 636f 6e73 6964 6572 0a61 6c74 6572 e consider.alter │ │ │ │ +000099e0: 6e61 7469 7665 2062 6f6f 7420 6d65 7468 native boot meth │ │ │ │ +000099f0: 6f64 7320 6c69 6b65 2063 6f70 7969 6e67 ods like copying │ │ │ │ +00009a00: 2061 6c6c 2066 696c 6573 2066 726f 6d20 all files from │ │ │ │ +00009a10: 7468 6520 696d 6167 6520 746f 2061 6374 the image to act │ │ │ │ +00009a20: 7561 6c0a 7061 7274 6974 696f 6e2e 2020 ual.partition. │ │ │ │ +00009a30: 436f 6e73 756c 7420 796f 7572 204f 5320 Consult your OS │ │ │ │ +00009a40: 646f 6375 6d65 6e74 6174 696f 6e20 666f documentation fo │ │ │ │ +00009a50: 7220 6d6f 7265 2064 6574 6169 6c73 0a0a r more details.. │ │ │ │ +00009a60: 1f0a 4669 6c65 3a20 6772 7562 2e69 6e66 ..File: grub.inf │ │ │ │ +00009a70: 6f2c 2020 4e6f 6465 3a20 4f53 2d73 7065 o, Node: OS-spe │ │ │ │ +00009a80: 6369 6669 6320 6e6f 7465 732c 2020 5072 cific notes, Pr │ │ │ │ +00009a90: 6576 3a20 4c6f 6f70 6261 636b 2062 6f6f ev: Loopback boo │ │ │ │ +00009aa0: 7469 6e67 2c20 2055 703a 2042 6f6f 7469 ting, Up: Booti │ │ │ │ +00009ab0: 6e67 0a0a 352e 3320 536f 6d65 2063 6176 ng..5.3 Some cav │ │ │ │ +00009ac0: 6561 7473 206f 6e20 4f53 2d73 7065 6369 eats on OS-speci │ │ │ │ +00009ad0: 6669 6320 6973 7375 6573 0a3d 3d3d 3d3d fic issues.===== │ │ │ │ 00009ae0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ -00009af0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a48 =============..H │ │ │ │ -00009b00: 6572 652c 2077 6520 6465 7363 7269 6265 ere, we describe │ │ │ │ -00009b10: 2073 6f6d 6520 6361 7665 6174 7320 6f6e some caveats on │ │ │ │ -00009b20: 2073 6576 6572 616c 206f 7065 7261 7469 several operati │ │ │ │ -00009b30: 6e67 2073 7973 7465 6d73 2e0a 0a2a 204d ng systems...* M │ │ │ │ -00009b40: 656e 753a 0a0a 2a20 474e 552f 4875 7264 enu:..* GNU/Hurd │ │ │ │ -00009b50: 3a3a 0a2a 2047 4e55 2f4c 696e 7578 3a3a ::.* GNU/Linux:: │ │ │ │ -00009b60: 0a2a 204e 6574 4253 443a 3a0a 2a20 444f .* NetBSD::.* DO │ │ │ │ -00009b70: 532f 5769 6e64 6f77 733a 3a0a 0a1f 0a46 S/Windows::....F │ │ │ │ -00009b80: 696c 653a 2067 7275 622e 696e 666f 2c20 ile: grub.info, │ │ │ │ -00009b90: 204e 6f64 653a 2047 4e55 2f48 7572 642c Node: GNU/Hurd, │ │ │ │ -00009ba0: 2020 4e65 7874 3a20 474e 552f 4c69 6e75 Next: GNU/Linu │ │ │ │ -00009bb0: 782c 2020 5570 3a20 4f53 2d73 7065 6369 x, Up: OS-speci │ │ │ │ -00009bc0: 6669 6320 6e6f 7465 730a 0a35 2e33 2e31 fic notes..5.3.1 │ │ │ │ -00009bd0: 2047 4e55 2f48 7572 640a 2d2d 2d2d 2d2d GNU/Hurd.------ │ │ │ │ -00009be0: 2d2d 2d2d 2d2d 2d2d 0a0a 5369 6e63 6520 --------..Since │ │ │ │ -00009bf0: 474e 552f 4875 7264 2069 7320 4d75 6c74 GNU/Hurd is Mult │ │ │ │ -00009c00: 6962 6f6f 742d 636f 6d70 6c69 616e 742c iboot-compliant, │ │ │ │ -00009c10: 2069 7420 6973 2065 6173 7920 746f 2062 it is easy to b │ │ │ │ -00009c20: 6f6f 7420 6974 3b20 7468 6572 6520 6973 oot it; there is │ │ │ │ -00009c30: 0a6e 6f74 6869 6e67 2073 7065 6369 616c .nothing special │ │ │ │ -00009c40: 2061 626f 7574 2069 742e 2020 4275 7420 about it. But │ │ │ │ -00009c50: 646f 206e 6f74 2066 6f72 6765 7420 7468 do not forget th │ │ │ │ -00009c60: 6174 2079 6f75 2068 6176 6520 746f 2073 at you have to s │ │ │ │ -00009c70: 7065 6369 6679 2061 0a72 6f6f 7420 7061 pecify a.root pa │ │ │ │ -00009c80: 7274 6974 696f 6e20 746f 2074 6865 206b rtition to the k │ │ │ │ -00009c90: 6572 6e65 6c2e 0a0a 2020 312e 2053 6574 ernel... 1. Set │ │ │ │ -00009ca0: 2047 5255 4227 7320 726f 6f74 2064 6576 GRUB's root dev │ │ │ │ -00009cb0: 6963 6520 746f 2074 6865 2073 616d 6520 ice to the same │ │ │ │ -00009cc0: 6472 6976 6520 6173 2047 4e55 2f48 7572 drive as GNU/Hur │ │ │ │ -00009cd0: 6427 732e 2020 5468 650a 2020 2020 2063 d's. The. c │ │ │ │ -00009ce0: 6f6d 6d61 6e64 2027 7365 6172 6368 202d ommand 'search - │ │ │ │ -00009cf0: 2d73 6574 3d72 6f6f 7420 2d2d 6669 6c65 -set=root --file │ │ │ │ -00009d00: 202f 626f 6f74 2f67 6e75 6d61 6368 2e67 /boot/gnumach.g │ │ │ │ -00009d10: 7a27 206f 7220 7369 6d69 6c61 7220 6d61 z' or similar ma │ │ │ │ -00009d20: 790a 2020 2020 2068 656c 7020 796f 7520 y. help you │ │ │ │ -00009d30: 282a 6e6f 7465 2073 6561 7263 683a 3a29 (*note search::) │ │ │ │ -00009d40: 2e0a 0a20 2032 2e20 4c6f 6164 2074 6865 ... 2. Load the │ │ │ │ -00009d50: 206b 6572 6e65 6c20 616e 6420 7468 6520 kernel and the │ │ │ │ -00009d60: 6d6f 6475 6c65 732c 206c 696b 6520 7468 modules, like th │ │ │ │ -00009d70: 6973 3a0a 0a20 2020 2020 2020 2020 2067 is:.. g │ │ │ │ -00009d80: 7275 623e 206d 756c 7469 626f 6f74 202f rub> multiboot / │ │ │ │ -00009d90: 626f 6f74 2f67 6e75 6d61 6368 2e67 7a20 boot/gnumach.gz │ │ │ │ -00009da0: 726f 6f74 3d64 6576 6963 653a 6864 3073 root=device:hd0s │ │ │ │ -00009db0: 310a 2020 2020 2020 2020 2020 6772 7562 1. grub │ │ │ │ -00009dc0: 3e20 6d6f 6475 6c65 2020 2f68 7572 642f > module /hurd/ │ │ │ │ -00009dd0: 6578 7432 6673 2e73 7461 7469 6320 6578 ext2fs.static ex │ │ │ │ -00009de0: 7432 6673 202d 2d72 6561 646f 6e6c 7920 t2fs --readonly │ │ │ │ -00009df0: 5c0a 2020 2020 2020 2020 2020 2020 2020 \. │ │ │ │ -00009e00: 2020 2020 2020 2020 2020 2020 2020 202d - │ │ │ │ -00009e10: 2d6d 756c 7469 626f 6f74 2d63 6f6d 6d61 -multiboot-comma │ │ │ │ -00009e20: 6e64 2d6c 696e 653d 2724 7b6b 6572 6e65 nd-line='${kerne │ │ │ │ -00009e30: 6c2d 636f 6d6d 616e 642d 6c69 6e65 7d27 l-command-line}' │ │ │ │ -00009e40: 205c 0a20 2020 2020 2020 2020 2020 2020 \. │ │ │ │ +00009af0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ +00009b00: 3d0a 0a48 6572 652c 2077 6520 6465 7363 =..Here, we desc │ │ │ │ +00009b10: 7269 6265 2073 6f6d 6520 6361 7665 6174 ribe some caveat │ │ │ │ +00009b20: 7320 6f6e 2073 6576 6572 616c 206f 7065 s on several ope │ │ │ │ +00009b30: 7261 7469 6e67 2073 7973 7465 6d73 2e0a rating systems.. │ │ │ │ +00009b40: 0a2a 204d 656e 753a 0a0a 2a20 474e 552f .* Menu:..* GNU/ │ │ │ │ +00009b50: 4875 7264 3a3a 0a2a 2047 4e55 2f4c 696e Hurd::.* GNU/Lin │ │ │ │ +00009b60: 7578 3a3a 0a2a 204e 6574 4253 443a 3a0a ux::.* NetBSD::. │ │ │ │ +00009b70: 2a20 444f 532f 5769 6e64 6f77 733a 3a0a * DOS/Windows::. │ │ │ │ +00009b80: 0a1f 0a46 696c 653a 2067 7275 622e 696e ...File: grub.in │ │ │ │ +00009b90: 666f 2c20 204e 6f64 653a 2047 4e55 2f48 fo, Node: GNU/H │ │ │ │ +00009ba0: 7572 642c 2020 4e65 7874 3a20 474e 552f urd, Next: GNU/ │ │ │ │ +00009bb0: 4c69 6e75 782c 2020 5570 3a20 4f53 2d73 Linux, Up: OS-s │ │ │ │ +00009bc0: 7065 6369 6669 6320 6e6f 7465 730a 0a35 pecific notes..5 │ │ │ │ +00009bd0: 2e33 2e31 2047 4e55 2f48 7572 640a 2d2d .3.1 GNU/Hurd.-- │ │ │ │ +00009be0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 5369 ------------..Si │ │ │ │ +00009bf0: 6e63 6520 474e 552f 4875 7264 2069 7320 nce GNU/Hurd is │ │ │ │ +00009c00: 4d75 6c74 6962 6f6f 742d 636f 6d70 6c69 Multiboot-compli │ │ │ │ +00009c10: 616e 742c 2069 7420 6973 2065 6173 7920 ant, it is easy │ │ │ │ +00009c20: 746f 2062 6f6f 7420 6974 3b20 7468 6572 to boot it; ther │ │ │ │ +00009c30: 6520 6973 0a6e 6f74 6869 6e67 2073 7065 e is.nothing spe │ │ │ │ +00009c40: 6369 616c 2061 626f 7574 2069 742e 2020 cial about it. │ │ │ │ +00009c50: 4275 7420 646f 206e 6f74 2066 6f72 6765 But do not forge │ │ │ │ +00009c60: 7420 7468 6174 2079 6f75 2068 6176 6520 t that you have │ │ │ │ +00009c70: 746f 2073 7065 6369 6679 2061 0a72 6f6f to specify a.roo │ │ │ │ +00009c80: 7420 7061 7274 6974 696f 6e20 746f 2074 t partition to t │ │ │ │ +00009c90: 6865 206b 6572 6e65 6c2e 0a0a 2020 312e he kernel... 1. │ │ │ │ +00009ca0: 2053 6574 2047 5255 4227 7320 726f 6f74 Set GRUB's root │ │ │ │ +00009cb0: 2064 6576 6963 6520 746f 2074 6865 2073 device to the s │ │ │ │ +00009cc0: 616d 6520 6472 6976 6520 6173 2047 4e55 ame drive as GNU │ │ │ │ +00009cd0: 2f48 7572 6427 732e 2020 5468 650a 2020 /Hurd's. The. │ │ │ │ +00009ce0: 2020 2063 6f6d 6d61 6e64 2027 7365 6172 command 'sear │ │ │ │ +00009cf0: 6368 202d 2d73 6574 3d72 6f6f 7420 2d2d ch --set=root -- │ │ │ │ +00009d00: 6669 6c65 202f 626f 6f74 2f67 6e75 6d61 file /boot/gnuma │ │ │ │ +00009d10: 6368 2e67 7a27 206f 7220 7369 6d69 6c61 ch.gz' or simila │ │ │ │ +00009d20: 7220 6d61 790a 2020 2020 2068 656c 7020 r may. help │ │ │ │ +00009d30: 796f 7520 282a 6e6f 7465 2073 6561 7263 you (*note searc │ │ │ │ +00009d40: 683a 3a29 2e0a 0a20 2032 2e20 4c6f 6164 h::)... 2. Load │ │ │ │ +00009d50: 2074 6865 206b 6572 6e65 6c20 616e 6420 the kernel and │ │ │ │ +00009d60: 7468 6520 6d6f 6475 6c65 732c 206c 696b the modules, lik │ │ │ │ +00009d70: 6520 7468 6973 3a0a 0a20 2020 2020 2020 e this:.. │ │ │ │ +00009d80: 2020 2067 7275 623e 206d 756c 7469 626f grub> multibo │ │ │ │ +00009d90: 6f74 202f 626f 6f74 2f67 6e75 6d61 6368 ot /boot/gnumach │ │ │ │ +00009da0: 2e67 7a20 726f 6f74 3d64 6576 6963 653a .gz root=device: │ │ │ │ +00009db0: 6864 3073 310a 2020 2020 2020 2020 2020 hd0s1. │ │ │ │ +00009dc0: 6772 7562 3e20 6d6f 6475 6c65 2020 2f68 grub> module /h │ │ │ │ +00009dd0: 7572 642f 6578 7432 6673 2e73 7461 7469 urd/ext2fs.stati │ │ │ │ +00009de0: 6320 6578 7432 6673 202d 2d72 6561 646f c ext2fs --reado │ │ │ │ +00009df0: 6e6c 7920 5c0a 2020 2020 2020 2020 2020 nly \. │ │ │ │ +00009e00: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00009e10: 2020 202d 2d6d 756c 7469 626f 6f74 2d63 --multiboot-c │ │ │ │ +00009e20: 6f6d 6d61 6e64 2d6c 696e 653d 2724 7b6b ommand-line='${k │ │ │ │ +00009e30: 6572 6e65 6c2d 636f 6d6d 616e 642d 6c69 ernel-command-li │ │ │ │ +00009e40: 6e65 7d27 205c 0a20 2020 2020 2020 2020 ne}' \. │ │ │ │ 00009e50: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00009e60: 2d2d 686f 7374 2d70 7269 762d 706f 7274 --host-priv-port │ │ │ │ -00009e70: 3d27 247b 686f 7374 2d70 6f72 747d 2720 ='${host-port}' │ │ │ │ -00009e80: 5c0a 2020 2020 2020 2020 2020 2020 2020 \. │ │ │ │ -00009e90: 2020 2020 2020 2020 2020 2020 2020 202d - │ │ │ │ -00009ea0: 2d64 6576 6963 652d 6d61 7374 6572 2d70 -device-master-p │ │ │ │ -00009eb0: 6f72 743d 2724 7b64 6576 6963 652d 706f ort='${device-po │ │ │ │ -00009ec0: 7274 7d27 205c 0a20 2020 2020 2020 2020 rt}' \. │ │ │ │ +00009e60: 2020 2020 2d2d 686f 7374 2d70 7269 762d --host-priv- │ │ │ │ +00009e70: 706f 7274 3d27 247b 686f 7374 2d70 6f72 port='${host-por │ │ │ │ +00009e80: 747d 2720 5c0a 2020 2020 2020 2020 2020 t}' \. │ │ │ │ +00009e90: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00009ea0: 2020 202d 2d64 6576 6963 652d 6d61 7374 --device-mast │ │ │ │ +00009eb0: 6572 2d70 6f72 743d 2724 7b64 6576 6963 er-port='${devic │ │ │ │ +00009ec0: 652d 706f 7274 7d27 205c 0a20 2020 2020 e-port}' \. │ │ │ │ 00009ed0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00009ee0: 2020 2020 2d2d 6578 6563 2d73 6572 7665 --exec-serve │ │ │ │ -00009ef0: 722d 7461 736b 3d27 247b 6578 6563 2d74 r-task='${exec-t │ │ │ │ -00009f00: 6173 6b7d 2720 2d54 2074 7970 6564 2027 ask}' -T typed ' │ │ │ │ -00009f10: 247b 726f 6f74 7d27 205c 0a20 2020 2020 ${root}' \. │ │ │ │ +00009ee0: 2020 2020 2020 2020 2d2d 6578 6563 2d73 --exec-s │ │ │ │ +00009ef0: 6572 7665 722d 7461 736b 3d27 247b 6578 erver-task='${ex │ │ │ │ +00009f00: 6563 2d74 6173 6b7d 2720 2d54 2074 7970 ec-task}' -T typ │ │ │ │ +00009f10: 6564 2027 247b 726f 6f74 7d27 205c 0a20 ed '${root}' \. │ │ │ │ 00009f20: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00009f30: 2020 2020 2020 2020 2724 2874 6173 6b2d '$(task- │ │ │ │ -00009f40: 6372 6561 7465 2927 2027 2428 7461 736b create)' '$(task │ │ │ │ -00009f50: 2d72 6573 756d 6529 270a 2020 2020 2020 -resume)'. │ │ │ │ -00009f60: 2020 2020 6772 7562 3e20 6d6f 6475 6c65 grub> module │ │ │ │ -00009f70: 202f 6c69 622f 6c64 2e73 6f2e 3120 6578 /lib/ld.so.1 ex │ │ │ │ -00009f80: 6563 202f 6875 7264 2f65 7865 6320 2724 ec /hurd/exec '$ │ │ │ │ -00009f90: 2865 7865 632d 7461 736b 3d74 6173 6b2d (exec-task=task- │ │ │ │ -00009fa0: 6372 6561 7465 2927 0a0a 2020 332e 2046 create)'.. 3. F │ │ │ │ -00009fb0: 696e 616c 6c79 2c20 7275 6e20 7468 6520 inally, run the │ │ │ │ -00009fc0: 636f 6d6d 616e 6420 2762 6f6f 7427 2028 command 'boot' ( │ │ │ │ -00009fd0: 2a6e 6f74 6520 626f 6f74 3a3a 292e 0a0a *note boot::)... │ │ │ │ -00009fe0: 1f0a 4669 6c65 3a20 6772 7562 2e69 6e66 ..File: grub.inf │ │ │ │ -00009ff0: 6f2c 2020 4e6f 6465 3a20 474e 552f 4c69 o, Node: GNU/Li │ │ │ │ -0000a000: 6e75 782c 2020 4e65 7874 3a20 4e65 7442 nux, Next: NetB │ │ │ │ -0000a010: 5344 2c20 2050 7265 763a 2047 4e55 2f48 SD, Prev: GNU/H │ │ │ │ -0000a020: 7572 642c 2020 5570 3a20 4f53 2d73 7065 urd, Up: OS-spe │ │ │ │ -0000a030: 6369 6669 6320 6e6f 7465 730a 0a35 2e33 cific notes..5.3 │ │ │ │ -0000a040: 2e32 2047 4e55 2f4c 696e 7578 0a2d 2d2d .2 GNU/Linux.--- │ │ │ │ -0000a050: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 4974 ------------..It │ │ │ │ -0000a060: 2069 7320 7265 6c61 7469 7665 6c79 2065 is relatively e │ │ │ │ -0000a070: 6173 7920 746f 2062 6f6f 7420 474e 552f asy to boot GNU/ │ │ │ │ -0000a080: 4c69 6e75 7820 6672 6f6d 2047 5255 422c Linux from GRUB, │ │ │ │ -0000a090: 2062 6563 6175 7365 2069 7420 736f 6d65 because it some │ │ │ │ -0000a0a0: 7768 6174 0a72 6573 656d 626c 6573 2074 what.resembles t │ │ │ │ -0000a0b0: 6f20 626f 6f74 2061 204d 756c 7469 626f o boot a Multibo │ │ │ │ -0000a0c0: 6f74 2d63 6f6d 706c 6961 6e74 204f 532e ot-compliant OS. │ │ │ │ -0000a0d0: 0a0a 2020 312e 2053 6574 2047 5255 4227 .. 1. Set GRUB' │ │ │ │ -0000a0e0: 7320 726f 6f74 2064 6576 6963 6520 746f s root device to │ │ │ │ -0000a0f0: 2074 6865 2073 616d 6520 6472 6976 6520 the same drive │ │ │ │ -0000a100: 6173 2047 4e55 2f4c 696e 7578 2773 2e20 as GNU/Linux's. │ │ │ │ -0000a110: 2054 6865 0a20 2020 2020 636f 6d6d 616e The. comman │ │ │ │ -0000a120: 6420 2773 6561 7263 6820 2d2d 7365 743d d 'search --set= │ │ │ │ -0000a130: 726f 6f74 202d 2d66 696c 6520 2f76 6d6c root --file /vml │ │ │ │ -0000a140: 696e 757a 2720 6f72 2073 696d 696c 6172 inuz' or similar │ │ │ │ -0000a150: 206d 6179 2068 656c 7020 796f 750a 2020 may help you. │ │ │ │ -0000a160: 2020 2028 2a6e 6f74 6520 7365 6172 6368 (*note search │ │ │ │ -0000a170: 3a3a 292e 0a0a 2020 322e 204c 6f61 6420 ::)... 2. Load │ │ │ │ -0000a180: 7468 6520 6b65 726e 656c 2075 7369 6e67 the kernel using │ │ │ │ -0000a190: 2074 6865 2063 6f6d 6d61 6e64 2027 6c69 the command 'li │ │ │ │ -0000a1a0: 6e75 7827 2028 2a6e 6f74 6520 6c69 6e75 nux' (*note linu │ │ │ │ -0000a1b0: 783a 3a29 3a0a 0a20 2020 2020 2020 2020 x::):.. │ │ │ │ -0000a1c0: 2067 7275 623e 206c 696e 7578 202f 766d grub> linux /vm │ │ │ │ -0000a1d0: 6c69 6e75 7a20 726f 6f74 3d2f 6465 762f linuz root=/dev/ │ │ │ │ -0000a1e0: 7364 6131 0a0a 2020 2020 2049 6620 796f sda1.. If yo │ │ │ │ -0000a1f0: 7520 6e65 6564 2074 6f20 7370 6563 6966 u need to specif │ │ │ │ -0000a200: 7920 736f 6d65 206b 6572 6e65 6c20 7061 y some kernel pa │ │ │ │ -0000a210: 7261 6d65 7465 7273 2c20 6a75 7374 2061 rameters, just a │ │ │ │ -0000a220: 7070 656e 6420 7468 656d 2074 6f0a 2020 ppend them to. │ │ │ │ -0000a230: 2020 2074 6865 2063 6f6d 6d61 6e64 2e20 the command. │ │ │ │ -0000a240: 2046 6f72 2065 7861 6d70 6c65 2c20 746f For example, to │ │ │ │ -0000a250: 2073 6574 2027 6163 7069 2720 746f 2027 set 'acpi' to ' │ │ │ │ -0000a260: 6f66 6627 2c20 646f 2074 6869 733a 0a0a off', do this:.. │ │ │ │ -0000a270: 2020 2020 2020 2020 2020 6772 7562 3e20 grub> │ │ │ │ -0000a280: 6c69 6e75 7820 2f76 6d6c 696e 757a 2072 linux /vmlinuz r │ │ │ │ -0000a290: 6f6f 743d 2f64 6576 2f73 6461 3120 6163 oot=/dev/sda1 ac │ │ │ │ -0000a2a0: 7069 3d6f 6666 0a0a 2020 2020 2053 6565 pi=off.. See │ │ │ │ -0000a2b0: 2074 6865 2064 6f63 756d 656e 7461 7469 the documentati │ │ │ │ -0000a2c0: 6f6e 2069 6e20 7468 6520 4c69 6e75 7820 on in the Linux │ │ │ │ -0000a2d0: 736f 7572 6365 2074 7265 6520 666f 7220 source tree for │ │ │ │ -0000a2e0: 636f 6d70 6c65 7465 0a20 2020 2020 696e complete. in │ │ │ │ -0000a2f0: 666f 726d 6174 696f 6e20 6f6e 2074 6865 formation on the │ │ │ │ -0000a300: 2061 7661 696c 6162 6c65 206f 7074 696f available optio │ │ │ │ -0000a310: 6e73 2e0a 0a20 2020 2020 5769 7468 2027 ns... With ' │ │ │ │ -0000a320: 6c69 6e75 7827 2047 5255 4220 7573 6573 linux' GRUB uses │ │ │ │ -0000a330: 2033 322d 6269 7420 7072 6f74 6f63 6f6c 32-bit protocol │ │ │ │ -0000a340: 2e20 2053 6f6d 6520 4249 4f53 2073 6572 . Some BIOS ser │ │ │ │ -0000a350: 7669 6365 7320 6c69 6b65 0a20 2020 2020 vices like. │ │ │ │ -0000a360: 4150 4d20 6f72 2045 4444 2061 7265 6e27 APM or EDD aren' │ │ │ │ -0000a370: 7420 6176 6169 6c61 626c 6520 7769 7468 t available with │ │ │ │ -0000a380: 2074 6869 7320 7072 6f74 6f63 6f6c 2e20 this protocol. │ │ │ │ -0000a390: 2049 6e20 7468 6973 2063 6173 6520 796f In this case yo │ │ │ │ -0000a3a0: 750a 2020 2020 206e 6565 6420 746f 2075 u. need to u │ │ │ │ -0000a3b0: 7365 2027 6c69 6e75 7831 3627 0a0a 2020 se 'linux16'.. │ │ │ │ -0000a3c0: 2020 2020 2020 2020 6772 7562 3e20 6c69 grub> li │ │ │ │ -0000a3d0: 6e75 7831 3620 2f76 6d6c 696e 757a 2072 nux16 /vmlinuz r │ │ │ │ -0000a3e0: 6f6f 743d 2f64 6576 2f73 6461 3120 6163 oot=/dev/sda1 ac │ │ │ │ -0000a3f0: 7069 3d6f 6666 0a0a 2020 332e 2049 6620 pi=off.. 3. If │ │ │ │ -0000a400: 796f 7520 7573 6520 616e 2069 6e69 7472 you use an initr │ │ │ │ -0000a410: 642c 2065 7865 6375 7465 2074 6865 2063 d, execute the c │ │ │ │ -0000a420: 6f6d 6d61 6e64 2027 696e 6974 7264 2720 ommand 'initrd' │ │ │ │ -0000a430: 282a 6e6f 7465 2069 6e69 7472 643a 3a29 (*note initrd::) │ │ │ │ -0000a440: 0a20 2020 2020 6166 7465 7220 276c 696e . after 'lin │ │ │ │ -0000a450: 7578 273a 0a0a 2020 2020 2020 2020 2020 ux':.. │ │ │ │ -0000a460: 6772 7562 3e20 696e 6974 7264 202f 696e grub> initrd /in │ │ │ │ -0000a470: 6974 7264 0a0a 2020 2020 2049 6620 796f itrd.. If yo │ │ │ │ -0000a480: 7520 7573 6564 2027 6c69 6e75 7831 3627 u used 'linux16' │ │ │ │ -0000a490: 2079 6f75 206e 6565 6420 746f 2075 7365 you need to use │ │ │ │ -0000a4a0: 2027 696e 6974 7264 3136 273a 0a0a 2020 'initrd16':.. │ │ │ │ -0000a4b0: 2020 2020 2020 2020 6772 7562 3e20 696e grub> in │ │ │ │ -0000a4c0: 6974 7264 3136 202f 696e 6974 7264 0a0a itrd16 /initrd.. │ │ │ │ -0000a4d0: 2020 342e 2046 696e 616c 6c79 2c20 7275 4. Finally, ru │ │ │ │ -0000a4e0: 6e20 7468 6520 636f 6d6d 616e 6420 2762 n the command 'b │ │ │ │ -0000a4f0: 6f6f 7427 2028 2a6e 6f74 6520 626f 6f74 oot' (*note boot │ │ │ │ -0000a500: 3a3a 292e 0a0a 2020 202a 4361 7574 696f ::)... *Cautio │ │ │ │ -0000a510: 6e3a 2a20 4966 2079 6f75 2075 7365 2061 n:* If you use a │ │ │ │ -0000a520: 6e20 696e 6974 7264 2061 6e64 2073 7065 n initrd and spe │ │ │ │ -0000a530: 6369 6679 2074 6865 2027 6d65 6d3d 2720 cify the 'mem=' │ │ │ │ -0000a540: 6f70 7469 6f6e 2074 6f20 7468 650a 6b65 option to the.ke │ │ │ │ -0000a550: 726e 656c 2074 6f20 6c65 7420 6974 2075 rnel to let it u │ │ │ │ -0000a560: 7365 206c 6573 7320 7468 616e 2061 6374 se less than act │ │ │ │ -0000a570: 7561 6c20 6d65 6d6f 7279 2073 697a 652c ual memory size, │ │ │ │ -0000a580: 2079 6f75 2077 696c 6c20 616c 736f 2068 you will also h │ │ │ │ -0000a590: 6176 6520 746f 0a73 7065 6369 6679 2074 ave to.specify t │ │ │ │ -0000a5a0: 6865 2073 616d 6520 6d65 6d6f 7279 2073 he same memory s │ │ │ │ -0000a5b0: 697a 6520 746f 2047 5255 422e 2054 6f20 ize to GRUB. To │ │ │ │ -0000a5c0: 6c65 7420 4752 5542 206b 6e6f 7720 7468 let GRUB know th │ │ │ │ -0000a5d0: 6520 7369 7a65 2c20 7275 6e20 7468 650a e size, run the. │ │ │ │ -0000a5e0: 636f 6d6d 616e 6420 2775 7070 6572 6d65 command 'upperme │ │ │ │ -0000a5f0: 6d27 205f 6265 666f 7265 5f20 6c6f 6164 m' _before_ load │ │ │ │ -0000a600: 696e 6720 7468 6520 6b65 726e 656c 2e20 ing the kernel. │ │ │ │ -0000a610: 202a 4e6f 7465 2075 7070 6572 6d65 6d3a *Note uppermem: │ │ │ │ -0000a620: 3a2c 2066 6f72 0a6d 6f72 6520 696e 666f :, for.more info │ │ │ │ -0000a630: 726d 6174 696f 6e2e 0a0a 1f0a 4669 6c65 rmation.....File │ │ │ │ -0000a640: 3a20 6772 7562 2e69 6e66 6f2c 2020 4e6f : grub.info, No │ │ │ │ -0000a650: 6465 3a20 4e65 7442 5344 2c20 204e 6578 de: NetBSD, Nex │ │ │ │ -0000a660: 743a 2044 4f53 2f57 696e 646f 7773 2c20 t: DOS/Windows, │ │ │ │ -0000a670: 2050 7265 763a 2047 4e55 2f4c 696e 7578 Prev: GNU/Linux │ │ │ │ -0000a680: 2c20 2055 703a 204f 532d 7370 6563 6966 , Up: OS-specif │ │ │ │ -0000a690: 6963 206e 6f74 6573 0a0a 352e 332e 3320 ic notes..5.3.3 │ │ │ │ -0000a6a0: 4e65 7442 5344 0a2d 2d2d 2d2d 2d2d 2d2d NetBSD.--------- │ │ │ │ -0000a6b0: 2d2d 2d0a 0a42 6f6f 7469 6e67 2061 204e ---..Booting a N │ │ │ │ -0000a6c0: 6574 4253 4420 6b65 726e 656c 2066 726f etBSD kernel fro │ │ │ │ -0000a6d0: 6d20 4752 5542 2069 7320 616c 736f 2072 m GRUB is also r │ │ │ │ -0000a6e0: 656c 6174 6976 656c 7920 6561 7379 3a20 elatively easy: │ │ │ │ -0000a6f0: 6669 7273 7420 7365 740a 4752 5542 2773 first set.GRUB's │ │ │ │ -0000a700: 2072 6f6f 7420 6465 7669 6365 2c20 7468 root device, th │ │ │ │ -0000a710: 656e 206c 6f61 6420 7468 6520 6b65 726e en load the kern │ │ │ │ -0000a720: 656c 2061 6e64 2074 6865 206d 6f64 756c el and the modul │ │ │ │ -0000a730: 6573 2c20 616e 6420 6669 6e61 6c6c 790a es, and finally. │ │ │ │ -0000a740: 7275 6e20 2762 6f6f 7427 2e0a 0a20 2031 run 'boot'... 1 │ │ │ │ -0000a750: 2e20 5365 7420 4752 5542 2773 2072 6f6f . Set GRUB's roo │ │ │ │ -0000a760: 7420 6465 7669 6365 2074 6f20 7468 6520 t device to the │ │ │ │ -0000a770: 7061 7274 6974 696f 6e20 686f 6c64 696e partition holdin │ │ │ │ -0000a780: 6720 7468 6520 4e65 7442 5344 2072 6f6f g the NetBSD roo │ │ │ │ -0000a790: 740a 2020 2020 2066 696c 6520 7379 7374 t. file syst │ │ │ │ -0000a7a0: 656d 2e20 2046 6f72 2061 2064 6973 6b20 em. For a disk │ │ │ │ -0000a7b0: 7769 7468 2061 204e 6574 4253 4420 6469 with a NetBSD di │ │ │ │ -0000a7c0: 736b 206c 6162 656c 2c20 7468 6973 2069 sk label, this i │ │ │ │ -0000a7d0: 7320 7573 7561 6c6c 790a 2020 2020 2074 s usually. t │ │ │ │ -0000a7e0: 6865 2066 6972 7374 2070 6172 7469 7469 he first partiti │ │ │ │ -0000a7f0: 6f6e 2028 613a 292e 2020 496e 2074 6861 on (a:). In tha │ │ │ │ -0000a800: 7420 6361 7365 2c20 616e 6420 6173 7375 t case, and assu │ │ │ │ -0000a810: 6d69 6e67 2074 6861 7420 7468 650a 2020 ming that the. │ │ │ │ -0000a820: 2020 2070 6172 7469 7469 6f6e 2069 7320 partition is │ │ │ │ -0000a830: 6f6e 2074 6865 2066 6972 7374 2068 6172 on the first har │ │ │ │ -0000a840: 6420 6469 736b 2c20 7365 7420 4752 5542 d disk, set GRUB │ │ │ │ -0000a850: 2773 2072 6f6f 7420 6465 7669 6365 2061 's root device a │ │ │ │ -0000a860: 730a 2020 2020 2066 6f6c 6c6f 7773 3a0a s. follows:. │ │ │ │ -0000a870: 0a20 2020 2020 2020 2020 2067 7275 623e . grub> │ │ │ │ -0000a880: 2069 6e73 6d6f 6420 7061 7274 5f62 7364 insmod part_bsd │ │ │ │ -0000a890: 0a20 2020 2020 2020 2020 2067 7275 623e . grub> │ │ │ │ -0000a8a0: 2073 6574 2072 6f6f 743d 2868 6430 2c6e set root=(hd0,n │ │ │ │ -0000a8b0: 6574 6273 6431 290a 0a20 2020 2020 466f etbsd1).. Fo │ │ │ │ -0000a8c0: 7220 6120 6469 736b 2077 6974 6820 6120 r a disk with a │ │ │ │ -0000a8d0: 4755 4944 2050 6172 7469 7469 6f6e 2054 GUID Partition T │ │ │ │ -0000a8e0: 6162 6c65 2028 4750 5429 2c20 616e 6420 able (GPT), and │ │ │ │ -0000a8f0: 6173 7375 6d69 6e67 2074 6861 7420 7468 assuming that th │ │ │ │ -0000a900: 650a 2020 2020 204e 6574 4253 4420 726f e. NetBSD ro │ │ │ │ -0000a910: 6f74 2070 6172 7469 7469 6f6e 2069 7320 ot partition is │ │ │ │ -0000a920: 7468 6520 7468 6972 6420 4750 5420 7061 the third GPT pa │ │ │ │ -0000a930: 7274 6974 696f 6e2c 2064 6f20 7468 6973 rtition, do this │ │ │ │ -0000a940: 3a0a 0a20 2020 2020 2020 2020 2067 7275 :.. gru │ │ │ │ -0000a950: 623e 2069 6e73 6d6f 6420 7061 7274 5f67 b> insmod part_g │ │ │ │ -0000a960: 7074 0a20 2020 2020 2020 2020 2067 7275 pt. gru │ │ │ │ -0000a970: 623e 2073 6574 2072 6f6f 743d 2868 6430 b> set root=(hd0 │ │ │ │ -0000a980: 2c67 7074 3329 0a0a 2020 322e 204c 6f61 ,gpt3).. 2. Loa │ │ │ │ -0000a990: 6420 7468 6520 6b65 726e 656c 2075 7369 d the kernel usi │ │ │ │ -0000a9a0: 6e67 2074 6865 2063 6f6d 6d61 6e64 2027 ng the command ' │ │ │ │ -0000a9b0: 6b6e 6574 6273 6427 3a0a 0a20 2020 2020 knetbsd':.. │ │ │ │ -0000a9c0: 2020 2020 2067 7275 623e 206b 6e65 7462 grub> knetb │ │ │ │ -0000a9d0: 7364 202f 6e65 7462 7364 0a0a 2020 2020 sd /netbsd.. │ │ │ │ -0000a9e0: 2056 6172 696f 7573 206f 7074 696f 6e73 Various options │ │ │ │ -0000a9f0: 206d 6179 2062 6520 6769 7665 6e20 746f may be given to │ │ │ │ -0000aa00: 2027 6b6e 6574 6273 6427 2e20 2054 6865 'knetbsd'. The │ │ │ │ -0000aa10: 7365 206f 7074 696f 6e73 2061 7265 2c20 se options are, │ │ │ │ -0000aa20: 666f 720a 2020 2020 2074 6865 206d 6f73 for. the mos │ │ │ │ -0000aa30: 7420 7061 7274 2c20 7468 6520 7361 6d65 t part, the same │ │ │ │ -0000aa40: 2061 7320 696e 2074 6865 204e 6574 4253 as in the NetBS │ │ │ │ -0000aa50: 4420 626f 6f74 206c 6f61 6465 722e 2020 D boot loader. │ │ │ │ -0000aa60: 466f 720a 2020 2020 2069 6e73 7461 6e63 For. instanc │ │ │ │ -0000aa70: 652c 2074 6f20 626f 6f74 2074 6865 2073 e, to boot the s │ │ │ │ -0000aa80: 7973 7465 6d20 696e 2073 696e 676c 652d ystem in single- │ │ │ │ -0000aa90: 7573 6572 206d 6f64 6520 616e 6420 7769 user mode and wi │ │ │ │ -0000aaa0: 7468 2076 6572 626f 7365 0a20 2020 2020 th verbose. │ │ │ │ -0000aab0: 6d65 7373 6167 6573 2c20 646f 2074 6869 messages, do thi │ │ │ │ -0000aac0: 733a 0a0a 2020 2020 2020 2020 2020 6772 s:.. gr │ │ │ │ -0000aad0: 7562 3e20 6b6e 6574 6273 6420 2f6e 6574 ub> knetbsd /net │ │ │ │ -0000aae0: 6273 6420 2d73 202d 760a 0a20 2033 2e20 bsd -s -v.. 3. │ │ │ │ -0000aaf0: 4966 206e 6565 6465 642c 206c 6f61 6420 If needed, load │ │ │ │ -0000ab00: 6b65 726e 656c 206d 6f64 756c 6573 2077 kernel modules w │ │ │ │ -0000ab10: 6974 6820 7468 6520 636f 6d6d 616e 640a ith the command. │ │ │ │ -0000ab20: 2020 2020 2027 6b6e 6574 6273 645f 6d6f 'knetbsd_mo │ │ │ │ -0000ab30: 6475 6c65 5f65 6c66 272e 2020 4120 7479 dule_elf'. A ty │ │ │ │ -0000ab40: 7069 6361 6c20 6578 616d 706c 6520 6973 pical example is │ │ │ │ -0000ab50: 2074 6865 206d 6f64 756c 6520 666f 7220 the module for │ │ │ │ -0000ab60: 7468 6520 726f 6f74 0a20 2020 2020 6669 the root. fi │ │ │ │ -0000ab70: 6c65 2073 7973 7465 6d3a 0a0a 2020 2020 le system:.. │ │ │ │ -0000ab80: 2020 2020 2020 6772 7562 3e20 6b6e 6574 grub> knet │ │ │ │ -0000ab90: 6273 645f 6d6f 6475 6c65 5f65 6c66 202f bsd_module_elf / │ │ │ │ -0000aba0: 7374 616e 642f 616d 6436 342f 362e 302f stand/amd64/6.0/ │ │ │ │ -0000abb0: 6d6f 6475 6c65 732f 6666 732f 6666 732e modules/ffs/ffs. │ │ │ │ -0000abc0: 6b6d 6f64 0a0a 2020 342e 2046 696e 616c kmod.. 4. Final │ │ │ │ -0000abd0: 6c79 2c20 7275 6e20 7468 6520 636f 6d6d ly, run the comm │ │ │ │ -0000abe0: 616e 6420 2762 6f6f 7427 2028 2a6e 6f74 and 'boot' (*not │ │ │ │ -0000abf0: 6520 626f 6f74 3a3a 292e 0a0a 1f0a 4669 e boot::).....Fi │ │ │ │ -0000ac00: 6c65 3a20 6772 7562 2e69 6e66 6f2c 2020 le: grub.info, │ │ │ │ -0000ac10: 4e6f 6465 3a20 444f 532f 5769 6e64 6f77 Node: DOS/Window │ │ │ │ -0000ac20: 732c 2020 5072 6576 3a20 4e65 7442 5344 s, Prev: NetBSD │ │ │ │ -0000ac30: 2c20 2055 703a 204f 532d 7370 6563 6966 , Up: OS-specif │ │ │ │ -0000ac40: 6963 206e 6f74 6573 0a0a 352e 332e 3420 ic notes..5.3.4 │ │ │ │ -0000ac50: 444f 532f 5769 6e64 6f77 730a 2d2d 2d2d DOS/Windows.---- │ │ │ │ -0000ac60: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a47 -------------..G │ │ │ │ -0000ac70: 5255 4220 6361 6e6e 6f74 2062 6f6f 7420 RUB cannot boot │ │ │ │ -0000ac80: 444f 5320 6f72 2057 696e 646f 7773 2064 DOS or Windows d │ │ │ │ -0000ac90: 6972 6563 746c 792c 2073 6f20 796f 7520 irectly, so you │ │ │ │ -0000aca0: 6d75 7374 2063 6861 696e 2d6c 6f61 6420 must chain-load │ │ │ │ -0000acb0: 7468 656d 0a28 2a6e 6f74 6520 4368 6169 them.(*note Chai │ │ │ │ -0000acc0: 6e2d 6c6f 6164 696e 673a 3a29 2e20 2048 n-loading::). H │ │ │ │ -0000acd0: 6f77 6576 6572 2c20 7468 6569 7220 626f owever, their bo │ │ │ │ -0000ace0: 6f74 206c 6f61 6465 7273 2068 6176 6520 ot loaders have │ │ │ │ -0000acf0: 736f 6d65 2063 7269 7469 6361 6c0a 6465 some critical.de │ │ │ │ -0000ad00: 6669 6369 656e 6369 6573 2c20 736f 2069 ficiencies, so i │ │ │ │ -0000ad10: 7420 6d61 7920 6e6f 7420 776f 726b 2074 t may not work t │ │ │ │ -0000ad20: 6f20 6a75 7374 2063 6861 696e 2d6c 6f61 o just chain-loa │ │ │ │ -0000ad30: 6420 7468 656d 2e20 2054 6f20 6f76 6572 d them. To over │ │ │ │ -0000ad40: 636f 6d65 0a74 6865 2070 726f 626c 656d come.the problem │ │ │ │ -0000ad50: 732c 2047 5255 4220 7072 6f76 6964 6573 s, GRUB provides │ │ │ │ -0000ad60: 2079 6f75 2077 6974 6820 7477 6f20 6865 you with two he │ │ │ │ -0000ad70: 6c70 6572 2066 756e 6374 696f 6e73 2e0a lper functions.. │ │ │ │ -0000ad80: 0a20 2020 4966 2079 6f75 2068 6176 6520 . If you have │ │ │ │ -0000ad90: 696e 7374 616c 6c65 6420 444f 5320 286f installed DOS (o │ │ │ │ -0000ada0: 7220 5769 6e64 6f77 7329 206f 6e20 6120 r Windows) on a │ │ │ │ -0000adb0: 6e6f 6e2d 6669 7273 7420 6861 7264 2064 non-first hard d │ │ │ │ -0000adc0: 6973 6b2c 2079 6f75 0a68 6176 6520 746f isk, you.have to │ │ │ │ -0000add0: 2075 7365 2074 6865 2064 6973 6b20 7377 use the disk sw │ │ │ │ -0000ade0: 6170 7069 6e67 2074 6563 686e 6971 7565 apping technique │ │ │ │ -0000adf0: 2c20 6265 6361 7573 6520 7468 6174 204f , because that O │ │ │ │ -0000ae00: 5320 6361 6e6e 6f74 2062 6f6f 740a 6672 S cannot boot.fr │ │ │ │ -0000ae10: 6f6d 2061 6e79 2064 6973 6b73 2062 7574 om any disks but │ │ │ │ -0000ae20: 2074 6865 2066 6972 7374 206f 6e65 2e20 the first one. │ │ │ │ -0000ae30: 2054 6865 2077 6f72 6b61 726f 756e 6420 The workaround │ │ │ │ -0000ae40: 7573 6564 2069 6e20 4752 5542 2069 7320 used in GRUB is │ │ │ │ -0000ae50: 7468 650a 636f 6d6d 616e 6420 2764 7269 the.command 'dri │ │ │ │ -0000ae60: 7665 6d61 7027 2028 2a6e 6f74 6520 6472 vemap' (*note dr │ │ │ │ -0000ae70: 6976 656d 6170 3a3a 292c 206c 696b 6520 ivemap::), like │ │ │ │ -0000ae80: 7468 6973 3a0a 0a20 2020 2020 6472 6976 this:.. driv │ │ │ │ -0000ae90: 656d 6170 202d 7320 2868 6430 2920 2868 emap -s (hd0) (h │ │ │ │ -0000aea0: 6431 290a 0a20 2020 5468 6973 2070 6572 d1).. This per │ │ │ │ -0000aeb0: 666f 726d 7320 6120 2276 6972 7475 616c forms a "virtual │ │ │ │ -0000aec0: 2220 7377 6170 2062 6574 7765 656e 2079 " swap between y │ │ │ │ -0000aed0: 6f75 7220 6669 7273 7420 616e 6420 7365 our first and se │ │ │ │ -0000aee0: 636f 6e64 2068 6172 640a 6472 6976 652e cond hard.drive. │ │ │ │ -0000aef0: 0a0a 2020 202a 4361 7574 696f 6e3a 2a20 .. *Caution:* │ │ │ │ -0000af00: 5468 6973 2069 7320 6566 6665 6374 6976 This is effectiv │ │ │ │ -0000af10: 6520 6f6e 6c79 2069 6620 444f 5320 286f e only if DOS (o │ │ │ │ -0000af20: 7220 5769 6e64 6f77 7329 2075 7365 7320 r Windows) uses │ │ │ │ -0000af30: 4249 4f53 2074 6f0a 6163 6365 7373 2074 BIOS to.access t │ │ │ │ -0000af40: 6865 2073 7761 7070 6564 2064 6973 6b73 he swapped disks │ │ │ │ -0000af50: 2e20 2049 6620 7468 6174 204f 5320 7573 . If that OS us │ │ │ │ -0000af60: 6573 2061 2073 7065 6369 616c 2064 7269 es a special dri │ │ │ │ -0000af70: 7665 7220 666f 7220 7468 650a 6469 736b ver for the.disk │ │ │ │ -0000af80: 732c 2074 6869 7320 7072 6f62 6162 6c79 s, this probably │ │ │ │ -0000af90: 2077 6f6e 2774 2077 6f72 6b2e 0a0a 2020 won't work... │ │ │ │ -0000afa0: 2041 6e6f 7468 6572 2070 726f 626c 656d Another problem │ │ │ │ -0000afb0: 2061 7269 7365 7320 6966 2079 6f75 2069 arises if you i │ │ │ │ -0000afc0: 6e73 7461 6c6c 6564 206d 6f72 6520 7468 nstalled more th │ │ │ │ -0000afd0: 616e 206f 6e65 2073 6574 206f 660a 444f an one set of.DO │ │ │ │ -0000afe0: 532f 5769 6e64 6f77 7320 6f6e 746f 206f S/Windows onto o │ │ │ │ -0000aff0: 6e65 2064 6973 6b2c 2062 6563 6175 7365 ne disk, because │ │ │ │ -0000b000: 2074 6865 7920 636f 756c 6420 6265 2063 they could be c │ │ │ │ -0000b010: 6f6e 6675 7365 6420 6966 2074 6865 7265 onfused if there │ │ │ │ -0000b020: 2061 7265 0a6d 6f72 6520 7468 616e 206f are.more than o │ │ │ │ -0000b030: 6e65 2070 7269 6d61 7279 2070 6172 7469 ne primary parti │ │ │ │ -0000b040: 7469 6f6e 7320 666f 7220 444f 532f 5769 tions for DOS/Wi │ │ │ │ -0000b050: 6e64 6f77 732e 2020 4365 7274 6169 6e6c ndows. Certainl │ │ │ │ -0000b060: 7920 796f 7520 7368 6f75 6c64 0a61 766f y you should.avo │ │ │ │ -0000b070: 6964 2064 6f69 6e67 2074 6869 732c 2062 id doing this, b │ │ │ │ -0000b080: 7574 2074 6865 7265 2069 7320 6120 736f ut there is a so │ │ │ │ -0000b090: 6c75 7469 6f6e 2069 6620 796f 7520 646f lution if you do │ │ │ │ -0000b0a0: 2077 616e 7420 746f 2064 6f20 736f 2e20 want to do so. │ │ │ │ -0000b0b0: 2055 7365 0a74 6865 2070 6172 7469 7469 Use.the partiti │ │ │ │ -0000b0c0: 6f6e 2068 6964 696e 672f 756e 6869 6469 on hiding/unhidi │ │ │ │ -0000b0d0: 6e67 2074 6563 686e 6971 7565 2e0a 0a20 ng technique... │ │ │ │ -0000b0e0: 2020 4966 2047 5255 4220 2268 6964 6573 If GRUB "hides │ │ │ │ -0000b0f0: 2220 6120 444f 5320 286f 7220 5769 6e64 " a DOS (or Wind │ │ │ │ -0000b100: 6f77 7329 2070 6172 7469 7469 6f6e 2028 ows) partition ( │ │ │ │ -0000b110: 2a6e 6f74 6520 7061 7274 746f 6f6c 3a3a *note parttool:: │ │ │ │ -0000b120: 292c 2044 4f53 0a28 6f72 2057 696e 646f ), DOS.(or Windo │ │ │ │ -0000b130: 7773 2920 7769 6c6c 2069 676e 6f72 6520 ws) will ignore │ │ │ │ -0000b140: 7468 6520 7061 7274 6974 696f 6e2e 2020 the partition. │ │ │ │ -0000b150: 4966 2047 5255 4220 2275 6e68 6964 6573 If GRUB "unhides │ │ │ │ -0000b160: 2220 6120 444f 5320 286f 720a 5769 6e64 " a DOS (or.Wind │ │ │ │ -0000b170: 6f77 7329 2070 6172 7469 7469 6f6e 2c20 ows) partition, │ │ │ │ -0000b180: 444f 5320 286f 7220 5769 6e64 6f77 7329 DOS (or Windows) │ │ │ │ -0000b190: 2077 696c 6c20 6465 7465 6374 2074 6865 will detect the │ │ │ │ -0000b1a0: 2070 6172 7469 7469 6f6e 2e20 2054 6875 partition. Thu │ │ │ │ -0000b1b0: 732c 0a69 6620 796f 7520 6861 7665 2069 s,.if you have i │ │ │ │ -0000b1c0: 6e73 7461 6c6c 6564 2044 4f53 2028 6f72 nstalled DOS (or │ │ │ │ -0000b1d0: 2057 696e 646f 7773 2920 6f6e 2074 6865 Windows) on the │ │ │ │ -0000b1e0: 2066 6972 7374 2061 6e64 2074 6865 2073 first and the s │ │ │ │ -0000b1f0: 6563 6f6e 640a 7061 7274 6974 696f 6e20 econd.partition │ │ │ │ -0000b200: 6f66 2074 6865 2066 6972 7374 2068 6172 of the first har │ │ │ │ -0000b210: 6420 6469 736b 2c20 616e 6420 796f 7520 d disk, and you │ │ │ │ -0000b220: 7761 6e74 2074 6f20 626f 6f74 2074 6865 want to boot the │ │ │ │ -0000b230: 2063 6f70 7920 6f6e 2074 6865 0a66 6972 copy on the.fir │ │ │ │ -0000b240: 7374 2070 6172 7469 7469 6f6e 2c20 646f st partition, do │ │ │ │ -0000b250: 2074 6865 2066 6f6c 6c6f 7769 6e67 3a0a the following:. │ │ │ │ -0000b260: 0a20 2020 2020 7061 7274 746f 6f6c 2028 . parttool ( │ │ │ │ -0000b270: 6864 302c 3129 2068 6964 6465 6e2d 0a20 hd0,1) hidden-. │ │ │ │ -0000b280: 2020 2020 7061 7274 746f 6f6c 2028 6864 parttool (hd │ │ │ │ -0000b290: 302c 3229 2068 6964 6465 6e2b 0a20 2020 0,2) hidden+. │ │ │ │ -0000b2a0: 2020 7365 7420 726f 6f74 3d28 6864 302c set root=(hd0, │ │ │ │ -0000b2b0: 3129 0a20 2020 2020 6368 6169 6e6c 6f61 1). chainloa │ │ │ │ -0000b2c0: 6465 7220 2b31 0a20 2020 2020 7061 7274 der +1. part │ │ │ │ -0000b2d0: 746f 6f6c 2024 7b72 6f6f 747d 2062 6f6f tool ${root} boo │ │ │ │ -0000b2e0: 742b 0a20 2020 2020 626f 6f74 0a0a 1f0a t+. boot.... │ │ │ │ -0000b2f0: 4669 6c65 3a20 6772 7562 2e69 6e66 6f2c File: grub.info, │ │ │ │ -0000b300: 2020 4e6f 6465 3a20 436f 6e66 6967 7572 Node: Configur │ │ │ │ -0000b310: 6174 696f 6e2c 2020 4e65 7874 3a20 5468 ation, Next: Th │ │ │ │ -0000b320: 656d 6520 6669 6c65 2066 6f72 6d61 742c eme file format, │ │ │ │ -0000b330: 2020 5072 6576 3a20 426f 6f74 696e 672c Prev: Booting, │ │ │ │ -0000b340: 2020 5570 3a20 546f 700a 0a36 2057 7269 Up: Top..6 Wri │ │ │ │ -0000b350: 7469 6e67 2079 6f75 7220 6f77 6e20 636f ting your own co │ │ │ │ -0000b360: 6e66 6967 7572 6174 696f 6e20 6669 6c65 nfiguration file │ │ │ │ -0000b370: 0a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a .*************** │ │ │ │ +00009f30: 2020 2020 2020 2020 2020 2020 2724 2874 '$(t │ │ │ │ +00009f40: 6173 6b2d 6372 6561 7465 2927 2027 2428 ask-create)' '$( │ │ │ │ +00009f50: 7461 736b 2d72 6573 756d 6529 270a 2020 task-resume)'. │ │ │ │ +00009f60: 2020 2020 2020 2020 6772 7562 3e20 6d6f grub> mo │ │ │ │ +00009f70: 6475 6c65 202f 6c69 622f 6c64 2e73 6f2e dule /lib/ld.so. │ │ │ │ +00009f80: 3120 6578 6563 202f 6875 7264 2f65 7865 1 exec /hurd/exe │ │ │ │ +00009f90: 6320 2724 2865 7865 632d 7461 736b 3d74 c '$(exec-task=t │ │ │ │ +00009fa0: 6173 6b2d 6372 6561 7465 2927 0a0a 2020 ask-create)'.. │ │ │ │ +00009fb0: 332e 2046 696e 616c 6c79 2c20 7275 6e20 3. Finally, run │ │ │ │ +00009fc0: 7468 6520 636f 6d6d 616e 6420 2762 6f6f the command 'boo │ │ │ │ +00009fd0: 7427 2028 2a6e 6f74 6520 626f 6f74 3a3a t' (*note boot:: │ │ │ │ +00009fe0: 292e 0a0a 1f0a 4669 6c65 3a20 6772 7562 ).....File: grub │ │ │ │ +00009ff0: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 474e .info, Node: GN │ │ │ │ +0000a000: 552f 4c69 6e75 782c 2020 4e65 7874 3a20 U/Linux, Next: │ │ │ │ +0000a010: 4e65 7442 5344 2c20 2050 7265 763a 2047 NetBSD, Prev: G │ │ │ │ +0000a020: 4e55 2f48 7572 642c 2020 5570 3a20 4f53 NU/Hurd, Up: OS │ │ │ │ +0000a030: 2d73 7065 6369 6669 6320 6e6f 7465 730a -specific notes. │ │ │ │ +0000a040: 0a35 2e33 2e32 2047 4e55 2f4c 696e 7578 .5.3.2 GNU/Linux │ │ │ │ +0000a050: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d .--------------- │ │ │ │ +0000a060: 0a0a 4974 2069 7320 7265 6c61 7469 7665 ..It is relative │ │ │ │ +0000a070: 6c79 2065 6173 7920 746f 2062 6f6f 7420 ly easy to boot │ │ │ │ +0000a080: 474e 552f 4c69 6e75 7820 6672 6f6d 2047 GNU/Linux from G │ │ │ │ +0000a090: 5255 422c 2062 6563 6175 7365 2069 7420 RUB, because it │ │ │ │ +0000a0a0: 736f 6d65 7768 6174 0a72 6573 656d 626c somewhat.resembl │ │ │ │ +0000a0b0: 6573 2074 6f20 626f 6f74 2061 204d 756c es to boot a Mul │ │ │ │ +0000a0c0: 7469 626f 6f74 2d63 6f6d 706c 6961 6e74 tiboot-compliant │ │ │ │ +0000a0d0: 204f 532e 0a0a 2020 312e 2053 6574 2047 OS... 1. Set G │ │ │ │ +0000a0e0: 5255 4227 7320 726f 6f74 2064 6576 6963 RUB's root devic │ │ │ │ +0000a0f0: 6520 746f 2074 6865 2073 616d 6520 6472 e to the same dr │ │ │ │ +0000a100: 6976 6520 6173 2047 4e55 2f4c 696e 7578 ive as GNU/Linux │ │ │ │ +0000a110: 2773 2e20 2054 6865 0a20 2020 2020 636f 's. The. co │ │ │ │ +0000a120: 6d6d 616e 6420 2773 6561 7263 6820 2d2d mmand 'search -- │ │ │ │ +0000a130: 7365 743d 726f 6f74 202d 2d66 696c 6520 set=root --file │ │ │ │ +0000a140: 2f76 6d6c 696e 757a 2720 6f72 2073 696d /vmlinuz' or sim │ │ │ │ +0000a150: 696c 6172 206d 6179 2068 656c 7020 796f ilar may help yo │ │ │ │ +0000a160: 750a 2020 2020 2028 2a6e 6f74 6520 7365 u. (*note se │ │ │ │ +0000a170: 6172 6368 3a3a 292e 0a0a 2020 322e 204c arch::)... 2. L │ │ │ │ +0000a180: 6f61 6420 7468 6520 6b65 726e 656c 2075 oad the kernel u │ │ │ │ +0000a190: 7369 6e67 2074 6865 2063 6f6d 6d61 6e64 sing the command │ │ │ │ +0000a1a0: 2027 6c69 6e75 7827 2028 2a6e 6f74 6520 'linux' (*note │ │ │ │ +0000a1b0: 6c69 6e75 783a 3a29 3a0a 0a20 2020 2020 linux::):.. │ │ │ │ +0000a1c0: 2020 2020 2067 7275 623e 206c 696e 7578 grub> linux │ │ │ │ +0000a1d0: 202f 766d 6c69 6e75 7a20 726f 6f74 3d2f /vmlinuz root=/ │ │ │ │ +0000a1e0: 6465 762f 7364 6131 0a0a 2020 2020 2049 dev/sda1.. I │ │ │ │ +0000a1f0: 6620 796f 7520 6e65 6564 2074 6f20 7370 f you need to sp │ │ │ │ +0000a200: 6563 6966 7920 736f 6d65 206b 6572 6e65 ecify some kerne │ │ │ │ +0000a210: 6c20 7061 7261 6d65 7465 7273 2c20 6a75 l parameters, ju │ │ │ │ +0000a220: 7374 2061 7070 656e 6420 7468 656d 2074 st append them t │ │ │ │ +0000a230: 6f0a 2020 2020 2074 6865 2063 6f6d 6d61 o. the comma │ │ │ │ +0000a240: 6e64 2e20 2046 6f72 2065 7861 6d70 6c65 nd. For example │ │ │ │ +0000a250: 2c20 746f 2073 6574 2027 6163 7069 2720 , to set 'acpi' │ │ │ │ +0000a260: 746f 2027 6f66 6627 2c20 646f 2074 6869 to 'off', do thi │ │ │ │ +0000a270: 733a 0a0a 2020 2020 2020 2020 2020 6772 s:.. gr │ │ │ │ +0000a280: 7562 3e20 6c69 6e75 7820 2f76 6d6c 696e ub> linux /vmlin │ │ │ │ +0000a290: 757a 2072 6f6f 743d 2f64 6576 2f73 6461 uz root=/dev/sda │ │ │ │ +0000a2a0: 3120 6163 7069 3d6f 6666 0a0a 2020 2020 1 acpi=off.. │ │ │ │ +0000a2b0: 2053 6565 2074 6865 2064 6f63 756d 656e See the documen │ │ │ │ +0000a2c0: 7461 7469 6f6e 2069 6e20 7468 6520 4c69 tation in the Li │ │ │ │ +0000a2d0: 6e75 7820 736f 7572 6365 2074 7265 6520 nux source tree │ │ │ │ +0000a2e0: 666f 7220 636f 6d70 6c65 7465 0a20 2020 for complete. │ │ │ │ +0000a2f0: 2020 696e 666f 726d 6174 696f 6e20 6f6e information on │ │ │ │ +0000a300: 2074 6865 2061 7661 696c 6162 6c65 206f the available o │ │ │ │ +0000a310: 7074 696f 6e73 2e0a 0a20 2020 2020 5769 ptions... Wi │ │ │ │ +0000a320: 7468 2027 6c69 6e75 7827 2047 5255 4220 th 'linux' GRUB │ │ │ │ +0000a330: 7573 6573 2033 322d 6269 7420 7072 6f74 uses 32-bit prot │ │ │ │ +0000a340: 6f63 6f6c 2e20 2053 6f6d 6520 4249 4f53 ocol. Some BIOS │ │ │ │ +0000a350: 2073 6572 7669 6365 7320 6c69 6b65 0a20 services like. │ │ │ │ +0000a360: 2020 2020 4150 4d20 6f72 2045 4444 2061 APM or EDD a │ │ │ │ +0000a370: 7265 6e27 7420 6176 6169 6c61 626c 6520 ren't available │ │ │ │ +0000a380: 7769 7468 2074 6869 7320 7072 6f74 6f63 with this protoc │ │ │ │ +0000a390: 6f6c 2e20 2049 6e20 7468 6973 2063 6173 ol. In this cas │ │ │ │ +0000a3a0: 6520 796f 750a 2020 2020 206e 6565 6420 e you. need │ │ │ │ +0000a3b0: 746f 2075 7365 2027 6c69 6e75 7831 3627 to use 'linux16' │ │ │ │ +0000a3c0: 0a0a 2020 2020 2020 2020 2020 6772 7562 .. grub │ │ │ │ +0000a3d0: 3e20 6c69 6e75 7831 3620 2f76 6d6c 696e > linux16 /vmlin │ │ │ │ +0000a3e0: 757a 2072 6f6f 743d 2f64 6576 2f73 6461 uz root=/dev/sda │ │ │ │ +0000a3f0: 3120 6163 7069 3d6f 6666 0a0a 2020 332e 1 acpi=off.. 3. │ │ │ │ +0000a400: 2049 6620 796f 7520 7573 6520 616e 2069 If you use an i │ │ │ │ +0000a410: 6e69 7472 642c 2065 7865 6375 7465 2074 nitrd, execute t │ │ │ │ +0000a420: 6865 2063 6f6d 6d61 6e64 2027 696e 6974 he command 'init │ │ │ │ +0000a430: 7264 2720 282a 6e6f 7465 2069 6e69 7472 rd' (*note initr │ │ │ │ +0000a440: 643a 3a29 0a20 2020 2020 6166 7465 7220 d::). after │ │ │ │ +0000a450: 276c 696e 7578 273a 0a0a 2020 2020 2020 'linux':.. │ │ │ │ +0000a460: 2020 2020 6772 7562 3e20 696e 6974 7264 grub> initrd │ │ │ │ +0000a470: 202f 696e 6974 7264 0a0a 2020 2020 2049 /initrd.. I │ │ │ │ +0000a480: 6620 796f 7520 7573 6564 2027 6c69 6e75 f you used 'linu │ │ │ │ +0000a490: 7831 3627 2079 6f75 206e 6565 6420 746f x16' you need to │ │ │ │ +0000a4a0: 2075 7365 2027 696e 6974 7264 3136 273a use 'initrd16': │ │ │ │ +0000a4b0: 0a0a 2020 2020 2020 2020 2020 6772 7562 .. grub │ │ │ │ +0000a4c0: 3e20 696e 6974 7264 3136 202f 696e 6974 > initrd16 /init │ │ │ │ +0000a4d0: 7264 0a0a 2020 342e 2046 696e 616c 6c79 rd.. 4. Finally │ │ │ │ +0000a4e0: 2c20 7275 6e20 7468 6520 636f 6d6d 616e , run the comman │ │ │ │ +0000a4f0: 6420 2762 6f6f 7427 2028 2a6e 6f74 6520 d 'boot' (*note │ │ │ │ +0000a500: 626f 6f74 3a3a 292e 0a0a 2020 202a 4361 boot::)... *Ca │ │ │ │ +0000a510: 7574 696f 6e3a 2a20 4966 2079 6f75 2075 ution:* If you u │ │ │ │ +0000a520: 7365 2061 6e20 696e 6974 7264 2061 6e64 se an initrd and │ │ │ │ +0000a530: 2073 7065 6369 6679 2074 6865 2027 6d65 specify the 'me │ │ │ │ +0000a540: 6d3d 2720 6f70 7469 6f6e 2074 6f20 7468 m=' option to th │ │ │ │ +0000a550: 650a 6b65 726e 656c 2074 6f20 6c65 7420 e.kernel to let │ │ │ │ +0000a560: 6974 2075 7365 206c 6573 7320 7468 616e it use less than │ │ │ │ +0000a570: 2061 6374 7561 6c20 6d65 6d6f 7279 2073 actual memory s │ │ │ │ +0000a580: 697a 652c 2079 6f75 2077 696c 6c20 616c ize, you will al │ │ │ │ +0000a590: 736f 2068 6176 6520 746f 0a73 7065 6369 so have to.speci │ │ │ │ +0000a5a0: 6679 2074 6865 2073 616d 6520 6d65 6d6f fy the same memo │ │ │ │ +0000a5b0: 7279 2073 697a 6520 746f 2047 5255 422e ry size to GRUB. │ │ │ │ +0000a5c0: 2054 6f20 6c65 7420 4752 5542 206b 6e6f To let GRUB kno │ │ │ │ +0000a5d0: 7720 7468 6520 7369 7a65 2c20 7275 6e20 w the size, run │ │ │ │ +0000a5e0: 7468 650a 636f 6d6d 616e 6420 2775 7070 the.command 'upp │ │ │ │ +0000a5f0: 6572 6d65 6d27 205f 6265 666f 7265 5f20 ermem' _before_ │ │ │ │ +0000a600: 6c6f 6164 696e 6720 7468 6520 6b65 726e loading the kern │ │ │ │ +0000a610: 656c 2e20 202a 4e6f 7465 2075 7070 6572 el. *Note upper │ │ │ │ +0000a620: 6d65 6d3a 3a2c 2066 6f72 0a6d 6f72 6520 mem::, for.more │ │ │ │ +0000a630: 696e 666f 726d 6174 696f 6e2e 0a0a 1f0a information..... │ │ │ │ +0000a640: 4669 6c65 3a20 6772 7562 2e69 6e66 6f2c File: grub.info, │ │ │ │ +0000a650: 2020 4e6f 6465 3a20 4e65 7442 5344 2c20 Node: NetBSD, │ │ │ │ +0000a660: 204e 6578 743a 2044 4f53 2f57 696e 646f Next: DOS/Windo │ │ │ │ +0000a670: 7773 2c20 2050 7265 763a 2047 4e55 2f4c ws, Prev: GNU/L │ │ │ │ +0000a680: 696e 7578 2c20 2055 703a 204f 532d 7370 inux, Up: OS-sp │ │ │ │ +0000a690: 6563 6966 6963 206e 6f74 6573 0a0a 352e ecific notes..5. │ │ │ │ +0000a6a0: 332e 3320 4e65 7442 5344 0a2d 2d2d 2d2d 3.3 NetBSD.----- │ │ │ │ +0000a6b0: 2d2d 2d2d 2d2d 2d0a 0a42 6f6f 7469 6e67 -------..Booting │ │ │ │ +0000a6c0: 2061 204e 6574 4253 4420 6b65 726e 656c a NetBSD kernel │ │ │ │ +0000a6d0: 2066 726f 6d20 4752 5542 2069 7320 616c from GRUB is al │ │ │ │ +0000a6e0: 736f 2072 656c 6174 6976 656c 7920 6561 so relatively ea │ │ │ │ +0000a6f0: 7379 3a20 6669 7273 7420 7365 740a 4752 sy: first set.GR │ │ │ │ +0000a700: 5542 2773 2072 6f6f 7420 6465 7669 6365 UB's root device │ │ │ │ +0000a710: 2c20 7468 656e 206c 6f61 6420 7468 6520 , then load the │ │ │ │ +0000a720: 6b65 726e 656c 2061 6e64 2074 6865 206d kernel and the m │ │ │ │ +0000a730: 6f64 756c 6573 2c20 616e 6420 6669 6e61 odules, and fina │ │ │ │ +0000a740: 6c6c 790a 7275 6e20 2762 6f6f 7427 2e0a lly.run 'boot'.. │ │ │ │ +0000a750: 0a20 2031 2e20 5365 7420 4752 5542 2773 . 1. Set GRUB's │ │ │ │ +0000a760: 2072 6f6f 7420 6465 7669 6365 2074 6f20 root device to │ │ │ │ +0000a770: 7468 6520 7061 7274 6974 696f 6e20 686f the partition ho │ │ │ │ +0000a780: 6c64 696e 6720 7468 6520 4e65 7442 5344 lding the NetBSD │ │ │ │ +0000a790: 2072 6f6f 740a 2020 2020 2066 696c 6520 root. file │ │ │ │ +0000a7a0: 7379 7374 656d 2e20 2046 6f72 2061 2064 system. For a d │ │ │ │ +0000a7b0: 6973 6b20 7769 7468 2061 204e 6574 4253 isk with a NetBS │ │ │ │ +0000a7c0: 4420 6469 736b 206c 6162 656c 2c20 7468 D disk label, th │ │ │ │ +0000a7d0: 6973 2069 7320 7573 7561 6c6c 790a 2020 is is usually. │ │ │ │ +0000a7e0: 2020 2074 6865 2066 6972 7374 2070 6172 the first par │ │ │ │ +0000a7f0: 7469 7469 6f6e 2028 613a 292e 2020 496e tition (a:). In │ │ │ │ +0000a800: 2074 6861 7420 6361 7365 2c20 616e 6420 that case, and │ │ │ │ +0000a810: 6173 7375 6d69 6e67 2074 6861 7420 7468 assuming that th │ │ │ │ +0000a820: 650a 2020 2020 2070 6172 7469 7469 6f6e e. partition │ │ │ │ +0000a830: 2069 7320 6f6e 2074 6865 2066 6972 7374 is on the first │ │ │ │ +0000a840: 2068 6172 6420 6469 736b 2c20 7365 7420 hard disk, set │ │ │ │ +0000a850: 4752 5542 2773 2072 6f6f 7420 6465 7669 GRUB's root devi │ │ │ │ +0000a860: 6365 2061 730a 2020 2020 2066 6f6c 6c6f ce as. follo │ │ │ │ +0000a870: 7773 3a0a 0a20 2020 2020 2020 2020 2067 ws:.. g │ │ │ │ +0000a880: 7275 623e 2069 6e73 6d6f 6420 7061 7274 rub> insmod part │ │ │ │ +0000a890: 5f62 7364 0a20 2020 2020 2020 2020 2067 _bsd. g │ │ │ │ +0000a8a0: 7275 623e 2073 6574 2072 6f6f 743d 2868 rub> set root=(h │ │ │ │ +0000a8b0: 6430 2c6e 6574 6273 6431 290a 0a20 2020 d0,netbsd1).. │ │ │ │ +0000a8c0: 2020 466f 7220 6120 6469 736b 2077 6974 For a disk wit │ │ │ │ +0000a8d0: 6820 6120 4755 4944 2050 6172 7469 7469 h a GUID Partiti │ │ │ │ +0000a8e0: 6f6e 2054 6162 6c65 2028 4750 5429 2c20 on Table (GPT), │ │ │ │ +0000a8f0: 616e 6420 6173 7375 6d69 6e67 2074 6861 and assuming tha │ │ │ │ +0000a900: 7420 7468 650a 2020 2020 204e 6574 4253 t the. NetBS │ │ │ │ +0000a910: 4420 726f 6f74 2070 6172 7469 7469 6f6e D root partition │ │ │ │ +0000a920: 2069 7320 7468 6520 7468 6972 6420 4750 is the third GP │ │ │ │ +0000a930: 5420 7061 7274 6974 696f 6e2c 2064 6f20 T partition, do │ │ │ │ +0000a940: 7468 6973 3a0a 0a20 2020 2020 2020 2020 this:.. │ │ │ │ +0000a950: 2067 7275 623e 2069 6e73 6d6f 6420 7061 grub> insmod pa │ │ │ │ +0000a960: 7274 5f67 7074 0a20 2020 2020 2020 2020 rt_gpt. │ │ │ │ +0000a970: 2067 7275 623e 2073 6574 2072 6f6f 743d grub> set root= │ │ │ │ +0000a980: 2868 6430 2c67 7074 3329 0a0a 2020 322e (hd0,gpt3).. 2. │ │ │ │ +0000a990: 204c 6f61 6420 7468 6520 6b65 726e 656c Load the kernel │ │ │ │ +0000a9a0: 2075 7369 6e67 2074 6865 2063 6f6d 6d61 using the comma │ │ │ │ +0000a9b0: 6e64 2027 6b6e 6574 6273 6427 3a0a 0a20 nd 'knetbsd':.. │ │ │ │ +0000a9c0: 2020 2020 2020 2020 2067 7275 623e 206b grub> k │ │ │ │ +0000a9d0: 6e65 7462 7364 202f 6e65 7462 7364 0a0a netbsd /netbsd.. │ │ │ │ +0000a9e0: 2020 2020 2056 6172 696f 7573 206f 7074 Various opt │ │ │ │ +0000a9f0: 696f 6e73 206d 6179 2062 6520 6769 7665 ions may be give │ │ │ │ +0000aa00: 6e20 746f 2027 6b6e 6574 6273 6427 2e20 n to 'knetbsd'. │ │ │ │ +0000aa10: 2054 6865 7365 206f 7074 696f 6e73 2061 These options a │ │ │ │ +0000aa20: 7265 2c20 666f 720a 2020 2020 2074 6865 re, for. the │ │ │ │ +0000aa30: 206d 6f73 7420 7061 7274 2c20 7468 6520 most part, the │ │ │ │ +0000aa40: 7361 6d65 2061 7320 696e 2074 6865 204e same as in the N │ │ │ │ +0000aa50: 6574 4253 4420 626f 6f74 206c 6f61 6465 etBSD boot loade │ │ │ │ +0000aa60: 722e 2020 466f 720a 2020 2020 2069 6e73 r. For. ins │ │ │ │ +0000aa70: 7461 6e63 652c 2074 6f20 626f 6f74 2074 tance, to boot t │ │ │ │ +0000aa80: 6865 2073 7973 7465 6d20 696e 2073 696e he system in sin │ │ │ │ +0000aa90: 676c 652d 7573 6572 206d 6f64 6520 616e gle-user mode an │ │ │ │ +0000aaa0: 6420 7769 7468 2076 6572 626f 7365 0a20 d with verbose. │ │ │ │ +0000aab0: 2020 2020 6d65 7373 6167 6573 2c20 646f messages, do │ │ │ │ +0000aac0: 2074 6869 733a 0a0a 2020 2020 2020 2020 this:.. │ │ │ │ +0000aad0: 2020 6772 7562 3e20 6b6e 6574 6273 6420 grub> knetbsd │ │ │ │ +0000aae0: 2f6e 6574 6273 6420 2d73 202d 760a 0a20 /netbsd -s -v.. │ │ │ │ +0000aaf0: 2033 2e20 4966 206e 6565 6465 642c 206c 3. If needed, l │ │ │ │ +0000ab00: 6f61 6420 6b65 726e 656c 206d 6f64 756c oad kernel modul │ │ │ │ +0000ab10: 6573 2077 6974 6820 7468 6520 636f 6d6d es with the comm │ │ │ │ +0000ab20: 616e 640a 2020 2020 2027 6b6e 6574 6273 and. 'knetbs │ │ │ │ +0000ab30: 645f 6d6f 6475 6c65 5f65 6c66 272e 2020 d_module_elf'. │ │ │ │ +0000ab40: 4120 7479 7069 6361 6c20 6578 616d 706c A typical exampl │ │ │ │ +0000ab50: 6520 6973 2074 6865 206d 6f64 756c 6520 e is the module │ │ │ │ +0000ab60: 666f 7220 7468 6520 726f 6f74 0a20 2020 for the root. │ │ │ │ +0000ab70: 2020 6669 6c65 2073 7973 7465 6d3a 0a0a file system:.. │ │ │ │ +0000ab80: 2020 2020 2020 2020 2020 6772 7562 3e20 grub> │ │ │ │ +0000ab90: 6b6e 6574 6273 645f 6d6f 6475 6c65 5f65 knetbsd_module_e │ │ │ │ +0000aba0: 6c66 202f 7374 616e 642f 616d 6436 342f lf /stand/amd64/ │ │ │ │ +0000abb0: 362e 302f 6d6f 6475 6c65 732f 6666 732f 6.0/modules/ffs/ │ │ │ │ +0000abc0: 6666 732e 6b6d 6f64 0a0a 2020 342e 2046 ffs.kmod.. 4. F │ │ │ │ +0000abd0: 696e 616c 6c79 2c20 7275 6e20 7468 6520 inally, run the │ │ │ │ +0000abe0: 636f 6d6d 616e 6420 2762 6f6f 7427 2028 command 'boot' ( │ │ │ │ +0000abf0: 2a6e 6f74 6520 626f 6f74 3a3a 292e 0a0a *note boot::)... │ │ │ │ +0000ac00: 1f0a 4669 6c65 3a20 6772 7562 2e69 6e66 ..File: grub.inf │ │ │ │ +0000ac10: 6f2c 2020 4e6f 6465 3a20 444f 532f 5769 o, Node: DOS/Wi │ │ │ │ +0000ac20: 6e64 6f77 732c 2020 5072 6576 3a20 4e65 ndows, Prev: Ne │ │ │ │ +0000ac30: 7442 5344 2c20 2055 703a 204f 532d 7370 tBSD, Up: OS-sp │ │ │ │ +0000ac40: 6563 6966 6963 206e 6f74 6573 0a0a 352e ecific notes..5. │ │ │ │ +0000ac50: 332e 3420 444f 532f 5769 6e64 6f77 730a 3.4 DOS/Windows. │ │ │ │ +0000ac60: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ +0000ac70: 2d0a 0a47 5255 4220 6361 6e6e 6f74 2062 -..GRUB cannot b │ │ │ │ +0000ac80: 6f6f 7420 444f 5320 6f72 2057 696e 646f oot DOS or Windo │ │ │ │ +0000ac90: 7773 2064 6972 6563 746c 792c 2073 6f20 ws directly, so │ │ │ │ +0000aca0: 796f 7520 6d75 7374 2063 6861 696e 2d6c you must chain-l │ │ │ │ +0000acb0: 6f61 6420 7468 656d 0a28 2a6e 6f74 6520 oad them.(*note │ │ │ │ +0000acc0: 4368 6169 6e2d 6c6f 6164 696e 673a 3a29 Chain-loading::) │ │ │ │ +0000acd0: 2e20 2048 6f77 6576 6572 2c20 7468 6569 . However, thei │ │ │ │ +0000ace0: 7220 626f 6f74 206c 6f61 6465 7273 2068 r boot loaders h │ │ │ │ +0000acf0: 6176 6520 736f 6d65 2063 7269 7469 6361 ave some critica │ │ │ │ +0000ad00: 6c0a 6465 6669 6369 656e 6369 6573 2c20 l.deficiencies, │ │ │ │ +0000ad10: 736f 2069 7420 6d61 7920 6e6f 7420 776f so it may not wo │ │ │ │ +0000ad20: 726b 2074 6f20 6a75 7374 2063 6861 696e rk to just chain │ │ │ │ +0000ad30: 2d6c 6f61 6420 7468 656d 2e20 2054 6f20 -load them. To │ │ │ │ +0000ad40: 6f76 6572 636f 6d65 0a74 6865 2070 726f overcome.the pro │ │ │ │ +0000ad50: 626c 656d 732c 2047 5255 4220 7072 6f76 blems, GRUB prov │ │ │ │ +0000ad60: 6964 6573 2079 6f75 2077 6974 6820 7477 ides you with tw │ │ │ │ +0000ad70: 6f20 6865 6c70 6572 2066 756e 6374 696f o helper functio │ │ │ │ +0000ad80: 6e73 2e0a 0a20 2020 4966 2079 6f75 2068 ns... If you h │ │ │ │ +0000ad90: 6176 6520 696e 7374 616c 6c65 6420 444f ave installed DO │ │ │ │ +0000ada0: 5320 286f 7220 5769 6e64 6f77 7329 206f S (or Windows) o │ │ │ │ +0000adb0: 6e20 6120 6e6f 6e2d 6669 7273 7420 6861 n a non-first ha │ │ │ │ +0000adc0: 7264 2064 6973 6b2c 2079 6f75 0a68 6176 rd disk, you.hav │ │ │ │ +0000add0: 6520 746f 2075 7365 2074 6865 2064 6973 e to use the dis │ │ │ │ +0000ade0: 6b20 7377 6170 7069 6e67 2074 6563 686e k swapping techn │ │ │ │ +0000adf0: 6971 7565 2c20 6265 6361 7573 6520 7468 ique, because th │ │ │ │ +0000ae00: 6174 204f 5320 6361 6e6e 6f74 2062 6f6f at OS cannot boo │ │ │ │ +0000ae10: 740a 6672 6f6d 2061 6e79 2064 6973 6b73 t.from any disks │ │ │ │ +0000ae20: 2062 7574 2074 6865 2066 6972 7374 206f but the first o │ │ │ │ +0000ae30: 6e65 2e20 2054 6865 2077 6f72 6b61 726f ne. The workaro │ │ │ │ +0000ae40: 756e 6420 7573 6564 2069 6e20 4752 5542 und used in GRUB │ │ │ │ +0000ae50: 2069 7320 7468 650a 636f 6d6d 616e 6420 is the.command │ │ │ │ +0000ae60: 2764 7269 7665 6d61 7027 2028 2a6e 6f74 'drivemap' (*not │ │ │ │ +0000ae70: 6520 6472 6976 656d 6170 3a3a 292c 206c e drivemap::), l │ │ │ │ +0000ae80: 696b 6520 7468 6973 3a0a 0a20 2020 2020 ike this:.. │ │ │ │ +0000ae90: 6472 6976 656d 6170 202d 7320 2868 6430 drivemap -s (hd0 │ │ │ │ +0000aea0: 2920 2868 6431 290a 0a20 2020 5468 6973 ) (hd1).. This │ │ │ │ +0000aeb0: 2070 6572 666f 726d 7320 6120 2276 6972 performs a "vir │ │ │ │ +0000aec0: 7475 616c 2220 7377 6170 2062 6574 7765 tual" swap betwe │ │ │ │ +0000aed0: 656e 2079 6f75 7220 6669 7273 7420 616e en your first an │ │ │ │ +0000aee0: 6420 7365 636f 6e64 2068 6172 640a 6472 d second hard.dr │ │ │ │ +0000aef0: 6976 652e 0a0a 2020 202a 4361 7574 696f ive... *Cautio │ │ │ │ +0000af00: 6e3a 2a20 5468 6973 2069 7320 6566 6665 n:* This is effe │ │ │ │ +0000af10: 6374 6976 6520 6f6e 6c79 2069 6620 444f ctive only if DO │ │ │ │ +0000af20: 5320 286f 7220 5769 6e64 6f77 7329 2075 S (or Windows) u │ │ │ │ +0000af30: 7365 7320 4249 4f53 2074 6f0a 6163 6365 ses BIOS to.acce │ │ │ │ +0000af40: 7373 2074 6865 2073 7761 7070 6564 2064 ss the swapped d │ │ │ │ +0000af50: 6973 6b73 2e20 2049 6620 7468 6174 204f isks. If that O │ │ │ │ +0000af60: 5320 7573 6573 2061 2073 7065 6369 616c S uses a special │ │ │ │ +0000af70: 2064 7269 7665 7220 666f 7220 7468 650a driver for the. │ │ │ │ +0000af80: 6469 736b 732c 2074 6869 7320 7072 6f62 disks, this prob │ │ │ │ +0000af90: 6162 6c79 2077 6f6e 2774 2077 6f72 6b2e ably won't work. │ │ │ │ +0000afa0: 0a0a 2020 2041 6e6f 7468 6572 2070 726f .. Another pro │ │ │ │ +0000afb0: 626c 656d 2061 7269 7365 7320 6966 2079 blem arises if y │ │ │ │ +0000afc0: 6f75 2069 6e73 7461 6c6c 6564 206d 6f72 ou installed mor │ │ │ │ +0000afd0: 6520 7468 616e 206f 6e65 2073 6574 206f e than one set o │ │ │ │ +0000afe0: 660a 444f 532f 5769 6e64 6f77 7320 6f6e f.DOS/Windows on │ │ │ │ +0000aff0: 746f 206f 6e65 2064 6973 6b2c 2062 6563 to one disk, bec │ │ │ │ +0000b000: 6175 7365 2074 6865 7920 636f 756c 6420 ause they could │ │ │ │ +0000b010: 6265 2063 6f6e 6675 7365 6420 6966 2074 be confused if t │ │ │ │ +0000b020: 6865 7265 2061 7265 0a6d 6f72 6520 7468 here are.more th │ │ │ │ +0000b030: 616e 206f 6e65 2070 7269 6d61 7279 2070 an one primary p │ │ │ │ +0000b040: 6172 7469 7469 6f6e 7320 666f 7220 444f artitions for DO │ │ │ │ +0000b050: 532f 5769 6e64 6f77 732e 2020 4365 7274 S/Windows. Cert │ │ │ │ +0000b060: 6169 6e6c 7920 796f 7520 7368 6f75 6c64 ainly you should │ │ │ │ +0000b070: 0a61 766f 6964 2064 6f69 6e67 2074 6869 .avoid doing thi │ │ │ │ +0000b080: 732c 2062 7574 2074 6865 7265 2069 7320 s, but there is │ │ │ │ +0000b090: 6120 736f 6c75 7469 6f6e 2069 6620 796f a solution if yo │ │ │ │ +0000b0a0: 7520 646f 2077 616e 7420 746f 2064 6f20 u do want to do │ │ │ │ +0000b0b0: 736f 2e20 2055 7365 0a74 6865 2070 6172 so. Use.the par │ │ │ │ +0000b0c0: 7469 7469 6f6e 2068 6964 696e 672f 756e tition hiding/un │ │ │ │ +0000b0d0: 6869 6469 6e67 2074 6563 686e 6971 7565 hiding technique │ │ │ │ +0000b0e0: 2e0a 0a20 2020 4966 2047 5255 4220 2268 ... If GRUB "h │ │ │ │ +0000b0f0: 6964 6573 2220 6120 444f 5320 286f 7220 ides" a DOS (or │ │ │ │ +0000b100: 5769 6e64 6f77 7329 2070 6172 7469 7469 Windows) partiti │ │ │ │ +0000b110: 6f6e 2028 2a6e 6f74 6520 7061 7274 746f on (*note partto │ │ │ │ +0000b120: 6f6c 3a3a 292c 2044 4f53 0a28 6f72 2057 ol::), DOS.(or W │ │ │ │ +0000b130: 696e 646f 7773 2920 7769 6c6c 2069 676e indows) will ign │ │ │ │ +0000b140: 6f72 6520 7468 6520 7061 7274 6974 696f ore the partitio │ │ │ │ +0000b150: 6e2e 2020 4966 2047 5255 4220 2275 6e68 n. If GRUB "unh │ │ │ │ +0000b160: 6964 6573 2220 6120 444f 5320 286f 720a ides" a DOS (or. │ │ │ │ +0000b170: 5769 6e64 6f77 7329 2070 6172 7469 7469 Windows) partiti │ │ │ │ +0000b180: 6f6e 2c20 444f 5320 286f 7220 5769 6e64 on, DOS (or Wind │ │ │ │ +0000b190: 6f77 7329 2077 696c 6c20 6465 7465 6374 ows) will detect │ │ │ │ +0000b1a0: 2074 6865 2070 6172 7469 7469 6f6e 2e20 the partition. │ │ │ │ +0000b1b0: 2054 6875 732c 0a69 6620 796f 7520 6861 Thus,.if you ha │ │ │ │ +0000b1c0: 7665 2069 6e73 7461 6c6c 6564 2044 4f53 ve installed DOS │ │ │ │ +0000b1d0: 2028 6f72 2057 696e 646f 7773 2920 6f6e (or Windows) on │ │ │ │ +0000b1e0: 2074 6865 2066 6972 7374 2061 6e64 2074 the first and t │ │ │ │ +0000b1f0: 6865 2073 6563 6f6e 640a 7061 7274 6974 he second.partit │ │ │ │ +0000b200: 696f 6e20 6f66 2074 6865 2066 6972 7374 ion of the first │ │ │ │ +0000b210: 2068 6172 6420 6469 736b 2c20 616e 6420 hard disk, and │ │ │ │ +0000b220: 796f 7520 7761 6e74 2074 6f20 626f 6f74 you want to boot │ │ │ │ +0000b230: 2074 6865 2063 6f70 7920 6f6e 2074 6865 the copy on the │ │ │ │ +0000b240: 0a66 6972 7374 2070 6172 7469 7469 6f6e .first partition │ │ │ │ +0000b250: 2c20 646f 2074 6865 2066 6f6c 6c6f 7769 , do the followi │ │ │ │ +0000b260: 6e67 3a0a 0a20 2020 2020 7061 7274 746f ng:.. partto │ │ │ │ +0000b270: 6f6c 2028 6864 302c 3129 2068 6964 6465 ol (hd0,1) hidde │ │ │ │ +0000b280: 6e2d 0a20 2020 2020 7061 7274 746f 6f6c n-. parttool │ │ │ │ +0000b290: 2028 6864 302c 3229 2068 6964 6465 6e2b (hd0,2) hidden+ │ │ │ │ +0000b2a0: 0a20 2020 2020 7365 7420 726f 6f74 3d28 . set root=( │ │ │ │ +0000b2b0: 6864 302c 3129 0a20 2020 2020 6368 6169 hd0,1). chai │ │ │ │ +0000b2c0: 6e6c 6f61 6465 7220 2b31 0a20 2020 2020 nloader +1. │ │ │ │ +0000b2d0: 7061 7274 746f 6f6c 2024 7b72 6f6f 747d parttool ${root} │ │ │ │ +0000b2e0: 2062 6f6f 742b 0a20 2020 2020 626f 6f74 boot+. boot │ │ │ │ +0000b2f0: 0a0a 1f0a 4669 6c65 3a20 6772 7562 2e69 ....File: grub.i │ │ │ │ +0000b300: 6e66 6f2c 2020 4e6f 6465 3a20 436f 6e66 nfo, Node: Conf │ │ │ │ +0000b310: 6967 7572 6174 696f 6e2c 2020 4e65 7874 iguration, Next │ │ │ │ +0000b320: 3a20 5468 656d 6520 6669 6c65 2066 6f72 : Theme file for │ │ │ │ +0000b330: 6d61 742c 2020 5072 6576 3a20 426f 6f74 mat, Prev: Boot │ │ │ │ +0000b340: 696e 672c 2020 5570 3a20 546f 700a 0a36 ing, Up: Top..6 │ │ │ │ +0000b350: 2057 7269 7469 6e67 2079 6f75 7220 6f77 Writing your ow │ │ │ │ +0000b360: 6e20 636f 6e66 6967 7572 6174 696f 6e20 n configuration │ │ │ │ +0000b370: 6669 6c65 0a2a 2a2a 2a2a 2a2a 2a2a 2a2a file.*********** │ │ │ │ 0000b380: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ -0000b390: 2a2a 2a2a 2a2a 0a0a 4752 5542 2069 7320 ******..GRUB is │ │ │ │ -0000b3a0: 636f 6e66 6967 7572 6564 2075 7369 6e67 configured using │ │ │ │ -0000b3b0: 2027 6772 7562 2e63 6667 272c 2075 7375 'grub.cfg', usu │ │ │ │ -0000b3c0: 616c 6c79 206c 6f63 6174 6564 2075 6e64 ally located und │ │ │ │ -0000b3d0: 6572 2027 2f62 6f6f 742f 6772 7562 272e er '/boot/grub'. │ │ │ │ -0000b3e0: 0a54 6869 7320 6669 6c65 2069 7320 7175 .This file is qu │ │ │ │ -0000b3f0: 6974 6520 666c 6578 6962 6c65 2c20 6275 ite flexible, bu │ │ │ │ -0000b400: 7420 6d6f 7374 2075 7365 7273 2077 696c t most users wil │ │ │ │ -0000b410: 6c20 6e6f 7420 6e65 6564 2074 6f20 7772 l not need to wr │ │ │ │ -0000b420: 6974 6520 7468 650a 7768 6f6c 6520 7468 ite the.whole th │ │ │ │ -0000b430: 696e 6720 6279 2068 616e 642e 0a0a 2a20 ing by hand...* │ │ │ │ -0000b440: 4d65 6e75 3a0a 0a2a 2053 696d 706c 6520 Menu:..* Simple │ │ │ │ -0000b450: 636f 6e66 6967 7572 6174 696f 6e3a 3a20 configuration:: │ │ │ │ -0000b460: 2020 2020 2020 2020 2020 2052 6563 6f6d Recom │ │ │ │ -0000b470: 6d65 6e64 6564 2066 6f72 206d 6f73 7420 mended for most │ │ │ │ -0000b480: 7573 6572 730a 2a20 526f 6f74 2049 6465 users.* Root Ide │ │ │ │ -0000b490: 6e74 6966 6361 7469 6f6e 2048 6575 7269 ntifcation Heuri │ │ │ │ -0000b4a0: 7374 6963 733a 3a20 2020 5375 6d6d 6172 stics:: Summar │ │ │ │ -0000b4b0: 7920 6f6e 2068 6f77 2074 6865 2072 6f6f y on how the roo │ │ │ │ -0000b4c0: 7420 6669 6c65 2073 7973 7465 6d20 6973 t file system is │ │ │ │ -0000b4d0: 2069 6465 6e74 6966 6965 642e 0a2a 2053 identified..* S │ │ │ │ -0000b4e0: 6865 6c6c 2d6c 696b 6520 7363 7269 7074 hell-like script │ │ │ │ -0000b4f0: 696e 673a 3a20 2020 2020 2020 2020 2020 ing:: │ │ │ │ -0000b500: 2046 6f72 2070 6f77 6572 2075 7365 7273 For power users │ │ │ │ -0000b510: 2061 6e64 2064 6576 656c 6f70 6572 730a and developers. │ │ │ │ -0000b520: 2a20 4d75 6c74 692d 626f 6f74 206d 616e * Multi-boot man │ │ │ │ -0000b530: 7561 6c20 636f 6e66 6967 3a3a 2020 2020 ual config:: │ │ │ │ -0000b540: 2020 2020 466f 7220 6e6f 6e2d 7374 616e For non-stan │ │ │ │ -0000b550: 6461 7264 206d 756c 7469 2d4f 5320 7363 dard multi-OS sc │ │ │ │ -0000b560: 656e 6172 696f 730a 2a20 456d 6265 6464 enarios.* Embedd │ │ │ │ -0000b570: 6564 2063 6f6e 6669 6775 7261 7469 6f6e ed configuration │ │ │ │ -0000b580: 3a3a 2020 2020 2020 2020 2020 456d 6265 :: Embe │ │ │ │ -0000b590: 6464 696e 6720 6120 636f 6e66 6967 7572 dding a configur │ │ │ │ -0000b5a0: 6174 696f 6e20 6669 6c65 2069 6e74 6f20 ation file into │ │ │ │ -0000b5b0: 4752 5542 0a0a 1f0a 4669 6c65 3a20 6772 GRUB....File: gr │ │ │ │ -0000b5c0: 7562 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ub.info, Node: │ │ │ │ -0000b5d0: 5369 6d70 6c65 2063 6f6e 6669 6775 7261 Simple configura │ │ │ │ -0000b5e0: 7469 6f6e 2c20 204e 6578 743a 2052 6f6f tion, Next: Roo │ │ │ │ -0000b5f0: 7420 4964 656e 7469 6663 6174 696f 6e20 t Identifcation │ │ │ │ -0000b600: 4865 7572 6973 7469 6373 2c20 2055 703a Heuristics, Up: │ │ │ │ -0000b610: 2043 6f6e 6669 6775 7261 7469 6f6e 0a0a Configuration.. │ │ │ │ -0000b620: 362e 3120 5369 6d70 6c65 2063 6f6e 6669 6.1 Simple confi │ │ │ │ -0000b630: 6775 7261 7469 6f6e 2068 616e 646c 696e guration handlin │ │ │ │ -0000b640: 670a 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d g.============== │ │ │ │ +0000b390: 2a2a 2a2a 2a2a 2a2a 2a2a 0a0a 4752 5542 **********..GRUB │ │ │ │ +0000b3a0: 2069 7320 636f 6e66 6967 7572 6564 2075 is configured u │ │ │ │ +0000b3b0: 7369 6e67 2027 6772 7562 2e63 6667 272c sing 'grub.cfg', │ │ │ │ +0000b3c0: 2075 7375 616c 6c79 206c 6f63 6174 6564 usually located │ │ │ │ +0000b3d0: 2075 6e64 6572 2027 2f62 6f6f 742f 6772 under '/boot/gr │ │ │ │ +0000b3e0: 7562 272e 0a54 6869 7320 6669 6c65 2069 ub'..This file i │ │ │ │ +0000b3f0: 7320 7175 6974 6520 666c 6578 6962 6c65 s quite flexible │ │ │ │ +0000b400: 2c20 6275 7420 6d6f 7374 2075 7365 7273 , but most users │ │ │ │ +0000b410: 2077 696c 6c20 6e6f 7420 6e65 6564 2074 will not need t │ │ │ │ +0000b420: 6f20 7772 6974 6520 7468 650a 7768 6f6c o write the.whol │ │ │ │ +0000b430: 6520 7468 696e 6720 6279 2068 616e 642e e thing by hand. │ │ │ │ +0000b440: 0a0a 2a20 4d65 6e75 3a0a 0a2a 2053 696d ..* Menu:..* Sim │ │ │ │ +0000b450: 706c 6520 636f 6e66 6967 7572 6174 696f ple configuratio │ │ │ │ +0000b460: 6e3a 3a20 2020 2020 2020 2020 2020 2052 n:: R │ │ │ │ +0000b470: 6563 6f6d 6d65 6e64 6564 2066 6f72 206d ecommended for m │ │ │ │ +0000b480: 6f73 7420 7573 6572 730a 2a20 526f 6f74 ost users.* Root │ │ │ │ +0000b490: 2049 6465 6e74 6966 6361 7469 6f6e 2048 Identifcation H │ │ │ │ +0000b4a0: 6575 7269 7374 6963 733a 3a20 2020 5375 euristics:: Su │ │ │ │ +0000b4b0: 6d6d 6172 7920 6f6e 2068 6f77 2074 6865 mmary on how the │ │ │ │ +0000b4c0: 2072 6f6f 7420 6669 6c65 2073 7973 7465 root file syste │ │ │ │ +0000b4d0: 6d20 6973 2069 6465 6e74 6966 6965 642e m is identified. │ │ │ │ +0000b4e0: 0a2a 2053 6865 6c6c 2d6c 696b 6520 7363 .* Shell-like sc │ │ │ │ +0000b4f0: 7269 7074 696e 673a 3a20 2020 2020 2020 ripting:: │ │ │ │ +0000b500: 2020 2020 2046 6f72 2070 6f77 6572 2075 For power u │ │ │ │ +0000b510: 7365 7273 2061 6e64 2064 6576 656c 6f70 sers and develop │ │ │ │ +0000b520: 6572 730a 2a20 4d75 6c74 692d 626f 6f74 ers.* Multi-boot │ │ │ │ +0000b530: 206d 616e 7561 6c20 636f 6e66 6967 3a3a manual config:: │ │ │ │ +0000b540: 2020 2020 2020 2020 466f 7220 6e6f 6e2d For non- │ │ │ │ +0000b550: 7374 616e 6461 7264 206d 756c 7469 2d4f standard multi-O │ │ │ │ +0000b560: 5320 7363 656e 6172 696f 730a 2a20 456d S scenarios.* Em │ │ │ │ +0000b570: 6265 6464 6564 2063 6f6e 6669 6775 7261 bedded configura │ │ │ │ +0000b580: 7469 6f6e 3a3a 2020 2020 2020 2020 2020 tion:: │ │ │ │ +0000b590: 456d 6265 6464 696e 6720 6120 636f 6e66 Embedding a conf │ │ │ │ +0000b5a0: 6967 7572 6174 696f 6e20 6669 6c65 2069 iguration file i │ │ │ │ +0000b5b0: 6e74 6f20 4752 5542 0a0a 1f0a 4669 6c65 nto GRUB....File │ │ │ │ +0000b5c0: 3a20 6772 7562 2e69 6e66 6f2c 2020 4e6f : grub.info, No │ │ │ │ +0000b5d0: 6465 3a20 5369 6d70 6c65 2063 6f6e 6669 de: Simple confi │ │ │ │ +0000b5e0: 6775 7261 7469 6f6e 2c20 204e 6578 743a guration, Next: │ │ │ │ +0000b5f0: 2052 6f6f 7420 4964 656e 7469 6663 6174 Root Identifcat │ │ │ │ +0000b600: 696f 6e20 4865 7572 6973 7469 6373 2c20 ion Heuristics, │ │ │ │ +0000b610: 2055 703a 2043 6f6e 6669 6775 7261 7469 Up: Configurati │ │ │ │ +0000b620: 6f6e 0a0a 362e 3120 5369 6d70 6c65 2063 on..6.1 Simple c │ │ │ │ +0000b630: 6f6e 6669 6775 7261 7469 6f6e 2068 616e onfiguration han │ │ │ │ +0000b640: 646c 696e 670a 3d3d 3d3d 3d3d 3d3d 3d3d dling.========== │ │ │ │ 0000b650: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ -0000b660: 3d3d 3d0a 0a54 6865 2070 726f 6772 616d ===..The program │ │ │ │ -0000b670: 2027 6772 7562 2d6d 6b63 6f6e 6669 6727 'grub-mkconfig' │ │ │ │ -0000b680: 2028 2a6e 6f74 6520 496e 766f 6b69 6e67 (*note Invoking │ │ │ │ -0000b690: 2067 7275 622d 6d6b 636f 6e66 6967 3a3a grub-mkconfig:: │ │ │ │ -0000b6a0: 2920 6765 6e65 7261 7465 730a 2767 7275 ) generates.'gru │ │ │ │ -0000b6b0: 622e 6366 6727 2066 696c 6573 2073 7569 b.cfg' files sui │ │ │ │ -0000b6c0: 7461 626c 6520 666f 7220 6d6f 7374 2063 table for most c │ │ │ │ -0000b6d0: 6173 6573 2e20 2049 7420 6973 2073 7569 ases. It is sui │ │ │ │ -0000b6e0: 7461 626c 6520 666f 7220 7573 6520 7768 table for use wh │ │ │ │ -0000b6f0: 656e 0a75 7067 7261 6469 6e67 2061 2064 en.upgrading a d │ │ │ │ -0000b700: 6973 7472 6962 7574 696f 6e2c 2061 6e64 istribution, and │ │ │ │ -0000b710: 2077 696c 6c20 6469 7363 6f76 6572 2061 will discover a │ │ │ │ -0000b720: 7661 696c 6162 6c65 206b 6572 6e65 6c73 vailable kernels │ │ │ │ -0000b730: 2061 6e64 0a61 7474 656d 7074 2074 6f20 and.attempt to │ │ │ │ -0000b740: 6765 6e65 7261 7465 206d 656e 7520 656e generate menu en │ │ │ │ -0000b750: 7472 6965 7320 666f 7220 7468 656d 2e0a tries for them.. │ │ │ │ -0000b760: 0a20 2020 2767 7275 622d 6d6b 636f 6e66 . 'grub-mkconf │ │ │ │ -0000b770: 6967 2720 646f 6573 2068 6176 6520 736f ig' does have so │ │ │ │ -0000b780: 6d65 206c 696d 6974 6174 696f 6e73 2e20 me limitations. │ │ │ │ -0000b790: 2057 6869 6c65 2061 6464 696e 6720 6578 While adding ex │ │ │ │ -0000b7a0: 7472 610a 6375 7374 6f6d 206d 656e 7520 tra.custom menu │ │ │ │ -0000b7b0: 656e 7472 6965 7320 746f 2074 6865 2065 entries to the e │ │ │ │ -0000b7c0: 6e64 206f 6620 7468 6520 6c69 7374 2063 nd of the list c │ │ │ │ -0000b7d0: 616e 2062 6520 646f 6e65 2062 7920 6564 an be done by ed │ │ │ │ -0000b7e0: 6974 696e 670a 272f 6574 632f 6772 7562 iting.'/etc/grub │ │ │ │ -0000b7f0: 2e64 2f34 305f 6375 7374 6f6d 2720 6f72 .d/40_custom' or │ │ │ │ -0000b800: 2063 7265 6174 696e 6720 272f 626f 6f74 creating '/boot │ │ │ │ -0000b810: 2f67 7275 622f 6375 7374 6f6d 2e63 6667 /grub/custom.cfg │ │ │ │ -0000b820: 272c 2063 6861 6e67 696e 670a 7468 6520 ', changing.the │ │ │ │ -0000b830: 6f72 6465 7220 6f66 206d 656e 7520 656e order of menu en │ │ │ │ -0000b840: 7472 6965 7320 6f72 2063 6861 6e67 696e tries or changin │ │ │ │ -0000b850: 6720 7468 6569 7220 7469 746c 6573 206d g their titles m │ │ │ │ -0000b860: 6179 2072 6571 7569 7265 206d 616b 696e ay require makin │ │ │ │ -0000b870: 670a 636f 6d70 6c65 7820 6368 616e 6765 g.complex change │ │ │ │ -0000b880: 7320 746f 2073 6865 6c6c 2073 6372 6970 s to shell scrip │ │ │ │ -0000b890: 7473 2073 746f 7265 6420 696e 2027 2f65 ts stored in '/e │ │ │ │ -0000b8a0: 7463 2f67 7275 622e 642f 272e 2020 5468 tc/grub.d/'. Th │ │ │ │ -0000b8b0: 6973 206d 6179 2062 650a 696d 7072 6f76 is may be.improv │ │ │ │ -0000b8c0: 6564 2069 6e20 7468 6520 6675 7475 7265 ed in the future │ │ │ │ -0000b8d0: 2e20 2049 6e20 7468 6520 6d65 616e 7469 . In the meanti │ │ │ │ -0000b8e0: 6d65 2c20 7468 6f73 6520 7768 6f20 6665 me, those who fe │ │ │ │ -0000b8f0: 656c 2074 6861 7420 6974 2077 6f75 6c64 el that it would │ │ │ │ -0000b900: 0a62 6520 6561 7369 6572 2074 6f20 7772 .be easier to wr │ │ │ │ -0000b910: 6974 6520 2767 7275 622e 6366 6727 2064 ite 'grub.cfg' d │ │ │ │ -0000b920: 6972 6563 746c 7920 6172 6520 656e 636f irectly are enco │ │ │ │ -0000b930: 7572 6167 6564 2074 6f20 646f 2073 6f20 uraged to do so │ │ │ │ -0000b940: 282a 6e6f 7465 0a42 6f6f 7469 6e67 3a3a (*note.Booting:: │ │ │ │ -0000b950: 2c20 616e 6420 2a6e 6f74 6520 5368 656c , and *note Shel │ │ │ │ -0000b960: 6c2d 6c69 6b65 2073 6372 6970 7469 6e67 l-like scripting │ │ │ │ -0000b970: 3a3a 292c 2061 6e64 2074 6f20 6469 7361 ::), and to disa │ │ │ │ -0000b980: 626c 6520 616e 7920 7379 7374 656d 0a70 ble any system.p │ │ │ │ -0000b990: 726f 7669 6465 6420 6279 2074 6865 6972 rovided by their │ │ │ │ -0000b9a0: 2064 6973 7472 6962 7574 696f 6e20 746f distribution to │ │ │ │ -0000b9b0: 2061 7574 6f6d 6174 6963 616c 6c79 2072 automatically r │ │ │ │ -0000b9c0: 756e 2027 6772 7562 2d6d 6b63 6f6e 6669 un 'grub-mkconfi │ │ │ │ -0000b9d0: 6727 2e0a 0a20 2020 5468 6520 6669 6c65 g'... The file │ │ │ │ -0000b9e0: 2027 2f65 7463 2f64 6566 6175 6c74 2f67 '/etc/default/g │ │ │ │ -0000b9f0: 7275 6227 2063 6f6e 7472 6f6c 7320 7468 rub' controls th │ │ │ │ -0000ba00: 6520 6f70 6572 6174 696f 6e20 6f66 0a27 e operation of.' │ │ │ │ -0000ba10: 6772 7562 2d6d 6b63 6f6e 6669 6727 2e20 grub-mkconfig'. │ │ │ │ -0000ba20: 2049 7420 6973 2073 6f75 7263 6564 2062 It is sourced b │ │ │ │ -0000ba30: 7920 6120 7368 656c 6c20 7363 7269 7074 y a shell script │ │ │ │ -0000ba40: 2c20 616e 6420 736f 206d 7573 7420 6265 , and so must be │ │ │ │ -0000ba50: 2076 616c 6964 0a50 4f53 4958 2073 6865 valid.POSIX she │ │ │ │ -0000ba60: 6c6c 2069 6e70 7574 3b20 6e6f 726d 616c ll input; normal │ │ │ │ -0000ba70: 6c79 2c20 6974 2077 696c 6c20 6a75 7374 ly, it will just │ │ │ │ -0000ba80: 2062 6520 6120 7365 7175 656e 6365 206f be a sequence o │ │ │ │ -0000ba90: 6620 274b 4559 3d76 616c 7565 270a 6c69 f 'KEY=value'.li │ │ │ │ -0000baa0: 6e65 732c 2062 7574 2069 6620 7468 6520 nes, but if the │ │ │ │ -0000bab0: 7661 6c75 6520 636f 6e74 6169 6e73 2073 value contains s │ │ │ │ -0000bac0: 7061 6365 7320 6f72 206f 7468 6572 2073 paces or other s │ │ │ │ -0000bad0: 7065 6369 616c 2063 6861 7261 6374 6572 pecial character │ │ │ │ -0000bae0: 7320 7468 656e 0a69 7420 6d75 7374 2062 s then.it must b │ │ │ │ -0000baf0: 6520 7175 6f74 6564 2e20 2046 6f72 2065 e quoted. For e │ │ │ │ -0000bb00: 7861 6d70 6c65 3a0a 0a20 2020 2020 4752 xample:.. GR │ │ │ │ -0000bb10: 5542 5f54 4552 4d49 4e41 4c5f 494e 5055 UB_TERMINAL_INPU │ │ │ │ -0000bb20: 543d 2263 6f6e 736f 6c65 2073 6572 6961 T="console seria │ │ │ │ -0000bb30: 6c22 0a0a 2020 2056 616c 6964 206b 6579 l".. Valid key │ │ │ │ -0000bb40: 7320 696e 2027 2f65 7463 2f64 6566 6175 s in '/etc/defau │ │ │ │ -0000bb50: 6c74 2f67 7275 6227 2061 7265 2061 7320 lt/grub' are as │ │ │ │ -0000bb60: 666f 6c6c 6f77 733a 0a0a 2747 5255 425f follows:..'GRUB_ │ │ │ │ -0000bb70: 4445 4641 554c 5427 0a20 2020 2020 5468 DEFAULT'. Th │ │ │ │ -0000bb80: 6520 6465 6661 756c 7420 6d65 6e75 2065 e default menu e │ │ │ │ -0000bb90: 6e74 7279 2e20 2054 6869 7320 6d61 7920 ntry. This may │ │ │ │ -0000bba0: 6265 2061 206e 756d 6265 722c 2069 6e20 be a number, in │ │ │ │ -0000bbb0: 7768 6963 6820 6361 7365 2069 740a 2020 which case it. │ │ │ │ -0000bbc0: 2020 2069 6465 6e74 6966 6965 7320 7468 identifies th │ │ │ │ -0000bbd0: 6520 4e74 6820 656e 7472 7920 696e 2074 e Nth entry in t │ │ │ │ -0000bbe0: 6865 2067 656e 6572 6174 6564 206d 656e he generated men │ │ │ │ -0000bbf0: 7520 636f 756e 7465 6420 6672 6f6d 207a u counted from z │ │ │ │ -0000bc00: 6572 6f2c 0a20 2020 2020 6f72 2074 6865 ero,. or the │ │ │ │ -0000bc10: 2074 6974 6c65 206f 6620 6120 6d65 6e75 title of a menu │ │ │ │ -0000bc20: 2065 6e74 7279 2c20 6f72 2074 6865 2073 entry, or the s │ │ │ │ -0000bc30: 7065 6369 616c 2073 7472 696e 6720 2773 pecial string 's │ │ │ │ -0000bc40: 6176 6564 272e 2020 5573 696e 670a 2020 aved'. Using. │ │ │ │ -0000bc50: 2020 2074 6865 2069 6420 6d61 7920 6265 the id may be │ │ │ │ -0000bc60: 2075 7365 6675 6c20 6966 2079 6f75 2077 useful if you w │ │ │ │ -0000bc70: 616e 7420 746f 2073 6574 2061 206d 656e ant to set a men │ │ │ │ -0000bc80: 7520 656e 7472 7920 6173 2074 6865 2064 u entry as the d │ │ │ │ -0000bc90: 6566 6175 6c74 0a20 2020 2020 6576 656e efault. even │ │ │ │ -0000bca0: 2074 686f 7567 6820 7468 6572 6520 6d61 though there ma │ │ │ │ -0000bcb0: 7920 6265 2061 2076 6172 6961 626c 6520 y be a variable │ │ │ │ -0000bcc0: 6e75 6d62 6572 206f 6620 656e 7472 6965 number of entrie │ │ │ │ -0000bcd0: 7320 6265 666f 7265 2069 742e 0a0a 2020 s before it... │ │ │ │ -0000bce0: 2020 2046 6f72 2065 7861 6d70 6c65 2c20 For example, │ │ │ │ -0000bcf0: 6966 2079 6f75 2068 6176 653a 0a0a 2020 if you have:.. │ │ │ │ -0000bd00: 2020 206d 656e 7565 6e74 7279 2027 4578 menuentry 'Ex │ │ │ │ -0000bd10: 616d 706c 6520 474e 552f 4c69 6e75 7820 ample GNU/Linux │ │ │ │ -0000bd20: 6469 7374 7269 6275 7469 6f6e 2720 2d2d distribution' -- │ │ │ │ -0000bd30: 636c 6173 7320 676e 752d 6c69 6e75 7820 class gnu-linux │ │ │ │ -0000bd40: 2d2d 6964 2065 7861 6d70 6c65 2d67 6e75 --id example-gnu │ │ │ │ -0000bd50: 2d6c 696e 7578 207b 0a20 2020 2020 092e -linux {. .. │ │ │ │ -0000bd60: 2e2e 0a20 2020 2020 7d0a 0a20 2020 2020 ... }.. │ │ │ │ -0000bd70: 7468 656e 2079 6f75 2063 616e 206d 616b then you can mak │ │ │ │ -0000bd80: 6520 7468 6973 2074 6865 2064 6566 6175 e this the defau │ │ │ │ -0000bd90: 6c74 2075 7369 6e67 3a0a 0a20 2020 2020 lt using:.. │ │ │ │ -0000bda0: 2020 2020 2047 5255 425f 4445 4641 554c GRUB_DEFAUL │ │ │ │ -0000bdb0: 543d 6578 616d 706c 652d 676e 752d 6c69 T=example-gnu-li │ │ │ │ -0000bdc0: 6e75 780a 0a20 2020 2020 5072 6576 696f nux.. Previo │ │ │ │ -0000bdd0: 7573 6c79 2069 7420 7761 7320 646f 6375 usly it was docu │ │ │ │ -0000bde0: 6d65 6e74 6564 2074 6865 2077 6179 2074 mented the way t │ │ │ │ -0000bdf0: 6f20 7573 6520 656e 7472 7920 7469 746c o use entry titl │ │ │ │ -0000be00: 652e 2020 5768 696c 650a 2020 2020 2074 e. While. t │ │ │ │ -0000be10: 6869 7320 7374 696c 6c20 776f 726b 7320 his still works │ │ │ │ -0000be20: 6974 2773 206e 6f74 2072 6563 6f6d 6d65 it's not recomme │ │ │ │ -0000be30: 6e64 6564 2073 696e 6365 2074 6974 6c65 nded since title │ │ │ │ -0000be40: 7320 6f66 7465 6e20 636f 6e74 6169 6e0a s often contain. │ │ │ │ -0000be50: 2020 2020 2075 6e73 7461 626c 6520 6465 unstable de │ │ │ │ -0000be60: 7669 6365 206e 616d 6573 2061 6e64 206d vice names and m │ │ │ │ -0000be70: 6179 2062 6520 7472 616e 736c 6174 6564 ay be translated │ │ │ │ -0000be80: 0a0a 2020 2020 2049 6620 796f 7520 7365 .. If you se │ │ │ │ -0000be90: 7420 7468 6973 2074 6f20 2773 6176 6564 t this to 'saved │ │ │ │ -0000bea0: 272c 2074 6865 6e20 7468 6520 6465 6661 ', then the defa │ │ │ │ -0000beb0: 756c 7420 6d65 6e75 2065 6e74 7279 2077 ult menu entry w │ │ │ │ -0000bec0: 696c 6c20 6265 0a20 2020 2020 7468 6174 ill be. that │ │ │ │ -0000bed0: 2073 6176 6564 2062 7920 2747 5255 425f saved by 'GRUB_ │ │ │ │ -0000bee0: 5341 5645 4445 4641 554c 5427 206f 7220 SAVEDEFAULT' or │ │ │ │ -0000bef0: 2767 7275 622d 7365 742d 6465 6661 756c 'grub-set-defaul │ │ │ │ -0000bf00: 7427 2e20 2054 6869 730a 2020 2020 2072 t'. This. r │ │ │ │ -0000bf10: 656c 6965 7320 6f6e 2074 6865 2065 6e76 elies on the env │ │ │ │ -0000bf20: 6972 6f6e 6d65 6e74 2062 6c6f 636b 2c20 ironment block, │ │ │ │ -0000bf30: 7768 6963 6820 6d61 7920 6e6f 7420 6265 which may not be │ │ │ │ -0000bf40: 2061 7661 696c 6162 6c65 2069 6e20 616c available in al │ │ │ │ -0000bf50: 6c0a 2020 2020 2073 6974 7561 7469 6f6e l. situation │ │ │ │ -0000bf60: 7320 282a 6e6f 7465 2045 6e76 6972 6f6e s (*note Environ │ │ │ │ -0000bf70: 6d65 6e74 2062 6c6f 636b 3a3a 292e 0a0a ment block::)... │ │ │ │ -0000bf80: 2020 2020 2054 6865 2064 6566 6175 6c74 The default │ │ │ │ -0000bf90: 2069 7320 2730 272e 0a0a 2747 5255 425f is '0'...'GRUB_ │ │ │ │ -0000bfa0: 5341 5645 4445 4641 554c 5427 0a20 2020 SAVEDEFAULT'. │ │ │ │ -0000bfb0: 2020 4966 2074 6869 7320 6f70 7469 6f6e If this option │ │ │ │ -0000bfc0: 2069 7320 7365 7420 746f 2027 7472 7565 is set to 'true │ │ │ │ -0000bfd0: 272c 2074 6865 6e2c 2077 6865 6e20 616e ', then, when an │ │ │ │ -0000bfe0: 2065 6e74 7279 2069 7320 7365 6c65 6374 entry is select │ │ │ │ -0000bff0: 6564 2c0a 2020 2020 2073 6176 6520 6974 ed,. save it │ │ │ │ -0000c000: 2061 7320 6120 6e65 7720 6465 6661 756c as a new defaul │ │ │ │ -0000c010: 7420 656e 7472 7920 666f 7220 7573 6520 t entry for use │ │ │ │ -0000c020: 6279 2066 7574 7572 6520 7275 6e73 206f by future runs o │ │ │ │ -0000c030: 6620 4752 5542 2e20 5468 6973 0a20 2020 f GRUB. This. │ │ │ │ -0000c040: 2020 6973 206f 6e6c 7920 7573 6566 756c is only useful │ │ │ │ -0000c050: 2069 6620 2747 5255 425f 4445 4641 554c if 'GRUB_DEFAUL │ │ │ │ -0000c060: 543d 7361 7665 6427 3b20 6974 2069 7320 T=saved'; it is │ │ │ │ -0000c070: 6120 7365 7061 7261 7465 206f 7074 696f a separate optio │ │ │ │ -0000c080: 6e0a 2020 2020 2062 6563 6175 7365 2027 n. because ' │ │ │ │ -0000c090: 4752 5542 5f44 4546 4155 4c54 3d73 6176 GRUB_DEFAULT=sav │ │ │ │ -0000c0a0: 6564 2720 6973 2075 7365 6675 6c20 7769 ed' is useful wi │ │ │ │ -0000c0b0: 7468 6f75 7420 7468 6973 206f 7074 696f thout this optio │ │ │ │ -0000c0c0: 6e2c 2069 6e0a 2020 2020 2063 6f6e 6a75 n, in. conju │ │ │ │ -0000c0d0: 6e63 7469 6f6e 2077 6974 6820 2767 7275 nction with 'gru │ │ │ │ -0000c0e0: 622d 7365 742d 6465 6661 756c 7427 2e20 b-set-default'. │ │ │ │ -0000c0f0: 2055 6e73 6574 2062 7920 6465 6661 756c Unset by defaul │ │ │ │ -0000c100: 742e 2020 5468 6973 0a20 2020 2020 6f70 t. This. op │ │ │ │ -0000c110: 7469 6f6e 2072 656c 6965 7320 6f6e 2074 tion relies on t │ │ │ │ -0000c120: 6865 2065 6e76 6972 6f6e 6d65 6e74 2062 he environment b │ │ │ │ -0000c130: 6c6f 636b 2c20 7768 6963 6820 6d61 7920 lock, which may │ │ │ │ -0000c140: 6e6f 7420 6265 2061 7661 696c 6162 6c65 not be available │ │ │ │ -0000c150: 0a20 2020 2020 696e 2061 6c6c 2073 6974 . in all sit │ │ │ │ -0000c160: 7561 7469 6f6e 7320 282a 6e6f 7465 2045 uations (*note E │ │ │ │ -0000c170: 6e76 6972 6f6e 6d65 6e74 2062 6c6f 636b nvironment block │ │ │ │ -0000c180: 3a3a 292e 0a0a 2747 5255 425f 5449 4d45 ::)...'GRUB_TIME │ │ │ │ -0000c190: 4f55 5427 0a20 2020 2020 426f 6f74 2074 OUT'. Boot t │ │ │ │ -0000c1a0: 6865 2064 6566 6175 6c74 2065 6e74 7279 he default entry │ │ │ │ -0000c1b0: 2074 6869 7320 6d61 6e79 2073 6563 6f6e this many secon │ │ │ │ -0000c1c0: 6473 2061 6674 6572 2074 6865 206d 656e ds after the men │ │ │ │ -0000c1d0: 7520 6973 0a20 2020 2020 6469 7370 6c61 u is. displa │ │ │ │ -0000c1e0: 7965 642c 2075 6e6c 6573 7320 6120 6b65 yed, unless a ke │ │ │ │ -0000c1f0: 7920 6973 2070 7265 7373 6564 2e20 2054 y is pressed. T │ │ │ │ -0000c200: 6865 2064 6566 6175 6c74 2069 7320 2735 he default is '5 │ │ │ │ -0000c210: 272e 2020 5365 7420 746f 0a20 2020 2020 '. Set to. │ │ │ │ -0000c220: 2730 2720 746f 2062 6f6f 7420 696d 6d65 '0' to boot imme │ │ │ │ -0000c230: 6469 6174 656c 7920 7769 7468 6f75 7420 diately without │ │ │ │ -0000c240: 6469 7370 6c61 7969 6e67 2074 6865 206d displaying the m │ │ │ │ -0000c250: 656e 752c 206f 7220 746f 2027 2d31 2720 enu, or to '-1' │ │ │ │ -0000c260: 746f 0a20 2020 2020 7761 6974 2069 6e64 to. wait ind │ │ │ │ -0000c270: 6566 696e 6974 656c 792e 0a0a 2020 2020 efinitely... │ │ │ │ -0000c280: 2049 6620 2747 5255 425f 5449 4d45 4f55 If 'GRUB_TIMEOU │ │ │ │ -0000c290: 545f 5354 594c 4527 2069 7320 7365 7420 T_STYLE' is set │ │ │ │ -0000c2a0: 746f 2027 636f 756e 7464 6f77 6e27 206f to 'countdown' o │ │ │ │ -0000c2b0: 7220 2768 6964 6465 6e27 2c20 7468 650a r 'hidden', the. │ │ │ │ -0000c2c0: 2020 2020 2074 696d 656f 7574 2069 7320 timeout is │ │ │ │ -0000c2d0: 696e 7374 6561 6420 636f 756e 7465 6420 instead counted │ │ │ │ -0000c2e0: 6265 666f 7265 2074 6865 206d 656e 7520 before the menu │ │ │ │ -0000c2f0: 6973 2064 6973 706c 6179 6564 2e0a 0a27 is displayed...' │ │ │ │ -0000c300: 4752 5542 5f54 494d 454f 5554 5f53 5459 GRUB_TIMEOUT_STY │ │ │ │ -0000c310: 4c45 270a 2020 2020 2049 6620 7468 6973 LE'. If this │ │ │ │ -0000c320: 206f 7074 696f 6e20 6973 2075 6e73 6574 option is unset │ │ │ │ -0000c330: 206f 7220 7365 7420 746f 2027 6d65 6e75 or set to 'menu │ │ │ │ -0000c340: 272c 2074 6865 6e20 4752 5542 2077 696c ', then GRUB wil │ │ │ │ -0000c350: 6c20 6469 7370 6c61 790a 2020 2020 2074 l display. t │ │ │ │ -0000c360: 6865 206d 656e 7520 616e 6420 7468 656e he menu and then │ │ │ │ -0000c370: 2077 6169 7420 666f 7220 7468 6520 7469 wait for the ti │ │ │ │ -0000c380: 6d65 6f75 7420 7365 7420 6279 2027 4752 meout set by 'GR │ │ │ │ -0000c390: 5542 5f54 494d 454f 5554 2720 746f 0a20 UB_TIMEOUT' to. │ │ │ │ -0000c3a0: 2020 2020 6578 7069 7265 2062 6566 6f72 expire befor │ │ │ │ -0000c3b0: 6520 626f 6f74 696e 6720 7468 6520 6465 e booting the de │ │ │ │ -0000c3c0: 6661 756c 7420 656e 7472 792e 2020 5072 fault entry. Pr │ │ │ │ -0000c3d0: 6573 7369 6e67 2061 206b 6579 2069 6e74 essing a key int │ │ │ │ -0000c3e0: 6572 7275 7074 730a 2020 2020 2074 6865 errupts. the │ │ │ │ -0000c3f0: 2074 696d 656f 7574 2e0a 0a20 2020 2020 timeout... │ │ │ │ -0000c400: 4966 2074 6869 7320 6f70 7469 6f6e 2069 If this option i │ │ │ │ -0000c410: 7320 7365 7420 746f 2027 636f 756e 7464 s set to 'countd │ │ │ │ -0000c420: 6f77 6e27 206f 7220 2768 6964 6465 6e27 own' or 'hidden' │ │ │ │ -0000c430: 2c20 7468 656e 2c20 6265 666f 7265 0a20 , then, before. │ │ │ │ -0000c440: 2020 2020 6469 7370 6c61 7969 6e67 2074 displaying t │ │ │ │ -0000c450: 6865 206d 656e 752c 2047 5255 4220 7769 he menu, GRUB wi │ │ │ │ -0000c460: 6c6c 2077 6169 7420 666f 7220 7468 6520 ll wait for the │ │ │ │ -0000c470: 7469 6d65 6f75 7420 7365 7420 6279 0a20 timeout set by. │ │ │ │ -0000c480: 2020 2020 2747 5255 425f 5449 4d45 4f55 'GRUB_TIMEOU │ │ │ │ -0000c490: 5427 2074 6f20 6578 7069 7265 2e20 2049 T' to expire. I │ │ │ │ -0000c4a0: 6620 3c45 5343 3e20 6973 2070 7265 7373 f is press │ │ │ │ -0000c4b0: 6564 2064 7572 696e 6720 7468 6174 2074 ed during that t │ │ │ │ -0000c4c0: 696d 652c 2069 740a 2020 2020 2077 696c ime, it. wil │ │ │ │ -0000c4d0: 6c20 6469 7370 6c61 7920 7468 6520 6d65 l display the me │ │ │ │ -0000c4e0: 6e75 2061 6e64 2077 6169 7420 666f 7220 nu and wait for │ │ │ │ -0000c4f0: 696e 7075 742e 2020 4966 2061 2068 6f74 input. If a hot │ │ │ │ -0000c500: 6b65 7920 6173 736f 6369 6174 6564 0a20 key associated. │ │ │ │ -0000c510: 2020 2020 7769 7468 2061 206d 656e 7520 with a menu │ │ │ │ -0000c520: 656e 7472 7920 6973 2070 7265 7373 6564 entry is pressed │ │ │ │ -0000c530: 2c20 6974 2077 696c 6c20 626f 6f74 2074 , it will boot t │ │ │ │ -0000c540: 6865 2061 7373 6f63 6961 7465 6420 6d65 he associated me │ │ │ │ -0000c550: 6e75 0a20 2020 2020 656e 7472 7920 696d nu. entry im │ │ │ │ -0000c560: 6d65 6469 6174 656c 792e 2020 4966 2074 mediately. If t │ │ │ │ -0000c570: 6865 2074 696d 656f 7574 2065 7870 6972 he timeout expir │ │ │ │ -0000c580: 6573 2062 6566 6f72 6520 6569 7468 6572 es before either │ │ │ │ -0000c590: 206f 6620 7468 6573 650a 2020 2020 2068 of these. h │ │ │ │ -0000c5a0: 6170 7065 6e73 2c20 6974 2077 696c 6c20 appens, it will │ │ │ │ -0000c5b0: 626f 6f74 2074 6865 2064 6566 6175 6c74 boot the default │ │ │ │ -0000c5c0: 2065 6e74 7279 2e20 2049 6e20 7468 6520 entry. In the │ │ │ │ -0000c5d0: 2763 6f75 6e74 646f 776e 2720 6361 7365 'countdown' case │ │ │ │ -0000c5e0: 2c0a 2020 2020 2069 7420 7769 6c6c 2073 ,. it will s │ │ │ │ -0000c5f0: 686f 7720 6120 6f6e 652d 6c69 6e65 2069 how a one-line i │ │ │ │ -0000c600: 6e64 6963 6174 696f 6e20 6f66 2074 6865 ndication of the │ │ │ │ -0000c610: 2072 656d 6169 6e69 6e67 2074 696d 652e remaining time. │ │ │ │ -0000c620: 0a0a 2747 5255 425f 4445 4641 554c 545f ..'GRUB_DEFAULT_ │ │ │ │ -0000c630: 4255 5454 4f4e 270a 2747 5255 425f 5449 BUTTON'.'GRUB_TI │ │ │ │ -0000c640: 4d45 4f55 545f 4255 5454 4f4e 270a 2747 MEOUT_BUTTON'.'G │ │ │ │ -0000c650: 5255 425f 5449 4d45 4f55 545f 5354 594c RUB_TIMEOUT_STYL │ │ │ │ -0000c660: 455f 4255 5454 4f4e 270a 2747 5255 425f E_BUTTON'.'GRUB_ │ │ │ │ -0000c670: 4255 5454 4f4e 5f43 4d4f 535f 4144 4452 BUTTON_CMOS_ADDR │ │ │ │ -0000c680: 4553 5327 0a20 2020 2020 5661 7269 616e ESS'. Varian │ │ │ │ -0000c690: 7473 206f 6620 7468 6520 636f 7272 6573 ts of the corres │ │ │ │ -0000c6a0: 706f 6e64 696e 6720 7661 7269 6162 6c65 ponding variable │ │ │ │ -0000c6b0: 7320 7769 7468 6f75 7420 7468 6520 275f s without the '_ │ │ │ │ -0000c6c0: 4255 5454 4f4e 270a 2020 2020 2073 7566 BUTTON'. suf │ │ │ │ -0000c6d0: 6669 782c 2075 7365 6420 746f 2073 7570 fix, used to sup │ │ │ │ -0000c6e0: 706f 7274 2076 656e 646f 722d 7370 6563 port vendor-spec │ │ │ │ -0000c6f0: 6966 6963 2070 6f77 6572 2062 7574 746f ific power butto │ │ │ │ -0000c700: 6e73 2e20 202a 4e6f 7465 0a20 2020 2020 ns. *Note. │ │ │ │ -0000c710: 5665 6e64 6f72 2070 6f77 6572 2d6f 6e20 Vendor power-on │ │ │ │ -0000c720: 6b65 7973 3a3a 2e0a 0a27 4752 5542 5f44 keys::...'GRUB_D │ │ │ │ -0000c730: 4953 5452 4942 5554 4f52 270a 2020 2020 ISTRIBUTOR'. │ │ │ │ -0000c740: 2053 6574 2062 7920 6469 7374 7269 6275 Set by distribu │ │ │ │ -0000c750: 746f 7273 206f 6620 4752 5542 2074 6f20 tors of GRUB to │ │ │ │ -0000c760: 7468 6569 7220 6964 656e 7469 6679 696e their identifyin │ │ │ │ -0000c770: 6720 6e61 6d65 2e20 2054 6869 7320 6973 g name. This is │ │ │ │ -0000c780: 0a20 2020 2020 7573 6564 2074 6f20 6765 . used to ge │ │ │ │ -0000c790: 6e65 7261 7465 206d 6f72 6520 696e 666f nerate more info │ │ │ │ -0000c7a0: 726d 6174 6976 6520 6d65 6e75 2065 6e74 rmative menu ent │ │ │ │ -0000c7b0: 7279 2074 6974 6c65 732e 0a0a 2747 5255 ry titles...'GRU │ │ │ │ -0000c7c0: 425f 5445 524d 494e 414c 5f49 4e50 5554 B_TERMINAL_INPUT │ │ │ │ -0000c7d0: 270a 2020 2020 2053 656c 6563 7420 7468 '. Select th │ │ │ │ -0000c7e0: 6520 7465 726d 696e 616c 2069 6e70 7574 e terminal input │ │ │ │ -0000c7f0: 2064 6576 6963 652e 2020 596f 7520 6d61 device. You ma │ │ │ │ -0000c800: 7920 7365 6c65 6374 206d 756c 7469 706c y select multipl │ │ │ │ -0000c810: 6520 6465 7669 6365 730a 2020 2020 2068 e devices. h │ │ │ │ -0000c820: 6572 652c 2073 6570 6172 6174 6564 2062 ere, separated b │ │ │ │ -0000c830: 7920 7370 6163 6573 2e0a 0a20 2020 2020 y spaces... │ │ │ │ -0000c840: 5661 6c69 6420 7465 726d 696e 616c 2069 Valid terminal i │ │ │ │ -0000c850: 6e70 7574 206e 616d 6573 2064 6570 656e nput names depen │ │ │ │ -0000c860: 6420 6f6e 2074 6865 2070 6c61 7466 6f72 d on the platfor │ │ │ │ -0000c870: 6d2c 2062 7574 206d 6179 2069 6e63 6c75 m, but may inclu │ │ │ │ -0000c880: 6465 0a20 2020 2020 2763 6f6e 736f 6c65 de. 'console │ │ │ │ -0000c890: 2720 286e 6174 6976 6520 706c 6174 666f ' (native platfo │ │ │ │ -0000c8a0: 726d 2063 6f6e 736f 6c65 292c 2027 7365 rm console), 'se │ │ │ │ -0000c8b0: 7269 616c 2720 2873 6572 6961 6c20 7465 rial' (serial te │ │ │ │ -0000c8c0: 726d 696e 616c 292c 0a20 2020 2020 2773 rminal),. 's │ │ │ │ -0000c8d0: 6572 6961 6c5f 3c70 6f72 743e 2720 2873 erial_' (s │ │ │ │ -0000c8e0: 6572 6961 6c20 7465 726d 696e 616c 2077 erial terminal w │ │ │ │ -0000c8f0: 6974 6820 6578 706c 6963 6974 2070 6f72 ith explicit por │ │ │ │ -0000c900: 7420 7365 6c65 6374 696f 6e29 2c0a 2020 t selection),. │ │ │ │ -0000c910: 2020 2027 6174 5f6b 6579 626f 6172 6427 'at_keyboard' │ │ │ │ -0000c920: 2028 5043 2041 5420 6b65 7962 6f61 7264 (PC AT keyboard │ │ │ │ -0000c930: 292c 206f 7220 2775 7362 5f6b 6579 626f ), or 'usb_keybo │ │ │ │ -0000c940: 6172 6427 2028 5553 4220 6b65 7962 6f61 ard' (USB keyboa │ │ │ │ -0000c950: 7264 0a20 2020 2020 7573 696e 6720 7468 rd. using th │ │ │ │ -0000c960: 6520 4849 4420 426f 6f74 2050 726f 746f e HID Boot Proto │ │ │ │ -0000c970: 636f 6c2c 2066 6f72 2063 6173 6573 2077 col, for cases w │ │ │ │ -0000c980: 6865 7265 2074 6865 2066 6972 6d77 6172 here the firmwar │ │ │ │ -0000c990: 6520 646f 6573 206e 6f74 0a20 2020 2020 e does not. │ │ │ │ -0000c9a0: 6861 6e64 6c65 2074 6869 7329 2e0a 0a20 handle this)... │ │ │ │ -0000c9b0: 2020 2020 5468 6520 6465 6661 756c 7420 The default │ │ │ │ -0000c9c0: 6973 2074 6f20 7573 6520 7468 6520 706c is to use the pl │ │ │ │ -0000c9d0: 6174 666f 726d 2773 206e 6174 6976 6520 atform's native │ │ │ │ -0000c9e0: 7465 726d 696e 616c 2069 6e70 7574 2e0a terminal input.. │ │ │ │ -0000c9f0: 0a27 4752 5542 5f54 4552 4d49 4e41 4c5f .'GRUB_TERMINAL_ │ │ │ │ -0000ca00: 4f55 5450 5554 270a 2020 2020 2053 656c OUTPUT'. Sel │ │ │ │ -0000ca10: 6563 7420 7468 6520 7465 726d 696e 616c ect the terminal │ │ │ │ -0000ca20: 206f 7574 7075 7420 6465 7669 6365 2e20 output device. │ │ │ │ -0000ca30: 2059 6f75 206d 6179 2073 656c 6563 7420 You may select │ │ │ │ -0000ca40: 6d75 6c74 6970 6c65 2064 6576 6963 6573 multiple devices │ │ │ │ -0000ca50: 0a20 2020 2020 6865 7265 2c20 7365 7061 . here, sepa │ │ │ │ -0000ca60: 7261 7465 6420 6279 2073 7061 6365 732e rated by spaces. │ │ │ │ -0000ca70: 0a0a 2020 2020 2056 616c 6964 2074 6572 .. Valid ter │ │ │ │ -0000ca80: 6d69 6e61 6c20 6f75 7470 7574 206e 616d minal output nam │ │ │ │ -0000ca90: 6573 2064 6570 656e 6420 6f6e 2074 6865 es depend on the │ │ │ │ -0000caa0: 2070 6c61 7466 6f72 6d2c 2062 7574 206d platform, but m │ │ │ │ -0000cab0: 6179 2069 6e63 6c75 6465 0a20 2020 2020 ay include. │ │ │ │ -0000cac0: 2763 6f6e 736f 6c65 2720 286e 6174 6976 'console' (nativ │ │ │ │ -0000cad0: 6520 706c 6174 666f 726d 2063 6f6e 736f e platform conso │ │ │ │ -0000cae0: 6c65 292c 2027 7365 7269 616c 2720 2873 le), 'serial' (s │ │ │ │ -0000caf0: 6572 6961 6c20 7465 726d 696e 616c 292c erial terminal), │ │ │ │ -0000cb00: 0a20 2020 2020 2773 6572 6961 6c5f 3c70 . 'serial_

' (serial te │ │ │ │ -0000cb20: 726d 696e 616c 2077 6974 6820 6578 706c rminal with expl │ │ │ │ -0000cb30: 6963 6974 2070 6f72 7420 7365 6c65 6374 icit port select │ │ │ │ -0000cb40: 696f 6e29 2c0a 2020 2020 2027 6766 7874 ion),. 'gfxt │ │ │ │ -0000cb50: 6572 6d27 2028 6772 6170 6869 6373 2d6d erm' (graphics-m │ │ │ │ -0000cb60: 6f64 6520 6f75 7470 7574 292c 2027 7667 ode output), 'vg │ │ │ │ -0000cb70: 615f 7465 7874 2720 2856 4741 2074 6578 a_text' (VGA tex │ │ │ │ -0000cb80: 7420 6f75 7470 7574 292c 0a20 2020 2020 t output),. │ │ │ │ -0000cb90: 276d 6461 5f74 6578 7427 2028 4d44 4120 'mda_text' (MDA │ │ │ │ -0000cba0: 7465 7874 206f 7574 7075 7429 2c20 276d text output), 'm │ │ │ │ -0000cbb0: 6f72 7365 2720 284d 6f72 7365 2d63 6f64 orse' (Morse-cod │ │ │ │ -0000cbc0: 696e 6720 7573 696e 6720 7379 7374 656d ing using system │ │ │ │ -0000cbd0: 0a20 2020 2020 6265 6570 6572 2920 6f72 . beeper) or │ │ │ │ -0000cbe0: 2027 7370 6b6d 6f64 656d 2720 2873 696d 'spkmodem' (sim │ │ │ │ -0000cbf0: 706c 6520 6461 7461 2070 726f 746f 636f ple data protoco │ │ │ │ -0000cc00: 6c20 7573 696e 6720 7379 7374 656d 2073 l using system s │ │ │ │ -0000cc10: 7065 616b 6572 292e 0a0a 2020 2020 2027 peaker)... ' │ │ │ │ -0000cc20: 7370 6b6d 6f64 656d 2720 6973 2075 7365 spkmodem' is use │ │ │ │ -0000cc30: 6675 6c20 7768 656e 206e 6f20 7365 7269 ful when no seri │ │ │ │ -0000cc40: 616c 2070 6f72 7420 6973 2061 7661 696c al port is avail │ │ │ │ -0000cc50: 6162 6c65 2e20 2043 6f6e 6e65 6374 2074 able. Connect t │ │ │ │ -0000cc60: 6865 0a20 2020 2020 6f75 7470 7574 206f he. output o │ │ │ │ -0000cc70: 6620 7365 6e64 696e 6720 7379 7374 656d f sending system │ │ │ │ -0000cc80: 2028 7768 6572 6520 4752 5542 2069 7320 (where GRUB is │ │ │ │ -0000cc90: 7275 6e6e 696e 6729 2074 6f20 6c69 6e65 running) to line │ │ │ │ -0000cca0: 2d69 6e20 6f66 0a20 2020 2020 7265 6365 -in of. rece │ │ │ │ -0000ccb0: 6976 696e 6720 7379 7374 656d 2028 7573 iving system (us │ │ │ │ -0000ccc0: 7561 6c6c 7920 6465 7665 6c6f 7065 7220 ually developer │ │ │ │ -0000ccd0: 6d61 6368 696e 6529 2e20 204f 6e20 7265 machine). On re │ │ │ │ -0000cce0: 6365 6976 696e 6720 7379 7374 656d 0a20 ceiving system. │ │ │ │ -0000ccf0: 2020 2020 636f 6d70 696c 6520 2773 706b compile 'spk │ │ │ │ -0000cd00: 6d6f 6465 6d2d 7265 6376 2720 6672 6f6d modem-recv' from │ │ │ │ -0000cd10: 2027 7574 696c 2f73 706b 6d6f 6465 6d2d 'util/spkmodem- │ │ │ │ -0000cd20: 7265 6376 2e63 2720 616e 6420 7275 6e3a recv.c' and run: │ │ │ │ -0000cd30: 0a0a 2020 2020 2020 2020 2020 7061 7265 .. pare │ │ │ │ -0000cd40: 636f 7264 202d 2d63 6861 6e6e 656c 733d cord --channels= │ │ │ │ -0000cd50: 3120 2d2d 7261 7465 3d34 3830 3030 202d 1 --rate=48000 - │ │ │ │ -0000cd60: 2d66 6f72 6d61 743d 7331 366c 6520 7c20 -format=s16le | │ │ │ │ -0000cd70: 2e2f 7370 6b6d 6f64 656d 2d72 6563 760a ./spkmodem-recv. │ │ │ │ -0000cd80: 0a20 2020 2020 5468 6520 6465 6661 756c . The defaul │ │ │ │ -0000cd90: 7420 6973 2074 6f20 7573 6520 7468 6520 t is to use the │ │ │ │ -0000cda0: 706c 6174 666f 726d 2773 206e 6174 6976 platform's nativ │ │ │ │ -0000cdb0: 6520 7465 726d 696e 616c 206f 7574 7075 e terminal outpu │ │ │ │ -0000cdc0: 742e 0a0a 2747 5255 425f 5445 524d 494e t...'GRUB_TERMIN │ │ │ │ -0000cdd0: 414c 270a 2020 2020 2049 6620 7468 6973 AL'. If this │ │ │ │ -0000cde0: 206f 7074 696f 6e20 6973 2073 6574 2c20 option is set, │ │ │ │ -0000cdf0: 6974 206f 7665 7272 6964 6573 2062 6f74 it overrides bot │ │ │ │ -0000ce00: 6820 2747 5255 425f 5445 524d 494e 414c h 'GRUB_TERMINAL │ │ │ │ -0000ce10: 5f49 4e50 5554 2720 616e 640a 2020 2020 _INPUT' and. │ │ │ │ -0000ce20: 2027 4752 5542 5f54 4552 4d49 4e41 4c5f 'GRUB_TERMINAL_ │ │ │ │ -0000ce30: 4f55 5450 5554 2720 746f 2074 6865 2073 OUTPUT' to the s │ │ │ │ -0000ce40: 616d 6520 7661 6c75 652e 0a0a 2747 5255 ame value...'GRU │ │ │ │ -0000ce50: 425f 5345 5249 414c 5f43 4f4d 4d41 4e44 B_SERIAL_COMMAND │ │ │ │ -0000ce60: 270a 2020 2020 2041 2063 6f6d 6d61 6e64 '. A command │ │ │ │ -0000ce70: 2074 6f20 636f 6e66 6967 7572 6520 7468 to configure th │ │ │ │ -0000ce80: 6520 7365 7269 616c 2070 6f72 7420 7768 e serial port wh │ │ │ │ -0000ce90: 656e 2075 7369 6e67 2074 6865 2073 6572 en using the ser │ │ │ │ -0000cea0: 6961 6c0a 2020 2020 2063 6f6e 736f 6c65 ial. console │ │ │ │ -0000ceb0: 2e20 202a 4e6f 7465 2073 6572 6961 6c3a . *Note serial: │ │ │ │ -0000cec0: 3a2e 2020 4465 6661 756c 7473 2074 6f20 :. Defaults to │ │ │ │ -0000ced0: 2773 6572 6961 6c27 2e0a 0a27 4752 5542 'serial'...'GRUB │ │ │ │ -0000cee0: 5f43 4d44 4c49 4e45 5f4c 494e 5558 270a _CMDLINE_LINUX'. │ │ │ │ -0000cef0: 2020 2020 2043 6f6d 6d61 6e64 2d6c 696e Command-lin │ │ │ │ -0000cf00: 6520 6172 6775 6d65 6e74 7320 746f 2061 e arguments to a │ │ │ │ -0000cf10: 6464 2074 6f20 6d65 6e75 2065 6e74 7269 dd to menu entri │ │ │ │ -0000cf20: 6573 2066 6f72 2074 6865 204c 696e 7578 es for the Linux │ │ │ │ -0000cf30: 206b 6572 6e65 6c2e 0a0a 2747 5255 425f kernel...'GRUB_ │ │ │ │ -0000cf40: 434d 444c 494e 455f 4c49 4e55 585f 4445 CMDLINE_LINUX_DE │ │ │ │ -0000cf50: 4641 554c 5427 0a20 2020 2020 556e 6c65 FAULT'. Unle │ │ │ │ -0000cf60: 7373 2027 4752 5542 5f44 4953 4142 4c45 ss 'GRUB_DISABLE │ │ │ │ -0000cf70: 5f52 4543 4f56 4552 5927 2069 7320 7365 _RECOVERY' is se │ │ │ │ -0000cf80: 7420 746f 2027 7472 7565 272c 2074 776f t to 'true', two │ │ │ │ -0000cf90: 206d 656e 7520 656e 7472 6965 730a 2020 menu entries. │ │ │ │ -0000cfa0: 2020 2077 696c 6c20 6265 2067 656e 6572 will be gener │ │ │ │ -0000cfb0: 6174 6564 2066 6f72 2065 6163 6820 4c69 ated for each Li │ │ │ │ -0000cfc0: 6e75 7820 6b65 726e 656c 3a20 6f6e 6520 nux kernel: one │ │ │ │ -0000cfd0: 6465 6661 756c 7420 656e 7472 7920 616e default entry an │ │ │ │ -0000cfe0: 6420 6f6e 650a 2020 2020 2065 6e74 7279 d one. entry │ │ │ │ -0000cff0: 2066 6f72 2072 6563 6f76 6572 7920 6d6f for recovery mo │ │ │ │ -0000d000: 6465 2e20 2054 6869 7320 6f70 7469 6f6e de. This option │ │ │ │ -0000d010: 206c 6973 7473 2063 6f6d 6d61 6e64 2d6c lists command-l │ │ │ │ -0000d020: 696e 6520 6172 6775 6d65 6e74 730a 2020 ine arguments. │ │ │ │ -0000d030: 2020 2074 6f20 6164 6420 6f6e 6c79 2074 to add only t │ │ │ │ -0000d040: 6f20 7468 6520 6465 6661 756c 7420 6d65 o the default me │ │ │ │ -0000d050: 6e75 2065 6e74 7279 2c20 6166 7465 7220 nu entry, after │ │ │ │ -0000d060: 7468 6f73 6520 6c69 7374 6564 2069 6e0a those listed in. │ │ │ │ -0000d070: 2020 2020 2027 4752 5542 5f43 4d44 4c49 'GRUB_CMDLI │ │ │ │ -0000d080: 4e45 5f4c 494e 5558 272e 0a0a 2747 5255 NE_LINUX'...'GRU │ │ │ │ -0000d090: 425f 434d 444c 494e 455f 4e45 5442 5344 B_CMDLINE_NETBSD │ │ │ │ -0000d0a0: 270a 2747 5255 425f 434d 444c 494e 455f '.'GRUB_CMDLINE_ │ │ │ │ -0000d0b0: 4e45 5442 5344 5f44 4546 4155 4c54 270a NETBSD_DEFAULT'. │ │ │ │ -0000d0c0: 2020 2020 2041 7320 2747 5255 425f 434d As 'GRUB_CM │ │ │ │ -0000d0d0: 444c 494e 455f 4c49 4e55 5827 2061 6e64 DLINE_LINUX' and │ │ │ │ -0000d0e0: 2027 4752 5542 5f43 4d44 4c49 4e45 5f4c 'GRUB_CMDLINE_L │ │ │ │ -0000d0f0: 494e 5558 5f44 4546 4155 4c54 272c 2062 INUX_DEFAULT', b │ │ │ │ -0000d100: 7574 2066 6f72 0a20 2020 2020 4e65 7442 ut for. NetB │ │ │ │ -0000d110: 5344 2e0a 0a27 4752 5542 5f43 4d44 4c49 SD...'GRUB_CMDLI │ │ │ │ -0000d120: 4e45 5f47 4e55 4d41 4348 270a 2020 2020 NE_GNUMACH'. │ │ │ │ -0000d130: 2041 7320 2747 5255 425f 434d 444c 494e As 'GRUB_CMDLIN │ │ │ │ -0000d140: 455f 4c49 4e55 5827 2c20 6275 7420 666f E_LINUX', but fo │ │ │ │ -0000d150: 7220 474e 5520 4d61 6368 2e0a 0a27 4752 r GNU Mach...'GR │ │ │ │ -0000d160: 5542 5f43 4d44 4c49 4e45 5f58 454e 270a UB_CMDLINE_XEN'. │ │ │ │ -0000d170: 2747 5255 425f 434d 444c 494e 455f 5845 'GRUB_CMDLINE_XE │ │ │ │ -0000d180: 4e5f 4445 4641 554c 5427 0a20 2020 2020 N_DEFAULT'. │ │ │ │ -0000d190: 5468 6520 7661 6c75 6573 206f 6620 7468 The values of th │ │ │ │ -0000d1a0: 6573 6520 6f70 7469 6f6e 7320 6172 6520 ese options are │ │ │ │ -0000d1b0: 7061 7373 6564 2074 6f20 5865 6e20 6879 passed to Xen hy │ │ │ │ -0000d1c0: 7065 7276 6973 6f72 2058 656e 206d 656e pervisor Xen men │ │ │ │ -0000d1d0: 750a 2020 2020 2065 6e74 7269 6573 2c20 u. entries, │ │ │ │ -0000d1e0: 666f 7220 616c 6c20 7265 7370 6563 7469 for all respecti │ │ │ │ -0000d1f0: 7665 6c79 206e 6f72 6d61 6c20 656e 7472 vely normal entr │ │ │ │ -0000d200: 6965 732e 0a0a 2747 5255 425f 434d 444c ies...'GRUB_CMDL │ │ │ │ -0000d210: 494e 455f 4c49 4e55 585f 5845 4e5f 5245 INE_LINUX_XEN_RE │ │ │ │ -0000d220: 504c 4143 4527 0a27 4752 5542 5f43 4d44 PLACE'.'GRUB_CMD │ │ │ │ -0000d230: 4c49 4e45 5f4c 494e 5558 5f58 454e 5f52 LINE_LINUX_XEN_R │ │ │ │ -0000d240: 4550 4c41 4345 5f44 4546 4155 4c54 270a EPLACE_DEFAULT'. │ │ │ │ -0000d250: 2020 2020 2054 6865 2076 616c 7565 7320 The values │ │ │ │ -0000d260: 6f66 2074 6865 7365 206f 7074 696f 6e73 of these options │ │ │ │ -0000d270: 2072 6570 6c61 6365 2074 6865 2076 616c replace the val │ │ │ │ -0000d280: 7565 7320 6f66 0a20 2020 2020 2747 5255 ues of. 'GRU │ │ │ │ -0000d290: 425f 434d 444c 494e 455f 4c49 4e55 5827 B_CMDLINE_LINUX' │ │ │ │ -0000d2a0: 2061 6e64 2027 4752 5542 5f43 4d44 4c49 and 'GRUB_CMDLI │ │ │ │ -0000d2b0: 4e45 5f4c 494e 5558 5f44 4546 4155 4c54 NE_LINUX_DEFAULT │ │ │ │ -0000d2c0: 2720 666f 7220 4c69 6e75 7820 616e 640a ' for Linux and. │ │ │ │ -0000d2d0: 2020 2020 2058 656e 206d 656e 7520 656e Xen menu en │ │ │ │ -0000d2e0: 7472 6965 732e 0a0a 2747 5255 425f 4541 tries...'GRUB_EA │ │ │ │ -0000d2f0: 524c 595f 494e 4954 5244 5f4c 494e 5558 RLY_INITRD_LINUX │ │ │ │ -0000d300: 5f43 5553 544f 4d27 0a27 4752 5542 5f45 _CUSTOM'.'GRUB_E │ │ │ │ -0000d310: 4152 4c59 5f49 4e49 5452 445f 4c49 4e55 ARLY_INITRD_LINU │ │ │ │ -0000d320: 585f 5354 4f43 4b27 0a20 2020 2020 4c69 X_STOCK'. Li │ │ │ │ -0000d330: 7374 206f 6620 7370 6163 652d 7365 7061 st of space-sepa │ │ │ │ -0000d340: 7261 7465 6420 6561 726c 7920 696e 6974 rated early init │ │ │ │ -0000d350: 7264 2069 6d61 6765 7320 746f 2062 6520 rd images to be │ │ │ │ -0000d360: 6c6f 6164 6564 2066 726f 6d0a 2020 2020 loaded from. │ │ │ │ -0000d370: 2027 2f62 6f6f 7427 2e20 2054 6869 7320 '/boot'. This │ │ │ │ -0000d380: 6973 2066 6f72 206c 6f61 6469 6e67 2074 is for loading t │ │ │ │ -0000d390: 6869 6e67 7320 6c69 6b65 2043 5055 206d hings like CPU m │ │ │ │ -0000d3a0: 6963 726f 636f 6465 2c20 6669 726d 7761 icrocode, firmwa │ │ │ │ -0000d3b0: 7265 2c0a 2020 2020 2041 4350 4920 7461 re,. ACPI ta │ │ │ │ -0000d3c0: 626c 6573 2c20 6372 7970 746f 206b 6579 bles, crypto key │ │ │ │ -0000d3d0: 732c 2061 6e64 2073 6f20 6f6e 2e20 2054 s, and so on. T │ │ │ │ -0000d3e0: 6865 7365 2065 6172 6c79 2069 6d61 6765 hese early image │ │ │ │ -0000d3f0: 7320 7769 6c6c 2062 650a 2020 2020 206c s will be. l │ │ │ │ -0000d400: 6f61 6465 6420 696e 2074 6865 206f 7264 oaded in the ord │ │ │ │ -0000d410: 6572 2064 6563 6c61 7265 642c 2061 6e64 er declared, and │ │ │ │ -0000d420: 2061 6c6c 2077 696c 6c20 6265 206c 6f61 all will be loa │ │ │ │ -0000d430: 6465 6420 6265 666f 7265 2074 6865 0a20 ded before the. │ │ │ │ -0000d440: 2020 2020 6163 7475 616c 2066 756e 6374 actual funct │ │ │ │ -0000d450: 696f 6e61 6c20 696e 6974 7264 2069 6d61 ional initrd ima │ │ │ │ -0000d460: 6765 2e0a 0a20 2020 2020 2747 5255 425f ge... 'GRUB_ │ │ │ │ -0000d470: 4541 524c 595f 494e 4954 5244 5f4c 494e EARLY_INITRD_LIN │ │ │ │ -0000d480: 5558 5f53 544f 434b 2720 6973 2066 6f72 UX_STOCK' is for │ │ │ │ -0000d490: 2079 6f75 7220 6469 7374 7269 6275 7469 your distributi │ │ │ │ -0000d4a0: 6f6e 2074 6f20 6465 636c 6172 650a 2020 on to declare. │ │ │ │ -0000d4b0: 2020 2069 6d61 6765 7320 7468 6174 2061 images that a │ │ │ │ -0000d4c0: 7265 2070 726f 7669 6465 6420 6279 2074 re provided by t │ │ │ │ -0000d4d0: 6865 2064 6973 7472 6962 7574 696f 6e2e he distribution. │ │ │ │ -0000d4e0: 2020 4974 2073 686f 756c 6420 6e6f 7420 It should not │ │ │ │ -0000d4f0: 6265 0a20 2020 2020 6d6f 6469 6669 6564 be. modified │ │ │ │ -0000d500: 2077 6974 686f 7574 2075 6e64 6572 7374 without underst │ │ │ │ -0000d510: 616e 6469 6e67 2074 6865 2063 6f6e 7365 anding the conse │ │ │ │ -0000d520: 7175 656e 6365 732e 2020 5468 6579 2077 quences. They w │ │ │ │ -0000d530: 696c 6c20 6265 0a20 2020 2020 6c6f 6164 ill be. load │ │ │ │ -0000d540: 6564 2066 6972 7374 2e0a 0a20 2020 2020 ed first... │ │ │ │ -0000d550: 2747 5255 425f 4541 524c 595f 494e 4954 'GRUB_EARLY_INIT │ │ │ │ -0000d560: 5244 5f4c 494e 5558 5f43 5553 544f 4d27 RD_LINUX_CUSTOM' │ │ │ │ -0000d570: 2069 7320 666f 7220 796f 7572 2063 7573 is for your cus │ │ │ │ -0000d580: 746f 6d20 6372 6561 7465 6420 696d 6167 tom created imag │ │ │ │ -0000d590: 6573 2e0a 0a20 2020 2020 5468 6520 6465 es... The de │ │ │ │ -0000d5a0: 6661 756c 7420 7374 6f63 6b20 696d 6167 fault stock imag │ │ │ │ -0000d5b0: 6573 2061 7265 2061 7320 666f 6c6c 6f77 es are as follow │ │ │ │ -0000d5c0: 732c 2074 686f 7567 6820 7468 6579 206d s, though they m │ │ │ │ -0000d5d0: 6179 2062 650a 2020 2020 206f 7665 7272 ay be. overr │ │ │ │ -0000d5e0: 6964 6465 6e20 6279 2079 6f75 7220 6469 idden by your di │ │ │ │ -0000d5f0: 7374 7269 6275 7469 6f6e 3a0a 2020 2020 stribution:. │ │ │ │ -0000d600: 2020 2020 2020 696e 7465 6c2d 7563 2e69 intel-uc.i │ │ │ │ -0000d610: 6d67 2069 6e74 656c 2d75 636f 6465 2e69 mg intel-ucode.i │ │ │ │ -0000d620: 6d67 2061 6d64 2d75 632e 696d 6720 616d mg amd-uc.img am │ │ │ │ -0000d630: 642d 7563 6f64 652e 696d 6720 6561 726c d-ucode.img earl │ │ │ │ -0000d640: 795f 7563 6f64 652e 6370 696f 206d 6963 y_ucode.cpio mic │ │ │ │ -0000d650: 726f 636f 6465 2e63 7069 6f0a 0a27 4752 rocode.cpio..'GR │ │ │ │ -0000d660: 5542 5f44 4953 4142 4c45 5f4c 494e 5558 UB_DISABLE_LINUX │ │ │ │ -0000d670: 5f55 5549 4427 0a20 2020 2020 4e6f 726d _UUID'. Norm │ │ │ │ -0000d680: 616c 6c79 2c20 2767 7275 622d 6d6b 636f ally, 'grub-mkco │ │ │ │ -0000d690: 6e66 6967 2720 7769 6c6c 2067 656e 6572 nfig' will gener │ │ │ │ -0000d6a0: 6174 6520 6d65 6e75 2065 6e74 7269 6573 ate menu entries │ │ │ │ -0000d6b0: 2074 6861 7420 7573 650a 2020 2020 2075 that use. u │ │ │ │ -0000d6c0: 6e69 7665 7273 616c 6c79 2d75 6e69 7175 niversally-uniqu │ │ │ │ -0000d6d0: 6520 6964 656e 7469 6669 6572 7320 2855 e identifiers (U │ │ │ │ -0000d6e0: 5549 4473 2920 746f 2069 6465 6e74 6966 UIDs) to identif │ │ │ │ -0000d6f0: 7920 7468 6520 726f 6f74 0a20 2020 2020 y the root. │ │ │ │ -0000d700: 6669 6c65 7379 7374 656d 2074 6f20 7468 filesystem to th │ │ │ │ -0000d710: 6520 4c69 6e75 7820 6b65 726e 656c 2c20 e Linux kernel, │ │ │ │ -0000d720: 7573 696e 6720 6120 2772 6f6f 743d 5555 using a 'root=UU │ │ │ │ -0000d730: 4944 3d2e 2e2e 2720 6b65 726e 656c 0a20 ID=...' kernel. │ │ │ │ -0000d740: 2020 2020 7061 7261 6d65 7465 722e 2020 parameter. │ │ │ │ -0000d750: 5468 6973 2069 7320 7573 7561 6c6c 7920 This is usually │ │ │ │ -0000d760: 6d6f 7265 2072 656c 6961 626c 652c 2062 more reliable, b │ │ │ │ -0000d770: 7574 2069 6e20 736f 6d65 2063 6173 6573 ut in some cases │ │ │ │ -0000d780: 2069 7420 6d61 790a 2020 2020 206e 6f74 it may. not │ │ │ │ -0000d790: 2062 6520 6170 7072 6f70 7269 6174 652e be appropriate. │ │ │ │ -0000d7a0: 2020 546f 2064 6973 6162 6c65 2074 6865 To disable the │ │ │ │ -0000d7b0: 2075 7365 206f 6620 5555 4944 732c 2073 use of UUIDs, s │ │ │ │ -0000d7c0: 6574 2074 6869 7320 6f70 7469 6f6e 0a20 et this option. │ │ │ │ -0000d7d0: 2020 2020 746f 2027 7472 7565 272e 0a0a to 'true'... │ │ │ │ -0000d7e0: 2747 5255 425f 4449 5341 424c 455f 4c49 'GRUB_DISABLE_LI │ │ │ │ -0000d7f0: 4e55 585f 5041 5254 5555 4944 270a 2020 NUX_PARTUUID'. │ │ │ │ -0000d800: 2020 2049 6620 2767 7275 622d 6d6b 636f If 'grub-mkco │ │ │ │ -0000d810: 6e66 6967 2720 6361 6e6e 6f74 2069 6465 nfig' cannot ide │ │ │ │ -0000d820: 6e74 6966 7920 7468 6520 726f 6f74 2066 ntify the root f │ │ │ │ -0000d830: 696c 6573 7973 7465 6d20 7669 6120 6974 ilesystem via it │ │ │ │ -0000d840: 730a 2020 2020 2075 6e69 7665 7273 616c s. universal │ │ │ │ -0000d850: 6c79 2d75 6e69 7175 6520 696e 6465 6e74 ly-unique indent │ │ │ │ -0000d860: 6966 6965 7220 2855 5549 4429 2c20 2767 ifier (UUID), 'g │ │ │ │ -0000d870: 7275 622d 6d6b 636f 6e66 6967 2720 6361 rub-mkconfig' ca │ │ │ │ -0000d880: 6e20 7573 6520 7468 650a 2020 2020 2055 n use the. U │ │ │ │ -0000d890: 5549 4420 6f66 2074 6865 2070 6172 7469 UID of the parti │ │ │ │ -0000d8a0: 7469 6f6e 2063 6f6e 7461 696e 696e 6720 tion containing │ │ │ │ -0000d8b0: 7468 6520 6669 6c65 7379 7374 656d 2074 the filesystem t │ │ │ │ -0000d8c0: 6f20 6964 656e 7469 6679 2074 6865 0a20 o identify the. │ │ │ │ -0000d8d0: 2020 2020 726f 6f74 2066 696c 6573 7973 root filesys │ │ │ │ -0000d8e0: 7465 6d20 746f 2074 6865 204c 696e 7578 tem to the Linux │ │ │ │ -0000d8f0: 206b 6572 6e65 6c20 7669 6120 6120 2772 kernel via a 'r │ │ │ │ -0000d900: 6f6f 743d 5041 5254 5555 4944 3d2e 2e2e oot=PARTUUID=... │ │ │ │ -0000d910: 270a 2020 2020 206b 6572 6e65 6c20 7061 '. kernel pa │ │ │ │ -0000d920: 7261 6d65 7465 722e 2020 5468 6973 2069 rameter. This i │ │ │ │ -0000d930: 7320 6e6f 7420 6173 2072 656c 6961 626c s not as reliabl │ │ │ │ -0000d940: 6520 6173 2075 7369 6e67 2074 6865 2066 e as using the f │ │ │ │ -0000d950: 696c 6573 7973 7465 6d0a 2020 2020 2055 ilesystem. U │ │ │ │ -0000d960: 5549 442c 2062 7574 2069 7320 6d6f 7265 UID, but is more │ │ │ │ -0000d970: 2072 656c 6961 626c 6520 7468 616e 2075 reliable than u │ │ │ │ -0000d980: 7369 6e67 2074 6865 204c 696e 7578 2064 sing the Linux d │ │ │ │ -0000d990: 6576 6963 6520 6e61 6d65 732e 2020 5768 evice names. Wh │ │ │ │ -0000d9a0: 656e 0a20 2020 2020 2747 5255 425f 4449 en. 'GRUB_DI │ │ │ │ -0000d9b0: 5341 424c 455f 4c49 4e55 585f 5041 5254 SABLE_LINUX_PART │ │ │ │ -0000d9c0: 5555 4944 2720 6973 2073 6574 2074 6f20 UUID' is set to │ │ │ │ -0000d9d0: 2766 616c 7365 272c 2074 6865 204c 696e 'false', the Lin │ │ │ │ -0000d9e0: 7578 206b 6572 6e65 6c0a 2020 2020 2076 ux kernel. v │ │ │ │ -0000d9f0: 6572 7369 6f6e 206d 7573 7420 6265 2032 ersion must be 2 │ │ │ │ -0000da00: 2e36 2e33 3720 2833 2e31 3020 666f 7220 .6.37 (3.10 for │ │ │ │ -0000da10: 7379 7374 656d 7320 7573 696e 6720 7468 systems using th │ │ │ │ -0000da20: 6520 4d53 444f 5320 7061 7274 6974 696f e MSDOS partitio │ │ │ │ -0000da30: 6e0a 2020 2020 2073 6368 656d 6529 206f n. scheme) o │ │ │ │ -0000da40: 7220 6e65 7765 722e 2020 5468 6973 206f r newer. This o │ │ │ │ -0000da50: 7074 696f 6e20 6465 6661 756c 7473 2074 ption defaults t │ │ │ │ -0000da60: 6f20 2774 7275 6527 2e20 2054 6f20 656e o 'true'. To en │ │ │ │ -0000da70: 6162 6c65 2074 6865 0a20 2020 2020 7573 able the. us │ │ │ │ -0000da80: 6520 6f66 2070 6172 7469 7469 6f6e 2055 e of partition U │ │ │ │ -0000da90: 5549 4473 2c20 7365 7420 7468 6973 206f UIDs, set this o │ │ │ │ -0000daa0: 7074 696f 6e20 746f 2027 6661 6c73 6527 ption to 'false' │ │ │ │ -0000dab0: 2e0a 0a27 4752 5542 5f44 4953 4142 4c45 ...'GRUB_DISABLE │ │ │ │ -0000dac0: 5f52 4543 4f56 4552 5927 0a20 2020 2020 _RECOVERY'. │ │ │ │ -0000dad0: 4966 2074 6869 7320 6f70 7469 6f6e 2069 If this option i │ │ │ │ -0000dae0: 7320 7365 7420 746f 2027 7472 7565 272c s set to 'true', │ │ │ │ -0000daf0: 2064 6973 6162 6c65 2074 6865 2067 656e disable the gen │ │ │ │ -0000db00: 6572 6174 696f 6e20 6f66 2072 6563 6f76 eration of recov │ │ │ │ -0000db10: 6572 790a 2020 2020 206d 6f64 6520 6d65 ery. mode me │ │ │ │ -0000db20: 6e75 2065 6e74 7269 6573 2e0a 0a27 4752 nu entries...'GR │ │ │ │ -0000db30: 5542 5f56 4944 454f 5f42 4143 4b45 4e44 UB_VIDEO_BACKEND │ │ │ │ -0000db40: 270a 2020 2020 2049 6620 6772 6170 6869 '. If graphi │ │ │ │ -0000db50: 6361 6c20 7669 6465 6f20 7375 7070 6f72 cal video suppor │ │ │ │ -0000db60: 7420 6973 2072 6571 7569 7265 642c 2065 t is required, e │ │ │ │ -0000db70: 6974 6865 7220 6265 6361 7573 6520 7468 ither because th │ │ │ │ -0000db80: 650a 2020 2020 2027 6766 7874 6572 6d27 e. 'gfxterm' │ │ │ │ -0000db90: 2067 7261 7068 6963 616c 2074 6572 6d69 graphical termi │ │ │ │ -0000dba0: 6e61 6c20 6973 2069 6e20 7573 6520 6f72 nal is in use or │ │ │ │ -0000dbb0: 2062 6563 6175 7365 0a20 2020 2020 2747 because. 'G │ │ │ │ -0000dbc0: 5255 425f 4746 5850 4159 4c4f 4144 5f4c RUB_GFXPAYLOAD_L │ │ │ │ -0000dbd0: 494e 5558 2720 6973 2073 6574 2c20 7468 INUX' is set, th │ │ │ │ -0000dbe0: 656e 2027 6772 7562 2d6d 6b63 6f6e 6669 en 'grub-mkconfi │ │ │ │ -0000dbf0: 6727 2077 696c 6c20 6e6f 726d 616c 6c79 g' will normally │ │ │ │ -0000dc00: 0a20 2020 2020 6c6f 6164 2061 6c6c 2061 . load all a │ │ │ │ -0000dc10: 7661 696c 6162 6c65 2047 5255 4220 7669 vailable GRUB vi │ │ │ │ -0000dc20: 6465 6f20 6472 6976 6572 7320 616e 6420 deo drivers and │ │ │ │ -0000dc30: 7573 6520 7468 6520 6f6e 6520 6d6f 7374 use the one most │ │ │ │ -0000dc40: 0a20 2020 2020 6170 7072 6f70 7269 6174 . appropriat │ │ │ │ -0000dc50: 6520 666f 7220 796f 7572 2068 6172 6477 e for your hardw │ │ │ │ -0000dc60: 6172 652e 2020 4966 2079 6f75 206e 6565 are. If you nee │ │ │ │ -0000dc70: 6420 746f 206f 7665 7272 6964 6520 7468 d to override th │ │ │ │ -0000dc80: 6973 2066 6f72 0a20 2020 2020 736f 6d65 is for. some │ │ │ │ -0000dc90: 2072 6561 736f 6e2c 2074 6865 6e20 796f reason, then yo │ │ │ │ -0000dca0: 7520 6361 6e20 7365 7420 7468 6973 206f u can set this o │ │ │ │ -0000dcb0: 7074 696f 6e2e 0a0a 2020 2020 2041 6674 ption... Aft │ │ │ │ -0000dcc0: 6572 2027 6772 7562 2d69 6e73 7461 6c6c er 'grub-install │ │ │ │ -0000dcd0: 2720 6861 7320 6265 656e 2072 756e 2c20 ' has been run, │ │ │ │ -0000dce0: 7468 6520 6176 6169 6c61 626c 6520 7669 the available vi │ │ │ │ -0000dcf0: 6465 6f20 6472 6976 6572 7320 6172 650a deo drivers are. │ │ │ │ -0000dd00: 2020 2020 206c 6973 7465 6420 696e 2027 listed in ' │ │ │ │ -0000dd10: 2f62 6f6f 742f 6772 7562 2f76 6964 656f /boot/grub/video │ │ │ │ -0000dd20: 2e6c 7374 272e 0a0a 2747 5255 425f 4746 .lst'...'GRUB_GF │ │ │ │ -0000dd30: 584d 4f44 4527 0a20 2020 2020 5365 7420 XMODE'. Set │ │ │ │ -0000dd40: 7468 6520 7265 736f 6c75 7469 6f6e 2075 the resolution u │ │ │ │ -0000dd50: 7365 6420 6f6e 2074 6865 2027 6766 7874 sed on the 'gfxt │ │ │ │ -0000dd60: 6572 6d27 2067 7261 7068 6963 616c 2074 erm' graphical t │ │ │ │ -0000dd70: 6572 6d69 6e61 6c2e 2020 4e6f 7465 0a20 erminal. Note. │ │ │ │ -0000dd80: 2020 2020 7468 6174 2079 6f75 2063 616e that you can │ │ │ │ -0000dd90: 206f 6e6c 7920 7573 6520 6d6f 6465 7320 only use modes │ │ │ │ -0000dda0: 7768 6963 6820 796f 7572 2067 7261 7068 which your graph │ │ │ │ -0000ddb0: 6963 7320 6361 7264 2073 7570 706f 7274 ics card support │ │ │ │ -0000ddc0: 7320 7669 610a 2020 2020 2056 4553 4120 s via. VESA │ │ │ │ -0000ddd0: 4249 4f53 2045 7874 656e 7369 6f6e 7320 BIOS Extensions │ │ │ │ -0000dde0: 2856 4245 292c 2073 6f20 666f 7220 6578 (VBE), so for ex │ │ │ │ -0000ddf0: 616d 706c 6520 6e61 7469 7665 204c 4344 ample native LCD │ │ │ │ -0000de00: 2070 616e 656c 0a20 2020 2020 7265 736f panel. reso │ │ │ │ -0000de10: 6c75 7469 6f6e 7320 6d61 7920 6e6f 7420 lutions may not │ │ │ │ -0000de20: 6265 2061 7661 696c 6162 6c65 2e20 2054 be available. T │ │ │ │ -0000de30: 6865 2064 6566 6175 6c74 2069 7320 2761 he default is 'a │ │ │ │ -0000de40: 7574 6f27 2c20 7768 6963 680a 2020 2020 uto', which. │ │ │ │ -0000de50: 2074 7269 6573 2074 6f20 7365 6c65 6374 tries to select │ │ │ │ -0000de60: 2061 2070 7265 6665 7272 6564 2072 6573 a preferred res │ │ │ │ -0000de70: 6f6c 7574 696f 6e2e 2020 2a4e 6f74 6520 olution. *Note │ │ │ │ -0000de80: 6766 786d 6f64 653a 3a2e 0a0a 2747 5255 gfxmode::...'GRU │ │ │ │ -0000de90: 425f 4241 434b 4752 4f55 4e44 270a 2020 B_BACKGROUND'. │ │ │ │ -0000dea0: 2020 2053 6574 2061 2062 6163 6b67 726f Set a backgro │ │ │ │ -0000deb0: 756e 6420 696d 6167 6520 666f 7220 7573 und image for us │ │ │ │ -0000dec0: 6520 7769 7468 2074 6865 2027 6766 7874 e with the 'gfxt │ │ │ │ -0000ded0: 6572 6d27 2067 7261 7068 6963 616c 0a20 erm' graphical. │ │ │ │ -0000dee0: 2020 2020 7465 726d 696e 616c 2e20 2054 terminal. T │ │ │ │ -0000def0: 6865 2076 616c 7565 206f 6620 7468 6973 he value of this │ │ │ │ -0000df00: 206f 7074 696f 6e20 6d75 7374 2062 6520 option must be │ │ │ │ -0000df10: 6120 6669 6c65 2072 6561 6461 626c 6520 a file readable │ │ │ │ -0000df20: 6279 2047 5255 420a 2020 2020 2061 7420 by GRUB. at │ │ │ │ -0000df30: 626f 6f74 2074 696d 652c 2061 6e64 2069 boot time, and i │ │ │ │ -0000df40: 7420 6d75 7374 2065 6e64 2077 6974 6820 t must end with │ │ │ │ -0000df50: 272e 706e 6727 2c20 272e 7467 6127 2c20 '.png', '.tga', │ │ │ │ -0000df60: 272e 6a70 6727 2c20 6f72 0a20 2020 2020 '.jpg', or. │ │ │ │ -0000df70: 272e 6a70 6567 272e 2020 5468 6520 696d '.jpeg'. The im │ │ │ │ -0000df80: 6167 6520 7769 6c6c 2062 6520 7363 616c age will be scal │ │ │ │ -0000df90: 6564 2069 6620 6e65 6365 7373 6172 7920 ed if necessary │ │ │ │ -0000dfa0: 746f 2066 6974 2074 6865 2073 6372 6565 to fit the scree │ │ │ │ -0000dfb0: 6e2e 0a0a 2747 5255 425f 5448 454d 4527 n...'GRUB_THEME' │ │ │ │ -0000dfc0: 0a20 2020 2020 5365 7420 6120 7468 656d . Set a them │ │ │ │ -0000dfd0: 6520 666f 7220 7573 6520 7769 7468 2074 e for use with t │ │ │ │ -0000dfe0: 6865 2027 6766 7874 6572 6d27 2067 7261 he 'gfxterm' gra │ │ │ │ -0000dff0: 7068 6963 616c 2074 6572 6d69 6e61 6c2e phical terminal. │ │ │ │ -0000e000: 0a0a 2747 5255 425f 4746 5850 4159 4c4f ..'GRUB_GFXPAYLO │ │ │ │ -0000e010: 4144 5f4c 494e 5558 270a 2020 2020 2053 AD_LINUX'. S │ │ │ │ -0000e020: 6574 2074 6f20 2774 6578 7427 2074 6f20 et to 'text' to │ │ │ │ -0000e030: 666f 7263 6520 7468 6520 4c69 6e75 7820 force the Linux │ │ │ │ -0000e040: 6b65 726e 656c 2074 6f20 626f 6f74 2069 kernel to boot i │ │ │ │ -0000e050: 6e20 6e6f 726d 616c 2074 6578 740a 2020 n normal text. │ │ │ │ -0000e060: 2020 206d 6f64 652c 2027 6b65 6570 2720 mode, 'keep' │ │ │ │ -0000e070: 746f 2070 7265 7365 7276 6520 7468 6520 to preserve the │ │ │ │ -0000e080: 6772 6170 6869 6373 206d 6f64 6520 7365 graphics mode se │ │ │ │ -0000e090: 7420 7573 696e 670a 2020 2020 2027 4752 t using. 'GR │ │ │ │ -0000e0a0: 5542 5f47 4658 4d4f 4445 272c 2027 5749 UB_GFXMODE', 'WI │ │ │ │ -0000e0b0: 4454 4878 4845 4947 4854 275b 2778 4445 DTHxHEIGHT'['xDE │ │ │ │ -0000e0c0: 5054 4827 5d20 746f 2073 6574 2061 2070 PTH'] to set a p │ │ │ │ -0000e0d0: 6172 7469 6375 6c61 720a 2020 2020 2067 articular. g │ │ │ │ -0000e0e0: 7261 7068 6963 7320 6d6f 6465 2c20 6f72 raphics mode, or │ │ │ │ -0000e0f0: 2061 2073 6571 7565 6e63 6520 6f66 2074 a sequence of t │ │ │ │ -0000e100: 6865 7365 2073 6570 6172 6174 6564 2062 hese separated b │ │ │ │ -0000e110: 7920 636f 6d6d 6173 206f 720a 2020 2020 y commas or. │ │ │ │ -0000e120: 2073 656d 6963 6f6c 6f6e 7320 746f 2074 semicolons to t │ │ │ │ -0000e130: 7279 2073 6576 6572 616c 206d 6f64 6573 ry several modes │ │ │ │ -0000e140: 2069 6e20 7365 7175 656e 6365 2e20 202a in sequence. * │ │ │ │ -0000e150: 4e6f 7465 2067 6678 7061 796c 6f61 643a Note gfxpayload: │ │ │ │ -0000e160: 3a2e 0a0a 2020 2020 2044 6570 656e 6469 :... Dependi │ │ │ │ -0000e170: 6e67 206f 6e20 796f 7572 206b 6572 6e65 ng on your kerne │ │ │ │ -0000e180: 6c2c 2079 6f75 7220 6469 7374 7269 6275 l, your distribu │ │ │ │ -0000e190: 7469 6f6e 2c20 796f 7572 2067 7261 7068 tion, your graph │ │ │ │ -0000e1a0: 6963 7320 6361 7264 2c0a 2020 2020 2061 ics card,. a │ │ │ │ -0000e1b0: 6e64 2074 6865 2070 6861 7365 206f 6620 nd the phase of │ │ │ │ -0000e1c0: 7468 6520 6d6f 6f6e 2c20 6e6f 7465 2074 the moon, note t │ │ │ │ -0000e1d0: 6861 7420 7573 696e 6720 7468 6973 206f hat using this o │ │ │ │ -0000e1e0: 7074 696f 6e20 6d61 7920 6361 7573 650a ption may cause. │ │ │ │ -0000e1f0: 2020 2020 2047 4e55 2f4c 696e 7578 2074 GNU/Linux t │ │ │ │ -0000e200: 6f20 7375 6666 6572 2066 726f 6d20 7661 o suffer from va │ │ │ │ -0000e210: 7269 6f75 7320 6469 7370 6c61 7920 7072 rious display pr │ │ │ │ -0000e220: 6f62 6c65 6d73 2c20 7061 7274 6963 756c oblems, particul │ │ │ │ -0000e230: 6172 6c79 0a20 2020 2020 6475 7269 6e67 arly. during │ │ │ │ -0000e240: 2074 6865 2065 6172 6c79 2070 6172 7420 the early part │ │ │ │ -0000e250: 6f66 2074 6865 2062 6f6f 7420 7365 7175 of the boot sequ │ │ │ │ -0000e260: 656e 6365 2e20 2049 6620 796f 7520 6861 ence. If you ha │ │ │ │ -0000e270: 7665 2070 726f 626c 656d 732c 0a20 2020 ve problems,. │ │ │ │ -0000e280: 2020 7365 7420 7468 6973 206f 7074 696f set this optio │ │ │ │ -0000e290: 6e20 746f 2027 7465 7874 2720 616e 6420 n to 'text' and │ │ │ │ -0000e2a0: 4752 5542 2077 696c 6c20 7465 6c6c 204c GRUB will tell L │ │ │ │ -0000e2b0: 696e 7578 2074 6f20 626f 6f74 2069 6e0a inux to boot in. │ │ │ │ -0000e2c0: 2020 2020 206e 6f72 6d61 6c20 7465 7874 normal text │ │ │ │ -0000e2d0: 206d 6f64 652e 0a0a 2747 5255 425f 4449 mode...'GRUB_DI │ │ │ │ -0000e2e0: 5341 424c 455f 4f53 5f50 524f 4245 5227 SABLE_OS_PROBER' │ │ │ │ -0000e2f0: 0a20 2020 2020 4e6f 726d 616c 6c79 2c20 . Normally, │ │ │ │ -0000e300: 2767 7275 622d 6d6b 636f 6e66 6967 2720 'grub-mkconfig' │ │ │ │ -0000e310: 7769 6c6c 2074 7279 2074 6f20 7573 6520 will try to use │ │ │ │ -0000e320: 7468 6520 6578 7465 726e 616c 2027 6f73 the external 'os │ │ │ │ -0000e330: 2d70 726f 6265 7227 0a20 2020 2020 7072 -prober'. pr │ │ │ │ -0000e340: 6f67 7261 6d2c 2069 6620 696e 7374 616c ogram, if instal │ │ │ │ -0000e350: 6c65 642c 2074 6f20 6469 7363 6f76 6572 led, to discover │ │ │ │ -0000e360: 206f 7468 6572 206f 7065 7261 7469 6e67 other operating │ │ │ │ -0000e370: 2073 7973 7465 6d73 0a20 2020 2020 696e systems. in │ │ │ │ -0000e380: 7374 616c 6c65 6420 6f6e 2074 6865 2073 stalled on the s │ │ │ │ -0000e390: 616d 6520 7379 7374 656d 2061 6e64 2067 ame system and g │ │ │ │ -0000e3a0: 656e 6572 6174 6520 6170 7072 6f70 7269 enerate appropri │ │ │ │ -0000e3b0: 6174 6520 6d65 6e75 2065 6e74 7269 6573 ate menu entries │ │ │ │ -0000e3c0: 0a20 2020 2020 666f 7220 7468 656d 2e20 . for them. │ │ │ │ -0000e3d0: 2053 6574 2074 6869 7320 6f70 7469 6f6e Set this option │ │ │ │ -0000e3e0: 2074 6f20 2774 7275 6527 2074 6f20 6469 to 'true' to di │ │ │ │ -0000e3f0: 7361 626c 6520 7468 6973 2e0a 0a27 4752 sable this...'GR │ │ │ │ -0000e400: 5542 5f4f 535f 5052 4f42 4552 5f53 4b49 UB_OS_PROBER_SKI │ │ │ │ -0000e410: 505f 4c49 5354 270a 2020 2020 204c 6973 P_LIST'. Lis │ │ │ │ -0000e420: 7420 6f66 2073 7061 6365 2d73 6570 6172 t of space-separ │ │ │ │ -0000e430: 6174 6564 2046 5320 5555 4944 7320 6f66 ated FS UUIDs of │ │ │ │ -0000e440: 2066 696c 6573 7973 7465 6d73 2074 6f20 filesystems to │ │ │ │ -0000e450: 6265 2069 676e 6f72 6564 2066 726f 6d0a be ignored from. │ │ │ │ -0000e460: 2020 2020 206f 732d 7072 6f62 6572 206f os-prober o │ │ │ │ -0000e470: 7574 7075 742e 2020 466f 7220 6566 6920 utput. For efi │ │ │ │ -0000e480: 6368 6169 6e6c 6f61 6465 7273 2069 7427 chainloaders it' │ │ │ │ -0000e490: 7320 3c55 5549 443e 403c 4546 4920 4649 s @..'GRUB_DISAB │ │ │ │ -0000e4b0: 4c45 5f53 5542 4d45 4e55 270a 2020 2020 LE_SUBMENU'. │ │ │ │ -0000e4c0: 204e 6f72 6d61 6c6c 792c 2027 6772 7562 Normally, 'grub │ │ │ │ -0000e4d0: 2d6d 6b63 6f6e 6669 6727 2077 696c 6c20 -mkconfig' will │ │ │ │ -0000e4e0: 6765 6e65 7261 7465 2074 6f70 206c 6576 generate top lev │ │ │ │ -0000e4f0: 656c 206d 656e 7520 656e 7472 7920 666f el menu entry fo │ │ │ │ -0000e500: 720a 2020 2020 2074 6865 206b 6572 6e65 r. the kerne │ │ │ │ -0000e510: 6c20 7769 7468 2068 6967 6865 7374 2076 l with highest v │ │ │ │ -0000e520: 6572 7369 6f6e 206e 756d 6265 7220 616e ersion number an │ │ │ │ -0000e530: 6420 7075 7420 616c 6c20 6f74 6865 7220 d put all other │ │ │ │ -0000e540: 666f 756e 640a 2020 2020 206b 6572 6e65 found. kerne │ │ │ │ -0000e550: 6c73 206f 7220 616c 7465 726e 6174 6976 ls or alternativ │ │ │ │ -0000e560: 6520 6d65 6e75 2065 6e74 7269 6573 2066 e menu entries f │ │ │ │ -0000e570: 6f72 2072 6563 6f76 6572 7920 6d6f 6465 or recovery mode │ │ │ │ -0000e580: 2069 6e20 7375 626d 656e 752e 0a20 2020 in submenu.. │ │ │ │ -0000e590: 2020 466f 7220 656e 7472 6965 7320 7265 For entries re │ │ │ │ -0000e5a0: 7475 726e 6564 2062 7920 276f 732d 7072 turned by 'os-pr │ │ │ │ -0000e5b0: 6f62 6572 2720 6669 7273 7420 656e 7472 ober' first entr │ │ │ │ -0000e5c0: 7920 7769 6c6c 2062 6520 7075 7420 6f6e y will be put on │ │ │ │ -0000e5d0: 2074 6f70 0a20 2020 2020 6c65 7665 6c20 top. level │ │ │ │ -0000e5e0: 616e 6420 616c 6c20 6f74 6865 7273 2069 and all others i │ │ │ │ -0000e5f0: 6e20 7375 626d 656e 752e 2020 4966 2074 n submenu. If t │ │ │ │ -0000e600: 6869 7320 6f70 7469 6f6e 2069 7320 7365 his option is se │ │ │ │ -0000e610: 7420 746f 2027 7927 2c0a 2020 2020 2066 t to 'y',. f │ │ │ │ -0000e620: 6c61 7420 6d65 6e75 2077 6974 6820 616c lat menu with al │ │ │ │ -0000e630: 6c20 656e 7472 6965 7320 6f6e 2074 6f70 l entries on top │ │ │ │ -0000e640: 206c 6576 656c 2077 696c 6c20 6265 2067 level will be g │ │ │ │ -0000e650: 656e 6572 6174 6564 2069 6e73 7465 6164 enerated instead │ │ │ │ -0000e660: 2e0a 2020 2020 2043 6861 6e67 696e 6720 .. Changing │ │ │ │ -0000e670: 7468 6973 206f 7074 696f 6e20 7769 6c6c this option will │ │ │ │ -0000e680: 2072 6571 7569 7265 2063 6861 6e67 696e require changin │ │ │ │ -0000e690: 6720 6578 6973 7469 6e67 2076 616c 7565 g existing value │ │ │ │ -0000e6a0: 7320 6f66 0a20 2020 2020 2747 5255 425f s of. 'GRUB_ │ │ │ │ -0000e6b0: 4445 4641 554c 5427 2c20 2766 616c 6c62 DEFAULT', 'fallb │ │ │ │ -0000e6c0: 6163 6b27 2028 2a6e 6f74 6520 6661 6c6c ack' (*note fall │ │ │ │ -0000e6d0: 6261 636b 3a3a 2920 616e 6420 2764 6566 back::) and 'def │ │ │ │ -0000e6e0: 6175 6c74 2720 282a 6e6f 7465 0a20 2020 ault' (*note. │ │ │ │ -0000e6f0: 2020 6465 6661 756c 743a 3a29 2065 6e76 default::) env │ │ │ │ -0000e700: 6972 6f6e 6d65 6e74 2076 6172 6961 626c ironment variabl │ │ │ │ -0000e710: 6573 2061 7320 7765 6c6c 2061 7320 7361 es as well as sa │ │ │ │ -0000e720: 7665 6420 6465 6661 756c 7420 656e 7472 ved default entr │ │ │ │ -0000e730: 790a 2020 2020 2075 7369 6e67 2027 6772 y. using 'gr │ │ │ │ -0000e740: 7562 2d73 6574 2d64 6566 6175 6c74 2720 ub-set-default' │ │ │ │ -0000e750: 616e 6420 7661 6c75 6520 7573 6564 2077 and value used w │ │ │ │ -0000e760: 6974 6820 2767 7275 622d 7265 626f 6f74 ith 'grub-reboot │ │ │ │ -0000e770: 272e 0a0a 2747 5255 425f 454e 4142 4c45 '...'GRUB_ENABLE │ │ │ │ -0000e780: 5f43 5259 5054 4f44 4953 4b27 0a20 2020 _CRYPTODISK'. │ │ │ │ -0000e790: 2020 4966 2073 6574 2074 6f20 2779 272c If set to 'y', │ │ │ │ -0000e7a0: 2027 6772 7562 2d6d 6b63 6f6e 6669 6727 'grub-mkconfig' │ │ │ │ -0000e7b0: 2061 6e64 2027 6772 7562 2d69 6e73 7461 and 'grub-insta │ │ │ │ -0000e7c0: 6c6c 2720 7769 6c6c 2063 6865 636b 2066 ll' will check f │ │ │ │ -0000e7d0: 6f72 0a20 2020 2020 656e 6372 7970 7465 or. encrypte │ │ │ │ -0000e7e0: 6420 6469 736b 7320 616e 6420 6765 6e65 d disks and gene │ │ │ │ -0000e7f0: 7261 7465 2061 6464 6974 696f 6e61 6c20 rate additional │ │ │ │ -0000e800: 636f 6d6d 616e 6473 206e 6565 6465 6420 commands needed │ │ │ │ -0000e810: 746f 2061 6363 6573 730a 2020 2020 2074 to access. t │ │ │ │ -0000e820: 6865 6d20 6475 7269 6e67 2062 6f6f 742e hem during boot. │ │ │ │ -0000e830: 2020 4e6f 7465 2074 6861 7420 696e 2074 Note that in t │ │ │ │ -0000e840: 6869 7320 6361 7365 2075 6e61 7474 656e his case unatten │ │ │ │ -0000e850: 6465 6420 626f 6f74 2069 7320 6e6f 740a ded boot is not. │ │ │ │ -0000e860: 2020 2020 2070 6f73 7369 626c 6520 6265 possible be │ │ │ │ -0000e870: 6361 7573 6520 4752 5542 2077 696c 6c20 cause GRUB will │ │ │ │ -0000e880: 7761 6974 2066 6f72 2070 6173 7370 6872 wait for passphr │ │ │ │ -0000e890: 6173 6520 746f 2075 6e6c 6f63 6b20 656e ase to unlock en │ │ │ │ -0000e8a0: 6372 7970 7465 640a 2020 2020 2063 6f6e crypted. con │ │ │ │ -0000e8b0: 7461 696e 6572 2e0a 0a27 4752 5542 5f49 tainer...'GRUB_I │ │ │ │ -0000e8c0: 4e49 545f 5455 4e45 270a 2020 2020 2050 NIT_TUNE'. P │ │ │ │ -0000e8d0: 6c61 7920 6120 7475 6e65 206f 6e20 7468 lay a tune on th │ │ │ │ -0000e8e0: 6520 7370 6561 6b65 7220 7768 656e 2047 e speaker when G │ │ │ │ -0000e8f0: 5255 4220 7374 6172 7473 2e20 2054 6869 RUB starts. Thi │ │ │ │ -0000e900: 7320 6973 2070 6172 7469 6375 6c61 726c s is particularl │ │ │ │ -0000e910: 790a 2020 2020 2075 7365 6675 6c20 666f y. useful fo │ │ │ │ -0000e920: 7220 7573 6572 7320 756e 6162 6c65 2074 r users unable t │ │ │ │ -0000e930: 6f20 7365 6520 7468 6520 7363 7265 656e o see the screen │ │ │ │ -0000e940: 2e20 2054 6865 2076 616c 7565 206f 6620 . The value of │ │ │ │ -0000e950: 7468 6973 0a20 2020 2020 6f70 7469 6f6e this. option │ │ │ │ -0000e960: 2069 7320 7061 7373 6564 2064 6972 6563 is passed direc │ │ │ │ -0000e970: 746c 7920 746f 202a 6e6f 7465 2070 6c61 tly to *note pla │ │ │ │ -0000e980: 793a 3a2e 0a0a 2747 5255 425f 4241 4452 y::...'GRUB_BADR │ │ │ │ -0000e990: 414d 270a 2020 2020 2049 6620 7468 6973 AM'. If this │ │ │ │ -0000e9a0: 206f 7074 696f 6e20 6973 2073 6574 2c20 option is set, │ │ │ │ -0000e9b0: 4752 5542 2077 696c 6c20 6973 7375 6520 GRUB will issue │ │ │ │ -0000e9c0: 6120 2a6e 6f74 6520 6261 6472 616d 3a3a a *note badram:: │ │ │ │ -0000e9d0: 2063 6f6d 6d61 6e64 2074 6f0a 2020 2020 command to. │ │ │ │ -0000e9e0: 2066 696c 7465 7220 6f75 7420 7370 6563 filter out spec │ │ │ │ -0000e9f0: 6966 6965 6420 7265 6769 6f6e 7320 6f66 ified regions of │ │ │ │ -0000ea00: 2052 414d 2e0a 0a27 4752 5542 5f50 5245 RAM...'GRUB_PRE │ │ │ │ -0000ea10: 4c4f 4144 5f4d 4f44 554c 4553 270a 2020 LOAD_MODULES'. │ │ │ │ -0000ea20: 2020 2054 6869 7320 6f70 7469 6f6e 206d This option m │ │ │ │ -0000ea30: 6179 2062 6520 7365 7420 746f 2061 206c ay be set to a l │ │ │ │ -0000ea40: 6973 7420 6f66 2047 5255 4220 6d6f 6475 ist of GRUB modu │ │ │ │ -0000ea50: 6c65 206e 616d 6573 2073 6570 6172 6174 le names separat │ │ │ │ -0000ea60: 6564 2062 790a 2020 2020 2073 7061 6365 ed by. space │ │ │ │ -0000ea70: 732e 2020 4561 6368 206d 6f64 756c 6520 s. Each module │ │ │ │ -0000ea80: 7769 6c6c 2062 6520 6c6f 6164 6564 2061 will be loaded a │ │ │ │ -0000ea90: 7320 6561 726c 7920 6173 2070 6f73 7369 s early as possi │ │ │ │ -0000eaa0: 626c 652c 2061 7420 7468 650a 2020 2020 ble, at the. │ │ │ │ -0000eab0: 2073 7461 7274 206f 6620 2767 7275 622e start of 'grub. │ │ │ │ -0000eac0: 6366 6727 2e0a 0a27 4752 5542 5f52 4543 cfg'...'GRUB_REC │ │ │ │ -0000ead0: 4f52 4446 4149 4c5f 5449 4d45 4f55 5427 ORDFAIL_TIMEOUT' │ │ │ │ -0000eae0: 0a20 2020 2020 4966 2074 6869 7320 6f70 . If this op │ │ │ │ -0000eaf0: 7469 6f6e 2069 7320 7365 742c 2069 7420 tion is set, it │ │ │ │ -0000eb00: 6f76 6572 7269 6465 7320 7468 6520 6465 overrides the de │ │ │ │ -0000eb10: 6661 756c 7420 7265 636f 7264 6661 696c fault recordfail │ │ │ │ -0000eb20: 2073 6574 7469 6e67 2e0a 2020 2020 2041 setting.. A │ │ │ │ -0000eb30: 2073 6574 7469 6e67 206f 6620 2d31 2063 setting of -1 c │ │ │ │ -0000eb40: 6175 7365 7320 4752 5542 2074 6f20 7761 auses GRUB to wa │ │ │ │ -0000eb50: 6974 2066 6f72 2075 7365 7220 696e 7075 it for user inpu │ │ │ │ -0000eb60: 7420 696e 6465 6669 6e69 7465 6c79 2e0a t indefinitely.. │ │ │ │ -0000eb70: 2020 2020 2048 6f77 6576 6572 2c20 6120 However, a │ │ │ │ -0000eb80: 6661 6c73 6520 706f 7369 7469 7665 2069 false positive i │ │ │ │ -0000eb90: 6e20 7468 6520 7265 636f 7264 6661 696c n the recordfail │ │ │ │ -0000eba0: 206d 6563 6861 6e69 736d 206d 6179 206f mechanism may o │ │ │ │ -0000ebb0: 6363 7572 2069 660a 2020 2020 2070 6f77 ccur if. pow │ │ │ │ -0000ebc0: 6572 2069 7320 6c6f 7374 2064 7572 696e er is lost durin │ │ │ │ -0000ebd0: 6720 626f 6f74 2062 6566 6f72 6520 626f g boot before bo │ │ │ │ -0000ebe0: 6f74 2073 7563 6365 7373 2069 7320 7265 ot success is re │ │ │ │ -0000ebf0: 636f 7264 6564 2069 6e0a 2020 2020 2075 corded in. u │ │ │ │ -0000ec00: 7365 7273 7061 6365 2e20 2054 6865 2064 serspace. The d │ │ │ │ -0000ec10: 6566 6175 6c74 2073 6574 7469 6e67 2069 efault setting i │ │ │ │ -0000ec20: 7320 3330 2c20 7768 6963 6820 6361 7573 s 30, which caus │ │ │ │ -0000ec30: 6573 2047 5255 4220 746f 2077 6169 740a es GRUB to wait. │ │ │ │ -0000ec40: 2020 2020 2066 6f72 2075 7365 7220 696e for user in │ │ │ │ -0000ec50: 7075 7420 666f 7220 7468 6972 7479 2073 put for thirty s │ │ │ │ -0000ec60: 6563 6f6e 6473 2062 6566 6f72 6520 636f econds before co │ │ │ │ -0000ec70: 6e74 696e 7569 6e67 2e20 2054 6869 7320 ntinuing. This │ │ │ │ -0000ec80: 6465 6661 756c 740a 2020 2020 2061 6c6c default. all │ │ │ │ -0000ec90: 6f77 7320 696e 7465 7261 6374 6976 6520 ows interactive │ │ │ │ -0000eca0: 7573 6572 7320 7468 6520 6f70 706f 7274 users the opport │ │ │ │ -0000ecb0: 756e 6974 7920 746f 2073 7769 7463 6820 unity to switch │ │ │ │ -0000ecc0: 746f 2061 2064 6966 6665 7265 6e74 2c0a to a different,. │ │ │ │ -0000ecd0: 2020 2020 2077 6f72 6b69 6e67 206b 6572 working ker │ │ │ │ -0000ece0: 6e65 6c2c 2077 6869 6c65 2061 766f 6964 nel, while avoid │ │ │ │ -0000ecf0: 696e 6720 6120 6661 6c73 6520 706f 7369 ing a false posi │ │ │ │ -0000ed00: 7469 7665 2063 6175 7369 6e67 2074 6865 tive causing the │ │ │ │ -0000ed10: 2062 6f6f 7420 746f 0a20 2020 2020 626c boot to. bl │ │ │ │ -0000ed20: 6f63 6b20 696e 6465 6669 6e69 7465 6c79 ock indefinitely │ │ │ │ -0000ed30: 206f 6e20 6865 6164 6c65 7373 2061 6e64 on headless and │ │ │ │ -0000ed40: 2061 7070 6c69 616e 6365 2073 7973 7465 appliance syste │ │ │ │ -0000ed50: 6d73 2077 6865 7265 2061 6363 6573 730a ms where access. │ │ │ │ -0000ed60: 2020 2020 2074 6f20 6120 636f 6e73 6f6c to a consol │ │ │ │ -0000ed70: 6520 6973 2072 6573 7472 6963 7465 6420 e is restricted │ │ │ │ -0000ed80: 6f72 206c 696d 6974 6564 2e0a 0a20 2020 or limited... │ │ │ │ -0000ed90: 2020 5468 6973 206f 7074 696f 6e20 6973 This option is │ │ │ │ -0000eda0: 206f 6e6c 7920 6566 6665 6374 6976 6520 only effective │ │ │ │ -0000edb0: 7768 656e 2047 5255 4220 7761 7320 636f when GRUB was co │ │ │ │ -0000edc0: 6e66 6967 7572 6564 2077 6974 6820 7468 nfigured with th │ │ │ │ -0000edd0: 650a 2020 2020 2027 2d2d 656e 6162 6c65 e. '--enable │ │ │ │ -0000ede0: 2d71 7569 636b 2d62 6f6f 7427 206f 7074 -quick-boot' opt │ │ │ │ -0000edf0: 696f 6e2e 0a0a 2747 5255 425f 5245 434f ion...'GRUB_RECO │ │ │ │ -0000ee00: 5645 5259 5f54 4954 4c45 270a 2020 2020 VERY_TITLE'. │ │ │ │ -0000ee10: 2054 6869 7320 6f70 7469 6f6e 2073 6574 This option set │ │ │ │ -0000ee20: 7320 7468 6520 456e 676c 6973 6820 7465 s the English te │ │ │ │ -0000ee30: 7874 206f 6620 7468 6520 7374 7269 6e67 xt of the string │ │ │ │ -0000ee40: 2074 6861 7420 7769 6c6c 2062 650a 2020 that will be. │ │ │ │ -0000ee50: 2020 2064 6973 706c 6179 6564 2069 6e20 displayed in │ │ │ │ -0000ee60: 7061 7265 6e74 6865 7365 7320 746f 2069 parentheses to i │ │ │ │ -0000ee70: 6e64 6963 6174 6520 7468 6174 2061 2062 ndicate that a b │ │ │ │ -0000ee80: 6f6f 7420 6f70 7469 6f6e 2069 7320 7072 oot option is pr │ │ │ │ -0000ee90: 6f76 6964 6564 0a20 2020 2020 746f 2068 ovided. to h │ │ │ │ -0000eea0: 656c 7020 7573 6572 7320 7265 636f 7665 elp users recove │ │ │ │ -0000eeb0: 7220 6120 6272 6f6b 656e 2073 7973 7465 r a broken syste │ │ │ │ -0000eec0: 6d2e 2020 5468 6520 6465 6661 756c 7420 m. The default │ │ │ │ -0000eed0: 6973 2022 7265 636f 7665 7279 0a20 2020 is "recovery. │ │ │ │ -0000eee0: 2020 6d6f 6465 222e 0a0a 2020 2054 6865 mode"... The │ │ │ │ -0000eef0: 2066 6f6c 6c6f 7769 6e67 206f 7074 696f following optio │ │ │ │ -0000ef00: 6e73 2061 7265 2073 7469 6c6c 2061 6363 ns are still acc │ │ │ │ -0000ef10: 6570 7465 6420 666f 7220 636f 6d70 6174 epted for compat │ │ │ │ -0000ef20: 6962 696c 6974 7920 7769 7468 0a65 7869 ibility with.exi │ │ │ │ -0000ef30: 7374 696e 6720 636f 6e66 6967 7572 6174 sting configurat │ │ │ │ -0000ef40: 696f 6e73 2c20 6275 7420 6861 7665 2062 ions, but have b │ │ │ │ -0000ef50: 6574 7465 7220 7265 706c 6163 656d 656e etter replacemen │ │ │ │ -0000ef60: 7473 3a0a 0a27 4752 5542 5f48 4944 4445 ts:..'GRUB_HIDDE │ │ │ │ -0000ef70: 4e5f 5449 4d45 4f55 5427 0a20 2020 2020 N_TIMEOUT'. │ │ │ │ -0000ef80: 5761 6974 2074 6869 7320 6d61 6e79 2073 Wait this many s │ │ │ │ -0000ef90: 6563 6f6e 6473 2062 6566 6f72 6520 6469 econds before di │ │ │ │ -0000efa0: 7370 6c61 7969 6e67 2074 6865 206d 656e splaying the men │ │ │ │ -0000efb0: 752e 2020 4966 203c 4553 433e 2069 730a u. If is. │ │ │ │ -0000efc0: 2020 2020 2070 7265 7373 6564 2064 7572 pressed dur │ │ │ │ -0000efd0: 696e 6720 7468 6174 2074 696d 652c 2064 ing that time, d │ │ │ │ -0000efe0: 6973 706c 6179 2074 6865 206d 656e 7520 isplay the menu │ │ │ │ -0000eff0: 616e 6420 7761 6974 2066 6f72 2069 6e70 and wait for inp │ │ │ │ -0000f000: 7574 0a20 2020 2020 6163 636f 7264 696e ut. accordin │ │ │ │ -0000f010: 6720 746f 2027 4752 5542 5f54 494d 454f g to 'GRUB_TIMEO │ │ │ │ -0000f020: 5554 272e 2020 4966 2061 2068 6f74 6b65 UT'. If a hotke │ │ │ │ -0000f030: 7920 6173 736f 6369 6174 6564 2077 6974 y associated wit │ │ │ │ -0000f040: 6820 6120 6d65 6e75 0a20 2020 2020 656e h a menu. en │ │ │ │ -0000f050: 7472 7920 6973 2070 7265 7373 6564 2c20 try is pressed, │ │ │ │ -0000f060: 626f 6f74 2074 6865 2061 7373 6f63 6961 boot the associa │ │ │ │ -0000f070: 7465 6420 6d65 6e75 2065 6e74 7279 2069 ted menu entry i │ │ │ │ -0000f080: 6d6d 6564 6961 7465 6c79 2e20 2049 660a mmediately. If. │ │ │ │ -0000f090: 2020 2020 2074 6865 2074 696d 656f 7574 the timeout │ │ │ │ -0000f0a0: 2065 7870 6972 6573 2062 6566 6f72 6520 expires before │ │ │ │ -0000f0b0: 6569 7468 6572 206f 6620 7468 6573 6520 either of these │ │ │ │ -0000f0c0: 6861 7070 656e 732c 2064 6973 706c 6179 happens, display │ │ │ │ -0000f0d0: 2074 6865 0a20 2020 2020 6d65 6e75 2066 the. menu f │ │ │ │ -0000f0e0: 6f72 2074 6865 206e 756d 6265 7220 6f66 or the number of │ │ │ │ -0000f0f0: 2073 6563 6f6e 6473 2073 7065 6369 6669 seconds specifi │ │ │ │ -0000f100: 6564 2069 6e20 2747 5255 425f 5449 4d45 ed in 'GRUB_TIME │ │ │ │ -0000f110: 4f55 5427 2062 6566 6f72 650a 2020 2020 OUT' before. │ │ │ │ -0000f120: 2062 6f6f 7469 6e67 2074 6865 2064 6566 booting the def │ │ │ │ -0000f130: 6175 6c74 2065 6e74 7279 2e0a 0a20 2020 ault entry... │ │ │ │ -0000f140: 2020 4966 2079 6f75 2073 6574 2027 4752 If you set 'GR │ │ │ │ -0000f150: 5542 5f48 4944 4445 4e5f 5449 4d45 4f55 UB_HIDDEN_TIMEOU │ │ │ │ -0000f160: 5427 2c20 796f 7520 7368 6f75 6c64 2061 T', you should a │ │ │ │ -0000f170: 6c73 6f20 7365 740a 2020 2020 2027 4752 lso set. 'GR │ │ │ │ -0000f180: 5542 5f54 494d 454f 5554 3d30 2720 736f UB_TIMEOUT=0' so │ │ │ │ -0000f190: 2074 6861 7420 7468 6520 6d65 6e75 2069 that the menu i │ │ │ │ -0000f1a0: 7320 6e6f 7420 6469 7370 6c61 7965 6420 s not displayed │ │ │ │ -0000f1b0: 6174 2061 6c6c 2075 6e6c 6573 730a 2020 at all unless. │ │ │ │ -0000f1c0: 2020 203c 4553 433e 2069 7320 7072 6573 is pres │ │ │ │ -0000f1d0: 7365 642e 0a0a 2020 2020 2054 6869 7320 sed... This │ │ │ │ -0000f1e0: 6f70 7469 6f6e 2069 7320 756e 7365 7420 option is unset │ │ │ │ -0000f1f0: 6279 2064 6566 6175 6c74 2c20 616e 6420 by default, and │ │ │ │ -0000f200: 6973 2064 6570 7265 6361 7465 6420 696e is deprecated in │ │ │ │ -0000f210: 2066 6176 6f75 7220 6f66 2074 6865 0a20 favour of the. │ │ │ │ -0000f220: 2020 2020 6c65 7373 2063 6f6e 6675 7369 less confusi │ │ │ │ -0000f230: 6e67 2027 4752 5542 5f54 494d 454f 5554 ng 'GRUB_TIMEOUT │ │ │ │ -0000f240: 5f53 5459 4c45 3d63 6f75 6e74 646f 776e _STYLE=countdown │ │ │ │ -0000f250: 2720 6f72 0a20 2020 2020 2747 5255 425f ' or. 'GRUB_ │ │ │ │ -0000f260: 5449 4d45 4f55 545f 5354 594c 453d 6869 TIMEOUT_STYLE=hi │ │ │ │ -0000f270: 6464 656e 272e 0a0a 2747 5255 425f 4849 dden'...'GRUB_HI │ │ │ │ -0000f280: 4444 454e 5f54 494d 454f 5554 5f51 5549 DDEN_TIMEOUT_QUI │ │ │ │ -0000f290: 4554 270a 2020 2020 2049 6e20 636f 6e6a ET'. In conj │ │ │ │ -0000f2a0: 756e 6374 696f 6e20 7769 7468 2027 4752 unction with 'GR │ │ │ │ -0000f2b0: 5542 5f48 4944 4445 4e5f 5449 4d45 4f55 UB_HIDDEN_TIMEOU │ │ │ │ -0000f2c0: 5427 2c20 7365 7420 7468 6973 2074 6f20 T', set this to │ │ │ │ -0000f2d0: 2774 7275 6527 2074 6f0a 2020 2020 2073 'true' to. s │ │ │ │ -0000f2e0: 7570 7072 6573 7320 7468 6520 7665 7262 uppress the verb │ │ │ │ -0000f2f0: 6f73 6520 636f 756e 7464 6f77 6e20 7768 ose countdown wh │ │ │ │ -0000f300: 696c 6520 7761 6974 696e 6720 666f 7220 ile waiting for │ │ │ │ -0000f310: 6120 6b65 7920 746f 2062 650a 2020 2020 a key to be. │ │ │ │ -0000f320: 2070 7265 7373 6564 2062 6566 6f72 6520 pressed before │ │ │ │ -0000f330: 6469 7370 6c61 7969 6e67 2074 6865 206d displaying the m │ │ │ │ -0000f340: 656e 752e 0a0a 2020 2020 2054 6869 7320 enu... This │ │ │ │ -0000f350: 6f70 7469 6f6e 2069 7320 756e 7365 7420 option is unset │ │ │ │ -0000f360: 6279 2064 6566 6175 6c74 2c20 616e 6420 by default, and │ │ │ │ -0000f370: 6973 2064 6570 7265 6361 7465 6420 696e is deprecated in │ │ │ │ -0000f380: 2066 6176 6f75 7220 6f66 2074 6865 0a20 favour of the. │ │ │ │ -0000f390: 2020 2020 6c65 7373 2063 6f6e 6675 7369 less confusi │ │ │ │ -0000f3a0: 6e67 2027 4752 5542 5f54 494d 454f 5554 ng 'GRUB_TIMEOUT │ │ │ │ -0000f3b0: 5f53 5459 4c45 3d63 6f75 6e74 646f 776e _STYLE=countdown │ │ │ │ -0000f3c0: 272e 0a0a 2747 5255 425f 4849 4444 454e '...'GRUB_HIDDEN │ │ │ │ -0000f3d0: 5f54 494d 454f 5554 5f42 5554 544f 4e27 _TIMEOUT_BUTTON' │ │ │ │ -0000f3e0: 0a20 2020 2020 5661 7269 616e 7420 6f66 . Variant of │ │ │ │ -0000f3f0: 2027 4752 5542 5f48 4944 4445 4e5f 5449 'GRUB_HIDDEN_TI │ │ │ │ -0000f400: 4d45 4f55 5427 2c20 7573 6564 2074 6f20 MEOUT', used to │ │ │ │ -0000f410: 7375 7070 6f72 7420 7665 6e64 6f72 2d73 support vendor-s │ │ │ │ -0000f420: 7065 6369 6669 630a 2020 2020 2070 6f77 pecific. pow │ │ │ │ -0000f430: 6572 2062 7574 746f 6e73 2e20 202a 4e6f er buttons. *No │ │ │ │ -0000f440: 7465 2056 656e 646f 7220 706f 7765 722d te Vendor power- │ │ │ │ -0000f450: 6f6e 206b 6579 733a 3a2e 0a0a 2020 2020 on keys::... │ │ │ │ -0000f460: 2054 6869 7320 6f70 7469 6f6e 2069 7320 This option is │ │ │ │ -0000f470: 756e 7365 7420 6279 2064 6566 6175 6c74 unset by default │ │ │ │ -0000f480: 2c20 616e 6420 6973 2064 6570 7265 6361 , and is depreca │ │ │ │ -0000f490: 7465 6420 696e 2066 6176 6f75 7220 6f66 ted in favour of │ │ │ │ -0000f4a0: 2074 6865 0a20 2020 2020 6c65 7373 2063 the. less c │ │ │ │ -0000f4b0: 6f6e 6675 7369 6e67 2027 4752 5542 5f54 onfusing 'GRUB_T │ │ │ │ -0000f4c0: 494d 454f 5554 5f53 5459 4c45 3d63 6f75 IMEOUT_STYLE=cou │ │ │ │ -0000f4d0: 6e74 646f 776e 2720 6f72 0a20 2020 2020 ntdown' or. │ │ │ │ -0000f4e0: 2747 5255 425f 5449 4d45 4f55 545f 5354 'GRUB_TIMEOUT_ST │ │ │ │ -0000f4f0: 594c 453d 6869 6464 656e 272e 0a0a 2020 YLE=hidden'... │ │ │ │ -0000f500: 2046 6f72 206d 6f72 6520 6465 7461 696c For more detail │ │ │ │ -0000f510: 6564 2063 7573 746f 6d69 7361 7469 6f6e ed customisation │ │ │ │ -0000f520: 206f 6620 2767 7275 622d 6d6b 636f 6e66 of 'grub-mkconf │ │ │ │ -0000f530: 6967 2727 7320 6f75 7470 7574 2c20 796f ig''s output, yo │ │ │ │ -0000f540: 7520 6d61 790a 6564 6974 2074 6865 2073 u may.edit the s │ │ │ │ -0000f550: 6372 6970 7473 2069 6e20 272f 6574 632f cripts in '/etc/ │ │ │ │ -0000f560: 6772 7562 2e64 2720 6469 7265 6374 6c79 grub.d' directly │ │ │ │ -0000f570: 2e20 2027 2f65 7463 2f67 7275 622e 642f . '/etc/grub.d/ │ │ │ │ -0000f580: 3430 5f63 7573 746f 6d27 2069 730a 7061 40_custom' is.pa │ │ │ │ -0000f590: 7274 6963 756c 6172 6c79 2075 7365 6675 rticularly usefu │ │ │ │ -0000f5a0: 6c20 666f 7220 6164 6469 6e67 2065 6e74 l for adding ent │ │ │ │ -0000f5b0: 6972 6520 6375 7374 6f6d 206d 656e 7520 ire custom menu │ │ │ │ -0000f5c0: 656e 7472 6965 733b 2073 696d 706c 7920 entries; simply │ │ │ │ -0000f5d0: 7479 7065 0a74 6865 206d 656e 7520 656e type.the menu en │ │ │ │ -0000f5e0: 7472 6965 7320 796f 7520 7761 6e74 2074 tries you want t │ │ │ │ -0000f5f0: 6f20 6164 6420 6174 2074 6865 2065 6e64 o add at the end │ │ │ │ -0000f600: 206f 6620 7468 6174 2066 696c 652c 206d of that file, m │ │ │ │ -0000f610: 616b 696e 6720 7375 7265 2074 6f0a 6c65 aking sure to.le │ │ │ │ -0000f620: 6176 6520 6174 206c 6561 7374 2074 6865 ave at least the │ │ │ │ -0000f630: 2066 6972 7374 2074 776f 206c 696e 6573 first two lines │ │ │ │ -0000f640: 2069 6e74 6163 742e 0a0a 1f0a 4669 6c65 intact.....File │ │ │ │ -0000f650: 3a20 6772 7562 2e69 6e66 6f2c 2020 4e6f : grub.info, No │ │ │ │ -0000f660: 6465 3a20 526f 6f74 2049 6465 6e74 6966 de: Root Identif │ │ │ │ -0000f670: 6361 7469 6f6e 2048 6575 7269 7374 6963 cation Heuristic │ │ │ │ -0000f680: 732c 2020 4e65 7874 3a20 5368 656c 6c2d s, Next: Shell- │ │ │ │ -0000f690: 6c69 6b65 2073 6372 6970 7469 6e67 2c20 like scripting, │ │ │ │ -0000f6a0: 2050 7265 763a 2053 696d 706c 6520 636f Prev: Simple co │ │ │ │ -0000f6b0: 6e66 6967 7572 6174 696f 6e2c 2020 5570 nfiguration, Up │ │ │ │ -0000f6c0: 3a20 436f 6e66 6967 7572 6174 696f 6e0a : Configuration. │ │ │ │ -0000f6d0: 0a36 2e32 2052 6f6f 7420 4964 656e 7469 .6.2 Root Identi │ │ │ │ -0000f6e0: 6663 6174 696f 6e20 4865 7572 6973 7469 fcation Heuristi │ │ │ │ -0000f6f0: 6373 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d cs.============= │ │ │ │ +0000b660: 3d3d 3d3d 3d3d 3d0a 0a54 6865 2070 726f =======..The pro │ │ │ │ +0000b670: 6772 616d 2027 6772 7562 2d6d 6b63 6f6e gram 'grub-mkcon │ │ │ │ +0000b680: 6669 6727 2028 2a6e 6f74 6520 496e 766f fig' (*note Invo │ │ │ │ +0000b690: 6b69 6e67 2067 7275 622d 6d6b 636f 6e66 king grub-mkconf │ │ │ │ +0000b6a0: 6967 3a3a 2920 6765 6e65 7261 7465 730a ig::) generates. │ │ │ │ +0000b6b0: 2767 7275 622e 6366 6727 2066 696c 6573 'grub.cfg' files │ │ │ │ +0000b6c0: 2073 7569 7461 626c 6520 666f 7220 6d6f suitable for mo │ │ │ │ +0000b6d0: 7374 2063 6173 6573 2e20 2049 7420 6973 st cases. It is │ │ │ │ +0000b6e0: 2073 7569 7461 626c 6520 666f 7220 7573 suitable for us │ │ │ │ +0000b6f0: 6520 7768 656e 0a75 7067 7261 6469 6e67 e when.upgrading │ │ │ │ +0000b700: 2061 2064 6973 7472 6962 7574 696f 6e2c a distribution, │ │ │ │ +0000b710: 2061 6e64 2077 696c 6c20 6469 7363 6f76 and will discov │ │ │ │ +0000b720: 6572 2061 7661 696c 6162 6c65 206b 6572 er available ker │ │ │ │ +0000b730: 6e65 6c73 2061 6e64 0a61 7474 656d 7074 nels and.attempt │ │ │ │ +0000b740: 2074 6f20 6765 6e65 7261 7465 206d 656e to generate men │ │ │ │ +0000b750: 7520 656e 7472 6965 7320 666f 7220 7468 u entries for th │ │ │ │ +0000b760: 656d 2e0a 0a20 2020 2767 7275 622d 6d6b em... 'grub-mk │ │ │ │ +0000b770: 636f 6e66 6967 2720 646f 6573 2068 6176 config' does hav │ │ │ │ +0000b780: 6520 736f 6d65 206c 696d 6974 6174 696f e some limitatio │ │ │ │ +0000b790: 6e73 2e20 2057 6869 6c65 2061 6464 696e ns. While addin │ │ │ │ +0000b7a0: 6720 6578 7472 610a 6375 7374 6f6d 206d g extra.custom m │ │ │ │ +0000b7b0: 656e 7520 656e 7472 6965 7320 746f 2074 enu entries to t │ │ │ │ +0000b7c0: 6865 2065 6e64 206f 6620 7468 6520 6c69 he end of the li │ │ │ │ +0000b7d0: 7374 2063 616e 2062 6520 646f 6e65 2062 st can be done b │ │ │ │ +0000b7e0: 7920 6564 6974 696e 670a 272f 6574 632f y editing.'/etc/ │ │ │ │ +0000b7f0: 6772 7562 2e64 2f34 305f 6375 7374 6f6d grub.d/40_custom │ │ │ │ +0000b800: 2720 6f72 2063 7265 6174 696e 6720 272f ' or creating '/ │ │ │ │ +0000b810: 626f 6f74 2f67 7275 622f 6375 7374 6f6d boot/grub/custom │ │ │ │ +0000b820: 2e63 6667 272c 2063 6861 6e67 696e 670a .cfg', changing. │ │ │ │ +0000b830: 7468 6520 6f72 6465 7220 6f66 206d 656e the order of men │ │ │ │ +0000b840: 7520 656e 7472 6965 7320 6f72 2063 6861 u entries or cha │ │ │ │ +0000b850: 6e67 696e 6720 7468 6569 7220 7469 746c nging their titl │ │ │ │ +0000b860: 6573 206d 6179 2072 6571 7569 7265 206d es may require m │ │ │ │ +0000b870: 616b 696e 670a 636f 6d70 6c65 7820 6368 aking.complex ch │ │ │ │ +0000b880: 616e 6765 7320 746f 2073 6865 6c6c 2073 anges to shell s │ │ │ │ +0000b890: 6372 6970 7473 2073 746f 7265 6420 696e cripts stored in │ │ │ │ +0000b8a0: 2027 2f65 7463 2f67 7275 622e 642f 272e '/etc/grub.d/'. │ │ │ │ +0000b8b0: 2020 5468 6973 206d 6179 2062 650a 696d This may be.im │ │ │ │ +0000b8c0: 7072 6f76 6564 2069 6e20 7468 6520 6675 proved in the fu │ │ │ │ +0000b8d0: 7475 7265 2e20 2049 6e20 7468 6520 6d65 ture. In the me │ │ │ │ +0000b8e0: 616e 7469 6d65 2c20 7468 6f73 6520 7768 antime, those wh │ │ │ │ +0000b8f0: 6f20 6665 656c 2074 6861 7420 6974 2077 o feel that it w │ │ │ │ +0000b900: 6f75 6c64 0a62 6520 6561 7369 6572 2074 ould.be easier t │ │ │ │ +0000b910: 6f20 7772 6974 6520 2767 7275 622e 6366 o write 'grub.cf │ │ │ │ +0000b920: 6727 2064 6972 6563 746c 7920 6172 6520 g' directly are │ │ │ │ +0000b930: 656e 636f 7572 6167 6564 2074 6f20 646f encouraged to do │ │ │ │ +0000b940: 2073 6f20 282a 6e6f 7465 0a42 6f6f 7469 so (*note.Booti │ │ │ │ +0000b950: 6e67 3a3a 2c20 616e 6420 2a6e 6f74 6520 ng::, and *note │ │ │ │ +0000b960: 5368 656c 6c2d 6c69 6b65 2073 6372 6970 Shell-like scrip │ │ │ │ +0000b970: 7469 6e67 3a3a 292c 2061 6e64 2074 6f20 ting::), and to │ │ │ │ +0000b980: 6469 7361 626c 6520 616e 7920 7379 7374 disable any syst │ │ │ │ +0000b990: 656d 0a70 726f 7669 6465 6420 6279 2074 em.provided by t │ │ │ │ +0000b9a0: 6865 6972 2064 6973 7472 6962 7574 696f heir distributio │ │ │ │ +0000b9b0: 6e20 746f 2061 7574 6f6d 6174 6963 616c n to automatical │ │ │ │ +0000b9c0: 6c79 2072 756e 2027 6772 7562 2d6d 6b63 ly run 'grub-mkc │ │ │ │ +0000b9d0: 6f6e 6669 6727 2e0a 0a20 2020 5468 6520 onfig'... The │ │ │ │ +0000b9e0: 6669 6c65 2027 2f65 7463 2f64 6566 6175 file '/etc/defau │ │ │ │ +0000b9f0: 6c74 2f67 7275 6227 2063 6f6e 7472 6f6c lt/grub' control │ │ │ │ +0000ba00: 7320 7468 6520 6f70 6572 6174 696f 6e20 s the operation │ │ │ │ +0000ba10: 6f66 0a27 6772 7562 2d6d 6b63 6f6e 6669 of.'grub-mkconfi │ │ │ │ +0000ba20: 6727 2e20 2049 7420 6973 2073 6f75 7263 g'. It is sourc │ │ │ │ +0000ba30: 6564 2062 7920 6120 7368 656c 6c20 7363 ed by a shell sc │ │ │ │ +0000ba40: 7269 7074 2c20 616e 6420 736f 206d 7573 ript, and so mus │ │ │ │ +0000ba50: 7420 6265 2076 616c 6964 0a50 4f53 4958 t be valid.POSIX │ │ │ │ +0000ba60: 2073 6865 6c6c 2069 6e70 7574 3b20 6e6f shell input; no │ │ │ │ +0000ba70: 726d 616c 6c79 2c20 6974 2077 696c 6c20 rmally, it will │ │ │ │ +0000ba80: 6a75 7374 2062 6520 6120 7365 7175 656e just be a sequen │ │ │ │ +0000ba90: 6365 206f 6620 274b 4559 3d76 616c 7565 ce of 'KEY=value │ │ │ │ +0000baa0: 270a 6c69 6e65 732c 2062 7574 2069 6620 '.lines, but if │ │ │ │ +0000bab0: 7468 6520 7661 6c75 6520 636f 6e74 6169 the value contai │ │ │ │ +0000bac0: 6e73 2073 7061 6365 7320 6f72 206f 7468 ns spaces or oth │ │ │ │ +0000bad0: 6572 2073 7065 6369 616c 2063 6861 7261 er special chara │ │ │ │ +0000bae0: 6374 6572 7320 7468 656e 0a69 7420 6d75 cters then.it mu │ │ │ │ +0000baf0: 7374 2062 6520 7175 6f74 6564 2e20 2046 st be quoted. F │ │ │ │ +0000bb00: 6f72 2065 7861 6d70 6c65 3a0a 0a20 2020 or example:.. │ │ │ │ +0000bb10: 2020 4752 5542 5f54 4552 4d49 4e41 4c5f GRUB_TERMINAL_ │ │ │ │ +0000bb20: 494e 5055 543d 2263 6f6e 736f 6c65 2073 INPUT="console s │ │ │ │ +0000bb30: 6572 6961 6c22 0a0a 2020 2056 616c 6964 erial".. Valid │ │ │ │ +0000bb40: 206b 6579 7320 696e 2027 2f65 7463 2f64 keys in '/etc/d │ │ │ │ +0000bb50: 6566 6175 6c74 2f67 7275 6227 2061 7265 efault/grub' are │ │ │ │ +0000bb60: 2061 7320 666f 6c6c 6f77 733a 0a0a 2747 as follows:..'G │ │ │ │ +0000bb70: 5255 425f 4445 4641 554c 5427 0a20 2020 RUB_DEFAULT'. │ │ │ │ +0000bb80: 2020 5468 6520 6465 6661 756c 7420 6d65 The default me │ │ │ │ +0000bb90: 6e75 2065 6e74 7279 2e20 2054 6869 7320 nu entry. This │ │ │ │ +0000bba0: 6d61 7920 6265 2061 206e 756d 6265 722c may be a number, │ │ │ │ +0000bbb0: 2069 6e20 7768 6963 6820 6361 7365 2069 in which case i │ │ │ │ +0000bbc0: 740a 2020 2020 2069 6465 6e74 6966 6965 t. identifie │ │ │ │ +0000bbd0: 7320 7468 6520 4e74 6820 656e 7472 7920 s the Nth entry │ │ │ │ +0000bbe0: 696e 2074 6865 2067 656e 6572 6174 6564 in the generated │ │ │ │ +0000bbf0: 206d 656e 7520 636f 756e 7465 6420 6672 menu counted fr │ │ │ │ +0000bc00: 6f6d 207a 6572 6f2c 0a20 2020 2020 6f72 om zero,. or │ │ │ │ +0000bc10: 2074 6865 2074 6974 6c65 206f 6620 6120 the title of a │ │ │ │ +0000bc20: 6d65 6e75 2065 6e74 7279 2c20 6f72 2074 menu entry, or t │ │ │ │ +0000bc30: 6865 2073 7065 6369 616c 2073 7472 696e he special strin │ │ │ │ +0000bc40: 6720 2773 6176 6564 272e 2020 5573 696e g 'saved'. Usin │ │ │ │ +0000bc50: 670a 2020 2020 2074 6865 2069 6420 6d61 g. the id ma │ │ │ │ +0000bc60: 7920 6265 2075 7365 6675 6c20 6966 2079 y be useful if y │ │ │ │ +0000bc70: 6f75 2077 616e 7420 746f 2073 6574 2061 ou want to set a │ │ │ │ +0000bc80: 206d 656e 7520 656e 7472 7920 6173 2074 menu entry as t │ │ │ │ +0000bc90: 6865 2064 6566 6175 6c74 0a20 2020 2020 he default. │ │ │ │ +0000bca0: 6576 656e 2074 686f 7567 6820 7468 6572 even though ther │ │ │ │ +0000bcb0: 6520 6d61 7920 6265 2061 2076 6172 6961 e may be a varia │ │ │ │ +0000bcc0: 626c 6520 6e75 6d62 6572 206f 6620 656e ble number of en │ │ │ │ +0000bcd0: 7472 6965 7320 6265 666f 7265 2069 742e tries before it. │ │ │ │ +0000bce0: 0a0a 2020 2020 2046 6f72 2065 7861 6d70 .. For examp │ │ │ │ +0000bcf0: 6c65 2c20 6966 2079 6f75 2068 6176 653a le, if you have: │ │ │ │ +0000bd00: 0a0a 2020 2020 206d 656e 7565 6e74 7279 .. menuentry │ │ │ │ +0000bd10: 2027 4578 616d 706c 6520 474e 552f 4c69 'Example GNU/Li │ │ │ │ +0000bd20: 6e75 7820 6469 7374 7269 6275 7469 6f6e nux distribution │ │ │ │ +0000bd30: 2720 2d2d 636c 6173 7320 676e 752d 6c69 ' --class gnu-li │ │ │ │ +0000bd40: 6e75 7820 2d2d 6964 2065 7861 6d70 6c65 nux --id example │ │ │ │ +0000bd50: 2d67 6e75 2d6c 696e 7578 207b 0a20 2020 -gnu-linux {. │ │ │ │ +0000bd60: 2020 092e 2e2e 0a20 2020 2020 7d0a 0a20 ..... }.. │ │ │ │ +0000bd70: 2020 2020 7468 656e 2079 6f75 2063 616e then you can │ │ │ │ +0000bd80: 206d 616b 6520 7468 6973 2074 6865 2064 make this the d │ │ │ │ +0000bd90: 6566 6175 6c74 2075 7369 6e67 3a0a 0a20 efault using:.. │ │ │ │ +0000bda0: 2020 2020 2020 2020 2047 5255 425f 4445 GRUB_DE │ │ │ │ +0000bdb0: 4641 554c 543d 6578 616d 706c 652d 676e FAULT=example-gn │ │ │ │ +0000bdc0: 752d 6c69 6e75 780a 0a20 2020 2020 5072 u-linux.. Pr │ │ │ │ +0000bdd0: 6576 696f 7573 6c79 2069 7420 7761 7320 eviously it was │ │ │ │ +0000bde0: 646f 6375 6d65 6e74 6564 2074 6865 2077 documented the w │ │ │ │ +0000bdf0: 6179 2074 6f20 7573 6520 656e 7472 7920 ay to use entry │ │ │ │ +0000be00: 7469 746c 652e 2020 5768 696c 650a 2020 title. While. │ │ │ │ +0000be10: 2020 2074 6869 7320 7374 696c 6c20 776f this still wo │ │ │ │ +0000be20: 726b 7320 6974 2773 206e 6f74 2072 6563 rks it's not rec │ │ │ │ +0000be30: 6f6d 6d65 6e64 6564 2073 696e 6365 2074 ommended since t │ │ │ │ +0000be40: 6974 6c65 7320 6f66 7465 6e20 636f 6e74 itles often cont │ │ │ │ +0000be50: 6169 6e0a 2020 2020 2075 6e73 7461 626c ain. unstabl │ │ │ │ +0000be60: 6520 6465 7669 6365 206e 616d 6573 2061 e device names a │ │ │ │ +0000be70: 6e64 206d 6179 2062 6520 7472 616e 736c nd may be transl │ │ │ │ +0000be80: 6174 6564 0a0a 2020 2020 2049 6620 796f ated.. If yo │ │ │ │ +0000be90: 7520 7365 7420 7468 6973 2074 6f20 2773 u set this to 's │ │ │ │ +0000bea0: 6176 6564 272c 2074 6865 6e20 7468 6520 aved', then the │ │ │ │ +0000beb0: 6465 6661 756c 7420 6d65 6e75 2065 6e74 default menu ent │ │ │ │ +0000bec0: 7279 2077 696c 6c20 6265 0a20 2020 2020 ry will be. │ │ │ │ +0000bed0: 7468 6174 2073 6176 6564 2062 7920 2747 that saved by 'G │ │ │ │ +0000bee0: 5255 425f 5341 5645 4445 4641 554c 5427 RUB_SAVEDEFAULT' │ │ │ │ +0000bef0: 206f 7220 2767 7275 622d 7365 742d 6465 or 'grub-set-de │ │ │ │ +0000bf00: 6661 756c 7427 2e20 2054 6869 730a 2020 fault'. This. │ │ │ │ +0000bf10: 2020 2072 656c 6965 7320 6f6e 2074 6865 relies on the │ │ │ │ +0000bf20: 2065 6e76 6972 6f6e 6d65 6e74 2062 6c6f environment blo │ │ │ │ +0000bf30: 636b 2c20 7768 6963 6820 6d61 7920 6e6f ck, which may no │ │ │ │ +0000bf40: 7420 6265 2061 7661 696c 6162 6c65 2069 t be available i │ │ │ │ +0000bf50: 6e20 616c 6c0a 2020 2020 2073 6974 7561 n all. situa │ │ │ │ +0000bf60: 7469 6f6e 7320 282a 6e6f 7465 2045 6e76 tions (*note Env │ │ │ │ +0000bf70: 6972 6f6e 6d65 6e74 2062 6c6f 636b 3a3a ironment block:: │ │ │ │ +0000bf80: 292e 0a0a 2020 2020 2054 6865 2064 6566 )... The def │ │ │ │ +0000bf90: 6175 6c74 2069 7320 2730 272e 0a0a 2747 ault is '0'...'G │ │ │ │ +0000bfa0: 5255 425f 5341 5645 4445 4641 554c 5427 RUB_SAVEDEFAULT' │ │ │ │ +0000bfb0: 0a20 2020 2020 4966 2074 6869 7320 6f70 . If this op │ │ │ │ +0000bfc0: 7469 6f6e 2069 7320 7365 7420 746f 2027 tion is set to ' │ │ │ │ +0000bfd0: 7472 7565 272c 2074 6865 6e2c 2077 6865 true', then, whe │ │ │ │ +0000bfe0: 6e20 616e 2065 6e74 7279 2069 7320 7365 n an entry is se │ │ │ │ +0000bff0: 6c65 6374 6564 2c0a 2020 2020 2073 6176 lected,. sav │ │ │ │ +0000c000: 6520 6974 2061 7320 6120 6e65 7720 6465 e it as a new de │ │ │ │ +0000c010: 6661 756c 7420 656e 7472 7920 666f 7220 fault entry for │ │ │ │ +0000c020: 7573 6520 6279 2066 7574 7572 6520 7275 use by future ru │ │ │ │ +0000c030: 6e73 206f 6620 4752 5542 2e20 5468 6973 ns of GRUB. This │ │ │ │ +0000c040: 0a20 2020 2020 6973 206f 6e6c 7920 7573 . is only us │ │ │ │ +0000c050: 6566 756c 2069 6620 2747 5255 425f 4445 eful if 'GRUB_DE │ │ │ │ +0000c060: 4641 554c 543d 7361 7665 6427 3b20 6974 FAULT=saved'; it │ │ │ │ +0000c070: 2069 7320 6120 7365 7061 7261 7465 206f is a separate o │ │ │ │ +0000c080: 7074 696f 6e0a 2020 2020 2062 6563 6175 ption. becau │ │ │ │ +0000c090: 7365 2027 4752 5542 5f44 4546 4155 4c54 se 'GRUB_DEFAULT │ │ │ │ +0000c0a0: 3d73 6176 6564 2720 6973 2075 7365 6675 =saved' is usefu │ │ │ │ +0000c0b0: 6c20 7769 7468 6f75 7420 7468 6973 206f l without this o │ │ │ │ +0000c0c0: 7074 696f 6e2c 2069 6e0a 2020 2020 2063 ption, in. c │ │ │ │ +0000c0d0: 6f6e 6a75 6e63 7469 6f6e 2077 6974 6820 onjunction with │ │ │ │ +0000c0e0: 2767 7275 622d 7365 742d 6465 6661 756c 'grub-set-defaul │ │ │ │ +0000c0f0: 7427 2e20 2055 6e73 6574 2062 7920 6465 t'. Unset by de │ │ │ │ +0000c100: 6661 756c 742e 2020 5468 6973 0a20 2020 fault. This. │ │ │ │ +0000c110: 2020 6f70 7469 6f6e 2072 656c 6965 7320 option relies │ │ │ │ +0000c120: 6f6e 2074 6865 2065 6e76 6972 6f6e 6d65 on the environme │ │ │ │ +0000c130: 6e74 2062 6c6f 636b 2c20 7768 6963 6820 nt block, which │ │ │ │ +0000c140: 6d61 7920 6e6f 7420 6265 2061 7661 696c may not be avail │ │ │ │ +0000c150: 6162 6c65 0a20 2020 2020 696e 2061 6c6c able. in all │ │ │ │ +0000c160: 2073 6974 7561 7469 6f6e 7320 282a 6e6f situations (*no │ │ │ │ +0000c170: 7465 2045 6e76 6972 6f6e 6d65 6e74 2062 te Environment b │ │ │ │ +0000c180: 6c6f 636b 3a3a 292e 0a0a 2747 5255 425f lock::)...'GRUB_ │ │ │ │ +0000c190: 5449 4d45 4f55 5427 0a20 2020 2020 426f TIMEOUT'. Bo │ │ │ │ +0000c1a0: 6f74 2074 6865 2064 6566 6175 6c74 2065 ot the default e │ │ │ │ +0000c1b0: 6e74 7279 2074 6869 7320 6d61 6e79 2073 ntry this many s │ │ │ │ +0000c1c0: 6563 6f6e 6473 2061 6674 6572 2074 6865 econds after the │ │ │ │ +0000c1d0: 206d 656e 7520 6973 0a20 2020 2020 6469 menu is. di │ │ │ │ +0000c1e0: 7370 6c61 7965 642c 2075 6e6c 6573 7320 splayed, unless │ │ │ │ +0000c1f0: 6120 6b65 7920 6973 2070 7265 7373 6564 a key is pressed │ │ │ │ +0000c200: 2e20 2054 6865 2064 6566 6175 6c74 2069 . The default i │ │ │ │ +0000c210: 7320 2735 272e 2020 5365 7420 746f 0a20 s '5'. Set to. │ │ │ │ +0000c220: 2020 2020 2730 2720 746f 2062 6f6f 7420 '0' to boot │ │ │ │ +0000c230: 696d 6d65 6469 6174 656c 7920 7769 7468 immediately with │ │ │ │ +0000c240: 6f75 7420 6469 7370 6c61 7969 6e67 2074 out displaying t │ │ │ │ +0000c250: 6865 206d 656e 752c 206f 7220 746f 2027 he menu, or to ' │ │ │ │ +0000c260: 2d31 2720 746f 0a20 2020 2020 7761 6974 -1' to. wait │ │ │ │ +0000c270: 2069 6e64 6566 696e 6974 656c 792e 0a0a indefinitely... │ │ │ │ +0000c280: 2020 2020 2049 6620 2747 5255 425f 5449 If 'GRUB_TI │ │ │ │ +0000c290: 4d45 4f55 545f 5354 594c 4527 2069 7320 MEOUT_STYLE' is │ │ │ │ +0000c2a0: 7365 7420 746f 2027 636f 756e 7464 6f77 set to 'countdow │ │ │ │ +0000c2b0: 6e27 206f 7220 2768 6964 6465 6e27 2c20 n' or 'hidden', │ │ │ │ +0000c2c0: 7468 650a 2020 2020 2074 696d 656f 7574 the. timeout │ │ │ │ +0000c2d0: 2069 7320 696e 7374 6561 6420 636f 756e is instead coun │ │ │ │ +0000c2e0: 7465 6420 6265 666f 7265 2074 6865 206d ted before the m │ │ │ │ +0000c2f0: 656e 7520 6973 2064 6973 706c 6179 6564 enu is displayed │ │ │ │ +0000c300: 2e0a 0a27 4752 5542 5f54 494d 454f 5554 ...'GRUB_TIMEOUT │ │ │ │ +0000c310: 5f53 5459 4c45 270a 2020 2020 2049 6620 _STYLE'. If │ │ │ │ +0000c320: 7468 6973 206f 7074 696f 6e20 6973 2075 this option is u │ │ │ │ +0000c330: 6e73 6574 206f 7220 7365 7420 746f 2027 nset or set to ' │ │ │ │ +0000c340: 6d65 6e75 272c 2074 6865 6e20 4752 5542 menu', then GRUB │ │ │ │ +0000c350: 2077 696c 6c20 6469 7370 6c61 790a 2020 will display. │ │ │ │ +0000c360: 2020 2074 6865 206d 656e 7520 616e 6420 the menu and │ │ │ │ +0000c370: 7468 656e 2077 6169 7420 666f 7220 7468 then wait for th │ │ │ │ +0000c380: 6520 7469 6d65 6f75 7420 7365 7420 6279 e timeout set by │ │ │ │ +0000c390: 2027 4752 5542 5f54 494d 454f 5554 2720 'GRUB_TIMEOUT' │ │ │ │ +0000c3a0: 746f 0a20 2020 2020 6578 7069 7265 2062 to. expire b │ │ │ │ +0000c3b0: 6566 6f72 6520 626f 6f74 696e 6720 7468 efore booting th │ │ │ │ +0000c3c0: 6520 6465 6661 756c 7420 656e 7472 792e e default entry. │ │ │ │ +0000c3d0: 2020 5072 6573 7369 6e67 2061 206b 6579 Pressing a key │ │ │ │ +0000c3e0: 2069 6e74 6572 7275 7074 730a 2020 2020 interrupts. │ │ │ │ +0000c3f0: 2074 6865 2074 696d 656f 7574 2e0a 0a20 the timeout... │ │ │ │ +0000c400: 2020 2020 4966 2074 6869 7320 6f70 7469 If this opti │ │ │ │ +0000c410: 6f6e 2069 7320 7365 7420 746f 2027 636f on is set to 'co │ │ │ │ +0000c420: 756e 7464 6f77 6e27 206f 7220 2768 6964 untdown' or 'hid │ │ │ │ +0000c430: 6465 6e27 2c20 7468 656e 2c20 6265 666f den', then, befo │ │ │ │ +0000c440: 7265 0a20 2020 2020 6469 7370 6c61 7969 re. displayi │ │ │ │ +0000c450: 6e67 2074 6865 206d 656e 752c 2047 5255 ng the menu, GRU │ │ │ │ +0000c460: 4220 7769 6c6c 2077 6169 7420 666f 7220 B will wait for │ │ │ │ +0000c470: 7468 6520 7469 6d65 6f75 7420 7365 7420 the timeout set │ │ │ │ +0000c480: 6279 0a20 2020 2020 2747 5255 425f 5449 by. 'GRUB_TI │ │ │ │ +0000c490: 4d45 4f55 5427 2074 6f20 6578 7069 7265 MEOUT' to expire │ │ │ │ +0000c4a0: 2e20 2049 6620 3c45 5343 3e20 6973 2070 . If is p │ │ │ │ +0000c4b0: 7265 7373 6564 2064 7572 696e 6720 7468 ressed during th │ │ │ │ +0000c4c0: 6174 2074 696d 652c 2069 740a 2020 2020 at time, it. │ │ │ │ +0000c4d0: 2077 696c 6c20 6469 7370 6c61 7920 7468 will display th │ │ │ │ +0000c4e0: 6520 6d65 6e75 2061 6e64 2077 6169 7420 e menu and wait │ │ │ │ +0000c4f0: 666f 7220 696e 7075 742e 2020 4966 2061 for input. If a │ │ │ │ +0000c500: 2068 6f74 6b65 7920 6173 736f 6369 6174 hotkey associat │ │ │ │ +0000c510: 6564 0a20 2020 2020 7769 7468 2061 206d ed. with a m │ │ │ │ +0000c520: 656e 7520 656e 7472 7920 6973 2070 7265 enu entry is pre │ │ │ │ +0000c530: 7373 6564 2c20 6974 2077 696c 6c20 626f ssed, it will bo │ │ │ │ +0000c540: 6f74 2074 6865 2061 7373 6f63 6961 7465 ot the associate │ │ │ │ +0000c550: 6420 6d65 6e75 0a20 2020 2020 656e 7472 d menu. entr │ │ │ │ +0000c560: 7920 696d 6d65 6469 6174 656c 792e 2020 y immediately. │ │ │ │ +0000c570: 4966 2074 6865 2074 696d 656f 7574 2065 If the timeout e │ │ │ │ +0000c580: 7870 6972 6573 2062 6566 6f72 6520 6569 xpires before ei │ │ │ │ +0000c590: 7468 6572 206f 6620 7468 6573 650a 2020 ther of these. │ │ │ │ +0000c5a0: 2020 2068 6170 7065 6e73 2c20 6974 2077 happens, it w │ │ │ │ +0000c5b0: 696c 6c20 626f 6f74 2074 6865 2064 6566 ill boot the def │ │ │ │ +0000c5c0: 6175 6c74 2065 6e74 7279 2e20 2049 6e20 ault entry. In │ │ │ │ +0000c5d0: 7468 6520 2763 6f75 6e74 646f 776e 2720 the 'countdown' │ │ │ │ +0000c5e0: 6361 7365 2c0a 2020 2020 2069 7420 7769 case,. it wi │ │ │ │ +0000c5f0: 6c6c 2073 686f 7720 6120 6f6e 652d 6c69 ll show a one-li │ │ │ │ +0000c600: 6e65 2069 6e64 6963 6174 696f 6e20 6f66 ne indication of │ │ │ │ +0000c610: 2074 6865 2072 656d 6169 6e69 6e67 2074 the remaining t │ │ │ │ +0000c620: 696d 652e 0a0a 2747 5255 425f 4445 4641 ime...'GRUB_DEFA │ │ │ │ +0000c630: 554c 545f 4255 5454 4f4e 270a 2747 5255 ULT_BUTTON'.'GRU │ │ │ │ +0000c640: 425f 5449 4d45 4f55 545f 4255 5454 4f4e B_TIMEOUT_BUTTON │ │ │ │ +0000c650: 270a 2747 5255 425f 5449 4d45 4f55 545f '.'GRUB_TIMEOUT_ │ │ │ │ +0000c660: 5354 594c 455f 4255 5454 4f4e 270a 2747 STYLE_BUTTON'.'G │ │ │ │ +0000c670: 5255 425f 4255 5454 4f4e 5f43 4d4f 535f RUB_BUTTON_CMOS_ │ │ │ │ +0000c680: 4144 4452 4553 5327 0a20 2020 2020 5661 ADDRESS'. Va │ │ │ │ +0000c690: 7269 616e 7473 206f 6620 7468 6520 636f riants of the co │ │ │ │ +0000c6a0: 7272 6573 706f 6e64 696e 6720 7661 7269 rresponding vari │ │ │ │ +0000c6b0: 6162 6c65 7320 7769 7468 6f75 7420 7468 ables without th │ │ │ │ +0000c6c0: 6520 275f 4255 5454 4f4e 270a 2020 2020 e '_BUTTON'. │ │ │ │ +0000c6d0: 2073 7566 6669 782c 2075 7365 6420 746f suffix, used to │ │ │ │ +0000c6e0: 2073 7570 706f 7274 2076 656e 646f 722d support vendor- │ │ │ │ +0000c6f0: 7370 6563 6966 6963 2070 6f77 6572 2062 specific power b │ │ │ │ +0000c700: 7574 746f 6e73 2e20 202a 4e6f 7465 0a20 uttons. *Note. │ │ │ │ +0000c710: 2020 2020 5665 6e64 6f72 2070 6f77 6572 Vendor power │ │ │ │ +0000c720: 2d6f 6e20 6b65 7973 3a3a 2e0a 0a27 4752 -on keys::...'GR │ │ │ │ +0000c730: 5542 5f44 4953 5452 4942 5554 4f52 270a UB_DISTRIBUTOR'. │ │ │ │ +0000c740: 2020 2020 2053 6574 2062 7920 6469 7374 Set by dist │ │ │ │ +0000c750: 7269 6275 746f 7273 206f 6620 4752 5542 ributors of GRUB │ │ │ │ +0000c760: 2074 6f20 7468 6569 7220 6964 656e 7469 to their identi │ │ │ │ +0000c770: 6679 696e 6720 6e61 6d65 2e20 2054 6869 fying name. Thi │ │ │ │ +0000c780: 7320 6973 0a20 2020 2020 7573 6564 2074 s is. used t │ │ │ │ +0000c790: 6f20 6765 6e65 7261 7465 206d 6f72 6520 o generate more │ │ │ │ +0000c7a0: 696e 666f 726d 6174 6976 6520 6d65 6e75 informative menu │ │ │ │ +0000c7b0: 2065 6e74 7279 2074 6974 6c65 732e 0a0a entry titles... │ │ │ │ +0000c7c0: 2747 5255 425f 5445 524d 494e 414c 5f49 'GRUB_TERMINAL_I │ │ │ │ +0000c7d0: 4e50 5554 270a 2020 2020 2053 656c 6563 NPUT'. Selec │ │ │ │ +0000c7e0: 7420 7468 6520 7465 726d 696e 616c 2069 t the terminal i │ │ │ │ +0000c7f0: 6e70 7574 2064 6576 6963 652e 2020 596f nput device. Yo │ │ │ │ +0000c800: 7520 6d61 7920 7365 6c65 6374 206d 756c u may select mul │ │ │ │ +0000c810: 7469 706c 6520 6465 7669 6365 730a 2020 tiple devices. │ │ │ │ +0000c820: 2020 2068 6572 652c 2073 6570 6172 6174 here, separat │ │ │ │ +0000c830: 6564 2062 7920 7370 6163 6573 2e0a 0a20 ed by spaces... │ │ │ │ +0000c840: 2020 2020 5661 6c69 6420 7465 726d 696e Valid termin │ │ │ │ +0000c850: 616c 2069 6e70 7574 206e 616d 6573 2064 al input names d │ │ │ │ +0000c860: 6570 656e 6420 6f6e 2074 6865 2070 6c61 epend on the pla │ │ │ │ +0000c870: 7466 6f72 6d2c 2062 7574 206d 6179 2069 tform, but may i │ │ │ │ +0000c880: 6e63 6c75 6465 0a20 2020 2020 2763 6f6e nclude. 'con │ │ │ │ +0000c890: 736f 6c65 2720 286e 6174 6976 6520 706c sole' (native pl │ │ │ │ +0000c8a0: 6174 666f 726d 2063 6f6e 736f 6c65 292c atform console), │ │ │ │ +0000c8b0: 2027 7365 7269 616c 2720 2873 6572 6961 'serial' (seria │ │ │ │ +0000c8c0: 6c20 7465 726d 696e 616c 292c 0a20 2020 l terminal),. │ │ │ │ +0000c8d0: 2020 2773 6572 6961 6c5f 3c70 6f72 743e 'serial_ │ │ │ │ +0000c8e0: 2720 2873 6572 6961 6c20 7465 726d 696e ' (serial termin │ │ │ │ +0000c8f0: 616c 2077 6974 6820 6578 706c 6963 6974 al with explicit │ │ │ │ +0000c900: 2070 6f72 7420 7365 6c65 6374 696f 6e29 port selection) │ │ │ │ +0000c910: 2c0a 2020 2020 2027 6174 5f6b 6579 626f ,. 'at_keybo │ │ │ │ +0000c920: 6172 6427 2028 5043 2041 5420 6b65 7962 ard' (PC AT keyb │ │ │ │ +0000c930: 6f61 7264 292c 206f 7220 2775 7362 5f6b oard), or 'usb_k │ │ │ │ +0000c940: 6579 626f 6172 6427 2028 5553 4220 6b65 eyboard' (USB ke │ │ │ │ +0000c950: 7962 6f61 7264 0a20 2020 2020 7573 696e yboard. usin │ │ │ │ +0000c960: 6720 7468 6520 4849 4420 426f 6f74 2050 g the HID Boot P │ │ │ │ +0000c970: 726f 746f 636f 6c2c 2066 6f72 2063 6173 rotocol, for cas │ │ │ │ +0000c980: 6573 2077 6865 7265 2074 6865 2066 6972 es where the fir │ │ │ │ +0000c990: 6d77 6172 6520 646f 6573 206e 6f74 0a20 mware does not. │ │ │ │ +0000c9a0: 2020 2020 6861 6e64 6c65 2074 6869 7329 handle this) │ │ │ │ +0000c9b0: 2e0a 0a20 2020 2020 5468 6520 6465 6661 ... The defa │ │ │ │ +0000c9c0: 756c 7420 6973 2074 6f20 7573 6520 7468 ult is to use th │ │ │ │ +0000c9d0: 6520 706c 6174 666f 726d 2773 206e 6174 e platform's nat │ │ │ │ +0000c9e0: 6976 6520 7465 726d 696e 616c 2069 6e70 ive terminal inp │ │ │ │ +0000c9f0: 7574 2e0a 0a27 4752 5542 5f54 4552 4d49 ut...'GRUB_TERMI │ │ │ │ +0000ca00: 4e41 4c5f 4f55 5450 5554 270a 2020 2020 NAL_OUTPUT'. │ │ │ │ +0000ca10: 2053 656c 6563 7420 7468 6520 7465 726d Select the term │ │ │ │ +0000ca20: 696e 616c 206f 7574 7075 7420 6465 7669 inal output devi │ │ │ │ +0000ca30: 6365 2e20 2059 6f75 206d 6179 2073 656c ce. You may sel │ │ │ │ +0000ca40: 6563 7420 6d75 6c74 6970 6c65 2064 6576 ect multiple dev │ │ │ │ +0000ca50: 6963 6573 0a20 2020 2020 6865 7265 2c20 ices. here, │ │ │ │ +0000ca60: 7365 7061 7261 7465 6420 6279 2073 7061 separated by spa │ │ │ │ +0000ca70: 6365 732e 0a0a 2020 2020 2056 616c 6964 ces... Valid │ │ │ │ +0000ca80: 2074 6572 6d69 6e61 6c20 6f75 7470 7574 terminal output │ │ │ │ +0000ca90: 206e 616d 6573 2064 6570 656e 6420 6f6e names depend on │ │ │ │ +0000caa0: 2074 6865 2070 6c61 7466 6f72 6d2c 2062 the platform, b │ │ │ │ +0000cab0: 7574 206d 6179 2069 6e63 6c75 6465 0a20 ut may include. │ │ │ │ +0000cac0: 2020 2020 2763 6f6e 736f 6c65 2720 286e 'console' (n │ │ │ │ +0000cad0: 6174 6976 6520 706c 6174 666f 726d 2063 ative platform c │ │ │ │ +0000cae0: 6f6e 736f 6c65 292c 2027 7365 7269 616c onsole), 'serial │ │ │ │ +0000caf0: 2720 2873 6572 6961 6c20 7465 726d 696e ' (serial termin │ │ │ │ +0000cb00: 616c 292c 0a20 2020 2020 2773 6572 6961 al),. 'seria │ │ │ │ +0000cb10: 6c5f 3c70 6f72 743e 2720 2873 6572 6961 l_' (seria │ │ │ │ +0000cb20: 6c20 7465 726d 696e 616c 2077 6974 6820 l terminal with │ │ │ │ +0000cb30: 6578 706c 6963 6974 2070 6f72 7420 7365 explicit port se │ │ │ │ +0000cb40: 6c65 6374 696f 6e29 2c0a 2020 2020 2027 lection),. ' │ │ │ │ +0000cb50: 6766 7874 6572 6d27 2028 6772 6170 6869 gfxterm' (graphi │ │ │ │ +0000cb60: 6373 2d6d 6f64 6520 6f75 7470 7574 292c cs-mode output), │ │ │ │ +0000cb70: 2027 7667 615f 7465 7874 2720 2856 4741 'vga_text' (VGA │ │ │ │ +0000cb80: 2074 6578 7420 6f75 7470 7574 292c 0a20 text output),. │ │ │ │ +0000cb90: 2020 2020 276d 6461 5f74 6578 7427 2028 'mda_text' ( │ │ │ │ +0000cba0: 4d44 4120 7465 7874 206f 7574 7075 7429 MDA text output) │ │ │ │ +0000cbb0: 2c20 276d 6f72 7365 2720 284d 6f72 7365 , 'morse' (Morse │ │ │ │ +0000cbc0: 2d63 6f64 696e 6720 7573 696e 6720 7379 -coding using sy │ │ │ │ +0000cbd0: 7374 656d 0a20 2020 2020 6265 6570 6572 stem. beeper │ │ │ │ +0000cbe0: 2920 6f72 2027 7370 6b6d 6f64 656d 2720 ) or 'spkmodem' │ │ │ │ +0000cbf0: 2873 696d 706c 6520 6461 7461 2070 726f (simple data pro │ │ │ │ +0000cc00: 746f 636f 6c20 7573 696e 6720 7379 7374 tocol using syst │ │ │ │ +0000cc10: 656d 2073 7065 616b 6572 292e 0a0a 2020 em speaker)... │ │ │ │ +0000cc20: 2020 2027 7370 6b6d 6f64 656d 2720 6973 'spkmodem' is │ │ │ │ +0000cc30: 2075 7365 6675 6c20 7768 656e 206e 6f20 useful when no │ │ │ │ +0000cc40: 7365 7269 616c 2070 6f72 7420 6973 2061 serial port is a │ │ │ │ +0000cc50: 7661 696c 6162 6c65 2e20 2043 6f6e 6e65 vailable. Conne │ │ │ │ +0000cc60: 6374 2074 6865 0a20 2020 2020 6f75 7470 ct the. outp │ │ │ │ +0000cc70: 7574 206f 6620 7365 6e64 696e 6720 7379 ut of sending sy │ │ │ │ +0000cc80: 7374 656d 2028 7768 6572 6520 4752 5542 stem (where GRUB │ │ │ │ +0000cc90: 2069 7320 7275 6e6e 696e 6729 2074 6f20 is running) to │ │ │ │ +0000cca0: 6c69 6e65 2d69 6e20 6f66 0a20 2020 2020 line-in of. │ │ │ │ +0000ccb0: 7265 6365 6976 696e 6720 7379 7374 656d receiving system │ │ │ │ +0000ccc0: 2028 7573 7561 6c6c 7920 6465 7665 6c6f (usually develo │ │ │ │ +0000ccd0: 7065 7220 6d61 6368 696e 6529 2e20 204f per machine). O │ │ │ │ +0000cce0: 6e20 7265 6365 6976 696e 6720 7379 7374 n receiving syst │ │ │ │ +0000ccf0: 656d 0a20 2020 2020 636f 6d70 696c 6520 em. compile │ │ │ │ +0000cd00: 2773 706b 6d6f 6465 6d2d 7265 6376 2720 'spkmodem-recv' │ │ │ │ +0000cd10: 6672 6f6d 2027 7574 696c 2f73 706b 6d6f from 'util/spkmo │ │ │ │ +0000cd20: 6465 6d2d 7265 6376 2e63 2720 616e 6420 dem-recv.c' and │ │ │ │ +0000cd30: 7275 6e3a 0a0a 2020 2020 2020 2020 2020 run:.. │ │ │ │ +0000cd40: 7061 7265 636f 7264 202d 2d63 6861 6e6e parecord --chann │ │ │ │ +0000cd50: 656c 733d 3120 2d2d 7261 7465 3d34 3830 els=1 --rate=480 │ │ │ │ +0000cd60: 3030 202d 2d66 6f72 6d61 743d 7331 366c 00 --format=s16l │ │ │ │ +0000cd70: 6520 7c20 2e2f 7370 6b6d 6f64 656d 2d72 e | ./spkmodem-r │ │ │ │ +0000cd80: 6563 760a 0a20 2020 2020 5468 6520 6465 ecv.. The de │ │ │ │ +0000cd90: 6661 756c 7420 6973 2074 6f20 7573 6520 fault is to use │ │ │ │ +0000cda0: 7468 6520 706c 6174 666f 726d 2773 206e the platform's n │ │ │ │ +0000cdb0: 6174 6976 6520 7465 726d 696e 616c 206f ative terminal o │ │ │ │ +0000cdc0: 7574 7075 742e 0a0a 2747 5255 425f 5445 utput...'GRUB_TE │ │ │ │ +0000cdd0: 524d 494e 414c 270a 2020 2020 2049 6620 RMINAL'. If │ │ │ │ +0000cde0: 7468 6973 206f 7074 696f 6e20 6973 2073 this option is s │ │ │ │ +0000cdf0: 6574 2c20 6974 206f 7665 7272 6964 6573 et, it overrides │ │ │ │ +0000ce00: 2062 6f74 6820 2747 5255 425f 5445 524d both 'GRUB_TERM │ │ │ │ +0000ce10: 494e 414c 5f49 4e50 5554 2720 616e 640a INAL_INPUT' and. │ │ │ │ +0000ce20: 2020 2020 2027 4752 5542 5f54 4552 4d49 'GRUB_TERMI │ │ │ │ +0000ce30: 4e41 4c5f 4f55 5450 5554 2720 746f 2074 NAL_OUTPUT' to t │ │ │ │ +0000ce40: 6865 2073 616d 6520 7661 6c75 652e 0a0a he same value... │ │ │ │ +0000ce50: 2747 5255 425f 5345 5249 414c 5f43 4f4d 'GRUB_SERIAL_COM │ │ │ │ +0000ce60: 4d41 4e44 270a 2020 2020 2041 2063 6f6d MAND'. A com │ │ │ │ +0000ce70: 6d61 6e64 2074 6f20 636f 6e66 6967 7572 mand to configur │ │ │ │ +0000ce80: 6520 7468 6520 7365 7269 616c 2070 6f72 e the serial por │ │ │ │ +0000ce90: 7420 7768 656e 2075 7369 6e67 2074 6865 t when using the │ │ │ │ +0000cea0: 2073 6572 6961 6c0a 2020 2020 2063 6f6e serial. con │ │ │ │ +0000ceb0: 736f 6c65 2e20 202a 4e6f 7465 2073 6572 sole. *Note ser │ │ │ │ +0000cec0: 6961 6c3a 3a2e 2020 4465 6661 756c 7473 ial::. Defaults │ │ │ │ +0000ced0: 2074 6f20 2773 6572 6961 6c27 2e0a 0a27 to 'serial'...' │ │ │ │ +0000cee0: 4752 5542 5f43 4d44 4c49 4e45 5f4c 494e GRUB_CMDLINE_LIN │ │ │ │ +0000cef0: 5558 270a 2020 2020 2043 6f6d 6d61 6e64 UX'. Command │ │ │ │ +0000cf00: 2d6c 696e 6520 6172 6775 6d65 6e74 7320 -line arguments │ │ │ │ +0000cf10: 746f 2061 6464 2074 6f20 6d65 6e75 2065 to add to menu e │ │ │ │ +0000cf20: 6e74 7269 6573 2066 6f72 2074 6865 204c ntries for the L │ │ │ │ +0000cf30: 696e 7578 206b 6572 6e65 6c2e 0a0a 2747 inux kernel...'G │ │ │ │ +0000cf40: 5255 425f 434d 444c 494e 455f 4c49 4e55 RUB_CMDLINE_LINU │ │ │ │ +0000cf50: 585f 4445 4641 554c 5427 0a20 2020 2020 X_DEFAULT'. │ │ │ │ +0000cf60: 556e 6c65 7373 2027 4752 5542 5f44 4953 Unless 'GRUB_DIS │ │ │ │ +0000cf70: 4142 4c45 5f52 4543 4f56 4552 5927 2069 ABLE_RECOVERY' i │ │ │ │ +0000cf80: 7320 7365 7420 746f 2027 7472 7565 272c s set to 'true', │ │ │ │ +0000cf90: 2074 776f 206d 656e 7520 656e 7472 6965 two menu entrie │ │ │ │ +0000cfa0: 730a 2020 2020 2077 696c 6c20 6265 2067 s. will be g │ │ │ │ +0000cfb0: 656e 6572 6174 6564 2066 6f72 2065 6163 enerated for eac │ │ │ │ +0000cfc0: 6820 4c69 6e75 7820 6b65 726e 656c 3a20 h Linux kernel: │ │ │ │ +0000cfd0: 6f6e 6520 6465 6661 756c 7420 656e 7472 one default entr │ │ │ │ +0000cfe0: 7920 616e 6420 6f6e 650a 2020 2020 2065 y and one. e │ │ │ │ +0000cff0: 6e74 7279 2066 6f72 2072 6563 6f76 6572 ntry for recover │ │ │ │ +0000d000: 7920 6d6f 6465 2e20 2054 6869 7320 6f70 y mode. This op │ │ │ │ +0000d010: 7469 6f6e 206c 6973 7473 2063 6f6d 6d61 tion lists comma │ │ │ │ +0000d020: 6e64 2d6c 696e 6520 6172 6775 6d65 6e74 nd-line argument │ │ │ │ +0000d030: 730a 2020 2020 2074 6f20 6164 6420 6f6e s. to add on │ │ │ │ +0000d040: 6c79 2074 6f20 7468 6520 6465 6661 756c ly to the defaul │ │ │ │ +0000d050: 7420 6d65 6e75 2065 6e74 7279 2c20 6166 t menu entry, af │ │ │ │ +0000d060: 7465 7220 7468 6f73 6520 6c69 7374 6564 ter those listed │ │ │ │ +0000d070: 2069 6e0a 2020 2020 2027 4752 5542 5f43 in. 'GRUB_C │ │ │ │ +0000d080: 4d44 4c49 4e45 5f4c 494e 5558 272e 0a0a MDLINE_LINUX'... │ │ │ │ +0000d090: 2747 5255 425f 434d 444c 494e 455f 4e45 'GRUB_CMDLINE_NE │ │ │ │ +0000d0a0: 5442 5344 270a 2747 5255 425f 434d 444c TBSD'.'GRUB_CMDL │ │ │ │ +0000d0b0: 494e 455f 4e45 5442 5344 5f44 4546 4155 INE_NETBSD_DEFAU │ │ │ │ +0000d0c0: 4c54 270a 2020 2020 2041 7320 2747 5255 LT'. As 'GRU │ │ │ │ +0000d0d0: 425f 434d 444c 494e 455f 4c49 4e55 5827 B_CMDLINE_LINUX' │ │ │ │ +0000d0e0: 2061 6e64 2027 4752 5542 5f43 4d44 4c49 and 'GRUB_CMDLI │ │ │ │ +0000d0f0: 4e45 5f4c 494e 5558 5f44 4546 4155 4c54 NE_LINUX_DEFAULT │ │ │ │ +0000d100: 272c 2062 7574 2066 6f72 0a20 2020 2020 ', but for. │ │ │ │ +0000d110: 4e65 7442 5344 2e0a 0a27 4752 5542 5f43 NetBSD...'GRUB_C │ │ │ │ +0000d120: 4d44 4c49 4e45 5f47 4e55 4d41 4348 270a MDLINE_GNUMACH'. │ │ │ │ +0000d130: 2020 2020 2041 7320 2747 5255 425f 434d As 'GRUB_CM │ │ │ │ +0000d140: 444c 494e 455f 4c49 4e55 5827 2c20 6275 DLINE_LINUX', bu │ │ │ │ +0000d150: 7420 666f 7220 474e 5520 4d61 6368 2e0a t for GNU Mach.. │ │ │ │ +0000d160: 0a27 4752 5542 5f43 4d44 4c49 4e45 5f58 .'GRUB_CMDLINE_X │ │ │ │ +0000d170: 454e 270a 2747 5255 425f 434d 444c 494e EN'.'GRUB_CMDLIN │ │ │ │ +0000d180: 455f 5845 4e5f 4445 4641 554c 5427 0a20 E_XEN_DEFAULT'. │ │ │ │ +0000d190: 2020 2020 5468 6520 7661 6c75 6573 206f The values o │ │ │ │ +0000d1a0: 6620 7468 6573 6520 6f70 7469 6f6e 7320 f these options │ │ │ │ +0000d1b0: 6172 6520 7061 7373 6564 2074 6f20 5865 are passed to Xe │ │ │ │ +0000d1c0: 6e20 6879 7065 7276 6973 6f72 2058 656e n hypervisor Xen │ │ │ │ +0000d1d0: 206d 656e 750a 2020 2020 2065 6e74 7269 menu. entri │ │ │ │ +0000d1e0: 6573 2c20 666f 7220 616c 6c20 7265 7370 es, for all resp │ │ │ │ +0000d1f0: 6563 7469 7665 6c79 206e 6f72 6d61 6c20 ectively normal │ │ │ │ +0000d200: 656e 7472 6965 732e 0a0a 2747 5255 425f entries...'GRUB_ │ │ │ │ +0000d210: 434d 444c 494e 455f 4c49 4e55 585f 5845 CMDLINE_LINUX_XE │ │ │ │ +0000d220: 4e5f 5245 504c 4143 4527 0a27 4752 5542 N_REPLACE'.'GRUB │ │ │ │ +0000d230: 5f43 4d44 4c49 4e45 5f4c 494e 5558 5f58 _CMDLINE_LINUX_X │ │ │ │ +0000d240: 454e 5f52 4550 4c41 4345 5f44 4546 4155 EN_REPLACE_DEFAU │ │ │ │ +0000d250: 4c54 270a 2020 2020 2054 6865 2076 616c LT'. The val │ │ │ │ +0000d260: 7565 7320 6f66 2074 6865 7365 206f 7074 ues of these opt │ │ │ │ +0000d270: 696f 6e73 2072 6570 6c61 6365 2074 6865 ions replace the │ │ │ │ +0000d280: 2076 616c 7565 7320 6f66 0a20 2020 2020 values of. │ │ │ │ +0000d290: 2747 5255 425f 434d 444c 494e 455f 4c49 'GRUB_CMDLINE_LI │ │ │ │ +0000d2a0: 4e55 5827 2061 6e64 2027 4752 5542 5f43 NUX' and 'GRUB_C │ │ │ │ +0000d2b0: 4d44 4c49 4e45 5f4c 494e 5558 5f44 4546 MDLINE_LINUX_DEF │ │ │ │ +0000d2c0: 4155 4c54 2720 666f 7220 4c69 6e75 7820 AULT' for Linux │ │ │ │ +0000d2d0: 616e 640a 2020 2020 2058 656e 206d 656e and. Xen men │ │ │ │ +0000d2e0: 7520 656e 7472 6965 732e 0a0a 2747 5255 u entries...'GRU │ │ │ │ +0000d2f0: 425f 4541 524c 595f 494e 4954 5244 5f4c B_EARLY_INITRD_L │ │ │ │ +0000d300: 494e 5558 5f43 5553 544f 4d27 0a27 4752 INUX_CUSTOM'.'GR │ │ │ │ +0000d310: 5542 5f45 4152 4c59 5f49 4e49 5452 445f UB_EARLY_INITRD_ │ │ │ │ +0000d320: 4c49 4e55 585f 5354 4f43 4b27 0a20 2020 LINUX_STOCK'. │ │ │ │ +0000d330: 2020 4c69 7374 206f 6620 7370 6163 652d List of space- │ │ │ │ +0000d340: 7365 7061 7261 7465 6420 6561 726c 7920 separated early │ │ │ │ +0000d350: 696e 6974 7264 2069 6d61 6765 7320 746f initrd images to │ │ │ │ +0000d360: 2062 6520 6c6f 6164 6564 2066 726f 6d0a be loaded from. │ │ │ │ +0000d370: 2020 2020 2027 2f62 6f6f 7427 2e20 2054 '/boot'. T │ │ │ │ +0000d380: 6869 7320 6973 2066 6f72 206c 6f61 6469 his is for loadi │ │ │ │ +0000d390: 6e67 2074 6869 6e67 7320 6c69 6b65 2043 ng things like C │ │ │ │ +0000d3a0: 5055 206d 6963 726f 636f 6465 2c20 6669 PU microcode, fi │ │ │ │ +0000d3b0: 726d 7761 7265 2c0a 2020 2020 2041 4350 rmware,. ACP │ │ │ │ +0000d3c0: 4920 7461 626c 6573 2c20 6372 7970 746f I tables, crypto │ │ │ │ +0000d3d0: 206b 6579 732c 2061 6e64 2073 6f20 6f6e keys, and so on │ │ │ │ +0000d3e0: 2e20 2054 6865 7365 2065 6172 6c79 2069 . These early i │ │ │ │ +0000d3f0: 6d61 6765 7320 7769 6c6c 2062 650a 2020 mages will be. │ │ │ │ +0000d400: 2020 206c 6f61 6465 6420 696e 2074 6865 loaded in the │ │ │ │ +0000d410: 206f 7264 6572 2064 6563 6c61 7265 642c order declared, │ │ │ │ +0000d420: 2061 6e64 2061 6c6c 2077 696c 6c20 6265 and all will be │ │ │ │ +0000d430: 206c 6f61 6465 6420 6265 666f 7265 2074 loaded before t │ │ │ │ +0000d440: 6865 0a20 2020 2020 6163 7475 616c 2066 he. actual f │ │ │ │ +0000d450: 756e 6374 696f 6e61 6c20 696e 6974 7264 unctional initrd │ │ │ │ +0000d460: 2069 6d61 6765 2e0a 0a20 2020 2020 2747 image... 'G │ │ │ │ +0000d470: 5255 425f 4541 524c 595f 494e 4954 5244 RUB_EARLY_INITRD │ │ │ │ +0000d480: 5f4c 494e 5558 5f53 544f 434b 2720 6973 _LINUX_STOCK' is │ │ │ │ +0000d490: 2066 6f72 2079 6f75 7220 6469 7374 7269 for your distri │ │ │ │ +0000d4a0: 6275 7469 6f6e 2074 6f20 6465 636c 6172 bution to declar │ │ │ │ +0000d4b0: 650a 2020 2020 2069 6d61 6765 7320 7468 e. images th │ │ │ │ +0000d4c0: 6174 2061 7265 2070 726f 7669 6465 6420 at are provided │ │ │ │ +0000d4d0: 6279 2074 6865 2064 6973 7472 6962 7574 by the distribut │ │ │ │ +0000d4e0: 696f 6e2e 2020 4974 2073 686f 756c 6420 ion. It should │ │ │ │ +0000d4f0: 6e6f 7420 6265 0a20 2020 2020 6d6f 6469 not be. modi │ │ │ │ +0000d500: 6669 6564 2077 6974 686f 7574 2075 6e64 fied without und │ │ │ │ +0000d510: 6572 7374 616e 6469 6e67 2074 6865 2063 erstanding the c │ │ │ │ +0000d520: 6f6e 7365 7175 656e 6365 732e 2020 5468 onsequences. Th │ │ │ │ +0000d530: 6579 2077 696c 6c20 6265 0a20 2020 2020 ey will be. │ │ │ │ +0000d540: 6c6f 6164 6564 2066 6972 7374 2e0a 0a20 loaded first... │ │ │ │ +0000d550: 2020 2020 2747 5255 425f 4541 524c 595f 'GRUB_EARLY_ │ │ │ │ +0000d560: 494e 4954 5244 5f4c 494e 5558 5f43 5553 INITRD_LINUX_CUS │ │ │ │ +0000d570: 544f 4d27 2069 7320 666f 7220 796f 7572 TOM' is for your │ │ │ │ +0000d580: 2063 7573 746f 6d20 6372 6561 7465 6420 custom created │ │ │ │ +0000d590: 696d 6167 6573 2e0a 0a20 2020 2020 5468 images... Th │ │ │ │ +0000d5a0: 6520 6465 6661 756c 7420 7374 6f63 6b20 e default stock │ │ │ │ +0000d5b0: 696d 6167 6573 2061 7265 2061 7320 666f images are as fo │ │ │ │ +0000d5c0: 6c6c 6f77 732c 2074 686f 7567 6820 7468 llows, though th │ │ │ │ +0000d5d0: 6579 206d 6179 2062 650a 2020 2020 206f ey may be. o │ │ │ │ +0000d5e0: 7665 7272 6964 6465 6e20 6279 2079 6f75 verridden by you │ │ │ │ +0000d5f0: 7220 6469 7374 7269 6275 7469 6f6e 3a0a r distribution:. │ │ │ │ +0000d600: 2020 2020 2020 2020 2020 696e 7465 6c2d intel- │ │ │ │ +0000d610: 7563 2e69 6d67 2069 6e74 656c 2d75 636f uc.img intel-uco │ │ │ │ +0000d620: 6465 2e69 6d67 2061 6d64 2d75 632e 696d de.img amd-uc.im │ │ │ │ +0000d630: 6720 616d 642d 7563 6f64 652e 696d 6720 g amd-ucode.img │ │ │ │ +0000d640: 6561 726c 795f 7563 6f64 652e 6370 696f early_ucode.cpio │ │ │ │ +0000d650: 206d 6963 726f 636f 6465 2e63 7069 6f0a microcode.cpio. │ │ │ │ +0000d660: 0a27 4752 5542 5f44 4953 4142 4c45 5f4c .'GRUB_DISABLE_L │ │ │ │ +0000d670: 494e 5558 5f55 5549 4427 0a20 2020 2020 INUX_UUID'. │ │ │ │ +0000d680: 4e6f 726d 616c 6c79 2c20 2767 7275 622d Normally, 'grub- │ │ │ │ +0000d690: 6d6b 636f 6e66 6967 2720 7769 6c6c 2067 mkconfig' will g │ │ │ │ +0000d6a0: 656e 6572 6174 6520 6d65 6e75 2065 6e74 enerate menu ent │ │ │ │ +0000d6b0: 7269 6573 2074 6861 7420 7573 650a 2020 ries that use. │ │ │ │ +0000d6c0: 2020 2075 6e69 7665 7273 616c 6c79 2d75 universally-u │ │ │ │ +0000d6d0: 6e69 7175 6520 6964 656e 7469 6669 6572 nique identifier │ │ │ │ +0000d6e0: 7320 2855 5549 4473 2920 746f 2069 6465 s (UUIDs) to ide │ │ │ │ +0000d6f0: 6e74 6966 7920 7468 6520 726f 6f74 0a20 ntify the root. │ │ │ │ +0000d700: 2020 2020 6669 6c65 7379 7374 656d 2074 filesystem t │ │ │ │ +0000d710: 6f20 7468 6520 4c69 6e75 7820 6b65 726e o the Linux kern │ │ │ │ +0000d720: 656c 2c20 7573 696e 6720 6120 2772 6f6f el, using a 'roo │ │ │ │ +0000d730: 743d 5555 4944 3d2e 2e2e 2720 6b65 726e t=UUID=...' kern │ │ │ │ +0000d740: 656c 0a20 2020 2020 7061 7261 6d65 7465 el. paramete │ │ │ │ +0000d750: 722e 2020 5468 6973 2069 7320 7573 7561 r. This is usua │ │ │ │ +0000d760: 6c6c 7920 6d6f 7265 2072 656c 6961 626c lly more reliabl │ │ │ │ +0000d770: 652c 2062 7574 2069 6e20 736f 6d65 2063 e, but in some c │ │ │ │ +0000d780: 6173 6573 2069 7420 6d61 790a 2020 2020 ases it may. │ │ │ │ +0000d790: 206e 6f74 2062 6520 6170 7072 6f70 7269 not be appropri │ │ │ │ +0000d7a0: 6174 652e 2020 546f 2064 6973 6162 6c65 ate. To disable │ │ │ │ +0000d7b0: 2074 6865 2075 7365 206f 6620 5555 4944 the use of UUID │ │ │ │ +0000d7c0: 732c 2073 6574 2074 6869 7320 6f70 7469 s, set this opti │ │ │ │ +0000d7d0: 6f6e 0a20 2020 2020 746f 2027 7472 7565 on. to 'true │ │ │ │ +0000d7e0: 272e 0a0a 2747 5255 425f 4449 5341 424c '...'GRUB_DISABL │ │ │ │ +0000d7f0: 455f 4c49 4e55 585f 5041 5254 5555 4944 E_LINUX_PARTUUID │ │ │ │ +0000d800: 270a 2020 2020 2049 6620 2767 7275 622d '. If 'grub- │ │ │ │ +0000d810: 6d6b 636f 6e66 6967 2720 6361 6e6e 6f74 mkconfig' cannot │ │ │ │ +0000d820: 2069 6465 6e74 6966 7920 7468 6520 726f identify the ro │ │ │ │ +0000d830: 6f74 2066 696c 6573 7973 7465 6d20 7669 ot filesystem vi │ │ │ │ +0000d840: 6120 6974 730a 2020 2020 2075 6e69 7665 a its. unive │ │ │ │ +0000d850: 7273 616c 6c79 2d75 6e69 7175 6520 696e rsally-unique in │ │ │ │ +0000d860: 6465 6e74 6966 6965 7220 2855 5549 4429 dentifier (UUID) │ │ │ │ +0000d870: 2c20 2767 7275 622d 6d6b 636f 6e66 6967 , 'grub-mkconfig │ │ │ │ +0000d880: 2720 6361 6e20 7573 6520 7468 650a 2020 ' can use the. │ │ │ │ +0000d890: 2020 2055 5549 4420 6f66 2074 6865 2070 UUID of the p │ │ │ │ +0000d8a0: 6172 7469 7469 6f6e 2063 6f6e 7461 696e artition contain │ │ │ │ +0000d8b0: 696e 6720 7468 6520 6669 6c65 7379 7374 ing the filesyst │ │ │ │ +0000d8c0: 656d 2074 6f20 6964 656e 7469 6679 2074 em to identify t │ │ │ │ +0000d8d0: 6865 0a20 2020 2020 726f 6f74 2066 696c he. root fil │ │ │ │ +0000d8e0: 6573 7973 7465 6d20 746f 2074 6865 204c esystem to the L │ │ │ │ +0000d8f0: 696e 7578 206b 6572 6e65 6c20 7669 6120 inux kernel via │ │ │ │ +0000d900: 6120 2772 6f6f 743d 5041 5254 5555 4944 a 'root=PARTUUID │ │ │ │ +0000d910: 3d2e 2e2e 270a 2020 2020 206b 6572 6e65 =...'. kerne │ │ │ │ +0000d920: 6c20 7061 7261 6d65 7465 722e 2020 5468 l parameter. Th │ │ │ │ +0000d930: 6973 2069 7320 6e6f 7420 6173 2072 656c is is not as rel │ │ │ │ +0000d940: 6961 626c 6520 6173 2075 7369 6e67 2074 iable as using t │ │ │ │ +0000d950: 6865 2066 696c 6573 7973 7465 6d0a 2020 he filesystem. │ │ │ │ +0000d960: 2020 2055 5549 442c 2062 7574 2069 7320 UUID, but is │ │ │ │ +0000d970: 6d6f 7265 2072 656c 6961 626c 6520 7468 more reliable th │ │ │ │ +0000d980: 616e 2075 7369 6e67 2074 6865 204c 696e an using the Lin │ │ │ │ +0000d990: 7578 2064 6576 6963 6520 6e61 6d65 732e ux device names. │ │ │ │ +0000d9a0: 2020 5768 656e 0a20 2020 2020 2747 5255 When. 'GRU │ │ │ │ +0000d9b0: 425f 4449 5341 424c 455f 4c49 4e55 585f B_DISABLE_LINUX_ │ │ │ │ +0000d9c0: 5041 5254 5555 4944 2720 6973 2073 6574 PARTUUID' is set │ │ │ │ +0000d9d0: 2074 6f20 2766 616c 7365 272c 2074 6865 to 'false', the │ │ │ │ +0000d9e0: 204c 696e 7578 206b 6572 6e65 6c0a 2020 Linux kernel. │ │ │ │ +0000d9f0: 2020 2076 6572 7369 6f6e 206d 7573 7420 version must │ │ │ │ +0000da00: 6265 2032 2e36 2e33 3720 2833 2e31 3020 be 2.6.37 (3.10 │ │ │ │ +0000da10: 666f 7220 7379 7374 656d 7320 7573 696e for systems usin │ │ │ │ +0000da20: 6720 7468 6520 4d53 444f 5320 7061 7274 g the MSDOS part │ │ │ │ +0000da30: 6974 696f 6e0a 2020 2020 2073 6368 656d ition. schem │ │ │ │ +0000da40: 6529 206f 7220 6e65 7765 722e 2020 5468 e) or newer. Th │ │ │ │ +0000da50: 6973 206f 7074 696f 6e20 6465 6661 756c is option defaul │ │ │ │ +0000da60: 7473 2074 6f20 2774 7275 6527 2e20 2054 ts to 'true'. T │ │ │ │ +0000da70: 6f20 656e 6162 6c65 2074 6865 0a20 2020 o enable the. │ │ │ │ +0000da80: 2020 7573 6520 6f66 2070 6172 7469 7469 use of partiti │ │ │ │ +0000da90: 6f6e 2055 5549 4473 2c20 7365 7420 7468 on UUIDs, set th │ │ │ │ +0000daa0: 6973 206f 7074 696f 6e20 746f 2027 6661 is option to 'fa │ │ │ │ +0000dab0: 6c73 6527 2e0a 0a27 4752 5542 5f44 4953 lse'...'GRUB_DIS │ │ │ │ +0000dac0: 4142 4c45 5f52 4543 4f56 4552 5927 0a20 ABLE_RECOVERY'. │ │ │ │ +0000dad0: 2020 2020 4966 2074 6869 7320 6f70 7469 If this opti │ │ │ │ +0000dae0: 6f6e 2069 7320 7365 7420 746f 2027 7472 on is set to 'tr │ │ │ │ +0000daf0: 7565 272c 2064 6973 6162 6c65 2074 6865 ue', disable the │ │ │ │ +0000db00: 2067 656e 6572 6174 696f 6e20 6f66 2072 generation of r │ │ │ │ +0000db10: 6563 6f76 6572 790a 2020 2020 206d 6f64 ecovery. mod │ │ │ │ +0000db20: 6520 6d65 6e75 2065 6e74 7269 6573 2e0a e menu entries.. │ │ │ │ +0000db30: 0a27 4752 5542 5f56 4944 454f 5f42 4143 .'GRUB_VIDEO_BAC │ │ │ │ +0000db40: 4b45 4e44 270a 2020 2020 2049 6620 6772 KEND'. If gr │ │ │ │ +0000db50: 6170 6869 6361 6c20 7669 6465 6f20 7375 aphical video su │ │ │ │ +0000db60: 7070 6f72 7420 6973 2072 6571 7569 7265 pport is require │ │ │ │ +0000db70: 642c 2065 6974 6865 7220 6265 6361 7573 d, either becaus │ │ │ │ +0000db80: 6520 7468 650a 2020 2020 2027 6766 7874 e the. 'gfxt │ │ │ │ +0000db90: 6572 6d27 2067 7261 7068 6963 616c 2074 erm' graphical t │ │ │ │ +0000dba0: 6572 6d69 6e61 6c20 6973 2069 6e20 7573 erminal is in us │ │ │ │ +0000dbb0: 6520 6f72 2062 6563 6175 7365 0a20 2020 e or because. │ │ │ │ +0000dbc0: 2020 2747 5255 425f 4746 5850 4159 4c4f 'GRUB_GFXPAYLO │ │ │ │ +0000dbd0: 4144 5f4c 494e 5558 2720 6973 2073 6574 AD_LINUX' is set │ │ │ │ +0000dbe0: 2c20 7468 656e 2027 6772 7562 2d6d 6b63 , then 'grub-mkc │ │ │ │ +0000dbf0: 6f6e 6669 6727 2077 696c 6c20 6e6f 726d onfig' will norm │ │ │ │ +0000dc00: 616c 6c79 0a20 2020 2020 6c6f 6164 2061 ally. load a │ │ │ │ +0000dc10: 6c6c 2061 7661 696c 6162 6c65 2047 5255 ll available GRU │ │ │ │ +0000dc20: 4220 7669 6465 6f20 6472 6976 6572 7320 B video drivers │ │ │ │ +0000dc30: 616e 6420 7573 6520 7468 6520 6f6e 6520 and use the one │ │ │ │ +0000dc40: 6d6f 7374 0a20 2020 2020 6170 7072 6f70 most. approp │ │ │ │ +0000dc50: 7269 6174 6520 666f 7220 796f 7572 2068 riate for your h │ │ │ │ +0000dc60: 6172 6477 6172 652e 2020 4966 2079 6f75 ardware. If you │ │ │ │ +0000dc70: 206e 6565 6420 746f 206f 7665 7272 6964 need to overrid │ │ │ │ +0000dc80: 6520 7468 6973 2066 6f72 0a20 2020 2020 e this for. │ │ │ │ +0000dc90: 736f 6d65 2072 6561 736f 6e2c 2074 6865 some reason, the │ │ │ │ +0000dca0: 6e20 796f 7520 6361 6e20 7365 7420 7468 n you can set th │ │ │ │ +0000dcb0: 6973 206f 7074 696f 6e2e 0a0a 2020 2020 is option... │ │ │ │ +0000dcc0: 2041 6674 6572 2027 6772 7562 2d69 6e73 After 'grub-ins │ │ │ │ +0000dcd0: 7461 6c6c 2720 6861 7320 6265 656e 2072 tall' has been r │ │ │ │ +0000dce0: 756e 2c20 7468 6520 6176 6169 6c61 626c un, the availabl │ │ │ │ +0000dcf0: 6520 7669 6465 6f20 6472 6976 6572 7320 e video drivers │ │ │ │ +0000dd00: 6172 650a 2020 2020 206c 6973 7465 6420 are. listed │ │ │ │ +0000dd10: 696e 2027 2f62 6f6f 742f 6772 7562 2f76 in '/boot/grub/v │ │ │ │ +0000dd20: 6964 656f 2e6c 7374 272e 0a0a 2747 5255 ideo.lst'...'GRU │ │ │ │ +0000dd30: 425f 4746 584d 4f44 4527 0a20 2020 2020 B_GFXMODE'. │ │ │ │ +0000dd40: 5365 7420 7468 6520 7265 736f 6c75 7469 Set the resoluti │ │ │ │ +0000dd50: 6f6e 2075 7365 6420 6f6e 2074 6865 2027 on used on the ' │ │ │ │ +0000dd60: 6766 7874 6572 6d27 2067 7261 7068 6963 gfxterm' graphic │ │ │ │ +0000dd70: 616c 2074 6572 6d69 6e61 6c2e 2020 4e6f al terminal. No │ │ │ │ +0000dd80: 7465 0a20 2020 2020 7468 6174 2079 6f75 te. that you │ │ │ │ +0000dd90: 2063 616e 206f 6e6c 7920 7573 6520 6d6f can only use mo │ │ │ │ +0000dda0: 6465 7320 7768 6963 6820 796f 7572 2067 des which your g │ │ │ │ +0000ddb0: 7261 7068 6963 7320 6361 7264 2073 7570 raphics card sup │ │ │ │ +0000ddc0: 706f 7274 7320 7669 610a 2020 2020 2056 ports via. V │ │ │ │ +0000ddd0: 4553 4120 4249 4f53 2045 7874 656e 7369 ESA BIOS Extensi │ │ │ │ +0000dde0: 6f6e 7320 2856 4245 292c 2073 6f20 666f ons (VBE), so fo │ │ │ │ +0000ddf0: 7220 6578 616d 706c 6520 6e61 7469 7665 r example native │ │ │ │ +0000de00: 204c 4344 2070 616e 656c 0a20 2020 2020 LCD panel. │ │ │ │ +0000de10: 7265 736f 6c75 7469 6f6e 7320 6d61 7920 resolutions may │ │ │ │ +0000de20: 6e6f 7420 6265 2061 7661 696c 6162 6c65 not be available │ │ │ │ +0000de30: 2e20 2054 6865 2064 6566 6175 6c74 2069 . The default i │ │ │ │ +0000de40: 7320 2761 7574 6f27 2c20 7768 6963 680a s 'auto', which. │ │ │ │ +0000de50: 2020 2020 2074 7269 6573 2074 6f20 7365 tries to se │ │ │ │ +0000de60: 6c65 6374 2061 2070 7265 6665 7272 6564 lect a preferred │ │ │ │ +0000de70: 2072 6573 6f6c 7574 696f 6e2e 2020 2a4e resolution. *N │ │ │ │ +0000de80: 6f74 6520 6766 786d 6f64 653a 3a2e 0a0a ote gfxmode::... │ │ │ │ +0000de90: 2747 5255 425f 4241 434b 4752 4f55 4e44 'GRUB_BACKGROUND │ │ │ │ +0000dea0: 270a 2020 2020 2053 6574 2061 2062 6163 '. Set a bac │ │ │ │ +0000deb0: 6b67 726f 756e 6420 696d 6167 6520 666f kground image fo │ │ │ │ +0000dec0: 7220 7573 6520 7769 7468 2074 6865 2027 r use with the ' │ │ │ │ +0000ded0: 6766 7874 6572 6d27 2067 7261 7068 6963 gfxterm' graphic │ │ │ │ +0000dee0: 616c 0a20 2020 2020 7465 726d 696e 616c al. terminal │ │ │ │ +0000def0: 2e20 2054 6865 2076 616c 7565 206f 6620 . The value of │ │ │ │ +0000df00: 7468 6973 206f 7074 696f 6e20 6d75 7374 this option must │ │ │ │ +0000df10: 2062 6520 6120 6669 6c65 2072 6561 6461 be a file reada │ │ │ │ +0000df20: 626c 6520 6279 2047 5255 420a 2020 2020 ble by GRUB. │ │ │ │ +0000df30: 2061 7420 626f 6f74 2074 696d 652c 2061 at boot time, a │ │ │ │ +0000df40: 6e64 2069 7420 6d75 7374 2065 6e64 2077 nd it must end w │ │ │ │ +0000df50: 6974 6820 272e 706e 6727 2c20 272e 7467 ith '.png', '.tg │ │ │ │ +0000df60: 6127 2c20 272e 6a70 6727 2c20 6f72 0a20 a', '.jpg', or. │ │ │ │ +0000df70: 2020 2020 272e 6a70 6567 272e 2020 5468 '.jpeg'. Th │ │ │ │ +0000df80: 6520 696d 6167 6520 7769 6c6c 2062 6520 e image will be │ │ │ │ +0000df90: 7363 616c 6564 2069 6620 6e65 6365 7373 scaled if necess │ │ │ │ +0000dfa0: 6172 7920 746f 2066 6974 2074 6865 2073 ary to fit the s │ │ │ │ +0000dfb0: 6372 6565 6e2e 0a0a 2747 5255 425f 5448 creen...'GRUB_TH │ │ │ │ +0000dfc0: 454d 4527 0a20 2020 2020 5365 7420 6120 EME'. Set a │ │ │ │ +0000dfd0: 7468 656d 6520 666f 7220 7573 6520 7769 theme for use wi │ │ │ │ +0000dfe0: 7468 2074 6865 2027 6766 7874 6572 6d27 th the 'gfxterm' │ │ │ │ +0000dff0: 2067 7261 7068 6963 616c 2074 6572 6d69 graphical termi │ │ │ │ +0000e000: 6e61 6c2e 0a0a 2747 5255 425f 4746 5850 nal...'GRUB_GFXP │ │ │ │ +0000e010: 4159 4c4f 4144 5f4c 494e 5558 270a 2020 AYLOAD_LINUX'. │ │ │ │ +0000e020: 2020 2053 6574 2074 6f20 2774 6578 7427 Set to 'text' │ │ │ │ +0000e030: 2074 6f20 666f 7263 6520 7468 6520 4c69 to force the Li │ │ │ │ +0000e040: 6e75 7820 6b65 726e 656c 2074 6f20 626f nux kernel to bo │ │ │ │ +0000e050: 6f74 2069 6e20 6e6f 726d 616c 2074 6578 ot in normal tex │ │ │ │ +0000e060: 740a 2020 2020 206d 6f64 652c 2027 6b65 t. mode, 'ke │ │ │ │ +0000e070: 6570 2720 746f 2070 7265 7365 7276 6520 ep' to preserve │ │ │ │ +0000e080: 7468 6520 6772 6170 6869 6373 206d 6f64 the graphics mod │ │ │ │ +0000e090: 6520 7365 7420 7573 696e 670a 2020 2020 e set using. │ │ │ │ +0000e0a0: 2027 4752 5542 5f47 4658 4d4f 4445 272c 'GRUB_GFXMODE', │ │ │ │ +0000e0b0: 2027 5749 4454 4878 4845 4947 4854 275b 'WIDTHxHEIGHT'[ │ │ │ │ +0000e0c0: 2778 4445 5054 4827 5d20 746f 2073 6574 'xDEPTH'] to set │ │ │ │ +0000e0d0: 2061 2070 6172 7469 6375 6c61 720a 2020 a particular. │ │ │ │ +0000e0e0: 2020 2067 7261 7068 6963 7320 6d6f 6465 graphics mode │ │ │ │ +0000e0f0: 2c20 6f72 2061 2073 6571 7565 6e63 6520 , or a sequence │ │ │ │ +0000e100: 6f66 2074 6865 7365 2073 6570 6172 6174 of these separat │ │ │ │ +0000e110: 6564 2062 7920 636f 6d6d 6173 206f 720a ed by commas or. │ │ │ │ +0000e120: 2020 2020 2073 656d 6963 6f6c 6f6e 7320 semicolons │ │ │ │ +0000e130: 746f 2074 7279 2073 6576 6572 616c 206d to try several m │ │ │ │ +0000e140: 6f64 6573 2069 6e20 7365 7175 656e 6365 odes in sequence │ │ │ │ +0000e150: 2e20 202a 4e6f 7465 2067 6678 7061 796c . *Note gfxpayl │ │ │ │ +0000e160: 6f61 643a 3a2e 0a0a 2020 2020 2044 6570 oad::... Dep │ │ │ │ +0000e170: 656e 6469 6e67 206f 6e20 796f 7572 206b ending on your k │ │ │ │ +0000e180: 6572 6e65 6c2c 2079 6f75 7220 6469 7374 ernel, your dist │ │ │ │ +0000e190: 7269 6275 7469 6f6e 2c20 796f 7572 2067 ribution, your g │ │ │ │ +0000e1a0: 7261 7068 6963 7320 6361 7264 2c0a 2020 raphics card,. │ │ │ │ +0000e1b0: 2020 2061 6e64 2074 6865 2070 6861 7365 and the phase │ │ │ │ +0000e1c0: 206f 6620 7468 6520 6d6f 6f6e 2c20 6e6f of the moon, no │ │ │ │ +0000e1d0: 7465 2074 6861 7420 7573 696e 6720 7468 te that using th │ │ │ │ +0000e1e0: 6973 206f 7074 696f 6e20 6d61 7920 6361 is option may ca │ │ │ │ +0000e1f0: 7573 650a 2020 2020 2047 4e55 2f4c 696e use. GNU/Lin │ │ │ │ +0000e200: 7578 2074 6f20 7375 6666 6572 2066 726f ux to suffer fro │ │ │ │ +0000e210: 6d20 7661 7269 6f75 7320 6469 7370 6c61 m various displa │ │ │ │ +0000e220: 7920 7072 6f62 6c65 6d73 2c20 7061 7274 y problems, part │ │ │ │ +0000e230: 6963 756c 6172 6c79 0a20 2020 2020 6475 icularly. du │ │ │ │ +0000e240: 7269 6e67 2074 6865 2065 6172 6c79 2070 ring the early p │ │ │ │ +0000e250: 6172 7420 6f66 2074 6865 2062 6f6f 7420 art of the boot │ │ │ │ +0000e260: 7365 7175 656e 6365 2e20 2049 6620 796f sequence. If yo │ │ │ │ +0000e270: 7520 6861 7665 2070 726f 626c 656d 732c u have problems, │ │ │ │ +0000e280: 0a20 2020 2020 7365 7420 7468 6973 206f . set this o │ │ │ │ +0000e290: 7074 696f 6e20 746f 2027 7465 7874 2720 ption to 'text' │ │ │ │ +0000e2a0: 616e 6420 4752 5542 2077 696c 6c20 7465 and GRUB will te │ │ │ │ +0000e2b0: 6c6c 204c 696e 7578 2074 6f20 626f 6f74 ll Linux to boot │ │ │ │ +0000e2c0: 2069 6e0a 2020 2020 206e 6f72 6d61 6c20 in. normal │ │ │ │ +0000e2d0: 7465 7874 206d 6f64 652e 0a0a 2747 5255 text mode...'GRU │ │ │ │ +0000e2e0: 425f 4449 5341 424c 455f 4f53 5f50 524f B_DISABLE_OS_PRO │ │ │ │ +0000e2f0: 4245 5227 0a20 2020 2020 4e6f 726d 616c BER'. Normal │ │ │ │ +0000e300: 6c79 2c20 2767 7275 622d 6d6b 636f 6e66 ly, 'grub-mkconf │ │ │ │ +0000e310: 6967 2720 7769 6c6c 2074 7279 2074 6f20 ig' will try to │ │ │ │ +0000e320: 7573 6520 7468 6520 6578 7465 726e 616c use the external │ │ │ │ +0000e330: 2027 6f73 2d70 726f 6265 7227 0a20 2020 'os-prober'. │ │ │ │ +0000e340: 2020 7072 6f67 7261 6d2c 2069 6620 696e program, if in │ │ │ │ +0000e350: 7374 616c 6c65 642c 2074 6f20 6469 7363 stalled, to disc │ │ │ │ +0000e360: 6f76 6572 206f 7468 6572 206f 7065 7261 over other opera │ │ │ │ +0000e370: 7469 6e67 2073 7973 7465 6d73 0a20 2020 ting systems. │ │ │ │ +0000e380: 2020 696e 7374 616c 6c65 6420 6f6e 2074 installed on t │ │ │ │ +0000e390: 6865 2073 616d 6520 7379 7374 656d 2061 he same system a │ │ │ │ +0000e3a0: 6e64 2067 656e 6572 6174 6520 6170 7072 nd generate appr │ │ │ │ +0000e3b0: 6f70 7269 6174 6520 6d65 6e75 2065 6e74 opriate menu ent │ │ │ │ +0000e3c0: 7269 6573 0a20 2020 2020 666f 7220 7468 ries. for th │ │ │ │ +0000e3d0: 656d 2e20 2053 6574 2074 6869 7320 6f70 em. Set this op │ │ │ │ +0000e3e0: 7469 6f6e 2074 6f20 2774 7275 6527 2074 tion to 'true' t │ │ │ │ +0000e3f0: 6f20 6469 7361 626c 6520 7468 6973 2e0a o disable this.. │ │ │ │ +0000e400: 0a27 4752 5542 5f4f 535f 5052 4f42 4552 .'GRUB_OS_PROBER │ │ │ │ +0000e410: 5f53 4b49 505f 4c49 5354 270a 2020 2020 _SKIP_LIST'. │ │ │ │ +0000e420: 204c 6973 7420 6f66 2073 7061 6365 2d73 List of space-s │ │ │ │ +0000e430: 6570 6172 6174 6564 2046 5320 5555 4944 eparated FS UUID │ │ │ │ +0000e440: 7320 6f66 2066 696c 6573 7973 7465 6d73 s of filesystems │ │ │ │ +0000e450: 2074 6f20 6265 2069 676e 6f72 6564 2066 to be ignored f │ │ │ │ +0000e460: 726f 6d0a 2020 2020 206f 732d 7072 6f62 rom. os-prob │ │ │ │ +0000e470: 6572 206f 7574 7075 742e 2020 466f 7220 er output. For │ │ │ │ +0000e480: 6566 6920 6368 6169 6e6c 6f61 6465 7273 efi chainloaders │ │ │ │ +0000e490: 2069 7427 7320 3c55 5549 443e 403c 4546 it's @..'GRUB_D │ │ │ │ +0000e4b0: 4953 4142 4c45 5f53 5542 4d45 4e55 270a ISABLE_SUBMENU'. │ │ │ │ +0000e4c0: 2020 2020 204e 6f72 6d61 6c6c 792c 2027 Normally, ' │ │ │ │ +0000e4d0: 6772 7562 2d6d 6b63 6f6e 6669 6727 2077 grub-mkconfig' w │ │ │ │ +0000e4e0: 696c 6c20 6765 6e65 7261 7465 2074 6f70 ill generate top │ │ │ │ +0000e4f0: 206c 6576 656c 206d 656e 7520 656e 7472 level menu entr │ │ │ │ +0000e500: 7920 666f 720a 2020 2020 2074 6865 206b y for. the k │ │ │ │ +0000e510: 6572 6e65 6c20 7769 7468 2068 6967 6865 ernel with highe │ │ │ │ +0000e520: 7374 2076 6572 7369 6f6e 206e 756d 6265 st version numbe │ │ │ │ +0000e530: 7220 616e 6420 7075 7420 616c 6c20 6f74 r and put all ot │ │ │ │ +0000e540: 6865 7220 666f 756e 640a 2020 2020 206b her found. k │ │ │ │ +0000e550: 6572 6e65 6c73 206f 7220 616c 7465 726e ernels or altern │ │ │ │ +0000e560: 6174 6976 6520 6d65 6e75 2065 6e74 7269 ative menu entri │ │ │ │ +0000e570: 6573 2066 6f72 2072 6563 6f76 6572 7920 es for recovery │ │ │ │ +0000e580: 6d6f 6465 2069 6e20 7375 626d 656e 752e mode in submenu. │ │ │ │ +0000e590: 0a20 2020 2020 466f 7220 656e 7472 6965 . For entrie │ │ │ │ +0000e5a0: 7320 7265 7475 726e 6564 2062 7920 276f s returned by 'o │ │ │ │ +0000e5b0: 732d 7072 6f62 6572 2720 6669 7273 7420 s-prober' first │ │ │ │ +0000e5c0: 656e 7472 7920 7769 6c6c 2062 6520 7075 entry will be pu │ │ │ │ +0000e5d0: 7420 6f6e 2074 6f70 0a20 2020 2020 6c65 t on top. le │ │ │ │ +0000e5e0: 7665 6c20 616e 6420 616c 6c20 6f74 6865 vel and all othe │ │ │ │ +0000e5f0: 7273 2069 6e20 7375 626d 656e 752e 2020 rs in submenu. │ │ │ │ +0000e600: 4966 2074 6869 7320 6f70 7469 6f6e 2069 If this option i │ │ │ │ +0000e610: 7320 7365 7420 746f 2027 7927 2c0a 2020 s set to 'y',. │ │ │ │ +0000e620: 2020 2066 6c61 7420 6d65 6e75 2077 6974 flat menu wit │ │ │ │ +0000e630: 6820 616c 6c20 656e 7472 6965 7320 6f6e h all entries on │ │ │ │ +0000e640: 2074 6f70 206c 6576 656c 2077 696c 6c20 top level will │ │ │ │ +0000e650: 6265 2067 656e 6572 6174 6564 2069 6e73 be generated ins │ │ │ │ +0000e660: 7465 6164 2e0a 2020 2020 2043 6861 6e67 tead.. Chang │ │ │ │ +0000e670: 696e 6720 7468 6973 206f 7074 696f 6e20 ing this option │ │ │ │ +0000e680: 7769 6c6c 2072 6571 7569 7265 2063 6861 will require cha │ │ │ │ +0000e690: 6e67 696e 6720 6578 6973 7469 6e67 2076 nging existing v │ │ │ │ +0000e6a0: 616c 7565 7320 6f66 0a20 2020 2020 2747 alues of. 'G │ │ │ │ +0000e6b0: 5255 425f 4445 4641 554c 5427 2c20 2766 RUB_DEFAULT', 'f │ │ │ │ +0000e6c0: 616c 6c62 6163 6b27 2028 2a6e 6f74 6520 allback' (*note │ │ │ │ +0000e6d0: 6661 6c6c 6261 636b 3a3a 2920 616e 6420 fallback::) and │ │ │ │ +0000e6e0: 2764 6566 6175 6c74 2720 282a 6e6f 7465 'default' (*note │ │ │ │ +0000e6f0: 0a20 2020 2020 6465 6661 756c 743a 3a29 . default::) │ │ │ │ +0000e700: 2065 6e76 6972 6f6e 6d65 6e74 2076 6172 environment var │ │ │ │ +0000e710: 6961 626c 6573 2061 7320 7765 6c6c 2061 iables as well a │ │ │ │ +0000e720: 7320 7361 7665 6420 6465 6661 756c 7420 s saved default │ │ │ │ +0000e730: 656e 7472 790a 2020 2020 2075 7369 6e67 entry. using │ │ │ │ +0000e740: 2027 6772 7562 2d73 6574 2d64 6566 6175 'grub-set-defau │ │ │ │ +0000e750: 6c74 2720 616e 6420 7661 6c75 6520 7573 lt' and value us │ │ │ │ +0000e760: 6564 2077 6974 6820 2767 7275 622d 7265 ed with 'grub-re │ │ │ │ +0000e770: 626f 6f74 272e 0a0a 2747 5255 425f 454e boot'...'GRUB_EN │ │ │ │ +0000e780: 4142 4c45 5f43 5259 5054 4f44 4953 4b27 ABLE_CRYPTODISK' │ │ │ │ +0000e790: 0a20 2020 2020 4966 2073 6574 2074 6f20 . If set to │ │ │ │ +0000e7a0: 2779 272c 2027 6772 7562 2d6d 6b63 6f6e 'y', 'grub-mkcon │ │ │ │ +0000e7b0: 6669 6727 2061 6e64 2027 6772 7562 2d69 fig' and 'grub-i │ │ │ │ +0000e7c0: 6e73 7461 6c6c 2720 7769 6c6c 2063 6865 nstall' will che │ │ │ │ +0000e7d0: 636b 2066 6f72 0a20 2020 2020 656e 6372 ck for. encr │ │ │ │ +0000e7e0: 7970 7465 6420 6469 736b 7320 616e 6420 ypted disks and │ │ │ │ +0000e7f0: 6765 6e65 7261 7465 2061 6464 6974 696f generate additio │ │ │ │ +0000e800: 6e61 6c20 636f 6d6d 616e 6473 206e 6565 nal commands nee │ │ │ │ +0000e810: 6465 6420 746f 2061 6363 6573 730a 2020 ded to access. │ │ │ │ +0000e820: 2020 2074 6865 6d20 6475 7269 6e67 2062 them during b │ │ │ │ +0000e830: 6f6f 742e 2020 4e6f 7465 2074 6861 7420 oot. Note that │ │ │ │ +0000e840: 696e 2074 6869 7320 6361 7365 2075 6e61 in this case una │ │ │ │ +0000e850: 7474 656e 6465 6420 626f 6f74 2069 7320 ttended boot is │ │ │ │ +0000e860: 6e6f 740a 2020 2020 2070 6f73 7369 626c not. possibl │ │ │ │ +0000e870: 6520 6265 6361 7573 6520 4752 5542 2077 e because GRUB w │ │ │ │ +0000e880: 696c 6c20 7761 6974 2066 6f72 2070 6173 ill wait for pas │ │ │ │ +0000e890: 7370 6872 6173 6520 746f 2075 6e6c 6f63 sphrase to unloc │ │ │ │ +0000e8a0: 6b20 656e 6372 7970 7465 640a 2020 2020 k encrypted. │ │ │ │ +0000e8b0: 2063 6f6e 7461 696e 6572 2e0a 0a27 4752 container...'GR │ │ │ │ +0000e8c0: 5542 5f49 4e49 545f 5455 4e45 270a 2020 UB_INIT_TUNE'. │ │ │ │ +0000e8d0: 2020 2050 6c61 7920 6120 7475 6e65 206f Play a tune o │ │ │ │ +0000e8e0: 6e20 7468 6520 7370 6561 6b65 7220 7768 n the speaker wh │ │ │ │ +0000e8f0: 656e 2047 5255 4220 7374 6172 7473 2e20 en GRUB starts. │ │ │ │ +0000e900: 2054 6869 7320 6973 2070 6172 7469 6375 This is particu │ │ │ │ +0000e910: 6c61 726c 790a 2020 2020 2075 7365 6675 larly. usefu │ │ │ │ +0000e920: 6c20 666f 7220 7573 6572 7320 756e 6162 l for users unab │ │ │ │ +0000e930: 6c65 2074 6f20 7365 6520 7468 6520 7363 le to see the sc │ │ │ │ +0000e940: 7265 656e 2e20 2054 6865 2076 616c 7565 reen. The value │ │ │ │ +0000e950: 206f 6620 7468 6973 0a20 2020 2020 6f70 of this. op │ │ │ │ +0000e960: 7469 6f6e 2069 7320 7061 7373 6564 2064 tion is passed d │ │ │ │ +0000e970: 6972 6563 746c 7920 746f 202a 6e6f 7465 irectly to *note │ │ │ │ +0000e980: 2070 6c61 793a 3a2e 0a0a 2747 5255 425f play::...'GRUB_ │ │ │ │ +0000e990: 4241 4452 414d 270a 2020 2020 2049 6620 BADRAM'. If │ │ │ │ +0000e9a0: 7468 6973 206f 7074 696f 6e20 6973 2073 this option is s │ │ │ │ +0000e9b0: 6574 2c20 4752 5542 2077 696c 6c20 6973 et, GRUB will is │ │ │ │ +0000e9c0: 7375 6520 6120 2a6e 6f74 6520 6261 6472 sue a *note badr │ │ │ │ +0000e9d0: 616d 3a3a 2063 6f6d 6d61 6e64 2074 6f0a am:: command to. │ │ │ │ +0000e9e0: 2020 2020 2066 696c 7465 7220 6f75 7420 filter out │ │ │ │ +0000e9f0: 7370 6563 6966 6965 6420 7265 6769 6f6e specified region │ │ │ │ +0000ea00: 7320 6f66 2052 414d 2e0a 0a27 4752 5542 s of RAM...'GRUB │ │ │ │ +0000ea10: 5f50 5245 4c4f 4144 5f4d 4f44 554c 4553 _PRELOAD_MODULES │ │ │ │ +0000ea20: 270a 2020 2020 2054 6869 7320 6f70 7469 '. This opti │ │ │ │ +0000ea30: 6f6e 206d 6179 2062 6520 7365 7420 746f on may be set to │ │ │ │ +0000ea40: 2061 206c 6973 7420 6f66 2047 5255 4220 a list of GRUB │ │ │ │ +0000ea50: 6d6f 6475 6c65 206e 616d 6573 2073 6570 module names sep │ │ │ │ +0000ea60: 6172 6174 6564 2062 790a 2020 2020 2073 arated by. s │ │ │ │ +0000ea70: 7061 6365 732e 2020 4561 6368 206d 6f64 paces. Each mod │ │ │ │ +0000ea80: 756c 6520 7769 6c6c 2062 6520 6c6f 6164 ule will be load │ │ │ │ +0000ea90: 6564 2061 7320 6561 726c 7920 6173 2070 ed as early as p │ │ │ │ +0000eaa0: 6f73 7369 626c 652c 2061 7420 7468 650a ossible, at the. │ │ │ │ +0000eab0: 2020 2020 2073 7461 7274 206f 6620 2767 start of 'g │ │ │ │ +0000eac0: 7275 622e 6366 6727 2e0a 0a27 4752 5542 rub.cfg'...'GRUB │ │ │ │ +0000ead0: 5f52 4543 4f52 4446 4149 4c5f 5449 4d45 _RECORDFAIL_TIME │ │ │ │ +0000eae0: 4f55 5427 0a20 2020 2020 4966 2074 6869 OUT'. If thi │ │ │ │ +0000eaf0: 7320 6f70 7469 6f6e 2069 7320 7365 742c s option is set, │ │ │ │ +0000eb00: 2069 7420 6f76 6572 7269 6465 7320 7468 it overrides th │ │ │ │ +0000eb10: 6520 6465 6661 756c 7420 7265 636f 7264 e default record │ │ │ │ +0000eb20: 6661 696c 2073 6574 7469 6e67 2e0a 2020 fail setting.. │ │ │ │ +0000eb30: 2020 2041 2073 6574 7469 6e67 206f 6620 A setting of │ │ │ │ +0000eb40: 2d31 2063 6175 7365 7320 4752 5542 2074 -1 causes GRUB t │ │ │ │ +0000eb50: 6f20 7761 6974 2066 6f72 2075 7365 7220 o wait for user │ │ │ │ +0000eb60: 696e 7075 7420 696e 6465 6669 6e69 7465 input indefinite │ │ │ │ +0000eb70: 6c79 2e0a 2020 2020 2048 6f77 6576 6572 ly.. However │ │ │ │ +0000eb80: 2c20 6120 6661 6c73 6520 706f 7369 7469 , a false positi │ │ │ │ +0000eb90: 7665 2069 6e20 7468 6520 7265 636f 7264 ve in the record │ │ │ │ +0000eba0: 6661 696c 206d 6563 6861 6e69 736d 206d fail mechanism m │ │ │ │ +0000ebb0: 6179 206f 6363 7572 2069 660a 2020 2020 ay occur if. │ │ │ │ +0000ebc0: 2070 6f77 6572 2069 7320 6c6f 7374 2064 power is lost d │ │ │ │ +0000ebd0: 7572 696e 6720 626f 6f74 2062 6566 6f72 uring boot befor │ │ │ │ +0000ebe0: 6520 626f 6f74 2073 7563 6365 7373 2069 e boot success i │ │ │ │ +0000ebf0: 7320 7265 636f 7264 6564 2069 6e0a 2020 s recorded in. │ │ │ │ +0000ec00: 2020 2075 7365 7273 7061 6365 2e20 2054 userspace. T │ │ │ │ +0000ec10: 6865 2064 6566 6175 6c74 2073 6574 7469 he default setti │ │ │ │ +0000ec20: 6e67 2069 7320 3330 2c20 7768 6963 6820 ng is 30, which │ │ │ │ +0000ec30: 6361 7573 6573 2047 5255 4220 746f 2077 causes GRUB to w │ │ │ │ +0000ec40: 6169 740a 2020 2020 2066 6f72 2075 7365 ait. for use │ │ │ │ +0000ec50: 7220 696e 7075 7420 666f 7220 7468 6972 r input for thir │ │ │ │ +0000ec60: 7479 2073 6563 6f6e 6473 2062 6566 6f72 ty seconds befor │ │ │ │ +0000ec70: 6520 636f 6e74 696e 7569 6e67 2e20 2054 e continuing. T │ │ │ │ +0000ec80: 6869 7320 6465 6661 756c 740a 2020 2020 his default. │ │ │ │ +0000ec90: 2061 6c6c 6f77 7320 696e 7465 7261 6374 allows interact │ │ │ │ +0000eca0: 6976 6520 7573 6572 7320 7468 6520 6f70 ive users the op │ │ │ │ +0000ecb0: 706f 7274 756e 6974 7920 746f 2073 7769 portunity to swi │ │ │ │ +0000ecc0: 7463 6820 746f 2061 2064 6966 6665 7265 tch to a differe │ │ │ │ +0000ecd0: 6e74 2c0a 2020 2020 2077 6f72 6b69 6e67 nt,. working │ │ │ │ +0000ece0: 206b 6572 6e65 6c2c 2077 6869 6c65 2061 kernel, while a │ │ │ │ +0000ecf0: 766f 6964 696e 6720 6120 6661 6c73 6520 voiding a false │ │ │ │ +0000ed00: 706f 7369 7469 7665 2063 6175 7369 6e67 positive causing │ │ │ │ +0000ed10: 2074 6865 2062 6f6f 7420 746f 0a20 2020 the boot to. │ │ │ │ +0000ed20: 2020 626c 6f63 6b20 696e 6465 6669 6e69 block indefini │ │ │ │ +0000ed30: 7465 6c79 206f 6e20 6865 6164 6c65 7373 tely on headless │ │ │ │ +0000ed40: 2061 6e64 2061 7070 6c69 616e 6365 2073 and appliance s │ │ │ │ +0000ed50: 7973 7465 6d73 2077 6865 7265 2061 6363 ystems where acc │ │ │ │ +0000ed60: 6573 730a 2020 2020 2074 6f20 6120 636f ess. to a co │ │ │ │ +0000ed70: 6e73 6f6c 6520 6973 2072 6573 7472 6963 nsole is restric │ │ │ │ +0000ed80: 7465 6420 6f72 206c 696d 6974 6564 2e0a ted or limited.. │ │ │ │ +0000ed90: 0a20 2020 2020 5468 6973 206f 7074 696f . This optio │ │ │ │ +0000eda0: 6e20 6973 206f 6e6c 7920 6566 6665 6374 n is only effect │ │ │ │ +0000edb0: 6976 6520 7768 656e 2047 5255 4220 7761 ive when GRUB wa │ │ │ │ +0000edc0: 7320 636f 6e66 6967 7572 6564 2077 6974 s configured wit │ │ │ │ +0000edd0: 6820 7468 650a 2020 2020 2027 2d2d 656e h the. '--en │ │ │ │ +0000ede0: 6162 6c65 2d71 7569 636b 2d62 6f6f 7427 able-quick-boot' │ │ │ │ +0000edf0: 206f 7074 696f 6e2e 0a0a 2747 5255 425f option...'GRUB_ │ │ │ │ +0000ee00: 5245 434f 5645 5259 5f54 4954 4c45 270a RECOVERY_TITLE'. │ │ │ │ +0000ee10: 2020 2020 2054 6869 7320 6f70 7469 6f6e This option │ │ │ │ +0000ee20: 2073 6574 7320 7468 6520 456e 676c 6973 sets the Englis │ │ │ │ +0000ee30: 6820 7465 7874 206f 6620 7468 6520 7374 h text of the st │ │ │ │ +0000ee40: 7269 6e67 2074 6861 7420 7769 6c6c 2062 ring that will b │ │ │ │ +0000ee50: 650a 2020 2020 2064 6973 706c 6179 6564 e. displayed │ │ │ │ +0000ee60: 2069 6e20 7061 7265 6e74 6865 7365 7320 in parentheses │ │ │ │ +0000ee70: 746f 2069 6e64 6963 6174 6520 7468 6174 to indicate that │ │ │ │ +0000ee80: 2061 2062 6f6f 7420 6f70 7469 6f6e 2069 a boot option i │ │ │ │ +0000ee90: 7320 7072 6f76 6964 6564 0a20 2020 2020 s provided. │ │ │ │ +0000eea0: 746f 2068 656c 7020 7573 6572 7320 7265 to help users re │ │ │ │ +0000eeb0: 636f 7665 7220 6120 6272 6f6b 656e 2073 cover a broken s │ │ │ │ +0000eec0: 7973 7465 6d2e 2020 5468 6520 6465 6661 ystem. The defa │ │ │ │ +0000eed0: 756c 7420 6973 2022 7265 636f 7665 7279 ult is "recovery │ │ │ │ +0000eee0: 0a20 2020 2020 6d6f 6465 222e 0a0a 2020 . mode"... │ │ │ │ +0000eef0: 2054 6865 2066 6f6c 6c6f 7769 6e67 206f The following o │ │ │ │ +0000ef00: 7074 696f 6e73 2061 7265 2073 7469 6c6c ptions are still │ │ │ │ +0000ef10: 2061 6363 6570 7465 6420 666f 7220 636f accepted for co │ │ │ │ +0000ef20: 6d70 6174 6962 696c 6974 7920 7769 7468 mpatibility with │ │ │ │ +0000ef30: 0a65 7869 7374 696e 6720 636f 6e66 6967 .existing config │ │ │ │ +0000ef40: 7572 6174 696f 6e73 2c20 6275 7420 6861 urations, but ha │ │ │ │ +0000ef50: 7665 2062 6574 7465 7220 7265 706c 6163 ve better replac │ │ │ │ +0000ef60: 656d 656e 7473 3a0a 0a27 4752 5542 5f48 ements:..'GRUB_H │ │ │ │ +0000ef70: 4944 4445 4e5f 5449 4d45 4f55 5427 0a20 IDDEN_TIMEOUT'. │ │ │ │ +0000ef80: 2020 2020 5761 6974 2074 6869 7320 6d61 Wait this ma │ │ │ │ +0000ef90: 6e79 2073 6563 6f6e 6473 2062 6566 6f72 ny seconds befor │ │ │ │ +0000efa0: 6520 6469 7370 6c61 7969 6e67 2074 6865 e displaying the │ │ │ │ +0000efb0: 206d 656e 752e 2020 4966 203c 4553 433e menu. If │ │ │ │ +0000efc0: 2069 730a 2020 2020 2070 7265 7373 6564 is. pressed │ │ │ │ +0000efd0: 2064 7572 696e 6720 7468 6174 2074 696d during that tim │ │ │ │ +0000efe0: 652c 2064 6973 706c 6179 2074 6865 206d e, display the m │ │ │ │ +0000eff0: 656e 7520 616e 6420 7761 6974 2066 6f72 enu and wait for │ │ │ │ +0000f000: 2069 6e70 7574 0a20 2020 2020 6163 636f input. acco │ │ │ │ +0000f010: 7264 696e 6720 746f 2027 4752 5542 5f54 rding to 'GRUB_T │ │ │ │ +0000f020: 494d 454f 5554 272e 2020 4966 2061 2068 IMEOUT'. If a h │ │ │ │ +0000f030: 6f74 6b65 7920 6173 736f 6369 6174 6564 otkey associated │ │ │ │ +0000f040: 2077 6974 6820 6120 6d65 6e75 0a20 2020 with a menu. │ │ │ │ +0000f050: 2020 656e 7472 7920 6973 2070 7265 7373 entry is press │ │ │ │ +0000f060: 6564 2c20 626f 6f74 2074 6865 2061 7373 ed, boot the ass │ │ │ │ +0000f070: 6f63 6961 7465 6420 6d65 6e75 2065 6e74 ociated menu ent │ │ │ │ +0000f080: 7279 2069 6d6d 6564 6961 7465 6c79 2e20 ry immediately. │ │ │ │ +0000f090: 2049 660a 2020 2020 2074 6865 2074 696d If. the tim │ │ │ │ +0000f0a0: 656f 7574 2065 7870 6972 6573 2062 6566 eout expires bef │ │ │ │ +0000f0b0: 6f72 6520 6569 7468 6572 206f 6620 7468 ore either of th │ │ │ │ +0000f0c0: 6573 6520 6861 7070 656e 732c 2064 6973 ese happens, dis │ │ │ │ +0000f0d0: 706c 6179 2074 6865 0a20 2020 2020 6d65 play the. me │ │ │ │ +0000f0e0: 6e75 2066 6f72 2074 6865 206e 756d 6265 nu for the numbe │ │ │ │ +0000f0f0: 7220 6f66 2073 6563 6f6e 6473 2073 7065 r of seconds spe │ │ │ │ +0000f100: 6369 6669 6564 2069 6e20 2747 5255 425f cified in 'GRUB_ │ │ │ │ +0000f110: 5449 4d45 4f55 5427 2062 6566 6f72 650a TIMEOUT' before. │ │ │ │ +0000f120: 2020 2020 2062 6f6f 7469 6e67 2074 6865 booting the │ │ │ │ +0000f130: 2064 6566 6175 6c74 2065 6e74 7279 2e0a default entry.. │ │ │ │ +0000f140: 0a20 2020 2020 4966 2079 6f75 2073 6574 . If you set │ │ │ │ +0000f150: 2027 4752 5542 5f48 4944 4445 4e5f 5449 'GRUB_HIDDEN_TI │ │ │ │ +0000f160: 4d45 4f55 5427 2c20 796f 7520 7368 6f75 MEOUT', you shou │ │ │ │ +0000f170: 6c64 2061 6c73 6f20 7365 740a 2020 2020 ld also set. │ │ │ │ +0000f180: 2027 4752 5542 5f54 494d 454f 5554 3d30 'GRUB_TIMEOUT=0 │ │ │ │ +0000f190: 2720 736f 2074 6861 7420 7468 6520 6d65 ' so that the me │ │ │ │ +0000f1a0: 6e75 2069 7320 6e6f 7420 6469 7370 6c61 nu is not displa │ │ │ │ +0000f1b0: 7965 6420 6174 2061 6c6c 2075 6e6c 6573 yed at all unles │ │ │ │ +0000f1c0: 730a 2020 2020 203c 4553 433e 2069 7320 s. is │ │ │ │ +0000f1d0: 7072 6573 7365 642e 0a0a 2020 2020 2054 pressed... T │ │ │ │ +0000f1e0: 6869 7320 6f70 7469 6f6e 2069 7320 756e his option is un │ │ │ │ +0000f1f0: 7365 7420 6279 2064 6566 6175 6c74 2c20 set by default, │ │ │ │ +0000f200: 616e 6420 6973 2064 6570 7265 6361 7465 and is deprecate │ │ │ │ +0000f210: 6420 696e 2066 6176 6f75 7220 6f66 2074 d in favour of t │ │ │ │ +0000f220: 6865 0a20 2020 2020 6c65 7373 2063 6f6e he. less con │ │ │ │ +0000f230: 6675 7369 6e67 2027 4752 5542 5f54 494d fusing 'GRUB_TIM │ │ │ │ +0000f240: 454f 5554 5f53 5459 4c45 3d63 6f75 6e74 EOUT_STYLE=count │ │ │ │ +0000f250: 646f 776e 2720 6f72 0a20 2020 2020 2747 down' or. 'G │ │ │ │ +0000f260: 5255 425f 5449 4d45 4f55 545f 5354 594c RUB_TIMEOUT_STYL │ │ │ │ +0000f270: 453d 6869 6464 656e 272e 0a0a 2747 5255 E=hidden'...'GRU │ │ │ │ +0000f280: 425f 4849 4444 454e 5f54 494d 454f 5554 B_HIDDEN_TIMEOUT │ │ │ │ +0000f290: 5f51 5549 4554 270a 2020 2020 2049 6e20 _QUIET'. In │ │ │ │ +0000f2a0: 636f 6e6a 756e 6374 696f 6e20 7769 7468 conjunction with │ │ │ │ +0000f2b0: 2027 4752 5542 5f48 4944 4445 4e5f 5449 'GRUB_HIDDEN_TI │ │ │ │ +0000f2c0: 4d45 4f55 5427 2c20 7365 7420 7468 6973 MEOUT', set this │ │ │ │ +0000f2d0: 2074 6f20 2774 7275 6527 2074 6f0a 2020 to 'true' to. │ │ │ │ +0000f2e0: 2020 2073 7570 7072 6573 7320 7468 6520 suppress the │ │ │ │ +0000f2f0: 7665 7262 6f73 6520 636f 756e 7464 6f77 verbose countdow │ │ │ │ +0000f300: 6e20 7768 696c 6520 7761 6974 696e 6720 n while waiting │ │ │ │ +0000f310: 666f 7220 6120 6b65 7920 746f 2062 650a for a key to be. │ │ │ │ +0000f320: 2020 2020 2070 7265 7373 6564 2062 6566 pressed bef │ │ │ │ +0000f330: 6f72 6520 6469 7370 6c61 7969 6e67 2074 ore displaying t │ │ │ │ +0000f340: 6865 206d 656e 752e 0a0a 2020 2020 2054 he menu... T │ │ │ │ +0000f350: 6869 7320 6f70 7469 6f6e 2069 7320 756e his option is un │ │ │ │ +0000f360: 7365 7420 6279 2064 6566 6175 6c74 2c20 set by default, │ │ │ │ +0000f370: 616e 6420 6973 2064 6570 7265 6361 7465 and is deprecate │ │ │ │ +0000f380: 6420 696e 2066 6176 6f75 7220 6f66 2074 d in favour of t │ │ │ │ +0000f390: 6865 0a20 2020 2020 6c65 7373 2063 6f6e he. less con │ │ │ │ +0000f3a0: 6675 7369 6e67 2027 4752 5542 5f54 494d fusing 'GRUB_TIM │ │ │ │ +0000f3b0: 454f 5554 5f53 5459 4c45 3d63 6f75 6e74 EOUT_STYLE=count │ │ │ │ +0000f3c0: 646f 776e 272e 0a0a 2747 5255 425f 4849 down'...'GRUB_HI │ │ │ │ +0000f3d0: 4444 454e 5f54 494d 454f 5554 5f42 5554 DDEN_TIMEOUT_BUT │ │ │ │ +0000f3e0: 544f 4e27 0a20 2020 2020 5661 7269 616e TON'. Varian │ │ │ │ +0000f3f0: 7420 6f66 2027 4752 5542 5f48 4944 4445 t of 'GRUB_HIDDE │ │ │ │ +0000f400: 4e5f 5449 4d45 4f55 5427 2c20 7573 6564 N_TIMEOUT', used │ │ │ │ +0000f410: 2074 6f20 7375 7070 6f72 7420 7665 6e64 to support vend │ │ │ │ +0000f420: 6f72 2d73 7065 6369 6669 630a 2020 2020 or-specific. │ │ │ │ +0000f430: 2070 6f77 6572 2062 7574 746f 6e73 2e20 power buttons. │ │ │ │ +0000f440: 202a 4e6f 7465 2056 656e 646f 7220 706f *Note Vendor po │ │ │ │ +0000f450: 7765 722d 6f6e 206b 6579 733a 3a2e 0a0a wer-on keys::... │ │ │ │ +0000f460: 2020 2020 2054 6869 7320 6f70 7469 6f6e This option │ │ │ │ +0000f470: 2069 7320 756e 7365 7420 6279 2064 6566 is unset by def │ │ │ │ +0000f480: 6175 6c74 2c20 616e 6420 6973 2064 6570 ault, and is dep │ │ │ │ +0000f490: 7265 6361 7465 6420 696e 2066 6176 6f75 recated in favou │ │ │ │ +0000f4a0: 7220 6f66 2074 6865 0a20 2020 2020 6c65 r of the. le │ │ │ │ +0000f4b0: 7373 2063 6f6e 6675 7369 6e67 2027 4752 ss confusing 'GR │ │ │ │ +0000f4c0: 5542 5f54 494d 454f 5554 5f53 5459 4c45 UB_TIMEOUT_STYLE │ │ │ │ +0000f4d0: 3d63 6f75 6e74 646f 776e 2720 6f72 0a20 =countdown' or. │ │ │ │ +0000f4e0: 2020 2020 2747 5255 425f 5449 4d45 4f55 'GRUB_TIMEOU │ │ │ │ +0000f4f0: 545f 5354 594c 453d 6869 6464 656e 272e T_STYLE=hidden'. │ │ │ │ +0000f500: 0a0a 2020 2046 6f72 206d 6f72 6520 6465 .. For more de │ │ │ │ +0000f510: 7461 696c 6564 2063 7573 746f 6d69 7361 tailed customisa │ │ │ │ +0000f520: 7469 6f6e 206f 6620 2767 7275 622d 6d6b tion of 'grub-mk │ │ │ │ +0000f530: 636f 6e66 6967 2727 7320 6f75 7470 7574 config''s output │ │ │ │ +0000f540: 2c20 796f 7520 6d61 790a 6564 6974 2074 , you may.edit t │ │ │ │ +0000f550: 6865 2073 6372 6970 7473 2069 6e20 272f he scripts in '/ │ │ │ │ +0000f560: 6574 632f 6772 7562 2e64 2720 6469 7265 etc/grub.d' dire │ │ │ │ +0000f570: 6374 6c79 2e20 2027 2f65 7463 2f67 7275 ctly. '/etc/gru │ │ │ │ +0000f580: 622e 642f 3430 5f63 7573 746f 6d27 2069 b.d/40_custom' i │ │ │ │ +0000f590: 730a 7061 7274 6963 756c 6172 6c79 2075 s.particularly u │ │ │ │ +0000f5a0: 7365 6675 6c20 666f 7220 6164 6469 6e67 seful for adding │ │ │ │ +0000f5b0: 2065 6e74 6972 6520 6375 7374 6f6d 206d entire custom m │ │ │ │ +0000f5c0: 656e 7520 656e 7472 6965 733b 2073 696d enu entries; sim │ │ │ │ +0000f5d0: 706c 7920 7479 7065 0a74 6865 206d 656e ply type.the men │ │ │ │ +0000f5e0: 7520 656e 7472 6965 7320 796f 7520 7761 u entries you wa │ │ │ │ +0000f5f0: 6e74 2074 6f20 6164 6420 6174 2074 6865 nt to add at the │ │ │ │ +0000f600: 2065 6e64 206f 6620 7468 6174 2066 696c end of that fil │ │ │ │ +0000f610: 652c 206d 616b 696e 6720 7375 7265 2074 e, making sure t │ │ │ │ +0000f620: 6f0a 6c65 6176 6520 6174 206c 6561 7374 o.leave at least │ │ │ │ +0000f630: 2074 6865 2066 6972 7374 2074 776f 206c the first two l │ │ │ │ +0000f640: 696e 6573 2069 6e74 6163 742e 0a0a 1f0a ines intact..... │ │ │ │ +0000f650: 4669 6c65 3a20 6772 7562 2e69 6e66 6f2c File: grub.info, │ │ │ │ +0000f660: 2020 4e6f 6465 3a20 526f 6f74 2049 6465 Node: Root Ide │ │ │ │ +0000f670: 6e74 6966 6361 7469 6f6e 2048 6575 7269 ntifcation Heuri │ │ │ │ +0000f680: 7374 6963 732c 2020 4e65 7874 3a20 5368 stics, Next: Sh │ │ │ │ +0000f690: 656c 6c2d 6c69 6b65 2073 6372 6970 7469 ell-like scripti │ │ │ │ +0000f6a0: 6e67 2c20 2050 7265 763a 2053 696d 706c ng, Prev: Simpl │ │ │ │ +0000f6b0: 6520 636f 6e66 6967 7572 6174 696f 6e2c e configuration, │ │ │ │ +0000f6c0: 2020 5570 3a20 436f 6e66 6967 7572 6174 Up: Configurat │ │ │ │ +0000f6d0: 696f 6e0a 0a36 2e32 2052 6f6f 7420 4964 ion..6.2 Root Id │ │ │ │ +0000f6e0: 656e 7469 6663 6174 696f 6e20 4865 7572 entifcation Heur │ │ │ │ +0000f6f0: 6973 7469 6373 0a3d 3d3d 3d3d 3d3d 3d3d istics.========= │ │ │ │ 0000f700: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ -0000f710: 3d3d 3d3d 0a0a 4966 2074 6865 2074 6172 ====..If the tar │ │ │ │ -0000f720: 6765 7420 6f70 6572 6174 696e 6720 7379 get operating sy │ │ │ │ -0000f730: 7374 656d 2075 7365 7320 7468 6520 4c69 stem uses the Li │ │ │ │ -0000f740: 6e75 7820 6b65 726e 656c 2c20 2767 7275 nux kernel, 'gru │ │ │ │ -0000f750: 622d 6d6b 636f 6e66 6967 270a 6174 7465 b-mkconfig'.atte │ │ │ │ -0000f760: 6d70 7473 2074 6f20 6964 656e 7469 6679 mpts to identify │ │ │ │ -0000f770: 2074 6865 2072 6f6f 7420 6669 6c65 2073 the root file s │ │ │ │ -0000f780: 7973 7465 6d20 7669 6120 6120 6865 7572 ystem via a heur │ │ │ │ -0000f790: 6973 7469 6320 616c 676f 6972 7468 6d2e istic algoirthm. │ │ │ │ -0000f7a0: 0a54 6869 7320 616c 676f 7269 7468 6d20 .This algorithm │ │ │ │ -0000f7b0: 7365 6c65 6374 7320 7468 6520 6964 656e selects the iden │ │ │ │ -0000f7c0: 7469 6669 6361 7469 6f6e 206d 6574 686f tification metho │ │ │ │ -0000f7d0: 6420 6f66 2074 6865 2072 6f6f 7420 6669 d of the root fi │ │ │ │ -0000f7e0: 6c65 2073 7973 7465 6d0a 6279 2063 6f6e le system.by con │ │ │ │ -0000f7f0: 7369 6465 7269 6e67 2074 6872 6565 2066 sidering three f │ │ │ │ -0000f800: 6163 746f 7273 2e20 2054 6865 2066 6972 actors. The fir │ │ │ │ -0000f810: 7374 2069 7320 6966 2061 6e20 696e 6974 st is if an init │ │ │ │ -0000f820: 7264 2066 6f72 2074 6865 2074 6172 6765 rd for the targe │ │ │ │ -0000f830: 740a 6f70 6572 6174 696e 6720 7379 7374 t.operating syst │ │ │ │ -0000f840: 656d 2069 7320 616c 736f 2070 7265 7365 em is also prese │ │ │ │ -0000f850: 6e74 2e20 2054 6865 2073 6563 6f6e 6420 nt. The second │ │ │ │ -0000f860: 6973 0a27 4752 5542 5f44 4953 4142 4c45 is.'GRUB_DISABLE │ │ │ │ -0000f870: 5f4c 494e 5558 5f55 5549 4427 2061 6e64 _LINUX_UUID' and │ │ │ │ -0000f880: 2069 6620 7365 7420 746f 2027 7472 7565 if set to 'true │ │ │ │ -0000f890: 272c 2070 7265 7665 6e74 7320 2767 7275 ', prevents 'gru │ │ │ │ -0000f8a0: 622d 6d6b 636f 6e66 6967 270a 6672 6f6d b-mkconfig'.from │ │ │ │ -0000f8b0: 2069 6465 6e74 6966 7969 6e67 2074 6865 identifying the │ │ │ │ -0000f8c0: 2072 6f6f 7420 6669 6c65 2073 7973 7465 root file syste │ │ │ │ -0000f8d0: 6d20 6279 2069 7473 2055 5549 442e 2054 m by its UUID. T │ │ │ │ -0000f8e0: 6865 2074 6869 7264 2069 730a 2747 5255 he third is.'GRU │ │ │ │ -0000f8f0: 425f 4449 5341 424c 455f 4c49 4e55 585f B_DISABLE_LINUX_ │ │ │ │ -0000f900: 5041 5254 5555 4944 2720 616e 6420 6966 PARTUUID' and if │ │ │ │ -0000f910: 2073 6574 2074 6f20 2774 7275 6527 2c20 set to 'true', │ │ │ │ -0000f920: 7072 6576 656e 7473 0a27 6772 7562 2d6d prevents.'grub-m │ │ │ │ -0000f930: 6b63 6f6e 6669 6727 2066 726f 6d20 6964 kconfig' from id │ │ │ │ -0000f940: 656e 7469 6679 696e 6720 7468 6520 726f entifying the ro │ │ │ │ -0000f950: 6f74 2066 696c 6520 7379 7374 656d 2076 ot file system v │ │ │ │ -0000f960: 6961 2074 6865 2055 5549 4420 6f66 0a69 ia the UUID of.i │ │ │ │ -0000f970: 7473 2065 6e63 6c6f 7369 6e67 2070 6172 ts enclosing par │ │ │ │ -0000f980: 7469 7469 6f6e 2e20 2049 6620 7468 6520 tition. If the │ │ │ │ -0000f990: 7661 7269 6162 6c65 7320 6172 6520 6173 variables are as │ │ │ │ -0000f9a0: 7369 676e 6564 2061 6e79 206f 7468 6572 signed any other │ │ │ │ -0000f9b0: 2076 616c 7565 2c0a 7468 6174 2076 616c value,.that val │ │ │ │ -0000f9c0: 7565 2069 7320 636f 6e73 6964 6572 6564 ue is considered │ │ │ │ -0000f9d0: 2065 7175 6976 616c 656e 7420 746f 2027 equivalent to ' │ │ │ │ -0000f9e0: 6661 6c73 6527 2e20 2054 6865 2076 6172 false'. The var │ │ │ │ -0000f9f0: 6961 626c 6573 2061 7265 2061 6c73 6f0a iables are also. │ │ │ │ -0000fa00: 636f 6e73 6964 6572 6564 2074 6f20 6265 considered to be │ │ │ │ -0000fa10: 2073 6574 2074 6f20 2766 616c 7365 2720 set to 'false' │ │ │ │ -0000fa20: 6966 2074 6865 7920 6172 6520 6e6f 7420 if they are not │ │ │ │ -0000fa30: 7365 742e 0a0a 2020 2057 6865 6e20 626f set... When bo │ │ │ │ -0000fa40: 6f74 696e 672c 2074 6865 204c 696e 7578 oting, the Linux │ │ │ │ -0000fa50: 206b 6572 6e65 6c20 7769 6c6c 2064 656c kernel will del │ │ │ │ -0000fa60: 6567 6174 6520 7468 6520 7461 736b 206f egate the task o │ │ │ │ -0000fa70: 6620 6d6f 756e 7469 6e67 2074 6865 0a72 f mounting the.r │ │ │ │ -0000fa80: 6f6f 7420 6669 6c65 7379 7374 656d 2074 oot filesystem t │ │ │ │ -0000fa90: 6f20 7468 6520 696e 6974 7264 2e20 204d o the initrd. M │ │ │ │ -0000faa0: 6f73 7420 696e 6974 7264 2069 6d61 6765 ost initrd image │ │ │ │ -0000fab0: 7320 6465 7465 726d 696e 6520 7468 6520 s determine the │ │ │ │ -0000fac0: 726f 6f74 0a66 696c 6520 7379 7374 656d root.file system │ │ │ │ -0000fad0: 2062 7920 6368 6563 6b69 6e67 2074 6865 by checking the │ │ │ │ -0000fae0: 204c 696e 7578 206b 6572 6e65 6c27 7320 Linux kernel's │ │ │ │ -0000faf0: 636f 6d6d 616e 642d 6c69 6e65 2066 6f72 command-line for │ │ │ │ -0000fb00: 2074 6865 2027 726f 6f74 270a 6b65 7920 the 'root'.key │ │ │ │ -0000fb10: 616e 6420 7573 6520 6974 7320 7661 6c75 and use its valu │ │ │ │ -0000fb20: 6520 6173 2074 6865 2069 6465 6e74 6966 e as the identif │ │ │ │ -0000fb30: 6963 6174 696f 6e20 6d65 7468 6f64 206f ication method o │ │ │ │ -0000fb40: 6620 7468 6520 726f 6f74 2066 696c 650a f the root file. │ │ │ │ -0000fb50: 7379 7374 656d 2e20 2054 6f20 696d 7072 system. To impr │ │ │ │ -0000fb60: 6f76 6520 7468 6520 7265 6c69 6162 696c ove the reliabil │ │ │ │ -0000fb70: 6974 7920 6f66 2062 6f6f 7469 6e67 2c20 ity of booting, │ │ │ │ -0000fb80: 6d6f 7374 2069 6e69 7472 6420 696d 6167 most initrd imag │ │ │ │ -0000fb90: 6573 2061 6c73 6f0a 616c 6c6f 7720 7468 es also.allow th │ │ │ │ -0000fba0: 6520 726f 6f74 2066 696c 6520 7379 7374 e root file syst │ │ │ │ -0000fbb0: 656d 2074 6f20 6265 2069 6465 6e74 6966 em to be identif │ │ │ │ -0000fbc0: 6965 6420 6279 2069 7473 2055 5549 442e ied by its UUID. │ │ │ │ -0000fbd0: 2042 6563 6175 7365 206f 6620 7468 6973 Because of this │ │ │ │ -0000fbe0: 0a62 6568 6176 696f 722c 2074 6865 2027 .behavior, the ' │ │ │ │ -0000fbf0: 6772 7562 2d6d 6b63 6f6e 6669 6727 2063 grub-mkconfig' c │ │ │ │ -0000fc00: 6f6d 6d61 6e64 2077 696c 6c20 7365 7420 ommand will set │ │ │ │ -0000fc10: 2772 6f6f 7427 2074 6f20 2772 6f6f 743d 'root' to 'root= │ │ │ │ -0000fc20: 5555 4944 3d2e 2e2e 270a 746f 2070 726f UUID=...'.to pro │ │ │ │ -0000fc30: 7669 6465 2074 6865 2069 6e69 7472 6420 vide the initrd │ │ │ │ -0000fc40: 7769 7468 2074 6865 2066 696c 6573 7973 with the filesys │ │ │ │ -0000fc50: 7465 6d20 5555 4944 206f 6620 7468 6520 tem UUID of the │ │ │ │ -0000fc60: 726f 6f74 2066 696c 6520 7379 7374 656d root file system │ │ │ │ -0000fc70: 2e0a 0a20 2020 4966 206e 6f20 696e 6974 ... If no init │ │ │ │ -0000fc80: 7264 2069 7320 6465 7465 6374 6564 206f rd is detected o │ │ │ │ -0000fc90: 7220 2747 5255 425f 4449 5341 424c 455f r 'GRUB_DISABLE_ │ │ │ │ -0000fca0: 4c49 4e55 585f 5555 4944 2720 6973 2073 LINUX_UUID' is s │ │ │ │ -0000fcb0: 6574 2074 6f0a 2774 7275 6527 2074 6865 et to.'true' the │ │ │ │ -0000fcc0: 6e20 2767 7275 622d 636f 6d6d 616e 6427 n 'grub-command' │ │ │ │ -0000fcd0: 2077 696c 6c20 6964 656e 7469 6679 2074 will identify t │ │ │ │ -0000fce0: 6865 2072 6f6f 7420 6669 6c65 7379 7374 he root filesyst │ │ │ │ -0000fcf0: 656d 2062 7920 7365 7474 696e 670a 7468 em by setting.th │ │ │ │ -0000fd00: 6520 6b65 726e 656c 2063 6f6d 6d61 6e64 e kernel command │ │ │ │ -0000fd10: 2d6c 696e 6520 7661 7269 6162 6c65 2027 -line variable ' │ │ │ │ -0000fd20: 726f 6f74 2720 746f 2027 726f 6f74 3d50 root' to 'root=P │ │ │ │ -0000fd30: 4152 5455 5549 443d 2e2e 2e27 2075 6e6c ARTUUID=...' unl │ │ │ │ -0000fd40: 6573 730a 2747 5255 425f 4449 5341 424c ess.'GRUB_DISABL │ │ │ │ -0000fd50: 455f 4c49 4e55 585f 5041 5254 5555 4944 E_LINUX_PARTUUID │ │ │ │ -0000fd60: 2720 6973 2061 6c73 6f20 7365 7420 746f ' is also set to │ │ │ │ -0000fd70: 2027 7472 7565 272e 2020 4966 0a27 4752 'true'. If.'GR │ │ │ │ -0000fd80: 5542 5f44 4953 4142 4c45 5f4c 494e 5558 UB_DISABLE_LINUX │ │ │ │ -0000fd90: 5f50 4152 5455 5549 4427 2069 7320 616c _PARTUUID' is al │ │ │ │ -0000fda0: 736f 2073 6574 2074 6f20 2774 7275 6527 so set to 'true' │ │ │ │ -0000fdb0: 2c20 2767 7275 622d 636f 6d6d 616e 6427 , 'grub-command' │ │ │ │ -0000fdc0: 2077 696c 6c0a 6964 656e 7469 6679 2062 will.identify b │ │ │ │ -0000fdd0: 7920 6974 7320 4c69 6e75 7820 6465 7669 y its Linux devi │ │ │ │ -0000fde0: 6365 206e 616d 652e 0a0a 2020 2054 6865 ce name... The │ │ │ │ -0000fdf0: 2066 6f6c 6c6f 7769 6e67 2074 6162 6c65 following table │ │ │ │ -0000fe00: 2073 756d 6d61 7269 7a65 7320 7468 6520 summarizes the │ │ │ │ -0000fe10: 6265 6861 7669 6f72 206f 6620 7468 6520 behavior of the │ │ │ │ -0000fe20: 2767 7275 622d 6d6b 636f 6e66 6967 270a 'grub-mkconfig'. │ │ │ │ -0000fe30: 636f 6d6d 616e 642e 0a0a 496e 6974 7264 command...Initrd │ │ │ │ -0000fe40: 2020 2020 2047 5255 425f 4449 5341 424c GRUB_DISABL │ │ │ │ -0000fe50: 455f 4c49 4e55 585f 5041 5254 5555 4944 E_LINUX_PARTUUID │ │ │ │ -0000fe60: 2020 2047 5255 425f 4449 5341 424c 455f GRUB_DISABLE_ │ │ │ │ -0000fe70: 4c49 4e55 585f 5555 4944 2020 204c 696e LINUX_UUID Lin │ │ │ │ -0000fe80: 7578 2052 6f6f 740a 6465 7465 6374 6564 ux Root.detected │ │ │ │ -0000fe90: 2020 2053 6574 2054 6f20 2020 2020 2020 Set To │ │ │ │ +0000f710: 3d3d 3d3d 3d3d 3d3d 0a0a 4966 2074 6865 ========..If the │ │ │ │ +0000f720: 2074 6172 6765 7420 6f70 6572 6174 696e target operatin │ │ │ │ +0000f730: 6720 7379 7374 656d 2075 7365 7320 7468 g system uses th │ │ │ │ +0000f740: 6520 4c69 6e75 7820 6b65 726e 656c 2c20 e Linux kernel, │ │ │ │ +0000f750: 2767 7275 622d 6d6b 636f 6e66 6967 270a 'grub-mkconfig'. │ │ │ │ +0000f760: 6174 7465 6d70 7473 2074 6f20 6964 656e attempts to iden │ │ │ │ +0000f770: 7469 6679 2074 6865 2072 6f6f 7420 6669 tify the root fi │ │ │ │ +0000f780: 6c65 2073 7973 7465 6d20 7669 6120 6120 le system via a │ │ │ │ +0000f790: 6865 7572 6973 7469 6320 616c 676f 6972 heuristic algoir │ │ │ │ +0000f7a0: 7468 6d2e 0a54 6869 7320 616c 676f 7269 thm..This algori │ │ │ │ +0000f7b0: 7468 6d20 7365 6c65 6374 7320 7468 6520 thm selects the │ │ │ │ +0000f7c0: 6964 656e 7469 6669 6361 7469 6f6e 206d identification m │ │ │ │ +0000f7d0: 6574 686f 6420 6f66 2074 6865 2072 6f6f ethod of the roo │ │ │ │ +0000f7e0: 7420 6669 6c65 2073 7973 7465 6d0a 6279 t file system.by │ │ │ │ +0000f7f0: 2063 6f6e 7369 6465 7269 6e67 2074 6872 considering thr │ │ │ │ +0000f800: 6565 2066 6163 746f 7273 2e20 2054 6865 ee factors. The │ │ │ │ +0000f810: 2066 6972 7374 2069 7320 6966 2061 6e20 first is if an │ │ │ │ +0000f820: 696e 6974 7264 2066 6f72 2074 6865 2074 initrd for the t │ │ │ │ +0000f830: 6172 6765 740a 6f70 6572 6174 696e 6720 arget.operating │ │ │ │ +0000f840: 7379 7374 656d 2069 7320 616c 736f 2070 system is also p │ │ │ │ +0000f850: 7265 7365 6e74 2e20 2054 6865 2073 6563 resent. The sec │ │ │ │ +0000f860: 6f6e 6420 6973 0a27 4752 5542 5f44 4953 ond is.'GRUB_DIS │ │ │ │ +0000f870: 4142 4c45 5f4c 494e 5558 5f55 5549 4427 ABLE_LINUX_UUID' │ │ │ │ +0000f880: 2061 6e64 2069 6620 7365 7420 746f 2027 and if set to ' │ │ │ │ +0000f890: 7472 7565 272c 2070 7265 7665 6e74 7320 true', prevents │ │ │ │ +0000f8a0: 2767 7275 622d 6d6b 636f 6e66 6967 270a 'grub-mkconfig'. │ │ │ │ +0000f8b0: 6672 6f6d 2069 6465 6e74 6966 7969 6e67 from identifying │ │ │ │ +0000f8c0: 2074 6865 2072 6f6f 7420 6669 6c65 2073 the root file s │ │ │ │ +0000f8d0: 7973 7465 6d20 6279 2069 7473 2055 5549 ystem by its UUI │ │ │ │ +0000f8e0: 442e 2054 6865 2074 6869 7264 2069 730a D. The third is. │ │ │ │ +0000f8f0: 2747 5255 425f 4449 5341 424c 455f 4c49 'GRUB_DISABLE_LI │ │ │ │ +0000f900: 4e55 585f 5041 5254 5555 4944 2720 616e NUX_PARTUUID' an │ │ │ │ +0000f910: 6420 6966 2073 6574 2074 6f20 2774 7275 d if set to 'tru │ │ │ │ +0000f920: 6527 2c20 7072 6576 656e 7473 0a27 6772 e', prevents.'gr │ │ │ │ +0000f930: 7562 2d6d 6b63 6f6e 6669 6727 2066 726f ub-mkconfig' fro │ │ │ │ +0000f940: 6d20 6964 656e 7469 6679 696e 6720 7468 m identifying th │ │ │ │ +0000f950: 6520 726f 6f74 2066 696c 6520 7379 7374 e root file syst │ │ │ │ +0000f960: 656d 2076 6961 2074 6865 2055 5549 4420 em via the UUID │ │ │ │ +0000f970: 6f66 0a69 7473 2065 6e63 6c6f 7369 6e67 of.its enclosing │ │ │ │ +0000f980: 2070 6172 7469 7469 6f6e 2e20 2049 6620 partition. If │ │ │ │ +0000f990: 7468 6520 7661 7269 6162 6c65 7320 6172 the variables ar │ │ │ │ +0000f9a0: 6520 6173 7369 676e 6564 2061 6e79 206f e assigned any o │ │ │ │ +0000f9b0: 7468 6572 2076 616c 7565 2c0a 7468 6174 ther value,.that │ │ │ │ +0000f9c0: 2076 616c 7565 2069 7320 636f 6e73 6964 value is consid │ │ │ │ +0000f9d0: 6572 6564 2065 7175 6976 616c 656e 7420 ered equivalent │ │ │ │ +0000f9e0: 746f 2027 6661 6c73 6527 2e20 2054 6865 to 'false'. The │ │ │ │ +0000f9f0: 2076 6172 6961 626c 6573 2061 7265 2061 variables are a │ │ │ │ +0000fa00: 6c73 6f0a 636f 6e73 6964 6572 6564 2074 lso.considered t │ │ │ │ +0000fa10: 6f20 6265 2073 6574 2074 6f20 2766 616c o be set to 'fal │ │ │ │ +0000fa20: 7365 2720 6966 2074 6865 7920 6172 6520 se' if they are │ │ │ │ +0000fa30: 6e6f 7420 7365 742e 0a0a 2020 2057 6865 not set... Whe │ │ │ │ +0000fa40: 6e20 626f 6f74 696e 672c 2074 6865 204c n booting, the L │ │ │ │ +0000fa50: 696e 7578 206b 6572 6e65 6c20 7769 6c6c inux kernel will │ │ │ │ +0000fa60: 2064 656c 6567 6174 6520 7468 6520 7461 delegate the ta │ │ │ │ +0000fa70: 736b 206f 6620 6d6f 756e 7469 6e67 2074 sk of mounting t │ │ │ │ +0000fa80: 6865 0a72 6f6f 7420 6669 6c65 7379 7374 he.root filesyst │ │ │ │ +0000fa90: 656d 2074 6f20 7468 6520 696e 6974 7264 em to the initrd │ │ │ │ +0000faa0: 2e20 204d 6f73 7420 696e 6974 7264 2069 . Most initrd i │ │ │ │ +0000fab0: 6d61 6765 7320 6465 7465 726d 696e 6520 mages determine │ │ │ │ +0000fac0: 7468 6520 726f 6f74 0a66 696c 6520 7379 the root.file sy │ │ │ │ +0000fad0: 7374 656d 2062 7920 6368 6563 6b69 6e67 stem by checking │ │ │ │ +0000fae0: 2074 6865 204c 696e 7578 206b 6572 6e65 the Linux kerne │ │ │ │ +0000faf0: 6c27 7320 636f 6d6d 616e 642d 6c69 6e65 l's command-line │ │ │ │ +0000fb00: 2066 6f72 2074 6865 2027 726f 6f74 270a for the 'root'. │ │ │ │ +0000fb10: 6b65 7920 616e 6420 7573 6520 6974 7320 key and use its │ │ │ │ +0000fb20: 7661 6c75 6520 6173 2074 6865 2069 6465 value as the ide │ │ │ │ +0000fb30: 6e74 6966 6963 6174 696f 6e20 6d65 7468 ntification meth │ │ │ │ +0000fb40: 6f64 206f 6620 7468 6520 726f 6f74 2066 od of the root f │ │ │ │ +0000fb50: 696c 650a 7379 7374 656d 2e20 2054 6f20 ile.system. To │ │ │ │ +0000fb60: 696d 7072 6f76 6520 7468 6520 7265 6c69 improve the reli │ │ │ │ +0000fb70: 6162 696c 6974 7920 6f66 2062 6f6f 7469 ability of booti │ │ │ │ +0000fb80: 6e67 2c20 6d6f 7374 2069 6e69 7472 6420 ng, most initrd │ │ │ │ +0000fb90: 696d 6167 6573 2061 6c73 6f0a 616c 6c6f images also.allo │ │ │ │ +0000fba0: 7720 7468 6520 726f 6f74 2066 696c 6520 w the root file │ │ │ │ +0000fbb0: 7379 7374 656d 2074 6f20 6265 2069 6465 system to be ide │ │ │ │ +0000fbc0: 6e74 6966 6965 6420 6279 2069 7473 2055 ntified by its U │ │ │ │ +0000fbd0: 5549 442e 2042 6563 6175 7365 206f 6620 UID. Because of │ │ │ │ +0000fbe0: 7468 6973 0a62 6568 6176 696f 722c 2074 this.behavior, t │ │ │ │ +0000fbf0: 6865 2027 6772 7562 2d6d 6b63 6f6e 6669 he 'grub-mkconfi │ │ │ │ +0000fc00: 6727 2063 6f6d 6d61 6e64 2077 696c 6c20 g' command will │ │ │ │ +0000fc10: 7365 7420 2772 6f6f 7427 2074 6f20 2772 set 'root' to 'r │ │ │ │ +0000fc20: 6f6f 743d 5555 4944 3d2e 2e2e 270a 746f oot=UUID=...'.to │ │ │ │ +0000fc30: 2070 726f 7669 6465 2074 6865 2069 6e69 provide the ini │ │ │ │ +0000fc40: 7472 6420 7769 7468 2074 6865 2066 696c trd with the fil │ │ │ │ +0000fc50: 6573 7973 7465 6d20 5555 4944 206f 6620 esystem UUID of │ │ │ │ +0000fc60: 7468 6520 726f 6f74 2066 696c 6520 7379 the root file sy │ │ │ │ +0000fc70: 7374 656d 2e0a 0a20 2020 4966 206e 6f20 stem... If no │ │ │ │ +0000fc80: 696e 6974 7264 2069 7320 6465 7465 6374 initrd is detect │ │ │ │ +0000fc90: 6564 206f 7220 2747 5255 425f 4449 5341 ed or 'GRUB_DISA │ │ │ │ +0000fca0: 424c 455f 4c49 4e55 585f 5555 4944 2720 BLE_LINUX_UUID' │ │ │ │ +0000fcb0: 6973 2073 6574 2074 6f0a 2774 7275 6527 is set to.'true' │ │ │ │ +0000fcc0: 2074 6865 6e20 2767 7275 622d 636f 6d6d then 'grub-comm │ │ │ │ +0000fcd0: 616e 6427 2077 696c 6c20 6964 656e 7469 and' will identi │ │ │ │ +0000fce0: 6679 2074 6865 2072 6f6f 7420 6669 6c65 fy the root file │ │ │ │ +0000fcf0: 7379 7374 656d 2062 7920 7365 7474 696e system by settin │ │ │ │ +0000fd00: 670a 7468 6520 6b65 726e 656c 2063 6f6d g.the kernel com │ │ │ │ +0000fd10: 6d61 6e64 2d6c 696e 6520 7661 7269 6162 mand-line variab │ │ │ │ +0000fd20: 6c65 2027 726f 6f74 2720 746f 2027 726f le 'root' to 'ro │ │ │ │ +0000fd30: 6f74 3d50 4152 5455 5549 443d 2e2e 2e27 ot=PARTUUID=...' │ │ │ │ +0000fd40: 2075 6e6c 6573 730a 2747 5255 425f 4449 unless.'GRUB_DI │ │ │ │ +0000fd50: 5341 424c 455f 4c49 4e55 585f 5041 5254 SABLE_LINUX_PART │ │ │ │ +0000fd60: 5555 4944 2720 6973 2061 6c73 6f20 7365 UUID' is also se │ │ │ │ +0000fd70: 7420 746f 2027 7472 7565 272e 2020 4966 t to 'true'. If │ │ │ │ +0000fd80: 0a27 4752 5542 5f44 4953 4142 4c45 5f4c .'GRUB_DISABLE_L │ │ │ │ +0000fd90: 494e 5558 5f50 4152 5455 5549 4427 2069 INUX_PARTUUID' i │ │ │ │ +0000fda0: 7320 616c 736f 2073 6574 2074 6f20 2774 s also set to 't │ │ │ │ +0000fdb0: 7275 6527 2c20 2767 7275 622d 636f 6d6d rue', 'grub-comm │ │ │ │ +0000fdc0: 616e 6427 2077 696c 6c0a 6964 656e 7469 and' will.identi │ │ │ │ +0000fdd0: 6679 2062 7920 6974 7320 4c69 6e75 7820 fy by its Linux │ │ │ │ +0000fde0: 6465 7669 6365 206e 616d 652e 0a0a 2020 device name... │ │ │ │ +0000fdf0: 2054 6865 2066 6f6c 6c6f 7769 6e67 2074 The following t │ │ │ │ +0000fe00: 6162 6c65 2073 756d 6d61 7269 7a65 7320 able summarizes │ │ │ │ +0000fe10: 7468 6520 6265 6861 7669 6f72 206f 6620 the behavior of │ │ │ │ +0000fe20: 7468 6520 2767 7275 622d 6d6b 636f 6e66 the 'grub-mkconf │ │ │ │ +0000fe30: 6967 270a 636f 6d6d 616e 642e 0a0a 496e ig'.command...In │ │ │ │ +0000fe40: 6974 7264 2020 2020 2047 5255 425f 4449 itrd GRUB_DI │ │ │ │ +0000fe50: 5341 424c 455f 4c49 4e55 585f 5041 5254 SABLE_LINUX_PART │ │ │ │ +0000fe60: 5555 4944 2020 2047 5255 425f 4449 5341 UUID GRUB_DISA │ │ │ │ +0000fe70: 424c 455f 4c49 4e55 585f 5555 4944 2020 BLE_LINUX_UUID │ │ │ │ +0000fe80: 204c 696e 7578 2052 6f6f 740a 6465 7465 Linux Root.dete │ │ │ │ +0000fe90: 6374 6564 2020 2053 6574 2054 6f20 2020 cted Set To │ │ │ │ 0000fea0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -0000feb0: 2053 6574 2054 6f20 2020 2020 2020 2020 Set To │ │ │ │ -0000fec0: 2020 2020 2020 2020 2020 2049 4420 4d65 ID Me │ │ │ │ -0000fed0: 7468 6f64 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d thod.----------- │ │ │ │ +0000feb0: 2020 2020 2053 6574 2054 6f20 2020 2020 Set To │ │ │ │ +0000fec0: 2020 2020 2020 2020 2020 2020 2020 2049 I │ │ │ │ +0000fed0: 4420 4d65 7468 6f64 0a2d 2d2d 2d2d 2d2d D Method.------- │ │ │ │ 0000fee0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ 0000fef0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ 0000ff00: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ 0000ff10: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ -0000ff20: 2d2d 2d2d 2d0a 6661 6c73 6520 2020 2020 -----.false │ │ │ │ -0000ff30: 2066 616c 7365 2020 2020 2020 2020 2020 false │ │ │ │ -0000ff40: 2020 2020 2020 2020 2020 2020 2020 2066 f │ │ │ │ -0000ff50: 616c 7365 2020 2020 2020 2020 2020 2020 alse │ │ │ │ -0000ff60: 2020 2020 2020 2020 2070 6172 7420 5555 part UU │ │ │ │ -0000ff70: 4944 0a66 616c 7365 2020 2020 2020 6661 ID.false fa │ │ │ │ -0000ff80: 6c73 6520 2020 2020 2020 2020 2020 2020 lse │ │ │ │ -0000ff90: 2020 2020 2020 2020 2020 2020 7472 7565 true │ │ │ │ -0000ffa0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -0000ffb0: 2020 2020 2020 7061 7274 2055 5549 440a part UUID. │ │ │ │ -0000ffc0: 6661 6c73 6520 2020 2020 2074 7275 6520 false true │ │ │ │ -0000ffd0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -0000ffe0: 2020 2020 2020 2020 2066 616c 7365 2020 false │ │ │ │ -0000fff0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00010000: 2020 2064 6576 206e 616d 650a 6661 6c73 dev name.fals │ │ │ │ -00010010: 6520 2020 2020 2074 7275 6520 2020 2020 e true │ │ │ │ +0000ff20: 2d2d 2d2d 2d2d 2d2d 2d0a 6661 6c73 6520 ---------.false │ │ │ │ +0000ff30: 2020 2020 2066 616c 7365 2020 2020 2020 false │ │ │ │ +0000ff40: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +0000ff50: 2020 2066 616c 7365 2020 2020 2020 2020 false │ │ │ │ +0000ff60: 2020 2020 2020 2020 2020 2020 2070 6172 par │ │ │ │ +0000ff70: 7420 5555 4944 0a66 616c 7365 2020 2020 t UUID.false │ │ │ │ +0000ff80: 2020 6661 6c73 6520 2020 2020 2020 2020 false │ │ │ │ +0000ff90: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +0000ffa0: 7472 7565 2020 2020 2020 2020 2020 2020 true │ │ │ │ +0000ffb0: 2020 2020 2020 2020 2020 7061 7274 2055 part U │ │ │ │ +0000ffc0: 5549 440a 6661 6c73 6520 2020 2020 2074 UID.false t │ │ │ │ +0000ffd0: 7275 6520 2020 2020 2020 2020 2020 2020 rue │ │ │ │ +0000ffe0: 2020 2020 2020 2020 2020 2020 2066 616c fal │ │ │ │ +0000fff0: 7365 2020 2020 2020 2020 2020 2020 2020 se │ │ │ │ +00010000: 2020 2020 2020 2064 6576 206e 616d 650a dev name. │ │ │ │ +00010010: 6661 6c73 6520 2020 2020 2074 7275 6520 false true │ │ │ │ 00010020: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00010030: 2020 2020 2074 7275 6520 2020 2020 2020 true │ │ │ │ -00010040: 2020 2020 2020 2020 2020 2020 2020 2064 d │ │ │ │ -00010050: 6576 206e 616d 650a 7472 7565 2020 2020 ev name.true │ │ │ │ -00010060: 2020 2066 616c 7365 2020 2020 2020 2020 false │ │ │ │ +00010030: 2020 2020 2020 2020 2074 7275 6520 2020 true │ │ │ │ +00010040: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00010050: 2020 2064 6576 206e 616d 650a 7472 7565 dev name.true │ │ │ │ +00010060: 2020 2020 2020 2066 616c 7365 2020 2020 false │ │ │ │ 00010070: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00010080: 2066 616c 7365 2020 2020 2020 2020 2020 false │ │ │ │ -00010090: 2020 2020 2020 2020 2020 2066 7320 5555 fs UU │ │ │ │ -000100a0: 4944 0a74 7275 6520 2020 2020 2020 6661 ID.true fa │ │ │ │ -000100b0: 6c73 6520 2020 2020 2020 2020 2020 2020 lse │ │ │ │ -000100c0: 2020 2020 2020 2020 2020 2020 7472 7565 true │ │ │ │ -000100d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -000100e0: 2020 2020 2020 7061 7274 2055 5549 440a part UUID. │ │ │ │ -000100f0: 7472 7565 2020 2020 2020 2074 7275 6520 true true │ │ │ │ -00010100: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00010110: 2020 2020 2020 2020 2066 616c 7365 2020 false │ │ │ │ -00010120: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00010130: 2020 2066 7320 5555 4944 0a74 7275 6520 fs UUID.true │ │ │ │ -00010140: 2020 2020 2020 7472 7565 2020 2020 2020 true │ │ │ │ +00010080: 2020 2020 2066 616c 7365 2020 2020 2020 false │ │ │ │ +00010090: 2020 2020 2020 2020 2020 2020 2020 2066 f │ │ │ │ +000100a0: 7320 5555 4944 0a74 7275 6520 2020 2020 s UUID.true │ │ │ │ +000100b0: 2020 6661 6c73 6520 2020 2020 2020 2020 false │ │ │ │ +000100c0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +000100d0: 7472 7565 2020 2020 2020 2020 2020 2020 true │ │ │ │ +000100e0: 2020 2020 2020 2020 2020 7061 7274 2055 part U │ │ │ │ +000100f0: 5549 440a 7472 7565 2020 2020 2020 2074 UID.true t │ │ │ │ +00010100: 7275 6520 2020 2020 2020 2020 2020 2020 rue │ │ │ │ +00010110: 2020 2020 2020 2020 2020 2020 2066 616c fal │ │ │ │ +00010120: 7365 2020 2020 2020 2020 2020 2020 2020 se │ │ │ │ +00010130: 2020 2020 2020 2066 7320 5555 4944 0a74 fs UUID.t │ │ │ │ +00010140: 7275 6520 2020 2020 2020 7472 7565 2020 rue true │ │ │ │ 00010150: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00010160: 2020 2020 7472 7565 2020 2020 2020 2020 true │ │ │ │ -00010170: 2020 2020 2020 2020 2020 2020 2020 6465 de │ │ │ │ -00010180: 7620 6e61 6d65 0a0a 2020 2052 656d 656d v name.. Remem │ │ │ │ -00010190: 6265 722c 2027 4752 5542 5f44 4953 4142 ber, 'GRUB_DISAB │ │ │ │ -000101a0: 4c45 5f4c 494e 5558 5f50 4152 5455 5549 LE_LINUX_PARTUUI │ │ │ │ -000101b0: 4427 2061 6e64 2027 4752 5542 5f44 4953 D' and 'GRUB_DIS │ │ │ │ -000101c0: 4142 4c45 5f4c 494e 5558 5f55 5549 4427 ABLE_LINUX_UUID' │ │ │ │ -000101d0: 0a61 7265 2061 6c73 6f20 636f 6e73 6964 .are also consid │ │ │ │ -000101e0: 6572 6564 2074 6f20 6265 2073 6574 2074 ered to be set t │ │ │ │ -000101f0: 6f20 2766 616c 7365 2720 7768 656e 2074 o 'false' when t │ │ │ │ -00010200: 6865 7920 6172 6520 756e 7365 742e 0a0a hey are unset... │ │ │ │ -00010210: 1f0a 4669 6c65 3a20 6772 7562 2e69 6e66 ..File: grub.inf │ │ │ │ -00010220: 6f2c 2020 4e6f 6465 3a20 5368 656c 6c2d o, Node: Shell- │ │ │ │ -00010230: 6c69 6b65 2073 6372 6970 7469 6e67 2c20 like scripting, │ │ │ │ -00010240: 204e 6578 743a 204d 756c 7469 2d62 6f6f Next: Multi-boo │ │ │ │ -00010250: 7420 6d61 6e75 616c 2063 6f6e 6669 672c t manual config, │ │ │ │ -00010260: 2020 5072 6576 3a20 526f 6f74 2049 6465 Prev: Root Ide │ │ │ │ -00010270: 6e74 6966 6361 7469 6f6e 2048 6575 7269 ntifcation Heuri │ │ │ │ -00010280: 7374 6963 732c 2020 5570 3a20 436f 6e66 stics, Up: Conf │ │ │ │ -00010290: 6967 7572 6174 696f 6e0a 0a36 2e33 2057 iguration..6.3 W │ │ │ │ -000102a0: 7269 7469 6e67 2066 756c 6c20 636f 6e66 riting full conf │ │ │ │ -000102b0: 6967 7572 6174 696f 6e20 6669 6c65 7320 iguration files │ │ │ │ -000102c0: 6469 7265 6374 6c79 0a3d 3d3d 3d3d 3d3d directly.======= │ │ │ │ +00010160: 2020 2020 2020 2020 7472 7565 2020 2020 true │ │ │ │ +00010170: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00010180: 2020 6465 7620 6e61 6d65 0a0a 2020 2052 dev name.. R │ │ │ │ +00010190: 656d 656d 6265 722c 2027 4752 5542 5f44 emember, 'GRUB_D │ │ │ │ +000101a0: 4953 4142 4c45 5f4c 494e 5558 5f50 4152 ISABLE_LINUX_PAR │ │ │ │ +000101b0: 5455 5549 4427 2061 6e64 2027 4752 5542 TUUID' and 'GRUB │ │ │ │ +000101c0: 5f44 4953 4142 4c45 5f4c 494e 5558 5f55 _DISABLE_LINUX_U │ │ │ │ +000101d0: 5549 4427 0a61 7265 2061 6c73 6f20 636f UID'.are also co │ │ │ │ +000101e0: 6e73 6964 6572 6564 2074 6f20 6265 2073 nsidered to be s │ │ │ │ +000101f0: 6574 2074 6f20 2766 616c 7365 2720 7768 et to 'false' wh │ │ │ │ +00010200: 656e 2074 6865 7920 6172 6520 756e 7365 en they are unse │ │ │ │ +00010210: 742e 0a0a 1f0a 4669 6c65 3a20 6772 7562 t.....File: grub │ │ │ │ +00010220: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 5368 .info, Node: Sh │ │ │ │ +00010230: 656c 6c2d 6c69 6b65 2073 6372 6970 7469 ell-like scripti │ │ │ │ +00010240: 6e67 2c20 204e 6578 743a 204d 756c 7469 ng, Next: Multi │ │ │ │ +00010250: 2d62 6f6f 7420 6d61 6e75 616c 2063 6f6e -boot manual con │ │ │ │ +00010260: 6669 672c 2020 5072 6576 3a20 526f 6f74 fig, Prev: Root │ │ │ │ +00010270: 2049 6465 6e74 6966 6361 7469 6f6e 2048 Identifcation H │ │ │ │ +00010280: 6575 7269 7374 6963 732c 2020 5570 3a20 euristics, Up: │ │ │ │ +00010290: 436f 6e66 6967 7572 6174 696f 6e0a 0a36 Configuration..6 │ │ │ │ +000102a0: 2e33 2057 7269 7469 6e67 2066 756c 6c20 .3 Writing full │ │ │ │ +000102b0: 636f 6e66 6967 7572 6174 696f 6e20 6669 configuration fi │ │ │ │ +000102c0: 6c65 7320 6469 7265 6374 6c79 0a3d 3d3d les directly.=== │ │ │ │ 000102d0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ 000102e0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ -000102f0: 3d3d 3d3d 3d3d 0a0a 2767 7275 622e 6366 ======..'grub.cf │ │ │ │ -00010300: 6727 2069 7320 7772 6974 7465 6e20 696e g' is written in │ │ │ │ -00010310: 2047 5255 4227 7320 6275 696c 742d 696e GRUB's built-in │ │ │ │ -00010320: 2073 6372 6970 7469 6e67 206c 616e 6775 scripting langu │ │ │ │ -00010330: 6167 652c 2077 6869 6368 2068 6173 2061 age, which has a │ │ │ │ -00010340: 0a73 796e 7461 7820 7175 6974 6520 7369 .syntax quite si │ │ │ │ -00010350: 6d69 6c61 7220 746f 2074 6861 7420 6f66 milar to that of │ │ │ │ -00010360: 2047 4e55 2042 6173 6820 616e 6420 6f74 GNU Bash and ot │ │ │ │ -00010370: 6865 7220 426f 7572 6e65 2073 6865 6c6c her Bourne shell │ │ │ │ -00010380: 0a64 6572 6976 6174 6976 6573 2e0a 0a57 .derivatives...W │ │ │ │ -00010390: 6f72 6473 0a3d 3d3d 3d3d 0a0a 4120 2277 ords.=====..A "w │ │ │ │ -000103a0: 6f72 6422 2069 7320 6120 7365 7175 656e ord" is a sequen │ │ │ │ -000103b0: 6365 206f 6620 6368 6172 6163 7465 7273 ce of characters │ │ │ │ -000103c0: 2063 6f6e 7369 6465 7265 6420 6173 2061 considered as a │ │ │ │ -000103d0: 2073 696e 676c 6520 756e 6974 2062 790a single unit by. │ │ │ │ -000103e0: 4752 5542 2e20 576f 7264 7320 6172 6520 GRUB. Words are │ │ │ │ -000103f0: 7365 7061 7261 7465 6420 6279 2022 6d65 separated by "me │ │ │ │ -00010400: 7461 6368 6172 6163 7465 7273 222c 2077 tacharacters", w │ │ │ │ -00010410: 6869 6368 2061 7265 2074 6865 2066 6f6c hich are the fol │ │ │ │ -00010420: 6c6f 7769 6e67 0a70 6c75 7320 7370 6163 lowing.plus spac │ │ │ │ -00010430: 652c 2074 6162 2c20 616e 6420 6e65 776c e, tab, and newl │ │ │ │ -00010440: 696e 653a 0a0a 2020 2020 207b 207d 207c ine:.. { } | │ │ │ │ -00010450: 2026 2024 203b 203c 203e 0a0a 2020 2051 & $ ; < >.. Q │ │ │ │ -00010460: 756f 7469 6e67 206d 6179 2062 6520 7573 uoting may be us │ │ │ │ -00010470: 6564 2074 6f20 696e 636c 7564 6520 6d65 ed to include me │ │ │ │ -00010480: 7461 6368 6172 6163 7465 7273 2069 6e20 tacharacters in │ │ │ │ -00010490: 776f 7264 733b 2073 6565 2062 656c 6f77 words; see below │ │ │ │ -000104a0: 2e0a 0a52 6573 6572 7665 6420 776f 7264 ...Reserved word │ │ │ │ -000104b0: 730a 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d s.============== │ │ │ │ -000104c0: 0a0a 5265 7365 7276 6564 2077 6f72 6473 ..Reserved words │ │ │ │ -000104d0: 2068 6176 6520 6120 7370 6563 6961 6c20 have a special │ │ │ │ -000104e0: 6d65 616e 696e 6720 746f 2047 5255 422e meaning to GRUB. │ │ │ │ -000104f0: 2054 6865 2066 6f6c 6c6f 7769 6e67 2077 The following w │ │ │ │ -00010500: 6f72 6473 2061 7265 0a72 6563 6f67 6e69 ords are.recogni │ │ │ │ -00010510: 7365 6420 6173 2072 6573 6572 7665 6420 sed as reserved │ │ │ │ -00010520: 7768 656e 2075 6e71 756f 7465 6420 616e when unquoted an │ │ │ │ -00010530: 6420 6569 7468 6572 2074 6865 2066 6972 d either the fir │ │ │ │ -00010540: 7374 2077 6f72 6420 6f66 2061 0a73 696d st word of a.sim │ │ │ │ -00010550: 706c 6520 636f 6d6d 616e 6420 6f72 2074 ple command or t │ │ │ │ -00010560: 6865 2074 6869 7264 2077 6f72 6420 6f66 he third word of │ │ │ │ -00010570: 2061 2027 666f 7227 2063 6f6d 6d61 6e64 a 'for' command │ │ │ │ -00010580: 3a0a 0a20 2020 2020 2120 5b5b 205d 5d20 :.. ! [[ ]] │ │ │ │ -00010590: 7b20 7d0a 2020 2020 2063 6173 6520 646f { }. case do │ │ │ │ -000105a0: 2064 6f6e 6520 656c 6966 2065 6c73 6520 done elif else │ │ │ │ -000105b0: 6573 6163 2066 6920 666f 7220 6675 6e63 esac fi for func │ │ │ │ -000105c0: 7469 6f6e 0a20 2020 2020 6966 2069 6e20 tion. if in │ │ │ │ -000105d0: 6d65 6e75 656e 7472 7920 7365 6c65 6374 menuentry select │ │ │ │ -000105e0: 2074 6865 6e20 7469 6d65 2075 6e74 696c then time until │ │ │ │ -000105f0: 2077 6869 6c65 0a0a 2020 204e 6f74 2061 while.. Not a │ │ │ │ -00010600: 6c6c 206f 6620 7468 6573 6520 7265 7365 ll of these rese │ │ │ │ -00010610: 7276 6564 2077 6f72 6473 2068 6176 6520 rved words have │ │ │ │ -00010620: 6120 7573 6566 756c 2070 7572 706f 7365 a useful purpose │ │ │ │ -00010630: 2079 6574 3b20 736f 6d65 2061 7265 0a72 yet; some are.r │ │ │ │ -00010640: 6573 6572 7665 6420 666f 7220 6675 7475 eserved for futu │ │ │ │ -00010650: 7265 2065 7870 616e 7369 6f6e 2e0a 0a51 re expansion...Q │ │ │ │ -00010660: 756f 7469 6e67 0a3d 3d3d 3d3d 3d3d 0a0a uoting.=======.. │ │ │ │ -00010670: 5175 6f74 696e 6720 6973 2075 7365 6420 Quoting is used │ │ │ │ -00010680: 746f 2072 656d 6f76 6520 7468 6520 7370 to remove the sp │ │ │ │ -00010690: 6563 6961 6c20 6d65 616e 696e 6720 6f66 ecial meaning of │ │ │ │ -000106a0: 2063 6572 7461 696e 2063 6861 7261 6374 certain charact │ │ │ │ -000106b0: 6572 7320 6f72 0a77 6f72 6473 2e20 2049 ers or.words. I │ │ │ │ -000106c0: 7420 6361 6e20 6265 2075 7365 6420 746f t can be used to │ │ │ │ -000106d0: 2074 7265 6174 206d 6574 6163 6861 7261 treat metachara │ │ │ │ -000106e0: 6374 6572 7320 6173 2070 6172 7420 6f66 cters as part of │ │ │ │ -000106f0: 2061 2077 6f72 642c 2074 6f0a 7072 6576 a word, to.prev │ │ │ │ -00010700: 656e 7420 7265 7365 7276 6564 2077 6f72 ent reserved wor │ │ │ │ -00010710: 6473 2066 726f 6d20 6265 696e 6720 7265 ds from being re │ │ │ │ -00010720: 636f 676e 6973 6564 2061 7320 7375 6368 cognised as such │ │ │ │ -00010730: 2c20 616e 6420 746f 2070 7265 7665 6e74 , and to prevent │ │ │ │ -00010740: 0a76 6172 6961 626c 6520 6578 7061 6e73 .variable expans │ │ │ │ -00010750: 696f 6e2e 0a0a 2020 2054 6865 7265 2061 ion... There a │ │ │ │ -00010760: 7265 2074 6872 6565 2071 756f 7469 6e67 re three quoting │ │ │ │ -00010770: 206d 6563 6861 6e69 736d 733a 2074 6865 mechanisms: the │ │ │ │ -00010780: 2065 7363 6170 6520 6368 6172 6163 7465 escape characte │ │ │ │ -00010790: 722c 2073 696e 676c 650a 7175 6f74 6573 r, single.quotes │ │ │ │ -000107a0: 2c20 616e 6420 646f 7562 6c65 2071 756f , and double quo │ │ │ │ -000107b0: 7465 732e 0a0a 2020 2041 206e 6f6e 2d71 tes... A non-q │ │ │ │ -000107c0: 756f 7465 6420 6261 636b 736c 6173 6820 uoted backslash │ │ │ │ -000107d0: 285c 2920 6973 2074 6865 2022 6573 6361 (\) is the "esca │ │ │ │ -000107e0: 7065 2063 6861 7261 6374 6572 222e 2020 pe character". │ │ │ │ -000107f0: 4974 2070 7265 7365 7276 6573 0a74 6865 It preserves.the │ │ │ │ -00010800: 206c 6974 6572 616c 2076 616c 7565 206f literal value o │ │ │ │ -00010810: 6620 7468 6520 6e65 7874 2063 6861 7261 f the next chara │ │ │ │ -00010820: 6374 6572 2074 6861 7420 666f 6c6c 6f77 cter that follow │ │ │ │ -00010830: 732c 2077 6974 6820 7468 6520 6578 6365 s, with the exce │ │ │ │ -00010840: 7074 696f 6e0a 6f66 206e 6577 6c69 6e65 ption.of newline │ │ │ │ -00010850: 2e0a 0a20 2020 456e 636c 6f73 696e 6720 ... Enclosing │ │ │ │ -00010860: 6368 6172 6163 7465 7273 2069 6e20 7369 characters in si │ │ │ │ -00010870: 6e67 6c65 2071 756f 7465 7320 7072 6573 ngle quotes pres │ │ │ │ -00010880: 6572 7665 7320 7468 6520 6c69 7465 7261 erves the litera │ │ │ │ -00010890: 6c20 7661 6c75 6520 6f66 0a65 6163 6820 l value of.each │ │ │ │ -000108a0: 6368 6172 6163 7465 7220 7769 7468 696e character within │ │ │ │ -000108b0: 2074 6865 2071 756f 7465 732e 2020 4120 the quotes. A │ │ │ │ -000108c0: 7369 6e67 6c65 2071 756f 7465 206d 6179 single quote may │ │ │ │ -000108d0: 206e 6f74 206f 6363 7572 2062 6574 7765 not occur betwe │ │ │ │ -000108e0: 656e 0a73 696e 676c 6520 7175 6f74 6573 en.single quotes │ │ │ │ -000108f0: 2c20 6576 656e 2077 6865 6e20 7072 6563 , even when prec │ │ │ │ -00010900: 6564 6564 2062 7920 6120 6261 636b 736c eded by a backsl │ │ │ │ -00010910: 6173 682e 0a0a 2020 2045 6e63 6c6f 7369 ash... Enclosi │ │ │ │ -00010920: 6e67 2063 6861 7261 6374 6572 7320 696e ng characters in │ │ │ │ -00010930: 2064 6f75 626c 6520 7175 6f74 6573 2070 double quotes p │ │ │ │ -00010940: 7265 7365 7276 6573 2074 6865 206c 6974 reserves the lit │ │ │ │ -00010950: 6572 616c 2076 616c 7565 206f 660a 616c eral value of.al │ │ │ │ -00010960: 6c20 6368 6172 6163 7465 7273 2077 6974 l characters wit │ │ │ │ -00010970: 6869 6e20 7468 6520 7175 6f74 6573 2c20 hin the quotes, │ │ │ │ -00010980: 7769 7468 2074 6865 2065 7863 6570 7469 with the excepti │ │ │ │ -00010990: 6f6e 206f 6620 2724 2720 616e 6420 275c on of '$' and '\ │ │ │ │ -000109a0: 272e 0a54 6865 2027 2427 2063 6861 7261 '..The '$' chara │ │ │ │ -000109b0: 6374 6572 2072 6574 6169 6e73 2069 7473 cter retains its │ │ │ │ -000109c0: 2073 7065 6369 616c 206d 6561 6e69 6e67 special meaning │ │ │ │ -000109d0: 2077 6974 6869 6e20 646f 7562 6c65 2071 within double q │ │ │ │ -000109e0: 756f 7465 732e 2020 5468 650a 6261 636b uotes. The.back │ │ │ │ -000109f0: 736c 6173 6820 7265 7461 696e 7320 6974 slash retains it │ │ │ │ -00010a00: 7320 7370 6563 6961 6c20 6d65 616e 696e s special meanin │ │ │ │ -00010a10: 6720 6f6e 6c79 2077 6865 6e20 666f 6c6c g only when foll │ │ │ │ -00010a20: 6f77 6564 2062 7920 6f6e 6520 6f66 2074 owed by one of t │ │ │ │ -00010a30: 6865 0a66 6f6c 6c6f 7769 6e67 2063 6861 he.following cha │ │ │ │ -00010a40: 7261 6374 6572 733a 2027 2427 2c20 2722 racters: '$', '" │ │ │ │ -00010a50: 272c 2027 5c27 2c20 6f72 206e 6577 6c69 ', '\', or newli │ │ │ │ -00010a60: 6e65 2e20 2041 2062 6163 6b73 6c61 7368 ne. A backslash │ │ │ │ -00010a70: 2d6e 6577 6c69 6e65 0a70 6169 7220 6973 -newline.pair is │ │ │ │ -00010a80: 2074 7265 6174 6564 2061 7320 6120 6c69 treated as a li │ │ │ │ -00010a90: 6e65 2063 6f6e 7469 6e75 6174 696f 6e20 ne continuation │ │ │ │ -00010aa0: 2874 6861 7420 6973 2c20 6974 2069 7320 (that is, it is │ │ │ │ -00010ab0: 7265 6d6f 7665 6420 6672 6f6d 2074 6865 removed from the │ │ │ │ -00010ac0: 0a69 6e70 7574 2073 7472 6561 6d20 616e .input stream an │ │ │ │ -00010ad0: 6420 6566 6665 6374 6976 656c 7920 6967 d effectively ig │ │ │ │ -00010ae0: 6e6f 7265 6428 3129 2028 2a6e 6f74 6520 nored(1) (*note │ │ │ │ -00010af0: 5368 656c 6c2d 6c69 6b65 0a73 6372 6970 Shell-like.scrip │ │ │ │ -00010b00: 7469 6e67 2d46 6f6f 746e 6f74 652d 313a ting-Footnote-1: │ │ │ │ -00010b10: 3a29 292e 2020 4120 646f 7562 6c65 2071 :)). A double q │ │ │ │ -00010b20: 756f 7465 206d 6179 2062 6520 7175 6f74 uote may be quot │ │ │ │ -00010b30: 6564 2077 6974 6869 6e20 646f 7562 6c65 ed within double │ │ │ │ -00010b40: 0a71 756f 7465 7320 6279 2070 7265 6365 .quotes by prece │ │ │ │ -00010b50: 6469 6e67 2069 7420 7769 7468 2061 2062 ding it with a b │ │ │ │ -00010b60: 6163 6b73 6c61 7368 2e0a 0a56 6172 6961 ackslash...Varia │ │ │ │ -00010b70: 626c 6520 6578 7061 6e73 696f 6e0a 3d3d ble expansion.== │ │ │ │ -00010b80: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ -00010b90: 0a0a 5468 6520 2724 2720 6368 6172 6163 ..The '$' charac │ │ │ │ -00010ba0: 7465 7220 696e 7472 6f64 7563 6573 2076 ter introduces v │ │ │ │ -00010bb0: 6172 6961 626c 6520 6578 7061 6e73 696f ariable expansio │ │ │ │ -00010bc0: 6e2e 2020 5468 6520 7661 7269 6162 6c65 n. The variable │ │ │ │ -00010bd0: 206e 616d 6520 746f 0a62 6520 6578 7061 name to.be expa │ │ │ │ -00010be0: 6e64 6564 206d 6179 2062 6520 656e 636c nded may be encl │ │ │ │ -00010bf0: 6f73 6564 2069 6e20 6272 6163 6573 2c20 osed in braces, │ │ │ │ -00010c00: 7768 6963 6820 6172 6520 6f70 7469 6f6e which are option │ │ │ │ -00010c10: 616c 2062 7574 2073 6572 7665 2074 6f0a al but serve to. │ │ │ │ -00010c20: 7072 6f74 6563 7420 7468 6520 7661 7269 protect the vari │ │ │ │ -00010c30: 6162 6c65 2074 6f20 6265 2065 7870 616e able to be expan │ │ │ │ -00010c40: 6465 6420 6672 6f6d 2063 6861 7261 6374 ded from charact │ │ │ │ -00010c50: 6572 7320 696d 6d65 6469 6174 656c 790a ers immediately. │ │ │ │ -00010c60: 666f 6c6c 6f77 696e 6720 6974 2077 6869 following it whi │ │ │ │ -00010c70: 6368 2063 6f75 6c64 2062 6520 696e 7465 ch could be inte │ │ │ │ -00010c80: 7270 7265 7465 6420 6173 2070 6172 7420 rpreted as part │ │ │ │ -00010c90: 6f66 2074 6865 206e 616d 652e 0a0a 2020 of the name... │ │ │ │ -00010ca0: 204e 6f72 6d61 6c20 7661 7269 6162 6c65 Normal variable │ │ │ │ -00010cb0: 206e 616d 6573 2062 6567 696e 2077 6974 names begin wit │ │ │ │ -00010cc0: 6820 616e 2061 6c70 6861 6265 7469 6320 h an alphabetic │ │ │ │ -00010cd0: 6368 6172 6163 7465 722c 2066 6f6c 6c6f character, follo │ │ │ │ -00010ce0: 7765 6420 6279 0a7a 6572 6f20 6f72 206d wed by.zero or m │ │ │ │ -00010cf0: 6f72 6520 616c 7068 616e 756d 6572 6963 ore alphanumeric │ │ │ │ -00010d00: 2063 6861 7261 6374 6572 732e 2020 5468 characters. Th │ │ │ │ -00010d10: 6573 6520 6e61 6d65 7320 7265 6665 7220 ese names refer │ │ │ │ -00010d20: 746f 2065 6e74 7269 6573 2069 6e0a 7468 to entries in.th │ │ │ │ -00010d30: 6520 4752 5542 2065 6e76 6972 6f6e 6d65 e GRUB environme │ │ │ │ -00010d40: 6e74 2028 2a6e 6f74 6520 456e 7669 726f nt (*note Enviro │ │ │ │ -00010d50: 6e6d 656e 743a 3a29 2e0a 0a20 2020 506f nment::)... Po │ │ │ │ -00010d60: 7369 7469 6f6e 616c 2076 6172 6961 626c sitional variabl │ │ │ │ -00010d70: 6520 6e61 6d65 7320 636f 6e73 6973 7420 e names consist │ │ │ │ -00010d80: 6f66 206f 6e65 206f 7220 6d6f 7265 2064 of one or more d │ │ │ │ -00010d90: 6967 6974 732e 2020 5468 6579 0a72 6570 igits. They.rep │ │ │ │ -00010da0: 7265 7365 6e74 2070 6172 616d 6574 6572 resent parameter │ │ │ │ -00010db0: 7320 7061 7373 6564 2074 6f20 6675 6e63 s passed to func │ │ │ │ -00010dc0: 7469 6f6e 2063 616c 6c73 2c20 7769 7468 tion calls, with │ │ │ │ -00010dd0: 2027 2431 2720 7265 7072 6573 656e 7469 '$1' representi │ │ │ │ -00010de0: 6e67 0a74 6865 2066 6972 7374 2070 6172 ng.the first par │ │ │ │ -00010df0: 616d 6574 6572 2c20 616e 6420 736f 206f ameter, and so o │ │ │ │ -00010e00: 6e2e 0a0a 2020 2054 6865 2073 7065 6369 n... The speci │ │ │ │ -00010e10: 616c 2076 6172 6961 626c 6520 6e61 6d65 al variable name │ │ │ │ -00010e20: 2027 3f27 2065 7870 616e 6473 2074 6f20 '?' expands to │ │ │ │ -00010e30: 7468 6520 6578 6974 2073 7461 7475 7320 the exit status │ │ │ │ -00010e40: 6f66 2074 6865 206d 6f73 740a 7265 6365 of the most.rece │ │ │ │ -00010e50: 6e74 6c79 2065 7865 6375 7465 6420 636f ntly executed co │ │ │ │ -00010e60: 6d6d 616e 642e 2020 5768 656e 2070 6f73 mmand. When pos │ │ │ │ -00010e70: 6974 696f 6e61 6c20 7661 7269 6162 6c65 itional variable │ │ │ │ -00010e80: 206e 616d 6573 2061 7265 2061 6374 6976 names are activ │ │ │ │ -00010e90: 652c 0a6f 7468 6572 2073 7065 6369 616c e,.other special │ │ │ │ -00010ea0: 2076 6172 6961 626c 6520 6e61 6d65 7320 variable names │ │ │ │ -00010eb0: 2740 272c 2027 2a27 2061 6e64 2027 2327 '@', '*' and '#' │ │ │ │ -00010ec0: 2061 7265 2064 6566 696e 6564 2061 6e64 are defined and │ │ │ │ -00010ed0: 2074 6865 790a 6578 7061 6e64 2074 6f20 they.expand to │ │ │ │ -00010ee0: 616c 6c20 706f 7369 7469 6f6e 616c 2070 all positional p │ │ │ │ -00010ef0: 6172 616d 6574 6572 7320 7769 7468 206e arameters with n │ │ │ │ -00010f00: 6563 6573 7361 7279 2071 756f 7469 6e67 ecessary quoting │ │ │ │ -00010f10: 2c20 706f 7369 7469 6f6e 616c 0a70 6172 , positional.par │ │ │ │ -00010f20: 616d 6574 6572 7320 7769 7468 6f75 7420 ameters without │ │ │ │ -00010f30: 616e 7920 7175 6f74 696e 672c 2061 6e64 any quoting, and │ │ │ │ -00010f40: 2070 6f73 6974 696f 6e61 6c20 7061 7261 positional para │ │ │ │ -00010f50: 6d65 7465 7220 636f 756e 740a 7265 7370 meter count.resp │ │ │ │ -00010f60: 6563 7469 7665 6c79 2e0a 0a43 6f6d 6d65 ectively...Comme │ │ │ │ -00010f70: 6e74 730a 3d3d 3d3d 3d3d 3d3d 0a0a 4120 nts.========..A │ │ │ │ -00010f80: 776f 7264 2062 6567 696e 6e69 6e67 2077 word beginning w │ │ │ │ -00010f90: 6974 6820 2723 2720 6361 7573 6573 2074 ith '#' causes t │ │ │ │ -00010fa0: 6861 7420 776f 7264 2061 6e64 2061 6c6c hat word and all │ │ │ │ -00010fb0: 2072 656d 6169 6e69 6e67 2063 6861 7261 remaining chara │ │ │ │ -00010fc0: 6374 6572 730a 6f6e 2074 6861 7420 6c69 cters.on that li │ │ │ │ -00010fd0: 6e65 2074 6f20 6265 2069 676e 6f72 6564 ne to be ignored │ │ │ │ -00010fe0: 2e0a 0a53 696d 706c 6520 636f 6d6d 616e ...Simple comman │ │ │ │ -00010ff0: 6473 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ds.============= │ │ │ │ -00011000: 3d3d 0a0a 4120 2273 696d 706c 6520 636f ==..A "simple co │ │ │ │ -00011010: 6d6d 616e 6422 2069 7320 6120 7365 7175 mmand" is a sequ │ │ │ │ -00011020: 656e 6365 206f 6620 776f 7264 7320 7365 ence of words se │ │ │ │ -00011030: 7061 7261 7465 6420 6279 2073 7061 6365 parated by space │ │ │ │ -00011040: 7320 6f72 2074 6162 730a 616e 6420 7465 s or tabs.and te │ │ │ │ -00011050: 726d 696e 6174 6564 2062 7920 6120 7365 rminated by a se │ │ │ │ -00011060: 6d69 636f 6c6f 6e20 6f72 2061 206e 6577 micolon or a new │ │ │ │ -00011070: 6c69 6e65 2e20 2054 6865 2066 6972 7374 line. The first │ │ │ │ -00011080: 2077 6f72 6420 7370 6563 6966 6965 730a word specifies. │ │ │ │ -00011090: 7468 6520 636f 6d6d 616e 6420 746f 2062 the command to b │ │ │ │ -000110a0: 6520 6578 6563 7574 6564 2e20 2054 6865 e executed. The │ │ │ │ -000110b0: 2072 656d 6169 6e69 6e67 2077 6f72 6473 remaining words │ │ │ │ -000110c0: 2061 7265 2070 6173 7365 6420 6173 2061 are passed as a │ │ │ │ -000110d0: 7267 756d 656e 7473 0a74 6f20 7468 6520 rguments.to the │ │ │ │ -000110e0: 696e 766f 6b65 6420 636f 6d6d 616e 642e invoked command. │ │ │ │ -000110f0: 0a0a 2020 2054 6865 2072 6574 7572 6e20 .. The return │ │ │ │ -00011100: 7661 6c75 6520 6f66 2061 2073 696d 706c value of a simpl │ │ │ │ -00011110: 6520 636f 6d6d 616e 6420 6973 2069 7473 e command is its │ │ │ │ -00011120: 2065 7869 7420 7374 6174 7573 2e20 2049 exit status. I │ │ │ │ -00011130: 6620 7468 650a 7265 7365 7276 6564 2077 f the.reserved w │ │ │ │ -00011140: 6f72 6420 2721 2720 7072 6563 6564 6573 ord '!' precedes │ │ │ │ -00011150: 2074 6865 2063 6f6d 6d61 6e64 2c20 7468 the command, th │ │ │ │ -00011160: 656e 2074 6865 2072 6574 7572 6e20 7661 en the return va │ │ │ │ -00011170: 6c75 6520 6973 2069 6e73 7465 6164 0a74 lue is instead.t │ │ │ │ -00011180: 6865 206c 6f67 6963 616c 206e 6567 6174 he logical negat │ │ │ │ -00011190: 696f 6e20 6f66 2074 6865 2063 6f6d 6d61 ion of the comma │ │ │ │ -000111a0: 6e64 2773 2065 7869 7420 7374 6174 7573 nd's exit status │ │ │ │ -000111b0: 2e0a 0a43 6f6d 706f 756e 6420 636f 6d6d ...Compound comm │ │ │ │ -000111c0: 616e 6473 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d ands.=========== │ │ │ │ -000111d0: 3d3d 3d3d 3d3d 0a0a 4120 2263 6f6d 706f ======..A "compo │ │ │ │ -000111e0: 756e 6420 636f 6d6d 616e 6422 2069 7320 und command" is │ │ │ │ -000111f0: 6f6e 6520 6f66 2074 6865 2066 6f6c 6c6f one of the follo │ │ │ │ -00011200: 7769 6e67 3a0a 0a66 6f72 204e 414d 4520 wing:..for NAME │ │ │ │ -00011210: 696e 2057 4f52 4420 2e2e 2e3b 2064 6f20 in WORD ...; do │ │ │ │ -00011220: 4c49 5354 3b20 646f 6e65 0a20 2020 2020 LIST; done. │ │ │ │ -00011230: 5468 6520 6c69 7374 206f 6620 776f 7264 The list of word │ │ │ │ -00011240: 7320 666f 6c6c 6f77 696e 6720 2769 6e27 s following 'in' │ │ │ │ -00011250: 2069 7320 6578 7061 6e64 6564 2c20 6765 is expanded, ge │ │ │ │ -00011260: 6e65 7261 7469 6e67 2061 206c 6973 7420 nerating a list │ │ │ │ -00011270: 6f66 0a20 2020 2020 6974 656d 732e 2020 of. items. │ │ │ │ -00011280: 5468 6520 7661 7269 6162 6c65 204e 414d The variable NAM │ │ │ │ -00011290: 4520 6973 2073 6574 2074 6f20 6561 6368 E is set to each │ │ │ │ -000112a0: 2065 6c65 6d65 6e74 206f 6620 7468 6973 element of this │ │ │ │ -000112b0: 206c 6973 7420 696e 0a20 2020 2020 7475 list in. tu │ │ │ │ -000112c0: 726e 2c20 616e 6420 4c49 5354 2069 7320 rn, and LIST is │ │ │ │ -000112d0: 6578 6563 7574 6564 2065 6163 6820 7469 executed each ti │ │ │ │ -000112e0: 6d65 2e20 2054 6865 2072 6574 7572 6e20 me. The return │ │ │ │ -000112f0: 7661 6c75 6520 6973 2074 6865 2065 7869 value is the exi │ │ │ │ -00011300: 740a 2020 2020 2073 7461 7475 7320 6f66 t. status of │ │ │ │ -00011310: 2074 6865 206c 6173 7420 636f 6d6d 616e the last comman │ │ │ │ -00011320: 6420 7468 6174 2065 7865 6375 7465 732e d that executes. │ │ │ │ -00011330: 2020 4966 2074 6865 2065 7870 616e 7369 If the expansi │ │ │ │ -00011340: 6f6e 206f 6620 7468 650a 2020 2020 2069 on of the. i │ │ │ │ -00011350: 7465 6d73 2066 6f6c 6c6f 7769 6e67 2027 tems following ' │ │ │ │ -00011360: 696e 2720 7265 7375 6c74 7320 696e 2061 in' results in a │ │ │ │ -00011370: 6e20 656d 7074 7920 6c69 7374 2c20 6e6f n empty list, no │ │ │ │ -00011380: 2063 6f6d 6d61 6e64 7320 6172 650a 2020 commands are. │ │ │ │ -00011390: 2020 2065 7865 6375 7465 642c 2061 6e64 executed, and │ │ │ │ -000113a0: 2074 6865 2072 6574 7572 6e20 7374 6174 the return stat │ │ │ │ -000113b0: 7573 2069 7320 302e 0a0a 6966 204c 4953 us is 0...if LIS │ │ │ │ -000113c0: 543b 2074 6865 6e20 4c49 5354 3b20 5b65 T; then LIST; [e │ │ │ │ -000113d0: 6c69 6620 4c49 5354 3b20 7468 656e 204c lif LIST; then L │ │ │ │ -000113e0: 4953 543b 5d20 2e2e 2e20 5b65 6c73 6520 IST;] ... [else │ │ │ │ -000113f0: 4c49 5354 3b5d 2066 690a 2020 2020 2054 LIST;] fi. T │ │ │ │ -00011400: 6865 2027 6966 2720 4c49 5354 2069 7320 he 'if' LIST is │ │ │ │ -00011410: 6578 6563 7574 6564 2e20 2049 6620 6974 executed. If it │ │ │ │ -00011420: 7320 6578 6974 2073 7461 7475 7320 6973 s exit status is │ │ │ │ -00011430: 207a 6572 6f2c 2074 6865 2027 7468 656e zero, the 'then │ │ │ │ -00011440: 270a 2020 2020 204c 4953 5420 6973 2065 '. LIST is e │ │ │ │ -00011450: 7865 6375 7465 642e 2020 4f74 6865 7277 xecuted. Otherw │ │ │ │ -00011460: 6973 652c 2065 6163 6820 2765 6c69 6627 ise, each 'elif' │ │ │ │ -00011470: 204c 4953 5420 6973 2065 7865 6375 7465 LIST is execute │ │ │ │ -00011480: 6420 696e 2074 7572 6e2c 0a20 2020 2020 d in turn,. │ │ │ │ -00011490: 616e 6420 6966 2069 7473 2065 7869 7420 and if its exit │ │ │ │ -000114a0: 7374 6174 7573 2069 7320 7a65 726f 2c20 status is zero, │ │ │ │ -000114b0: 7468 6520 636f 7272 6573 706f 6e64 696e the correspondin │ │ │ │ -000114c0: 6720 2774 6865 6e27 204c 4953 5420 6973 g 'then' LIST is │ │ │ │ -000114d0: 0a20 2020 2020 6578 6563 7574 6564 2061 . executed a │ │ │ │ -000114e0: 6e64 2074 6865 2063 6f6d 6d61 6e64 2063 nd the command c │ │ │ │ -000114f0: 6f6d 706c 6574 6573 2e20 204f 7468 6572 ompletes. Other │ │ │ │ -00011500: 7769 7365 2c20 7468 6520 2765 6c73 6527 wise, the 'else' │ │ │ │ -00011510: 204c 4953 5420 6973 0a20 2020 2020 6578 LIST is. ex │ │ │ │ -00011520: 6563 7574 6564 2c20 6966 2070 7265 7365 ecuted, if prese │ │ │ │ -00011530: 6e74 2e20 2054 6865 2065 7869 7420 7374 nt. The exit st │ │ │ │ -00011540: 6174 7573 2069 7320 7468 6520 6578 6974 atus is the exit │ │ │ │ -00011550: 2073 7461 7475 7320 6f66 2074 6865 0a20 status of the. │ │ │ │ -00011560: 2020 2020 6c61 7374 2063 6f6d 6d61 6e64 last command │ │ │ │ -00011570: 2065 7865 6375 7465 642c 206f 7220 7a65 executed, or ze │ │ │ │ -00011580: 726f 2069 6620 6e6f 2063 6f6e 6469 7469 ro if no conditi │ │ │ │ -00011590: 6f6e 2074 6573 7465 6420 7472 7565 2e0a on tested true.. │ │ │ │ -000115a0: 0a77 6869 6c65 2043 4f4e 443b 2064 6f20 .while COND; do │ │ │ │ -000115b0: 4c49 5354 3b20 646f 6e65 0a75 6e74 696c LIST; done.until │ │ │ │ -000115c0: 2043 4f4e 443b 2064 6f20 4c49 5354 3b20 COND; do LIST; │ │ │ │ -000115d0: 646f 6e65 0a20 2020 2020 5468 6520 2777 done. The 'w │ │ │ │ -000115e0: 6869 6c65 2720 636f 6d6d 616e 6420 636f hile' command co │ │ │ │ -000115f0: 6e74 696e 756f 7573 6c79 2065 7865 6375 ntinuously execu │ │ │ │ -00011600: 7465 7320 7468 6520 2764 6f27 204c 4953 tes the 'do' LIS │ │ │ │ -00011610: 5420 6173 206c 6f6e 6720 6173 0a20 2020 T as long as. │ │ │ │ -00011620: 2020 7468 6520 6c61 7374 2063 6f6d 6d61 the last comma │ │ │ │ -00011630: 6e64 2069 6e20 434f 4e44 2072 6574 7572 nd in COND retur │ │ │ │ -00011640: 6e73 2061 6e20 6578 6974 2073 7461 7475 ns an exit statu │ │ │ │ -00011650: 7320 6f66 207a 6572 6f2e 2020 5468 650a s of zero. The. │ │ │ │ -00011660: 2020 2020 2027 756e 7469 6c27 2063 6f6d 'until' com │ │ │ │ -00011670: 6d61 6e64 2069 7320 6964 656e 7469 6361 mand is identica │ │ │ │ -00011680: 6c20 746f 2074 6865 2027 7768 696c 6527 l to the 'while' │ │ │ │ -00011690: 2063 6f6d 6d61 6e64 2c20 6578 6365 7074 command, except │ │ │ │ -000116a0: 2074 6861 740a 2020 2020 2074 6865 2074 that. the t │ │ │ │ -000116b0: 6573 7420 6973 206e 6567 6174 6564 3b20 est is negated; │ │ │ │ -000116c0: 7468 6520 2764 6f27 204c 4953 5420 6973 the 'do' LIST is │ │ │ │ -000116d0: 2065 7865 6375 7465 6420 6173 206c 6f6e executed as lon │ │ │ │ -000116e0: 6720 6173 2074 6865 206c 6173 740a 2020 g as the last. │ │ │ │ -000116f0: 2020 2063 6f6d 6d61 6e64 2069 6e20 434f command in CO │ │ │ │ -00011700: 4e44 2072 6574 7572 6e73 2061 206e 6f6e ND returns a non │ │ │ │ -00011710: 2d7a 6572 6f20 6578 6974 2073 7461 7475 -zero exit statu │ │ │ │ -00011720: 732e 2020 5468 6520 6578 6974 2073 7461 s. The exit sta │ │ │ │ -00011730: 7475 7320 6f66 0a20 2020 2020 7468 6520 tus of. the │ │ │ │ -00011740: 2777 6869 6c65 2720 616e 6420 2775 6e74 'while' and 'unt │ │ │ │ -00011750: 696c 2720 636f 6d6d 616e 6473 2069 7320 il' commands is │ │ │ │ -00011760: 7468 6520 6578 6974 2073 7461 7475 7320 the exit status │ │ │ │ -00011770: 6f66 2074 6865 206c 6173 740a 2020 2020 of the last. │ │ │ │ -00011780: 2027 646f 2720 4c49 5354 2063 6f6d 6d61 'do' LIST comma │ │ │ │ -00011790: 6e64 2065 7865 6375 7465 642c 206f 7220 nd executed, or │ │ │ │ -000117a0: 7a65 726f 2069 6620 6e6f 6e65 2077 6173 zero if none was │ │ │ │ -000117b0: 2065 7865 6375 7465 642e 0a0a 6675 6e63 executed...func │ │ │ │ -000117c0: 7469 6f6e 204e 414d 4520 7b20 434f 4d4d tion NAME { COMM │ │ │ │ -000117d0: 414e 443b 202e 2e2e 207d 0a20 2020 2020 AND; ... }. │ │ │ │ -000117e0: 5468 6973 2064 6566 696e 6573 2061 2066 This defines a f │ │ │ │ -000117f0: 756e 6374 696f 6e20 6e61 6d65 6420 4e41 unction named NA │ │ │ │ -00011800: 4d45 2e20 2054 6865 2022 626f 6479 2220 ME. The "body" │ │ │ │ -00011810: 6f66 2074 6865 2066 756e 6374 696f 6e20 of the function │ │ │ │ -00011820: 6973 0a20 2020 2020 7468 6520 6c69 7374 is. the list │ │ │ │ -00011830: 206f 6620 636f 6d6d 616e 6473 2077 6974 of commands wit │ │ │ │ -00011840: 6869 6e20 6272 6163 6573 2c20 6561 6368 hin braces, each │ │ │ │ -00011850: 206f 6620 7768 6963 6820 6d75 7374 2062 of which must b │ │ │ │ -00011860: 650a 2020 2020 2074 6572 6d69 6e61 7465 e. terminate │ │ │ │ -00011870: 6420 7769 7468 2061 2073 656d 6963 6f6c d with a semicol │ │ │ │ -00011880: 6f6e 206f 7220 6120 6e65 776c 696e 652e on or a newline. │ │ │ │ -00011890: 2020 5468 6973 206c 6973 7420 6f66 2063 This list of c │ │ │ │ -000118a0: 6f6d 6d61 6e64 730a 2020 2020 2077 696c ommands. wil │ │ │ │ -000118b0: 6c20 6265 2065 7865 6375 7465 6420 7768 l be executed wh │ │ │ │ -000118c0: 656e 6576 6572 204e 414d 4520 6973 2073 enever NAME is s │ │ │ │ -000118d0: 7065 6369 6669 6564 2061 7320 7468 6520 pecified as the │ │ │ │ -000118e0: 6e61 6d65 206f 6620 6120 7369 6d70 6c65 name of a simple │ │ │ │ -000118f0: 0a20 2020 2020 636f 6d6d 616e 642e 2020 . command. │ │ │ │ -00011900: 4675 6e63 7469 6f6e 2064 6566 696e 6974 Function definit │ │ │ │ -00011910: 696f 6e73 2064 6f20 6e6f 7420 6166 6665 ions do not affe │ │ │ │ -00011920: 6374 2074 6865 2065 7869 7420 7374 6174 ct the exit stat │ │ │ │ -00011930: 7573 2069 6e0a 2020 2020 2027 243f 272e us in. '$?'. │ │ │ │ -00011940: 2020 5768 656e 2065 7865 6375 7465 642c When executed, │ │ │ │ -00011950: 2074 6865 2065 7869 7420 7374 6174 7573 the exit status │ │ │ │ -00011960: 206f 6620 6120 6675 6e63 7469 6f6e 2069 of a function i │ │ │ │ -00011970: 7320 7468 6520 6578 6974 0a20 2020 2020 s the exit. │ │ │ │ -00011980: 7374 6174 7573 206f 6620 7468 6520 6c61 status of the la │ │ │ │ -00011990: 7374 2063 6f6d 6d61 6e64 2065 7865 6375 st command execu │ │ │ │ -000119a0: 7465 6420 696e 2074 6865 2062 6f64 792e ted in the body. │ │ │ │ -000119b0: 0a0a 6d65 6e75 656e 7472 7920 5449 544c ..menuentry TITL │ │ │ │ -000119c0: 4520 5b27 2d2d 636c 6173 733d 636c 6173 E ['--class=clas │ │ │ │ -000119d0: 7327 202e 2e2e 5d20 5b27 2d2d 7573 6572 s' ...] ['--user │ │ │ │ -000119e0: 733d 7573 6572 7327 5d20 5b27 2d2d 756e s=users'] ['--un │ │ │ │ -000119f0: 7265 7374 7269 6374 6564 275d 205b 272d restricted'] ['- │ │ │ │ -00011a00: 2d68 6f74 6b65 793d 6b65 7927 5d20 5b27 -hotkey=key'] [' │ │ │ │ -00011a10: 2d2d 6964 3d69 6427 5d20 7b20 434f 4d4d --id=id'] { COMM │ │ │ │ -00011a20: 414e 443b 202e 2e2e 207d 0a20 2020 2020 AND; ... }. │ │ │ │ -00011a30: 2a4e 6f74 6520 6d65 6e75 656e 7472 793a *Note menuentry: │ │ │ │ -00011a40: 3a2e 0a0a 4275 696c 742d 696e 2043 6f6d :...Built-in Com │ │ │ │ -00011a50: 6d61 6e64 730a 3d3d 3d3d 3d3d 3d3d 3d3d mands.========== │ │ │ │ -00011a60: 3d3d 3d3d 3d3d 3d0a 0a53 6f6d 6520 6275 =======..Some bu │ │ │ │ -00011a70: 696c 742d 696e 2063 6f6d 6d61 6e64 7320 ilt-in commands │ │ │ │ -00011a80: 6172 6520 616c 736f 2070 726f 7669 6465 are also provide │ │ │ │ -00011a90: 6420 6279 2047 5255 4220 7363 7269 7074 d by GRUB script │ │ │ │ -00011aa0: 2074 6f20 6865 6c70 2073 6372 6970 740a to help script. │ │ │ │ -00011ab0: 7772 6974 6572 7320 7065 7266 6f72 6d20 writers perform │ │ │ │ -00011ac0: 6163 7469 6f6e 7320 7468 6174 2061 7265 actions that are │ │ │ │ -00011ad0: 206f 7468 6572 7769 7365 206e 6f74 2070 otherwise not p │ │ │ │ -00011ae0: 6f73 7369 626c 652e 2020 466f 7220 6578 ossible. For ex │ │ │ │ -00011af0: 616d 706c 652c 0a74 6865 7365 2069 6e63 ample,.these inc │ │ │ │ -00011b00: 6c75 6465 2063 6f6d 6d61 6e64 7320 746f lude commands to │ │ │ │ -00011b10: 206a 756d 7020 6f75 7420 6f66 2061 206c jump out of a l │ │ │ │ -00011b20: 6f6f 7020 7769 7468 6f75 7420 6675 6c6c oop without full │ │ │ │ -00011b30: 7920 636f 6d70 6c65 7469 6e67 0a69 742c y completing.it, │ │ │ │ -00011b40: 2065 7463 2e0a 0a62 7265 616b 205b 276e etc...break ['n │ │ │ │ -00011b50: 275d 0a20 2020 2020 4578 6974 2066 726f ']. Exit fro │ │ │ │ -00011b60: 6d20 7769 7468 696e 2061 2027 666f 7227 m within a 'for' │ │ │ │ -00011b70: 2c20 2777 6869 6c65 272c 206f 7220 2775 , 'while', or 'u │ │ │ │ -00011b80: 6e74 696c 2720 6c6f 6f70 2e20 2049 6620 ntil' loop. If │ │ │ │ -00011b90: 276e 2720 6973 0a20 2020 2020 7370 6563 'n' is. spec │ │ │ │ -00011ba0: 6966 6965 642c 2062 7265 616b 2027 6e27 ified, break 'n' │ │ │ │ -00011bb0: 206c 6576 656c 732e 2020 276e 2720 6d75 levels. 'n' mu │ │ │ │ -00011bc0: 7374 2062 6520 6772 6561 7465 7220 7468 st be greater th │ │ │ │ -00011bd0: 616e 206f 7220 6571 7561 6c20 746f 0a20 an or equal to. │ │ │ │ -00011be0: 2020 2020 312e 2020 4966 2027 6e27 2069 1. If 'n' i │ │ │ │ -00011bf0: 7320 6772 6561 7465 7220 7468 616e 2074 s greater than t │ │ │ │ -00011c00: 6865 206e 756d 6265 7220 6f66 2065 6e63 he number of enc │ │ │ │ -00011c10: 6c6f 7369 6e67 206c 6f6f 7073 2c20 616c losing loops, al │ │ │ │ -00011c20: 6c0a 2020 2020 2065 6e63 6c6f 7369 6e67 l. enclosing │ │ │ │ -00011c30: 206c 6f6f 7073 2061 7265 2065 7869 7465 loops are exite │ │ │ │ -00011c40: 642e 2020 5468 6520 7265 7475 726e 2076 d. The return v │ │ │ │ -00011c50: 616c 7565 2069 7320 3020 756e 6c65 7373 alue is 0 unless │ │ │ │ -00011c60: 2027 6e27 2069 730a 2020 2020 206e 6f74 'n' is. not │ │ │ │ -00011c70: 2067 7265 6174 6572 2074 6861 6e20 6f72 greater than or │ │ │ │ -00011c80: 2065 7175 616c 2074 6f20 312e 0a0a 636f equal to 1...co │ │ │ │ -00011c90: 6e74 696e 7565 205b 276e 275d 0a20 2020 ntinue ['n']. │ │ │ │ -00011ca0: 2020 5265 7375 6d65 2074 6865 206e 6578 Resume the nex │ │ │ │ -00011cb0: 7420 6974 6572 6174 696f 6e20 6f66 2074 t iteration of t │ │ │ │ -00011cc0: 6865 2065 6e63 6c6f 7369 6e67 2027 666f he enclosing 'fo │ │ │ │ -00011cd0: 7227 2c20 2777 6869 6c65 2720 6f72 0a20 r', 'while' or. │ │ │ │ -00011ce0: 2020 2020 2775 6e74 696c 2720 6c6f 6f70 'until' loop │ │ │ │ -00011cf0: 2e20 2049 6620 276e 2720 6973 2073 7065 . If 'n' is spe │ │ │ │ -00011d00: 6369 6669 6564 2c20 7265 7375 6d65 2061 cified, resume a │ │ │ │ -00011d10: 7420 7468 6520 276e 2774 6820 656e 636c t the 'n'th encl │ │ │ │ -00011d20: 6f73 696e 670a 2020 2020 206c 6f6f 702e osing. loop. │ │ │ │ -00011d30: 2020 276e 2720 6d75 7374 2062 6520 6772 'n' must be gr │ │ │ │ -00011d40: 6561 7465 7220 7468 616e 206f 7220 6571 eater than or eq │ │ │ │ -00011d50: 7561 6c20 746f 2031 2e20 2049 6620 276e ual to 1. If 'n │ │ │ │ -00011d60: 2720 6973 2067 7265 6174 6572 0a20 2020 ' is greater. │ │ │ │ -00011d70: 2020 7468 616e 2074 6865 206e 756d 6265 than the numbe │ │ │ │ -00011d80: 7220 6f66 2065 6e63 6c6f 7369 6e67 206c r of enclosing l │ │ │ │ -00011d90: 6f6f 7073 2c20 7468 6520 6c61 7374 2065 oops, the last e │ │ │ │ -00011da0: 6e63 6c6f 7369 6e67 206c 6f6f 7020 2874 nclosing loop (t │ │ │ │ -00011db0: 6865 0a20 2020 2020 2274 6f70 2d6c 6576 he. "top-lev │ │ │ │ -00011dc0: 656c 2220 6c6f 6f70 2920 6973 2072 6573 el" loop) is res │ │ │ │ -00011dd0: 756d 6564 2e20 2054 6865 2072 6574 7572 umed. The retur │ │ │ │ -00011de0: 6e20 7661 6c75 6520 6973 2030 2075 6e6c n value is 0 unl │ │ │ │ -00011df0: 6573 7320 276e 2720 6973 0a20 2020 2020 ess 'n' is. │ │ │ │ -00011e00: 6e6f 7420 6772 6561 7465 7220 7468 616e not greater than │ │ │ │ -00011e10: 206f 7220 6571 7561 6c20 746f 2031 2e0a or equal to 1.. │ │ │ │ -00011e20: 0a72 6574 7572 6e20 5b27 6e27 5d0a 2020 .return ['n']. │ │ │ │ -00011e30: 2020 2043 6175 7365 7320 6120 6675 6e63 Causes a func │ │ │ │ -00011e40: 7469 6f6e 2074 6f20 6578 6974 2077 6974 tion to exit wit │ │ │ │ -00011e50: 6820 7468 6520 7265 7475 726e 2076 616c h the return val │ │ │ │ -00011e60: 7565 2073 7065 6369 6669 6564 2062 7920 ue specified by │ │ │ │ -00011e70: 276e 272e 0a20 2020 2020 4966 2027 6e27 'n'.. If 'n' │ │ │ │ -00011e80: 2069 7320 6f6d 6974 7465 642c 2074 6865 is omitted, the │ │ │ │ -00011e90: 2072 6574 7572 6e20 7374 6174 7573 2069 return status i │ │ │ │ -00011ea0: 7320 7468 6174 206f 6620 7468 6520 6c61 s that of the la │ │ │ │ -00011eb0: 7374 2063 6f6d 6d61 6e64 0a20 2020 2020 st command. │ │ │ │ -00011ec0: 6578 6563 7574 6564 2069 6e20 7468 6520 executed in the │ │ │ │ -00011ed0: 6675 6e63 7469 6f6e 2062 6f64 792e 2020 function body. │ │ │ │ -00011ee0: 4966 2075 7365 6420 6f75 7473 6964 6520 If used outside │ │ │ │ -00011ef0: 6120 6675 6e63 7469 6f6e 2074 6865 0a20 a function the. │ │ │ │ -00011f00: 2020 2020 7265 7475 726e 2073 7461 7475 return statu │ │ │ │ -00011f10: 7320 6973 2066 616c 7365 2e0a 0a73 6574 s is false...set │ │ │ │ -00011f20: 7061 7261 6d73 205b 2761 7267 275d 202e params ['arg'] . │ │ │ │ -00011f30: 2e2e 0a20 2020 2020 5265 706c 6163 6520 ... Replace │ │ │ │ -00011f40: 706f 7369 7469 6f6e 616c 2070 6172 616d positional param │ │ │ │ -00011f50: 6574 6572 7320 7374 6172 7469 6e67 2077 eters starting w │ │ │ │ -00011f60: 6974 6820 2724 3127 2077 6974 6820 6172 ith '$1' with ar │ │ │ │ -00011f70: 6775 6d65 6e74 7320 746f 0a20 2020 2020 guments to. │ │ │ │ -00011f80: 2773 6574 7061 7261 6d73 272e 0a0a 7368 'setparams'...sh │ │ │ │ -00011f90: 6966 7420 5b27 6e27 5d0a 2020 2020 2054 ift ['n']. T │ │ │ │ -00011fa0: 6865 2070 6f73 6974 696f 6e61 6c20 7061 he positional pa │ │ │ │ -00011fb0: 7261 6d65 7465 7273 2066 726f 6d20 276e rameters from 'n │ │ │ │ -00011fc0: 272b 3120 2e2e 2e20 6172 6520 7265 6e61 '+1 ... are rena │ │ │ │ -00011fd0: 6d65 6420 746f 2027 2431 272e 2e2e 2e0a med to '$1'..... │ │ │ │ -00011fe0: 2020 2020 2050 6172 616d 6574 6572 7320 Parameters │ │ │ │ -00011ff0: 7265 7072 6573 656e 7465 6420 6279 2074 represented by t │ │ │ │ -00012000: 6865 206e 756d 6265 7273 2027 2423 2720 he numbers '$#' │ │ │ │ -00012010: 646f 776e 2074 6f20 2724 2327 2d27 6e27 down to '$#'-'n' │ │ │ │ -00012020: 2b31 2061 7265 0a20 2020 2020 756e 7365 +1 are. unse │ │ │ │ -00012030: 742e 2020 276e 2720 6d75 7374 2062 6520 t. 'n' must be │ │ │ │ -00012040: 6120 6e6f 6e2d 6e65 6761 7469 7665 206e a non-negative n │ │ │ │ -00012050: 756d 6265 7220 6c65 7373 2074 6861 6e20 umber less than │ │ │ │ -00012060: 6f72 2065 7175 616c 2074 6f0a 2020 2020 or equal to. │ │ │ │ -00012070: 2027 2423 272e 2020 4966 2027 6e27 2069 '$#'. If 'n' i │ │ │ │ -00012080: 7320 302c 206e 6f20 7061 7261 6d65 7465 s 0, no paramete │ │ │ │ -00012090: 7273 2061 7265 2063 6861 6e67 6564 2e20 rs are changed. │ │ │ │ -000120a0: 2049 6620 276e 2720 6973 206e 6f74 0a20 If 'n' is not. │ │ │ │ -000120b0: 2020 2020 6769 7665 6e2c 2069 7420 6973 given, it is │ │ │ │ -000120c0: 2061 7373 756d 6564 2074 6f20 6265 2031 assumed to be 1 │ │ │ │ -000120d0: 2e20 2049 6620 276e 2720 6973 2067 7265 . If 'n' is gre │ │ │ │ -000120e0: 6174 6572 2074 6861 6e20 2724 2327 2c20 ater than '$#', │ │ │ │ -000120f0: 7468 650a 2020 2020 2070 6f73 6974 696f the. positio │ │ │ │ -00012100: 6e61 6c20 7061 7261 6d65 7465 7273 2061 nal parameters a │ │ │ │ -00012110: 7265 206e 6f74 2063 6861 6e67 6564 2e20 re not changed. │ │ │ │ -00012120: 2054 6865 2072 6574 7572 6e20 7374 6174 The return stat │ │ │ │ -00012130: 7573 2069 730a 2020 2020 2067 7265 6174 us is. great │ │ │ │ -00012140: 6572 2074 6861 6e20 7a65 726f 2069 6620 er than zero if │ │ │ │ -00012150: 276e 2720 6973 2067 7265 6174 6572 2074 'n' is greater t │ │ │ │ -00012160: 6861 6e20 2724 2327 206f 7220 6c65 7373 han '$#' or less │ │ │ │ -00012170: 2074 6861 6e20 7a65 726f 3b0a 2020 2020 than zero;. │ │ │ │ -00012180: 206f 7468 6572 7769 7365 2030 2e0a 0a1f otherwise 0.... │ │ │ │ -00012190: 0a46 696c 653a 2067 7275 622e 696e 666f .File: grub.info │ │ │ │ -000121a0: 2c20 204e 6f64 653a 2053 6865 6c6c 2d6c , Node: Shell-l │ │ │ │ -000121b0: 696b 6520 7363 7269 7074 696e 672d 466f ike scripting-Fo │ │ │ │ -000121c0: 6f74 6e6f 7465 732c 2020 5570 3a20 5368 otnotes, Up: Sh │ │ │ │ -000121d0: 656c 6c2d 6c69 6b65 2073 6372 6970 7469 ell-like scripti │ │ │ │ -000121e0: 6e67 0a0a 2020 2028 3129 2043 7572 7265 ng.. (1) Curre │ │ │ │ -000121f0: 6e74 6c79 2061 2062 6163 6b73 6c61 7368 ntly a backslash │ │ │ │ -00012200: 2d6e 6577 6c69 6e65 2070 6169 7220 7769 -newline pair wi │ │ │ │ -00012210: 7468 696e 2061 2076 6172 6961 626c 6520 thin a variable │ │ │ │ -00012220: 6e61 6d65 2069 7320 6e6f 740a 6861 6e64 name is not.hand │ │ │ │ -00012230: 6c65 6420 7072 6f70 6572 6c79 2c20 736f led properly, so │ │ │ │ -00012240: 2075 7365 2074 6869 7320 6665 6174 7572 use this featur │ │ │ │ -00012250: 6520 7769 7468 2073 6f6d 6520 6361 7265 e with some care │ │ │ │ -00012260: 2e0a 0a1f 0a46 696c 653a 2067 7275 622e .....File: grub. │ │ │ │ -00012270: 696e 666f 2c20 204e 6f64 653a 204d 756c info, Node: Mul │ │ │ │ -00012280: 7469 2d62 6f6f 7420 6d61 6e75 616c 2063 ti-boot manual c │ │ │ │ -00012290: 6f6e 6669 672c 2020 4e65 7874 3a20 456d onfig, Next: Em │ │ │ │ -000122a0: 6265 6464 6564 2063 6f6e 6669 6775 7261 bedded configura │ │ │ │ -000122b0: 7469 6f6e 2c20 2050 7265 763a 2053 6865 tion, Prev: She │ │ │ │ -000122c0: 6c6c 2d6c 696b 6520 7363 7269 7074 696e ll-like scriptin │ │ │ │ -000122d0: 672c 2020 5570 3a20 436f 6e66 6967 7572 g, Up: Configur │ │ │ │ -000122e0: 6174 696f 6e0a 0a36 2e34 204d 756c 7469 ation..6.4 Multi │ │ │ │ -000122f0: 2d62 6f6f 7420 6d61 6e75 616c 2063 6f6e -boot manual con │ │ │ │ -00012300: 6669 670a 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d fig.============ │ │ │ │ +000102f0: 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a 2767 7275 ==========..'gru │ │ │ │ +00010300: 622e 6366 6727 2069 7320 7772 6974 7465 b.cfg' is writte │ │ │ │ +00010310: 6e20 696e 2047 5255 4227 7320 6275 696c n in GRUB's buil │ │ │ │ +00010320: 742d 696e 2073 6372 6970 7469 6e67 206c t-in scripting l │ │ │ │ +00010330: 616e 6775 6167 652c 2077 6869 6368 2068 anguage, which h │ │ │ │ +00010340: 6173 2061 0a73 796e 7461 7820 7175 6974 as a.syntax quit │ │ │ │ +00010350: 6520 7369 6d69 6c61 7220 746f 2074 6861 e similar to tha │ │ │ │ +00010360: 7420 6f66 2047 4e55 2042 6173 6820 616e t of GNU Bash an │ │ │ │ +00010370: 6420 6f74 6865 7220 426f 7572 6e65 2073 d other Bourne s │ │ │ │ +00010380: 6865 6c6c 0a64 6572 6976 6174 6976 6573 hell.derivatives │ │ │ │ +00010390: 2e0a 0a57 6f72 6473 0a3d 3d3d 3d3d 0a0a ...Words.=====.. │ │ │ │ +000103a0: 4120 2277 6f72 6422 2069 7320 6120 7365 A "word" is a se │ │ │ │ +000103b0: 7175 656e 6365 206f 6620 6368 6172 6163 quence of charac │ │ │ │ +000103c0: 7465 7273 2063 6f6e 7369 6465 7265 6420 ters considered │ │ │ │ +000103d0: 6173 2061 2073 696e 676c 6520 756e 6974 as a single unit │ │ │ │ +000103e0: 2062 790a 4752 5542 2e20 576f 7264 7320 by.GRUB. Words │ │ │ │ +000103f0: 6172 6520 7365 7061 7261 7465 6420 6279 are separated by │ │ │ │ +00010400: 2022 6d65 7461 6368 6172 6163 7465 7273 "metacharacters │ │ │ │ +00010410: 222c 2077 6869 6368 2061 7265 2074 6865 ", which are the │ │ │ │ +00010420: 2066 6f6c 6c6f 7769 6e67 0a70 6c75 7320 following.plus │ │ │ │ +00010430: 7370 6163 652c 2074 6162 2c20 616e 6420 space, tab, and │ │ │ │ +00010440: 6e65 776c 696e 653a 0a0a 2020 2020 207b newline:.. { │ │ │ │ +00010450: 207d 207c 2026 2024 203b 203c 203e 0a0a } | & $ ; < >.. │ │ │ │ +00010460: 2020 2051 756f 7469 6e67 206d 6179 2062 Quoting may b │ │ │ │ +00010470: 6520 7573 6564 2074 6f20 696e 636c 7564 e used to includ │ │ │ │ +00010480: 6520 6d65 7461 6368 6172 6163 7465 7273 e metacharacters │ │ │ │ +00010490: 2069 6e20 776f 7264 733b 2073 6565 2062 in words; see b │ │ │ │ +000104a0: 656c 6f77 2e0a 0a52 6573 6572 7665 6420 elow...Reserved │ │ │ │ +000104b0: 776f 7264 730a 3d3d 3d3d 3d3d 3d3d 3d3d words.========== │ │ │ │ +000104c0: 3d3d 3d3d 0a0a 5265 7365 7276 6564 2077 ====..Reserved w │ │ │ │ +000104d0: 6f72 6473 2068 6176 6520 6120 7370 6563 ords have a spec │ │ │ │ +000104e0: 6961 6c20 6d65 616e 696e 6720 746f 2047 ial meaning to G │ │ │ │ +000104f0: 5255 422e 2054 6865 2066 6f6c 6c6f 7769 RUB. The followi │ │ │ │ +00010500: 6e67 2077 6f72 6473 2061 7265 0a72 6563 ng words are.rec │ │ │ │ +00010510: 6f67 6e69 7365 6420 6173 2072 6573 6572 ognised as reser │ │ │ │ +00010520: 7665 6420 7768 656e 2075 6e71 756f 7465 ved when unquote │ │ │ │ +00010530: 6420 616e 6420 6569 7468 6572 2074 6865 d and either the │ │ │ │ +00010540: 2066 6972 7374 2077 6f72 6420 6f66 2061 first word of a │ │ │ │ +00010550: 0a73 696d 706c 6520 636f 6d6d 616e 6420 .simple command │ │ │ │ +00010560: 6f72 2074 6865 2074 6869 7264 2077 6f72 or the third wor │ │ │ │ +00010570: 6420 6f66 2061 2027 666f 7227 2063 6f6d d of a 'for' com │ │ │ │ +00010580: 6d61 6e64 3a0a 0a20 2020 2020 2120 5b5b mand:.. ! [[ │ │ │ │ +00010590: 205d 5d20 7b20 7d0a 2020 2020 2063 6173 ]] { }. cas │ │ │ │ +000105a0: 6520 646f 2064 6f6e 6520 656c 6966 2065 e do done elif e │ │ │ │ +000105b0: 6c73 6520 6573 6163 2066 6920 666f 7220 lse esac fi for │ │ │ │ +000105c0: 6675 6e63 7469 6f6e 0a20 2020 2020 6966 function. if │ │ │ │ +000105d0: 2069 6e20 6d65 6e75 656e 7472 7920 7365 in menuentry se │ │ │ │ +000105e0: 6c65 6374 2074 6865 6e20 7469 6d65 2075 lect then time u │ │ │ │ +000105f0: 6e74 696c 2077 6869 6c65 0a0a 2020 204e ntil while.. N │ │ │ │ +00010600: 6f74 2061 6c6c 206f 6620 7468 6573 6520 ot all of these │ │ │ │ +00010610: 7265 7365 7276 6564 2077 6f72 6473 2068 reserved words h │ │ │ │ +00010620: 6176 6520 6120 7573 6566 756c 2070 7572 ave a useful pur │ │ │ │ +00010630: 706f 7365 2079 6574 3b20 736f 6d65 2061 pose yet; some a │ │ │ │ +00010640: 7265 0a72 6573 6572 7665 6420 666f 7220 re.reserved for │ │ │ │ +00010650: 6675 7475 7265 2065 7870 616e 7369 6f6e future expansion │ │ │ │ +00010660: 2e0a 0a51 756f 7469 6e67 0a3d 3d3d 3d3d ...Quoting.===== │ │ │ │ +00010670: 3d3d 0a0a 5175 6f74 696e 6720 6973 2075 ==..Quoting is u │ │ │ │ +00010680: 7365 6420 746f 2072 656d 6f76 6520 7468 sed to remove th │ │ │ │ +00010690: 6520 7370 6563 6961 6c20 6d65 616e 696e e special meanin │ │ │ │ +000106a0: 6720 6f66 2063 6572 7461 696e 2063 6861 g of certain cha │ │ │ │ +000106b0: 7261 6374 6572 7320 6f72 0a77 6f72 6473 racters or.words │ │ │ │ +000106c0: 2e20 2049 7420 6361 6e20 6265 2075 7365 . It can be use │ │ │ │ +000106d0: 6420 746f 2074 7265 6174 206d 6574 6163 d to treat metac │ │ │ │ +000106e0: 6861 7261 6374 6572 7320 6173 2070 6172 haracters as par │ │ │ │ +000106f0: 7420 6f66 2061 2077 6f72 642c 2074 6f0a t of a word, to. │ │ │ │ +00010700: 7072 6576 656e 7420 7265 7365 7276 6564 prevent reserved │ │ │ │ +00010710: 2077 6f72 6473 2066 726f 6d20 6265 696e words from bein │ │ │ │ +00010720: 6720 7265 636f 676e 6973 6564 2061 7320 g recognised as │ │ │ │ +00010730: 7375 6368 2c20 616e 6420 746f 2070 7265 such, and to pre │ │ │ │ +00010740: 7665 6e74 0a76 6172 6961 626c 6520 6578 vent.variable ex │ │ │ │ +00010750: 7061 6e73 696f 6e2e 0a0a 2020 2054 6865 pansion... The │ │ │ │ +00010760: 7265 2061 7265 2074 6872 6565 2071 756f re are three quo │ │ │ │ +00010770: 7469 6e67 206d 6563 6861 6e69 736d 733a ting mechanisms: │ │ │ │ +00010780: 2074 6865 2065 7363 6170 6520 6368 6172 the escape char │ │ │ │ +00010790: 6163 7465 722c 2073 696e 676c 650a 7175 acter, single.qu │ │ │ │ +000107a0: 6f74 6573 2c20 616e 6420 646f 7562 6c65 otes, and double │ │ │ │ +000107b0: 2071 756f 7465 732e 0a0a 2020 2041 206e quotes... A n │ │ │ │ +000107c0: 6f6e 2d71 756f 7465 6420 6261 636b 736c on-quoted backsl │ │ │ │ +000107d0: 6173 6820 285c 2920 6973 2074 6865 2022 ash (\) is the " │ │ │ │ +000107e0: 6573 6361 7065 2063 6861 7261 6374 6572 escape character │ │ │ │ +000107f0: 222e 2020 4974 2070 7265 7365 7276 6573 ". It preserves │ │ │ │ +00010800: 0a74 6865 206c 6974 6572 616c 2076 616c .the literal val │ │ │ │ +00010810: 7565 206f 6620 7468 6520 6e65 7874 2063 ue of the next c │ │ │ │ +00010820: 6861 7261 6374 6572 2074 6861 7420 666f haracter that fo │ │ │ │ +00010830: 6c6c 6f77 732c 2077 6974 6820 7468 6520 llows, with the │ │ │ │ +00010840: 6578 6365 7074 696f 6e0a 6f66 206e 6577 exception.of new │ │ │ │ +00010850: 6c69 6e65 2e0a 0a20 2020 456e 636c 6f73 line... Enclos │ │ │ │ +00010860: 696e 6720 6368 6172 6163 7465 7273 2069 ing characters i │ │ │ │ +00010870: 6e20 7369 6e67 6c65 2071 756f 7465 7320 n single quotes │ │ │ │ +00010880: 7072 6573 6572 7665 7320 7468 6520 6c69 preserves the li │ │ │ │ +00010890: 7465 7261 6c20 7661 6c75 6520 6f66 0a65 teral value of.e │ │ │ │ +000108a0: 6163 6820 6368 6172 6163 7465 7220 7769 ach character wi │ │ │ │ +000108b0: 7468 696e 2074 6865 2071 756f 7465 732e thin the quotes. │ │ │ │ +000108c0: 2020 4120 7369 6e67 6c65 2071 756f 7465 A single quote │ │ │ │ +000108d0: 206d 6179 206e 6f74 206f 6363 7572 2062 may not occur b │ │ │ │ +000108e0: 6574 7765 656e 0a73 696e 676c 6520 7175 etween.single qu │ │ │ │ +000108f0: 6f74 6573 2c20 6576 656e 2077 6865 6e20 otes, even when │ │ │ │ +00010900: 7072 6563 6564 6564 2062 7920 6120 6261 preceded by a ba │ │ │ │ +00010910: 636b 736c 6173 682e 0a0a 2020 2045 6e63 ckslash... Enc │ │ │ │ +00010920: 6c6f 7369 6e67 2063 6861 7261 6374 6572 losing character │ │ │ │ +00010930: 7320 696e 2064 6f75 626c 6520 7175 6f74 s in double quot │ │ │ │ +00010940: 6573 2070 7265 7365 7276 6573 2074 6865 es preserves the │ │ │ │ +00010950: 206c 6974 6572 616c 2076 616c 7565 206f literal value o │ │ │ │ +00010960: 660a 616c 6c20 6368 6172 6163 7465 7273 f.all characters │ │ │ │ +00010970: 2077 6974 6869 6e20 7468 6520 7175 6f74 within the quot │ │ │ │ +00010980: 6573 2c20 7769 7468 2074 6865 2065 7863 es, with the exc │ │ │ │ +00010990: 6570 7469 6f6e 206f 6620 2724 2720 616e eption of '$' an │ │ │ │ +000109a0: 6420 275c 272e 0a54 6865 2027 2427 2063 d '\'..The '$' c │ │ │ │ +000109b0: 6861 7261 6374 6572 2072 6574 6169 6e73 haracter retains │ │ │ │ +000109c0: 2069 7473 2073 7065 6369 616c 206d 6561 its special mea │ │ │ │ +000109d0: 6e69 6e67 2077 6974 6869 6e20 646f 7562 ning within doub │ │ │ │ +000109e0: 6c65 2071 756f 7465 732e 2020 5468 650a le quotes. The. │ │ │ │ +000109f0: 6261 636b 736c 6173 6820 7265 7461 696e backslash retain │ │ │ │ +00010a00: 7320 6974 7320 7370 6563 6961 6c20 6d65 s its special me │ │ │ │ +00010a10: 616e 696e 6720 6f6e 6c79 2077 6865 6e20 aning only when │ │ │ │ +00010a20: 666f 6c6c 6f77 6564 2062 7920 6f6e 6520 followed by one │ │ │ │ +00010a30: 6f66 2074 6865 0a66 6f6c 6c6f 7769 6e67 of the.following │ │ │ │ +00010a40: 2063 6861 7261 6374 6572 733a 2027 2427 characters: '$' │ │ │ │ +00010a50: 2c20 2722 272c 2027 5c27 2c20 6f72 206e , '"', '\', or n │ │ │ │ +00010a60: 6577 6c69 6e65 2e20 2041 2062 6163 6b73 ewline. A backs │ │ │ │ +00010a70: 6c61 7368 2d6e 6577 6c69 6e65 0a70 6169 lash-newline.pai │ │ │ │ +00010a80: 7220 6973 2074 7265 6174 6564 2061 7320 r is treated as │ │ │ │ +00010a90: 6120 6c69 6e65 2063 6f6e 7469 6e75 6174 a line continuat │ │ │ │ +00010aa0: 696f 6e20 2874 6861 7420 6973 2c20 6974 ion (that is, it │ │ │ │ +00010ab0: 2069 7320 7265 6d6f 7665 6420 6672 6f6d is removed from │ │ │ │ +00010ac0: 2074 6865 0a69 6e70 7574 2073 7472 6561 the.input strea │ │ │ │ +00010ad0: 6d20 616e 6420 6566 6665 6374 6976 656c m and effectivel │ │ │ │ +00010ae0: 7920 6967 6e6f 7265 6428 3129 2028 2a6e y ignored(1) (*n │ │ │ │ +00010af0: 6f74 6520 5368 656c 6c2d 6c69 6b65 0a73 ote Shell-like.s │ │ │ │ +00010b00: 6372 6970 7469 6e67 2d46 6f6f 746e 6f74 cripting-Footnot │ │ │ │ +00010b10: 652d 313a 3a29 292e 2020 4120 646f 7562 e-1::)). A doub │ │ │ │ +00010b20: 6c65 2071 756f 7465 206d 6179 2062 6520 le quote may be │ │ │ │ +00010b30: 7175 6f74 6564 2077 6974 6869 6e20 646f quoted within do │ │ │ │ +00010b40: 7562 6c65 0a71 756f 7465 7320 6279 2070 uble.quotes by p │ │ │ │ +00010b50: 7265 6365 6469 6e67 2069 7420 7769 7468 receding it with │ │ │ │ +00010b60: 2061 2062 6163 6b73 6c61 7368 2e0a 0a56 a backslash...V │ │ │ │ +00010b70: 6172 6961 626c 6520 6578 7061 6e73 696f ariable expansio │ │ │ │ +00010b80: 6e0a 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d n.============== │ │ │ │ +00010b90: 3d3d 3d3d 0a0a 5468 6520 2724 2720 6368 ====..The '$' ch │ │ │ │ +00010ba0: 6172 6163 7465 7220 696e 7472 6f64 7563 aracter introduc │ │ │ │ +00010bb0: 6573 2076 6172 6961 626c 6520 6578 7061 es variable expa │ │ │ │ +00010bc0: 6e73 696f 6e2e 2020 5468 6520 7661 7269 nsion. The vari │ │ │ │ +00010bd0: 6162 6c65 206e 616d 6520 746f 0a62 6520 able name to.be │ │ │ │ +00010be0: 6578 7061 6e64 6564 206d 6179 2062 6520 expanded may be │ │ │ │ +00010bf0: 656e 636c 6f73 6564 2069 6e20 6272 6163 enclosed in brac │ │ │ │ +00010c00: 6573 2c20 7768 6963 6820 6172 6520 6f70 es, which are op │ │ │ │ +00010c10: 7469 6f6e 616c 2062 7574 2073 6572 7665 tional but serve │ │ │ │ +00010c20: 2074 6f0a 7072 6f74 6563 7420 7468 6520 to.protect the │ │ │ │ +00010c30: 7661 7269 6162 6c65 2074 6f20 6265 2065 variable to be e │ │ │ │ +00010c40: 7870 616e 6465 6420 6672 6f6d 2063 6861 xpanded from cha │ │ │ │ +00010c50: 7261 6374 6572 7320 696d 6d65 6469 6174 racters immediat │ │ │ │ +00010c60: 656c 790a 666f 6c6c 6f77 696e 6720 6974 ely.following it │ │ │ │ +00010c70: 2077 6869 6368 2063 6f75 6c64 2062 6520 which could be │ │ │ │ +00010c80: 696e 7465 7270 7265 7465 6420 6173 2070 interpreted as p │ │ │ │ +00010c90: 6172 7420 6f66 2074 6865 206e 616d 652e art of the name. │ │ │ │ +00010ca0: 0a0a 2020 204e 6f72 6d61 6c20 7661 7269 .. Normal vari │ │ │ │ +00010cb0: 6162 6c65 206e 616d 6573 2062 6567 696e able names begin │ │ │ │ +00010cc0: 2077 6974 6820 616e 2061 6c70 6861 6265 with an alphabe │ │ │ │ +00010cd0: 7469 6320 6368 6172 6163 7465 722c 2066 tic character, f │ │ │ │ +00010ce0: 6f6c 6c6f 7765 6420 6279 0a7a 6572 6f20 ollowed by.zero │ │ │ │ +00010cf0: 6f72 206d 6f72 6520 616c 7068 616e 756d or more alphanum │ │ │ │ +00010d00: 6572 6963 2063 6861 7261 6374 6572 732e eric characters. │ │ │ │ +00010d10: 2020 5468 6573 6520 6e61 6d65 7320 7265 These names re │ │ │ │ +00010d20: 6665 7220 746f 2065 6e74 7269 6573 2069 fer to entries i │ │ │ │ +00010d30: 6e0a 7468 6520 4752 5542 2065 6e76 6972 n.the GRUB envir │ │ │ │ +00010d40: 6f6e 6d65 6e74 2028 2a6e 6f74 6520 456e onment (*note En │ │ │ │ +00010d50: 7669 726f 6e6d 656e 743a 3a29 2e0a 0a20 vironment::)... │ │ │ │ +00010d60: 2020 506f 7369 7469 6f6e 616c 2076 6172 Positional var │ │ │ │ +00010d70: 6961 626c 6520 6e61 6d65 7320 636f 6e73 iable names cons │ │ │ │ +00010d80: 6973 7420 6f66 206f 6e65 206f 7220 6d6f ist of one or mo │ │ │ │ +00010d90: 7265 2064 6967 6974 732e 2020 5468 6579 re digits. They │ │ │ │ +00010da0: 0a72 6570 7265 7365 6e74 2070 6172 616d .represent param │ │ │ │ +00010db0: 6574 6572 7320 7061 7373 6564 2074 6f20 eters passed to │ │ │ │ +00010dc0: 6675 6e63 7469 6f6e 2063 616c 6c73 2c20 function calls, │ │ │ │ +00010dd0: 7769 7468 2027 2431 2720 7265 7072 6573 with '$1' repres │ │ │ │ +00010de0: 656e 7469 6e67 0a74 6865 2066 6972 7374 enting.the first │ │ │ │ +00010df0: 2070 6172 616d 6574 6572 2c20 616e 6420 parameter, and │ │ │ │ +00010e00: 736f 206f 6e2e 0a0a 2020 2054 6865 2073 so on... The s │ │ │ │ +00010e10: 7065 6369 616c 2076 6172 6961 626c 6520 pecial variable │ │ │ │ +00010e20: 6e61 6d65 2027 3f27 2065 7870 616e 6473 name '?' expands │ │ │ │ +00010e30: 2074 6f20 7468 6520 6578 6974 2073 7461 to the exit sta │ │ │ │ +00010e40: 7475 7320 6f66 2074 6865 206d 6f73 740a tus of the most. │ │ │ │ +00010e50: 7265 6365 6e74 6c79 2065 7865 6375 7465 recently execute │ │ │ │ +00010e60: 6420 636f 6d6d 616e 642e 2020 5768 656e d command. When │ │ │ │ +00010e70: 2070 6f73 6974 696f 6e61 6c20 7661 7269 positional vari │ │ │ │ +00010e80: 6162 6c65 206e 616d 6573 2061 7265 2061 able names are a │ │ │ │ +00010e90: 6374 6976 652c 0a6f 7468 6572 2073 7065 ctive,.other spe │ │ │ │ +00010ea0: 6369 616c 2076 6172 6961 626c 6520 6e61 cial variable na │ │ │ │ +00010eb0: 6d65 7320 2740 272c 2027 2a27 2061 6e64 mes '@', '*' and │ │ │ │ +00010ec0: 2027 2327 2061 7265 2064 6566 696e 6564 '#' are defined │ │ │ │ +00010ed0: 2061 6e64 2074 6865 790a 6578 7061 6e64 and they.expand │ │ │ │ +00010ee0: 2074 6f20 616c 6c20 706f 7369 7469 6f6e to all position │ │ │ │ +00010ef0: 616c 2070 6172 616d 6574 6572 7320 7769 al parameters wi │ │ │ │ +00010f00: 7468 206e 6563 6573 7361 7279 2071 756f th necessary quo │ │ │ │ +00010f10: 7469 6e67 2c20 706f 7369 7469 6f6e 616c ting, positional │ │ │ │ +00010f20: 0a70 6172 616d 6574 6572 7320 7769 7468 .parameters with │ │ │ │ +00010f30: 6f75 7420 616e 7920 7175 6f74 696e 672c out any quoting, │ │ │ │ +00010f40: 2061 6e64 2070 6f73 6974 696f 6e61 6c20 and positional │ │ │ │ +00010f50: 7061 7261 6d65 7465 7220 636f 756e 740a parameter count. │ │ │ │ +00010f60: 7265 7370 6563 7469 7665 6c79 2e0a 0a43 respectively...C │ │ │ │ +00010f70: 6f6d 6d65 6e74 730a 3d3d 3d3d 3d3d 3d3d omments.======== │ │ │ │ +00010f80: 0a0a 4120 776f 7264 2062 6567 696e 6e69 ..A word beginni │ │ │ │ +00010f90: 6e67 2077 6974 6820 2723 2720 6361 7573 ng with '#' caus │ │ │ │ +00010fa0: 6573 2074 6861 7420 776f 7264 2061 6e64 es that word and │ │ │ │ +00010fb0: 2061 6c6c 2072 656d 6169 6e69 6e67 2063 all remaining c │ │ │ │ +00010fc0: 6861 7261 6374 6572 730a 6f6e 2074 6861 haracters.on tha │ │ │ │ +00010fd0: 7420 6c69 6e65 2074 6f20 6265 2069 676e t line to be ign │ │ │ │ +00010fe0: 6f72 6564 2e0a 0a53 696d 706c 6520 636f ored...Simple co │ │ │ │ +00010ff0: 6d6d 616e 6473 0a3d 3d3d 3d3d 3d3d 3d3d mmands.========= │ │ │ │ +00011000: 3d3d 3d3d 3d3d 0a0a 4120 2273 696d 706c ======..A "simpl │ │ │ │ +00011010: 6520 636f 6d6d 616e 6422 2069 7320 6120 e command" is a │ │ │ │ +00011020: 7365 7175 656e 6365 206f 6620 776f 7264 sequence of word │ │ │ │ +00011030: 7320 7365 7061 7261 7465 6420 6279 2073 s separated by s │ │ │ │ +00011040: 7061 6365 7320 6f72 2074 6162 730a 616e paces or tabs.an │ │ │ │ +00011050: 6420 7465 726d 696e 6174 6564 2062 7920 d terminated by │ │ │ │ +00011060: 6120 7365 6d69 636f 6c6f 6e20 6f72 2061 a semicolon or a │ │ │ │ +00011070: 206e 6577 6c69 6e65 2e20 2054 6865 2066 newline. The f │ │ │ │ +00011080: 6972 7374 2077 6f72 6420 7370 6563 6966 irst word specif │ │ │ │ +00011090: 6965 730a 7468 6520 636f 6d6d 616e 6420 ies.the command │ │ │ │ +000110a0: 746f 2062 6520 6578 6563 7574 6564 2e20 to be executed. │ │ │ │ +000110b0: 2054 6865 2072 656d 6169 6e69 6e67 2077 The remaining w │ │ │ │ +000110c0: 6f72 6473 2061 7265 2070 6173 7365 6420 ords are passed │ │ │ │ +000110d0: 6173 2061 7267 756d 656e 7473 0a74 6f20 as arguments.to │ │ │ │ +000110e0: 7468 6520 696e 766f 6b65 6420 636f 6d6d the invoked comm │ │ │ │ +000110f0: 616e 642e 0a0a 2020 2054 6865 2072 6574 and... The ret │ │ │ │ +00011100: 7572 6e20 7661 6c75 6520 6f66 2061 2073 urn value of a s │ │ │ │ +00011110: 696d 706c 6520 636f 6d6d 616e 6420 6973 imple command is │ │ │ │ +00011120: 2069 7473 2065 7869 7420 7374 6174 7573 its exit status │ │ │ │ +00011130: 2e20 2049 6620 7468 650a 7265 7365 7276 . If the.reserv │ │ │ │ +00011140: 6564 2077 6f72 6420 2721 2720 7072 6563 ed word '!' prec │ │ │ │ +00011150: 6564 6573 2074 6865 2063 6f6d 6d61 6e64 edes the command │ │ │ │ +00011160: 2c20 7468 656e 2074 6865 2072 6574 7572 , then the retur │ │ │ │ +00011170: 6e20 7661 6c75 6520 6973 2069 6e73 7465 n value is inste │ │ │ │ +00011180: 6164 0a74 6865 206c 6f67 6963 616c 206e ad.the logical n │ │ │ │ +00011190: 6567 6174 696f 6e20 6f66 2074 6865 2063 egation of the c │ │ │ │ +000111a0: 6f6d 6d61 6e64 2773 2065 7869 7420 7374 ommand's exit st │ │ │ │ +000111b0: 6174 7573 2e0a 0a43 6f6d 706f 756e 6420 atus...Compound │ │ │ │ +000111c0: 636f 6d6d 616e 6473 0a3d 3d3d 3d3d 3d3d commands.======= │ │ │ │ +000111d0: 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a 4120 2263 ==========..A "c │ │ │ │ +000111e0: 6f6d 706f 756e 6420 636f 6d6d 616e 6422 ompound command" │ │ │ │ +000111f0: 2069 7320 6f6e 6520 6f66 2074 6865 2066 is one of the f │ │ │ │ +00011200: 6f6c 6c6f 7769 6e67 3a0a 0a66 6f72 204e ollowing:..for N │ │ │ │ +00011210: 414d 4520 696e 2057 4f52 4420 2e2e 2e3b AME in WORD ...; │ │ │ │ +00011220: 2064 6f20 4c49 5354 3b20 646f 6e65 0a20 do LIST; done. │ │ │ │ +00011230: 2020 2020 5468 6520 6c69 7374 206f 6620 The list of │ │ │ │ +00011240: 776f 7264 7320 666f 6c6c 6f77 696e 6720 words following │ │ │ │ +00011250: 2769 6e27 2069 7320 6578 7061 6e64 6564 'in' is expanded │ │ │ │ +00011260: 2c20 6765 6e65 7261 7469 6e67 2061 206c , generating a l │ │ │ │ +00011270: 6973 7420 6f66 0a20 2020 2020 6974 656d ist of. item │ │ │ │ +00011280: 732e 2020 5468 6520 7661 7269 6162 6c65 s. The variable │ │ │ │ +00011290: 204e 414d 4520 6973 2073 6574 2074 6f20 NAME is set to │ │ │ │ +000112a0: 6561 6368 2065 6c65 6d65 6e74 206f 6620 each element of │ │ │ │ +000112b0: 7468 6973 206c 6973 7420 696e 0a20 2020 this list in. │ │ │ │ +000112c0: 2020 7475 726e 2c20 616e 6420 4c49 5354 turn, and LIST │ │ │ │ +000112d0: 2069 7320 6578 6563 7574 6564 2065 6163 is executed eac │ │ │ │ +000112e0: 6820 7469 6d65 2e20 2054 6865 2072 6574 h time. The ret │ │ │ │ +000112f0: 7572 6e20 7661 6c75 6520 6973 2074 6865 urn value is the │ │ │ │ +00011300: 2065 7869 740a 2020 2020 2073 7461 7475 exit. statu │ │ │ │ +00011310: 7320 6f66 2074 6865 206c 6173 7420 636f s of the last co │ │ │ │ +00011320: 6d6d 616e 6420 7468 6174 2065 7865 6375 mmand that execu │ │ │ │ +00011330: 7465 732e 2020 4966 2074 6865 2065 7870 tes. If the exp │ │ │ │ +00011340: 616e 7369 6f6e 206f 6620 7468 650a 2020 ansion of the. │ │ │ │ +00011350: 2020 2069 7465 6d73 2066 6f6c 6c6f 7769 items followi │ │ │ │ +00011360: 6e67 2027 696e 2720 7265 7375 6c74 7320 ng 'in' results │ │ │ │ +00011370: 696e 2061 6e20 656d 7074 7920 6c69 7374 in an empty list │ │ │ │ +00011380: 2c20 6e6f 2063 6f6d 6d61 6e64 7320 6172 , no commands ar │ │ │ │ +00011390: 650a 2020 2020 2065 7865 6375 7465 642c e. executed, │ │ │ │ +000113a0: 2061 6e64 2074 6865 2072 6574 7572 6e20 and the return │ │ │ │ +000113b0: 7374 6174 7573 2069 7320 302e 0a0a 6966 status is 0...if │ │ │ │ +000113c0: 204c 4953 543b 2074 6865 6e20 4c49 5354 LIST; then LIST │ │ │ │ +000113d0: 3b20 5b65 6c69 6620 4c49 5354 3b20 7468 ; [elif LIST; th │ │ │ │ +000113e0: 656e 204c 4953 543b 5d20 2e2e 2e20 5b65 en LIST;] ... [e │ │ │ │ +000113f0: 6c73 6520 4c49 5354 3b5d 2066 690a 2020 lse LIST;] fi. │ │ │ │ +00011400: 2020 2054 6865 2027 6966 2720 4c49 5354 The 'if' LIST │ │ │ │ +00011410: 2069 7320 6578 6563 7574 6564 2e20 2049 is executed. I │ │ │ │ +00011420: 6620 6974 7320 6578 6974 2073 7461 7475 f its exit statu │ │ │ │ +00011430: 7320 6973 207a 6572 6f2c 2074 6865 2027 s is zero, the ' │ │ │ │ +00011440: 7468 656e 270a 2020 2020 204c 4953 5420 then'. LIST │ │ │ │ +00011450: 6973 2065 7865 6375 7465 642e 2020 4f74 is executed. Ot │ │ │ │ +00011460: 6865 7277 6973 652c 2065 6163 6820 2765 herwise, each 'e │ │ │ │ +00011470: 6c69 6627 204c 4953 5420 6973 2065 7865 lif' LIST is exe │ │ │ │ +00011480: 6375 7465 6420 696e 2074 7572 6e2c 0a20 cuted in turn,. │ │ │ │ +00011490: 2020 2020 616e 6420 6966 2069 7473 2065 and if its e │ │ │ │ +000114a0: 7869 7420 7374 6174 7573 2069 7320 7a65 xit status is ze │ │ │ │ +000114b0: 726f 2c20 7468 6520 636f 7272 6573 706f ro, the correspo │ │ │ │ +000114c0: 6e64 696e 6720 2774 6865 6e27 204c 4953 nding 'then' LIS │ │ │ │ +000114d0: 5420 6973 0a20 2020 2020 6578 6563 7574 T is. execut │ │ │ │ +000114e0: 6564 2061 6e64 2074 6865 2063 6f6d 6d61 ed and the comma │ │ │ │ +000114f0: 6e64 2063 6f6d 706c 6574 6573 2e20 204f nd completes. O │ │ │ │ +00011500: 7468 6572 7769 7365 2c20 7468 6520 2765 therwise, the 'e │ │ │ │ +00011510: 6c73 6527 204c 4953 5420 6973 0a20 2020 lse' LIST is. │ │ │ │ +00011520: 2020 6578 6563 7574 6564 2c20 6966 2070 executed, if p │ │ │ │ +00011530: 7265 7365 6e74 2e20 2054 6865 2065 7869 resent. The exi │ │ │ │ +00011540: 7420 7374 6174 7573 2069 7320 7468 6520 t status is the │ │ │ │ +00011550: 6578 6974 2073 7461 7475 7320 6f66 2074 exit status of t │ │ │ │ +00011560: 6865 0a20 2020 2020 6c61 7374 2063 6f6d he. last com │ │ │ │ +00011570: 6d61 6e64 2065 7865 6375 7465 642c 206f mand executed, o │ │ │ │ +00011580: 7220 7a65 726f 2069 6620 6e6f 2063 6f6e r zero if no con │ │ │ │ +00011590: 6469 7469 6f6e 2074 6573 7465 6420 7472 dition tested tr │ │ │ │ +000115a0: 7565 2e0a 0a77 6869 6c65 2043 4f4e 443b ue...while COND; │ │ │ │ +000115b0: 2064 6f20 4c49 5354 3b20 646f 6e65 0a75 do LIST; done.u │ │ │ │ +000115c0: 6e74 696c 2043 4f4e 443b 2064 6f20 4c49 ntil COND; do LI │ │ │ │ +000115d0: 5354 3b20 646f 6e65 0a20 2020 2020 5468 ST; done. Th │ │ │ │ +000115e0: 6520 2777 6869 6c65 2720 636f 6d6d 616e e 'while' comman │ │ │ │ +000115f0: 6420 636f 6e74 696e 756f 7573 6c79 2065 d continuously e │ │ │ │ +00011600: 7865 6375 7465 7320 7468 6520 2764 6f27 xecutes the 'do' │ │ │ │ +00011610: 204c 4953 5420 6173 206c 6f6e 6720 6173 LIST as long as │ │ │ │ +00011620: 0a20 2020 2020 7468 6520 6c61 7374 2063 . the last c │ │ │ │ +00011630: 6f6d 6d61 6e64 2069 6e20 434f 4e44 2072 ommand in COND r │ │ │ │ +00011640: 6574 7572 6e73 2061 6e20 6578 6974 2073 eturns an exit s │ │ │ │ +00011650: 7461 7475 7320 6f66 207a 6572 6f2e 2020 tatus of zero. │ │ │ │ +00011660: 5468 650a 2020 2020 2027 756e 7469 6c27 The. 'until' │ │ │ │ +00011670: 2063 6f6d 6d61 6e64 2069 7320 6964 656e command is iden │ │ │ │ +00011680: 7469 6361 6c20 746f 2074 6865 2027 7768 tical to the 'wh │ │ │ │ +00011690: 696c 6527 2063 6f6d 6d61 6e64 2c20 6578 ile' command, ex │ │ │ │ +000116a0: 6365 7074 2074 6861 740a 2020 2020 2074 cept that. t │ │ │ │ +000116b0: 6865 2074 6573 7420 6973 206e 6567 6174 he test is negat │ │ │ │ +000116c0: 6564 3b20 7468 6520 2764 6f27 204c 4953 ed; the 'do' LIS │ │ │ │ +000116d0: 5420 6973 2065 7865 6375 7465 6420 6173 T is executed as │ │ │ │ +000116e0: 206c 6f6e 6720 6173 2074 6865 206c 6173 long as the las │ │ │ │ +000116f0: 740a 2020 2020 2063 6f6d 6d61 6e64 2069 t. command i │ │ │ │ +00011700: 6e20 434f 4e44 2072 6574 7572 6e73 2061 n COND returns a │ │ │ │ +00011710: 206e 6f6e 2d7a 6572 6f20 6578 6974 2073 non-zero exit s │ │ │ │ +00011720: 7461 7475 732e 2020 5468 6520 6578 6974 tatus. The exit │ │ │ │ +00011730: 2073 7461 7475 7320 6f66 0a20 2020 2020 status of. │ │ │ │ +00011740: 7468 6520 2777 6869 6c65 2720 616e 6420 the 'while' and │ │ │ │ +00011750: 2775 6e74 696c 2720 636f 6d6d 616e 6473 'until' commands │ │ │ │ +00011760: 2069 7320 7468 6520 6578 6974 2073 7461 is the exit sta │ │ │ │ +00011770: 7475 7320 6f66 2074 6865 206c 6173 740a tus of the last. │ │ │ │ +00011780: 2020 2020 2027 646f 2720 4c49 5354 2063 'do' LIST c │ │ │ │ +00011790: 6f6d 6d61 6e64 2065 7865 6375 7465 642c ommand executed, │ │ │ │ +000117a0: 206f 7220 7a65 726f 2069 6620 6e6f 6e65 or zero if none │ │ │ │ +000117b0: 2077 6173 2065 7865 6375 7465 642e 0a0a was executed... │ │ │ │ +000117c0: 6675 6e63 7469 6f6e 204e 414d 4520 7b20 function NAME { │ │ │ │ +000117d0: 434f 4d4d 414e 443b 202e 2e2e 207d 0a20 COMMAND; ... }. │ │ │ │ +000117e0: 2020 2020 5468 6973 2064 6566 696e 6573 This defines │ │ │ │ +000117f0: 2061 2066 756e 6374 696f 6e20 6e61 6d65 a function name │ │ │ │ +00011800: 6420 4e41 4d45 2e20 2054 6865 2022 626f d NAME. The "bo │ │ │ │ +00011810: 6479 2220 6f66 2074 6865 2066 756e 6374 dy" of the funct │ │ │ │ +00011820: 696f 6e20 6973 0a20 2020 2020 7468 6520 ion is. the │ │ │ │ +00011830: 6c69 7374 206f 6620 636f 6d6d 616e 6473 list of commands │ │ │ │ +00011840: 2077 6974 6869 6e20 6272 6163 6573 2c20 within braces, │ │ │ │ +00011850: 6561 6368 206f 6620 7768 6963 6820 6d75 each of which mu │ │ │ │ +00011860: 7374 2062 650a 2020 2020 2074 6572 6d69 st be. termi │ │ │ │ +00011870: 6e61 7465 6420 7769 7468 2061 2073 656d nated with a sem │ │ │ │ +00011880: 6963 6f6c 6f6e 206f 7220 6120 6e65 776c icolon or a newl │ │ │ │ +00011890: 696e 652e 2020 5468 6973 206c 6973 7420 ine. This list │ │ │ │ +000118a0: 6f66 2063 6f6d 6d61 6e64 730a 2020 2020 of commands. │ │ │ │ +000118b0: 2077 696c 6c20 6265 2065 7865 6375 7465 will be execute │ │ │ │ +000118c0: 6420 7768 656e 6576 6572 204e 414d 4520 d whenever NAME │ │ │ │ +000118d0: 6973 2073 7065 6369 6669 6564 2061 7320 is specified as │ │ │ │ +000118e0: 7468 6520 6e61 6d65 206f 6620 6120 7369 the name of a si │ │ │ │ +000118f0: 6d70 6c65 0a20 2020 2020 636f 6d6d 616e mple. comman │ │ │ │ +00011900: 642e 2020 4675 6e63 7469 6f6e 2064 6566 d. Function def │ │ │ │ +00011910: 696e 6974 696f 6e73 2064 6f20 6e6f 7420 initions do not │ │ │ │ +00011920: 6166 6665 6374 2074 6865 2065 7869 7420 affect the exit │ │ │ │ +00011930: 7374 6174 7573 2069 6e0a 2020 2020 2027 status in. ' │ │ │ │ +00011940: 243f 272e 2020 5768 656e 2065 7865 6375 $?'. When execu │ │ │ │ +00011950: 7465 642c 2074 6865 2065 7869 7420 7374 ted, the exit st │ │ │ │ +00011960: 6174 7573 206f 6620 6120 6675 6e63 7469 atus of a functi │ │ │ │ +00011970: 6f6e 2069 7320 7468 6520 6578 6974 0a20 on is the exit. │ │ │ │ +00011980: 2020 2020 7374 6174 7573 206f 6620 7468 status of th │ │ │ │ +00011990: 6520 6c61 7374 2063 6f6d 6d61 6e64 2065 e last command e │ │ │ │ +000119a0: 7865 6375 7465 6420 696e 2074 6865 2062 xecuted in the b │ │ │ │ +000119b0: 6f64 792e 0a0a 6d65 6e75 656e 7472 7920 ody...menuentry │ │ │ │ +000119c0: 5449 544c 4520 5b27 2d2d 636c 6173 733d TITLE ['--class= │ │ │ │ +000119d0: 636c 6173 7327 202e 2e2e 5d20 5b27 2d2d class' ...] ['-- │ │ │ │ +000119e0: 7573 6572 733d 7573 6572 7327 5d20 5b27 users=users'] [' │ │ │ │ +000119f0: 2d2d 756e 7265 7374 7269 6374 6564 275d --unrestricted'] │ │ │ │ +00011a00: 205b 272d 2d68 6f74 6b65 793d 6b65 7927 ['--hotkey=key' │ │ │ │ +00011a10: 5d20 5b27 2d2d 6964 3d69 6427 5d20 7b20 ] ['--id=id'] { │ │ │ │ +00011a20: 434f 4d4d 414e 443b 202e 2e2e 207d 0a20 COMMAND; ... }. │ │ │ │ +00011a30: 2020 2020 2a4e 6f74 6520 6d65 6e75 656e *Note menuen │ │ │ │ +00011a40: 7472 793a 3a2e 0a0a 4275 696c 742d 696e try::...Built-in │ │ │ │ +00011a50: 2043 6f6d 6d61 6e64 730a 3d3d 3d3d 3d3d Commands.====== │ │ │ │ +00011a60: 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a53 6f6d ===========..Som │ │ │ │ +00011a70: 6520 6275 696c 742d 696e 2063 6f6d 6d61 e built-in comma │ │ │ │ +00011a80: 6e64 7320 6172 6520 616c 736f 2070 726f nds are also pro │ │ │ │ +00011a90: 7669 6465 6420 6279 2047 5255 4220 7363 vided by GRUB sc │ │ │ │ +00011aa0: 7269 7074 2074 6f20 6865 6c70 2073 6372 ript to help scr │ │ │ │ +00011ab0: 6970 740a 7772 6974 6572 7320 7065 7266 ipt.writers perf │ │ │ │ +00011ac0: 6f72 6d20 6163 7469 6f6e 7320 7468 6174 orm actions that │ │ │ │ +00011ad0: 2061 7265 206f 7468 6572 7769 7365 206e are otherwise n │ │ │ │ +00011ae0: 6f74 2070 6f73 7369 626c 652e 2020 466f ot possible. Fo │ │ │ │ +00011af0: 7220 6578 616d 706c 652c 0a74 6865 7365 r example,.these │ │ │ │ +00011b00: 2069 6e63 6c75 6465 2063 6f6d 6d61 6e64 include command │ │ │ │ +00011b10: 7320 746f 206a 756d 7020 6f75 7420 6f66 s to jump out of │ │ │ │ +00011b20: 2061 206c 6f6f 7020 7769 7468 6f75 7420 a loop without │ │ │ │ +00011b30: 6675 6c6c 7920 636f 6d70 6c65 7469 6e67 fully completing │ │ │ │ +00011b40: 0a69 742c 2065 7463 2e0a 0a62 7265 616b .it, etc...break │ │ │ │ +00011b50: 205b 276e 275d 0a20 2020 2020 4578 6974 ['n']. Exit │ │ │ │ +00011b60: 2066 726f 6d20 7769 7468 696e 2061 2027 from within a ' │ │ │ │ +00011b70: 666f 7227 2c20 2777 6869 6c65 272c 206f for', 'while', o │ │ │ │ +00011b80: 7220 2775 6e74 696c 2720 6c6f 6f70 2e20 r 'until' loop. │ │ │ │ +00011b90: 2049 6620 276e 2720 6973 0a20 2020 2020 If 'n' is. │ │ │ │ +00011ba0: 7370 6563 6966 6965 642c 2062 7265 616b specified, break │ │ │ │ +00011bb0: 2027 6e27 206c 6576 656c 732e 2020 276e 'n' levels. 'n │ │ │ │ +00011bc0: 2720 6d75 7374 2062 6520 6772 6561 7465 ' must be greate │ │ │ │ +00011bd0: 7220 7468 616e 206f 7220 6571 7561 6c20 r than or equal │ │ │ │ +00011be0: 746f 0a20 2020 2020 312e 2020 4966 2027 to. 1. If ' │ │ │ │ +00011bf0: 6e27 2069 7320 6772 6561 7465 7220 7468 n' is greater th │ │ │ │ +00011c00: 616e 2074 6865 206e 756d 6265 7220 6f66 an the number of │ │ │ │ +00011c10: 2065 6e63 6c6f 7369 6e67 206c 6f6f 7073 enclosing loops │ │ │ │ +00011c20: 2c20 616c 6c0a 2020 2020 2065 6e63 6c6f , all. enclo │ │ │ │ +00011c30: 7369 6e67 206c 6f6f 7073 2061 7265 2065 sing loops are e │ │ │ │ +00011c40: 7869 7465 642e 2020 5468 6520 7265 7475 xited. The retu │ │ │ │ +00011c50: 726e 2076 616c 7565 2069 7320 3020 756e rn value is 0 un │ │ │ │ +00011c60: 6c65 7373 2027 6e27 2069 730a 2020 2020 less 'n' is. │ │ │ │ +00011c70: 206e 6f74 2067 7265 6174 6572 2074 6861 not greater tha │ │ │ │ +00011c80: 6e20 6f72 2065 7175 616c 2074 6f20 312e n or equal to 1. │ │ │ │ +00011c90: 0a0a 636f 6e74 696e 7565 205b 276e 275d ..continue ['n'] │ │ │ │ +00011ca0: 0a20 2020 2020 5265 7375 6d65 2074 6865 . Resume the │ │ │ │ +00011cb0: 206e 6578 7420 6974 6572 6174 696f 6e20 next iteration │ │ │ │ +00011cc0: 6f66 2074 6865 2065 6e63 6c6f 7369 6e67 of the enclosing │ │ │ │ +00011cd0: 2027 666f 7227 2c20 2777 6869 6c65 2720 'for', 'while' │ │ │ │ +00011ce0: 6f72 0a20 2020 2020 2775 6e74 696c 2720 or. 'until' │ │ │ │ +00011cf0: 6c6f 6f70 2e20 2049 6620 276e 2720 6973 loop. If 'n' is │ │ │ │ +00011d00: 2073 7065 6369 6669 6564 2c20 7265 7375 specified, resu │ │ │ │ +00011d10: 6d65 2061 7420 7468 6520 276e 2774 6820 me at the 'n'th │ │ │ │ +00011d20: 656e 636c 6f73 696e 670a 2020 2020 206c enclosing. l │ │ │ │ +00011d30: 6f6f 702e 2020 276e 2720 6d75 7374 2062 oop. 'n' must b │ │ │ │ +00011d40: 6520 6772 6561 7465 7220 7468 616e 206f e greater than o │ │ │ │ +00011d50: 7220 6571 7561 6c20 746f 2031 2e20 2049 r equal to 1. I │ │ │ │ +00011d60: 6620 276e 2720 6973 2067 7265 6174 6572 f 'n' is greater │ │ │ │ +00011d70: 0a20 2020 2020 7468 616e 2074 6865 206e . than the n │ │ │ │ +00011d80: 756d 6265 7220 6f66 2065 6e63 6c6f 7369 umber of enclosi │ │ │ │ +00011d90: 6e67 206c 6f6f 7073 2c20 7468 6520 6c61 ng loops, the la │ │ │ │ +00011da0: 7374 2065 6e63 6c6f 7369 6e67 206c 6f6f st enclosing loo │ │ │ │ +00011db0: 7020 2874 6865 0a20 2020 2020 2274 6f70 p (the. "top │ │ │ │ +00011dc0: 2d6c 6576 656c 2220 6c6f 6f70 2920 6973 -level" loop) is │ │ │ │ +00011dd0: 2072 6573 756d 6564 2e20 2054 6865 2072 resumed. The r │ │ │ │ +00011de0: 6574 7572 6e20 7661 6c75 6520 6973 2030 eturn value is 0 │ │ │ │ +00011df0: 2075 6e6c 6573 7320 276e 2720 6973 0a20 unless 'n' is. │ │ │ │ +00011e00: 2020 2020 6e6f 7420 6772 6561 7465 7220 not greater │ │ │ │ +00011e10: 7468 616e 206f 7220 6571 7561 6c20 746f than or equal to │ │ │ │ +00011e20: 2031 2e0a 0a72 6574 7572 6e20 5b27 6e27 1...return ['n' │ │ │ │ +00011e30: 5d0a 2020 2020 2043 6175 7365 7320 6120 ]. Causes a │ │ │ │ +00011e40: 6675 6e63 7469 6f6e 2074 6f20 6578 6974 function to exit │ │ │ │ +00011e50: 2077 6974 6820 7468 6520 7265 7475 726e with the return │ │ │ │ +00011e60: 2076 616c 7565 2073 7065 6369 6669 6564 value specified │ │ │ │ +00011e70: 2062 7920 276e 272e 0a20 2020 2020 4966 by 'n'.. If │ │ │ │ +00011e80: 2027 6e27 2069 7320 6f6d 6974 7465 642c 'n' is omitted, │ │ │ │ +00011e90: 2074 6865 2072 6574 7572 6e20 7374 6174 the return stat │ │ │ │ +00011ea0: 7573 2069 7320 7468 6174 206f 6620 7468 us is that of th │ │ │ │ +00011eb0: 6520 6c61 7374 2063 6f6d 6d61 6e64 0a20 e last command. │ │ │ │ +00011ec0: 2020 2020 6578 6563 7574 6564 2069 6e20 executed in │ │ │ │ +00011ed0: 7468 6520 6675 6e63 7469 6f6e 2062 6f64 the function bod │ │ │ │ +00011ee0: 792e 2020 4966 2075 7365 6420 6f75 7473 y. If used outs │ │ │ │ +00011ef0: 6964 6520 6120 6675 6e63 7469 6f6e 2074 ide a function t │ │ │ │ +00011f00: 6865 0a20 2020 2020 7265 7475 726e 2073 he. return s │ │ │ │ +00011f10: 7461 7475 7320 6973 2066 616c 7365 2e0a tatus is false.. │ │ │ │ +00011f20: 0a73 6574 7061 7261 6d73 205b 2761 7267 .setparams ['arg │ │ │ │ +00011f30: 275d 202e 2e2e 0a20 2020 2020 5265 706c '] .... Repl │ │ │ │ +00011f40: 6163 6520 706f 7369 7469 6f6e 616c 2070 ace positional p │ │ │ │ +00011f50: 6172 616d 6574 6572 7320 7374 6172 7469 arameters starti │ │ │ │ +00011f60: 6e67 2077 6974 6820 2724 3127 2077 6974 ng with '$1' wit │ │ │ │ +00011f70: 6820 6172 6775 6d65 6e74 7320 746f 0a20 h arguments to. │ │ │ │ +00011f80: 2020 2020 2773 6574 7061 7261 6d73 272e 'setparams'. │ │ │ │ +00011f90: 0a0a 7368 6966 7420 5b27 6e27 5d0a 2020 ..shift ['n']. │ │ │ │ +00011fa0: 2020 2054 6865 2070 6f73 6974 696f 6e61 The positiona │ │ │ │ +00011fb0: 6c20 7061 7261 6d65 7465 7273 2066 726f l parameters fro │ │ │ │ +00011fc0: 6d20 276e 272b 3120 2e2e 2e20 6172 6520 m 'n'+1 ... are │ │ │ │ +00011fd0: 7265 6e61 6d65 6420 746f 2027 2431 272e renamed to '$1'. │ │ │ │ +00011fe0: 2e2e 2e0a 2020 2020 2050 6172 616d 6574 .... Paramet │ │ │ │ +00011ff0: 6572 7320 7265 7072 6573 656e 7465 6420 ers represented │ │ │ │ +00012000: 6279 2074 6865 206e 756d 6265 7273 2027 by the numbers ' │ │ │ │ +00012010: 2423 2720 646f 776e 2074 6f20 2724 2327 $#' down to '$#' │ │ │ │ +00012020: 2d27 6e27 2b31 2061 7265 0a20 2020 2020 -'n'+1 are. │ │ │ │ +00012030: 756e 7365 742e 2020 276e 2720 6d75 7374 unset. 'n' must │ │ │ │ +00012040: 2062 6520 6120 6e6f 6e2d 6e65 6761 7469 be a non-negati │ │ │ │ +00012050: 7665 206e 756d 6265 7220 6c65 7373 2074 ve number less t │ │ │ │ +00012060: 6861 6e20 6f72 2065 7175 616c 2074 6f0a han or equal to. │ │ │ │ +00012070: 2020 2020 2027 2423 272e 2020 4966 2027 '$#'. If ' │ │ │ │ +00012080: 6e27 2069 7320 302c 206e 6f20 7061 7261 n' is 0, no para │ │ │ │ +00012090: 6d65 7465 7273 2061 7265 2063 6861 6e67 meters are chang │ │ │ │ +000120a0: 6564 2e20 2049 6620 276e 2720 6973 206e ed. If 'n' is n │ │ │ │ +000120b0: 6f74 0a20 2020 2020 6769 7665 6e2c 2069 ot. given, i │ │ │ │ +000120c0: 7420 6973 2061 7373 756d 6564 2074 6f20 t is assumed to │ │ │ │ +000120d0: 6265 2031 2e20 2049 6620 276e 2720 6973 be 1. If 'n' is │ │ │ │ +000120e0: 2067 7265 6174 6572 2074 6861 6e20 2724 greater than '$ │ │ │ │ +000120f0: 2327 2c20 7468 650a 2020 2020 2070 6f73 #', the. pos │ │ │ │ +00012100: 6974 696f 6e61 6c20 7061 7261 6d65 7465 itional paramete │ │ │ │ +00012110: 7273 2061 7265 206e 6f74 2063 6861 6e67 rs are not chang │ │ │ │ +00012120: 6564 2e20 2054 6865 2072 6574 7572 6e20 ed. The return │ │ │ │ +00012130: 7374 6174 7573 2069 730a 2020 2020 2067 status is. g │ │ │ │ +00012140: 7265 6174 6572 2074 6861 6e20 7a65 726f reater than zero │ │ │ │ +00012150: 2069 6620 276e 2720 6973 2067 7265 6174 if 'n' is great │ │ │ │ +00012160: 6572 2074 6861 6e20 2724 2327 206f 7220 er than '$#' or │ │ │ │ +00012170: 6c65 7373 2074 6861 6e20 7a65 726f 3b0a less than zero;. │ │ │ │ +00012180: 2020 2020 206f 7468 6572 7769 7365 2030 otherwise 0 │ │ │ │ +00012190: 2e0a 0a1f 0a46 696c 653a 2067 7275 622e .....File: grub. │ │ │ │ +000121a0: 696e 666f 2c20 204e 6f64 653a 2053 6865 info, Node: She │ │ │ │ +000121b0: 6c6c 2d6c 696b 6520 7363 7269 7074 696e ll-like scriptin │ │ │ │ +000121c0: 672d 466f 6f74 6e6f 7465 732c 2020 5570 g-Footnotes, Up │ │ │ │ +000121d0: 3a20 5368 656c 6c2d 6c69 6b65 2073 6372 : Shell-like scr │ │ │ │ +000121e0: 6970 7469 6e67 0a0a 2020 2028 3129 2043 ipting.. (1) C │ │ │ │ +000121f0: 7572 7265 6e74 6c79 2061 2062 6163 6b73 urrently a backs │ │ │ │ +00012200: 6c61 7368 2d6e 6577 6c69 6e65 2070 6169 lash-newline pai │ │ │ │ +00012210: 7220 7769 7468 696e 2061 2076 6172 6961 r within a varia │ │ │ │ +00012220: 626c 6520 6e61 6d65 2069 7320 6e6f 740a ble name is not. │ │ │ │ +00012230: 6861 6e64 6c65 6420 7072 6f70 6572 6c79 handled properly │ │ │ │ +00012240: 2c20 736f 2075 7365 2074 6869 7320 6665 , so use this fe │ │ │ │ +00012250: 6174 7572 6520 7769 7468 2073 6f6d 6520 ature with some │ │ │ │ +00012260: 6361 7265 2e0a 0a1f 0a46 696c 653a 2067 care.....File: g │ │ │ │ +00012270: 7275 622e 696e 666f 2c20 204e 6f64 653a rub.info, Node: │ │ │ │ +00012280: 204d 756c 7469 2d62 6f6f 7420 6d61 6e75 Multi-boot manu │ │ │ │ +00012290: 616c 2063 6f6e 6669 672c 2020 4e65 7874 al config, Next │ │ │ │ +000122a0: 3a20 456d 6265 6464 6564 2063 6f6e 6669 : Embedded confi │ │ │ │ +000122b0: 6775 7261 7469 6f6e 2c20 2050 7265 763a guration, Prev: │ │ │ │ +000122c0: 2053 6865 6c6c 2d6c 696b 6520 7363 7269 Shell-like scri │ │ │ │ +000122d0: 7074 696e 672c 2020 5570 3a20 436f 6e66 pting, Up: Conf │ │ │ │ +000122e0: 6967 7572 6174 696f 6e0a 0a36 2e34 204d iguration..6.4 M │ │ │ │ +000122f0: 756c 7469 2d62 6f6f 7420 6d61 6e75 616c ulti-boot manual │ │ │ │ +00012300: 2063 6f6e 6669 670a 3d3d 3d3d 3d3d 3d3d config.======== │ │ │ │ 00012310: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ -00012320: 0a0a 4375 7272 656e 746c 7920 6175 746f ..Currently auto │ │ │ │ -00012330: 6765 6e65 7261 7469 6e67 2063 6f6e 6669 generating confi │ │ │ │ -00012340: 6720 6669 6c65 7320 666f 7220 6d75 6c74 g files for mult │ │ │ │ -00012350: 692d 626f 6f74 2065 6e76 6972 6f6e 6d65 i-boot environme │ │ │ │ -00012360: 6e74 730a 6465 7065 6e64 7320 6f6e 206f nts.depends on o │ │ │ │ -00012370: 732d 7072 6f62 6572 2061 6e64 2068 6173 s-prober and has │ │ │ │ -00012380: 2073 6576 6572 616c 2073 686f 7274 636f several shortco │ │ │ │ -00012390: 6d69 6e67 732e 2020 5768 696c 6520 6669 mings. While fi │ │ │ │ -000123a0: 7869 6e67 2069 7420 6973 0a73 6368 6564 xing it is.sched │ │ │ │ -000123b0: 756c 6564 2066 6f72 2074 6865 206e 6578 uled for the nex │ │ │ │ -000123c0: 7420 7265 6c65 6173 652c 206d 6561 6e77 t release, meanw │ │ │ │ -000123d0: 6869 6c65 2079 6f75 2063 616e 206d 616b hile you can mak │ │ │ │ -000123e0: 6520 7573 6520 6f66 2074 6865 2070 6f77 e use of the pow │ │ │ │ -000123f0: 6572 0a6f 6620 4752 5542 2073 796e 7461 er.of GRUB synta │ │ │ │ -00012400: 7820 616e 6420 646f 2069 7420 796f 7572 x and do it your │ │ │ │ -00012410: 7365 6c66 2e20 2041 2070 6f73 7369 626c self. A possibl │ │ │ │ -00012420: 6520 636f 6e66 6967 7572 6174 696f 6e20 e configuration │ │ │ │ -00012430: 6973 2064 6574 6169 6c65 640a 6865 7265 is detailed.here │ │ │ │ -00012440: 2c20 6665 656c 2066 7265 6520 746f 2061 , feel free to a │ │ │ │ -00012450: 646a 7573 7420 746f 2079 6f75 7220 6e65 djust to your ne │ │ │ │ -00012460: 6564 732e 0a0a 2020 2046 6972 7374 2063 eds... First c │ │ │ │ -00012470: 7265 6174 6520 6120 7365 7061 7261 7465 reate a separate │ │ │ │ -00012480: 2047 5255 4220 7061 7274 6974 696f 6e2c GRUB partition, │ │ │ │ -00012490: 2062 6967 2065 6e6f 7567 6820 746f 2068 big enough to h │ │ │ │ -000124a0: 6f6c 6420 4752 5542 2e20 536f 6d65 0a6f old GRUB. Some.o │ │ │ │ -000124b0: 6620 7468 6520 666f 6c6c 6f77 696e 6720 f the following │ │ │ │ -000124c0: 656e 7472 6965 7320 7368 6f77 2068 6f77 entries show how │ │ │ │ -000124d0: 2074 6f20 6c6f 6164 204f 5320 696e 7374 to load OS inst │ │ │ │ -000124e0: 616c 6c65 7220 696d 6167 6573 2066 726f aller images fro │ │ │ │ -000124f0: 6d20 7468 6973 0a73 616d 6520 7061 7274 m this.same part │ │ │ │ -00012500: 6974 696f 6e2c 2066 6f72 2074 6861 7420 ition, for that │ │ │ │ -00012510: 796f 7520 6f62 7669 6f75 736c 7920 6e65 you obviously ne │ │ │ │ -00012520: 6564 2074 6f20 6d61 6b65 2074 6865 2070 ed to make the p │ │ │ │ -00012530: 6172 7469 7469 6f6e 206c 6172 6765 0a65 artition large.e │ │ │ │ -00012540: 6e6f 7567 6820 746f 2068 6f6c 6420 7468 nough to hold th │ │ │ │ -00012550: 6f73 6520 696d 6167 6573 2061 7320 7765 ose images as we │ │ │ │ -00012560: 6c6c 2e20 204d 6f75 6e74 2074 6869 7320 ll. Mount this │ │ │ │ -00012570: 7061 7274 6974 696f 6e20 6f6e 2f6d 6e74 partition on/mnt │ │ │ │ -00012580: 2f62 6f6f 740a 616e 6420 6469 7361 626c /boot.and disabl │ │ │ │ -00012590: 6520 4752 5542 2069 6e20 616c 6c20 4f53 e GRUB in all OS │ │ │ │ -000125a0: 6573 2061 6e64 206d 616e 7561 6c6c 7920 es and manually │ │ │ │ -000125b0: 696e 7374 616c 6c20 7365 6c66 2d63 6f6d install self-com │ │ │ │ -000125c0: 7069 6c65 6420 6c61 7465 7374 0a47 5255 piled latest.GRU │ │ │ │ -000125d0: 4220 7769 7468 3a0a 0a20 2020 2767 7275 B with:.. 'gru │ │ │ │ -000125e0: 622d 696e 7374 616c 6c20 2d2d 626f 6f74 b-install --boot │ │ │ │ -000125f0: 2d64 6972 6563 746f 7279 3d2f 6d6e 742f -directory=/mnt/ │ │ │ │ -00012600: 626f 6f74 202f 6465 762f 7364 6127 0a0a boot /dev/sda'.. │ │ │ │ -00012610: 2020 2049 6e20 616c 6c20 7468 6520 4f53 In all the OS │ │ │ │ -00012620: 6573 2069 6e73 7461 6c6c 2047 5255 4220 es install GRUB │ │ │ │ -00012630: 746f 6f6c 7320 6275 7420 6469 7361 626c tools but disabl │ │ │ │ -00012640: 6520 696e 7374 616c 6c69 6e67 2047 5255 e installing GRU │ │ │ │ -00012650: 4220 696e 0a62 6f6f 7473 6563 746f 722c B in.bootsector, │ │ │ │ -00012660: 2073 6f20 796f 7527 6c6c 2068 6176 6520 so you'll have │ │ │ │ -00012670: 6d65 6e75 2e6c 7374 2061 6e64 2067 7275 menu.lst and gru │ │ │ │ -00012680: 622e 6366 6720 6176 6169 6c61 626c 6520 b.cfg available │ │ │ │ -00012690: 666f 7220 7573 652e 0a41 6c73 6f20 6469 for use..Also di │ │ │ │ -000126a0: 7361 626c 6520 6f73 2d70 726f 6265 7220 sable os-prober │ │ │ │ -000126b0: 7573 6520 6279 2073 6574 7469 6e67 3a0a use by setting:. │ │ │ │ -000126c0: 0a20 2020 2747 5255 425f 4449 5341 424c . 'GRUB_DISABL │ │ │ │ -000126d0: 455f 4f53 5f50 524f 4245 523d 7472 7565 E_OS_PROBER=true │ │ │ │ -000126e0: 270a 0a20 2020 696e 202f 6574 632f 6465 '.. in /etc/de │ │ │ │ -000126f0: 6661 756c 742f 6772 7562 0a0a 2020 2054 fault/grub.. T │ │ │ │ -00012700: 6865 6e20 7772 6974 6520 6120 6772 7562 hen write a grub │ │ │ │ -00012710: 2e63 6667 2028 2f6d 6e74 2f62 6f6f 742f .cfg (/mnt/boot/ │ │ │ │ -00012720: 6772 7562 2f67 7275 622e 6366 6729 3a0a grub/grub.cfg):. │ │ │ │ -00012730: 0a0a 2020 2020 206d 656e 7565 6e74 7279 .. menuentry │ │ │ │ -00012740: 2022 4f53 2075 7369 6e67 2067 7275 6232 "OS using grub2 │ │ │ │ -00012750: 2220 7b0a 2020 2020 2020 2020 696e 736d " {. insm │ │ │ │ -00012760: 6f64 2078 6673 0a20 2020 2020 2020 2073 od xfs. s │ │ │ │ -00012770: 6561 7263 6820 2d2d 7365 743d 726f 6f74 earch --set=root │ │ │ │ -00012780: 202d 2d6c 6162 656c 204f 5331 202d 2d68 --label OS1 --h │ │ │ │ -00012790: 696e 7420 6864 302c 6d73 646f 7338 0a20 int hd0,msdos8. │ │ │ │ -000127a0: 2020 2020 2020 2063 6f6e 6669 6766 696c configfil │ │ │ │ -000127b0: 6520 2f62 6f6f 742f 6772 7562 2f67 7275 e /boot/grub/gru │ │ │ │ -000127c0: 622e 6366 670a 2020 2020 207d 0a0a 2020 b.cfg. }.. │ │ │ │ -000127d0: 2020 206d 656e 7565 6e74 7279 2022 4f53 menuentry "OS │ │ │ │ -000127e0: 2075 7369 6e67 2067 7275 6232 2d6c 6567 using grub2-leg │ │ │ │ -000127f0: 6163 7922 207b 0a20 2020 2020 2020 2069 acy" {. i │ │ │ │ -00012800: 6e73 6d6f 6420 6578 7432 0a20 2020 2020 nsmod ext2. │ │ │ │ -00012810: 2020 2073 6561 7263 6820 2d2d 7365 743d search --set= │ │ │ │ -00012820: 726f 6f74 202d 2d6c 6162 656c 204f 5332 root --label OS2 │ │ │ │ -00012830: 202d 2d68 696e 7420 6864 302c 6d73 646f --hint hd0,msdo │ │ │ │ -00012840: 7336 0a20 2020 2020 2020 206c 6567 6163 s6. legac │ │ │ │ -00012850: 795f 636f 6e66 6967 6669 6c65 202f 626f y_configfile /bo │ │ │ │ -00012860: 6f74 2f67 7275 622f 6d65 6e75 2e6c 7374 ot/grub/menu.lst │ │ │ │ -00012870: 0a20 2020 2020 7d0a 0a20 2020 2020 6d65 . }.. me │ │ │ │ -00012880: 6e75 656e 7472 7920 2257 696e 646f 7773 nuentry "Windows │ │ │ │ -00012890: 2058 5022 207b 0a20 2020 2020 2020 2069 XP" {. i │ │ │ │ -000128a0: 6e73 6d6f 6420 6e74 6673 0a20 2020 2020 nsmod ntfs. │ │ │ │ -000128b0: 2020 2073 6561 7263 6820 2d2d 7365 743d search --set= │ │ │ │ -000128c0: 726f 6f74 202d 2d6c 6162 656c 2057 494e root --label WIN │ │ │ │ -000128d0: 444f 5753 5f58 5020 2d2d 6869 6e74 2068 DOWS_XP --hint h │ │ │ │ -000128e0: 6430 2c6d 7364 6f73 310a 2020 2020 2020 d0,msdos1. │ │ │ │ -000128f0: 2020 6e74 6c64 7220 2f6e 746c 6472 0a20 ntldr /ntldr. │ │ │ │ -00012900: 2020 2020 7d0a 0a20 2020 2020 6d65 6e75 }.. menu │ │ │ │ -00012910: 656e 7472 7920 2257 696e 646f 7773 2037 entry "Windows 7 │ │ │ │ -00012920: 2220 7b0a 2020 2020 2020 2020 696e 736d " {. insm │ │ │ │ -00012930: 6f64 206e 7466 730a 2020 2020 2020 2020 od ntfs. │ │ │ │ -00012940: 7365 6172 6368 202d 2d73 6574 3d72 6f6f search --set=roo │ │ │ │ -00012950: 7420 2d2d 6c61 6265 6c20 5749 4e44 4f57 t --label WINDOW │ │ │ │ -00012960: 535f 3720 2d2d 6869 6e74 2068 6430 2c6d S_7 --hint hd0,m │ │ │ │ -00012970: 7364 6f73 320a 2020 2020 2020 2020 6e74 sdos2. nt │ │ │ │ -00012980: 6c64 7220 2f62 6f6f 746d 6772 0a20 2020 ldr /bootmgr. │ │ │ │ -00012990: 2020 7d0a 0a20 2020 2020 6d65 6e75 656e }.. menuen │ │ │ │ -000129a0: 7472 7920 2246 7265 6542 5344 2220 7b0a try "FreeBSD" {. │ │ │ │ -000129b0: 2020 2020 2020 2020 2020 2020 2020 2069 i │ │ │ │ -000129c0: 6e73 6d6f 6420 7a66 730a 2020 2020 2020 nsmod zfs. │ │ │ │ -000129d0: 2020 2020 2020 2020 2073 6561 7263 6820 search │ │ │ │ -000129e0: 2d2d 7365 743d 726f 6f74 202d 2d6c 6162 --set=root --lab │ │ │ │ -000129f0: 656c 2066 7265 6570 6f6f 6c20 2d2d 6869 el freepool --hi │ │ │ │ -00012a00: 6e74 2068 6430 2c6d 7364 6f73 370a 2020 nt hd0,msdos7. │ │ │ │ -00012a10: 2020 2020 2020 2020 2020 2020 206b 6672 kfr │ │ │ │ -00012a20: 6565 6273 6420 2f66 7265 6562 7364 402f eebsd /freebsd@/ │ │ │ │ -00012a30: 626f 6f74 2f6b 6572 6e65 6c2f 6b65 726e boot/kernel/kern │ │ │ │ -00012a40: 656c 0a20 2020 2020 2020 2020 2020 2020 el. │ │ │ │ -00012a50: 2020 6b66 7265 6562 7364 5f6d 6f64 756c kfreebsd_modul │ │ │ │ -00012a60: 655f 656c 6620 2f66 7265 6562 7364 402f e_elf /freebsd@/ │ │ │ │ -00012a70: 626f 6f74 2f6b 6572 6e65 6c2f 6f70 656e boot/kernel/open │ │ │ │ -00012a80: 736f 6c61 7269 732e 6b6f 0a20 2020 2020 solaris.ko. │ │ │ │ -00012a90: 2020 2020 2020 2020 2020 6b66 7265 6562 kfreeb │ │ │ │ -00012aa0: 7364 5f6d 6f64 756c 655f 656c 6620 2f66 sd_module_elf /f │ │ │ │ -00012ab0: 7265 6562 7364 402f 626f 6f74 2f6b 6572 reebsd@/boot/ker │ │ │ │ -00012ac0: 6e65 6c2f 7a66 732e 6b6f 0a20 2020 2020 nel/zfs.ko. │ │ │ │ -00012ad0: 2020 2020 2020 2020 2020 6b66 7265 6562 kfreeb │ │ │ │ -00012ae0: 7364 5f6d 6f64 756c 6520 2f66 7265 6562 sd_module /freeb │ │ │ │ -00012af0: 7364 402f 626f 6f74 2f7a 6673 2f7a 706f sd@/boot/zfs/zpo │ │ │ │ -00012b00: 6f6c 2e63 6163 6865 2074 7970 653d 2f62 ol.cache type=/b │ │ │ │ -00012b10: 6f6f 742f 7a66 732f 7a70 6f6f 6c2e 6361 oot/zfs/zpool.ca │ │ │ │ -00012b20: 6368 650a 2020 2020 2020 2020 2020 2020 che. │ │ │ │ -00012b30: 2020 2073 6574 206b 4672 6565 4253 442e set kFreeBSD. │ │ │ │ -00012b40: 7666 732e 726f 6f74 2e6d 6f75 6e74 6672 vfs.root.mountfr │ │ │ │ -00012b50: 6f6d 3d7a 6673 3a66 7265 6570 6f6f 6c2f om=zfs:freepool/ │ │ │ │ -00012b60: 6672 6565 6273 640a 2020 2020 2020 2020 freebsd. │ │ │ │ -00012b70: 2020 2020 2020 2073 6574 206b 4672 6565 set kFree │ │ │ │ -00012b80: 4253 442e 6877 2e70 736d 2e73 796e 6170 BSD.hw.psm.synap │ │ │ │ -00012b90: 7469 6373 5f73 7570 706f 7274 3d31 0a20 tics_support=1. │ │ │ │ -00012ba0: 2020 2020 7d0a 0a20 2020 2020 6d65 6e75 }.. menu │ │ │ │ -00012bb0: 656e 7472 7920 2265 7870 6572 696d 656e entry "experimen │ │ │ │ -00012bc0: 7461 6c20 4752 5542 2220 7b0a 2020 2020 tal GRUB" {. │ │ │ │ -00012bd0: 2020 2020 2020 2020 2020 2073 6561 7263 searc │ │ │ │ -00012be0: 6820 2d2d 7365 743d 726f 6f74 202d 2d6c h --set=root --l │ │ │ │ -00012bf0: 6162 656c 2047 5255 4220 2d2d 6869 6e74 abel GRUB --hint │ │ │ │ -00012c00: 2068 6430 2c6d 7364 6f73 350a 2020 2020 hd0,msdos5. │ │ │ │ -00012c10: 2020 2020 2020 2020 2020 206d 756c 7469 multi │ │ │ │ -00012c20: 626f 6f74 202f 6578 7065 7269 6d65 6e74 boot /experiment │ │ │ │ -00012c30: 616c 2f67 7275 622f 6933 3836 2d70 632f al/grub/i386-pc/ │ │ │ │ -00012c40: 636f 7265 2e69 6d67 0a20 2020 2020 7d0a core.img. }. │ │ │ │ -00012c50: 0a20 2020 2020 6d65 6e75 656e 7472 7920 . menuentry │ │ │ │ -00012c60: 2246 6564 6f72 6120 3136 2069 6e73 7461 "Fedora 16 insta │ │ │ │ -00012c70: 6c6c 6572 2220 7b0a 2020 2020 2020 2020 ller" {. │ │ │ │ -00012c80: 2020 2020 2020 2073 6561 7263 6820 2d2d search -- │ │ │ │ -00012c90: 7365 743d 726f 6f74 202d 2d6c 6162 656c set=root --label │ │ │ │ -00012ca0: 2047 5255 4220 2d2d 6869 6e74 2068 6430 GRUB --hint hd0 │ │ │ │ -00012cb0: 2c6d 7364 6f73 350a 2020 2020 2020 2020 ,msdos5. │ │ │ │ -00012cc0: 2020 2020 2020 206c 696e 7578 202f 6665 linux /fe │ │ │ │ -00012cd0: 646f 7261 2f76 6d6c 696e 757a 206c 616e dora/vmlinuz lan │ │ │ │ -00012ce0: 673d 656e 5f55 5320 6b65 796d 6170 3d73 g=en_US keymap=s │ │ │ │ -00012cf0: 6720 7265 736f 6c75 7469 6f6e 3d31 3238 g resolution=128 │ │ │ │ -00012d00: 3078 3830 300a 2020 2020 2020 2020 2020 0x800. │ │ │ │ -00012d10: 2020 2020 2069 6e69 7472 6420 2f66 6564 initrd /fed │ │ │ │ -00012d20: 6f72 612f 696e 6974 7264 2e69 6d67 0a20 ora/initrd.img. │ │ │ │ -00012d30: 2020 2020 7d0a 0a20 2020 2020 6d65 6e75 }.. menu │ │ │ │ -00012d40: 656e 7472 7920 2246 6564 6f72 6120 7261 entry "Fedora ra │ │ │ │ -00012d50: 7768 6964 6520 696e 7374 616c 6c65 7222 whide installer" │ │ │ │ -00012d60: 207b 0a20 2020 2020 2020 2020 2020 2020 {. │ │ │ │ -00012d70: 2020 7365 6172 6368 202d 2d73 6574 3d72 search --set=r │ │ │ │ -00012d80: 6f6f 7420 2d2d 6c61 6265 6c20 4752 5542 oot --label GRUB │ │ │ │ -00012d90: 202d 2d68 696e 7420 6864 302c 6d73 646f --hint hd0,msdo │ │ │ │ -00012da0: 7335 0a20 2020 2020 2020 2020 2020 2020 s5. │ │ │ │ -00012db0: 2020 6c69 6e75 7820 2f66 6564 6f72 612f linux /fedora/ │ │ │ │ -00012dc0: 766d 6c69 6e75 7a20 7265 706f 3d66 7470 vmlinuz repo=ftp │ │ │ │ -00012dd0: 3a2f 2f6d 6972 726f 722e 7377 6974 6368 ://mirror.switch │ │ │ │ -00012de0: 2e63 682f 6d69 7272 6f72 2f66 6564 6f72 .ch/mirror/fedor │ │ │ │ -00012df0: 612f 6c69 6e75 782f 6465 7665 6c6f 706d a/linux/developm │ │ │ │ -00012e00: 656e 742f 7261 7768 6964 652f 7838 365f ent/rawhide/x86_ │ │ │ │ -00012e10: 3634 206c 616e 673d 656e 5f55 5320 6b65 64 lang=en_US ke │ │ │ │ -00012e20: 796d 6170 3d73 6720 7265 736f 6c75 7469 ymap=sg resoluti │ │ │ │ -00012e30: 6f6e 3d31 3238 3078 3830 300a 2020 2020 on=1280x800. │ │ │ │ -00012e40: 2020 2020 2020 2020 2020 2069 6e69 7472 initr │ │ │ │ -00012e50: 6420 2f66 6564 6f72 612f 696e 6974 7264 d /fedora/initrd │ │ │ │ -00012e60: 2e69 6d67 0a20 2020 2020 7d0a 0a20 2020 .img. }.. │ │ │ │ -00012e70: 2020 6d65 6e75 656e 7472 7920 2244 6562 menuentry "Deb │ │ │ │ -00012e80: 6961 6e20 7369 6420 696e 7374 616c 6c65 ian sid installe │ │ │ │ -00012e90: 7222 207b 0a20 2020 2020 2020 2020 2020 r" {. │ │ │ │ -00012ea0: 2020 2020 7365 6172 6368 202d 2d73 6574 search --set │ │ │ │ -00012eb0: 3d72 6f6f 7420 2d2d 6c61 6265 6c20 4752 =root --label GR │ │ │ │ -00012ec0: 5542 202d 2d68 696e 7420 6864 302c 6d73 UB --hint hd0,ms │ │ │ │ -00012ed0: 646f 7335 0a20 2020 2020 2020 2020 2020 dos5. │ │ │ │ -00012ee0: 2020 2020 6c69 6e75 7820 2f64 6562 6961 linux /debia │ │ │ │ -00012ef0: 6e2f 6469 7374 732f 7369 642f 6d61 696e n/dists/sid/main │ │ │ │ -00012f00: 2f69 6e73 7461 6c6c 6572 2d61 6d64 3634 /installer-amd64 │ │ │ │ -00012f10: 2f63 7572 7265 6e74 2f69 6d61 6765 732f /current/images/ │ │ │ │ -00012f20: 6864 2d6d 6564 6961 2f76 6d6c 696e 757a hd-media/vmlinuz │ │ │ │ -00012f30: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ -00012f40: 696e 6974 7264 202f 6465 6269 616e 2f64 initrd /debian/d │ │ │ │ -00012f50: 6973 7473 2f73 6964 2f6d 6169 6e2f 696e ists/sid/main/in │ │ │ │ -00012f60: 7374 616c 6c65 722d 616d 6436 342f 6375 staller-amd64/cu │ │ │ │ -00012f70: 7272 656e 742f 696d 6167 6573 2f68 642d rrent/images/hd- │ │ │ │ -00012f80: 6d65 6469 612f 696e 6974 7264 2e67 7a0a media/initrd.gz. │ │ │ │ -00012f90: 2020 2020 207d 0a0a 0a20 2020 4e6f 7465 }... Note │ │ │ │ -00012fa0: 733a 0a20 2020 2a20 4172 6775 6d65 6e74 s:. * Argument │ │ │ │ -00012fb0: 2074 6f20 7365 6172 6368 2061 6674 6572 to search after │ │ │ │ -00012fc0: 202d 6c61 6265 6c20 6973 2046 5320 4c41 -label is FS LA │ │ │ │ -00012fd0: 4245 4c2e 2059 6f75 2063 616e 2061 6c73 BEL. You can als │ │ │ │ -00012fe0: 6f20 7573 6520 5555 4944 730a 2020 2020 o use UUIDs. │ │ │ │ -00012ff0: 2077 6974 6820 2d66 732d 7575 6964 2055 with -fs-uuid U │ │ │ │ -00013000: 5549 4420 696e 7374 6561 6420 6f66 202d UID instead of - │ │ │ │ -00013010: 6c61 6265 6c20 4c41 4245 4c2e 2059 6f75 label LABEL. You │ │ │ │ -00013020: 2063 6f75 6c64 2061 6c73 6f20 7573 650a could also use. │ │ │ │ -00013030: 2020 2020 2064 6972 6563 7420 2772 6f6f direct 'roo │ │ │ │ -00013040: 743d 6864 302c 6d73 646f 7358 2720 6275 t=hd0,msdosX' bu │ │ │ │ -00013050: 7420 7468 6973 2069 7320 6e6f 7420 7265 t this is not re │ │ │ │ -00013060: 636f 6d6d 656e 6465 6420 6475 6520 746f commended due to │ │ │ │ -00013070: 2064 6576 6963 650a 2020 2020 206e 616d device. nam │ │ │ │ -00013080: 6520 696e 7374 6162 696c 6974 792e 0a0a e instability... │ │ │ │ -00013090: 1f0a 4669 6c65 3a20 6772 7562 2e69 6e66 ..File: grub.inf │ │ │ │ -000130a0: 6f2c 2020 4e6f 6465 3a20 456d 6265 6464 o, Node: Embedd │ │ │ │ -000130b0: 6564 2063 6f6e 6669 6775 7261 7469 6f6e ed configuration │ │ │ │ -000130c0: 2c20 2050 7265 763a 204d 756c 7469 2d62 , Prev: Multi-b │ │ │ │ -000130d0: 6f6f 7420 6d61 6e75 616c 2063 6f6e 6669 oot manual confi │ │ │ │ -000130e0: 672c 2020 5570 3a20 436f 6e66 6967 7572 g, Up: Configur │ │ │ │ -000130f0: 6174 696f 6e0a 0a36 2e35 2045 6d62 6564 ation..6.5 Embed │ │ │ │ -00013100: 6469 6e67 2061 2063 6f6e 6669 6775 7261 ding a configura │ │ │ │ -00013110: 7469 6f6e 2066 696c 6520 696e 746f 2047 tion file into G │ │ │ │ -00013120: 5255 420a 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d RUB.============ │ │ │ │ +00012320: 3d3d 3d3d 0a0a 4375 7272 656e 746c 7920 ====..Currently │ │ │ │ +00012330: 6175 746f 6765 6e65 7261 7469 6e67 2063 autogenerating c │ │ │ │ +00012340: 6f6e 6669 6720 6669 6c65 7320 666f 7220 onfig files for │ │ │ │ +00012350: 6d75 6c74 692d 626f 6f74 2065 6e76 6972 multi-boot envir │ │ │ │ +00012360: 6f6e 6d65 6e74 730a 6465 7065 6e64 7320 onments.depends │ │ │ │ +00012370: 6f6e 206f 732d 7072 6f62 6572 2061 6e64 on os-prober and │ │ │ │ +00012380: 2068 6173 2073 6576 6572 616c 2073 686f has several sho │ │ │ │ +00012390: 7274 636f 6d69 6e67 732e 2020 5768 696c rtcomings. Whil │ │ │ │ +000123a0: 6520 6669 7869 6e67 2069 7420 6973 0a73 e fixing it is.s │ │ │ │ +000123b0: 6368 6564 756c 6564 2066 6f72 2074 6865 cheduled for the │ │ │ │ +000123c0: 206e 6578 7420 7265 6c65 6173 652c 206d next release, m │ │ │ │ +000123d0: 6561 6e77 6869 6c65 2079 6f75 2063 616e eanwhile you can │ │ │ │ +000123e0: 206d 616b 6520 7573 6520 6f66 2074 6865 make use of the │ │ │ │ +000123f0: 2070 6f77 6572 0a6f 6620 4752 5542 2073 power.of GRUB s │ │ │ │ +00012400: 796e 7461 7820 616e 6420 646f 2069 7420 yntax and do it │ │ │ │ +00012410: 796f 7572 7365 6c66 2e20 2041 2070 6f73 yourself. A pos │ │ │ │ +00012420: 7369 626c 6520 636f 6e66 6967 7572 6174 sible configurat │ │ │ │ +00012430: 696f 6e20 6973 2064 6574 6169 6c65 640a ion is detailed. │ │ │ │ +00012440: 6865 7265 2c20 6665 656c 2066 7265 6520 here, feel free │ │ │ │ +00012450: 746f 2061 646a 7573 7420 746f 2079 6f75 to adjust to you │ │ │ │ +00012460: 7220 6e65 6564 732e 0a0a 2020 2046 6972 r needs... Fir │ │ │ │ +00012470: 7374 2063 7265 6174 6520 6120 7365 7061 st create a sepa │ │ │ │ +00012480: 7261 7465 2047 5255 4220 7061 7274 6974 rate GRUB partit │ │ │ │ +00012490: 696f 6e2c 2062 6967 2065 6e6f 7567 6820 ion, big enough │ │ │ │ +000124a0: 746f 2068 6f6c 6420 4752 5542 2e20 536f to hold GRUB. So │ │ │ │ +000124b0: 6d65 0a6f 6620 7468 6520 666f 6c6c 6f77 me.of the follow │ │ │ │ +000124c0: 696e 6720 656e 7472 6965 7320 7368 6f77 ing entries show │ │ │ │ +000124d0: 2068 6f77 2074 6f20 6c6f 6164 204f 5320 how to load OS │ │ │ │ +000124e0: 696e 7374 616c 6c65 7220 696d 6167 6573 installer images │ │ │ │ +000124f0: 2066 726f 6d20 7468 6973 0a73 616d 6520 from this.same │ │ │ │ +00012500: 7061 7274 6974 696f 6e2c 2066 6f72 2074 partition, for t │ │ │ │ +00012510: 6861 7420 796f 7520 6f62 7669 6f75 736c hat you obviousl │ │ │ │ +00012520: 7920 6e65 6564 2074 6f20 6d61 6b65 2074 y need to make t │ │ │ │ +00012530: 6865 2070 6172 7469 7469 6f6e 206c 6172 he partition lar │ │ │ │ +00012540: 6765 0a65 6e6f 7567 6820 746f 2068 6f6c ge.enough to hol │ │ │ │ +00012550: 6420 7468 6f73 6520 696d 6167 6573 2061 d those images a │ │ │ │ +00012560: 7320 7765 6c6c 2e20 204d 6f75 6e74 2074 s well. Mount t │ │ │ │ +00012570: 6869 7320 7061 7274 6974 696f 6e20 6f6e his partition on │ │ │ │ +00012580: 2f6d 6e74 2f62 6f6f 740a 616e 6420 6469 /mnt/boot.and di │ │ │ │ +00012590: 7361 626c 6520 4752 5542 2069 6e20 616c sable GRUB in al │ │ │ │ +000125a0: 6c20 4f53 6573 2061 6e64 206d 616e 7561 l OSes and manua │ │ │ │ +000125b0: 6c6c 7920 696e 7374 616c 6c20 7365 6c66 lly install self │ │ │ │ +000125c0: 2d63 6f6d 7069 6c65 6420 6c61 7465 7374 -compiled latest │ │ │ │ +000125d0: 0a47 5255 4220 7769 7468 3a0a 0a20 2020 .GRUB with:.. │ │ │ │ +000125e0: 2767 7275 622d 696e 7374 616c 6c20 2d2d 'grub-install -- │ │ │ │ +000125f0: 626f 6f74 2d64 6972 6563 746f 7279 3d2f boot-directory=/ │ │ │ │ +00012600: 6d6e 742f 626f 6f74 202f 6465 762f 7364 mnt/boot /dev/sd │ │ │ │ +00012610: 6127 0a0a 2020 2049 6e20 616c 6c20 7468 a'.. In all th │ │ │ │ +00012620: 6520 4f53 6573 2069 6e73 7461 6c6c 2047 e OSes install G │ │ │ │ +00012630: 5255 4220 746f 6f6c 7320 6275 7420 6469 RUB tools but di │ │ │ │ +00012640: 7361 626c 6520 696e 7374 616c 6c69 6e67 sable installing │ │ │ │ +00012650: 2047 5255 4220 696e 0a62 6f6f 7473 6563 GRUB in.bootsec │ │ │ │ +00012660: 746f 722c 2073 6f20 796f 7527 6c6c 2068 tor, so you'll h │ │ │ │ +00012670: 6176 6520 6d65 6e75 2e6c 7374 2061 6e64 ave menu.lst and │ │ │ │ +00012680: 2067 7275 622e 6366 6720 6176 6169 6c61 grub.cfg availa │ │ │ │ +00012690: 626c 6520 666f 7220 7573 652e 0a41 6c73 ble for use..Als │ │ │ │ +000126a0: 6f20 6469 7361 626c 6520 6f73 2d70 726f o disable os-pro │ │ │ │ +000126b0: 6265 7220 7573 6520 6279 2073 6574 7469 ber use by setti │ │ │ │ +000126c0: 6e67 3a0a 0a20 2020 2747 5255 425f 4449 ng:.. 'GRUB_DI │ │ │ │ +000126d0: 5341 424c 455f 4f53 5f50 524f 4245 523d SABLE_OS_PROBER= │ │ │ │ +000126e0: 7472 7565 270a 0a20 2020 696e 202f 6574 true'.. in /et │ │ │ │ +000126f0: 632f 6465 6661 756c 742f 6772 7562 0a0a c/default/grub.. │ │ │ │ +00012700: 2020 2054 6865 6e20 7772 6974 6520 6120 Then write a │ │ │ │ +00012710: 6772 7562 2e63 6667 2028 2f6d 6e74 2f62 grub.cfg (/mnt/b │ │ │ │ +00012720: 6f6f 742f 6772 7562 2f67 7275 622e 6366 oot/grub/grub.cf │ │ │ │ +00012730: 6729 3a0a 0a0a 2020 2020 206d 656e 7565 g):... menue │ │ │ │ +00012740: 6e74 7279 2022 4f53 2075 7369 6e67 2067 ntry "OS using g │ │ │ │ +00012750: 7275 6232 2220 7b0a 2020 2020 2020 2020 rub2" {. │ │ │ │ +00012760: 696e 736d 6f64 2078 6673 0a20 2020 2020 insmod xfs. │ │ │ │ +00012770: 2020 2073 6561 7263 6820 2d2d 7365 743d search --set= │ │ │ │ +00012780: 726f 6f74 202d 2d6c 6162 656c 204f 5331 root --label OS1 │ │ │ │ +00012790: 202d 2d68 696e 7420 6864 302c 6d73 646f --hint hd0,msdo │ │ │ │ +000127a0: 7338 0a20 2020 2020 2020 2063 6f6e 6669 s8. confi │ │ │ │ +000127b0: 6766 696c 6520 2f62 6f6f 742f 6772 7562 gfile /boot/grub │ │ │ │ +000127c0: 2f67 7275 622e 6366 670a 2020 2020 207d /grub.cfg. } │ │ │ │ +000127d0: 0a0a 2020 2020 206d 656e 7565 6e74 7279 .. menuentry │ │ │ │ +000127e0: 2022 4f53 2075 7369 6e67 2067 7275 6232 "OS using grub2 │ │ │ │ +000127f0: 2d6c 6567 6163 7922 207b 0a20 2020 2020 -legacy" {. │ │ │ │ +00012800: 2020 2069 6e73 6d6f 6420 6578 7432 0a20 insmod ext2. │ │ │ │ +00012810: 2020 2020 2020 2073 6561 7263 6820 2d2d search -- │ │ │ │ +00012820: 7365 743d 726f 6f74 202d 2d6c 6162 656c set=root --label │ │ │ │ +00012830: 204f 5332 202d 2d68 696e 7420 6864 302c OS2 --hint hd0, │ │ │ │ +00012840: 6d73 646f 7336 0a20 2020 2020 2020 206c msdos6. l │ │ │ │ +00012850: 6567 6163 795f 636f 6e66 6967 6669 6c65 egacy_configfile │ │ │ │ +00012860: 202f 626f 6f74 2f67 7275 622f 6d65 6e75 /boot/grub/menu │ │ │ │ +00012870: 2e6c 7374 0a20 2020 2020 7d0a 0a20 2020 .lst. }.. │ │ │ │ +00012880: 2020 6d65 6e75 656e 7472 7920 2257 696e menuentry "Win │ │ │ │ +00012890: 646f 7773 2058 5022 207b 0a20 2020 2020 dows XP" {. │ │ │ │ +000128a0: 2020 2069 6e73 6d6f 6420 6e74 6673 0a20 insmod ntfs. │ │ │ │ +000128b0: 2020 2020 2020 2073 6561 7263 6820 2d2d search -- │ │ │ │ +000128c0: 7365 743d 726f 6f74 202d 2d6c 6162 656c set=root --label │ │ │ │ +000128d0: 2057 494e 444f 5753 5f58 5020 2d2d 6869 WINDOWS_XP --hi │ │ │ │ +000128e0: 6e74 2068 6430 2c6d 7364 6f73 310a 2020 nt hd0,msdos1. │ │ │ │ +000128f0: 2020 2020 2020 6e74 6c64 7220 2f6e 746c ntldr /ntl │ │ │ │ +00012900: 6472 0a20 2020 2020 7d0a 0a20 2020 2020 dr. }.. │ │ │ │ +00012910: 6d65 6e75 656e 7472 7920 2257 696e 646f menuentry "Windo │ │ │ │ +00012920: 7773 2037 2220 7b0a 2020 2020 2020 2020 ws 7" {. │ │ │ │ +00012930: 696e 736d 6f64 206e 7466 730a 2020 2020 insmod ntfs. │ │ │ │ +00012940: 2020 2020 7365 6172 6368 202d 2d73 6574 search --set │ │ │ │ +00012950: 3d72 6f6f 7420 2d2d 6c61 6265 6c20 5749 =root --label WI │ │ │ │ +00012960: 4e44 4f57 535f 3720 2d2d 6869 6e74 2068 NDOWS_7 --hint h │ │ │ │ +00012970: 6430 2c6d 7364 6f73 320a 2020 2020 2020 d0,msdos2. │ │ │ │ +00012980: 2020 6e74 6c64 7220 2f62 6f6f 746d 6772 ntldr /bootmgr │ │ │ │ +00012990: 0a20 2020 2020 7d0a 0a20 2020 2020 6d65 . }.. me │ │ │ │ +000129a0: 6e75 656e 7472 7920 2246 7265 6542 5344 nuentry "FreeBSD │ │ │ │ +000129b0: 2220 7b0a 2020 2020 2020 2020 2020 2020 " {. │ │ │ │ +000129c0: 2020 2069 6e73 6d6f 6420 7a66 730a 2020 insmod zfs. │ │ │ │ +000129d0: 2020 2020 2020 2020 2020 2020 2073 6561 sea │ │ │ │ +000129e0: 7263 6820 2d2d 7365 743d 726f 6f74 202d rch --set=root - │ │ │ │ +000129f0: 2d6c 6162 656c 2066 7265 6570 6f6f 6c20 -label freepool │ │ │ │ +00012a00: 2d2d 6869 6e74 2068 6430 2c6d 7364 6f73 --hint hd0,msdos │ │ │ │ +00012a10: 370a 2020 2020 2020 2020 2020 2020 2020 7. │ │ │ │ +00012a20: 206b 6672 6565 6273 6420 2f66 7265 6562 kfreebsd /freeb │ │ │ │ +00012a30: 7364 402f 626f 6f74 2f6b 6572 6e65 6c2f sd@/boot/kernel/ │ │ │ │ +00012a40: 6b65 726e 656c 0a20 2020 2020 2020 2020 kernel. │ │ │ │ +00012a50: 2020 2020 2020 6b66 7265 6562 7364 5f6d kfreebsd_m │ │ │ │ +00012a60: 6f64 756c 655f 656c 6620 2f66 7265 6562 odule_elf /freeb │ │ │ │ +00012a70: 7364 402f 626f 6f74 2f6b 6572 6e65 6c2f sd@/boot/kernel/ │ │ │ │ +00012a80: 6f70 656e 736f 6c61 7269 732e 6b6f 0a20 opensolaris.ko. │ │ │ │ +00012a90: 2020 2020 2020 2020 2020 2020 2020 6b66 kf │ │ │ │ +00012aa0: 7265 6562 7364 5f6d 6f64 756c 655f 656c reebsd_module_el │ │ │ │ +00012ab0: 6620 2f66 7265 6562 7364 402f 626f 6f74 f /freebsd@/boot │ │ │ │ +00012ac0: 2f6b 6572 6e65 6c2f 7a66 732e 6b6f 0a20 /kernel/zfs.ko. │ │ │ │ +00012ad0: 2020 2020 2020 2020 2020 2020 2020 6b66 kf │ │ │ │ +00012ae0: 7265 6562 7364 5f6d 6f64 756c 6520 2f66 reebsd_module /f │ │ │ │ +00012af0: 7265 6562 7364 402f 626f 6f74 2f7a 6673 reebsd@/boot/zfs │ │ │ │ +00012b00: 2f7a 706f 6f6c 2e63 6163 6865 2074 7970 /zpool.cache typ │ │ │ │ +00012b10: 653d 2f62 6f6f 742f 7a66 732f 7a70 6f6f e=/boot/zfs/zpoo │ │ │ │ +00012b20: 6c2e 6361 6368 650a 2020 2020 2020 2020 l.cache. │ │ │ │ +00012b30: 2020 2020 2020 2073 6574 206b 4672 6565 set kFree │ │ │ │ +00012b40: 4253 442e 7666 732e 726f 6f74 2e6d 6f75 BSD.vfs.root.mou │ │ │ │ +00012b50: 6e74 6672 6f6d 3d7a 6673 3a66 7265 6570 ntfrom=zfs:freep │ │ │ │ +00012b60: 6f6f 6c2f 6672 6565 6273 640a 2020 2020 ool/freebsd. │ │ │ │ +00012b70: 2020 2020 2020 2020 2020 2073 6574 206b set k │ │ │ │ +00012b80: 4672 6565 4253 442e 6877 2e70 736d 2e73 FreeBSD.hw.psm.s │ │ │ │ +00012b90: 796e 6170 7469 6373 5f73 7570 706f 7274 ynaptics_support │ │ │ │ +00012ba0: 3d31 0a20 2020 2020 7d0a 0a20 2020 2020 =1. }.. │ │ │ │ +00012bb0: 6d65 6e75 656e 7472 7920 2265 7870 6572 menuentry "exper │ │ │ │ +00012bc0: 696d 656e 7461 6c20 4752 5542 2220 7b0a imental GRUB" {. │ │ │ │ +00012bd0: 2020 2020 2020 2020 2020 2020 2020 2073 s │ │ │ │ +00012be0: 6561 7263 6820 2d2d 7365 743d 726f 6f74 earch --set=root │ │ │ │ +00012bf0: 202d 2d6c 6162 656c 2047 5255 4220 2d2d --label GRUB -- │ │ │ │ +00012c00: 6869 6e74 2068 6430 2c6d 7364 6f73 350a hint hd0,msdos5. │ │ │ │ +00012c10: 2020 2020 2020 2020 2020 2020 2020 206d m │ │ │ │ +00012c20: 756c 7469 626f 6f74 202f 6578 7065 7269 ultiboot /experi │ │ │ │ +00012c30: 6d65 6e74 616c 2f67 7275 622f 6933 3836 mental/grub/i386 │ │ │ │ +00012c40: 2d70 632f 636f 7265 2e69 6d67 0a20 2020 -pc/core.img. │ │ │ │ +00012c50: 2020 7d0a 0a20 2020 2020 6d65 6e75 656e }.. menuen │ │ │ │ +00012c60: 7472 7920 2246 6564 6f72 6120 3136 2069 try "Fedora 16 i │ │ │ │ +00012c70: 6e73 7461 6c6c 6572 2220 7b0a 2020 2020 nstaller" {. │ │ │ │ +00012c80: 2020 2020 2020 2020 2020 2073 6561 7263 searc │ │ │ │ +00012c90: 6820 2d2d 7365 743d 726f 6f74 202d 2d6c h --set=root --l │ │ │ │ +00012ca0: 6162 656c 2047 5255 4220 2d2d 6869 6e74 abel GRUB --hint │ │ │ │ +00012cb0: 2068 6430 2c6d 7364 6f73 350a 2020 2020 hd0,msdos5. │ │ │ │ +00012cc0: 2020 2020 2020 2020 2020 206c 696e 7578 linux │ │ │ │ +00012cd0: 202f 6665 646f 7261 2f76 6d6c 696e 757a /fedora/vmlinuz │ │ │ │ +00012ce0: 206c 616e 673d 656e 5f55 5320 6b65 796d lang=en_US keym │ │ │ │ +00012cf0: 6170 3d73 6720 7265 736f 6c75 7469 6f6e ap=sg resolution │ │ │ │ +00012d00: 3d31 3238 3078 3830 300a 2020 2020 2020 =1280x800. │ │ │ │ +00012d10: 2020 2020 2020 2020 2069 6e69 7472 6420 initrd │ │ │ │ +00012d20: 2f66 6564 6f72 612f 696e 6974 7264 2e69 /fedora/initrd.i │ │ │ │ +00012d30: 6d67 0a20 2020 2020 7d0a 0a20 2020 2020 mg. }.. │ │ │ │ +00012d40: 6d65 6e75 656e 7472 7920 2246 6564 6f72 menuentry "Fedor │ │ │ │ +00012d50: 6120 7261 7768 6964 6520 696e 7374 616c a rawhide instal │ │ │ │ +00012d60: 6c65 7222 207b 0a20 2020 2020 2020 2020 ler" {. │ │ │ │ +00012d70: 2020 2020 2020 7365 6172 6368 202d 2d73 search --s │ │ │ │ +00012d80: 6574 3d72 6f6f 7420 2d2d 6c61 6265 6c20 et=root --label │ │ │ │ +00012d90: 4752 5542 202d 2d68 696e 7420 6864 302c GRUB --hint hd0, │ │ │ │ +00012da0: 6d73 646f 7335 0a20 2020 2020 2020 2020 msdos5. │ │ │ │ +00012db0: 2020 2020 2020 6c69 6e75 7820 2f66 6564 linux /fed │ │ │ │ +00012dc0: 6f72 612f 766d 6c69 6e75 7a20 7265 706f ora/vmlinuz repo │ │ │ │ +00012dd0: 3d66 7470 3a2f 2f6d 6972 726f 722e 7377 =ftp://mirror.sw │ │ │ │ +00012de0: 6974 6368 2e63 682f 6d69 7272 6f72 2f66 itch.ch/mirror/f │ │ │ │ +00012df0: 6564 6f72 612f 6c69 6e75 782f 6465 7665 edora/linux/deve │ │ │ │ +00012e00: 6c6f 706d 656e 742f 7261 7768 6964 652f lopment/rawhide/ │ │ │ │ +00012e10: 7838 365f 3634 206c 616e 673d 656e 5f55 x86_64 lang=en_U │ │ │ │ +00012e20: 5320 6b65 796d 6170 3d73 6720 7265 736f S keymap=sg reso │ │ │ │ +00012e30: 6c75 7469 6f6e 3d31 3238 3078 3830 300a lution=1280x800. │ │ │ │ +00012e40: 2020 2020 2020 2020 2020 2020 2020 2069 i │ │ │ │ +00012e50: 6e69 7472 6420 2f66 6564 6f72 612f 696e nitrd /fedora/in │ │ │ │ +00012e60: 6974 7264 2e69 6d67 0a20 2020 2020 7d0a itrd.img. }. │ │ │ │ +00012e70: 0a20 2020 2020 6d65 6e75 656e 7472 7920 . menuentry │ │ │ │ +00012e80: 2244 6562 6961 6e20 7369 6420 696e 7374 "Debian sid inst │ │ │ │ +00012e90: 616c 6c65 7222 207b 0a20 2020 2020 2020 aller" {. │ │ │ │ +00012ea0: 2020 2020 2020 2020 7365 6172 6368 202d search - │ │ │ │ +00012eb0: 2d73 6574 3d72 6f6f 7420 2d2d 6c61 6265 -set=root --labe │ │ │ │ +00012ec0: 6c20 4752 5542 202d 2d68 696e 7420 6864 l GRUB --hint hd │ │ │ │ +00012ed0: 302c 6d73 646f 7335 0a20 2020 2020 2020 0,msdos5. │ │ │ │ +00012ee0: 2020 2020 2020 2020 6c69 6e75 7820 2f64 linux /d │ │ │ │ +00012ef0: 6562 6961 6e2f 6469 7374 732f 7369 642f ebian/dists/sid/ │ │ │ │ +00012f00: 6d61 696e 2f69 6e73 7461 6c6c 6572 2d61 main/installer-a │ │ │ │ +00012f10: 6d64 3634 2f63 7572 7265 6e74 2f69 6d61 md64/current/ima │ │ │ │ +00012f20: 6765 732f 6864 2d6d 6564 6961 2f76 6d6c ges/hd-media/vml │ │ │ │ +00012f30: 696e 757a 0a20 2020 2020 2020 2020 2020 inuz. │ │ │ │ +00012f40: 2020 2020 696e 6974 7264 202f 6465 6269 initrd /debi │ │ │ │ +00012f50: 616e 2f64 6973 7473 2f73 6964 2f6d 6169 an/dists/sid/mai │ │ │ │ +00012f60: 6e2f 696e 7374 616c 6c65 722d 616d 6436 n/installer-amd6 │ │ │ │ +00012f70: 342f 6375 7272 656e 742f 696d 6167 6573 4/current/images │ │ │ │ +00012f80: 2f68 642d 6d65 6469 612f 696e 6974 7264 /hd-media/initrd │ │ │ │ +00012f90: 2e67 7a0a 2020 2020 207d 0a0a 0a20 2020 .gz. }... │ │ │ │ +00012fa0: 4e6f 7465 733a 0a20 2020 2a20 4172 6775 Notes:. * Argu │ │ │ │ +00012fb0: 6d65 6e74 2074 6f20 7365 6172 6368 2061 ment to search a │ │ │ │ +00012fc0: 6674 6572 202d 6c61 6265 6c20 6973 2046 fter -label is F │ │ │ │ +00012fd0: 5320 4c41 4245 4c2e 2059 6f75 2063 616e S LABEL. You can │ │ │ │ +00012fe0: 2061 6c73 6f20 7573 6520 5555 4944 730a also use UUIDs. │ │ │ │ +00012ff0: 2020 2020 2077 6974 6820 2d66 732d 7575 with -fs-uu │ │ │ │ +00013000: 6964 2055 5549 4420 696e 7374 6561 6420 id UUID instead │ │ │ │ +00013010: 6f66 202d 6c61 6265 6c20 4c41 4245 4c2e of -label LABEL. │ │ │ │ +00013020: 2059 6f75 2063 6f75 6c64 2061 6c73 6f20 You could also │ │ │ │ +00013030: 7573 650a 2020 2020 2064 6972 6563 7420 use. direct │ │ │ │ +00013040: 2772 6f6f 743d 6864 302c 6d73 646f 7358 'root=hd0,msdosX │ │ │ │ +00013050: 2720 6275 7420 7468 6973 2069 7320 6e6f ' but this is no │ │ │ │ +00013060: 7420 7265 636f 6d6d 656e 6465 6420 6475 t recommended du │ │ │ │ +00013070: 6520 746f 2064 6576 6963 650a 2020 2020 e to device. │ │ │ │ +00013080: 206e 616d 6520 696e 7374 6162 696c 6974 name instabilit │ │ │ │ +00013090: 792e 0a0a 1f0a 4669 6c65 3a20 6772 7562 y.....File: grub │ │ │ │ +000130a0: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 456d .info, Node: Em │ │ │ │ +000130b0: 6265 6464 6564 2063 6f6e 6669 6775 7261 bedded configura │ │ │ │ +000130c0: 7469 6f6e 2c20 2050 7265 763a 204d 756c tion, Prev: Mul │ │ │ │ +000130d0: 7469 2d62 6f6f 7420 6d61 6e75 616c 2063 ti-boot manual c │ │ │ │ +000130e0: 6f6e 6669 672c 2020 5570 3a20 436f 6e66 onfig, Up: Conf │ │ │ │ +000130f0: 6967 7572 6174 696f 6e0a 0a36 2e35 2045 iguration..6.5 E │ │ │ │ +00013100: 6d62 6564 6469 6e67 2061 2063 6f6e 6669 mbedding a confi │ │ │ │ +00013110: 6775 7261 7469 6f6e 2066 696c 6520 696e guration file in │ │ │ │ +00013120: 746f 2047 5255 420a 3d3d 3d3d 3d3d 3d3d to GRUB.======== │ │ │ │ 00013130: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ 00013140: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ -00013150: 0a0a 4752 5542 2073 7570 706f 7274 7320 ..GRUB supports │ │ │ │ -00013160: 656d 6265 6464 696e 6720 6120 636f 6e66 embedding a conf │ │ │ │ -00013170: 6967 7572 6174 696f 6e20 6669 6c65 2064 iguration file d │ │ │ │ -00013180: 6972 6563 746c 7920 696e 746f 2074 6865 irectly into the │ │ │ │ -00013190: 2063 6f72 650a 696d 6167 652c 2073 6f20 core.image, so │ │ │ │ -000131a0: 7468 6174 2069 7420 6973 206c 6f61 6465 that it is loade │ │ │ │ -000131b0: 6420 6265 666f 7265 2065 6e74 6572 696e d before enterin │ │ │ │ -000131c0: 6720 6e6f 726d 616c 206d 6f64 652e 2020 g normal mode. │ │ │ │ -000131d0: 5468 6973 2069 730a 7573 6566 756c 2c20 This is.useful, │ │ │ │ -000131e0: 666f 7220 6578 616d 706c 652c 2077 6865 for example, whe │ │ │ │ -000131f0: 6e20 6974 2069 7320 6e6f 7420 7374 7261 n it is not stra │ │ │ │ -00013200: 6967 6874 666f 7277 6172 6420 746f 2066 ightforward to f │ │ │ │ -00013210: 696e 6420 7468 6520 7265 616c 0a63 6f6e ind the real.con │ │ │ │ -00013220: 6669 6775 7261 7469 6f6e 2066 696c 652c figuration file, │ │ │ │ -00013230: 206f 7220 7768 656e 2079 6f75 206e 6565 or when you nee │ │ │ │ -00013240: 6420 746f 2064 6562 7567 2070 726f 626c d to debug probl │ │ │ │ -00013250: 656d 7320 7769 7468 206c 6f61 6469 6e67 ems with loading │ │ │ │ -00013260: 2074 6861 740a 6669 6c65 2e20 2027 6772 that.file. 'gr │ │ │ │ -00013270: 7562 2d69 6e73 7461 6c6c 2720 7573 6573 ub-install' uses │ │ │ │ -00013280: 2074 6869 7320 6665 6174 7572 6520 7768 this feature wh │ │ │ │ -00013290: 656e 2069 7420 6973 206e 6f74 2075 7369 en it is not usi │ │ │ │ -000132a0: 6e67 2042 494f 5320 6469 736b 0a66 756e ng BIOS disk.fun │ │ │ │ -000132b0: 6374 696f 6e73 206f 7220 7768 656e 2069 ctions or when i │ │ │ │ -000132c0: 6e73 7461 6c6c 696e 6720 746f 2061 2064 nstalling to a d │ │ │ │ -000132d0: 6966 6665 7265 6e74 2064 6973 6b20 6672 ifferent disk fr │ │ │ │ -000132e0: 6f6d 2074 6865 206f 6e65 2063 6f6e 7461 om the one conta │ │ │ │ -000132f0: 696e 696e 670a 272f 626f 6f74 2f67 7275 ining.'/boot/gru │ │ │ │ -00013300: 6227 2c20 696e 2077 6869 6368 2063 6173 b', in which cas │ │ │ │ -00013310: 6520 6974 206e 6565 6473 2074 6f20 7573 e it needs to us │ │ │ │ -00013320: 6520 7468 6520 2773 6561 7263 6827 2063 e the 'search' c │ │ │ │ -00013330: 6f6d 6d61 6e64 2028 2a6e 6f74 650a 7365 ommand (*note.se │ │ │ │ -00013340: 6172 6368 3a3a 2920 746f 2066 696e 6420 arch::) to find │ │ │ │ -00013350: 272f 626f 6f74 2f67 7275 6227 2e0a 0a20 '/boot/grub'... │ │ │ │ -00013360: 2020 546f 2065 6d62 6564 2061 2063 6f6e To embed a con │ │ │ │ -00013370: 6669 6775 7261 7469 6f6e 2066 696c 652c figuration file, │ │ │ │ -00013380: 2075 7365 2074 6865 2027 2d63 2720 6f70 use the '-c' op │ │ │ │ -00013390: 7469 6f6e 2074 6f20 2767 7275 622d 6d6b tion to 'grub-mk │ │ │ │ -000133a0: 696d 6167 6527 2e0a 5468 6520 6669 6c65 image'..The file │ │ │ │ -000133b0: 2069 7320 636f 7069 6564 2069 6e74 6f20 is copied into │ │ │ │ -000133c0: 7468 6520 636f 7265 2069 6d61 6765 2c20 the core image, │ │ │ │ -000133d0: 736f 2069 7420 6d61 7920 7265 7369 6465 so it may reside │ │ │ │ -000133e0: 2061 6e79 7768 6572 6520 6f6e 2074 6865 anywhere on the │ │ │ │ -000133f0: 0a66 696c 6520 7379 7374 656d 2c20 616e .file system, an │ │ │ │ -00013400: 6420 6d61 7920 6265 2072 656d 6f76 6564 d may be removed │ │ │ │ -00013410: 2061 6674 6572 2072 756e 6e69 6e67 2027 after running ' │ │ │ │ -00013420: 6772 7562 2d6d 6b69 6d61 6765 272e 0a0a grub-mkimage'... │ │ │ │ -00013430: 2020 2041 6674 6572 2074 6865 2065 6d62 After the emb │ │ │ │ -00013440: 6564 6465 6420 636f 6e66 6967 7572 6174 edded configurat │ │ │ │ -00013450: 696f 6e20 6669 6c65 2028 6966 2061 6e79 ion file (if any │ │ │ │ -00013460: 2920 6973 2065 7865 6375 7465 642c 2047 ) is executed, G │ │ │ │ -00013470: 5255 4220 7769 6c6c 0a6c 6f61 6420 7468 RUB will.load th │ │ │ │ -00013480: 6520 276e 6f72 6d61 6c27 206d 6f64 756c e 'normal' modul │ │ │ │ -00013490: 6520 282a 6e6f 7465 206e 6f72 6d61 6c3a e (*note normal: │ │ │ │ -000134a0: 3a29 2c20 7768 6963 6820 7769 6c6c 2074 :), which will t │ │ │ │ -000134b0: 6865 6e20 7265 6164 2074 6865 2072 6561 hen read the rea │ │ │ │ -000134c0: 6c0a 636f 6e66 6967 7572 6174 696f 6e20 l.configuration │ │ │ │ -000134d0: 6669 6c65 2066 726f 6d20 2724 7072 6566 file from '$pref │ │ │ │ -000134e0: 6978 2f67 7275 622e 6366 6727 2e20 2042 ix/grub.cfg'. B │ │ │ │ -000134f0: 7920 7468 6973 2070 6f69 6e74 2c20 7468 y this point, th │ │ │ │ -00013500: 6520 2772 6f6f 7427 0a76 6172 6961 626c e 'root'.variabl │ │ │ │ -00013510: 6520 7769 6c6c 2061 6c73 6f20 6861 7665 e will also have │ │ │ │ -00013520: 2062 6565 6e20 7365 7420 746f 2074 6865 been set to the │ │ │ │ -00013530: 2072 6f6f 7420 6465 7669 6365 206e 616d root device nam │ │ │ │ -00013540: 652e 2020 466f 7220 6578 616d 706c 652c e. For example, │ │ │ │ -00013550: 0a27 7072 6566 6978 2720 6d69 6768 7420 .'prefix' might │ │ │ │ -00013560: 6265 2073 6574 2074 6f20 2728 6864 302c be set to '(hd0, │ │ │ │ -00013570: 3129 2f62 6f6f 742f 6772 7562 272c 2061 1)/boot/grub', a │ │ │ │ -00013580: 6e64 2027 726f 6f74 2720 6d69 6768 7420 nd 'root' might │ │ │ │ -00013590: 6265 2073 6574 2074 6f0a 2768 6430 2c31 be set to.'hd0,1 │ │ │ │ -000135a0: 272e 2020 5468 7573 2c20 696e 206d 6f73 '. Thus, in mos │ │ │ │ -000135b0: 7420 6361 7365 732c 2074 6865 2065 6d62 t cases, the emb │ │ │ │ -000135c0: 6564 6465 6420 636f 6e66 6967 7572 6174 edded configurat │ │ │ │ -000135d0: 696f 6e20 6669 6c65 206f 6e6c 790a 6e65 ion file only.ne │ │ │ │ -000135e0: 6564 7320 746f 2073 6574 2074 6865 2027 eds to set the ' │ │ │ │ -000135f0: 7072 6566 6978 2720 616e 6420 2772 6f6f prefix' and 'roo │ │ │ │ -00013600: 7427 2076 6172 6961 626c 6573 2c20 616e t' variables, an │ │ │ │ -00013610: 6420 7468 656e 2064 726f 7020 7468 726f d then drop thro │ │ │ │ -00013620: 7567 6820 746f 0a47 5255 4227 7320 6e6f ugh to.GRUB's no │ │ │ │ -00013630: 726d 616c 2070 726f 6365 7373 696e 672e rmal processing. │ │ │ │ -00013640: 2020 4120 7479 7069 6361 6c20 6578 616d A typical exam │ │ │ │ -00013650: 706c 6520 6f66 2074 6869 7320 6d69 6768 ple of this migh │ │ │ │ -00013660: 7420 6c6f 6f6b 206c 696b 650a 7468 6973 t look like.this │ │ │ │ -00013670: 3a0a 0a20 2020 2020 7365 6172 6368 2e66 :.. search.f │ │ │ │ -00013680: 735f 7575 6964 2030 3132 3334 3536 372d s_uuid 01234567- │ │ │ │ -00013690: 3839 6162 2d63 6465 662d 3031 3233 2d34 89ab-cdef-0123-4 │ │ │ │ -000136a0: 3536 3738 3961 6263 6465 6620 726f 6f74 56789abcdef root │ │ │ │ -000136b0: 0a20 2020 2020 7365 7420 7072 6566 6978 . set prefix │ │ │ │ -000136c0: 3d28 2472 6f6f 7429 2f62 6f6f 742f 6772 =($root)/boot/gr │ │ │ │ -000136d0: 7562 0a0a 2020 2028 5468 6520 2773 6561 ub.. (The 'sea │ │ │ │ -000136e0: 7263 685f 6673 5f75 7569 6427 206d 6f64 rch_fs_uuid' mod │ │ │ │ -000136f0: 756c 6520 6d75 7374 2062 6520 696e 636c ule must be incl │ │ │ │ -00013700: 7564 6564 2069 6e20 7468 6520 636f 7265 uded in the core │ │ │ │ -00013710: 2069 6d61 6765 2066 6f72 0a74 6869 7320 image for.this │ │ │ │ -00013720: 6578 616d 706c 6520 746f 2077 6f72 6b2e example to work. │ │ │ │ -00013730: 290a 0a20 2020 496e 206d 6f72 6520 636f ).. In more co │ │ │ │ -00013740: 6d70 6c65 7820 6361 7365 732c 2069 7420 mplex cases, it │ │ │ │ -00013750: 6d61 7920 6265 2075 7365 6675 6c20 746f may be useful to │ │ │ │ -00013760: 2072 6561 6420 6f74 6865 7220 636f 6e66 read other conf │ │ │ │ -00013770: 6967 7572 6174 696f 6e0a 6669 6c65 7320 iguration.files │ │ │ │ -00013780: 6469 7265 6374 6c79 2066 726f 6d20 7468 directly from th │ │ │ │ -00013790: 6520 656d 6265 6464 6564 2063 6f6e 6669 e embedded confi │ │ │ │ -000137a0: 6775 7261 7469 6f6e 2066 696c 652e 2020 guration file. │ │ │ │ -000137b0: 5468 6973 2061 6c6c 6f77 7320 7375 6368 This allows such │ │ │ │ -000137c0: 0a74 6869 6e67 7320 6173 2072 6561 6469 .things as readi │ │ │ │ -000137d0: 6e67 2066 696c 6573 206e 6f74 2063 616c ng files not cal │ │ │ │ -000137e0: 6c65 6420 2767 7275 622e 6366 6727 2c20 led 'grub.cfg', │ │ │ │ -000137f0: 6f72 2072 6561 6469 6e67 2066 696c 6573 or reading files │ │ │ │ -00013800: 2066 726f 6d20 610a 6469 7265 6374 6f72 from a.director │ │ │ │ -00013810: 7920 6f74 6865 7220 7468 616e 2074 6861 y other than tha │ │ │ │ -00013820: 7420 7768 6572 6520 4752 5542 2773 206c t where GRUB's l │ │ │ │ -00013830: 6f61 6461 626c 6520 6d6f 6475 6c65 7320 oadable modules │ │ │ │ -00013840: 6172 6520 696e 7374 616c 6c65 642e 0a54 are installed..T │ │ │ │ -00013850: 6f20 646f 2074 6869 732c 2069 6e63 6c75 o do this, inclu │ │ │ │ -00013860: 6465 2074 6865 2027 636f 6e66 6967 6669 de the 'configfi │ │ │ │ -00013870: 6c65 2720 616e 6420 276e 6f72 6d61 6c27 le' and 'normal' │ │ │ │ -00013880: 206d 6f64 756c 6573 2069 6e20 7468 6520 modules in the │ │ │ │ -00013890: 636f 7265 0a69 6d61 6765 2c20 616e 6420 core.image, and │ │ │ │ -000138a0: 656d 6265 6420 6120 636f 6e66 6967 7572 embed a configur │ │ │ │ -000138b0: 6174 696f 6e20 6669 6c65 2074 6861 7420 ation file that │ │ │ │ -000138c0: 7573 6573 2074 6865 2027 636f 6e66 6967 uses the 'config │ │ │ │ -000138d0: 6669 6c65 2720 636f 6d6d 616e 640a 746f file' command.to │ │ │ │ -000138e0: 206c 6f61 6420 616e 6f74 6865 7220 6669 load another fi │ │ │ │ -000138f0: 6c65 2e20 2054 6865 2066 6f6c 6c6f 7769 le. The followi │ │ │ │ -00013900: 6e67 2065 7861 6d70 6c65 206f 6620 7468 ng example of th │ │ │ │ -00013910: 6973 2061 6c73 6f20 7265 7175 6972 6573 is also requires │ │ │ │ -00013920: 2074 6865 0a27 6563 686f 272c 2027 7365 the.'echo', 'se │ │ │ │ -00013930: 6172 6368 5f6c 6162 656c 272c 2061 6e64 arch_label', and │ │ │ │ -00013940: 2027 7465 7374 2720 6d6f 6475 6c65 7320 'test' modules │ │ │ │ -00013950: 746f 2062 6520 696e 636c 7564 6564 2069 to be included i │ │ │ │ -00013960: 6e20 7468 6520 636f 7265 0a69 6d61 6765 n the core.image │ │ │ │ -00013970: 3a0a 0a20 2020 2020 7365 6172 6368 2e66 :.. search.f │ │ │ │ -00013980: 735f 6c61 6265 6c20 6772 7562 2072 6f6f s_label grub roo │ │ │ │ -00013990: 740a 2020 2020 2069 6620 5b20 2d65 202f t. if [ -e / │ │ │ │ -000139a0: 626f 6f74 2f67 7275 622f 6578 616d 706c boot/grub/exampl │ │ │ │ -000139b0: 652f 7465 7374 312e 6366 6720 5d3b 2074 e/test1.cfg ]; t │ │ │ │ -000139c0: 6865 6e0a 2020 2020 2020 2020 2073 6574 hen. set │ │ │ │ -000139d0: 2070 7265 6669 783d 2824 726f 6f74 292f prefix=($root)/ │ │ │ │ -000139e0: 626f 6f74 2f67 7275 620a 2020 2020 2020 boot/grub. │ │ │ │ -000139f0: 2020 2063 6f6e 6669 6766 696c 6520 2f62 configfile /b │ │ │ │ -00013a00: 6f6f 742f 6772 7562 2f65 7861 6d70 6c65 oot/grub/example │ │ │ │ -00013a10: 2f74 6573 7431 2e63 6667 0a20 2020 2020 /test1.cfg. │ │ │ │ -00013a20: 656c 7365 0a20 2020 2020 2020 2020 6966 else. if │ │ │ │ -00013a30: 205b 202d 6520 2f62 6f6f 742f 6772 7562 [ -e /boot/grub │ │ │ │ -00013a40: 2f65 7861 6d70 6c65 2f74 6573 7432 2e63 /example/test2.c │ │ │ │ -00013a50: 6667 205d 3b20 7468 656e 0a20 2020 2020 fg ]; then. │ │ │ │ -00013a60: 2020 2020 2020 2020 7365 7420 7072 6566 set pref │ │ │ │ -00013a70: 6978 3d28 2472 6f6f 7429 2f62 6f6f 742f ix=($root)/boot/ │ │ │ │ -00013a80: 6772 7562 0a20 2020 2020 2020 2020 2020 grub. │ │ │ │ -00013a90: 2020 636f 6e66 6967 6669 6c65 202f 626f configfile /bo │ │ │ │ -00013aa0: 6f74 2f67 7275 622f 6578 616d 706c 652f ot/grub/example/ │ │ │ │ -00013ab0: 7465 7374 322e 6366 670a 2020 2020 2020 test2.cfg. │ │ │ │ -00013ac0: 2020 2065 6c73 650a 2020 2020 2020 2020 else. │ │ │ │ -00013ad0: 2020 2020 2065 6368 6f20 2243 6f75 6c64 echo "Could │ │ │ │ -00013ae0: 206e 6f74 2066 696e 6420 616e 2065 7861 not find an exa │ │ │ │ -00013af0: 6d70 6c65 2063 6f6e 6669 6775 7261 7469 mple configurati │ │ │ │ -00013b00: 6f6e 2066 696c 6521 220a 2020 2020 2020 on file!". │ │ │ │ -00013b10: 2020 2066 690a 2020 2020 2066 690a 0a20 fi. fi.. │ │ │ │ -00013b20: 2020 5468 6520 656d 6265 6464 6564 2063 The embedded c │ │ │ │ -00013b30: 6f6e 6669 6775 7261 7469 6f6e 2066 696c onfiguration fil │ │ │ │ -00013b40: 6520 6d61 7920 6e6f 7420 636f 6e74 6169 e may not contai │ │ │ │ -00013b50: 6e20 6d65 6e75 2065 6e74 7269 6573 0a64 n menu entries.d │ │ │ │ -00013b60: 6972 6563 746c 792c 2062 7574 206d 6179 irectly, but may │ │ │ │ -00013b70: 206f 6e6c 7920 7265 6164 2074 6865 6d20 only read them │ │ │ │ -00013b80: 6672 6f6d 2065 6c73 6577 6865 7265 2075 from elsewhere u │ │ │ │ -00013b90: 7369 6e67 2027 636f 6e66 6967 6669 6c65 sing 'configfile │ │ │ │ -00013ba0: 272e 0a0a 1f0a 4669 6c65 3a20 6772 7562 '.....File: grub │ │ │ │ -00013bb0: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 5468 .info, Node: Th │ │ │ │ -00013bc0: 656d 6520 6669 6c65 2066 6f72 6d61 742c eme file format, │ │ │ │ -00013bd0: 2020 4e65 7874 3a20 4e65 7477 6f72 6b2c Next: Network, │ │ │ │ -00013be0: 2020 5072 6576 3a20 436f 6e66 6967 7572 Prev: Configur │ │ │ │ -00013bf0: 6174 696f 6e2c 2020 5570 3a20 546f 700a ation, Up: Top. │ │ │ │ -00013c00: 0a37 2054 6865 6d65 2066 696c 6520 666f .7 Theme file fo │ │ │ │ -00013c10: 726d 6174 0a2a 2a2a 2a2a 2a2a 2a2a 2a2a rmat.*********** │ │ │ │ -00013c20: 2a2a 2a2a 2a2a 2a2a 0a0a 372e 3120 496e ********..7.1 In │ │ │ │ -00013c30: 7472 6f64 7563 7469 6f6e 0a3d 3d3d 3d3d troduction.===== │ │ │ │ -00013c40: 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a54 6865 ===========..The │ │ │ │ -00013c50: 2047 5255 4220 6772 6170 6869 6361 6c20 GRUB graphical │ │ │ │ -00013c60: 6d65 6e75 2073 7570 706f 7274 7320 7468 menu supports th │ │ │ │ -00013c70: 656d 6573 2074 6861 7420 6361 6e20 6375 emes that can cu │ │ │ │ -00013c80: 7374 6f6d 697a 6520 7468 6520 6c61 796f stomize the layo │ │ │ │ -00013c90: 7574 0a61 6e64 2061 7070 6561 7261 6e63 ut.and appearanc │ │ │ │ -00013ca0: 6520 6f66 2074 6865 2047 5255 4220 626f e of the GRUB bo │ │ │ │ -00013cb0: 6f74 206d 656e 752e 2020 5468 6520 7468 ot menu. The th │ │ │ │ -00013cc0: 656d 6520 6973 2063 6f6e 6669 6775 7265 eme is configure │ │ │ │ -00013cd0: 6420 7468 726f 7567 6820 610a 706c 6169 d through a.plai │ │ │ │ -00013ce0: 6e20 7465 7874 2066 696c 6520 7468 6174 n text file that │ │ │ │ -00013cf0: 2073 7065 6369 6669 6573 2074 6865 206c specifies the l │ │ │ │ -00013d00: 6179 6f75 7420 6f66 2074 6865 2076 6172 ayout of the var │ │ │ │ -00013d10: 696f 7573 2047 5549 2063 6f6d 706f 6e65 ious GUI compone │ │ │ │ -00013d20: 6e74 730a 2869 6e63 6c75 6469 6e67 2074 nts.(including t │ │ │ │ -00013d30: 6865 2062 6f6f 7420 6d65 6e75 2c20 7469 he boot menu, ti │ │ │ │ -00013d40: 6d65 6f75 7420 7072 6f67 7265 7373 2062 meout progress b │ │ │ │ -00013d50: 6172 2c20 616e 6420 7465 7874 206d 6573 ar, and text mes │ │ │ │ -00013d60: 7361 6765 7329 2061 730a 7765 6c6c 2061 sages) as.well a │ │ │ │ -00013d70: 7320 7468 6520 6170 7065 6172 616e 6365 s the appearance │ │ │ │ -00013d80: 2075 7369 6e67 2063 6f6c 6f72 732c 2066 using colors, f │ │ │ │ -00013d90: 6f6e 7473 2c20 616e 6420 696d 6167 6573 onts, and images │ │ │ │ -00013da0: 2e20 2045 7861 6d70 6c65 2069 730a 6176 . Example is.av │ │ │ │ -00013db0: 6169 6c61 626c 6520 696e 2064 6f63 732f ailable in docs/ │ │ │ │ -00013dc0: 6578 616d 706c 655f 7468 656d 652e 7478 example_theme.tx │ │ │ │ -00013dd0: 740a 0a37 2e32 2054 6865 6d65 2045 6c65 t..7.2 Theme Ele │ │ │ │ -00013de0: 6d65 6e74 730a 3d3d 3d3d 3d3d 3d3d 3d3d ments.========== │ │ │ │ -00013df0: 3d3d 3d3d 3d3d 3d3d 0a0a 372e 322e 3120 ========..7.2.1 │ │ │ │ -00013e00: 436f 6c6f 7273 0a2d 2d2d 2d2d 2d2d 2d2d Colors.--------- │ │ │ │ -00013e10: 2d2d 2d0a 0a43 6f6c 6f72 7320 6361 6e20 ---..Colors can │ │ │ │ -00013e20: 6265 2073 7065 6369 6669 6564 2069 6e20 be specified in │ │ │ │ -00013e30: 7365 7665 7261 6c20 7761 7973 3a0a 0a20 several ways:.. │ │ │ │ -00013e40: 2020 2a20 4854 4d4c 2d73 7479 6c65 2022 * HTML-style " │ │ │ │ -00013e50: 2352 5247 4742 4222 206f 7220 2223 5247 #RRGGBB" or "#RG │ │ │ │ -00013e60: 4222 2066 6f72 6d61 742c 2077 6865 7265 B" format, where │ │ │ │ -00013e70: 202a 522a 2c20 2a47 2a2c 2061 6e64 202a *R*, *G*, and * │ │ │ │ -00013e80: 422a 2061 7265 0a20 2020 2020 6865 7861 B* are. hexa │ │ │ │ -00013e90: 6465 6369 6d61 6c20 6469 6769 7473 2028 decimal digits ( │ │ │ │ -00013ea0: 652e 672e 2c20 2223 3838 3939 4646 2229 e.g., "#8899FF") │ │ │ │ -00013eb0: 0a20 2020 2a20 6173 2063 6f6d 6d61 2d73 . * as comma-s │ │ │ │ -00013ec0: 6570 6172 6174 6564 2064 6563 696d 616c eparated decimal │ │ │ │ -00013ed0: 2052 4742 2076 616c 7565 7320 2865 2e67 RGB values (e.g │ │ │ │ -00013ee0: 2e2c 2022 3132 382c 2031 3238 2c20 3235 ., "128, 128, 25 │ │ │ │ -00013ef0: 3522 290a 2020 202a 2077 6974 6820 2253 5"). * with "S │ │ │ │ -00013f00: 5647 2031 2e30 2063 6f6c 6f72 206e 616d VG 1.0 color nam │ │ │ │ -00013f10: 6573 2220 2865 2e67 2e2c 2022 636f 726e es" (e.g., "corn │ │ │ │ -00013f20: 666c 6f77 6572 626c 7565 2229 2077 6869 flowerblue") whi │ │ │ │ -00013f30: 6368 206d 7573 7420 6265 0a20 2020 2020 ch must be. │ │ │ │ -00013f40: 7370 6563 6966 6965 6420 696e 206c 6f77 specified in low │ │ │ │ -00013f50: 6572 6361 7365 2e0a 0a37 2e32 2e32 2046 ercase...7.2.2 F │ │ │ │ -00013f60: 6f6e 7473 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d onts.----------- │ │ │ │ -00013f70: 0a0a 5468 6520 666f 6e74 7320 4752 5542 ..The fonts GRUB │ │ │ │ -00013f80: 2075 7365 7320 2250 4646 3220 666f 6e74 uses "PFF2 font │ │ │ │ -00013f90: 2066 6f72 6d61 7422 2062 6974 6d61 7020 format" bitmap │ │ │ │ -00013fa0: 666f 6e74 732e 2020 466f 6e74 7320 6172 fonts. Fonts ar │ │ │ │ -00013fb0: 650a 7370 6563 6966 6965 6420 7769 7468 e.specified with │ │ │ │ -00013fc0: 2066 756c 6c20 666f 6e74 206e 616d 6573 full font names │ │ │ │ -00013fd0: 2e20 2043 7572 7265 6e74 6c79 2074 6865 . Currently the │ │ │ │ -00013fe0: 7265 2069 7320 6e6f 2070 726f 7669 7369 re is no provisi │ │ │ │ -00013ff0: 6f6e 2066 6f72 2061 0a70 7265 6665 7265 on for a.prefere │ │ │ │ -00014000: 6e63 6520 6c69 7374 206f 6620 666f 6e74 nce list of font │ │ │ │ -00014010: 732c 206f 7220 6465 7269 7669 6e67 206f s, or deriving o │ │ │ │ -00014020: 6e65 2066 6f6e 7420 6672 6f6d 2061 6e6f ne font from ano │ │ │ │ -00014030: 7468 6572 2e20 2046 6f6e 7473 2061 7265 ther. Fonts are │ │ │ │ -00014040: 0a6c 6f61 6465 6420 7769 7468 2074 6865 .loaded with the │ │ │ │ -00014050: 2022 6c6f 6164 666f 6e74 2220 636f 6d6d "loadfont" comm │ │ │ │ -00014060: 616e 6420 696e 2047 5255 4220 282a 6e6f and in GRUB (*no │ │ │ │ -00014070: 7465 206c 6f61 6466 6f6e 743a 3a29 2e20 te loadfont::). │ │ │ │ -00014080: 2054 6f20 7365 650a 7468 6520 6c69 7374 To see.the list │ │ │ │ -00014090: 206f 6620 6c6f 6164 6564 2066 6f6e 7473 of loaded fonts │ │ │ │ -000140a0: 2c20 6578 6563 7574 6520 7468 6520 226c , execute the "l │ │ │ │ -000140b0: 7366 6f6e 7473 2220 636f 6d6d 616e 6420 sfonts" command │ │ │ │ -000140c0: 282a 6e6f 7465 0a6c 7366 6f6e 7473 3a3a (*note.lsfonts:: │ │ │ │ -000140d0: 292e 2020 4966 2074 6865 7265 2061 7265 ). If there are │ │ │ │ -000140e0: 2074 6f6f 206d 616e 7920 666f 6e74 7320 too many fonts │ │ │ │ -000140f0: 746f 2066 6974 206f 6e20 7363 7265 656e to fit on screen │ │ │ │ -00014100: 2c20 646f 2022 7365 740a 7061 6765 723d , do "set.pager= │ │ │ │ -00014110: 3122 2062 6566 6f72 6520 6578 6563 7574 1" before execut │ │ │ │ -00014120: 696e 6720 226c 7366 6f6e 7473 222e 0a0a ing "lsfonts"... │ │ │ │ -00014130: 372e 322e 3320 5072 6f67 7265 7373 2042 7.2.3 Progress B │ │ │ │ -00014140: 6172 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ar.------------- │ │ │ │ -00014150: 2d2d 2d2d 2d0a 0a46 6967 7572 6520 372e -----..Figure 7. │ │ │ │ -00014160: 310a 0a46 6967 7572 6520 372e 320a 0a50 1..Figure 7.2..P │ │ │ │ -00014170: 726f 6772 6573 7320 6261 7273 2061 7265 rogress bars are │ │ │ │ -00014180: 2075 7365 6420 746f 2064 6973 706c 6179 used to display │ │ │ │ -00014190: 2074 6865 2072 656d 6169 6e69 6e67 2074 the remaining t │ │ │ │ -000141a0: 696d 6520 6265 666f 7265 2047 5255 4220 ime before GRUB │ │ │ │ -000141b0: 626f 6f74 730a 7468 6520 6465 6661 756c boots.the defaul │ │ │ │ -000141c0: 7420 6d65 6e75 2065 6e74 7279 2e20 2054 t menu entry. T │ │ │ │ -000141d0: 6f20 6372 6561 7465 2061 2070 726f 6772 o create a progr │ │ │ │ -000141e0: 6573 7320 6261 7220 7468 6174 2077 696c ess bar that wil │ │ │ │ -000141f0: 6c20 6469 7370 6c61 7920 7468 650a 7265 l display the.re │ │ │ │ -00014200: 6d61 696e 696e 6720 7469 6d65 2062 6566 maining time bef │ │ │ │ -00014210: 6f72 6520 6175 746f 6d61 7469 6320 626f ore automatic bo │ │ │ │ -00014220: 6f74 2c20 7369 6d70 6c79 2063 7265 6174 ot, simply creat │ │ │ │ -00014230: 6520 6120 2270 726f 6772 6573 735f 6261 e a "progress_ba │ │ │ │ -00014240: 7222 0a63 6f6d 706f 6e65 6e74 2077 6974 r".component wit │ │ │ │ -00014250: 6820 7468 6520 6964 2022 5f5f 7469 6d65 h the id "__time │ │ │ │ -00014260: 6f75 745f 5f22 2e20 2054 6869 7320 696e out__". This in │ │ │ │ -00014270: 6469 6361 7465 7320 746f 2047 5255 4220 dicates to GRUB │ │ │ │ -00014280: 7468 6174 2074 6865 0a70 726f 6772 6573 that the.progres │ │ │ │ -00014290: 7320 6261 7220 7368 6f75 6c64 2062 6520 s bar should be │ │ │ │ -000142a0: 7570 6461 7465 6420 6173 2074 696d 6520 updated as time │ │ │ │ -000142b0: 7061 7373 6573 2c20 616e 6420 6974 2073 passes, and it s │ │ │ │ -000142c0: 686f 756c 6420 6265 206d 6164 650a 696e hould be made.in │ │ │ │ -000142d0: 7669 7369 626c 6520 6966 2074 6865 2063 visible if the c │ │ │ │ -000142e0: 6f75 6e74 646f 776e 2074 6f20 6175 746f ountdown to auto │ │ │ │ -000142f0: 6d61 7469 6320 626f 6f74 2069 7320 696e matic boot is in │ │ │ │ -00014300: 7465 7272 7570 7465 6420 6279 2074 6865 terrupted by the │ │ │ │ -00014310: 2075 7365 722e 0a0a 2020 2050 726f 6772 user... Progr │ │ │ │ -00014320: 6573 7320 6261 7273 206d 6179 206f 7074 ess bars may opt │ │ │ │ -00014330: 696f 6e61 6c6c 7920 6861 7665 2074 6578 ionally have tex │ │ │ │ -00014340: 7420 6469 7370 6c61 7965 6420 6f6e 2074 t displayed on t │ │ │ │ -00014350: 6865 6d2e 2020 5468 6973 2074 6578 740a hem. This text. │ │ │ │ -00014360: 6973 2063 6f6e 7472 6f6c 6c65 6420 6279 is controlled by │ │ │ │ -00014370: 2076 6172 6961 626c 6520 2274 6578 7422 variable "text" │ │ │ │ -00014380: 2077 6869 6368 2063 6f6e 7461 696e 7320 which contains │ │ │ │ -00014390: 6120 7072 696e 7466 2074 656d 706c 6174 a printf templat │ │ │ │ -000143a0: 6520 7769 7468 0a74 6865 206f 6e6c 7920 e with.the only │ │ │ │ -000143b0: 6172 6775 6d65 6e74 2025 6420 6973 2074 argument %d is t │ │ │ │ -000143c0: 6865 206e 756d 6265 7220 6f66 2073 6563 he number of sec │ │ │ │ -000143d0: 6f6e 6473 2072 656d 6169 6e69 6e67 2e20 onds remaining. │ │ │ │ -000143e0: 2041 6464 6974 696f 6e61 6c6c 790a 7370 Additionally.sp │ │ │ │ -000143f0: 6563 6961 6c20 7661 6c75 6573 2022 4054 ecial values "@T │ │ │ │ -00014400: 494d 454f 5554 5f4e 4f54 4946 4943 4154 IMEOUT_NOTIFICAT │ │ │ │ -00014410: 494f 4e5f 5348 4f52 5440 222c 0a22 4054 ION_SHORT@",."@T │ │ │ │ -00014420: 494d 454f 5554 5f4e 4f54 4946 4943 4154 IMEOUT_NOTIFICAT │ │ │ │ -00014430: 494f 4e5f 4d49 4444 4c45 4022 2c20 2240 ION_MIDDLE@", "@ │ │ │ │ -00014440: 5449 4d45 4f55 545f 4e4f 5449 4649 4341 TIMEOUT_NOTIFICA │ │ │ │ -00014450: 5449 4f4e 5f4c 4f4e 4740 2220 6172 650a TION_LONG@" are. │ │ │ │ -00014460: 7265 706c 6163 6564 2077 6974 6820 7374 replaced with st │ │ │ │ -00014470: 616e 6461 7264 2061 6e64 2074 7261 6e73 andard and trans │ │ │ │ -00014480: 6c61 7465 6420 7465 6d70 6c61 7465 732e lated templates. │ │ │ │ -00014490: 0a0a 372e 322e 3420 4369 7263 756c 6172 ..7.2.4 Circular │ │ │ │ -000144a0: 2050 726f 6772 6573 7320 496e 6469 6361 Progress Indica │ │ │ │ -000144b0: 746f 720a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d tor.------------ │ │ │ │ +00013150: 3d3d 3d3d 0a0a 4752 5542 2073 7570 706f ====..GRUB suppo │ │ │ │ +00013160: 7274 7320 656d 6265 6464 696e 6720 6120 rts embedding a │ │ │ │ +00013170: 636f 6e66 6967 7572 6174 696f 6e20 6669 configuration fi │ │ │ │ +00013180: 6c65 2064 6972 6563 746c 7920 696e 746f le directly into │ │ │ │ +00013190: 2074 6865 2063 6f72 650a 696d 6167 652c the core.image, │ │ │ │ +000131a0: 2073 6f20 7468 6174 2069 7420 6973 206c so that it is l │ │ │ │ +000131b0: 6f61 6465 6420 6265 666f 7265 2065 6e74 oaded before ent │ │ │ │ +000131c0: 6572 696e 6720 6e6f 726d 616c 206d 6f64 ering normal mod │ │ │ │ +000131d0: 652e 2020 5468 6973 2069 730a 7573 6566 e. This is.usef │ │ │ │ +000131e0: 756c 2c20 666f 7220 6578 616d 706c 652c ul, for example, │ │ │ │ +000131f0: 2077 6865 6e20 6974 2069 7320 6e6f 7420 when it is not │ │ │ │ +00013200: 7374 7261 6967 6874 666f 7277 6172 6420 straightforward │ │ │ │ +00013210: 746f 2066 696e 6420 7468 6520 7265 616c to find the real │ │ │ │ +00013220: 0a63 6f6e 6669 6775 7261 7469 6f6e 2066 .configuration f │ │ │ │ +00013230: 696c 652c 206f 7220 7768 656e 2079 6f75 ile, or when you │ │ │ │ +00013240: 206e 6565 6420 746f 2064 6562 7567 2070 need to debug p │ │ │ │ +00013250: 726f 626c 656d 7320 7769 7468 206c 6f61 roblems with loa │ │ │ │ +00013260: 6469 6e67 2074 6861 740a 6669 6c65 2e20 ding that.file. │ │ │ │ +00013270: 2027 6772 7562 2d69 6e73 7461 6c6c 2720 'grub-install' │ │ │ │ +00013280: 7573 6573 2074 6869 7320 6665 6174 7572 uses this featur │ │ │ │ +00013290: 6520 7768 656e 2069 7420 6973 206e 6f74 e when it is not │ │ │ │ +000132a0: 2075 7369 6e67 2042 494f 5320 6469 736b using BIOS disk │ │ │ │ +000132b0: 0a66 756e 6374 696f 6e73 206f 7220 7768 .functions or wh │ │ │ │ +000132c0: 656e 2069 6e73 7461 6c6c 696e 6720 746f en installing to │ │ │ │ +000132d0: 2061 2064 6966 6665 7265 6e74 2064 6973 a different dis │ │ │ │ +000132e0: 6b20 6672 6f6d 2074 6865 206f 6e65 2063 k from the one c │ │ │ │ +000132f0: 6f6e 7461 696e 696e 670a 272f 626f 6f74 ontaining.'/boot │ │ │ │ +00013300: 2f67 7275 6227 2c20 696e 2077 6869 6368 /grub', in which │ │ │ │ +00013310: 2063 6173 6520 6974 206e 6565 6473 2074 case it needs t │ │ │ │ +00013320: 6f20 7573 6520 7468 6520 2773 6561 7263 o use the 'searc │ │ │ │ +00013330: 6827 2063 6f6d 6d61 6e64 2028 2a6e 6f74 h' command (*not │ │ │ │ +00013340: 650a 7365 6172 6368 3a3a 2920 746f 2066 e.search::) to f │ │ │ │ +00013350: 696e 6420 272f 626f 6f74 2f67 7275 6227 ind '/boot/grub' │ │ │ │ +00013360: 2e0a 0a20 2020 546f 2065 6d62 6564 2061 ... To embed a │ │ │ │ +00013370: 2063 6f6e 6669 6775 7261 7469 6f6e 2066 configuration f │ │ │ │ +00013380: 696c 652c 2075 7365 2074 6865 2027 2d63 ile, use the '-c │ │ │ │ +00013390: 2720 6f70 7469 6f6e 2074 6f20 2767 7275 ' option to 'gru │ │ │ │ +000133a0: 622d 6d6b 696d 6167 6527 2e0a 5468 6520 b-mkimage'..The │ │ │ │ +000133b0: 6669 6c65 2069 7320 636f 7069 6564 2069 file is copied i │ │ │ │ +000133c0: 6e74 6f20 7468 6520 636f 7265 2069 6d61 nto the core ima │ │ │ │ +000133d0: 6765 2c20 736f 2069 7420 6d61 7920 7265 ge, so it may re │ │ │ │ +000133e0: 7369 6465 2061 6e79 7768 6572 6520 6f6e side anywhere on │ │ │ │ +000133f0: 2074 6865 0a66 696c 6520 7379 7374 656d the.file system │ │ │ │ +00013400: 2c20 616e 6420 6d61 7920 6265 2072 656d , and may be rem │ │ │ │ +00013410: 6f76 6564 2061 6674 6572 2072 756e 6e69 oved after runni │ │ │ │ +00013420: 6e67 2027 6772 7562 2d6d 6b69 6d61 6765 ng 'grub-mkimage │ │ │ │ +00013430: 272e 0a0a 2020 2041 6674 6572 2074 6865 '... After the │ │ │ │ +00013440: 2065 6d62 6564 6465 6420 636f 6e66 6967 embedded config │ │ │ │ +00013450: 7572 6174 696f 6e20 6669 6c65 2028 6966 uration file (if │ │ │ │ +00013460: 2061 6e79 2920 6973 2065 7865 6375 7465 any) is execute │ │ │ │ +00013470: 642c 2047 5255 4220 7769 6c6c 0a6c 6f61 d, GRUB will.loa │ │ │ │ +00013480: 6420 7468 6520 276e 6f72 6d61 6c27 206d d the 'normal' m │ │ │ │ +00013490: 6f64 756c 6520 282a 6e6f 7465 206e 6f72 odule (*note nor │ │ │ │ +000134a0: 6d61 6c3a 3a29 2c20 7768 6963 6820 7769 mal::), which wi │ │ │ │ +000134b0: 6c6c 2074 6865 6e20 7265 6164 2074 6865 ll then read the │ │ │ │ +000134c0: 2072 6561 6c0a 636f 6e66 6967 7572 6174 real.configurat │ │ │ │ +000134d0: 696f 6e20 6669 6c65 2066 726f 6d20 2724 ion file from '$ │ │ │ │ +000134e0: 7072 6566 6978 2f67 7275 622e 6366 6727 prefix/grub.cfg' │ │ │ │ +000134f0: 2e20 2042 7920 7468 6973 2070 6f69 6e74 . By this point │ │ │ │ +00013500: 2c20 7468 6520 2772 6f6f 7427 0a76 6172 , the 'root'.var │ │ │ │ +00013510: 6961 626c 6520 7769 6c6c 2061 6c73 6f20 iable will also │ │ │ │ +00013520: 6861 7665 2062 6565 6e20 7365 7420 746f have been set to │ │ │ │ +00013530: 2074 6865 2072 6f6f 7420 6465 7669 6365 the root device │ │ │ │ +00013540: 206e 616d 652e 2020 466f 7220 6578 616d name. For exam │ │ │ │ +00013550: 706c 652c 0a27 7072 6566 6978 2720 6d69 ple,.'prefix' mi │ │ │ │ +00013560: 6768 7420 6265 2073 6574 2074 6f20 2728 ght be set to '( │ │ │ │ +00013570: 6864 302c 3129 2f62 6f6f 742f 6772 7562 hd0,1)/boot/grub │ │ │ │ +00013580: 272c 2061 6e64 2027 726f 6f74 2720 6d69 ', and 'root' mi │ │ │ │ +00013590: 6768 7420 6265 2073 6574 2074 6f0a 2768 ght be set to.'h │ │ │ │ +000135a0: 6430 2c31 272e 2020 5468 7573 2c20 696e d0,1'. Thus, in │ │ │ │ +000135b0: 206d 6f73 7420 6361 7365 732c 2074 6865 most cases, the │ │ │ │ +000135c0: 2065 6d62 6564 6465 6420 636f 6e66 6967 embedded config │ │ │ │ +000135d0: 7572 6174 696f 6e20 6669 6c65 206f 6e6c uration file onl │ │ │ │ +000135e0: 790a 6e65 6564 7320 746f 2073 6574 2074 y.needs to set t │ │ │ │ +000135f0: 6865 2027 7072 6566 6978 2720 616e 6420 he 'prefix' and │ │ │ │ +00013600: 2772 6f6f 7427 2076 6172 6961 626c 6573 'root' variables │ │ │ │ +00013610: 2c20 616e 6420 7468 656e 2064 726f 7020 , and then drop │ │ │ │ +00013620: 7468 726f 7567 6820 746f 0a47 5255 4227 through to.GRUB' │ │ │ │ +00013630: 7320 6e6f 726d 616c 2070 726f 6365 7373 s normal process │ │ │ │ +00013640: 696e 672e 2020 4120 7479 7069 6361 6c20 ing. A typical │ │ │ │ +00013650: 6578 616d 706c 6520 6f66 2074 6869 7320 example of this │ │ │ │ +00013660: 6d69 6768 7420 6c6f 6f6b 206c 696b 650a might look like. │ │ │ │ +00013670: 7468 6973 3a0a 0a20 2020 2020 7365 6172 this:.. sear │ │ │ │ +00013680: 6368 2e66 735f 7575 6964 2030 3132 3334 ch.fs_uuid 01234 │ │ │ │ +00013690: 3536 372d 3839 6162 2d63 6465 662d 3031 567-89ab-cdef-01 │ │ │ │ +000136a0: 3233 2d34 3536 3738 3961 6263 6465 6620 23-456789abcdef │ │ │ │ +000136b0: 726f 6f74 0a20 2020 2020 7365 7420 7072 root. set pr │ │ │ │ +000136c0: 6566 6978 3d28 2472 6f6f 7429 2f62 6f6f efix=($root)/boo │ │ │ │ +000136d0: 742f 6772 7562 0a0a 2020 2028 5468 6520 t/grub.. (The │ │ │ │ +000136e0: 2773 6561 7263 685f 6673 5f75 7569 6427 'search_fs_uuid' │ │ │ │ +000136f0: 206d 6f64 756c 6520 6d75 7374 2062 6520 module must be │ │ │ │ +00013700: 696e 636c 7564 6564 2069 6e20 7468 6520 included in the │ │ │ │ +00013710: 636f 7265 2069 6d61 6765 2066 6f72 0a74 core image for.t │ │ │ │ +00013720: 6869 7320 6578 616d 706c 6520 746f 2077 his example to w │ │ │ │ +00013730: 6f72 6b2e 290a 0a20 2020 496e 206d 6f72 ork.).. In mor │ │ │ │ +00013740: 6520 636f 6d70 6c65 7820 6361 7365 732c e complex cases, │ │ │ │ +00013750: 2069 7420 6d61 7920 6265 2075 7365 6675 it may be usefu │ │ │ │ +00013760: 6c20 746f 2072 6561 6420 6f74 6865 7220 l to read other │ │ │ │ +00013770: 636f 6e66 6967 7572 6174 696f 6e0a 6669 configuration.fi │ │ │ │ +00013780: 6c65 7320 6469 7265 6374 6c79 2066 726f les directly fro │ │ │ │ +00013790: 6d20 7468 6520 656d 6265 6464 6564 2063 m the embedded c │ │ │ │ +000137a0: 6f6e 6669 6775 7261 7469 6f6e 2066 696c onfiguration fil │ │ │ │ +000137b0: 652e 2020 5468 6973 2061 6c6c 6f77 7320 e. This allows │ │ │ │ +000137c0: 7375 6368 0a74 6869 6e67 7320 6173 2072 such.things as r │ │ │ │ +000137d0: 6561 6469 6e67 2066 696c 6573 206e 6f74 eading files not │ │ │ │ +000137e0: 2063 616c 6c65 6420 2767 7275 622e 6366 called 'grub.cf │ │ │ │ +000137f0: 6727 2c20 6f72 2072 6561 6469 6e67 2066 g', or reading f │ │ │ │ +00013800: 696c 6573 2066 726f 6d20 610a 6469 7265 iles from a.dire │ │ │ │ +00013810: 6374 6f72 7920 6f74 6865 7220 7468 616e ctory other than │ │ │ │ +00013820: 2074 6861 7420 7768 6572 6520 4752 5542 that where GRUB │ │ │ │ +00013830: 2773 206c 6f61 6461 626c 6520 6d6f 6475 's loadable modu │ │ │ │ +00013840: 6c65 7320 6172 6520 696e 7374 616c 6c65 les are installe │ │ │ │ +00013850: 642e 0a54 6f20 646f 2074 6869 732c 2069 d..To do this, i │ │ │ │ +00013860: 6e63 6c75 6465 2074 6865 2027 636f 6e66 nclude the 'conf │ │ │ │ +00013870: 6967 6669 6c65 2720 616e 6420 276e 6f72 igfile' and 'nor │ │ │ │ +00013880: 6d61 6c27 206d 6f64 756c 6573 2069 6e20 mal' modules in │ │ │ │ +00013890: 7468 6520 636f 7265 0a69 6d61 6765 2c20 the core.image, │ │ │ │ +000138a0: 616e 6420 656d 6265 6420 6120 636f 6e66 and embed a conf │ │ │ │ +000138b0: 6967 7572 6174 696f 6e20 6669 6c65 2074 iguration file t │ │ │ │ +000138c0: 6861 7420 7573 6573 2074 6865 2027 636f hat uses the 'co │ │ │ │ +000138d0: 6e66 6967 6669 6c65 2720 636f 6d6d 616e nfigfile' comman │ │ │ │ +000138e0: 640a 746f 206c 6f61 6420 616e 6f74 6865 d.to load anothe │ │ │ │ +000138f0: 7220 6669 6c65 2e20 2054 6865 2066 6f6c r file. The fol │ │ │ │ +00013900: 6c6f 7769 6e67 2065 7861 6d70 6c65 206f lowing example o │ │ │ │ +00013910: 6620 7468 6973 2061 6c73 6f20 7265 7175 f this also requ │ │ │ │ +00013920: 6972 6573 2074 6865 0a27 6563 686f 272c ires the.'echo', │ │ │ │ +00013930: 2027 7365 6172 6368 5f6c 6162 656c 272c 'search_label', │ │ │ │ +00013940: 2061 6e64 2027 7465 7374 2720 6d6f 6475 and 'test' modu │ │ │ │ +00013950: 6c65 7320 746f 2062 6520 696e 636c 7564 les to be includ │ │ │ │ +00013960: 6564 2069 6e20 7468 6520 636f 7265 0a69 ed in the core.i │ │ │ │ +00013970: 6d61 6765 3a0a 0a20 2020 2020 7365 6172 mage:.. sear │ │ │ │ +00013980: 6368 2e66 735f 6c61 6265 6c20 6772 7562 ch.fs_label grub │ │ │ │ +00013990: 2072 6f6f 740a 2020 2020 2069 6620 5b20 root. if [ │ │ │ │ +000139a0: 2d65 202f 626f 6f74 2f67 7275 622f 6578 -e /boot/grub/ex │ │ │ │ +000139b0: 616d 706c 652f 7465 7374 312e 6366 6720 ample/test1.cfg │ │ │ │ +000139c0: 5d3b 2074 6865 6e0a 2020 2020 2020 2020 ]; then. │ │ │ │ +000139d0: 2073 6574 2070 7265 6669 783d 2824 726f set prefix=($ro │ │ │ │ +000139e0: 6f74 292f 626f 6f74 2f67 7275 620a 2020 ot)/boot/grub. │ │ │ │ +000139f0: 2020 2020 2020 2063 6f6e 6669 6766 696c configfil │ │ │ │ +00013a00: 6520 2f62 6f6f 742f 6772 7562 2f65 7861 e /boot/grub/exa │ │ │ │ +00013a10: 6d70 6c65 2f74 6573 7431 2e63 6667 0a20 mple/test1.cfg. │ │ │ │ +00013a20: 2020 2020 656c 7365 0a20 2020 2020 2020 else. │ │ │ │ +00013a30: 2020 6966 205b 202d 6520 2f62 6f6f 742f if [ -e /boot/ │ │ │ │ +00013a40: 6772 7562 2f65 7861 6d70 6c65 2f74 6573 grub/example/tes │ │ │ │ +00013a50: 7432 2e63 6667 205d 3b20 7468 656e 0a20 t2.cfg ]; then. │ │ │ │ +00013a60: 2020 2020 2020 2020 2020 2020 7365 7420 set │ │ │ │ +00013a70: 7072 6566 6978 3d28 2472 6f6f 7429 2f62 prefix=($root)/b │ │ │ │ +00013a80: 6f6f 742f 6772 7562 0a20 2020 2020 2020 oot/grub. │ │ │ │ +00013a90: 2020 2020 2020 636f 6e66 6967 6669 6c65 configfile │ │ │ │ +00013aa0: 202f 626f 6f74 2f67 7275 622f 6578 616d /boot/grub/exam │ │ │ │ +00013ab0: 706c 652f 7465 7374 322e 6366 670a 2020 ple/test2.cfg. │ │ │ │ +00013ac0: 2020 2020 2020 2065 6c73 650a 2020 2020 else. │ │ │ │ +00013ad0: 2020 2020 2020 2020 2065 6368 6f20 2243 echo "C │ │ │ │ +00013ae0: 6f75 6c64 206e 6f74 2066 696e 6420 616e ould not find an │ │ │ │ +00013af0: 2065 7861 6d70 6c65 2063 6f6e 6669 6775 example configu │ │ │ │ +00013b00: 7261 7469 6f6e 2066 696c 6521 220a 2020 ration file!". │ │ │ │ +00013b10: 2020 2020 2020 2066 690a 2020 2020 2066 fi. f │ │ │ │ +00013b20: 690a 0a20 2020 5468 6520 656d 6265 6464 i.. The embedd │ │ │ │ +00013b30: 6564 2063 6f6e 6669 6775 7261 7469 6f6e ed configuration │ │ │ │ +00013b40: 2066 696c 6520 6d61 7920 6e6f 7420 636f file may not co │ │ │ │ +00013b50: 6e74 6169 6e20 6d65 6e75 2065 6e74 7269 ntain menu entri │ │ │ │ +00013b60: 6573 0a64 6972 6563 746c 792c 2062 7574 es.directly, but │ │ │ │ +00013b70: 206d 6179 206f 6e6c 7920 7265 6164 2074 may only read t │ │ │ │ +00013b80: 6865 6d20 6672 6f6d 2065 6c73 6577 6865 hem from elsewhe │ │ │ │ +00013b90: 7265 2075 7369 6e67 2027 636f 6e66 6967 re using 'config │ │ │ │ +00013ba0: 6669 6c65 272e 0a0a 1f0a 4669 6c65 3a20 file'.....File: │ │ │ │ +00013bb0: 6772 7562 2e69 6e66 6f2c 2020 4e6f 6465 grub.info, Node │ │ │ │ +00013bc0: 3a20 5468 656d 6520 6669 6c65 2066 6f72 : Theme file for │ │ │ │ +00013bd0: 6d61 742c 2020 4e65 7874 3a20 4e65 7477 mat, Next: Netw │ │ │ │ +00013be0: 6f72 6b2c 2020 5072 6576 3a20 436f 6e66 ork, Prev: Conf │ │ │ │ +00013bf0: 6967 7572 6174 696f 6e2c 2020 5570 3a20 iguration, Up: │ │ │ │ +00013c00: 546f 700a 0a37 2054 6865 6d65 2066 696c Top..7 Theme fil │ │ │ │ +00013c10: 6520 666f 726d 6174 0a2a 2a2a 2a2a 2a2a e format.******* │ │ │ │ +00013c20: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 0a0a 372e ************..7. │ │ │ │ +00013c30: 3120 496e 7472 6f64 7563 7469 6f6e 0a3d 1 Introduction.= │ │ │ │ +00013c40: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a ===============. │ │ │ │ +00013c50: 0a54 6865 2047 5255 4220 6772 6170 6869 .The GRUB graphi │ │ │ │ +00013c60: 6361 6c20 6d65 6e75 2073 7570 706f 7274 cal menu support │ │ │ │ +00013c70: 7320 7468 656d 6573 2074 6861 7420 6361 s themes that ca │ │ │ │ +00013c80: 6e20 6375 7374 6f6d 697a 6520 7468 6520 n customize the │ │ │ │ +00013c90: 6c61 796f 7574 0a61 6e64 2061 7070 6561 layout.and appea │ │ │ │ +00013ca0: 7261 6e63 6520 6f66 2074 6865 2047 5255 rance of the GRU │ │ │ │ +00013cb0: 4220 626f 6f74 206d 656e 752e 2020 5468 B boot menu. Th │ │ │ │ +00013cc0: 6520 7468 656d 6520 6973 2063 6f6e 6669 e theme is confi │ │ │ │ +00013cd0: 6775 7265 6420 7468 726f 7567 6820 610a gured through a. │ │ │ │ +00013ce0: 706c 6169 6e20 7465 7874 2066 696c 6520 plain text file │ │ │ │ +00013cf0: 7468 6174 2073 7065 6369 6669 6573 2074 that specifies t │ │ │ │ +00013d00: 6865 206c 6179 6f75 7420 6f66 2074 6865 he layout of the │ │ │ │ +00013d10: 2076 6172 696f 7573 2047 5549 2063 6f6d various GUI com │ │ │ │ +00013d20: 706f 6e65 6e74 730a 2869 6e63 6c75 6469 ponents.(includi │ │ │ │ +00013d30: 6e67 2074 6865 2062 6f6f 7420 6d65 6e75 ng the boot menu │ │ │ │ +00013d40: 2c20 7469 6d65 6f75 7420 7072 6f67 7265 , timeout progre │ │ │ │ +00013d50: 7373 2062 6172 2c20 616e 6420 7465 7874 ss bar, and text │ │ │ │ +00013d60: 206d 6573 7361 6765 7329 2061 730a 7765 messages) as.we │ │ │ │ +00013d70: 6c6c 2061 7320 7468 6520 6170 7065 6172 ll as the appear │ │ │ │ +00013d80: 616e 6365 2075 7369 6e67 2063 6f6c 6f72 ance using color │ │ │ │ +00013d90: 732c 2066 6f6e 7473 2c20 616e 6420 696d s, fonts, and im │ │ │ │ +00013da0: 6167 6573 2e20 2045 7861 6d70 6c65 2069 ages. Example i │ │ │ │ +00013db0: 730a 6176 6169 6c61 626c 6520 696e 2064 s.available in d │ │ │ │ +00013dc0: 6f63 732f 6578 616d 706c 655f 7468 656d ocs/example_them │ │ │ │ +00013dd0: 652e 7478 740a 0a37 2e32 2054 6865 6d65 e.txt..7.2 Theme │ │ │ │ +00013de0: 2045 6c65 6d65 6e74 730a 3d3d 3d3d 3d3d Elements.====== │ │ │ │ +00013df0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a 372e ============..7. │ │ │ │ +00013e00: 322e 3120 436f 6c6f 7273 0a2d 2d2d 2d2d 2.1 Colors.----- │ │ │ │ +00013e10: 2d2d 2d2d 2d2d 2d0a 0a43 6f6c 6f72 7320 -------..Colors │ │ │ │ +00013e20: 6361 6e20 6265 2073 7065 6369 6669 6564 can be specified │ │ │ │ +00013e30: 2069 6e20 7365 7665 7261 6c20 7761 7973 in several ways │ │ │ │ +00013e40: 3a0a 0a20 2020 2a20 4854 4d4c 2d73 7479 :.. * HTML-sty │ │ │ │ +00013e50: 6c65 2022 2352 5247 4742 4222 206f 7220 le "#RRGGBB" or │ │ │ │ +00013e60: 2223 5247 4222 2066 6f72 6d61 742c 2077 "#RGB" format, w │ │ │ │ +00013e70: 6865 7265 202a 522a 2c20 2a47 2a2c 2061 here *R*, *G*, a │ │ │ │ +00013e80: 6e64 202a 422a 2061 7265 0a20 2020 2020 nd *B* are. │ │ │ │ +00013e90: 6865 7861 6465 6369 6d61 6c20 6469 6769 hexadecimal digi │ │ │ │ +00013ea0: 7473 2028 652e 672e 2c20 2223 3838 3939 ts (e.g., "#8899 │ │ │ │ +00013eb0: 4646 2229 0a20 2020 2a20 6173 2063 6f6d FF"). * as com │ │ │ │ +00013ec0: 6d61 2d73 6570 6172 6174 6564 2064 6563 ma-separated dec │ │ │ │ +00013ed0: 696d 616c 2052 4742 2076 616c 7565 7320 imal RGB values │ │ │ │ +00013ee0: 2865 2e67 2e2c 2022 3132 382c 2031 3238 (e.g., "128, 128 │ │ │ │ +00013ef0: 2c20 3235 3522 290a 2020 202a 2077 6974 , 255"). * wit │ │ │ │ +00013f00: 6820 2253 5647 2031 2e30 2063 6f6c 6f72 h "SVG 1.0 color │ │ │ │ +00013f10: 206e 616d 6573 2220 2865 2e67 2e2c 2022 names" (e.g., " │ │ │ │ +00013f20: 636f 726e 666c 6f77 6572 626c 7565 2229 cornflowerblue") │ │ │ │ +00013f30: 2077 6869 6368 206d 7573 7420 6265 0a20 which must be. │ │ │ │ +00013f40: 2020 2020 7370 6563 6966 6965 6420 696e specified in │ │ │ │ +00013f50: 206c 6f77 6572 6361 7365 2e0a 0a37 2e32 lowercase...7.2 │ │ │ │ +00013f60: 2e32 2046 6f6e 7473 0a2d 2d2d 2d2d 2d2d .2 Fonts.------- │ │ │ │ +00013f70: 2d2d 2d2d 0a0a 5468 6520 666f 6e74 7320 ----..The fonts │ │ │ │ +00013f80: 4752 5542 2075 7365 7320 2250 4646 3220 GRUB uses "PFF2 │ │ │ │ +00013f90: 666f 6e74 2066 6f72 6d61 7422 2062 6974 font format" bit │ │ │ │ +00013fa0: 6d61 7020 666f 6e74 732e 2020 466f 6e74 map fonts. Font │ │ │ │ +00013fb0: 7320 6172 650a 7370 6563 6966 6965 6420 s are.specified │ │ │ │ +00013fc0: 7769 7468 2066 756c 6c20 666f 6e74 206e with full font n │ │ │ │ +00013fd0: 616d 6573 2e20 2043 7572 7265 6e74 6c79 ames. Currently │ │ │ │ +00013fe0: 2074 6865 7265 2069 7320 6e6f 2070 726f there is no pro │ │ │ │ +00013ff0: 7669 7369 6f6e 2066 6f72 2061 0a70 7265 vision for a.pre │ │ │ │ +00014000: 6665 7265 6e63 6520 6c69 7374 206f 6620 ference list of │ │ │ │ +00014010: 666f 6e74 732c 206f 7220 6465 7269 7669 fonts, or derivi │ │ │ │ +00014020: 6e67 206f 6e65 2066 6f6e 7420 6672 6f6d ng one font from │ │ │ │ +00014030: 2061 6e6f 7468 6572 2e20 2046 6f6e 7473 another. Fonts │ │ │ │ +00014040: 2061 7265 0a6c 6f61 6465 6420 7769 7468 are.loaded with │ │ │ │ +00014050: 2074 6865 2022 6c6f 6164 666f 6e74 2220 the "loadfont" │ │ │ │ +00014060: 636f 6d6d 616e 6420 696e 2047 5255 4220 command in GRUB │ │ │ │ +00014070: 282a 6e6f 7465 206c 6f61 6466 6f6e 743a (*note loadfont: │ │ │ │ +00014080: 3a29 2e20 2054 6f20 7365 650a 7468 6520 :). To see.the │ │ │ │ +00014090: 6c69 7374 206f 6620 6c6f 6164 6564 2066 list of loaded f │ │ │ │ +000140a0: 6f6e 7473 2c20 6578 6563 7574 6520 7468 onts, execute th │ │ │ │ +000140b0: 6520 226c 7366 6f6e 7473 2220 636f 6d6d e "lsfonts" comm │ │ │ │ +000140c0: 616e 6420 282a 6e6f 7465 0a6c 7366 6f6e and (*note.lsfon │ │ │ │ +000140d0: 7473 3a3a 292e 2020 4966 2074 6865 7265 ts::). If there │ │ │ │ +000140e0: 2061 7265 2074 6f6f 206d 616e 7920 666f are too many fo │ │ │ │ +000140f0: 6e74 7320 746f 2066 6974 206f 6e20 7363 nts to fit on sc │ │ │ │ +00014100: 7265 656e 2c20 646f 2022 7365 740a 7061 reen, do "set.pa │ │ │ │ +00014110: 6765 723d 3122 2062 6566 6f72 6520 6578 ger=1" before ex │ │ │ │ +00014120: 6563 7574 696e 6720 226c 7366 6f6e 7473 ecuting "lsfonts │ │ │ │ +00014130: 222e 0a0a 372e 322e 3320 5072 6f67 7265 "...7.2.3 Progre │ │ │ │ +00014140: 7373 2042 6172 0a2d 2d2d 2d2d 2d2d 2d2d ss Bar.--------- │ │ │ │ +00014150: 2d2d 2d2d 2d2d 2d2d 2d0a 0a46 6967 7572 ---------..Figur │ │ │ │ +00014160: 6520 372e 310a 0a46 6967 7572 6520 372e e 7.1..Figure 7. │ │ │ │ +00014170: 320a 0a50 726f 6772 6573 7320 6261 7273 2..Progress bars │ │ │ │ +00014180: 2061 7265 2075 7365 6420 746f 2064 6973 are used to dis │ │ │ │ +00014190: 706c 6179 2074 6865 2072 656d 6169 6e69 play the remaini │ │ │ │ +000141a0: 6e67 2074 696d 6520 6265 666f 7265 2047 ng time before G │ │ │ │ +000141b0: 5255 4220 626f 6f74 730a 7468 6520 6465 RUB boots.the de │ │ │ │ +000141c0: 6661 756c 7420 6d65 6e75 2065 6e74 7279 fault menu entry │ │ │ │ +000141d0: 2e20 2054 6f20 6372 6561 7465 2061 2070 . To create a p │ │ │ │ +000141e0: 726f 6772 6573 7320 6261 7220 7468 6174 rogress bar that │ │ │ │ +000141f0: 2077 696c 6c20 6469 7370 6c61 7920 7468 will display th │ │ │ │ +00014200: 650a 7265 6d61 696e 696e 6720 7469 6d65 e.remaining time │ │ │ │ +00014210: 2062 6566 6f72 6520 6175 746f 6d61 7469 before automati │ │ │ │ +00014220: 6320 626f 6f74 2c20 7369 6d70 6c79 2063 c boot, simply c │ │ │ │ +00014230: 7265 6174 6520 6120 2270 726f 6772 6573 reate a "progres │ │ │ │ +00014240: 735f 6261 7222 0a63 6f6d 706f 6e65 6e74 s_bar".component │ │ │ │ +00014250: 2077 6974 6820 7468 6520 6964 2022 5f5f with the id "__ │ │ │ │ +00014260: 7469 6d65 6f75 745f 5f22 2e20 2054 6869 timeout__". Thi │ │ │ │ +00014270: 7320 696e 6469 6361 7465 7320 746f 2047 s indicates to G │ │ │ │ +00014280: 5255 4220 7468 6174 2074 6865 0a70 726f RUB that the.pro │ │ │ │ +00014290: 6772 6573 7320 6261 7220 7368 6f75 6c64 gress bar should │ │ │ │ +000142a0: 2062 6520 7570 6461 7465 6420 6173 2074 be updated as t │ │ │ │ +000142b0: 696d 6520 7061 7373 6573 2c20 616e 6420 ime passes, and │ │ │ │ +000142c0: 6974 2073 686f 756c 6420 6265 206d 6164 it should be mad │ │ │ │ +000142d0: 650a 696e 7669 7369 626c 6520 6966 2074 e.invisible if t │ │ │ │ +000142e0: 6865 2063 6f75 6e74 646f 776e 2074 6f20 he countdown to │ │ │ │ +000142f0: 6175 746f 6d61 7469 6320 626f 6f74 2069 automatic boot i │ │ │ │ +00014300: 7320 696e 7465 7272 7570 7465 6420 6279 s interrupted by │ │ │ │ +00014310: 2074 6865 2075 7365 722e 0a0a 2020 2050 the user... P │ │ │ │ +00014320: 726f 6772 6573 7320 6261 7273 206d 6179 rogress bars may │ │ │ │ +00014330: 206f 7074 696f 6e61 6c6c 7920 6861 7665 optionally have │ │ │ │ +00014340: 2074 6578 7420 6469 7370 6c61 7965 6420 text displayed │ │ │ │ +00014350: 6f6e 2074 6865 6d2e 2020 5468 6973 2074 on them. This t │ │ │ │ +00014360: 6578 740a 6973 2063 6f6e 7472 6f6c 6c65 ext.is controlle │ │ │ │ +00014370: 6420 6279 2076 6172 6961 626c 6520 2274 d by variable "t │ │ │ │ +00014380: 6578 7422 2077 6869 6368 2063 6f6e 7461 ext" which conta │ │ │ │ +00014390: 696e 7320 6120 7072 696e 7466 2074 656d ins a printf tem │ │ │ │ +000143a0: 706c 6174 6520 7769 7468 0a74 6865 206f plate with.the o │ │ │ │ +000143b0: 6e6c 7920 6172 6775 6d65 6e74 2025 6420 nly argument %d │ │ │ │ +000143c0: 6973 2074 6865 206e 756d 6265 7220 6f66 is the number of │ │ │ │ +000143d0: 2073 6563 6f6e 6473 2072 656d 6169 6e69 seconds remaini │ │ │ │ +000143e0: 6e67 2e20 2041 6464 6974 696f 6e61 6c6c ng. Additionall │ │ │ │ +000143f0: 790a 7370 6563 6961 6c20 7661 6c75 6573 y.special values │ │ │ │ +00014400: 2022 4054 494d 454f 5554 5f4e 4f54 4946 "@TIMEOUT_NOTIF │ │ │ │ +00014410: 4943 4154 494f 4e5f 5348 4f52 5440 222c ICATION_SHORT@", │ │ │ │ +00014420: 0a22 4054 494d 454f 5554 5f4e 4f54 4946 ."@TIMEOUT_NOTIF │ │ │ │ +00014430: 4943 4154 494f 4e5f 4d49 4444 4c45 4022 ICATION_MIDDLE@" │ │ │ │ +00014440: 2c20 2240 5449 4d45 4f55 545f 4e4f 5449 , "@TIMEOUT_NOTI │ │ │ │ +00014450: 4649 4341 5449 4f4e 5f4c 4f4e 4740 2220 FICATION_LONG@" │ │ │ │ +00014460: 6172 650a 7265 706c 6163 6564 2077 6974 are.replaced wit │ │ │ │ +00014470: 6820 7374 616e 6461 7264 2061 6e64 2074 h standard and t │ │ │ │ +00014480: 7261 6e73 6c61 7465 6420 7465 6d70 6c61 ranslated templa │ │ │ │ +00014490: 7465 732e 0a0a 372e 322e 3420 4369 7263 tes...7.2.4 Circ │ │ │ │ +000144a0: 756c 6172 2050 726f 6772 6573 7320 496e ular Progress In │ │ │ │ +000144b0: 6469 6361 746f 720a 2d2d 2d2d 2d2d 2d2d dicator.-------- │ │ │ │ 000144c0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ -000144d0: 2d2d 2d2d 2d0a 0a54 6865 2063 6972 6375 -----..The circu │ │ │ │ -000144e0: 6c61 7220 7072 6f67 7265 7373 2069 6e64 lar progress ind │ │ │ │ -000144f0: 6963 6174 6f72 2066 756e 6374 696f 6e73 icator functions │ │ │ │ -00014500: 2073 696d 696c 6172 6c79 2074 6f20 7468 similarly to th │ │ │ │ -00014510: 6520 7072 6f67 7265 7373 2062 6172 2e0a e progress bar.. │ │ │ │ -00014520: 5768 656e 2067 6976 656e 2061 6e20 6964 When given an id │ │ │ │ -00014530: 206f 6620 225f 5f74 696d 656f 7574 5f5f of "__timeout__ │ │ │ │ -00014540: 222c 2047 5255 4220 7570 6461 7465 7320 ", GRUB updates │ │ │ │ -00014550: 7468 6520 6369 7263 756c 6172 2070 726f the circular pro │ │ │ │ -00014560: 6772 6573 730a 696e 6469 6361 746f 7227 gress.indicator' │ │ │ │ -00014570: 7320 7661 6c75 6520 746f 2069 6e64 6963 s value to indic │ │ │ │ -00014580: 6174 6520 7468 6520 7469 6d65 2072 656d ate the time rem │ │ │ │ -00014590: 6169 6e69 6e67 2e20 2046 6f72 2074 6865 aining. For the │ │ │ │ -000145a0: 2063 6972 6375 6c61 720a 7072 6f67 7265 circular.progre │ │ │ │ -000145b0: 7373 2069 6e64 6963 6174 6f72 2c20 7468 ss indicator, th │ │ │ │ -000145c0: 6572 6520 6172 6520 7477 6f20 696d 6167 ere are two imag │ │ │ │ -000145d0: 6573 2075 7365 6420 746f 2072 656e 6465 es used to rende │ │ │ │ -000145e0: 7220 6974 3a20 7468 6520 2a63 656e 7465 r it: the *cente │ │ │ │ -000145f0: 722a 0a69 6d61 6765 2c20 616e 6420 7468 r*.image, and th │ │ │ │ -00014600: 6520 2a74 6963 6b2a 2069 6d61 6765 2e20 e *tick* image. │ │ │ │ -00014610: 2054 6865 2063 656e 7465 7220 696d 6167 The center imag │ │ │ │ -00014620: 6520 6973 2072 656e 6465 7265 6420 696e e is rendered in │ │ │ │ -00014630: 2074 6865 2063 656e 7465 720a 6f66 2074 the center.of t │ │ │ │ -00014640: 6865 2063 6f6d 706f 6e65 6e74 2c20 7768 he component, wh │ │ │ │ -00014650: 696c 6520 7468 6520 7469 636b 2069 6d61 ile the tick ima │ │ │ │ -00014660: 6765 2069 7320 7573 6564 2074 6f20 7265 ge is used to re │ │ │ │ -00014670: 6e64 6572 2065 6163 6820 6d61 726b 2061 nder each mark a │ │ │ │ -00014680: 6c6f 6e67 0a74 6865 2063 6972 6375 6d66 long.the circumf │ │ │ │ -00014690: 6572 656e 6365 206f 6620 7468 6520 696e erence of the in │ │ │ │ -000146a0: 6469 6361 746f 722e 0a0a 372e 322e 3520 dicator...7.2.5 │ │ │ │ -000146b0: 4c61 6265 6c73 0a2d 2d2d 2d2d 2d2d 2d2d Labels.--------- │ │ │ │ -000146c0: 2d2d 2d0a 0a54 6578 7420 6c61 6265 6c73 ---..Text labels │ │ │ │ -000146d0: 2063 616e 2062 6520 706c 6163 6564 206f can be placed o │ │ │ │ -000146e0: 6e20 7468 6520 626f 6f74 2073 6372 6565 n the boot scree │ │ │ │ -000146f0: 6e2e 2020 5468 6520 666f 6e74 2c20 636f n. The font, co │ │ │ │ -00014700: 6c6f 722c 2061 6e64 0a68 6f72 697a 6f6e lor, and.horizon │ │ │ │ -00014710: 7461 6c20 616c 6967 6e6d 656e 7420 6361 tal alignment ca │ │ │ │ -00014720: 6e20 6265 2073 7065 6369 6669 6564 2066 n be specified f │ │ │ │ -00014730: 6f72 206c 6162 656c 732e 2020 4966 2061 or labels. If a │ │ │ │ -00014740: 206c 6162 656c 2069 7320 6769 7665 6e0a label is given. │ │ │ │ -00014750: 7468 6520 6964 2022 5f5f 7469 6d65 6f75 the id "__timeou │ │ │ │ -00014760: 745f 5f22 2c20 7468 656e 2074 6865 2022 t__", then the " │ │ │ │ -00014770: 7465 7874 2220 7072 6f70 6572 7479 2066 text" property f │ │ │ │ -00014780: 6f72 2074 6861 7420 6c61 6265 6c20 6973 or that label is │ │ │ │ -00014790: 2061 6c73 6f0a 7570 6461 7465 6420 7769 also.updated wi │ │ │ │ -000147a0: 7468 2061 206d 6573 7361 6765 2069 6e66 th a message inf │ │ │ │ -000147b0: 6f72 6d69 6e67 2074 6865 2075 7365 7220 orming the user │ │ │ │ -000147c0: 6f66 2074 6865 206e 756d 6265 7220 6f66 of the number of │ │ │ │ -000147d0: 2073 6563 6f6e 6473 0a72 656d 6169 6e69 seconds.remaini │ │ │ │ -000147e0: 6e67 2075 6e74 696c 2061 7574 6f6d 6174 ng until automat │ │ │ │ -000147f0: 6963 2062 6f6f 742e 2020 5468 6973 2069 ic boot. This i │ │ │ │ -00014800: 7320 7573 6566 756c 2069 6e20 6361 7365 s useful in case │ │ │ │ -00014810: 2079 6f75 2077 616e 7420 7468 650a 7465 you want the.te │ │ │ │ -00014820: 7874 2064 6973 706c 6179 6564 2073 6f6d xt displayed som │ │ │ │ -00014830: 6577 6865 7265 2065 6c73 6520 696e 7374 ewhere else inst │ │ │ │ -00014840: 6561 6420 6f66 2064 6972 6563 746c 7920 ead of directly │ │ │ │ -00014850: 6f6e 2074 6865 2070 726f 6772 6573 7320 on the progress │ │ │ │ -00014860: 6261 722e 0a0a 372e 322e 3620 426f 6f74 bar...7.2.6 Boot │ │ │ │ -00014870: 204d 656e 750a 2d2d 2d2d 2d2d 2d2d 2d2d Menu.---------- │ │ │ │ -00014880: 2d2d 2d2d 2d0a 0a54 6865 2062 6f6f 7420 -----..The boot │ │ │ │ -00014890: 6d65 6e75 2077 6865 7265 2047 5255 4220 menu where GRUB │ │ │ │ -000148a0: 6469 7370 6c61 7973 2074 6865 206d 656e displays the men │ │ │ │ -000148b0: 7520 656e 7472 6965 7320 6672 6f6d 2074 u entries from t │ │ │ │ -000148c0: 6865 2022 6772 7562 2e63 6667 220a 6669 he "grub.cfg".fi │ │ │ │ -000148d0: 6c65 2e20 2049 7420 6973 2061 206c 6973 le. It is a lis │ │ │ │ -000148e0: 7420 6f66 2069 7465 6d73 2c20 7768 6572 t of items, wher │ │ │ │ -000148f0: 6520 6561 6368 2069 7465 6d20 6861 7320 e each item has │ │ │ │ -00014900: 6120 7469 746c 6520 616e 6420 616e 0a6f a title and an.o │ │ │ │ -00014910: 7074 696f 6e61 6c20 6963 6f6e 2e20 2054 ptional icon. T │ │ │ │ -00014920: 6865 2069 636f 6e20 6973 2073 656c 6563 he icon is selec │ │ │ │ -00014930: 7465 6420 6261 7365 6420 6f6e 2074 6865 ted based on the │ │ │ │ -00014940: 202a 636c 6173 7365 732a 2073 7065 6369 *classes* speci │ │ │ │ -00014950: 6669 6564 0a66 6f72 2074 6865 206d 656e fied.for the men │ │ │ │ -00014960: 7520 656e 7472 792e 2020 4966 2074 6865 u entry. If the │ │ │ │ -00014970: 7265 2069 7320 6120 504e 4720 6669 6c65 re is a PNG file │ │ │ │ -00014980: 206e 616d 6564 2022 6d79 636c 6173 732e named "myclass. │ │ │ │ -00014990: 706e 6722 2069 6e20 7468 650a 2267 7275 png" in the."gru │ │ │ │ -000149a0: 622f 7468 656d 6573 2f69 636f 6e73 2220 b/themes/icons" │ │ │ │ -000149b0: 6469 7265 6374 6f72 792c 2069 7420 7769 directory, it wi │ │ │ │ -000149c0: 6c6c 2062 6520 6469 7370 6c61 7965 6420 ll be displayed │ │ │ │ -000149d0: 666f 7220 6974 656d 7320 7768 6963 6820 for items which │ │ │ │ -000149e0: 6861 7665 0a74 6865 2063 6c61 7373 202a have.the class * │ │ │ │ -000149f0: 6d79 636c 6173 732a 2e20 2054 6865 2062 myclass*. The b │ │ │ │ -00014a00: 6f6f 7420 6d65 6e75 2063 616e 2062 6520 oot menu can be │ │ │ │ -00014a10: 6375 7374 6f6d 697a 6564 2069 6e20 7365 customized in se │ │ │ │ -00014a20: 7665 7261 6c20 7761 7973 2c0a 7375 6368 veral ways,.such │ │ │ │ -00014a30: 2061 7320 7468 6520 666f 6e74 2061 6e64 as the font and │ │ │ │ -00014a40: 2063 6f6c 6f72 2075 7365 6420 666f 7220 color used for │ │ │ │ -00014a50: 7468 6520 6d65 6e75 2065 6e74 7279 2074 the menu entry t │ │ │ │ -00014a60: 6974 6c65 2c20 616e 6420 6279 0a73 7065 itle, and by.spe │ │ │ │ -00014a70: 6369 6679 696e 6720 7374 796c 6564 2062 cifying styled b │ │ │ │ -00014a80: 6f78 6573 2066 6f72 2074 6865 206d 656e oxes for the men │ │ │ │ -00014a90: 7520 6974 7365 6c66 2061 6e64 2066 6f72 u itself and for │ │ │ │ -00014aa0: 2074 6865 2073 656c 6563 7465 6420 6974 the selected it │ │ │ │ -00014ab0: 656d 0a68 6967 686c 6967 6874 2e0a 0a37 em.highlight...7 │ │ │ │ -00014ac0: 2e32 2e37 2053 7479 6c65 6420 426f 7865 .2.7 Styled Boxe │ │ │ │ -00014ad0: 730a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d s.-------------- │ │ │ │ -00014ae0: 2d2d 2d2d 0a0a 4f6e 6520 6f66 2074 6865 ----..One of the │ │ │ │ -00014af0: 206d 6f73 7420 696d 706f 7274 616e 7420 most important │ │ │ │ -00014b00: 6665 6174 7572 6573 2066 6f72 2063 7573 features for cus │ │ │ │ -00014b10: 746f 6d69 7a69 6e67 2074 6865 206c 6179 tomizing the lay │ │ │ │ -00014b20: 6f75 7420 6973 2074 6865 2075 7365 0a6f out is the use.o │ │ │ │ -00014b30: 6620 2a73 7479 6c65 6420 626f 7865 732a f *styled boxes* │ │ │ │ -00014b40: 2e20 2041 2073 7479 6c65 6420 626f 7820 . A styled box │ │ │ │ -00014b50: 6973 2063 6f6d 706f 7365 6420 6f66 2039 is composed of 9 │ │ │ │ -00014b60: 2072 6563 7461 6e67 756c 6172 2028 616e rectangular (an │ │ │ │ -00014b70: 640a 706f 7465 6e74 6961 6c6c 7920 656d d.potentially em │ │ │ │ -00014b80: 7074 7929 2072 6567 696f 6e73 2c20 7768 pty) regions, wh │ │ │ │ -00014b90: 6963 6820 6172 6520 7573 6564 2074 6f20 ich are used to │ │ │ │ -00014ba0: 7365 616d 6c65 7373 6c79 2064 7261 7720 seamlessly draw │ │ │ │ -00014bb0: 7468 6520 7374 796c 6564 0a62 6f78 206f the styled.box o │ │ │ │ -00014bc0: 6e20 7363 7265 656e 3a0a 0a4e 6f72 7468 n screen:..North │ │ │ │ -00014bd0: 7765 7374 2028 6e77 2920 2020 2020 2020 west (nw) │ │ │ │ -00014be0: 2020 4e6f 7274 6820 286e 2920 2020 2020 North (n) │ │ │ │ -00014bf0: 2020 2020 2020 2020 204e 6f72 7468 6561 Northea │ │ │ │ -00014c00: 7374 2028 6e65 290a 5765 7374 2028 7729 st (ne).West (w) │ │ │ │ -00014c10: 2020 2020 2020 2020 2020 2020 2020 2043 C │ │ │ │ -00014c20: 656e 7465 7220 2863 2920 2020 2020 2020 enter (c) │ │ │ │ -00014c30: 2020 2020 2020 4561 7374 2028 6529 0a53 East (e).S │ │ │ │ -00014c40: 6f75 7468 7765 7374 2028 7377 2920 2020 outhwest (sw) │ │ │ │ -00014c50: 2020 2020 2020 536f 7574 6820 2873 2920 South (s) │ │ │ │ -00014c60: 2020 2020 2020 2020 2020 2020 2053 6f75 Sou │ │ │ │ -00014c70: 7468 6561 7374 2028 7365 290a 0a20 2020 theast (se).. │ │ │ │ -00014c80: 546f 2073 7570 706f 7274 2061 6e79 2073 To support any s │ │ │ │ -00014c90: 697a 6520 6f66 2062 6f78 206f 6e20 7363 ize of box on sc │ │ │ │ -00014ca0: 7265 656e 2c20 7468 6520 6365 6e74 6572 reen, the center │ │ │ │ -00014cb0: 2073 6c69 6365 2061 6e64 2074 6865 2073 slice and the s │ │ │ │ -00014cc0: 6c69 6365 730a 666f 7220 7468 6520 746f lices.for the to │ │ │ │ -00014cd0: 702c 2062 6f74 746f 6d2c 2061 6e64 2073 p, bottom, and s │ │ │ │ -00014ce0: 6964 6573 2061 7265 2061 6c6c 2073 6361 ides are all sca │ │ │ │ -00014cf0: 6c65 6420 746f 2074 6865 2063 6f72 7265 led to the corre │ │ │ │ -00014d00: 6374 2073 697a 6520 666f 720a 7468 6520 ct size for.the │ │ │ │ -00014d10: 636f 6d70 6f6e 656e 7420 6f6e 2073 6372 component on scr │ │ │ │ -00014d20: 6565 6e2c 2075 7369 6e67 2074 6865 2066 een, using the f │ │ │ │ -00014d30: 6f6c 6c6f 7769 6e67 2072 756c 6573 3a0a ollowing rules:. │ │ │ │ -00014d40: 0a20 2031 2e20 5468 6520 6564 6765 2073 . 1. The edge s │ │ │ │ -00014d50: 6c69 6365 7320 286e 6f72 7468 2c20 736f lices (north, so │ │ │ │ -00014d60: 7574 682c 2065 6173 742c 2061 6e64 2077 uth, east, and w │ │ │ │ -00014d70: 6573 7429 2061 7265 2073 6361 6c65 6420 est) are scaled │ │ │ │ -00014d80: 696e 2074 6865 0a20 2020 2020 6469 7265 in the. dire │ │ │ │ -00014d90: 6374 696f 6e20 6f66 2074 6865 2065 6467 ction of the edg │ │ │ │ -00014da0: 6520 7468 6579 2061 7265 2061 646a 6163 e they are adjac │ │ │ │ -00014db0: 656e 7420 746f 2e20 2046 6f72 2069 6e73 ent to. For ins │ │ │ │ -00014dc0: 7461 6e63 652c 2074 6865 2077 6573 740a tance, the west. │ │ │ │ -00014dd0: 2020 2020 2073 6c69 6365 2069 7320 7363 slice is sc │ │ │ │ -00014de0: 616c 6564 2076 6572 7469 6361 6c6c 792e aled vertically. │ │ │ │ -00014df0: 0a20 2032 2e20 5468 6520 636f 726e 6572 . 2. The corner │ │ │ │ -00014e00: 2073 6c69 6365 7320 286e 6f72 7468 7765 slices (northwe │ │ │ │ -00014e10: 7374 2c20 6e6f 7274 6865 6173 742c 2073 st, northeast, s │ │ │ │ -00014e20: 6f75 7468 6561 7374 2c20 616e 6420 736f outheast, and so │ │ │ │ -00014e30: 7574 6877 6573 7429 0a20 2020 2020 6172 uthwest). ar │ │ │ │ -00014e40: 6520 6e6f 7420 7363 616c 6564 2e0a 2020 e not scaled.. │ │ │ │ -00014e50: 332e 2054 6865 2063 656e 7465 7220 736c 3. The center sl │ │ │ │ -00014e60: 6963 6520 6973 2073 6361 6c65 6420 746f ice is scaled to │ │ │ │ -00014e70: 2066 696c 6c20 7468 6520 7265 6d61 696e fill the remain │ │ │ │ -00014e80: 696e 6720 7370 6163 6520 696e 2074 6865 ing space in the │ │ │ │ -00014e90: 0a20 2020 2020 6d69 6464 6c65 2e0a 0a20 . middle... │ │ │ │ -00014ea0: 2020 4173 2061 6e20 6578 616d 706c 6520 As an example │ │ │ │ -00014eb0: 6f66 2068 6f77 2061 6e20 696d 6167 6520 of how an image │ │ │ │ -00014ec0: 6d69 6768 7420 6265 2073 6c69 6365 6420 might be sliced │ │ │ │ -00014ed0: 7570 2c20 636f 6e73 6964 6572 2074 6865 up, consider the │ │ │ │ -00014ee0: 2073 7479 6c65 640a 626f 7820 7573 6564 styled.box used │ │ │ │ -00014ef0: 2066 6f72 2061 2074 6572 6d69 6e61 6c20 for a terminal │ │ │ │ -00014f00: 7669 6577 2e0a 0a46 6967 7572 6520 372e view...Figure 7. │ │ │ │ -00014f10: 330a 0a37 2e32 2e38 2043 7265 6174 696e 3..7.2.8 Creatin │ │ │ │ -00014f20: 6720 5374 796c 6564 2042 6f78 2049 6d61 g Styled Box Ima │ │ │ │ -00014f30: 6765 730a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ges.------------ │ │ │ │ +000144d0: 2d2d 2d2d 2d2d 2d2d 2d0a 0a54 6865 2063 ---------..The c │ │ │ │ +000144e0: 6972 6375 6c61 7220 7072 6f67 7265 7373 ircular progress │ │ │ │ +000144f0: 2069 6e64 6963 6174 6f72 2066 756e 6374 indicator funct │ │ │ │ +00014500: 696f 6e73 2073 696d 696c 6172 6c79 2074 ions similarly t │ │ │ │ +00014510: 6f20 7468 6520 7072 6f67 7265 7373 2062 o the progress b │ │ │ │ +00014520: 6172 2e0a 5768 656e 2067 6976 656e 2061 ar..When given a │ │ │ │ +00014530: 6e20 6964 206f 6620 225f 5f74 696d 656f n id of "__timeo │ │ │ │ +00014540: 7574 5f5f 222c 2047 5255 4220 7570 6461 ut__", GRUB upda │ │ │ │ +00014550: 7465 7320 7468 6520 6369 7263 756c 6172 tes the circular │ │ │ │ +00014560: 2070 726f 6772 6573 730a 696e 6469 6361 progress.indica │ │ │ │ +00014570: 746f 7227 7320 7661 6c75 6520 746f 2069 tor's value to i │ │ │ │ +00014580: 6e64 6963 6174 6520 7468 6520 7469 6d65 ndicate the time │ │ │ │ +00014590: 2072 656d 6169 6e69 6e67 2e20 2046 6f72 remaining. For │ │ │ │ +000145a0: 2074 6865 2063 6972 6375 6c61 720a 7072 the circular.pr │ │ │ │ +000145b0: 6f67 7265 7373 2069 6e64 6963 6174 6f72 ogress indicator │ │ │ │ +000145c0: 2c20 7468 6572 6520 6172 6520 7477 6f20 , there are two │ │ │ │ +000145d0: 696d 6167 6573 2075 7365 6420 746f 2072 images used to r │ │ │ │ +000145e0: 656e 6465 7220 6974 3a20 7468 6520 2a63 ender it: the *c │ │ │ │ +000145f0: 656e 7465 722a 0a69 6d61 6765 2c20 616e enter*.image, an │ │ │ │ +00014600: 6420 7468 6520 2a74 6963 6b2a 2069 6d61 d the *tick* ima │ │ │ │ +00014610: 6765 2e20 2054 6865 2063 656e 7465 7220 ge. The center │ │ │ │ +00014620: 696d 6167 6520 6973 2072 656e 6465 7265 image is rendere │ │ │ │ +00014630: 6420 696e 2074 6865 2063 656e 7465 720a d in the center. │ │ │ │ +00014640: 6f66 2074 6865 2063 6f6d 706f 6e65 6e74 of the component │ │ │ │ +00014650: 2c20 7768 696c 6520 7468 6520 7469 636b , while the tick │ │ │ │ +00014660: 2069 6d61 6765 2069 7320 7573 6564 2074 image is used t │ │ │ │ +00014670: 6f20 7265 6e64 6572 2065 6163 6820 6d61 o render each ma │ │ │ │ +00014680: 726b 2061 6c6f 6e67 0a74 6865 2063 6972 rk along.the cir │ │ │ │ +00014690: 6375 6d66 6572 656e 6365 206f 6620 7468 cumference of th │ │ │ │ +000146a0: 6520 696e 6469 6361 746f 722e 0a0a 372e e indicator...7. │ │ │ │ +000146b0: 322e 3520 4c61 6265 6c73 0a2d 2d2d 2d2d 2.5 Labels.----- │ │ │ │ +000146c0: 2d2d 2d2d 2d2d 2d0a 0a54 6578 7420 6c61 -------..Text la │ │ │ │ +000146d0: 6265 6c73 2063 616e 2062 6520 706c 6163 bels can be plac │ │ │ │ +000146e0: 6564 206f 6e20 7468 6520 626f 6f74 2073 ed on the boot s │ │ │ │ +000146f0: 6372 6565 6e2e 2020 5468 6520 666f 6e74 creen. The font │ │ │ │ +00014700: 2c20 636f 6c6f 722c 2061 6e64 0a68 6f72 , color, and.hor │ │ │ │ +00014710: 697a 6f6e 7461 6c20 616c 6967 6e6d 656e izontal alignmen │ │ │ │ +00014720: 7420 6361 6e20 6265 2073 7065 6369 6669 t can be specifi │ │ │ │ +00014730: 6564 2066 6f72 206c 6162 656c 732e 2020 ed for labels. │ │ │ │ +00014740: 4966 2061 206c 6162 656c 2069 7320 6769 If a label is gi │ │ │ │ +00014750: 7665 6e0a 7468 6520 6964 2022 5f5f 7469 ven.the id "__ti │ │ │ │ +00014760: 6d65 6f75 745f 5f22 2c20 7468 656e 2074 meout__", then t │ │ │ │ +00014770: 6865 2022 7465 7874 2220 7072 6f70 6572 he "text" proper │ │ │ │ +00014780: 7479 2066 6f72 2074 6861 7420 6c61 6265 ty for that labe │ │ │ │ +00014790: 6c20 6973 2061 6c73 6f0a 7570 6461 7465 l is also.update │ │ │ │ +000147a0: 6420 7769 7468 2061 206d 6573 7361 6765 d with a message │ │ │ │ +000147b0: 2069 6e66 6f72 6d69 6e67 2074 6865 2075 informing the u │ │ │ │ +000147c0: 7365 7220 6f66 2074 6865 206e 756d 6265 ser of the numbe │ │ │ │ +000147d0: 7220 6f66 2073 6563 6f6e 6473 0a72 656d r of seconds.rem │ │ │ │ +000147e0: 6169 6e69 6e67 2075 6e74 696c 2061 7574 aining until aut │ │ │ │ +000147f0: 6f6d 6174 6963 2062 6f6f 742e 2020 5468 omatic boot. Th │ │ │ │ +00014800: 6973 2069 7320 7573 6566 756c 2069 6e20 is is useful in │ │ │ │ +00014810: 6361 7365 2079 6f75 2077 616e 7420 7468 case you want th │ │ │ │ +00014820: 650a 7465 7874 2064 6973 706c 6179 6564 e.text displayed │ │ │ │ +00014830: 2073 6f6d 6577 6865 7265 2065 6c73 6520 somewhere else │ │ │ │ +00014840: 696e 7374 6561 6420 6f66 2064 6972 6563 instead of direc │ │ │ │ +00014850: 746c 7920 6f6e 2074 6865 2070 726f 6772 tly on the progr │ │ │ │ +00014860: 6573 7320 6261 722e 0a0a 372e 322e 3620 ess bar...7.2.6 │ │ │ │ +00014870: 426f 6f74 204d 656e 750a 2d2d 2d2d 2d2d Boot Menu.------ │ │ │ │ +00014880: 2d2d 2d2d 2d2d 2d2d 2d0a 0a54 6865 2062 ---------..The b │ │ │ │ +00014890: 6f6f 7420 6d65 6e75 2077 6865 7265 2047 oot menu where G │ │ │ │ +000148a0: 5255 4220 6469 7370 6c61 7973 2074 6865 RUB displays the │ │ │ │ +000148b0: 206d 656e 7520 656e 7472 6965 7320 6672 menu entries fr │ │ │ │ +000148c0: 6f6d 2074 6865 2022 6772 7562 2e63 6667 om the "grub.cfg │ │ │ │ +000148d0: 220a 6669 6c65 2e20 2049 7420 6973 2061 ".file. It is a │ │ │ │ +000148e0: 206c 6973 7420 6f66 2069 7465 6d73 2c20 list of items, │ │ │ │ +000148f0: 7768 6572 6520 6561 6368 2069 7465 6d20 where each item │ │ │ │ +00014900: 6861 7320 6120 7469 746c 6520 616e 6420 has a title and │ │ │ │ +00014910: 616e 0a6f 7074 696f 6e61 6c20 6963 6f6e an.optional icon │ │ │ │ +00014920: 2e20 2054 6865 2069 636f 6e20 6973 2073 . The icon is s │ │ │ │ +00014930: 656c 6563 7465 6420 6261 7365 6420 6f6e elected based on │ │ │ │ +00014940: 2074 6865 202a 636c 6173 7365 732a 2073 the *classes* s │ │ │ │ +00014950: 7065 6369 6669 6564 0a66 6f72 2074 6865 pecified.for the │ │ │ │ +00014960: 206d 656e 7520 656e 7472 792e 2020 4966 menu entry. If │ │ │ │ +00014970: 2074 6865 7265 2069 7320 6120 504e 4720 there is a PNG │ │ │ │ +00014980: 6669 6c65 206e 616d 6564 2022 6d79 636c file named "mycl │ │ │ │ +00014990: 6173 732e 706e 6722 2069 6e20 7468 650a ass.png" in the. │ │ │ │ +000149a0: 2267 7275 622f 7468 656d 6573 2f69 636f "grub/themes/ico │ │ │ │ +000149b0: 6e73 2220 6469 7265 6374 6f72 792c 2069 ns" directory, i │ │ │ │ +000149c0: 7420 7769 6c6c 2062 6520 6469 7370 6c61 t will be displa │ │ │ │ +000149d0: 7965 6420 666f 7220 6974 656d 7320 7768 yed for items wh │ │ │ │ +000149e0: 6963 6820 6861 7665 0a74 6865 2063 6c61 ich have.the cla │ │ │ │ +000149f0: 7373 202a 6d79 636c 6173 732a 2e20 2054 ss *myclass*. T │ │ │ │ +00014a00: 6865 2062 6f6f 7420 6d65 6e75 2063 616e he boot menu can │ │ │ │ +00014a10: 2062 6520 6375 7374 6f6d 697a 6564 2069 be customized i │ │ │ │ +00014a20: 6e20 7365 7665 7261 6c20 7761 7973 2c0a n several ways,. │ │ │ │ +00014a30: 7375 6368 2061 7320 7468 6520 666f 6e74 such as the font │ │ │ │ +00014a40: 2061 6e64 2063 6f6c 6f72 2075 7365 6420 and color used │ │ │ │ +00014a50: 666f 7220 7468 6520 6d65 6e75 2065 6e74 for the menu ent │ │ │ │ +00014a60: 7279 2074 6974 6c65 2c20 616e 6420 6279 ry title, and by │ │ │ │ +00014a70: 0a73 7065 6369 6679 696e 6720 7374 796c .specifying styl │ │ │ │ +00014a80: 6564 2062 6f78 6573 2066 6f72 2074 6865 ed boxes for the │ │ │ │ +00014a90: 206d 656e 7520 6974 7365 6c66 2061 6e64 menu itself and │ │ │ │ +00014aa0: 2066 6f72 2074 6865 2073 656c 6563 7465 for the selecte │ │ │ │ +00014ab0: 6420 6974 656d 0a68 6967 686c 6967 6874 d item.highlight │ │ │ │ +00014ac0: 2e0a 0a37 2e32 2e37 2053 7479 6c65 6420 ...7.2.7 Styled │ │ │ │ +00014ad0: 426f 7865 730a 2d2d 2d2d 2d2d 2d2d 2d2d Boxes.---------- │ │ │ │ +00014ae0: 2d2d 2d2d 2d2d 2d2d 0a0a 4f6e 6520 6f66 --------..One of │ │ │ │ +00014af0: 2074 6865 206d 6f73 7420 696d 706f 7274 the most import │ │ │ │ +00014b00: 616e 7420 6665 6174 7572 6573 2066 6f72 ant features for │ │ │ │ +00014b10: 2063 7573 746f 6d69 7a69 6e67 2074 6865 customizing the │ │ │ │ +00014b20: 206c 6179 6f75 7420 6973 2074 6865 2075 layout is the u │ │ │ │ +00014b30: 7365 0a6f 6620 2a73 7479 6c65 6420 626f se.of *styled bo │ │ │ │ +00014b40: 7865 732a 2e20 2041 2073 7479 6c65 6420 xes*. A styled │ │ │ │ +00014b50: 626f 7820 6973 2063 6f6d 706f 7365 6420 box is composed │ │ │ │ +00014b60: 6f66 2039 2072 6563 7461 6e67 756c 6172 of 9 rectangular │ │ │ │ +00014b70: 2028 616e 640a 706f 7465 6e74 6961 6c6c (and.potentiall │ │ │ │ +00014b80: 7920 656d 7074 7929 2072 6567 696f 6e73 y empty) regions │ │ │ │ +00014b90: 2c20 7768 6963 6820 6172 6520 7573 6564 , which are used │ │ │ │ +00014ba0: 2074 6f20 7365 616d 6c65 7373 6c79 2064 to seamlessly d │ │ │ │ +00014bb0: 7261 7720 7468 6520 7374 796c 6564 0a62 raw the styled.b │ │ │ │ +00014bc0: 6f78 206f 6e20 7363 7265 656e 3a0a 0a4e ox on screen:..N │ │ │ │ +00014bd0: 6f72 7468 7765 7374 2028 6e77 2920 2020 orthwest (nw) │ │ │ │ +00014be0: 2020 2020 2020 4e6f 7274 6820 286e 2920 North (n) │ │ │ │ +00014bf0: 2020 2020 2020 2020 2020 2020 204e 6f72 Nor │ │ │ │ +00014c00: 7468 6561 7374 2028 6e65 290a 5765 7374 theast (ne).West │ │ │ │ +00014c10: 2028 7729 2020 2020 2020 2020 2020 2020 (w) │ │ │ │ +00014c20: 2020 2043 656e 7465 7220 2863 2920 2020 Center (c) │ │ │ │ +00014c30: 2020 2020 2020 2020 2020 4561 7374 2028 East ( │ │ │ │ +00014c40: 6529 0a53 6f75 7468 7765 7374 2028 7377 e).Southwest (sw │ │ │ │ +00014c50: 2920 2020 2020 2020 2020 536f 7574 6820 ) South │ │ │ │ +00014c60: 2873 2920 2020 2020 2020 2020 2020 2020 (s) │ │ │ │ +00014c70: 2053 6f75 7468 6561 7374 2028 7365 290a Southeast (se). │ │ │ │ +00014c80: 0a20 2020 546f 2073 7570 706f 7274 2061 . To support a │ │ │ │ +00014c90: 6e79 2073 697a 6520 6f66 2062 6f78 206f ny size of box o │ │ │ │ +00014ca0: 6e20 7363 7265 656e 2c20 7468 6520 6365 n screen, the ce │ │ │ │ +00014cb0: 6e74 6572 2073 6c69 6365 2061 6e64 2074 nter slice and t │ │ │ │ +00014cc0: 6865 2073 6c69 6365 730a 666f 7220 7468 he slices.for th │ │ │ │ +00014cd0: 6520 746f 702c 2062 6f74 746f 6d2c 2061 e top, bottom, a │ │ │ │ +00014ce0: 6e64 2073 6964 6573 2061 7265 2061 6c6c nd sides are all │ │ │ │ +00014cf0: 2073 6361 6c65 6420 746f 2074 6865 2063 scaled to the c │ │ │ │ +00014d00: 6f72 7265 6374 2073 697a 6520 666f 720a orrect size for. │ │ │ │ +00014d10: 7468 6520 636f 6d70 6f6e 656e 7420 6f6e the component on │ │ │ │ +00014d20: 2073 6372 6565 6e2c 2075 7369 6e67 2074 screen, using t │ │ │ │ +00014d30: 6865 2066 6f6c 6c6f 7769 6e67 2072 756c he following rul │ │ │ │ +00014d40: 6573 3a0a 0a20 2031 2e20 5468 6520 6564 es:.. 1. The ed │ │ │ │ +00014d50: 6765 2073 6c69 6365 7320 286e 6f72 7468 ge slices (north │ │ │ │ +00014d60: 2c20 736f 7574 682c 2065 6173 742c 2061 , south, east, a │ │ │ │ +00014d70: 6e64 2077 6573 7429 2061 7265 2073 6361 nd west) are sca │ │ │ │ +00014d80: 6c65 6420 696e 2074 6865 0a20 2020 2020 led in the. │ │ │ │ +00014d90: 6469 7265 6374 696f 6e20 6f66 2074 6865 direction of the │ │ │ │ +00014da0: 2065 6467 6520 7468 6579 2061 7265 2061 edge they are a │ │ │ │ +00014db0: 646a 6163 656e 7420 746f 2e20 2046 6f72 djacent to. For │ │ │ │ +00014dc0: 2069 6e73 7461 6e63 652c 2074 6865 2077 instance, the w │ │ │ │ +00014dd0: 6573 740a 2020 2020 2073 6c69 6365 2069 est. slice i │ │ │ │ +00014de0: 7320 7363 616c 6564 2076 6572 7469 6361 s scaled vertica │ │ │ │ +00014df0: 6c6c 792e 0a20 2032 2e20 5468 6520 636f lly.. 2. The co │ │ │ │ +00014e00: 726e 6572 2073 6c69 6365 7320 286e 6f72 rner slices (nor │ │ │ │ +00014e10: 7468 7765 7374 2c20 6e6f 7274 6865 6173 thwest, northeas │ │ │ │ +00014e20: 742c 2073 6f75 7468 6561 7374 2c20 616e t, southeast, an │ │ │ │ +00014e30: 6420 736f 7574 6877 6573 7429 0a20 2020 d southwest). │ │ │ │ +00014e40: 2020 6172 6520 6e6f 7420 7363 616c 6564 are not scaled │ │ │ │ +00014e50: 2e0a 2020 332e 2054 6865 2063 656e 7465 .. 3. The cente │ │ │ │ +00014e60: 7220 736c 6963 6520 6973 2073 6361 6c65 r slice is scale │ │ │ │ +00014e70: 6420 746f 2066 696c 6c20 7468 6520 7265 d to fill the re │ │ │ │ +00014e80: 6d61 696e 696e 6720 7370 6163 6520 696e maining space in │ │ │ │ +00014e90: 2074 6865 0a20 2020 2020 6d69 6464 6c65 the. middle │ │ │ │ +00014ea0: 2e0a 0a20 2020 4173 2061 6e20 6578 616d ... As an exam │ │ │ │ +00014eb0: 706c 6520 6f66 2068 6f77 2061 6e20 696d ple of how an im │ │ │ │ +00014ec0: 6167 6520 6d69 6768 7420 6265 2073 6c69 age might be sli │ │ │ │ +00014ed0: 6365 6420 7570 2c20 636f 6e73 6964 6572 ced up, consider │ │ │ │ +00014ee0: 2074 6865 2073 7479 6c65 640a 626f 7820 the styled.box │ │ │ │ +00014ef0: 7573 6564 2066 6f72 2061 2074 6572 6d69 used for a termi │ │ │ │ +00014f00: 6e61 6c20 7669 6577 2e0a 0a46 6967 7572 nal view...Figur │ │ │ │ +00014f10: 6520 372e 330a 0a37 2e32 2e38 2043 7265 e 7.3..7.2.8 Cre │ │ │ │ +00014f20: 6174 696e 6720 5374 796c 6564 2042 6f78 ating Styled Box │ │ │ │ +00014f30: 2049 6d61 6765 730a 2d2d 2d2d 2d2d 2d2d Images.-------- │ │ │ │ 00014f40: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ -00014f50: 2d2d 2d2d 0a0a 5468 6520 496e 6b73 6361 ----..The Inksca │ │ │ │ -00014f60: 7065 5f20 7363 616c 6162 6c65 2076 6563 pe_ scalable vec │ │ │ │ -00014f70: 746f 7220 6772 6170 6869 6373 2065 6469 tor graphics edi │ │ │ │ -00014f80: 746f 7220 6973 2061 2076 6572 7920 7573 tor is a very us │ │ │ │ -00014f90: 6566 756c 2074 6f6f 6c20 666f 720a 6372 eful tool for.cr │ │ │ │ -00014fa0: 6561 7469 6e67 2073 7479 6c65 6420 626f eating styled bo │ │ │ │ -00014fb0: 7820 696d 6167 6573 2e20 204f 6e65 2070 x images. One p │ │ │ │ -00014fc0: 726f 6365 7373 2074 6861 7420 776f 726b rocess that work │ │ │ │ -00014fd0: 7320 7765 6c6c 2066 6f72 2073 6c69 6369 s well for slici │ │ │ │ -00014fe0: 6e67 2061 0a64 7261 7769 6e67 2069 6e74 ng a.drawing int │ │ │ │ -00014ff0: 6f20 7468 6520 6e65 6365 7373 6172 7920 o the necessary │ │ │ │ -00015000: 696d 6167 6520 736c 6963 6573 2069 733a image slices is: │ │ │ │ -00015010: 0a0a 2020 312e 2043 7265 6174 6520 6f72 .. 1. Create or │ │ │ │ -00015020: 206f 7065 6e20 7468 6520 6472 6177 696e open the drawin │ │ │ │ -00015030: 6720 796f 7527 6420 6c69 6b65 2075 7365 g you'd like use │ │ │ │ -00015040: 2e0a 2020 322e 2043 7265 6174 6520 6120 .. 2. Create a │ │ │ │ -00015050: 6e65 7720 6c61 7965 7220 6f6e 2074 6865 new layer on the │ │ │ │ -00015060: 2074 6f70 206f 6620 7468 6520 6c61 7965 top of the laye │ │ │ │ -00015070: 7220 7374 6163 6b2e 2020 4d61 6b65 2069 r stack. Make i │ │ │ │ -00015080: 7420 7669 7369 626c 652e 0a20 2020 2020 t visible.. │ │ │ │ -00015090: 5365 6c65 6374 2074 6869 7320 6c61 7965 Select this laye │ │ │ │ -000150a0: 7220 6173 2074 6865 2063 7572 7265 6e74 r as the current │ │ │ │ -000150b0: 206c 6179 6572 2e0a 2020 332e 2044 7261 layer.. 3. Dra │ │ │ │ -000150c0: 7720 3920 7265 6374 616e 676c 6573 206f w 9 rectangles o │ │ │ │ -000150d0: 6e20 796f 7572 2064 7261 7769 6e67 2077 n your drawing w │ │ │ │ -000150e0: 6865 7265 2079 6f75 2764 206c 696b 6520 here you'd like │ │ │ │ -000150f0: 7468 6520 736c 6963 6573 2074 6f0a 2020 the slices to. │ │ │ │ -00015100: 2020 2062 652e 2020 436c 6561 7220 7468 be. Clear th │ │ │ │ -00015110: 6520 6669 6c6c 206f 7074 696f 6e2c 2061 e fill option, a │ │ │ │ -00015120: 6e64 2073 6574 2074 6865 2073 7472 6f6b nd set the strok │ │ │ │ -00015130: 6520 746f 2031 2070 6978 656c 2077 6964 e to 1 pixel wid │ │ │ │ -00015140: 650a 2020 2020 2073 6f6c 6964 2073 7472 e. solid str │ │ │ │ -00015150: 6f6b 652e 2020 5468 6520 636f 726e 6572 oke. The corner │ │ │ │ -00015160: 7320 6f66 2074 6865 2073 6c69 6365 7320 s of the slices │ │ │ │ -00015170: 6d75 7374 206d 6565 7420 7072 6563 6973 must meet precis │ │ │ │ -00015180: 656c 793b 2069 6620 6974 0a20 2020 2020 ely; if it. │ │ │ │ -00015190: 6973 206f 6666 2062 7920 6120 7369 6e67 is off by a sing │ │ │ │ -000151a0: 6c65 2070 6978 656c 2c20 6974 2077 696c le pixel, it wil │ │ │ │ -000151b0: 6c20 7072 6f62 6162 6c79 2062 6520 6576 l probably be ev │ │ │ │ -000151c0: 6964 656e 7420 7768 656e 2074 6865 0a20 ident when the. │ │ │ │ -000151d0: 2020 2020 7374 796c 6564 2062 6f78 2069 styled box i │ │ │ │ -000151e0: 7320 7265 6e64 6572 6564 2069 6e20 7468 s rendered in th │ │ │ │ -000151f0: 6520 4752 5542 206d 656e 752e 2020 596f e GRUB menu. Yo │ │ │ │ -00015200: 7520 7368 6f75 6c64 2070 726f 6261 626c u should probabl │ │ │ │ -00015210: 7920 676f 2074 6f0a 2020 2020 2046 696c y go to. Fil │ │ │ │ -00015220: 6520 7c20 446f 6375 6d65 6e74 2050 726f e | Document Pro │ │ │ │ -00015230: 7065 7274 6965 7320 7c20 4772 6964 7320 perties | Grids │ │ │ │ -00015240: 616e 6420 656e 6162 6c65 2061 2067 7269 and enable a gri │ │ │ │ -00015250: 6420 6f72 2063 7265 6174 6520 610a 2020 d or create a. │ │ │ │ -00015260: 2020 2067 7569 6465 2028 636c 6963 6b20 guide (click │ │ │ │ -00015270: 6f6e 206f 6e65 206f 6620 7468 6520 7275 on one of the ru │ │ │ │ -00015280: 6c65 7273 206e 6578 7420 746f 2074 6865 lers next to the │ │ │ │ -00015290: 2064 7261 7769 6e67 2061 6e64 2064 7261 drawing and dra │ │ │ │ -000152a0: 6720 6f76 6572 0a20 2020 2020 7468 6520 g over. the │ │ │ │ -000152b0: 6472 6177 696e 673b 2072 656c 6561 7365 drawing; release │ │ │ │ -000152c0: 2074 6865 206d 6f75 7365 2062 7574 746f the mouse butto │ │ │ │ -000152d0: 6e20 746f 2070 6c61 6365 2074 6865 2067 n to place the g │ │ │ │ -000152e0: 7569 6465 2920 746f 2068 656c 700a 2020 uide) to help. │ │ │ │ -000152f0: 2020 2070 6c61 6365 2074 6865 2072 6563 place the rec │ │ │ │ -00015300: 7461 6e67 6c65 7320 7072 6563 6973 656c tangles precisel │ │ │ │ -00015310: 792e 0a20 2034 2e20 5269 6768 7420 636c y.. 4. Right cl │ │ │ │ -00015320: 6963 6b20 6f6e 2074 6865 2063 656e 7465 ick on the cente │ │ │ │ -00015330: 7220 736c 6963 6520 7265 6374 616e 676c r slice rectangl │ │ │ │ -00015340: 6520 616e 6420 6368 6f6f 7365 204f 626a e and choose Obj │ │ │ │ -00015350: 6563 740a 2020 2020 2050 726f 7065 7274 ect. Propert │ │ │ │ -00015360: 6965 732e 2020 4368 616e 6765 2074 6865 ies. Change the │ │ │ │ -00015370: 2022 4964 2220 746f 2022 736c 6963 655f "Id" to "slice_ │ │ │ │ -00015380: 6322 2061 6e64 2063 6c69 636b 2053 6574 c" and click Set │ │ │ │ -00015390: 2e20 2052 6570 6561 740a 2020 2020 2074 . Repeat. t │ │ │ │ -000153a0: 6869 7320 666f 7220 7468 6520 7265 6d61 his for the rema │ │ │ │ -000153b0: 696e 696e 6720 3820 7265 6374 616e 676c ining 8 rectangl │ │ │ │ -000153c0: 6573 2c20 6769 7669 6e67 2074 6865 6d20 es, giving them │ │ │ │ -000153d0: 4964 2076 616c 7565 7320 6f66 0a20 2020 Id values of. │ │ │ │ -000153e0: 2020 2273 6c69 6365 5f6e 222c 2022 736c "slice_n", "sl │ │ │ │ -000153f0: 6963 655f 6e65 222c 2022 736c 6963 655f ice_ne", "slice_ │ │ │ │ -00015400: 6522 2c20 616e 6420 736f 206f 6e20 6163 e", and so on ac │ │ │ │ -00015410: 636f 7264 696e 6720 746f 2074 6865 0a20 cording to the. │ │ │ │ -00015420: 2020 2020 6c6f 6361 7469 6f6e 2e0a 2020 location.. │ │ │ │ -00015430: 352e 2053 6176 6520 7468 6520 6472 6177 5. Save the draw │ │ │ │ -00015440: 696e 672e 0a20 2036 2e20 5365 6c65 6374 ing.. 6. Select │ │ │ │ -00015450: 2061 6c6c 2074 6865 2073 6c69 6365 2072 all the slice r │ │ │ │ -00015460: 6563 7461 6e67 6c65 732e 2020 5769 7468 ectangles. With │ │ │ │ -00015470: 2074 6865 2073 6c69 6365 206c 6179 6572 the slice layer │ │ │ │ -00015480: 2073 656c 6563 7465 642c 0a20 2020 2020 selected,. │ │ │ │ -00015490: 796f 7520 6361 6e20 7369 6d70 6c79 2070 you can simply p │ │ │ │ -000154a0: 7265 7373 2043 7472 6c2b 4120 746f 2073 ress Ctrl+A to s │ │ │ │ -000154b0: 656c 6563 7420 616c 6c20 7265 6374 616e elect all rectan │ │ │ │ -000154c0: 676c 6573 2e20 2054 6865 2073 7461 7475 gles. The statu │ │ │ │ -000154d0: 730a 2020 2020 2062 6172 2073 686f 756c s. bar shoul │ │ │ │ -000154e0: 6420 696e 6469 6361 7465 2074 6861 7420 d indicate that │ │ │ │ -000154f0: 3920 7265 6374 616e 676c 6573 2061 7265 9 rectangles are │ │ │ │ -00015500: 2073 656c 6563 7465 642e 0a20 2037 2e20 selected.. 7. │ │ │ │ -00015510: 436c 6963 6b20 7468 6520 6c61 7965 7220 Click the layer │ │ │ │ -00015520: 6869 6465 2069 636f 6e20 666f 7220 7468 hide icon for th │ │ │ │ -00015530: 6520 736c 6963 6520 6c61 7965 7220 696e e slice layer in │ │ │ │ -00015540: 2074 6865 206c 6179 6572 2070 616c 6574 the layer palet │ │ │ │ -00015550: 7465 2e0a 2020 2020 2054 6865 2072 6563 te.. The rec │ │ │ │ -00015560: 7461 6e67 6c65 7320 7769 6c6c 2072 656d tangles will rem │ │ │ │ -00015570: 6169 6e20 7365 6c65 6374 6564 2c20 6576 ain selected, ev │ │ │ │ -00015580: 656e 2074 686f 7567 6820 7468 6579 2061 en though they a │ │ │ │ -00015590: 7265 2068 6964 6465 6e2e 0a20 2038 2e20 re hidden.. 8. │ │ │ │ -000155a0: 4368 6f6f 7365 2046 696c 6520 7c20 4578 Choose File | Ex │ │ │ │ -000155b0: 706f 7274 2042 6974 6d61 7020 616e 6420 port Bitmap and │ │ │ │ -000155c0: 6368 6563 6b20 7468 6520 2a42 6174 6368 check the *Batch │ │ │ │ -000155d0: 2065 7870 6f72 7420 3920 7365 6c65 6374 export 9 select │ │ │ │ -000155e0: 6564 0a20 2020 2020 6f62 6a65 6374 732a ed. objects* │ │ │ │ -000155f0: 2062 6f78 2e20 204d 616b 6520 7375 7265 box. Make sure │ │ │ │ -00015600: 2074 6861 7420 2a48 6964 6520 616c 6c20 that *Hide all │ │ │ │ -00015610: 6578 6365 7074 2073 656c 6563 7465 642a except selected* │ │ │ │ -00015620: 2069 730a 2020 2020 2075 6e63 6865 636b is. uncheck │ │ │ │ -00015630: 6564 2e20 2063 6c69 636b 202a 4578 706f ed. click *Expo │ │ │ │ -00015640: 7274 2a2e 2020 5468 6973 2077 696c 6c20 rt*. This will │ │ │ │ -00015650: 6372 6561 7465 2050 4e47 2066 696c 6573 create PNG files │ │ │ │ -00015660: 2069 6e20 7468 6520 7361 6d65 0a20 2020 in the same. │ │ │ │ -00015670: 2020 6469 7265 6374 6f72 7920 6173 2074 directory as t │ │ │ │ -00015680: 6865 2064 7261 7769 6e67 2c20 6e61 6d65 he drawing, name │ │ │ │ -00015690: 6420 6166 7465 7220 7468 6520 736c 6963 d after the slic │ │ │ │ -000156a0: 6573 2e20 2054 6865 7365 2063 616e 206e es. These can n │ │ │ │ -000156b0: 6f77 2062 650a 2020 2020 2075 7365 6420 ow be. used │ │ │ │ -000156c0: 666f 7220 6120 7374 796c 6564 2062 6f78 for a styled box │ │ │ │ -000156d0: 2069 6e20 6120 4752 5542 2074 6865 6d65 in a GRUB theme │ │ │ │ -000156e0: 2e0a 0a37 2e33 2054 6865 6d65 2046 696c ...7.3 Theme Fil │ │ │ │ -000156f0: 6520 4d61 6e75 616c 0a3d 3d3d 3d3d 3d3d e Manual.======= │ │ │ │ -00015700: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a ==============.. │ │ │ │ -00015710: 5468 6520 7468 656d 6520 6669 6c65 2069 The theme file i │ │ │ │ -00015720: 7320 6120 706c 6169 6e20 7465 7874 2066 s a plain text f │ │ │ │ -00015730: 696c 652e 2020 4c69 6e65 7320 7468 6174 ile. Lines that │ │ │ │ -00015740: 2062 6567 696e 2077 6974 6820 2223 2220 begin with "#" │ │ │ │ -00015750: 6172 650a 6967 6e6f 7265 6420 616e 6420 are.ignored and │ │ │ │ -00015760: 636f 6e73 6964 6572 6564 2063 6f6d 6d65 considered comme │ │ │ │ -00015770: 6e74 732e 2020 284e 6f74 653a 2054 6869 nts. (Note: Thi │ │ │ │ -00015780: 7320 6d61 7920 6e6f 7420 6265 2074 6865 s may not be the │ │ │ │ -00015790: 2063 6173 6520 6966 2074 6865 0a70 7265 case if the.pre │ │ │ │ -000157a0: 7669 6f75 7320 6c69 6e65 2065 6e64 6564 vious line ended │ │ │ │ -000157b0: 2077 6865 7265 2061 2076 616c 7565 2077 where a value w │ │ │ │ -000157c0: 6173 2065 7870 6563 7465 642e 290a 0a20 as expected.).. │ │ │ │ -000157d0: 2020 5468 6520 7468 656d 6520 6669 6c65 The theme file │ │ │ │ -000157e0: 2063 6f6e 7461 696e 7320 7477 6f20 7479 contains two ty │ │ │ │ -000157f0: 7065 7320 6f66 2073 7461 7465 6d65 6e74 pes of statement │ │ │ │ -00015800: 733a 0a20 2031 2e20 476c 6f62 616c 2070 s:. 1. Global p │ │ │ │ -00015810: 726f 7065 7274 6965 732e 0a20 2032 2e20 roperties.. 2. │ │ │ │ -00015820: 436f 6d70 6f6e 656e 7420 636f 6e73 7472 Component constr │ │ │ │ -00015830: 7563 7469 6f6e 2e0a 0a37 2e33 2e31 2047 uction...7.3.1 G │ │ │ │ -00015840: 6c6f 6261 6c20 5072 6f70 6572 7469 6573 lobal Properties │ │ │ │ -00015850: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d .--------------- │ │ │ │ -00015860: 2d2d 2d2d 2d2d 2d2d 0a0a 372e 332e 3220 --------..7.3.2 │ │ │ │ -00015870: 466f 726d 6174 0a2d 2d2d 2d2d 2d2d 2d2d Format.--------- │ │ │ │ -00015880: 2d2d 2d0a 0a47 6c6f 6261 6c20 7072 6f70 ---..Global prop │ │ │ │ -00015890: 6572 7469 6573 2061 7265 2073 7065 6369 erties are speci │ │ │ │ -000158a0: 6669 6564 2077 6974 6820 7468 6520 7369 fied with the si │ │ │ │ -000158b0: 6d70 6c65 2066 6f72 6d61 743a 0a20 2020 mple format:. │ │ │ │ -000158c0: 2a20 6e61 6d65 313a 2076 616c 7565 310a * name1: value1. │ │ │ │ -000158d0: 2020 202a 206e 616d 6532 3a20 2276 616c * name2: "val │ │ │ │ -000158e0: 7565 2077 6869 6368 206d 6179 2063 6f6e ue which may con │ │ │ │ -000158f0: 7461 696e 2073 7061 6365 7322 0a20 2020 tain spaces". │ │ │ │ -00015900: 2a20 6e61 6d65 333a 2023 3838 460a 0a20 * name3: #88F.. │ │ │ │ -00015910: 2020 496e 2074 6869 7320 6578 616d 706c In this exampl │ │ │ │ -00015920: 652c 206e 616d 6533 2069 7320 6173 7369 e, name3 is assi │ │ │ │ -00015930: 676e 6564 2061 2063 6f6c 6f72 2076 616c gned a color val │ │ │ │ -00015940: 7565 2e0a 0a37 2e33 2e33 2047 6c6f 6261 ue...7.3.3 Globa │ │ │ │ -00015950: 6c20 5072 6f70 6572 7479 204c 6973 740a l Property List. │ │ │ │ -00015960: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ -00015970: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 7469 746c ----------..titl │ │ │ │ -00015980: 652d 7465 7874 2020 2020 2020 2020 2020 e-text │ │ │ │ -00015990: 2020 2053 7065 6369 6669 6573 2074 6865 Specifies the │ │ │ │ -000159a0: 2074 6578 7420 746f 2064 6973 706c 6179 text to display │ │ │ │ -000159b0: 2061 7420 7468 6520 746f 700a 2020 2020 at the top. │ │ │ │ +00014f50: 2d2d 2d2d 2d2d 2d2d 0a0a 5468 6520 496e --------..The In │ │ │ │ +00014f60: 6b73 6361 7065 5f20 7363 616c 6162 6c65 kscape_ scalable │ │ │ │ +00014f70: 2076 6563 746f 7220 6772 6170 6869 6373 vector graphics │ │ │ │ +00014f80: 2065 6469 746f 7220 6973 2061 2076 6572 editor is a ver │ │ │ │ +00014f90: 7920 7573 6566 756c 2074 6f6f 6c20 666f y useful tool fo │ │ │ │ +00014fa0: 720a 6372 6561 7469 6e67 2073 7479 6c65 r.creating style │ │ │ │ +00014fb0: 6420 626f 7820 696d 6167 6573 2e20 204f d box images. O │ │ │ │ +00014fc0: 6e65 2070 726f 6365 7373 2074 6861 7420 ne process that │ │ │ │ +00014fd0: 776f 726b 7320 7765 6c6c 2066 6f72 2073 works well for s │ │ │ │ +00014fe0: 6c69 6369 6e67 2061 0a64 7261 7769 6e67 licing a.drawing │ │ │ │ +00014ff0: 2069 6e74 6f20 7468 6520 6e65 6365 7373 into the necess │ │ │ │ +00015000: 6172 7920 696d 6167 6520 736c 6963 6573 ary image slices │ │ │ │ +00015010: 2069 733a 0a0a 2020 312e 2043 7265 6174 is:.. 1. Creat │ │ │ │ +00015020: 6520 6f72 206f 7065 6e20 7468 6520 6472 e or open the dr │ │ │ │ +00015030: 6177 696e 6720 796f 7527 6420 6c69 6b65 awing you'd like │ │ │ │ +00015040: 2075 7365 2e0a 2020 322e 2043 7265 6174 use.. 2. Creat │ │ │ │ +00015050: 6520 6120 6e65 7720 6c61 7965 7220 6f6e e a new layer on │ │ │ │ +00015060: 2074 6865 2074 6f70 206f 6620 7468 6520 the top of the │ │ │ │ +00015070: 6c61 7965 7220 7374 6163 6b2e 2020 4d61 layer stack. Ma │ │ │ │ +00015080: 6b65 2069 7420 7669 7369 626c 652e 0a20 ke it visible.. │ │ │ │ +00015090: 2020 2020 5365 6c65 6374 2074 6869 7320 Select this │ │ │ │ +000150a0: 6c61 7965 7220 6173 2074 6865 2063 7572 layer as the cur │ │ │ │ +000150b0: 7265 6e74 206c 6179 6572 2e0a 2020 332e rent layer.. 3. │ │ │ │ +000150c0: 2044 7261 7720 3920 7265 6374 616e 676c Draw 9 rectangl │ │ │ │ +000150d0: 6573 206f 6e20 796f 7572 2064 7261 7769 es on your drawi │ │ │ │ +000150e0: 6e67 2077 6865 7265 2079 6f75 2764 206c ng where you'd l │ │ │ │ +000150f0: 696b 6520 7468 6520 736c 6963 6573 2074 ike the slices t │ │ │ │ +00015100: 6f0a 2020 2020 2062 652e 2020 436c 6561 o. be. Clea │ │ │ │ +00015110: 7220 7468 6520 6669 6c6c 206f 7074 696f r the fill optio │ │ │ │ +00015120: 6e2c 2061 6e64 2073 6574 2074 6865 2073 n, and set the s │ │ │ │ +00015130: 7472 6f6b 6520 746f 2031 2070 6978 656c troke to 1 pixel │ │ │ │ +00015140: 2077 6964 650a 2020 2020 2073 6f6c 6964 wide. solid │ │ │ │ +00015150: 2073 7472 6f6b 652e 2020 5468 6520 636f stroke. The co │ │ │ │ +00015160: 726e 6572 7320 6f66 2074 6865 2073 6c69 rners of the sli │ │ │ │ +00015170: 6365 7320 6d75 7374 206d 6565 7420 7072 ces must meet pr │ │ │ │ +00015180: 6563 6973 656c 793b 2069 6620 6974 0a20 ecisely; if it. │ │ │ │ +00015190: 2020 2020 6973 206f 6666 2062 7920 6120 is off by a │ │ │ │ +000151a0: 7369 6e67 6c65 2070 6978 656c 2c20 6974 single pixel, it │ │ │ │ +000151b0: 2077 696c 6c20 7072 6f62 6162 6c79 2062 will probably b │ │ │ │ +000151c0: 6520 6576 6964 656e 7420 7768 656e 2074 e evident when t │ │ │ │ +000151d0: 6865 0a20 2020 2020 7374 796c 6564 2062 he. styled b │ │ │ │ +000151e0: 6f78 2069 7320 7265 6e64 6572 6564 2069 ox is rendered i │ │ │ │ +000151f0: 6e20 7468 6520 4752 5542 206d 656e 752e n the GRUB menu. │ │ │ │ +00015200: 2020 596f 7520 7368 6f75 6c64 2070 726f You should pro │ │ │ │ +00015210: 6261 626c 7920 676f 2074 6f0a 2020 2020 bably go to. │ │ │ │ +00015220: 2046 696c 6520 7c20 446f 6375 6d65 6e74 File | Document │ │ │ │ +00015230: 2050 726f 7065 7274 6965 7320 7c20 4772 Properties | Gr │ │ │ │ +00015240: 6964 7320 616e 6420 656e 6162 6c65 2061 ids and enable a │ │ │ │ +00015250: 2067 7269 6420 6f72 2063 7265 6174 6520 grid or create │ │ │ │ +00015260: 610a 2020 2020 2067 7569 6465 2028 636c a. guide (cl │ │ │ │ +00015270: 6963 6b20 6f6e 206f 6e65 206f 6620 7468 ick on one of th │ │ │ │ +00015280: 6520 7275 6c65 7273 206e 6578 7420 746f e rulers next to │ │ │ │ +00015290: 2074 6865 2064 7261 7769 6e67 2061 6e64 the drawing and │ │ │ │ +000152a0: 2064 7261 6720 6f76 6572 0a20 2020 2020 drag over. │ │ │ │ +000152b0: 7468 6520 6472 6177 696e 673b 2072 656c the drawing; rel │ │ │ │ +000152c0: 6561 7365 2074 6865 206d 6f75 7365 2062 ease the mouse b │ │ │ │ +000152d0: 7574 746f 6e20 746f 2070 6c61 6365 2074 utton to place t │ │ │ │ +000152e0: 6865 2067 7569 6465 2920 746f 2068 656c he guide) to hel │ │ │ │ +000152f0: 700a 2020 2020 2070 6c61 6365 2074 6865 p. place the │ │ │ │ +00015300: 2072 6563 7461 6e67 6c65 7320 7072 6563 rectangles prec │ │ │ │ +00015310: 6973 656c 792e 0a20 2034 2e20 5269 6768 isely.. 4. Righ │ │ │ │ +00015320: 7420 636c 6963 6b20 6f6e 2074 6865 2063 t click on the c │ │ │ │ +00015330: 656e 7465 7220 736c 6963 6520 7265 6374 enter slice rect │ │ │ │ +00015340: 616e 676c 6520 616e 6420 6368 6f6f 7365 angle and choose │ │ │ │ +00015350: 204f 626a 6563 740a 2020 2020 2050 726f Object. Pro │ │ │ │ +00015360: 7065 7274 6965 732e 2020 4368 616e 6765 perties. Change │ │ │ │ +00015370: 2074 6865 2022 4964 2220 746f 2022 736c the "Id" to "sl │ │ │ │ +00015380: 6963 655f 6322 2061 6e64 2063 6c69 636b ice_c" and click │ │ │ │ +00015390: 2053 6574 2e20 2052 6570 6561 740a 2020 Set. Repeat. │ │ │ │ +000153a0: 2020 2074 6869 7320 666f 7220 7468 6520 this for the │ │ │ │ +000153b0: 7265 6d61 696e 696e 6720 3820 7265 6374 remaining 8 rect │ │ │ │ +000153c0: 616e 676c 6573 2c20 6769 7669 6e67 2074 angles, giving t │ │ │ │ +000153d0: 6865 6d20 4964 2076 616c 7565 7320 6f66 hem Id values of │ │ │ │ +000153e0: 0a20 2020 2020 2273 6c69 6365 5f6e 222c . "slice_n", │ │ │ │ +000153f0: 2022 736c 6963 655f 6e65 222c 2022 736c "slice_ne", "sl │ │ │ │ +00015400: 6963 655f 6522 2c20 616e 6420 736f 206f ice_e", and so o │ │ │ │ +00015410: 6e20 6163 636f 7264 696e 6720 746f 2074 n according to t │ │ │ │ +00015420: 6865 0a20 2020 2020 6c6f 6361 7469 6f6e he. location │ │ │ │ +00015430: 2e0a 2020 352e 2053 6176 6520 7468 6520 .. 5. Save the │ │ │ │ +00015440: 6472 6177 696e 672e 0a20 2036 2e20 5365 drawing.. 6. Se │ │ │ │ +00015450: 6c65 6374 2061 6c6c 2074 6865 2073 6c69 lect all the sli │ │ │ │ +00015460: 6365 2072 6563 7461 6e67 6c65 732e 2020 ce rectangles. │ │ │ │ +00015470: 5769 7468 2074 6865 2073 6c69 6365 206c With the slice l │ │ │ │ +00015480: 6179 6572 2073 656c 6563 7465 642c 0a20 ayer selected,. │ │ │ │ +00015490: 2020 2020 796f 7520 6361 6e20 7369 6d70 you can simp │ │ │ │ +000154a0: 6c79 2070 7265 7373 2043 7472 6c2b 4120 ly press Ctrl+A │ │ │ │ +000154b0: 746f 2073 656c 6563 7420 616c 6c20 7265 to select all re │ │ │ │ +000154c0: 6374 616e 676c 6573 2e20 2054 6865 2073 ctangles. The s │ │ │ │ +000154d0: 7461 7475 730a 2020 2020 2062 6172 2073 tatus. bar s │ │ │ │ +000154e0: 686f 756c 6420 696e 6469 6361 7465 2074 hould indicate t │ │ │ │ +000154f0: 6861 7420 3920 7265 6374 616e 676c 6573 hat 9 rectangles │ │ │ │ +00015500: 2061 7265 2073 656c 6563 7465 642e 0a20 are selected.. │ │ │ │ +00015510: 2037 2e20 436c 6963 6b20 7468 6520 6c61 7. Click the la │ │ │ │ +00015520: 7965 7220 6869 6465 2069 636f 6e20 666f yer hide icon fo │ │ │ │ +00015530: 7220 7468 6520 736c 6963 6520 6c61 7965 r the slice laye │ │ │ │ +00015540: 7220 696e 2074 6865 206c 6179 6572 2070 r in the layer p │ │ │ │ +00015550: 616c 6574 7465 2e0a 2020 2020 2054 6865 alette.. The │ │ │ │ +00015560: 2072 6563 7461 6e67 6c65 7320 7769 6c6c rectangles will │ │ │ │ +00015570: 2072 656d 6169 6e20 7365 6c65 6374 6564 remain selected │ │ │ │ +00015580: 2c20 6576 656e 2074 686f 7567 6820 7468 , even though th │ │ │ │ +00015590: 6579 2061 7265 2068 6964 6465 6e2e 0a20 ey are hidden.. │ │ │ │ +000155a0: 2038 2e20 4368 6f6f 7365 2046 696c 6520 8. Choose File │ │ │ │ +000155b0: 7c20 4578 706f 7274 2042 6974 6d61 7020 | Export Bitmap │ │ │ │ +000155c0: 616e 6420 6368 6563 6b20 7468 6520 2a42 and check the *B │ │ │ │ +000155d0: 6174 6368 2065 7870 6f72 7420 3920 7365 atch export 9 se │ │ │ │ +000155e0: 6c65 6374 6564 0a20 2020 2020 6f62 6a65 lected. obje │ │ │ │ +000155f0: 6374 732a 2062 6f78 2e20 204d 616b 6520 cts* box. Make │ │ │ │ +00015600: 7375 7265 2074 6861 7420 2a48 6964 6520 sure that *Hide │ │ │ │ +00015610: 616c 6c20 6578 6365 7074 2073 656c 6563 all except selec │ │ │ │ +00015620: 7465 642a 2069 730a 2020 2020 2075 6e63 ted* is. unc │ │ │ │ +00015630: 6865 636b 6564 2e20 2063 6c69 636b 202a hecked. click * │ │ │ │ +00015640: 4578 706f 7274 2a2e 2020 5468 6973 2077 Export*. This w │ │ │ │ +00015650: 696c 6c20 6372 6561 7465 2050 4e47 2066 ill create PNG f │ │ │ │ +00015660: 696c 6573 2069 6e20 7468 6520 7361 6d65 iles in the same │ │ │ │ +00015670: 0a20 2020 2020 6469 7265 6374 6f72 7920 . directory │ │ │ │ +00015680: 6173 2074 6865 2064 7261 7769 6e67 2c20 as the drawing, │ │ │ │ +00015690: 6e61 6d65 6420 6166 7465 7220 7468 6520 named after the │ │ │ │ +000156a0: 736c 6963 6573 2e20 2054 6865 7365 2063 slices. These c │ │ │ │ +000156b0: 616e 206e 6f77 2062 650a 2020 2020 2075 an now be. u │ │ │ │ +000156c0: 7365 6420 666f 7220 6120 7374 796c 6564 sed for a styled │ │ │ │ +000156d0: 2062 6f78 2069 6e20 6120 4752 5542 2074 box in a GRUB t │ │ │ │ +000156e0: 6865 6d65 2e0a 0a37 2e33 2054 6865 6d65 heme...7.3 Theme │ │ │ │ +000156f0: 2046 696c 6520 4d61 6e75 616c 0a3d 3d3d File Manual.=== │ │ │ │ +00015700: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ +00015710: 3d3d 0a0a 5468 6520 7468 656d 6520 6669 ==..The theme fi │ │ │ │ +00015720: 6c65 2069 7320 6120 706c 6169 6e20 7465 le is a plain te │ │ │ │ +00015730: 7874 2066 696c 652e 2020 4c69 6e65 7320 xt file. Lines │ │ │ │ +00015740: 7468 6174 2062 6567 696e 2077 6974 6820 that begin with │ │ │ │ +00015750: 2223 2220 6172 650a 6967 6e6f 7265 6420 "#" are.ignored │ │ │ │ +00015760: 616e 6420 636f 6e73 6964 6572 6564 2063 and considered c │ │ │ │ +00015770: 6f6d 6d65 6e74 732e 2020 284e 6f74 653a omments. (Note: │ │ │ │ +00015780: 2054 6869 7320 6d61 7920 6e6f 7420 6265 This may not be │ │ │ │ +00015790: 2074 6865 2063 6173 6520 6966 2074 6865 the case if the │ │ │ │ +000157a0: 0a70 7265 7669 6f75 7320 6c69 6e65 2065 .previous line e │ │ │ │ +000157b0: 6e64 6564 2077 6865 7265 2061 2076 616c nded where a val │ │ │ │ +000157c0: 7565 2077 6173 2065 7870 6563 7465 642e ue was expected. │ │ │ │ +000157d0: 290a 0a20 2020 5468 6520 7468 656d 6520 ).. The theme │ │ │ │ +000157e0: 6669 6c65 2063 6f6e 7461 696e 7320 7477 file contains tw │ │ │ │ +000157f0: 6f20 7479 7065 7320 6f66 2073 7461 7465 o types of state │ │ │ │ +00015800: 6d65 6e74 733a 0a20 2031 2e20 476c 6f62 ments:. 1. Glob │ │ │ │ +00015810: 616c 2070 726f 7065 7274 6965 732e 0a20 al properties.. │ │ │ │ +00015820: 2032 2e20 436f 6d70 6f6e 656e 7420 636f 2. Component co │ │ │ │ +00015830: 6e73 7472 7563 7469 6f6e 2e0a 0a37 2e33 nstruction...7.3 │ │ │ │ +00015840: 2e31 2047 6c6f 6261 6c20 5072 6f70 6572 .1 Global Proper │ │ │ │ +00015850: 7469 6573 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d ties.----------- │ │ │ │ +00015860: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 372e ------------..7. │ │ │ │ +00015870: 332e 3220 466f 726d 6174 0a2d 2d2d 2d2d 3.2 Format.----- │ │ │ │ +00015880: 2d2d 2d2d 2d2d 2d0a 0a47 6c6f 6261 6c20 -------..Global │ │ │ │ +00015890: 7072 6f70 6572 7469 6573 2061 7265 2073 properties are s │ │ │ │ +000158a0: 7065 6369 6669 6564 2077 6974 6820 7468 pecified with th │ │ │ │ +000158b0: 6520 7369 6d70 6c65 2066 6f72 6d61 743a e simple format: │ │ │ │ +000158c0: 0a20 2020 2a20 6e61 6d65 313a 2076 616c . * name1: val │ │ │ │ +000158d0: 7565 310a 2020 202a 206e 616d 6532 3a20 ue1. * name2: │ │ │ │ +000158e0: 2276 616c 7565 2077 6869 6368 206d 6179 "value which may │ │ │ │ +000158f0: 2063 6f6e 7461 696e 2073 7061 6365 7322 contain spaces" │ │ │ │ +00015900: 0a20 2020 2a20 6e61 6d65 333a 2023 3838 . * name3: #88 │ │ │ │ +00015910: 460a 0a20 2020 496e 2074 6869 7320 6578 F.. In this ex │ │ │ │ +00015920: 616d 706c 652c 206e 616d 6533 2069 7320 ample, name3 is │ │ │ │ +00015930: 6173 7369 676e 6564 2061 2063 6f6c 6f72 assigned a color │ │ │ │ +00015940: 2076 616c 7565 2e0a 0a37 2e33 2e33 2047 value...7.3.3 G │ │ │ │ +00015950: 6c6f 6261 6c20 5072 6f70 6572 7479 204c lobal Property L │ │ │ │ +00015960: 6973 740a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ist.------------ │ │ │ │ +00015970: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a --------------.. │ │ │ │ +00015980: 7469 746c 652d 7465 7874 2020 2020 2020 title-text │ │ │ │ +00015990: 2020 2020 2020 2053 7065 6369 6669 6573 Specifies │ │ │ │ +000159a0: 2074 6865 2074 6578 7420 746f 2064 6973 the text to dis │ │ │ │ +000159b0: 706c 6179 2061 7420 7468 6520 746f 700a play at the top. │ │ │ │ 000159c0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -000159d0: 2020 2063 656e 7465 7220 6f66 2074 6865 center of the │ │ │ │ -000159e0: 2073 6372 6565 6e20 6173 2061 2074 6974 screen as a tit │ │ │ │ -000159f0: 6c65 2e0a 7469 746c 652d 666f 6e74 2020 le..title-font │ │ │ │ -00015a00: 2020 2020 2020 2020 2020 2044 6566 696e Defin │ │ │ │ -00015a10: 6573 2074 6865 2066 6f6e 7420 7573 6564 es the font used │ │ │ │ -00015a20: 2066 6f72 2074 6865 2074 6974 6c65 0a20 for the title. │ │ │ │ -00015a30: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00015a40: 2020 2020 2020 6d65 7373 6167 6520 6174 message at │ │ │ │ -00015a50: 2074 6865 2074 6f70 206f 6620 7468 6520 the top of the │ │ │ │ -00015a60: 7363 7265 656e 2e0a 7469 746c 652d 636f screen..title-co │ │ │ │ -00015a70: 6c6f 7220 2020 2020 2020 2020 2020 2044 lor D │ │ │ │ -00015a80: 6566 696e 6573 2074 6865 2063 6f6c 6f72 efines the color │ │ │ │ -00015a90: 206f 6620 7468 6520 7469 746c 6520 6d65 of the title me │ │ │ │ -00015aa0: 7373 6167 652e 0a6d 6573 7361 6765 2d66 ssage..message-f │ │ │ │ -00015ab0: 6f6e 7420 2020 2020 2020 2020 2020 4375 ont Cu │ │ │ │ -00015ac0: 7272 656e 746c 7920 756e 7573 6564 2e20 rrently unused. │ │ │ │ -00015ad0: 204c 6566 7420 666f 7220 6261 636b 7761 Left for backwa │ │ │ │ -00015ae0: 7264 0a20 2020 2020 2020 2020 2020 2020 rd. │ │ │ │ -00015af0: 2020 2020 2020 2020 2020 636f 6d70 6174 compat │ │ │ │ -00015b00: 6962 696c 6974 792e 0a6d 6573 7361 6765 ibility..message │ │ │ │ -00015b10: 2d63 6f6c 6f72 2020 2020 2020 2020 2020 -color │ │ │ │ -00015b20: 4375 7272 656e 746c 7920 756e 7573 6564 Currently unused │ │ │ │ -00015b30: 2e20 204c 6566 7420 666f 7220 6261 636b . Left for back │ │ │ │ -00015b40: 7761 7264 0a20 2020 2020 2020 2020 2020 ward. │ │ │ │ -00015b50: 2020 2020 2020 2020 2020 2020 636f 6d70 comp │ │ │ │ -00015b60: 6174 6962 696c 6974 792e 0a6d 6573 7361 atibility..messa │ │ │ │ -00015b70: 6765 2d62 672d 636f 6c6f 7220 2020 2020 ge-bg-color │ │ │ │ -00015b80: 2020 4375 7272 656e 746c 7920 756e 7573 Currently unus │ │ │ │ -00015b90: 6564 2e20 204c 6566 7420 666f 7220 6261 ed. Left for ba │ │ │ │ -00015ba0: 636b 7761 7264 0a20 2020 2020 2020 2020 ckward. │ │ │ │ -00015bb0: 2020 2020 2020 2020 2020 2020 2020 636f co │ │ │ │ -00015bc0: 6d70 6174 6962 696c 6974 792e 0a64 6573 mpatibility..des │ │ │ │ -00015bd0: 6b74 6f70 2d69 6d61 6765 2020 2020 2020 ktop-image │ │ │ │ -00015be0: 2020 2020 5370 6563 6966 6965 7320 7468 Specifies th │ │ │ │ -00015bf0: 6520 696d 6167 6520 746f 2075 7365 2061 e image to use a │ │ │ │ -00015c00: 7320 7468 650a 2020 2020 2020 2020 2020 s the. │ │ │ │ -00015c10: 2020 2020 2020 2020 2020 2020 2062 6163 bac │ │ │ │ -00015c20: 6b67 726f 756e 642e 2020 4974 2077 696c kground. It wil │ │ │ │ -00015c30: 6c20 6265 2073 6361 6c65 6420 746f 2066 l be scaled to f │ │ │ │ -00015c40: 6974 2074 6865 0a20 2020 2020 2020 2020 it the. │ │ │ │ -00015c50: 2020 2020 2020 2020 2020 2020 2020 7363 sc │ │ │ │ -00015c60: 7265 656e 2073 697a 6520 6f72 2070 726f reen size or pro │ │ │ │ -00015c70: 706f 7274 696f 6e61 6c6c 7920 7363 616c portionally scal │ │ │ │ -00015c80: 6564 0a20 2020 2020 2020 2020 2020 2020 ed. │ │ │ │ -00015c90: 2020 2020 2020 2020 2020 6465 7065 6e64 depend │ │ │ │ -00015ca0: 696e 6720 6f6e 2074 6865 2073 6361 6c65 ing on the scale │ │ │ │ -00015cb0: 206d 6574 686f 642e 0a64 6573 6b74 6f70 method..desktop │ │ │ │ -00015cc0: 2d69 6d61 6765 2d73 6361 6c65 2d6d 6574 -image-scale-met │ │ │ │ -00015cd0: 686f 6453 7065 6369 6669 6573 2074 6865 hodSpecifies the │ │ │ │ -00015ce0: 2073 6361 6c69 6e67 206d 6574 686f 6420 scaling method │ │ │ │ -00015cf0: 666f 7220 7468 650a 2020 2020 2020 2020 for the. │ │ │ │ -00015d00: 2020 2020 2020 2020 2020 2020 2020 202a * │ │ │ │ -00015d10: 6465 736b 746f 702d 696d 6167 652a 2e20 desktop-image*. │ │ │ │ -00015d20: 204f 7074 696f 6e73 2061 7265 2022 7374 Options are "st │ │ │ │ -00015d30: 7265 7463 6822 2c0a 2020 2020 2020 2020 retch",. │ │ │ │ -00015d40: 2020 2020 2020 2020 2020 2020 2020 2022 " │ │ │ │ -00015d50: 6372 6f70 222c 2022 7061 6464 696e 6722 crop", "padding" │ │ │ │ -00015d60: 2c20 2266 6974 7769 6474 6822 2c0a 2020 , "fitwidth",. │ │ │ │ -00015d70: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00015d80: 2020 2020 2022 6669 7468 6569 6768 7422 "fitheight" │ │ │ │ -00015d90: 2e20 2022 7374 7265 7463 6822 2066 6f72 . "stretch" for │ │ │ │ -00015da0: 2066 6974 7469 6e67 2074 6865 0a20 2020 fitting the. │ │ │ │ -00015db0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00015dc0: 2020 2020 7363 7265 656e 2073 697a 652e screen size. │ │ │ │ -00015dd0: 2020 4f74 6865 7277 6973 6520 6974 2069 Otherwise it i │ │ │ │ -00015de0: 730a 2020 2020 2020 2020 2020 2020 2020 s. │ │ │ │ -00015df0: 2020 2020 2020 2020 2070 726f 706f 7274 proport │ │ │ │ -00015e00: 696f 6e61 6c20 7363 616c 696e 6720 6f66 ional scaling of │ │ │ │ -00015e10: 2061 2070 6172 7420 6f66 0a20 2020 2020 a part of. │ │ │ │ +000159d0: 2020 2020 2020 2063 656e 7465 7220 6f66 center of │ │ │ │ +000159e0: 2074 6865 2073 6372 6565 6e20 6173 2061 the screen as a │ │ │ │ +000159f0: 2074 6974 6c65 2e0a 7469 746c 652d 666f title..title-fo │ │ │ │ +00015a00: 6e74 2020 2020 2020 2020 2020 2020 2044 nt D │ │ │ │ +00015a10: 6566 696e 6573 2074 6865 2066 6f6e 7420 efines the font │ │ │ │ +00015a20: 7573 6564 2066 6f72 2074 6865 2074 6974 used for the tit │ │ │ │ +00015a30: 6c65 0a20 2020 2020 2020 2020 2020 2020 le. │ │ │ │ +00015a40: 2020 2020 2020 2020 2020 6d65 7373 6167 messag │ │ │ │ +00015a50: 6520 6174 2074 6865 2074 6f70 206f 6620 e at the top of │ │ │ │ +00015a60: 7468 6520 7363 7265 656e 2e0a 7469 746c the screen..titl │ │ │ │ +00015a70: 652d 636f 6c6f 7220 2020 2020 2020 2020 e-color │ │ │ │ +00015a80: 2020 2044 6566 696e 6573 2074 6865 2063 Defines the c │ │ │ │ +00015a90: 6f6c 6f72 206f 6620 7468 6520 7469 746c olor of the titl │ │ │ │ +00015aa0: 6520 6d65 7373 6167 652e 0a6d 6573 7361 e message..messa │ │ │ │ +00015ab0: 6765 2d66 6f6e 7420 2020 2020 2020 2020 ge-font │ │ │ │ +00015ac0: 2020 4375 7272 656e 746c 7920 756e 7573 Currently unus │ │ │ │ +00015ad0: 6564 2e20 204c 6566 7420 666f 7220 6261 ed. Left for ba │ │ │ │ +00015ae0: 636b 7761 7264 0a20 2020 2020 2020 2020 ckward. │ │ │ │ +00015af0: 2020 2020 2020 2020 2020 2020 2020 636f co │ │ │ │ +00015b00: 6d70 6174 6962 696c 6974 792e 0a6d 6573 mpatibility..mes │ │ │ │ +00015b10: 7361 6765 2d63 6f6c 6f72 2020 2020 2020 sage-color │ │ │ │ +00015b20: 2020 2020 4375 7272 656e 746c 7920 756e Currently un │ │ │ │ +00015b30: 7573 6564 2e20 204c 6566 7420 666f 7220 used. Left for │ │ │ │ +00015b40: 6261 636b 7761 7264 0a20 2020 2020 2020 backward. │ │ │ │ +00015b50: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00015b60: 636f 6d70 6174 6962 696c 6974 792e 0a6d compatibility..m │ │ │ │ +00015b70: 6573 7361 6765 2d62 672d 636f 6c6f 7220 essage-bg-color │ │ │ │ +00015b80: 2020 2020 2020 4375 7272 656e 746c 7920 Currently │ │ │ │ +00015b90: 756e 7573 6564 2e20 204c 6566 7420 666f unused. Left fo │ │ │ │ +00015ba0: 7220 6261 636b 7761 7264 0a20 2020 2020 r backward. │ │ │ │ +00015bb0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00015bc0: 2020 636f 6d70 6174 6962 696c 6974 792e compatibility. │ │ │ │ +00015bd0: 0a64 6573 6b74 6f70 2d69 6d61 6765 2020 .desktop-image │ │ │ │ +00015be0: 2020 2020 2020 2020 5370 6563 6966 6965 Specifie │ │ │ │ +00015bf0: 7320 7468 6520 696d 6167 6520 746f 2075 s the image to u │ │ │ │ +00015c00: 7365 2061 7320 7468 650a 2020 2020 2020 se as the. │ │ │ │ +00015c10: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00015c20: 2062 6163 6b67 726f 756e 642e 2020 4974 background. It │ │ │ │ +00015c30: 2077 696c 6c20 6265 2073 6361 6c65 6420 will be scaled │ │ │ │ +00015c40: 746f 2066 6974 2074 6865 0a20 2020 2020 to fit the. │ │ │ │ +00015c50: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00015c60: 2020 7363 7265 656e 2073 697a 6520 6f72 screen size or │ │ │ │ +00015c70: 2070 726f 706f 7274 696f 6e61 6c6c 7920 proportionally │ │ │ │ +00015c80: 7363 616c 6564 0a20 2020 2020 2020 2020 scaled. │ │ │ │ +00015c90: 2020 2020 2020 2020 2020 2020 2020 6465 de │ │ │ │ +00015ca0: 7065 6e64 696e 6720 6f6e 2074 6865 2073 pending on the s │ │ │ │ +00015cb0: 6361 6c65 206d 6574 686f 642e 0a64 6573 cale method..des │ │ │ │ +00015cc0: 6b74 6f70 2d69 6d61 6765 2d73 6361 6c65 ktop-image-scale │ │ │ │ +00015cd0: 2d6d 6574 686f 6453 7065 6369 6669 6573 -methodSpecifies │ │ │ │ +00015ce0: 2074 6865 2073 6361 6c69 6e67 206d 6574 the scaling met │ │ │ │ +00015cf0: 686f 6420 666f 7220 7468 650a 2020 2020 hod for the. │ │ │ │ +00015d00: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00015d10: 2020 202a 6465 736b 746f 702d 696d 6167 *desktop-imag │ │ │ │ +00015d20: 652a 2e20 204f 7074 696f 6e73 2061 7265 e*. Options are │ │ │ │ +00015d30: 2022 7374 7265 7463 6822 2c0a 2020 2020 "stretch",. │ │ │ │ +00015d40: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00015d50: 2020 2022 6372 6f70 222c 2022 7061 6464 "crop", "padd │ │ │ │ +00015d60: 696e 6722 2c20 2266 6974 7769 6474 6822 ing", "fitwidth" │ │ │ │ +00015d70: 2c0a 2020 2020 2020 2020 2020 2020 2020 ,. │ │ │ │ +00015d80: 2020 2020 2020 2020 2022 6669 7468 6569 "fithei │ │ │ │ +00015d90: 6768 7422 2e20 2022 7374 7265 7463 6822 ght". "stretch" │ │ │ │ +00015da0: 2066 6f72 2066 6974 7469 6e67 2074 6865 for fitting the │ │ │ │ +00015db0: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ +00015dc0: 2020 2020 2020 2020 7363 7265 656e 2073 screen s │ │ │ │ +00015dd0: 697a 652e 2020 4f74 6865 7277 6973 6520 ize. Otherwise │ │ │ │ +00015de0: 6974 2069 730a 2020 2020 2020 2020 2020 it is. │ │ │ │ +00015df0: 2020 2020 2020 2020 2020 2020 2070 726f pro │ │ │ │ +00015e00: 706f 7274 696f 6e61 6c20 7363 616c 696e portional scalin │ │ │ │ +00015e10: 6720 6f66 2061 2070 6172 7420 6f66 0a20 g of a part of. │ │ │ │ 00015e20: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00015e30: 2020 2a64 6573 6b74 6f70 2d69 6d61 6765 *desktop-image │ │ │ │ -00015e40: 2a20 746f 2074 6865 2070 6172 7420 6f66 * to the part of │ │ │ │ -00015e50: 2074 6865 0a20 2020 2020 2020 2020 2020 the. │ │ │ │ -00015e60: 2020 2020 2020 2020 2020 2020 7363 7265 scre │ │ │ │ -00015e70: 656e 2e20 2022 6372 6f70 2220 7061 7274 en. "crop" part │ │ │ │ -00015e80: 206f 6620 7468 650a 2020 2020 2020 2020 of the. │ │ │ │ -00015e90: 2020 2020 2020 2020 2020 2020 2020 202a * │ │ │ │ -00015ea0: 6465 736b 746f 702d 696d 6167 652a 2077 desktop-image* w │ │ │ │ -00015eb0: 696c 6c20 6265 2070 726f 706f 7274 696f ill be proportio │ │ │ │ -00015ec0: 6e61 6c6c 790a 2020 2020 2020 2020 2020 nally. │ │ │ │ -00015ed0: 2020 2020 2020 2020 2020 2020 2073 6361 sca │ │ │ │ -00015ee0: 6c65 6420 746f 2066 6974 2074 6865 2073 led to fit the s │ │ │ │ -00015ef0: 6372 6565 6e20 7369 7a65 732e 0a20 2020 creen sizes.. │ │ │ │ -00015f00: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00015f10: 2020 2020 2270 6164 6469 6e67 2220 7468 "padding" th │ │ │ │ -00015f20: 6520 656e 7469 7265 202a 6465 736b 746f e entire *deskto │ │ │ │ -00015f30: 702d 696d 6167 652a 2077 696c 6c0a 2020 p-image* will. │ │ │ │ -00015f40: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00015f50: 2020 2020 2062 6520 636f 6e74 6169 6e65 be containe │ │ │ │ -00015f60: 6420 6f6e 2074 6865 2073 6372 6565 6e2e d on the screen. │ │ │ │ -00015f70: 2020 2266 6974 7769 6474 6822 0a20 2020 "fitwidth". │ │ │ │ -00015f80: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00015f90: 2020 2020 666f 7220 6669 7474 696e 6720 for fitting │ │ │ │ -00015fa0: 7468 6520 2a64 6573 6b74 6f70 2d69 6d61 the *desktop-ima │ │ │ │ -00015fb0: 6765 2a27 7320 7769 6474 680a 2020 2020 ge*'s width. │ │ │ │ +00015e30: 2020 2020 2020 2a64 6573 6b74 6f70 2d69 *desktop-i │ │ │ │ +00015e40: 6d61 6765 2a20 746f 2074 6865 2070 6172 mage* to the par │ │ │ │ +00015e50: 7420 6f66 2074 6865 0a20 2020 2020 2020 t of the. │ │ │ │ +00015e60: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00015e70: 7363 7265 656e 2e20 2022 6372 6f70 2220 screen. "crop" │ │ │ │ +00015e80: 7061 7274 206f 6620 7468 650a 2020 2020 part of the. │ │ │ │ +00015e90: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00015ea0: 2020 202a 6465 736b 746f 702d 696d 6167 *desktop-imag │ │ │ │ +00015eb0: 652a 2077 696c 6c20 6265 2070 726f 706f e* will be propo │ │ │ │ +00015ec0: 7274 696f 6e61 6c6c 790a 2020 2020 2020 rtionally. │ │ │ │ +00015ed0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00015ee0: 2073 6361 6c65 6420 746f 2066 6974 2074 scaled to fit t │ │ │ │ +00015ef0: 6865 2073 6372 6565 6e20 7369 7a65 732e he screen sizes. │ │ │ │ +00015f00: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ +00015f10: 2020 2020 2020 2020 2270 6164 6469 6e67 "padding │ │ │ │ +00015f20: 2220 7468 6520 656e 7469 7265 202a 6465 " the entire *de │ │ │ │ +00015f30: 736b 746f 702d 696d 6167 652a 2077 696c sktop-image* wil │ │ │ │ +00015f40: 6c0a 2020 2020 2020 2020 2020 2020 2020 l. │ │ │ │ +00015f50: 2020 2020 2020 2020 2062 6520 636f 6e74 be cont │ │ │ │ +00015f60: 6169 6e65 6420 6f6e 2074 6865 2073 6372 ained on the scr │ │ │ │ +00015f70: 6565 6e2e 2020 2266 6974 7769 6474 6822 een. "fitwidth" │ │ │ │ +00015f80: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ +00015f90: 2020 2020 2020 2020 666f 7220 6669 7474 for fitt │ │ │ │ +00015fa0: 696e 6720 7468 6520 2a64 6573 6b74 6f70 ing the *desktop │ │ │ │ +00015fb0: 2d69 6d61 6765 2a27 7320 7769 6474 680a -image*'s width. │ │ │ │ 00015fc0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00015fd0: 2020 2077 6974 6820 7363 7265 656e 2077 with screen w │ │ │ │ -00015fe0: 6964 7468 2e20 2022 6669 7468 6569 6768 idth. "fitheigh │ │ │ │ -00015ff0: 7422 2066 6f72 0a20 2020 2020 2020 2020 t" for. │ │ │ │ -00016000: 2020 2020 2020 2020 2020 2020 2020 6669 fi │ │ │ │ -00016010: 7474 696e 6720 7468 6520 2a64 6573 6b74 tting the *deskt │ │ │ │ -00016020: 6f70 2d69 6d61 6765 2a27 7320 6865 6967 op-image*'s heig │ │ │ │ -00016030: 6874 2077 6974 680a 2020 2020 2020 2020 ht with. │ │ │ │ -00016040: 2020 2020 2020 2020 2020 2020 2020 2074 t │ │ │ │ -00016050: 6865 2073 6372 6565 6e20 6865 6967 6874 he screen height │ │ │ │ -00016060: 2e20 2044 6566 6175 6c74 2069 7320 2273 . Default is "s │ │ │ │ -00016070: 7472 6574 6368 222e 0a64 6573 6b74 6f70 tretch"..desktop │ │ │ │ -00016080: 2d69 6d61 6765 2d68 2d61 6c69 676e 2020 -image-h-align │ │ │ │ -00016090: 5370 6563 6966 6965 7320 7468 6520 686f Specifies the ho │ │ │ │ -000160a0: 7269 7a6f 6e74 616c 2061 6c69 676e 6d65 rizontal alignme │ │ │ │ -000160b0: 6e74 206f 6620 7468 650a 2020 2020 2020 nt of the. │ │ │ │ +00015fd0: 2020 2020 2020 2077 6974 6820 7363 7265 with scre │ │ │ │ +00015fe0: 656e 2077 6964 7468 2e20 2022 6669 7468 en width. "fith │ │ │ │ +00015ff0: 6569 6768 7422 2066 6f72 0a20 2020 2020 eight" for. │ │ │ │ +00016000: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00016010: 2020 6669 7474 696e 6720 7468 6520 2a64 fitting the *d │ │ │ │ +00016020: 6573 6b74 6f70 2d69 6d61 6765 2a27 7320 esktop-image*'s │ │ │ │ +00016030: 6865 6967 6874 2077 6974 680a 2020 2020 height with. │ │ │ │ +00016040: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00016050: 2020 2074 6865 2073 6372 6565 6e20 6865 the screen he │ │ │ │ +00016060: 6967 6874 2e20 2044 6566 6175 6c74 2069 ight. Default i │ │ │ │ +00016070: 7320 2273 7472 6574 6368 222e 0a64 6573 s "stretch"..des │ │ │ │ +00016080: 6b74 6f70 2d69 6d61 6765 2d68 2d61 6c69 ktop-image-h-ali │ │ │ │ +00016090: 676e 2020 5370 6563 6966 6965 7320 7468 gn Specifies th │ │ │ │ +000160a0: 6520 686f 7269 7a6f 6e74 616c 2061 6c69 e horizontal ali │ │ │ │ +000160b0: 676e 6d65 6e74 206f 6620 7468 650a 2020 gnment of the. │ │ │ │ 000160c0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -000160d0: 202a 6465 736b 746f 702d 696d 6167 652a *desktop-image* │ │ │ │ -000160e0: 2069 660a 2020 2020 2020 2020 2020 2020 if. │ │ │ │ -000160f0: 2020 2020 2020 2020 2020 202a 6465 736b *desk │ │ │ │ -00016100: 746f 702d 696d 6167 652d 7363 616c 652d top-image-scale- │ │ │ │ -00016110: 6d65 7468 6f64 2a20 6973 6e27 7420 6571 method* isn't eq │ │ │ │ -00016120: 7565 616c 0a20 2020 2020 2020 2020 2020 ueal. │ │ │ │ -00016130: 2020 2020 2020 2020 2020 2020 746f 2022 to " │ │ │ │ -00016140: 7374 7265 7463 6822 2e20 204f 7074 696f stretch". Optio │ │ │ │ -00016150: 6e73 2061 7265 2022 6c65 6674 222c 0a20 ns are "left",. │ │ │ │ -00016160: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00016170: 2020 2020 2020 2263 656e 7465 7222 2c20 "center", │ │ │ │ -00016180: 2272 6967 6874 222e 2020 4465 6661 756c "right". Defaul │ │ │ │ -00016190: 7420 6973 2022 6365 6e74 6572 222e 0a64 t is "center"..d │ │ │ │ -000161a0: 6573 6b74 6f70 2d69 6d61 6765 2d76 2d61 esktop-image-v-a │ │ │ │ -000161b0: 6c69 676e 2020 5370 6563 6966 6965 7320 lign Specifies │ │ │ │ -000161c0: 7468 6520 7665 7274 6963 616c 2061 6c69 the vertical ali │ │ │ │ -000161d0: 676e 6d65 6e74 206f 6620 7468 650a 2020 gnment of the. │ │ │ │ -000161e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -000161f0: 2020 2020 202a 6465 736b 746f 702d 696d *desktop-im │ │ │ │ -00016200: 6167 652a 2069 660a 2020 2020 2020 2020 age* if. │ │ │ │ -00016210: 2020 2020 2020 2020 2020 2020 2020 202a * │ │ │ │ -00016220: 6465 736b 746f 702d 696d 6167 652d 7363 desktop-image-sc │ │ │ │ -00016230: 616c 652d 6d65 7468 6f64 2a20 6973 6e27 ale-method* isn' │ │ │ │ -00016240: 7420 6571 7565 616c 0a20 2020 2020 2020 t equeal. │ │ │ │ +000160d0: 2020 2020 202a 6465 736b 746f 702d 696d *desktop-im │ │ │ │ +000160e0: 6167 652a 2069 660a 2020 2020 2020 2020 age* if. │ │ │ │ +000160f0: 2020 2020 2020 2020 2020 2020 2020 202a * │ │ │ │ +00016100: 6465 736b 746f 702d 696d 6167 652d 7363 desktop-image-sc │ │ │ │ +00016110: 616c 652d 6d65 7468 6f64 2a20 6973 6e27 ale-method* isn' │ │ │ │ +00016120: 7420 6571 7565 616c 0a20 2020 2020 2020 t equeal. │ │ │ │ +00016130: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00016140: 746f 2022 7374 7265 7463 6822 2e20 204f to "stretch". O │ │ │ │ +00016150: 7074 696f 6e73 2061 7265 2022 6c65 6674 ptions are "left │ │ │ │ +00016160: 222c 0a20 2020 2020 2020 2020 2020 2020 ",. │ │ │ │ +00016170: 2020 2020 2020 2020 2020 2263 656e 7465 "cente │ │ │ │ +00016180: 7222 2c20 2272 6967 6874 222e 2020 4465 r", "right". De │ │ │ │ +00016190: 6661 756c 7420 6973 2022 6365 6e74 6572 fault is "center │ │ │ │ +000161a0: 222e 0a64 6573 6b74 6f70 2d69 6d61 6765 "..desktop-image │ │ │ │ +000161b0: 2d76 2d61 6c69 676e 2020 5370 6563 6966 -v-align Specif │ │ │ │ +000161c0: 6965 7320 7468 6520 7665 7274 6963 616c ies the vertical │ │ │ │ +000161d0: 2061 6c69 676e 6d65 6e74 206f 6620 7468 alignment of th │ │ │ │ +000161e0: 650a 2020 2020 2020 2020 2020 2020 2020 e. │ │ │ │ +000161f0: 2020 2020 2020 2020 202a 6465 736b 746f *deskto │ │ │ │ +00016200: 702d 696d 6167 652a 2069 660a 2020 2020 p-image* if. │ │ │ │ +00016210: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00016220: 2020 202a 6465 736b 746f 702d 696d 6167 *desktop-imag │ │ │ │ +00016230: 652d 7363 616c 652d 6d65 7468 6f64 2a20 e-scale-method* │ │ │ │ +00016240: 6973 6e27 7420 6571 7565 616c 0a20 2020 isn't equeal. │ │ │ │ 00016250: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00016260: 746f 2022 7374 7265 7463 6822 2e20 204f to "stretch". O │ │ │ │ -00016270: 7074 696f 6e73 2061 7265 2022 746f 7022 ptions are "top" │ │ │ │ -00016280: 2c0a 2020 2020 2020 2020 2020 2020 2020 ,. │ │ │ │ -00016290: 2020 2020 2020 2020 2022 6365 6e74 6572 "center │ │ │ │ -000162a0: 222c 2022 626f 7474 6f6d 222e 2020 4465 ", "bottom". De │ │ │ │ -000162b0: 6661 756c 7420 6973 2022 6365 6e74 6572 fault is "center │ │ │ │ -000162c0: 222e 0a64 6573 6b74 6f70 2d63 6f6c 6f72 "..desktop-color │ │ │ │ -000162d0: 2020 2020 2020 2020 2020 5370 6563 6966 Specif │ │ │ │ -000162e0: 6965 7320 7468 6520 636f 6c6f 7220 666f ies the color fo │ │ │ │ -000162f0: 7220 7468 6520 6261 636b 6772 6f75 6e64 r the background │ │ │ │ -00016300: 2069 660a 2020 2020 2020 2020 2020 2020 if. │ │ │ │ -00016310: 2020 2020 2020 2020 2020 202a 6465 736b *desk │ │ │ │ -00016320: 746f 702d 696d 6167 652a 2069 7320 6e6f top-image* is no │ │ │ │ -00016330: 7420 7370 6563 6966 6965 642e 0a74 6572 t specified..ter │ │ │ │ -00016340: 6d69 6e61 6c2d 626f 7820 2020 2020 2020 minal-box │ │ │ │ -00016350: 2020 2020 5370 6563 6966 6965 7320 7468 Specifies th │ │ │ │ -00016360: 6520 6669 6c65 206e 616d 6520 7061 7474 e file name patt │ │ │ │ -00016370: 6572 6e20 666f 7220 7468 650a 2020 2020 ern for the. │ │ │ │ +00016260: 2020 2020 746f 2022 7374 7265 7463 6822 to "stretch" │ │ │ │ +00016270: 2e20 204f 7074 696f 6e73 2061 7265 2022 . Options are " │ │ │ │ +00016280: 746f 7022 2c0a 2020 2020 2020 2020 2020 top",. │ │ │ │ +00016290: 2020 2020 2020 2020 2020 2020 2022 6365 "ce │ │ │ │ +000162a0: 6e74 6572 222c 2022 626f 7474 6f6d 222e nter", "bottom". │ │ │ │ +000162b0: 2020 4465 6661 756c 7420 6973 2022 6365 Default is "ce │ │ │ │ +000162c0: 6e74 6572 222e 0a64 6573 6b74 6f70 2d63 nter"..desktop-c │ │ │ │ +000162d0: 6f6c 6f72 2020 2020 2020 2020 2020 5370 olor Sp │ │ │ │ +000162e0: 6563 6966 6965 7320 7468 6520 636f 6c6f ecifies the colo │ │ │ │ +000162f0: 7220 666f 7220 7468 6520 6261 636b 6772 r for the backgr │ │ │ │ +00016300: 6f75 6e64 2069 660a 2020 2020 2020 2020 ound if. │ │ │ │ +00016310: 2020 2020 2020 2020 2020 2020 2020 202a * │ │ │ │ +00016320: 6465 736b 746f 702d 696d 6167 652a 2069 desktop-image* i │ │ │ │ +00016330: 7320 6e6f 7420 7370 6563 6966 6965 642e s not specified. │ │ │ │ +00016340: 0a74 6572 6d69 6e61 6c2d 626f 7820 2020 .terminal-box │ │ │ │ +00016350: 2020 2020 2020 2020 5370 6563 6966 6965 Specifie │ │ │ │ +00016360: 7320 7468 6520 6669 6c65 206e 616d 6520 s the file name │ │ │ │ +00016370: 7061 7474 6572 6e20 666f 7220 7468 650a pattern for the. │ │ │ │ 00016380: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00016390: 2020 2073 7479 6c65 6420 626f 7820 736c styled box sl │ │ │ │ -000163a0: 6963 6573 2075 7365 6420 666f 7220 7468 ices used for th │ │ │ │ -000163b0: 6520 636f 6d6d 616e 640a 2020 2020 2020 e command. │ │ │ │ +00016390: 2020 2020 2020 2073 7479 6c65 6420 626f styled bo │ │ │ │ +000163a0: 7820 736c 6963 6573 2075 7365 6420 666f x slices used fo │ │ │ │ +000163b0: 7220 7468 6520 636f 6d6d 616e 640a 2020 r the command. │ │ │ │ 000163c0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -000163d0: 206c 696e 6520 7465 726d 696e 616c 2077 line terminal w │ │ │ │ -000163e0: 696e 646f 772e 2020 466f 7220 6578 616d indow. For exam │ │ │ │ -000163f0: 706c 652c 0a20 2020 2020 2020 2020 2020 ple,. │ │ │ │ -00016400: 2020 2020 2020 2020 2020 2020 2274 6572 "ter │ │ │ │ -00016410: 6d69 6e61 6c2d 626f 783a 2074 6572 6d69 minal-box: termi │ │ │ │ -00016420: 6e61 6c5f 2a2e 706e 6722 2077 696c 6c20 nal_*.png" will │ │ │ │ -00016430: 7573 650a 2020 2020 2020 2020 2020 2020 use. │ │ │ │ -00016440: 2020 2020 2020 2020 2020 2074 6865 2069 the i │ │ │ │ -00016450: 6d61 6765 7320 2274 6572 6d69 6e61 6c5f mages "terminal_ │ │ │ │ -00016460: 632e 706e 6722 2061 7320 7468 6520 6365 c.png" as the ce │ │ │ │ -00016470: 6e74 6572 0a20 2020 2020 2020 2020 2020 nter. │ │ │ │ -00016480: 2020 2020 2020 2020 2020 2020 6172 6561 area │ │ │ │ -00016490: 2c20 2274 6572 6d69 6e61 6c5f 6e2e 706e , "terminal_n.pn │ │ │ │ -000164a0: 6722 2061 7320 7468 6520 6e6f 7274 6820 g" as the north │ │ │ │ -000164b0: 2874 6f70 290a 2020 2020 2020 2020 2020 (top). │ │ │ │ -000164c0: 2020 2020 2020 2020 2020 2020 2065 6467 edg │ │ │ │ -000164d0: 652c 2022 7465 726d 696e 616c 5f6e 772e e, "terminal_nw. │ │ │ │ -000164e0: 706e 6722 2061 7320 7468 6520 6e6f 7274 png" as the nort │ │ │ │ -000164f0: 6877 6573 740a 2020 2020 2020 2020 2020 hwest. │ │ │ │ -00016500: 2020 2020 2020 2020 2020 2020 2028 7570 (up │ │ │ │ -00016510: 7065 7220 6c65 6674 2920 636f 726e 6572 per left) corner │ │ │ │ -00016520: 2c20 616e 6420 736f 206f 6e2e 2020 4966 , and so on. If │ │ │ │ -00016530: 2074 6865 0a20 2020 2020 2020 2020 2020 the. │ │ │ │ -00016540: 2020 2020 2020 2020 2020 2020 696d 6167 imag │ │ │ │ -00016550: 6520 666f 7220 616e 7920 736c 6963 6520 e for any slice │ │ │ │ -00016560: 6973 206e 6f74 2066 6f75 6e64 2c20 6974 is not found, it │ │ │ │ -00016570: 2077 696c 6c0a 2020 2020 2020 2020 2020 will. │ │ │ │ -00016580: 2020 2020 2020 2020 2020 2020 2073 696d sim │ │ │ │ -00016590: 706c 7920 6265 206c 6566 7420 656d 7074 ply be left empt │ │ │ │ -000165a0: 792e 0a74 6572 6d69 6e61 6c2d 626f 7264 y..terminal-bord │ │ │ │ -000165b0: 6572 2020 2020 2020 2020 5370 6563 6966 er Specif │ │ │ │ -000165c0: 6965 7320 7468 6520 626f 7264 6572 2077 ies the border w │ │ │ │ -000165d0: 6964 7468 206f 6620 7468 650a 2020 2020 idth of the. │ │ │ │ +000163d0: 2020 2020 206c 696e 6520 7465 726d 696e line termin │ │ │ │ +000163e0: 616c 2077 696e 646f 772e 2020 466f 7220 al window. For │ │ │ │ +000163f0: 6578 616d 706c 652c 0a20 2020 2020 2020 example,. │ │ │ │ +00016400: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00016410: 2274 6572 6d69 6e61 6c2d 626f 783a 2074 "terminal-box: t │ │ │ │ +00016420: 6572 6d69 6e61 6c5f 2a2e 706e 6722 2077 erminal_*.png" w │ │ │ │ +00016430: 696c 6c20 7573 650a 2020 2020 2020 2020 ill use. │ │ │ │ +00016440: 2020 2020 2020 2020 2020 2020 2020 2074 t │ │ │ │ +00016450: 6865 2069 6d61 6765 7320 2274 6572 6d69 he images "termi │ │ │ │ +00016460: 6e61 6c5f 632e 706e 6722 2061 7320 7468 nal_c.png" as th │ │ │ │ +00016470: 6520 6365 6e74 6572 0a20 2020 2020 2020 e center. │ │ │ │ +00016480: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00016490: 6172 6561 2c20 2274 6572 6d69 6e61 6c5f area, "terminal_ │ │ │ │ +000164a0: 6e2e 706e 6722 2061 7320 7468 6520 6e6f n.png" as the no │ │ │ │ +000164b0: 7274 6820 2874 6f70 290a 2020 2020 2020 rth (top). │ │ │ │ +000164c0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +000164d0: 2065 6467 652c 2022 7465 726d 696e 616c edge, "terminal │ │ │ │ +000164e0: 5f6e 772e 706e 6722 2061 7320 7468 6520 _nw.png" as the │ │ │ │ +000164f0: 6e6f 7274 6877 6573 740a 2020 2020 2020 northwest. │ │ │ │ +00016500: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00016510: 2028 7570 7065 7220 6c65 6674 2920 636f (upper left) co │ │ │ │ +00016520: 726e 6572 2c20 616e 6420 736f 206f 6e2e rner, and so on. │ │ │ │ +00016530: 2020 4966 2074 6865 0a20 2020 2020 2020 If the. │ │ │ │ +00016540: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00016550: 696d 6167 6520 666f 7220 616e 7920 736c image for any sl │ │ │ │ +00016560: 6963 6520 6973 206e 6f74 2066 6f75 6e64 ice is not found │ │ │ │ +00016570: 2c20 6974 2077 696c 6c0a 2020 2020 2020 , it will. │ │ │ │ +00016580: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00016590: 2073 696d 706c 7920 6265 206c 6566 7420 simply be left │ │ │ │ +000165a0: 656d 7074 792e 0a74 6572 6d69 6e61 6c2d empty..terminal- │ │ │ │ +000165b0: 626f 7264 6572 2020 2020 2020 2020 5370 border Sp │ │ │ │ +000165c0: 6563 6966 6965 7320 7468 6520 626f 7264 ecifies the bord │ │ │ │ +000165d0: 6572 2077 6964 7468 206f 6620 7468 650a er width of the. │ │ │ │ 000165e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -000165f0: 2020 2074 6572 6d69 6e61 6c20 7769 6e64 terminal wind │ │ │ │ -00016600: 6f77 2e0a 7465 726d 696e 616c 2d6c 6566 ow..terminal-lef │ │ │ │ -00016610: 7420 2020 2020 2020 2020 2053 7065 6369 t Speci │ │ │ │ -00016620: 6669 6573 2074 6865 206c 6566 7420 636f fies the left co │ │ │ │ -00016630: 6f72 6469 6e61 7465 206f 6620 7468 650a ordinate of the. │ │ │ │ -00016640: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00016650: 2020 2020 2020 2074 6572 6d69 6e61 6c20 terminal │ │ │ │ -00016660: 7769 6e64 6f77 2e0a 7465 726d 696e 616c window..terminal │ │ │ │ -00016670: 2d74 6f70 2020 2020 2020 2020 2020 2053 -top S │ │ │ │ -00016680: 7065 6369 6669 6573 2074 6865 2074 6f70 pecifies the top │ │ │ │ -00016690: 2063 6f6f 7264 696e 6174 6520 6f66 2074 coordinate of t │ │ │ │ -000166a0: 6865 0a20 2020 2020 2020 2020 2020 2020 he. │ │ │ │ -000166b0: 2020 2020 2020 2020 2020 7465 726d 696e termin │ │ │ │ -000166c0: 616c 2077 696e 646f 772e 0a74 6572 6d69 al window..termi │ │ │ │ -000166d0: 6e61 6c2d 7769 6474 6820 2020 2020 2020 nal-width │ │ │ │ -000166e0: 2020 5370 6563 6966 6965 7320 7468 6520 Specifies the │ │ │ │ -000166f0: 7769 6474 6820 6f66 2074 6865 2074 6572 width of the ter │ │ │ │ -00016700: 6d69 6e61 6c0a 2020 2020 2020 2020 2020 minal. │ │ │ │ -00016710: 2020 2020 2020 2020 2020 2020 2077 696e win │ │ │ │ -00016720: 646f 772e 0a74 6572 6d69 6e61 6c2d 6865 dow..terminal-he │ │ │ │ -00016730: 6967 6874 2020 2020 2020 2020 5370 6563 ight Spec │ │ │ │ -00016740: 6966 6965 7320 7468 6520 6865 6967 6874 ifies the height │ │ │ │ -00016750: 206f 6620 7468 6520 7465 726d 696e 616c of the terminal │ │ │ │ -00016760: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ -00016770: 2020 2020 2020 2020 7769 6e64 6f77 2e0a window.. │ │ │ │ -00016780: 0a37 2e33 2e34 2043 6f6d 706f 6e65 6e74 .7.3.4 Component │ │ │ │ -00016790: 2043 6f6e 7374 7275 6374 696f 6e0a 2d2d Construction.-- │ │ │ │ -000167a0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ -000167b0: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 4772 6561 ----------..Grea │ │ │ │ -000167c0: 7465 7220 6375 7374 6f6d 697a 6162 696c ter customizabil │ │ │ │ -000167d0: 6974 7920 636f 6d65 7320 6973 2070 726f ity comes is pro │ │ │ │ -000167e0: 7669 6465 6420 6279 2063 6f6d 706f 6e65 vided by compone │ │ │ │ -000167f0: 6e74 732e 2020 4120 7472 6565 206f 660a nts. A tree of. │ │ │ │ -00016800: 636f 6d70 6f6e 656e 7473 2066 6f72 6d73 components forms │ │ │ │ -00016810: 2074 6865 2075 7365 7220 696e 7465 7266 the user interf │ │ │ │ -00016820: 6163 652e 2020 2a43 6f6e 7461 696e 6572 ace. *Container │ │ │ │ -00016830: 732a 2061 7265 2063 6f6d 706f 6e65 6e74 s* are component │ │ │ │ -00016840: 7320 7468 6174 0a63 616e 2063 6f6e 7461 s that.can conta │ │ │ │ -00016850: 696e 206f 7468 6572 2063 6f6d 706f 6e65 in other compone │ │ │ │ -00016860: 6e74 732c 2061 6e64 2074 6865 7265 2069 nts, and there i │ │ │ │ -00016870: 7320 616c 7761 7973 2061 2073 696e 676c s always a singl │ │ │ │ -00016880: 6520 726f 6f74 0a63 6f6d 706f 6e65 6e74 e root.component │ │ │ │ -00016890: 2077 6869 6368 2069 7320 616e 2069 6e73 which is an ins │ │ │ │ -000168a0: 7461 6e63 6520 6f66 2061 202a 6361 6e76 tance of a *canv │ │ │ │ -000168b0: 6173 2a20 636f 6e74 6169 6e65 722e 0a0a as* container... │ │ │ │ -000168c0: 2020 2043 6f6d 706f 6e65 6e74 7320 6172 Components ar │ │ │ │ -000168d0: 6520 6372 6561 7465 6420 696e 2074 6865 e created in the │ │ │ │ -000168e0: 2074 6865 6d65 2066 696c 6520 6279 2070 theme file by p │ │ │ │ -000168f0: 7265 6669 7869 6e67 2074 6865 2074 7970 refixing the typ │ │ │ │ -00016900: 6520 6f66 0a63 6f6d 706f 6e65 6e74 2077 e of.component w │ │ │ │ -00016910: 6974 6820 6120 272b 2720 7369 676e 3a0a ith a '+' sign:. │ │ │ │ -00016920: 0a20 2020 2720 2b20 6c61 6265 6c20 7b20 . ' + label { │ │ │ │ -00016930: 7465 7874 3d22 4752 5542 2220 666f 6e74 text="GRUB" font │ │ │ │ -00016940: 3d22 6171 7569 2031 3122 2063 6f6c 6f72 ="aqui 11" color │ │ │ │ -00016950: 3d22 2338 4646 2220 7d20 270a 0a20 2020 ="#8FF" } '.. │ │ │ │ -00016960: 7072 6f70 6572 7469 6573 206f 6620 6120 properties of a │ │ │ │ -00016970: 636f 6d70 6f6e 656e 7420 6172 6520 7370 component are sp │ │ │ │ -00016980: 6563 6966 6965 6420 6173 2022 6e61 6d65 ecified as "name │ │ │ │ -00016990: 203d 2076 616c 7565 2220 2877 6869 7465 = value" (white │ │ │ │ -000169a0: 7370 6163 650a 7375 7272 6f75 6e64 696e space.surroundin │ │ │ │ -000169b0: 6720 746f 6b65 6e73 2069 7320 6f70 7469 g tokens is opti │ │ │ │ -000169c0: 6f6e 616c 2061 6e64 2069 7320 6967 6e6f onal and is igno │ │ │ │ -000169d0: 7265 6429 2077 6865 7265 202a 7661 6c75 red) where *valu │ │ │ │ -000169e0: 652a 206d 6179 2062 653a 0a20 2020 2a20 e* may be:. * │ │ │ │ -000169f0: 6120 7369 6e67 6c65 2077 6f72 6420 2865 a single word (e │ │ │ │ -00016a00: 2e67 2e2c 2022 616c 6967 6e20 3d20 6365 .g., "align = ce │ │ │ │ -00016a10: 6e74 6572 222c 2022 636f 6c6f 7220 3d20 nter", "color = │ │ │ │ -00016a20: 2346 4638 3038 3022 292c 0a20 2020 2a20 #FF8080"),. * │ │ │ │ -00016a30: 6120 7175 6f74 6564 2073 7472 696e 6720 a quoted string │ │ │ │ -00016a40: 2865 2e67 2e2c 2022 7465 7874 203d 2022 (e.g., "text = " │ │ │ │ -00016a50: 4865 6c6c 6f2c 2057 6f72 6c64 2122 2229 Hello, World!"") │ │ │ │ -00016a60: 2c20 6f72 0a20 2020 2a20 6120 7475 706c , or. * a tupl │ │ │ │ -00016a70: 6520 2865 2e67 2e2c 2022 7072 6566 6572 e (e.g., "prefer │ │ │ │ -00016a80: 7265 645f 7369 7a65 203d 2028 3132 302c red_size = (120, │ │ │ │ -00016a90: 2038 3029 2229 2e0a 0a37 2e33 2e35 2043 80)")...7.3.5 C │ │ │ │ -00016aa0: 6f6d 706f 6e65 6e74 204c 6973 740a 2d2d omponent List.-- │ │ │ │ -00016ab0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ -00016ac0: 2d2d 0a0a 5468 6520 666f 6c6c 6f77 696e --..The followin │ │ │ │ -00016ad0: 6720 6973 2061 206c 6973 7420 6f66 2074 g is a list of t │ │ │ │ -00016ae0: 6865 2063 6f6d 706f 6e65 6e74 7320 616e he components an │ │ │ │ -00016af0: 6420 7468 6520 7072 6f70 6572 7469 6573 d the properties │ │ │ │ -00016b00: 2074 6865 790a 7375 7070 6f72 742e 0a0a they.support... │ │ │ │ -00016b10: 2020 202a 206c 6162 656c 2041 206c 6162 * label A lab │ │ │ │ -00016b20: 656c 2064 6973 706c 6179 7320 6120 6c69 el displays a li │ │ │ │ -00016b30: 6e65 206f 6620 7465 7874 2e0a 0a20 2020 ne of text... │ │ │ │ -00016b40: 2020 5072 6f70 6572 7469 6573 3a0a 2020 Properties:. │ │ │ │ -00016b50: 2020 2069 6420 2020 2020 2020 2020 2020 id │ │ │ │ -00016b60: 2020 5365 7420 746f 2022 5f5f 7469 6d65 Set to "__time │ │ │ │ -00016b70: 6f75 745f 5f22 2074 6f20 6469 7370 6c61 out__" to displa │ │ │ │ -00016b80: 7920 7468 6520 7469 6d65 2065 6c61 7073 y the time elaps │ │ │ │ -00016b90: 6564 0a20 2020 2020 2020 2020 2020 2020 ed. │ │ │ │ -00016ba0: 2020 2020 2020 2074 6f20 616e 2061 7574 to an aut │ │ │ │ -00016bb0: 6f6d 6174 6963 616c 2062 6f6f 7420 6f66 omatical boot of │ │ │ │ -00016bc0: 2074 6865 2064 6566 6175 6c74 2065 6e74 the default ent │ │ │ │ -00016bd0: 7279 2e0a 2020 2020 2074 6578 7420 2020 ry.. text │ │ │ │ -00016be0: 2020 2020 2020 2020 5468 6520 7465 7874 The text │ │ │ │ -00016bf0: 2074 6f20 6469 7370 6c61 792e 2020 4966 to display. If │ │ │ │ -00016c00: 2022 6964 2220 6973 2073 6574 2074 6f0a "id" is set to. │ │ │ │ -00016c10: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00016c20: 2020 2020 225f 5f74 696d 656f 7574 5f5f "__timeout__ │ │ │ │ -00016c30: 2220 616e 6420 6e6f 2022 7465 7874 2220 " and no "text" │ │ │ │ -00016c40: 7072 6f70 6572 7479 2069 7320 7365 7420 property is set │ │ │ │ -00016c50: 7468 656e 0a20 2020 2020 2020 2020 2020 then. │ │ │ │ -00016c60: 2020 2020 2020 2020 2074 6865 2061 6d6f the amo │ │ │ │ -00016c70: 756e 7420 6f66 2073 6563 6f6e 6473 2077 unt of seconds w │ │ │ │ -00016c80: 696c 6c20 6265 2073 686f 776e 2e20 2049 ill be shown. I │ │ │ │ -00016c90: 6620 7365 7420 746f 0a20 2020 2020 2020 f set to. │ │ │ │ -00016ca0: 2020 2020 2020 2020 2020 2020 2022 404b "@K │ │ │ │ -00016cb0: 4559 4d41 505f 5348 4f52 5440 222c 2022 EYMAP_SHORT@", " │ │ │ │ -00016cc0: 404b 4559 4d41 505f 4d49 4444 4c45 4022 @KEYMAP_MIDDLE@" │ │ │ │ -00016cd0: 206f 720a 2020 2020 2020 2020 2020 2020 or. │ │ │ │ -00016ce0: 2020 2020 2020 2020 2240 4b45 594d 4150 "@KEYMAP │ │ │ │ -00016cf0: 5f4c 4f4e 4740 2220 7468 656e 2070 7265 _LONG@" then pre │ │ │ │ -00016d00: 6465 6669 6e65 6420 686f 746b 6579 0a20 defined hotkey. │ │ │ │ -00016d10: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00016d20: 2020 2069 6e66 6f72 6d61 7469 6f6e 2077 information w │ │ │ │ -00016d30: 696c 6c20 6265 2073 686f 776e 2e0a 2020 ill be shown.. │ │ │ │ -00016d40: 2020 2066 6f6e 7420 2020 2020 2020 2020 font │ │ │ │ -00016d50: 2020 5468 6520 666f 6e74 2074 6f20 7573 The font to us │ │ │ │ -00016d60: 6520 666f 7220 7465 7874 2064 6973 706c e for text displ │ │ │ │ -00016d70: 6179 2e0a 2020 2020 2063 6f6c 6f72 2020 ay.. color │ │ │ │ -00016d80: 2020 2020 2020 2020 5468 6520 636f 6c6f The colo │ │ │ │ -00016d90: 7220 6f66 2074 6865 2074 6578 742e 0a20 r of the text.. │ │ │ │ -00016da0: 2020 2020 616c 6967 6e20 2020 2020 2020 align │ │ │ │ -00016db0: 2020 2054 6865 2068 6f72 697a 6f6e 7461 The horizonta │ │ │ │ -00016dc0: 6c20 616c 6967 6e6d 656e 7420 6f66 2074 l alignment of t │ │ │ │ -00016dd0: 6865 2074 6578 7420 7769 7468 696e 2074 he text within t │ │ │ │ -00016de0: 6865 0a20 2020 2020 2020 2020 2020 2020 he. │ │ │ │ -00016df0: 2020 2020 2020 2063 6f6d 706f 6e65 6e74 component │ │ │ │ -00016e00: 2e20 204f 7074 696f 6e73 2061 7265 2022 . Options are " │ │ │ │ -00016e10: 6c65 6674 222c 2022 6365 6e74 6572 2220 left", "center" │ │ │ │ -00016e20: 616e 640a 2020 2020 2020 2020 2020 2020 and. │ │ │ │ -00016e30: 2020 2020 2020 2020 2272 6967 6874 222e "right". │ │ │ │ -00016e40: 0a20 2020 2020 7669 7369 626c 6520 2020 . visible │ │ │ │ -00016e50: 2020 2020 2053 6574 2074 6f20 2266 616c Set to "fal │ │ │ │ -00016e60: 7365 2220 746f 2068 6964 6520 7468 6520 se" to hide the │ │ │ │ -00016e70: 6c61 6265 6c2e 0a0a 2020 202a 2069 6d61 label... * ima │ │ │ │ -00016e80: 6765 2041 2063 6f6d 706f 6e65 6e74 2074 ge A component t │ │ │ │ -00016e90: 6861 7420 6469 7370 6c61 7973 2061 6e20 hat displays an │ │ │ │ -00016ea0: 696d 6167 652e 2020 5468 6520 696d 6167 image. The imag │ │ │ │ -00016eb0: 6520 6973 2073 6361 6c65 6420 746f 0a20 e is scaled to. │ │ │ │ -00016ec0: 2020 2020 6669 7420 7468 6520 636f 6d70 fit the comp │ │ │ │ -00016ed0: 6f6e 656e 742e 0a0a 2020 2020 2050 726f onent... Pro │ │ │ │ -00016ee0: 7065 7274 6965 733a 0a0a 2020 2020 2066 perties:.. f │ │ │ │ -00016ef0: 696c 6520 2020 2020 2020 2020 2020 5468 ile Th │ │ │ │ -00016f00: 6520 6675 6c6c 2070 6174 6820 746f 2074 e full path to t │ │ │ │ -00016f10: 6865 2069 6d61 6765 2066 696c 6520 746f he image file to │ │ │ │ -00016f20: 206c 6f61 642e 0a0a 2020 202a 2070 726f load... * pro │ │ │ │ -00016f30: 6772 6573 735f 6261 7220 4469 7370 6c61 gress_bar Displa │ │ │ │ -00016f40: 7973 2061 2068 6f72 697a 6f6e 7461 6c6c ys a horizontall │ │ │ │ -00016f50: 7920 6f72 6965 6e74 6564 2070 726f 6772 y oriented progr │ │ │ │ -00016f60: 6573 7320 6261 722e 2020 4974 2063 616e ess bar. It can │ │ │ │ -00016f70: 0a20 2020 2020 6265 2072 656e 6465 7265 . be rendere │ │ │ │ -00016f80: 6420 7573 696e 6720 7369 6d70 6c65 2073 d using simple s │ │ │ │ -00016f90: 6f6c 6964 2066 696c 6c65 6420 7265 6374 olid filled rect │ │ │ │ -00016fa0: 616e 676c 6573 2c20 6f72 2075 7369 6e67 angles, or using │ │ │ │ -00016fb0: 2061 2070 6169 720a 2020 2020 206f 6620 a pair. of │ │ │ │ -00016fc0: 7069 786d 6170 2073 7479 6c65 6420 626f pixmap styled bo │ │ │ │ -00016fd0: 7865 732e 0a0a 2020 2020 2050 726f 7065 xes... Prope │ │ │ │ -00016fe0: 7274 6965 733a 0a0a 2020 2020 2069 6420 rties:.. id │ │ │ │ -00016ff0: 2020 2020 2020 2020 2020 2020 5365 7420 Set │ │ │ │ -00017000: 746f 2022 5f5f 7469 6d65 6f75 745f 5f22 to "__timeout__" │ │ │ │ -00017010: 2074 6f20 6469 7370 6c61 7920 7468 6520 to display the │ │ │ │ -00017020: 7469 6d65 2065 6c61 7073 6564 0a20 2020 time elapsed. │ │ │ │ -00017030: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00017040: 2074 6f20 616e 2061 7574 6f6d 6174 6963 to an automatic │ │ │ │ -00017050: 616c 2062 6f6f 7420 6f66 2074 6865 2064 al boot of the d │ │ │ │ -00017060: 6566 6175 6c74 2065 6e74 7279 2e0a 2020 efault entry.. │ │ │ │ -00017070: 2020 2066 675f 636f 6c6f 7220 2020 2020 fg_color │ │ │ │ -00017080: 2020 5468 6520 666f 7265 6772 6f75 6e64 The foreground │ │ │ │ -00017090: 2063 6f6c 6f72 2066 6f72 2070 6c61 696e color for plain │ │ │ │ -000170a0: 2073 6f6c 6964 2063 6f6c 6f72 0a20 2020 solid color. │ │ │ │ -000170b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -000170c0: 2072 656e 6465 7269 6e67 2e0a 2020 2020 rendering.. │ │ │ │ -000170d0: 2062 675f 636f 6c6f 7220 2020 2020 2020 bg_color │ │ │ │ -000170e0: 5468 6520 6261 636b 6772 6f75 6e64 2063 The background c │ │ │ │ -000170f0: 6f6c 6f72 2066 6f72 2070 6c61 696e 2073 olor for plain s │ │ │ │ -00017100: 6f6c 6964 2063 6f6c 6f72 0a20 2020 2020 olid color. │ │ │ │ -00017110: 2020 2020 2020 2020 2020 2020 2020 2072 r │ │ │ │ -00017120: 656e 6465 7269 6e67 2e0a 2020 2020 2062 endering.. b │ │ │ │ -00017130: 6f72 6465 725f 636f 6c6f 7220 2020 5468 order_color Th │ │ │ │ -00017140: 6520 626f 7264 6572 2063 6f6c 6f72 2066 e border color f │ │ │ │ -00017150: 6f72 2070 6c61 696e 2073 6f6c 6964 2063 or plain solid c │ │ │ │ -00017160: 6f6c 6f72 0a20 2020 2020 2020 2020 2020 olor. │ │ │ │ -00017170: 2020 2020 2020 2020 2072 656e 6465 7269 renderi │ │ │ │ -00017180: 6e67 2e0a 2020 2020 2074 6578 745f 636f ng.. text_co │ │ │ │ -00017190: 6c6f 7220 2020 2020 5468 6520 7465 7874 lor The text │ │ │ │ -000171a0: 2063 6f6c 6f72 2e0a 2020 2020 2062 6172 color.. bar │ │ │ │ -000171b0: 5f73 7479 6c65 2020 2020 2020 5468 6520 _style The │ │ │ │ -000171c0: 7374 796c 6564 2062 6f78 2073 7065 6369 styled box speci │ │ │ │ -000171d0: 6669 6361 7469 6f6e 2066 6f72 2074 6865 fication for the │ │ │ │ -000171e0: 2066 7261 6d65 206f 660a 2020 2020 2020 frame of. │ │ │ │ -000171f0: 2020 2020 2020 2020 2020 2020 2020 7468 th │ │ │ │ -00017200: 6520 7072 6f67 7265 7373 2062 6172 2e20 e progress bar. │ │ │ │ -00017210: 2045 7861 6d70 6c65 3a0a 2020 2020 2020 Example:. │ │ │ │ -00017220: 2020 2020 2020 2020 2020 2020 2020 2270 "p │ │ │ │ -00017230: 726f 6772 6573 735f 6672 616d 655f 2a2e rogress_frame_*. │ │ │ │ -00017240: 706e 6722 2049 6620 7468 6520 7661 6c75 png" If the valu │ │ │ │ -00017250: 6520 6973 2065 7175 616c 2074 6f0a 2020 e is equal to. │ │ │ │ -00017260: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00017270: 2020 2268 6967 686c 6967 6874 5f73 7479 "highlight_sty │ │ │ │ -00017280: 6c65 2220 7468 656e 206e 6f20 7374 796c le" then no styl │ │ │ │ -00017290: 6564 2062 6f78 6573 2077 696c 6c20 6265 ed boxes will be │ │ │ │ -000172a0: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ -000172b0: 2020 2020 2073 686f 776e 2e0a 2020 2020 shown.. │ │ │ │ -000172c0: 2068 6967 686c 6967 6874 5f73 7479 6c65 highlight_style │ │ │ │ -000172d0: 5468 6520 7374 796c 6564 2062 6f78 2073 The styled box s │ │ │ │ -000172e0: 7065 6369 6669 6361 7469 6f6e 2066 6f72 pecification for │ │ │ │ -000172f0: 2074 6865 2068 6967 686c 6967 6874 6564 the highlighted │ │ │ │ -00017300: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ -00017310: 2020 2020 2072 6567 696f 6e20 6f66 2074 region of t │ │ │ │ -00017320: 6865 2070 726f 6772 6573 7320 6261 722e he progress bar. │ │ │ │ -00017330: 2020 5468 6973 2062 6f78 2077 696c 6c20 This box will │ │ │ │ -00017340: 6265 0a20 2020 2020 2020 2020 2020 2020 be. │ │ │ │ -00017350: 2020 2020 2020 2075 7365 6420 746f 2070 used to p │ │ │ │ -00017360: 6169 6e74 206a 7573 7420 7468 6520 6869 aint just the hi │ │ │ │ -00017370: 6768 6c69 6768 7465 6420 7265 6769 6f6e ghlighted region │ │ │ │ -00017380: 206f 6620 7468 650a 2020 2020 2020 2020 of the. │ │ │ │ -00017390: 2020 2020 2020 2020 2020 2020 6261 722c bar, │ │ │ │ -000173a0: 2061 6e64 2077 696c 6c20 6265 2069 6e63 and will be inc │ │ │ │ -000173b0: 7265 6173 6564 2069 6e20 7369 7a65 2061 reased in size a │ │ │ │ -000173c0: 7320 7468 6520 6261 720a 2020 2020 2020 s the bar. │ │ │ │ -000173d0: 2020 2020 2020 2020 2020 2020 2020 6e65 ne │ │ │ │ -000173e0: 6172 7320 636f 6d70 6c65 7469 6f6e 2e20 ars completion. │ │ │ │ -000173f0: 2045 7861 6d70 6c65 3a20 2270 726f 6772 Example: "progr │ │ │ │ -00017400: 6573 735f 686c 5f2a 2e70 6e67 222e 0a20 ess_hl_*.png".. │ │ │ │ -00017410: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00017420: 2020 2049 6620 7468 6520 7661 6c75 6520 If the value │ │ │ │ -00017430: 6973 2065 7175 616c 2074 6f20 2262 6172 is equal to "bar │ │ │ │ -00017440: 5f73 7479 6c65 2220 7468 656e 206e 6f0a _style" then no. │ │ │ │ -00017450: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00017460: 2020 2020 7374 796c 6564 2062 6f78 6573 styled boxes │ │ │ │ -00017470: 2077 696c 6c20 6265 2073 686f 776e 2e0a will be shown.. │ │ │ │ -00017480: 2020 2020 2068 6967 686c 6967 6874 5f6f highlight_o │ │ │ │ -00017490: 7665 726c 6179 4966 2074 6869 7320 6f70 verlayIf this op │ │ │ │ -000174a0: 7469 6f6e 2069 7320 7365 7420 746f 2022 tion is set to " │ │ │ │ -000174b0: 7472 7565 2220 7468 656e 2074 6865 0a20 true" then the. │ │ │ │ -000174c0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -000174d0: 2020 2068 6967 686c 6967 6874 2062 6f78 highlight box │ │ │ │ -000174e0: 2073 6964 6520 736c 6963 6573 2028 6576 side slices (ev │ │ │ │ -000174f0: 6572 7920 736c 6963 6520 6578 6365 7074 ery slice except │ │ │ │ -00017500: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ -00017510: 2020 2020 2074 6865 2063 656e 7465 7220 the center │ │ │ │ -00017520: 736c 6963 6529 2077 696c 6c20 6f76 6572 slice) will over │ │ │ │ -00017530: 6c61 7920 7468 6520 6672 616d 6520 626f lay the frame bo │ │ │ │ -00017540: 780a 2020 2020 2020 2020 2020 2020 2020 x. │ │ │ │ -00017550: 2020 2020 2020 7369 6465 2073 6c69 6365 side slice │ │ │ │ -00017560: 732e 2020 416e 6420 7468 6520 6365 6e74 s. And the cent │ │ │ │ -00017570: 6572 2073 6c69 6365 206f 6620 7468 650a er slice of the. │ │ │ │ -00017580: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00017590: 2020 2020 6869 6768 6c69 6768 7420 626f highlight bo │ │ │ │ -000175a0: 7820 6361 6e20 6d6f 7665 2061 6c6c 2074 x can move all t │ │ │ │ -000175b0: 6865 2077 6179 2028 6672 6f6d 2074 6f70 he way (from top │ │ │ │ -000175c0: 2074 6f0a 2020 2020 2020 2020 2020 2020 to. │ │ │ │ -000175d0: 2020 2020 2020 2020 626f 7474 6f6d 292c bottom), │ │ │ │ -000175e0: 2062 6569 6e67 2064 7261 776e 206f 6e20 being drawn on │ │ │ │ -000175f0: 7468 6520 6365 6e74 6572 2073 6c69 6365 the center slice │ │ │ │ -00017600: 206f 6620 7468 650a 2020 2020 2020 2020 of the. │ │ │ │ -00017610: 2020 2020 2020 2020 2020 2020 6672 616d fram │ │ │ │ -00017620: 6520 626f 782e 2020 5468 6174 2077 6179 e box. That way │ │ │ │ -00017630: 2077 6520 6361 6e20 6d61 6b65 2061 2070 we can make a p │ │ │ │ -00017640: 726f 6772 6573 7320 6261 720a 2020 2020 rogress bar. │ │ │ │ +000165f0: 2020 2020 2020 2074 6572 6d69 6e61 6c20 terminal │ │ │ │ +00016600: 7769 6e64 6f77 2e0a 7465 726d 696e 616c window..terminal │ │ │ │ +00016610: 2d6c 6566 7420 2020 2020 2020 2020 2053 -left S │ │ │ │ +00016620: 7065 6369 6669 6573 2074 6865 206c 6566 pecifies the lef │ │ │ │ +00016630: 7420 636f 6f72 6469 6e61 7465 206f 6620 t coordinate of │ │ │ │ +00016640: 7468 650a 2020 2020 2020 2020 2020 2020 the. │ │ │ │ +00016650: 2020 2020 2020 2020 2020 2074 6572 6d69 termi │ │ │ │ +00016660: 6e61 6c20 7769 6e64 6f77 2e0a 7465 726d nal window..term │ │ │ │ +00016670: 696e 616c 2d74 6f70 2020 2020 2020 2020 inal-top │ │ │ │ +00016680: 2020 2053 7065 6369 6669 6573 2074 6865 Specifies the │ │ │ │ +00016690: 2074 6f70 2063 6f6f 7264 696e 6174 6520 top coordinate │ │ │ │ +000166a0: 6f66 2074 6865 0a20 2020 2020 2020 2020 of the. │ │ │ │ +000166b0: 2020 2020 2020 2020 2020 2020 2020 7465 te │ │ │ │ +000166c0: 726d 696e 616c 2077 696e 646f 772e 0a74 rminal window..t │ │ │ │ +000166d0: 6572 6d69 6e61 6c2d 7769 6474 6820 2020 erminal-width │ │ │ │ +000166e0: 2020 2020 2020 5370 6563 6966 6965 7320 Specifies │ │ │ │ +000166f0: 7468 6520 7769 6474 6820 6f66 2074 6865 the width of the │ │ │ │ +00016700: 2074 6572 6d69 6e61 6c0a 2020 2020 2020 terminal. │ │ │ │ +00016710: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00016720: 2077 696e 646f 772e 0a74 6572 6d69 6e61 window..termina │ │ │ │ +00016730: 6c2d 6865 6967 6874 2020 2020 2020 2020 l-height │ │ │ │ +00016740: 5370 6563 6966 6965 7320 7468 6520 6865 Specifies the he │ │ │ │ +00016750: 6967 6874 206f 6620 7468 6520 7465 726d ight of the term │ │ │ │ +00016760: 696e 616c 0a20 2020 2020 2020 2020 2020 inal. │ │ │ │ +00016770: 2020 2020 2020 2020 2020 2020 7769 6e64 wind │ │ │ │ +00016780: 6f77 2e0a 0a37 2e33 2e34 2043 6f6d 706f ow...7.3.4 Compo │ │ │ │ +00016790: 6e65 6e74 2043 6f6e 7374 7275 6374 696f nent Constructio │ │ │ │ +000167a0: 6e0a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d n.-------------- │ │ │ │ +000167b0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a --------------.. │ │ │ │ +000167c0: 4772 6561 7465 7220 6375 7374 6f6d 697a Greater customiz │ │ │ │ +000167d0: 6162 696c 6974 7920 636f 6d65 7320 6973 ability comes is │ │ │ │ +000167e0: 2070 726f 7669 6465 6420 6279 2063 6f6d provided by com │ │ │ │ +000167f0: 706f 6e65 6e74 732e 2020 4120 7472 6565 ponents. A tree │ │ │ │ +00016800: 206f 660a 636f 6d70 6f6e 656e 7473 2066 of.components f │ │ │ │ +00016810: 6f72 6d73 2074 6865 2075 7365 7220 696e orms the user in │ │ │ │ +00016820: 7465 7266 6163 652e 2020 2a43 6f6e 7461 terface. *Conta │ │ │ │ +00016830: 696e 6572 732a 2061 7265 2063 6f6d 706f iners* are compo │ │ │ │ +00016840: 6e65 6e74 7320 7468 6174 0a63 616e 2063 nents that.can c │ │ │ │ +00016850: 6f6e 7461 696e 206f 7468 6572 2063 6f6d ontain other com │ │ │ │ +00016860: 706f 6e65 6e74 732c 2061 6e64 2074 6865 ponents, and the │ │ │ │ +00016870: 7265 2069 7320 616c 7761 7973 2061 2073 re is always a s │ │ │ │ +00016880: 696e 676c 6520 726f 6f74 0a63 6f6d 706f ingle root.compo │ │ │ │ +00016890: 6e65 6e74 2077 6869 6368 2069 7320 616e nent which is an │ │ │ │ +000168a0: 2069 6e73 7461 6e63 6520 6f66 2061 202a instance of a * │ │ │ │ +000168b0: 6361 6e76 6173 2a20 636f 6e74 6169 6e65 canvas* containe │ │ │ │ +000168c0: 722e 0a0a 2020 2043 6f6d 706f 6e65 6e74 r... Component │ │ │ │ +000168d0: 7320 6172 6520 6372 6561 7465 6420 696e s are created in │ │ │ │ +000168e0: 2074 6865 2074 6865 6d65 2066 696c 6520 the theme file │ │ │ │ +000168f0: 6279 2070 7265 6669 7869 6e67 2074 6865 by prefixing the │ │ │ │ +00016900: 2074 7970 6520 6f66 0a63 6f6d 706f 6e65 type of.compone │ │ │ │ +00016910: 6e74 2077 6974 6820 6120 272b 2720 7369 nt with a '+' si │ │ │ │ +00016920: 676e 3a0a 0a20 2020 2720 2b20 6c61 6265 gn:.. ' + labe │ │ │ │ +00016930: 6c20 7b20 7465 7874 3d22 4752 5542 2220 l { text="GRUB" │ │ │ │ +00016940: 666f 6e74 3d22 6171 7569 2031 3122 2063 font="aqui 11" c │ │ │ │ +00016950: 6f6c 6f72 3d22 2338 4646 2220 7d20 270a olor="#8FF" } '. │ │ │ │ +00016960: 0a20 2020 7072 6f70 6572 7469 6573 206f . properties o │ │ │ │ +00016970: 6620 6120 636f 6d70 6f6e 656e 7420 6172 f a component ar │ │ │ │ +00016980: 6520 7370 6563 6966 6965 6420 6173 2022 e specified as " │ │ │ │ +00016990: 6e61 6d65 203d 2076 616c 7565 2220 2877 name = value" (w │ │ │ │ +000169a0: 6869 7465 7370 6163 650a 7375 7272 6f75 hitespace.surrou │ │ │ │ +000169b0: 6e64 696e 6720 746f 6b65 6e73 2069 7320 nding tokens is │ │ │ │ +000169c0: 6f70 7469 6f6e 616c 2061 6e64 2069 7320 optional and is │ │ │ │ +000169d0: 6967 6e6f 7265 6429 2077 6865 7265 202a ignored) where * │ │ │ │ +000169e0: 7661 6c75 652a 206d 6179 2062 653a 0a20 value* may be:. │ │ │ │ +000169f0: 2020 2a20 6120 7369 6e67 6c65 2077 6f72 * a single wor │ │ │ │ +00016a00: 6420 2865 2e67 2e2c 2022 616c 6967 6e20 d (e.g., "align │ │ │ │ +00016a10: 3d20 6365 6e74 6572 222c 2022 636f 6c6f = center", "colo │ │ │ │ +00016a20: 7220 3d20 2346 4638 3038 3022 292c 0a20 r = #FF8080"),. │ │ │ │ +00016a30: 2020 2a20 6120 7175 6f74 6564 2073 7472 * a quoted str │ │ │ │ +00016a40: 696e 6720 2865 2e67 2e2c 2022 7465 7874 ing (e.g., "text │ │ │ │ +00016a50: 203d 2022 4865 6c6c 6f2c 2057 6f72 6c64 = "Hello, World │ │ │ │ +00016a60: 2122 2229 2c20 6f72 0a20 2020 2a20 6120 !""), or. * a │ │ │ │ +00016a70: 7475 706c 6520 2865 2e67 2e2c 2022 7072 tuple (e.g., "pr │ │ │ │ +00016a80: 6566 6572 7265 645f 7369 7a65 203d 2028 eferred_size = ( │ │ │ │ +00016a90: 3132 302c 2038 3029 2229 2e0a 0a37 2e33 120, 80)")...7.3 │ │ │ │ +00016aa0: 2e35 2043 6f6d 706f 6e65 6e74 204c 6973 .5 Component Lis │ │ │ │ +00016ab0: 740a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d t.-------------- │ │ │ │ +00016ac0: 2d2d 2d2d 2d2d 0a0a 5468 6520 666f 6c6c ------..The foll │ │ │ │ +00016ad0: 6f77 696e 6720 6973 2061 206c 6973 7420 owing is a list │ │ │ │ +00016ae0: 6f66 2074 6865 2063 6f6d 706f 6e65 6e74 of the component │ │ │ │ +00016af0: 7320 616e 6420 7468 6520 7072 6f70 6572 s and the proper │ │ │ │ +00016b00: 7469 6573 2074 6865 790a 7375 7070 6f72 ties they.suppor │ │ │ │ +00016b10: 742e 0a0a 2020 202a 206c 6162 656c 2041 t... * label A │ │ │ │ +00016b20: 206c 6162 656c 2064 6973 706c 6179 7320 label displays │ │ │ │ +00016b30: 6120 6c69 6e65 206f 6620 7465 7874 2e0a a line of text.. │ │ │ │ +00016b40: 0a20 2020 2020 5072 6f70 6572 7469 6573 . Properties │ │ │ │ +00016b50: 3a0a 2020 2020 2069 6420 2020 2020 2020 :. id │ │ │ │ +00016b60: 2020 2020 2020 5365 7420 746f 2022 5f5f Set to "__ │ │ │ │ +00016b70: 7469 6d65 6f75 745f 5f22 2074 6f20 6469 timeout__" to di │ │ │ │ +00016b80: 7370 6c61 7920 7468 6520 7469 6d65 2065 splay the time e │ │ │ │ +00016b90: 6c61 7073 6564 0a20 2020 2020 2020 2020 lapsed. │ │ │ │ +00016ba0: 2020 2020 2020 2020 2020 2074 6f20 616e to an │ │ │ │ +00016bb0: 2061 7574 6f6d 6174 6963 616c 2062 6f6f automatical boo │ │ │ │ +00016bc0: 7420 6f66 2074 6865 2064 6566 6175 6c74 t of the default │ │ │ │ +00016bd0: 2065 6e74 7279 2e0a 2020 2020 2074 6578 entry.. tex │ │ │ │ +00016be0: 7420 2020 2020 2020 2020 2020 5468 6520 t The │ │ │ │ +00016bf0: 7465 7874 2074 6f20 6469 7370 6c61 792e text to display. │ │ │ │ +00016c00: 2020 4966 2022 6964 2220 6973 2073 6574 If "id" is set │ │ │ │ +00016c10: 2074 6f0a 2020 2020 2020 2020 2020 2020 to. │ │ │ │ +00016c20: 2020 2020 2020 2020 225f 5f74 696d 656f "__timeo │ │ │ │ +00016c30: 7574 5f5f 2220 616e 6420 6e6f 2022 7465 ut__" and no "te │ │ │ │ +00016c40: 7874 2220 7072 6f70 6572 7479 2069 7320 xt" property is │ │ │ │ +00016c50: 7365 7420 7468 656e 0a20 2020 2020 2020 set then. │ │ │ │ +00016c60: 2020 2020 2020 2020 2020 2020 2074 6865 the │ │ │ │ +00016c70: 2061 6d6f 756e 7420 6f66 2073 6563 6f6e amount of secon │ │ │ │ +00016c80: 6473 2077 696c 6c20 6265 2073 686f 776e ds will be shown │ │ │ │ +00016c90: 2e20 2049 6620 7365 7420 746f 0a20 2020 . If set to. │ │ │ │ +00016ca0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00016cb0: 2022 404b 4559 4d41 505f 5348 4f52 5440 "@KEYMAP_SHORT@ │ │ │ │ +00016cc0: 222c 2022 404b 4559 4d41 505f 4d49 4444 ", "@KEYMAP_MIDD │ │ │ │ +00016cd0: 4c45 4022 206f 720a 2020 2020 2020 2020 LE@" or. │ │ │ │ +00016ce0: 2020 2020 2020 2020 2020 2020 2240 4b45 "@KE │ │ │ │ +00016cf0: 594d 4150 5f4c 4f4e 4740 2220 7468 656e YMAP_LONG@" then │ │ │ │ +00016d00: 2070 7265 6465 6669 6e65 6420 686f 746b predefined hotk │ │ │ │ +00016d10: 6579 0a20 2020 2020 2020 2020 2020 2020 ey. │ │ │ │ +00016d20: 2020 2020 2020 2069 6e66 6f72 6d61 7469 informati │ │ │ │ +00016d30: 6f6e 2077 696c 6c20 6265 2073 686f 776e on will be shown │ │ │ │ +00016d40: 2e0a 2020 2020 2066 6f6e 7420 2020 2020 .. font │ │ │ │ +00016d50: 2020 2020 2020 5468 6520 666f 6e74 2074 The font t │ │ │ │ +00016d60: 6f20 7573 6520 666f 7220 7465 7874 2064 o use for text d │ │ │ │ +00016d70: 6973 706c 6179 2e0a 2020 2020 2063 6f6c isplay.. col │ │ │ │ +00016d80: 6f72 2020 2020 2020 2020 2020 5468 6520 or The │ │ │ │ +00016d90: 636f 6c6f 7220 6f66 2074 6865 2074 6578 color of the tex │ │ │ │ +00016da0: 742e 0a20 2020 2020 616c 6967 6e20 2020 t.. align │ │ │ │ +00016db0: 2020 2020 2020 2054 6865 2068 6f72 697a The horiz │ │ │ │ +00016dc0: 6f6e 7461 6c20 616c 6967 6e6d 656e 7420 ontal alignment │ │ │ │ +00016dd0: 6f66 2074 6865 2074 6578 7420 7769 7468 of the text with │ │ │ │ +00016de0: 696e 2074 6865 0a20 2020 2020 2020 2020 in the. │ │ │ │ +00016df0: 2020 2020 2020 2020 2020 2063 6f6d 706f compo │ │ │ │ +00016e00: 6e65 6e74 2e20 204f 7074 696f 6e73 2061 nent. Options a │ │ │ │ +00016e10: 7265 2022 6c65 6674 222c 2022 6365 6e74 re "left", "cent │ │ │ │ +00016e20: 6572 2220 616e 640a 2020 2020 2020 2020 er" and. │ │ │ │ +00016e30: 2020 2020 2020 2020 2020 2020 2272 6967 "rig │ │ │ │ +00016e40: 6874 222e 0a20 2020 2020 7669 7369 626c ht".. visibl │ │ │ │ +00016e50: 6520 2020 2020 2020 2053 6574 2074 6f20 e Set to │ │ │ │ +00016e60: 2266 616c 7365 2220 746f 2068 6964 6520 "false" to hide │ │ │ │ +00016e70: 7468 6520 6c61 6265 6c2e 0a0a 2020 202a the label... * │ │ │ │ +00016e80: 2069 6d61 6765 2041 2063 6f6d 706f 6e65 image A compone │ │ │ │ +00016e90: 6e74 2074 6861 7420 6469 7370 6c61 7973 nt that displays │ │ │ │ +00016ea0: 2061 6e20 696d 6167 652e 2020 5468 6520 an image. The │ │ │ │ +00016eb0: 696d 6167 6520 6973 2073 6361 6c65 6420 image is scaled │ │ │ │ +00016ec0: 746f 0a20 2020 2020 6669 7420 7468 6520 to. fit the │ │ │ │ +00016ed0: 636f 6d70 6f6e 656e 742e 0a0a 2020 2020 component... │ │ │ │ +00016ee0: 2050 726f 7065 7274 6965 733a 0a0a 2020 Properties:.. │ │ │ │ +00016ef0: 2020 2066 696c 6520 2020 2020 2020 2020 file │ │ │ │ +00016f00: 2020 5468 6520 6675 6c6c 2070 6174 6820 The full path │ │ │ │ +00016f10: 746f 2074 6865 2069 6d61 6765 2066 696c to the image fil │ │ │ │ +00016f20: 6520 746f 206c 6f61 642e 0a0a 2020 202a e to load... * │ │ │ │ +00016f30: 2070 726f 6772 6573 735f 6261 7220 4469 progress_bar Di │ │ │ │ +00016f40: 7370 6c61 7973 2061 2068 6f72 697a 6f6e splays a horizon │ │ │ │ +00016f50: 7461 6c6c 7920 6f72 6965 6e74 6564 2070 tally oriented p │ │ │ │ +00016f60: 726f 6772 6573 7320 6261 722e 2020 4974 rogress bar. It │ │ │ │ +00016f70: 2063 616e 0a20 2020 2020 6265 2072 656e can. be ren │ │ │ │ +00016f80: 6465 7265 6420 7573 696e 6720 7369 6d70 dered using simp │ │ │ │ +00016f90: 6c65 2073 6f6c 6964 2066 696c 6c65 6420 le solid filled │ │ │ │ +00016fa0: 7265 6374 616e 676c 6573 2c20 6f72 2075 rectangles, or u │ │ │ │ +00016fb0: 7369 6e67 2061 2070 6169 720a 2020 2020 sing a pair. │ │ │ │ +00016fc0: 206f 6620 7069 786d 6170 2073 7479 6c65 of pixmap style │ │ │ │ +00016fd0: 6420 626f 7865 732e 0a0a 2020 2020 2050 d boxes... P │ │ │ │ +00016fe0: 726f 7065 7274 6965 733a 0a0a 2020 2020 roperties:.. │ │ │ │ +00016ff0: 2069 6420 2020 2020 2020 2020 2020 2020 id │ │ │ │ +00017000: 5365 7420 746f 2022 5f5f 7469 6d65 6f75 Set to "__timeou │ │ │ │ +00017010: 745f 5f22 2074 6f20 6469 7370 6c61 7920 t__" to display │ │ │ │ +00017020: 7468 6520 7469 6d65 2065 6c61 7073 6564 the time elapsed │ │ │ │ +00017030: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ +00017040: 2020 2020 2074 6f20 616e 2061 7574 6f6d to an autom │ │ │ │ +00017050: 6174 6963 616c 2062 6f6f 7420 6f66 2074 atical boot of t │ │ │ │ +00017060: 6865 2064 6566 6175 6c74 2065 6e74 7279 he default entry │ │ │ │ +00017070: 2e0a 2020 2020 2066 675f 636f 6c6f 7220 .. fg_color │ │ │ │ +00017080: 2020 2020 2020 5468 6520 666f 7265 6772 The foregr │ │ │ │ +00017090: 6f75 6e64 2063 6f6c 6f72 2066 6f72 2070 ound color for p │ │ │ │ +000170a0: 6c61 696e 2073 6f6c 6964 2063 6f6c 6f72 lain solid color │ │ │ │ +000170b0: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ +000170c0: 2020 2020 2072 656e 6465 7269 6e67 2e0a rendering.. │ │ │ │ +000170d0: 2020 2020 2062 675f 636f 6c6f 7220 2020 bg_color │ │ │ │ +000170e0: 2020 2020 5468 6520 6261 636b 6772 6f75 The backgrou │ │ │ │ +000170f0: 6e64 2063 6f6c 6f72 2066 6f72 2070 6c61 nd color for pla │ │ │ │ +00017100: 696e 2073 6f6c 6964 2063 6f6c 6f72 0a20 in solid color. │ │ │ │ +00017110: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00017120: 2020 2072 656e 6465 7269 6e67 2e0a 2020 rendering.. │ │ │ │ +00017130: 2020 2062 6f72 6465 725f 636f 6c6f 7220 border_color │ │ │ │ +00017140: 2020 5468 6520 626f 7264 6572 2063 6f6c The border col │ │ │ │ +00017150: 6f72 2066 6f72 2070 6c61 696e 2073 6f6c or for plain sol │ │ │ │ +00017160: 6964 2063 6f6c 6f72 0a20 2020 2020 2020 id color. │ │ │ │ +00017170: 2020 2020 2020 2020 2020 2020 2072 656e ren │ │ │ │ +00017180: 6465 7269 6e67 2e0a 2020 2020 2074 6578 dering.. tex │ │ │ │ +00017190: 745f 636f 6c6f 7220 2020 2020 5468 6520 t_color The │ │ │ │ +000171a0: 7465 7874 2063 6f6c 6f72 2e0a 2020 2020 text color.. │ │ │ │ +000171b0: 2062 6172 5f73 7479 6c65 2020 2020 2020 bar_style │ │ │ │ +000171c0: 5468 6520 7374 796c 6564 2062 6f78 2073 The styled box s │ │ │ │ +000171d0: 7065 6369 6669 6361 7469 6f6e 2066 6f72 pecification for │ │ │ │ +000171e0: 2074 6865 2066 7261 6d65 206f 660a 2020 the frame of. │ │ │ │ +000171f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00017200: 2020 7468 6520 7072 6f67 7265 7373 2062 the progress b │ │ │ │ +00017210: 6172 2e20 2045 7861 6d70 6c65 3a0a 2020 ar. Example:. │ │ │ │ +00017220: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00017230: 2020 2270 726f 6772 6573 735f 6672 616d "progress_fram │ │ │ │ +00017240: 655f 2a2e 706e 6722 2049 6620 7468 6520 e_*.png" If the │ │ │ │ +00017250: 7661 6c75 6520 6973 2065 7175 616c 2074 value is equal t │ │ │ │ +00017260: 6f0a 2020 2020 2020 2020 2020 2020 2020 o. │ │ │ │ +00017270: 2020 2020 2020 2268 6967 686c 6967 6874 "highlight │ │ │ │ +00017280: 5f73 7479 6c65 2220 7468 656e 206e 6f20 _style" then no │ │ │ │ +00017290: 7374 796c 6564 2062 6f78 6573 2077 696c styled boxes wil │ │ │ │ +000172a0: 6c20 6265 0a20 2020 2020 2020 2020 2020 l be. │ │ │ │ +000172b0: 2020 2020 2020 2020 2073 686f 776e 2e0a shown.. │ │ │ │ +000172c0: 2020 2020 2068 6967 686c 6967 6874 5f73 highlight_s │ │ │ │ +000172d0: 7479 6c65 5468 6520 7374 796c 6564 2062 tyleThe styled b │ │ │ │ +000172e0: 6f78 2073 7065 6369 6669 6361 7469 6f6e ox specification │ │ │ │ +000172f0: 2066 6f72 2074 6865 2068 6967 686c 6967 for the highlig │ │ │ │ +00017300: 6874 6564 0a20 2020 2020 2020 2020 2020 hted. │ │ │ │ +00017310: 2020 2020 2020 2020 2072 6567 696f 6e20 region │ │ │ │ +00017320: 6f66 2074 6865 2070 726f 6772 6573 7320 of the progress │ │ │ │ +00017330: 6261 722e 2020 5468 6973 2062 6f78 2077 bar. This box w │ │ │ │ +00017340: 696c 6c20 6265 0a20 2020 2020 2020 2020 ill be. │ │ │ │ +00017350: 2020 2020 2020 2020 2020 2075 7365 6420 used │ │ │ │ +00017360: 746f 2070 6169 6e74 206a 7573 7420 7468 to paint just th │ │ │ │ +00017370: 6520 6869 6768 6c69 6768 7465 6420 7265 e highlighted re │ │ │ │ +00017380: 6769 6f6e 206f 6620 7468 650a 2020 2020 gion of the. │ │ │ │ +00017390: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +000173a0: 6261 722c 2061 6e64 2077 696c 6c20 6265 bar, and will be │ │ │ │ +000173b0: 2069 6e63 7265 6173 6564 2069 6e20 7369 increased in si │ │ │ │ +000173c0: 7a65 2061 7320 7468 6520 6261 720a 2020 ze as the bar. │ │ │ │ +000173d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +000173e0: 2020 6e65 6172 7320 636f 6d70 6c65 7469 nears completi │ │ │ │ +000173f0: 6f6e 2e20 2045 7861 6d70 6c65 3a20 2270 on. Example: "p │ │ │ │ +00017400: 726f 6772 6573 735f 686c 5f2a 2e70 6e67 rogress_hl_*.png │ │ │ │ +00017410: 222e 0a20 2020 2020 2020 2020 2020 2020 ".. │ │ │ │ +00017420: 2020 2020 2020 2049 6620 7468 6520 7661 If the va │ │ │ │ +00017430: 6c75 6520 6973 2065 7175 616c 2074 6f20 lue is equal to │ │ │ │ +00017440: 2262 6172 5f73 7479 6c65 2220 7468 656e "bar_style" then │ │ │ │ +00017450: 206e 6f0a 2020 2020 2020 2020 2020 2020 no. │ │ │ │ +00017460: 2020 2020 2020 2020 7374 796c 6564 2062 styled b │ │ │ │ +00017470: 6f78 6573 2077 696c 6c20 6265 2073 686f oxes will be sho │ │ │ │ +00017480: 776e 2e0a 2020 2020 2068 6967 686c 6967 wn.. highlig │ │ │ │ +00017490: 6874 5f6f 7665 726c 6179 4966 2074 6869 ht_overlayIf thi │ │ │ │ +000174a0: 7320 6f70 7469 6f6e 2069 7320 7365 7420 s option is set │ │ │ │ +000174b0: 746f 2022 7472 7565 2220 7468 656e 2074 to "true" then t │ │ │ │ +000174c0: 6865 0a20 2020 2020 2020 2020 2020 2020 he. │ │ │ │ +000174d0: 2020 2020 2020 2068 6967 686c 6967 6874 highlight │ │ │ │ +000174e0: 2062 6f78 2073 6964 6520 736c 6963 6573 box side slices │ │ │ │ +000174f0: 2028 6576 6572 7920 736c 6963 6520 6578 (every slice ex │ │ │ │ +00017500: 6365 7074 0a20 2020 2020 2020 2020 2020 cept. │ │ │ │ +00017510: 2020 2020 2020 2020 2074 6865 2063 656e the cen │ │ │ │ +00017520: 7465 7220 736c 6963 6529 2077 696c 6c20 ter slice) will │ │ │ │ +00017530: 6f76 6572 6c61 7920 7468 6520 6672 616d overlay the fram │ │ │ │ +00017540: 6520 626f 780a 2020 2020 2020 2020 2020 e box. │ │ │ │ +00017550: 2020 2020 2020 2020 2020 7369 6465 2073 side s │ │ │ │ +00017560: 6c69 6365 732e 2020 416e 6420 7468 6520 lices. And the │ │ │ │ +00017570: 6365 6e74 6572 2073 6c69 6365 206f 6620 center slice of │ │ │ │ +00017580: 7468 650a 2020 2020 2020 2020 2020 2020 the. │ │ │ │ +00017590: 2020 2020 2020 2020 6869 6768 6c69 6768 highligh │ │ │ │ +000175a0: 7420 626f 7820 6361 6e20 6d6f 7665 2061 t box can move a │ │ │ │ +000175b0: 6c6c 2074 6865 2077 6179 2028 6672 6f6d ll the way (from │ │ │ │ +000175c0: 2074 6f70 2074 6f0a 2020 2020 2020 2020 top to. │ │ │ │ +000175d0: 2020 2020 2020 2020 2020 2020 626f 7474 bott │ │ │ │ +000175e0: 6f6d 292c 2062 6569 6e67 2064 7261 776e om), being drawn │ │ │ │ +000175f0: 206f 6e20 7468 6520 6365 6e74 6572 2073 on the center s │ │ │ │ +00017600: 6c69 6365 206f 6620 7468 650a 2020 2020 lice of the. │ │ │ │ +00017610: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00017620: 6672 616d 6520 626f 782e 2020 5468 6174 frame box. That │ │ │ │ +00017630: 2077 6179 2077 6520 6361 6e20 6d61 6b65 way we can make │ │ │ │ +00017640: 2061 2070 726f 6772 6573 7320 6261 720a a progress bar. │ │ │ │ 00017650: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00017660: 7769 7468 2072 6f75 6e64 2d73 6861 7065 with round-shape │ │ │ │ -00017670: 6420 6564 6765 7320 736f 2074 6865 7265 d edges so there │ │ │ │ -00017680: 2077 6f6e 2774 2062 6520 6120 6672 6565 won't be a free │ │ │ │ -00017690: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ -000176a0: 2020 2020 2073 7061 6365 2066 726f 6d20 space from │ │ │ │ -000176b0: 7468 6520 6869 6768 6c69 6768 7420 746f the highlight to │ │ │ │ -000176c0: 2074 6865 2066 7261 6d65 2069 6e20 746f the frame in to │ │ │ │ -000176d0: 7020 616e 640a 2020 2020 2020 2020 2020 p and. │ │ │ │ -000176e0: 2020 2020 2020 2020 2020 626f 7474 6f6d bottom │ │ │ │ -000176f0: 2073 6372 6f6c 6c62 6172 2070 6f73 6974 scrollbar posit │ │ │ │ -00017700: 696f 6e73 2e20 2044 6566 6175 6c74 2069 ions. Default i │ │ │ │ -00017710: 7320 2266 616c 7365 222e 0a20 2020 2020 s "false".. │ │ │ │ -00017720: 666f 6e74 2020 2020 2020 2020 2020 2054 font T │ │ │ │ -00017730: 6865 2066 6f6e 7420 746f 2075 7365 2066 he font to use f │ │ │ │ -00017740: 6f72 2070 726f 6772 6573 7320 6261 722e or progress bar. │ │ │ │ -00017750: 0a20 2020 2020 7465 7874 2020 2020 2020 . text │ │ │ │ -00017760: 2020 2020 2054 6865 2074 6578 7420 746f The text to │ │ │ │ -00017770: 2064 6973 706c 6179 206f 6e20 7468 6520 display on the │ │ │ │ -00017780: 7072 6f67 7265 7373 2062 6172 2e20 2049 progress bar. I │ │ │ │ -00017790: 6620 7468 650a 2020 2020 2020 2020 2020 f the. │ │ │ │ -000177a0: 2020 2020 2020 2020 2020 7072 6f67 7265 progre │ │ │ │ -000177b0: 7373 2062 6172 2773 2049 4420 6973 2073 ss bar's ID is s │ │ │ │ -000177c0: 6574 2074 6f20 225f 5f74 696d 656f 7574 et to "__timeout │ │ │ │ -000177d0: 5f5f 2220 616e 640a 2020 2020 2020 2020 __" and. │ │ │ │ -000177e0: 2020 2020 2020 2020 2020 2020 7468 6520 the │ │ │ │ -000177f0: 7661 6c75 6520 6f66 2074 6869 7320 7072 value of this pr │ │ │ │ -00017800: 6f70 6572 7479 2069 7320 7365 7420 746f operty is set to │ │ │ │ -00017810: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ -00017820: 2020 2020 2022 4054 494d 454f 5554 5f4e "@TIMEOUT_N │ │ │ │ -00017830: 4f54 4946 4943 4154 494f 4e5f 5348 4f52 OTIFICATION_SHOR │ │ │ │ -00017840: 5440 222c 0a20 2020 2020 2020 2020 2020 T@",. │ │ │ │ -00017850: 2020 2020 2020 2020 2022 4054 494d 454f "@TIMEO │ │ │ │ -00017860: 5554 5f4e 4f54 4946 4943 4154 494f 4e5f UT_NOTIFICATION_ │ │ │ │ -00017870: 4d49 4444 4c45 4022 206f 720a 2020 2020 MIDDLE@" or. │ │ │ │ +00017660: 2020 2020 7769 7468 2072 6f75 6e64 2d73 with round-s │ │ │ │ +00017670: 6861 7065 6420 6564 6765 7320 736f 2074 haped edges so t │ │ │ │ +00017680: 6865 7265 2077 6f6e 2774 2062 6520 6120 here won't be a │ │ │ │ +00017690: 6672 6565 0a20 2020 2020 2020 2020 2020 free. │ │ │ │ +000176a0: 2020 2020 2020 2020 2073 7061 6365 2066 space f │ │ │ │ +000176b0: 726f 6d20 7468 6520 6869 6768 6c69 6768 rom the highligh │ │ │ │ +000176c0: 7420 746f 2074 6865 2066 7261 6d65 2069 t to the frame i │ │ │ │ +000176d0: 6e20 746f 7020 616e 640a 2020 2020 2020 n top and. │ │ │ │ +000176e0: 2020 2020 2020 2020 2020 2020 2020 626f bo │ │ │ │ +000176f0: 7474 6f6d 2073 6372 6f6c 6c62 6172 2070 ttom scrollbar p │ │ │ │ +00017700: 6f73 6974 696f 6e73 2e20 2044 6566 6175 ositions. Defau │ │ │ │ +00017710: 6c74 2069 7320 2266 616c 7365 222e 0a20 lt is "false".. │ │ │ │ +00017720: 2020 2020 666f 6e74 2020 2020 2020 2020 font │ │ │ │ +00017730: 2020 2054 6865 2066 6f6e 7420 746f 2075 The font to u │ │ │ │ +00017740: 7365 2066 6f72 2070 726f 6772 6573 7320 se for progress │ │ │ │ +00017750: 6261 722e 0a20 2020 2020 7465 7874 2020 bar.. text │ │ │ │ +00017760: 2020 2020 2020 2020 2054 6865 2074 6578 The tex │ │ │ │ +00017770: 7420 746f 2064 6973 706c 6179 206f 6e20 t to display on │ │ │ │ +00017780: 7468 6520 7072 6f67 7265 7373 2062 6172 the progress bar │ │ │ │ +00017790: 2e20 2049 6620 7468 650a 2020 2020 2020 . If the. │ │ │ │ +000177a0: 2020 2020 2020 2020 2020 2020 2020 7072 pr │ │ │ │ +000177b0: 6f67 7265 7373 2062 6172 2773 2049 4420 ogress bar's ID │ │ │ │ +000177c0: 6973 2073 6574 2074 6f20 225f 5f74 696d is set to "__tim │ │ │ │ +000177d0: 656f 7574 5f5f 2220 616e 640a 2020 2020 eout__" and. │ │ │ │ +000177e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +000177f0: 7468 6520 7661 6c75 6520 6f66 2074 6869 the value of thi │ │ │ │ +00017800: 7320 7072 6f70 6572 7479 2069 7320 7365 s property is se │ │ │ │ +00017810: 7420 746f 0a20 2020 2020 2020 2020 2020 t to. │ │ │ │ +00017820: 2020 2020 2020 2020 2022 4054 494d 454f "@TIMEO │ │ │ │ +00017830: 5554 5f4e 4f54 4946 4943 4154 494f 4e5f UT_NOTIFICATION_ │ │ │ │ +00017840: 5348 4f52 5440 222c 0a20 2020 2020 2020 SHORT@",. │ │ │ │ +00017850: 2020 2020 2020 2020 2020 2020 2022 4054 "@T │ │ │ │ +00017860: 494d 454f 5554 5f4e 4f54 4946 4943 4154 IMEOUT_NOTIFICAT │ │ │ │ +00017870: 494f 4e5f 4d49 4444 4c45 4022 206f 720a ION_MIDDLE@" or. │ │ │ │ 00017880: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00017890: 2240 5449 4d45 4f55 545f 4e4f 5449 4649 "@TIMEOUT_NOTIFI │ │ │ │ -000178a0: 4341 5449 4f4e 5f4c 4f4e 4740 222c 2074 CATION_LONG@", t │ │ │ │ -000178b0: 6865 6e20 4752 5542 2077 696c 6c0a 2020 hen GRUB will. │ │ │ │ -000178c0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -000178d0: 2020 7570 6461 7465 2074 6869 7320 7072 update this pr │ │ │ │ -000178e0: 6f70 6572 7479 2077 6974 6820 616e 2069 operty with an i │ │ │ │ -000178f0: 6e66 6f72 6d61 7469 7665 206d 6573 7361 nformative messa │ │ │ │ -00017900: 6765 0a20 2020 2020 2020 2020 2020 2020 ge. │ │ │ │ -00017910: 2020 2020 2020 2061 7320 7468 6520 7469 as the ti │ │ │ │ -00017920: 6d65 6f75 7420 6170 7072 6f61 6368 6573 meout approaches │ │ │ │ -00017930: 2e0a 0a20 2020 2a20 6369 7263 756c 6172 ... * circular │ │ │ │ -00017940: 5f70 726f 6772 6573 7320 4469 7370 6c61 _progress Displa │ │ │ │ -00017950: 7973 2061 2063 6972 6375 6c61 7220 7072 ys a circular pr │ │ │ │ -00017960: 6f67 7265 7373 2069 6e64 6963 6174 6f72 ogress indicator │ │ │ │ -00017970: 2e20 2054 6865 0a20 2020 2020 6170 7065 . The. appe │ │ │ │ -00017980: 6172 616e 6365 206f 6620 7468 6973 2063 arance of this c │ │ │ │ -00017990: 6f6d 706f 6e65 6e74 2069 7320 6465 7465 omponent is dete │ │ │ │ -000179a0: 726d 696e 6564 2062 7920 7477 6f20 696d rmined by two im │ │ │ │ -000179b0: 6167 6573 3a20 7468 650a 2020 2020 202a ages: the. * │ │ │ │ -000179c0: 6365 6e74 6572 2a20 696d 6167 6520 616e center* image an │ │ │ │ -000179d0: 6420 7468 6520 2a74 6963 6b2a 2069 6d61 d the *tick* ima │ │ │ │ -000179e0: 6765 2e20 2054 6865 2063 656e 7465 7220 ge. The center │ │ │ │ -000179f0: 696d 6167 6520 6973 2067 656e 6572 616c image is general │ │ │ │ -00017a00: 6c79 0a20 2020 2020 6c61 7267 6572 2061 ly. larger a │ │ │ │ -00017a10: 6e64 2077 696c 6c20 6265 2064 7261 776e nd will be drawn │ │ │ │ -00017a20: 2069 6e20 7468 6520 6365 6e74 6572 206f in the center o │ │ │ │ -00017a30: 6620 7468 6520 636f 6d70 6f6e 656e 742e f the component. │ │ │ │ -00017a40: 2020 4172 6f75 6e64 0a20 2020 2020 7468 Around. th │ │ │ │ -00017a50: 6520 6369 7263 756d 6665 7265 6e63 6520 e circumference │ │ │ │ -00017a60: 6f66 2061 2063 6972 636c 6520 7769 7468 of a circle with │ │ │ │ -00017a70: 696e 2074 6865 2063 6f6d 706f 6e65 6e74 in the component │ │ │ │ -00017a80: 2c20 7468 6520 7469 636b 2069 6d61 6765 , the tick image │ │ │ │ -00017a90: 0a20 2020 2020 7769 6c6c 2062 6520 6472 . will be dr │ │ │ │ -00017aa0: 6177 6e20 6120 6365 7274 6169 6e20 6e75 awn a certain nu │ │ │ │ -00017ab0: 6d62 6572 206f 6620 7469 6d65 732c 2064 mber of times, d │ │ │ │ -00017ac0: 6570 656e 6469 6e67 206f 6e20 7468 650a epending on the. │ │ │ │ -00017ad0: 2020 2020 2070 726f 7065 7274 6965 7320 properties │ │ │ │ -00017ae0: 6f66 2074 6865 2063 6f6d 706f 6e65 6e74 of the component │ │ │ │ -00017af0: 2e0a 0a20 2020 2020 5072 6f70 6572 7469 ... Properti │ │ │ │ -00017b00: 6573 3a0a 0a20 2020 2020 6964 2020 2020 es:.. id │ │ │ │ +00017890: 2020 2020 2240 5449 4d45 4f55 545f 4e4f "@TIMEOUT_NO │ │ │ │ +000178a0: 5449 4649 4341 5449 4f4e 5f4c 4f4e 4740 TIFICATION_LONG@ │ │ │ │ +000178b0: 222c 2074 6865 6e20 4752 5542 2077 696c ", then GRUB wil │ │ │ │ +000178c0: 6c0a 2020 2020 2020 2020 2020 2020 2020 l. │ │ │ │ +000178d0: 2020 2020 2020 7570 6461 7465 2074 6869 update thi │ │ │ │ +000178e0: 7320 7072 6f70 6572 7479 2077 6974 6820 s property with │ │ │ │ +000178f0: 616e 2069 6e66 6f72 6d61 7469 7665 206d an informative m │ │ │ │ +00017900: 6573 7361 6765 0a20 2020 2020 2020 2020 essage. │ │ │ │ +00017910: 2020 2020 2020 2020 2020 2061 7320 7468 as th │ │ │ │ +00017920: 6520 7469 6d65 6f75 7420 6170 7072 6f61 e timeout approa │ │ │ │ +00017930: 6368 6573 2e0a 0a20 2020 2a20 6369 7263 ches... * circ │ │ │ │ +00017940: 756c 6172 5f70 726f 6772 6573 7320 4469 ular_progress Di │ │ │ │ +00017950: 7370 6c61 7973 2061 2063 6972 6375 6c61 splays a circula │ │ │ │ +00017960: 7220 7072 6f67 7265 7373 2069 6e64 6963 r progress indic │ │ │ │ +00017970: 6174 6f72 2e20 2054 6865 0a20 2020 2020 ator. The. │ │ │ │ +00017980: 6170 7065 6172 616e 6365 206f 6620 7468 appearance of th │ │ │ │ +00017990: 6973 2063 6f6d 706f 6e65 6e74 2069 7320 is component is │ │ │ │ +000179a0: 6465 7465 726d 696e 6564 2062 7920 7477 determined by tw │ │ │ │ +000179b0: 6f20 696d 6167 6573 3a20 7468 650a 2020 o images: the. │ │ │ │ +000179c0: 2020 202a 6365 6e74 6572 2a20 696d 6167 *center* imag │ │ │ │ +000179d0: 6520 616e 6420 7468 6520 2a74 6963 6b2a e and the *tick* │ │ │ │ +000179e0: 2069 6d61 6765 2e20 2054 6865 2063 656e image. The cen │ │ │ │ +000179f0: 7465 7220 696d 6167 6520 6973 2067 656e ter image is gen │ │ │ │ +00017a00: 6572 616c 6c79 0a20 2020 2020 6c61 7267 erally. larg │ │ │ │ +00017a10: 6572 2061 6e64 2077 696c 6c20 6265 2064 er and will be d │ │ │ │ +00017a20: 7261 776e 2069 6e20 7468 6520 6365 6e74 rawn in the cent │ │ │ │ +00017a30: 6572 206f 6620 7468 6520 636f 6d70 6f6e er of the compon │ │ │ │ +00017a40: 656e 742e 2020 4172 6f75 6e64 0a20 2020 ent. Around. │ │ │ │ +00017a50: 2020 7468 6520 6369 7263 756d 6665 7265 the circumfere │ │ │ │ +00017a60: 6e63 6520 6f66 2061 2063 6972 636c 6520 nce of a circle │ │ │ │ +00017a70: 7769 7468 696e 2074 6865 2063 6f6d 706f within the compo │ │ │ │ +00017a80: 6e65 6e74 2c20 7468 6520 7469 636b 2069 nent, the tick i │ │ │ │ +00017a90: 6d61 6765 0a20 2020 2020 7769 6c6c 2062 mage. will b │ │ │ │ +00017aa0: 6520 6472 6177 6e20 6120 6365 7274 6169 e drawn a certai │ │ │ │ +00017ab0: 6e20 6e75 6d62 6572 206f 6620 7469 6d65 n number of time │ │ │ │ +00017ac0: 732c 2064 6570 656e 6469 6e67 206f 6e20 s, depending on │ │ │ │ +00017ad0: 7468 650a 2020 2020 2070 726f 7065 7274 the. propert │ │ │ │ +00017ae0: 6965 7320 6f66 2074 6865 2063 6f6d 706f ies of the compo │ │ │ │ +00017af0: 6e65 6e74 2e0a 0a20 2020 2020 5072 6f70 nent... Prop │ │ │ │ +00017b00: 6572 7469 6573 3a0a 0a20 2020 2020 6964 erties:.. id │ │ │ │ 00017b10: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00017b20: 2053 6574 2074 6f20 225f 5f74 696d 656f Set to "__timeo │ │ │ │ -00017b30: 7574 5f5f 2220 746f 2064 6973 706c 6179 ut__" to display │ │ │ │ -00017b40: 2074 6865 2074 696d 650a 2020 2020 2020 the time. │ │ │ │ +00017b20: 2020 2020 2053 6574 2074 6f20 225f 5f74 Set to "__t │ │ │ │ +00017b30: 696d 656f 7574 5f5f 2220 746f 2064 6973 imeout__" to dis │ │ │ │ +00017b40: 706c 6179 2074 6865 2074 696d 650a 2020 play the time. │ │ │ │ 00017b50: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00017b60: 2020 2020 2020 656c 6170 7365 6420 746f elapsed to │ │ │ │ -00017b70: 2061 6e20 6175 746f 6d61 7469 6361 6c20 an automatical │ │ │ │ -00017b80: 626f 6f74 206f 6620 7468 650a 2020 2020 boot of the. │ │ │ │ +00017b60: 2020 2020 2020 2020 2020 656c 6170 7365 elapse │ │ │ │ +00017b70: 6420 746f 2061 6e20 6175 746f 6d61 7469 d to an automati │ │ │ │ +00017b80: 6361 6c20 626f 6f74 206f 6620 7468 650a cal boot of the. │ │ │ │ 00017b90: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00017ba0: 2020 2020 2020 2020 6465 6661 756c 7420 default │ │ │ │ -00017bb0: 656e 7472 792e 0a20 2020 2020 6365 6e74 entry.. cent │ │ │ │ -00017bc0: 6572 5f62 6974 6d61 7020 2020 2020 2020 er_bitmap │ │ │ │ -00017bd0: 2020 2054 6865 2066 696c 6520 6e61 6d65 The file name │ │ │ │ -00017be0: 206f 6620 7468 6520 696d 6167 6520 746f of the image to │ │ │ │ -00017bf0: 2064 7261 7720 696e 2074 6865 0a20 2020 draw in the. │ │ │ │ -00017c00: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00017c10: 2020 2020 2020 2020 2063 656e 7465 7220 center │ │ │ │ -00017c20: 6f66 2074 6865 2063 6f6d 706f 6e65 6e74 of the component │ │ │ │ -00017c30: 2e0a 2020 2020 2074 6963 6b5f 6269 746d .. tick_bitm │ │ │ │ -00017c40: 6170 2020 2020 2020 2020 2020 2020 5468 ap Th │ │ │ │ -00017c50: 6520 6669 6c65 206e 616d 6520 6f66 2074 e file name of t │ │ │ │ -00017c60: 6865 2069 6d61 6765 2074 6f20 6472 6177 he image to draw │ │ │ │ -00017c70: 2066 6f72 0a20 2020 2020 2020 2020 2020 for. │ │ │ │ +00017ba0: 2020 2020 2020 2020 2020 2020 6465 6661 defa │ │ │ │ +00017bb0: 756c 7420 656e 7472 792e 0a20 2020 2020 ult entry.. │ │ │ │ +00017bc0: 6365 6e74 6572 5f62 6974 6d61 7020 2020 center_bitmap │ │ │ │ +00017bd0: 2020 2020 2020 2054 6865 2066 696c 6520 The file │ │ │ │ +00017be0: 6e61 6d65 206f 6620 7468 6520 696d 6167 name of the imag │ │ │ │ +00017bf0: 6520 746f 2064 7261 7720 696e 2074 6865 e to draw in the │ │ │ │ +00017c00: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ +00017c10: 2020 2020 2020 2020 2020 2020 2063 656e cen │ │ │ │ +00017c20: 7465 7220 6f66 2074 6865 2063 6f6d 706f ter of the compo │ │ │ │ +00017c30: 6e65 6e74 2e0a 2020 2020 2074 6963 6b5f nent.. tick_ │ │ │ │ +00017c40: 6269 746d 6170 2020 2020 2020 2020 2020 bitmap │ │ │ │ +00017c50: 2020 5468 6520 6669 6c65 206e 616d 6520 The file name │ │ │ │ +00017c60: 6f66 2074 6865 2069 6d61 6765 2074 6f20 of the image to │ │ │ │ +00017c70: 6472 6177 2066 6f72 0a20 2020 2020 2020 draw for. │ │ │ │ 00017c80: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00017c90: 2074 6865 2074 6963 6b20 6d61 726b 732e the tick marks. │ │ │ │ -00017ca0: 0a20 2020 2020 6e75 6d5f 7469 636b 7320 . num_ticks │ │ │ │ -00017cb0: 2020 2020 2020 2020 2020 2020 2054 6865 The │ │ │ │ -00017cc0: 206e 756d 6265 7220 6f66 2074 6963 6b73 number of ticks │ │ │ │ -00017cd0: 2074 6861 7420 6d61 6b65 2075 7020 6120 that make up a │ │ │ │ -00017ce0: 6675 6c6c 0a20 2020 2020 2020 2020 2020 full. │ │ │ │ +00017c90: 2020 2020 2074 6865 2074 6963 6b20 6d61 the tick ma │ │ │ │ +00017ca0: 726b 732e 0a20 2020 2020 6e75 6d5f 7469 rks.. num_ti │ │ │ │ +00017cb0: 636b 7320 2020 2020 2020 2020 2020 2020 cks │ │ │ │ +00017cc0: 2054 6865 206e 756d 6265 7220 6f66 2074 The number of t │ │ │ │ +00017cd0: 6963 6b73 2074 6861 7420 6d61 6b65 2075 icks that make u │ │ │ │ +00017ce0: 7020 6120 6675 6c6c 0a20 2020 2020 2020 p a full. │ │ │ │ 00017cf0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00017d00: 2063 6972 636c 652e 0a20 2020 2020 7469 circle.. ti │ │ │ │ -00017d10: 636b 735f 6469 7361 7070 6561 7220 2020 cks_disappear │ │ │ │ -00017d20: 2020 2020 2042 6f6f 6c65 616e 2076 616c Boolean val │ │ │ │ -00017d30: 7565 2069 6e64 6963 6174 696e 6720 7768 ue indicating wh │ │ │ │ -00017d40: 6574 6865 7220 7469 636b 0a20 2020 2020 ether tick. │ │ │ │ +00017d00: 2020 2020 2063 6972 636c 652e 0a20 2020 circle.. │ │ │ │ +00017d10: 2020 7469 636b 735f 6469 7361 7070 6561 ticks_disappea │ │ │ │ +00017d20: 7220 2020 2020 2020 2042 6f6f 6c65 616e r Boolean │ │ │ │ +00017d30: 2076 616c 7565 2069 6e64 6963 6174 696e value indicatin │ │ │ │ +00017d40: 6720 7768 6574 6865 7220 7469 636b 0a20 g whether tick. │ │ │ │ 00017d50: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00017d60: 2020 2020 2020 206d 6172 6b73 2073 686f marks sho │ │ │ │ -00017d70: 756c 6420 7072 6f67 7265 7373 6976 656c uld progressivel │ │ │ │ -00017d80: 7920 6170 7065 6172 2c20 6f72 0a20 2020 y appear, or. │ │ │ │ -00017d90: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00017da0: 2020 2020 2020 2020 2070 726f 6772 6573 progres │ │ │ │ -00017db0: 7369 7665 6c79 2064 6973 6170 7065 6172 sively disappear │ │ │ │ -00017dc0: 2061 7320 2a76 616c 7565 2a0a 2020 2020 as *value*. │ │ │ │ +00017d60: 2020 2020 2020 2020 2020 206d 6172 6b73 marks │ │ │ │ +00017d70: 2073 686f 756c 6420 7072 6f67 7265 7373 should progress │ │ │ │ +00017d80: 6976 656c 7920 6170 7065 6172 2c20 6f72 ively appear, or │ │ │ │ +00017d90: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ +00017da0: 2020 2020 2020 2020 2020 2020 2070 726f pro │ │ │ │ +00017db0: 6772 6573 7369 7665 6c79 2064 6973 6170 gressively disap │ │ │ │ +00017dc0: 7065 6172 2061 7320 2a76 616c 7565 2a0a pear as *value*. │ │ │ │ 00017dd0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00017de0: 2020 2020 2020 2020 6170 7072 6f61 6368 approach │ │ │ │ -00017df0: 6573 202a 656e 642a 2e20 2053 7065 6369 es *end*. Speci │ │ │ │ -00017e00: 6679 2022 7472 7565 2220 6f72 0a20 2020 fy "true" or. │ │ │ │ -00017e10: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00017e20: 2020 2020 2020 2020 2022 6661 6c73 6522 "false" │ │ │ │ -00017e30: 2e20 2044 6566 6175 6c74 2069 7320 2266 . Default is "f │ │ │ │ -00017e40: 616c 7365 222e 0a20 2020 2020 7374 6172 alse".. star │ │ │ │ -00017e50: 745f 616e 676c 6520 2020 2020 2020 2020 t_angle │ │ │ │ -00017e60: 2020 2054 6865 2070 6f73 6974 696f 6e20 The position │ │ │ │ -00017e70: 6f66 2074 6865 2066 6972 7374 2074 6963 of the first tic │ │ │ │ -00017e80: 6b20 6d61 726b 2074 6f0a 2020 2020 2020 k mark to. │ │ │ │ +00017de0: 2020 2020 2020 2020 2020 2020 6170 7072 appr │ │ │ │ +00017df0: 6f61 6368 6573 202a 656e 642a 2e20 2053 oaches *end*. S │ │ │ │ +00017e00: 7065 6369 6679 2022 7472 7565 2220 6f72 pecify "true" or │ │ │ │ +00017e10: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ +00017e20: 2020 2020 2020 2020 2020 2020 2022 6661 "fa │ │ │ │ +00017e30: 6c73 6522 2e20 2044 6566 6175 6c74 2069 lse". Default i │ │ │ │ +00017e40: 7320 2266 616c 7365 222e 0a20 2020 2020 s "false".. │ │ │ │ +00017e50: 7374 6172 745f 616e 676c 6520 2020 2020 start_angle │ │ │ │ +00017e60: 2020 2020 2020 2054 6865 2070 6f73 6974 The posit │ │ │ │ +00017e70: 696f 6e20 6f66 2074 6865 2066 6972 7374 ion of the first │ │ │ │ +00017e80: 2074 6963 6b20 6d61 726b 2074 6f0a 2020 tick mark to. │ │ │ │ 00017e90: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00017ea0: 2020 2020 2020 6170 7065 6172 206f 7220 appear or │ │ │ │ -00017eb0: 6469 7361 7070 6561 722e 2020 4d65 6173 disappear. Meas │ │ │ │ -00017ec0: 7572 6564 2069 6e0a 2020 2020 2020 2020 ured in. │ │ │ │ +00017ea0: 2020 2020 2020 2020 2020 6170 7065 6172 appear │ │ │ │ +00017eb0: 206f 7220 6469 7361 7070 6561 722e 2020 or disappear. │ │ │ │ +00017ec0: 4d65 6173 7572 6564 2069 6e0a 2020 2020 Measured in. │ │ │ │ 00017ed0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00017ee0: 2020 2020 2270 6172 726f 7473 222c 2031 "parrots", 1 │ │ │ │ -00017ef0: 2022 7061 7272 6f74 2220 3d20 3120 2f20 "parrot" = 1 / │ │ │ │ -00017f00: 3235 3620 6f66 2074 6865 0a20 2020 2020 256 of the. │ │ │ │ +00017ee0: 2020 2020 2020 2020 2270 6172 726f 7473 "parrots │ │ │ │ +00017ef0: 222c 2031 2022 7061 7272 6f74 2220 3d20 ", 1 "parrot" = │ │ │ │ +00017f00: 3120 2f20 3235 3620 6f66 2074 6865 0a20 1 / 256 of the. │ │ │ │ 00017f10: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00017f20: 2020 2020 2020 2066 756c 6c20 6369 7263 full circ │ │ │ │ -00017f30: 6c65 2e20 2055 7365 2076 616c 7565 7320 le. Use values │ │ │ │ -00017f40: 2278 7878 2064 6567 2220 6f72 0a20 2020 "xxx deg" or. │ │ │ │ -00017f50: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00017f60: 2020 2020 2020 2020 2022 7878 7820 5c78 "xxx \x │ │ │ │ -00017f70: 6332 5c78 6230 2220 746f 2073 6574 2074 c2\xb0" to set t │ │ │ │ -00017f80: 6865 2061 6e67 6c65 2069 6e0a 2020 2020 he angle in. │ │ │ │ +00017f20: 2020 2020 2020 2020 2020 2066 756c 6c20 full │ │ │ │ +00017f30: 6369 7263 6c65 2e20 2055 7365 2076 616c circle. Use val │ │ │ │ +00017f40: 7565 7320 2278 7878 2064 6567 2220 6f72 ues "xxx deg" or │ │ │ │ +00017f50: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ +00017f60: 2020 2020 2020 2020 2020 2020 2022 7878 "xx │ │ │ │ +00017f70: 7820 5c78 6332 5c78 6230 2220 746f 2073 x \xc2\xb0" to s │ │ │ │ +00017f80: 6574 2074 6865 2061 6e67 6c65 2069 6e0a et the angle in. │ │ │ │ 00017f90: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00017fa0: 2020 2020 2020 2020 6465 6772 6565 732e degrees. │ │ │ │ -00017fb0: 0a0a 2020 202a 2062 6f6f 745f 6d65 6e75 .. * boot_menu │ │ │ │ -00017fc0: 2044 6973 706c 6179 7320 7468 6520 4752 Displays the GR │ │ │ │ -00017fd0: 5542 2062 6f6f 7420 6d65 6e75 2e20 2049 UB boot menu. I │ │ │ │ -00017fe0: 7420 616c 6c6f 7773 2073 656c 6563 7469 t allows selecti │ │ │ │ -00017ff0: 6e67 2069 7465 6d73 0a20 2020 2020 616e ng items. an │ │ │ │ -00018000: 6420 6578 6563 7574 696e 6720 7468 656d d executing them │ │ │ │ -00018010: 2e0a 0a20 2020 2020 5072 6f70 6572 7469 ... Properti │ │ │ │ -00018020: 6573 3a0a 0a20 2020 2020 6974 656d 5f66 es:.. item_f │ │ │ │ -00018030: 6f6e 7420 2020 2020 2020 2020 2020 2020 ont │ │ │ │ -00018040: 2020 2020 2020 2020 5468 6520 666f 6e74 The font │ │ │ │ -00018050: 2074 6f20 7573 6520 666f 7220 7468 6520 to use for the │ │ │ │ -00018060: 6d65 6e75 2069 7465 6d0a 2020 2020 2020 menu item. │ │ │ │ +00017fa0: 2020 2020 2020 2020 2020 2020 6465 6772 degr │ │ │ │ +00017fb0: 6565 732e 0a0a 2020 202a 2062 6f6f 745f ees... * boot_ │ │ │ │ +00017fc0: 6d65 6e75 2044 6973 706c 6179 7320 7468 menu Displays th │ │ │ │ +00017fd0: 6520 4752 5542 2062 6f6f 7420 6d65 6e75 e GRUB boot menu │ │ │ │ +00017fe0: 2e20 2049 7420 616c 6c6f 7773 2073 656c . It allows sel │ │ │ │ +00017ff0: 6563 7469 6e67 2069 7465 6d73 0a20 2020 ecting items. │ │ │ │ +00018000: 2020 616e 6420 6578 6563 7574 696e 6720 and executing │ │ │ │ +00018010: 7468 656d 2e0a 0a20 2020 2020 5072 6f70 them... Prop │ │ │ │ +00018020: 6572 7469 6573 3a0a 0a20 2020 2020 6974 erties:.. it │ │ │ │ +00018030: 656d 5f66 6f6e 7420 2020 2020 2020 2020 em_font │ │ │ │ +00018040: 2020 2020 2020 2020 2020 2020 5468 6520 The │ │ │ │ +00018050: 666f 6e74 2074 6f20 7573 6520 666f 7220 font to use for │ │ │ │ +00018060: 7468 6520 6d65 6e75 2069 7465 6d0a 2020 the menu item. │ │ │ │ 00018070: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00018080: 2020 2020 2020 2020 2020 2020 2074 6974 tit │ │ │ │ -00018090: 6c65 732e 0a20 2020 2020 7365 6c65 6374 les.. select │ │ │ │ -000180a0: 6564 5f69 7465 6d5f 666f 6e74 2020 2020 ed_item_font │ │ │ │ -000180b0: 2020 2020 2020 2020 5468 6520 666f 6e74 The font │ │ │ │ -000180c0: 2074 6f20 7573 6520 666f 7220 7468 6520 to use for the │ │ │ │ -000180d0: 7365 6c65 6374 6564 0a20 2020 2020 2020 selected. │ │ │ │ +00018080: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00018090: 2074 6974 6c65 732e 0a20 2020 2020 7365 titles.. se │ │ │ │ +000180a0: 6c65 6374 6564 5f69 7465 6d5f 666f 6e74 lected_item_font │ │ │ │ +000180b0: 2020 2020 2020 2020 2020 2020 5468 6520 The │ │ │ │ +000180c0: 666f 6e74 2074 6f20 7573 6520 666f 7220 font to use for │ │ │ │ +000180d0: 7468 6520 7365 6c65 6374 6564 0a20 2020 the selected. │ │ │ │ 000180e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -000180f0: 2020 2020 2020 2020 2020 2020 6d65 6e75 menu │ │ │ │ -00018100: 2069 7465 6d2c 206f 7220 2269 6e68 6572 item, or "inher │ │ │ │ -00018110: 6974 2220 2874 6865 0a20 2020 2020 2020 it" (the. │ │ │ │ +000180f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00018100: 6d65 6e75 2069 7465 6d2c 206f 7220 2269 menu item, or "i │ │ │ │ +00018110: 6e68 6572 6974 2220 2874 6865 0a20 2020 nherit" (the. │ │ │ │ 00018120: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00018130: 2020 2020 2020 2020 2020 2020 6465 6661 defa │ │ │ │ -00018140: 756c 7429 2074 6f20 7573 6520 2269 7465 ult) to use "ite │ │ │ │ -00018150: 6d5f 666f 6e74 2220 666f 720a 2020 2020 m_font" for. │ │ │ │ +00018130: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00018140: 6465 6661 756c 7429 2074 6f20 7573 6520 default) to use │ │ │ │ +00018150: 2269 7465 6d5f 666f 6e74 2220 666f 720a "item_font" for. │ │ │ │ 00018160: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00018170: 2020 2020 2020 2020 2020 2020 2020 2074 t │ │ │ │ -00018180: 6865 2073 656c 6563 7465 6420 6d65 6e75 he selected menu │ │ │ │ -00018190: 2069 7465 6d20 6173 2077 656c 6c2e 0a20 item as well.. │ │ │ │ -000181a0: 2020 2020 6974 656d 5f63 6f6c 6f72 2020 item_color │ │ │ │ -000181b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -000181c0: 2020 5468 6520 636f 6c6f 7220 746f 2075 The color to u │ │ │ │ -000181d0: 7365 2066 6f72 2074 6865 206d 656e 7520 se for the menu │ │ │ │ -000181e0: 6974 656d 0a20 2020 2020 2020 2020 2020 item. │ │ │ │ +00018170: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00018180: 2020 2074 6865 2073 656c 6563 7465 6420 the selected │ │ │ │ +00018190: 6d65 6e75 2069 7465 6d20 6173 2077 656c menu item as wel │ │ │ │ +000181a0: 6c2e 0a20 2020 2020 6974 656d 5f63 6f6c l.. item_col │ │ │ │ +000181b0: 6f72 2020 2020 2020 2020 2020 2020 2020 or │ │ │ │ +000181c0: 2020 2020 2020 5468 6520 636f 6c6f 7220 The color │ │ │ │ +000181d0: 746f 2075 7365 2066 6f72 2074 6865 206d to use for the m │ │ │ │ +000181e0: 656e 7520 6974 656d 0a20 2020 2020 2020 enu item. │ │ │ │ 000181f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00018200: 2020 2020 2020 2020 7469 746c 6573 2e0a titles.. │ │ │ │ -00018210: 2020 2020 2073 656c 6563 7465 645f 6974 selected_it │ │ │ │ -00018220: 656d 5f63 6f6c 6f72 2020 2020 2020 2020 em_color │ │ │ │ -00018230: 2020 2054 6865 2063 6f6c 6f72 2074 6f20 The color to │ │ │ │ -00018240: 7573 6520 666f 7220 7468 6520 7365 6c65 use for the sele │ │ │ │ -00018250: 6374 6564 0a20 2020 2020 2020 2020 2020 cted. │ │ │ │ +00018200: 2020 2020 2020 2020 2020 2020 7469 746c titl │ │ │ │ +00018210: 6573 2e0a 2020 2020 2073 656c 6563 7465 es.. selecte │ │ │ │ +00018220: 645f 6974 656d 5f63 6f6c 6f72 2020 2020 d_item_color │ │ │ │ +00018230: 2020 2020 2020 2054 6865 2063 6f6c 6f72 The color │ │ │ │ +00018240: 2074 6f20 7573 6520 666f 7220 7468 6520 to use for the │ │ │ │ +00018250: 7365 6c65 6374 6564 0a20 2020 2020 2020 selected. │ │ │ │ 00018260: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00018270: 2020 2020 2020 2020 6d65 6e75 2069 7465 menu ite │ │ │ │ -00018280: 6d2c 206f 7220 2269 6e68 6572 6974 2220 m, or "inherit" │ │ │ │ -00018290: 2874 6865 0a20 2020 2020 2020 2020 2020 (the. │ │ │ │ +00018270: 2020 2020 2020 2020 2020 2020 6d65 6e75 menu │ │ │ │ +00018280: 2069 7465 6d2c 206f 7220 2269 6e68 6572 item, or "inher │ │ │ │ +00018290: 6974 2220 2874 6865 0a20 2020 2020 2020 it" (the. │ │ │ │ 000182a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -000182b0: 2020 2020 2020 2020 6465 6661 756c 7429 default) │ │ │ │ -000182c0: 2074 6f20 7573 6520 2269 7465 6d5f 636f to use "item_co │ │ │ │ -000182d0: 6c6f 7222 2066 6f72 0a20 2020 2020 2020 lor" for. │ │ │ │ +000182b0: 2020 2020 2020 2020 2020 2020 6465 6661 defa │ │ │ │ +000182c0: 756c 7429 2074 6f20 7573 6520 2269 7465 ult) to use "ite │ │ │ │ +000182d0: 6d5f 636f 6c6f 7222 2066 6f72 0a20 2020 m_color" for. │ │ │ │ 000182e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -000182f0: 2020 2020 2020 2020 2020 2020 7468 6520 the │ │ │ │ -00018300: 7365 6c65 6374 6564 206d 656e 7520 6974 selected menu it │ │ │ │ -00018310: 656d 2061 7320 7765 6c6c 2e0a 2020 2020 em as well.. │ │ │ │ -00018320: 2069 636f 6e5f 7769 6474 6820 2020 2020 icon_width │ │ │ │ -00018330: 2020 2020 2020 2020 2020 2020 2020 2054 T │ │ │ │ -00018340: 6865 2077 6964 7468 206f 6620 6d65 6e75 he width of menu │ │ │ │ -00018350: 2069 7465 6d20 6963 6f6e 732e 0a20 2020 item icons.. │ │ │ │ -00018360: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +000182f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00018300: 7468 6520 7365 6c65 6374 6564 206d 656e the selected men │ │ │ │ +00018310: 7520 6974 656d 2061 7320 7765 6c6c 2e0a u item as well.. │ │ │ │ +00018320: 2020 2020 2069 636f 6e5f 7769 6474 6820 icon_width │ │ │ │ +00018330: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00018340: 2020 2054 6865 2077 6964 7468 206f 6620 The width of │ │ │ │ +00018350: 6d65 6e75 2069 7465 6d20 6963 6f6e 732e menu item icons. │ │ │ │ +00018360: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ 00018370: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00018380: 4963 6f6e 7320 6172 6520 7363 616c 6564 Icons are scaled │ │ │ │ -00018390: 2074 6f20 7468 6520 7370 6563 6966 6965 to the specifie │ │ │ │ -000183a0: 640a 2020 2020 2020 2020 2020 2020 2020 d. │ │ │ │ +00018380: 2020 2020 4963 6f6e 7320 6172 6520 7363 Icons are sc │ │ │ │ +00018390: 616c 6564 2074 6f20 7468 6520 7370 6563 aled to the spec │ │ │ │ +000183a0: 6966 6965 640a 2020 2020 2020 2020 2020 ified. │ │ │ │ 000183b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -000183c0: 2020 2020 2073 697a 652e 0a20 2020 2020 size.. │ │ │ │ -000183d0: 6963 6f6e 5f68 6569 6768 7420 2020 2020 icon_height │ │ │ │ -000183e0: 2020 2020 2020 2020 2020 2020 2020 5468 Th │ │ │ │ -000183f0: 6520 6865 6967 6874 206f 6620 6d65 6e75 e height of menu │ │ │ │ -00018400: 2069 7465 6d20 6963 6f6e 732e 0a20 2020 item icons.. │ │ │ │ -00018410: 2020 6974 656d 5f68 6569 6768 7420 2020 item_height │ │ │ │ -00018420: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00018430: 5468 6520 6865 6967 6874 206f 6620 6561 The height of ea │ │ │ │ -00018440: 6368 206d 656e 7520 6974 656d 2069 6e0a ch menu item in. │ │ │ │ -00018450: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +000183c0: 2020 2020 2020 2020 2073 697a 652e 0a20 size.. │ │ │ │ +000183d0: 2020 2020 6963 6f6e 5f68 6569 6768 7420 icon_height │ │ │ │ +000183e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +000183f0: 2020 5468 6520 6865 6967 6874 206f 6620 The height of │ │ │ │ +00018400: 6d65 6e75 2069 7465 6d20 6963 6f6e 732e menu item icons. │ │ │ │ +00018410: 0a20 2020 2020 6974 656d 5f68 6569 6768 . item_heigh │ │ │ │ +00018420: 7420 2020 2020 2020 2020 2020 2020 2020 t │ │ │ │ +00018430: 2020 2020 5468 6520 6865 6967 6874 206f The height o │ │ │ │ +00018440: 6620 6561 6368 206d 656e 7520 6974 656d f each menu item │ │ │ │ +00018450: 2069 6e0a 2020 2020 2020 2020 2020 2020 in. │ │ │ │ 00018460: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00018470: 2020 2070 6978 656c 732e 0a20 2020 2020 pixels.. │ │ │ │ -00018480: 6974 656d 5f70 6164 6469 6e67 2020 2020 item_padding │ │ │ │ -00018490: 2020 2020 2020 2020 2020 2020 2020 5468 Th │ │ │ │ -000184a0: 6520 616d 6f75 6e74 206f 6620 7370 6163 e amount of spac │ │ │ │ -000184b0: 6520 696e 2070 6978 656c 7320 746f 0a20 e in pixels to. │ │ │ │ -000184c0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00018470: 2020 2020 2020 2070 6978 656c 732e 0a20 pixels.. │ │ │ │ +00018480: 2020 2020 6974 656d 5f70 6164 6469 6e67 item_padding │ │ │ │ +00018490: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +000184a0: 2020 5468 6520 616d 6f75 6e74 206f 6620 The amount of │ │ │ │ +000184b0: 7370 6163 6520 696e 2070 6978 656c 7320 space in pixels │ │ │ │ +000184c0: 746f 0a20 2020 2020 2020 2020 2020 2020 to. │ │ │ │ 000184d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -000184e0: 2020 6c65 6176 6520 6f6e 2065 6163 6820 leave on each │ │ │ │ -000184f0: 7369 6465 206f 6620 7468 6520 6d65 6e75 side of the menu │ │ │ │ -00018500: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ +000184e0: 2020 2020 2020 6c65 6176 6520 6f6e 2065 leave on e │ │ │ │ +000184f0: 6163 6820 7369 6465 206f 6620 7468 6520 ach side of the │ │ │ │ +00018500: 6d65 6e75 0a20 2020 2020 2020 2020 2020 menu. │ │ │ │ 00018510: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00018520: 2020 2020 6974 656d 2063 6f6e 7465 6e74 item content │ │ │ │ -00018530: 732e 0a20 2020 2020 6974 656d 5f69 636f s.. item_ico │ │ │ │ -00018540: 6e5f 7370 6163 6520 2020 2020 2020 2020 n_space │ │ │ │ -00018550: 2020 2020 2020 5468 6520 7370 6163 6520 The space │ │ │ │ -00018560: 6265 7477 6565 6e20 616e 2069 7465 6d27 between an item' │ │ │ │ -00018570: 7320 6963 6f6e 0a20 2020 2020 2020 2020 s icon. │ │ │ │ +00018520: 2020 2020 2020 2020 6974 656d 2063 6f6e item con │ │ │ │ +00018530: 7465 6e74 732e 0a20 2020 2020 6974 656d tents.. item │ │ │ │ +00018540: 5f69 636f 6e5f 7370 6163 6520 2020 2020 _icon_space │ │ │ │ +00018550: 2020 2020 2020 2020 2020 5468 6520 7370 The sp │ │ │ │ +00018560: 6163 6520 6265 7477 6565 6e20 616e 2069 ace between an i │ │ │ │ +00018570: 7465 6d27 7320 6963 6f6e 0a20 2020 2020 tem's icon. │ │ │ │ 00018580: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00018590: 2020 2020 2020 2020 2020 616e 6420 7468 and th │ │ │ │ -000185a0: 6520 7469 746c 6520 7465 7874 2c20 696e e title text, in │ │ │ │ -000185b0: 2070 6978 656c 732e 0a20 2020 2020 6974 pixels.. it │ │ │ │ -000185c0: 656d 5f73 7061 6369 6e67 2020 2020 2020 em_spacing │ │ │ │ -000185d0: 2020 2020 2020 2020 2020 2020 5468 6520 The │ │ │ │ -000185e0: 616d 6f75 6e74 206f 6620 7370 6163 6520 amount of space │ │ │ │ -000185f0: 746f 206c 6561 7665 0a20 2020 2020 2020 to leave. │ │ │ │ +00018590: 2020 2020 2020 2020 2020 2020 2020 616e an │ │ │ │ +000185a0: 6420 7468 6520 7469 746c 6520 7465 7874 d the title text │ │ │ │ +000185b0: 2c20 696e 2070 6978 656c 732e 0a20 2020 , in pixels.. │ │ │ │ +000185c0: 2020 6974 656d 5f73 7061 6369 6e67 2020 item_spacing │ │ │ │ +000185d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +000185e0: 5468 6520 616d 6f75 6e74 206f 6620 7370 The amount of sp │ │ │ │ +000185f0: 6163 6520 746f 206c 6561 7665 0a20 2020 ace to leave. │ │ │ │ 00018600: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00018610: 2020 2020 2020 2020 2020 2020 6265 7477 betw │ │ │ │ -00018620: 6565 6e20 6d65 6e75 2069 7465 6d73 2c20 een menu items, │ │ │ │ -00018630: 696e 2070 6978 656c 732e 0a20 2020 2020 in pixels.. │ │ │ │ -00018640: 6d65 6e75 5f70 6978 6d61 705f 7374 796c menu_pixmap_styl │ │ │ │ -00018650: 6520 2020 2020 2020 2020 2020 2020 5468 e Th │ │ │ │ -00018660: 6520 696d 6167 6520 6669 6c65 2070 6174 e image file pat │ │ │ │ -00018670: 7465 726e 2066 6f72 2074 6865 0a20 2020 tern for the. │ │ │ │ -00018680: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00018610: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00018620: 6265 7477 6565 6e20 6d65 6e75 2069 7465 between menu ite │ │ │ │ +00018630: 6d73 2c20 696e 2070 6978 656c 732e 0a20 ms, in pixels.. │ │ │ │ +00018640: 2020 2020 6d65 6e75 5f70 6978 6d61 705f menu_pixmap_ │ │ │ │ +00018650: 7374 796c 6520 2020 2020 2020 2020 2020 style │ │ │ │ +00018660: 2020 5468 6520 696d 6167 6520 6669 6c65 The image file │ │ │ │ +00018670: 2070 6174 7465 726e 2066 6f72 2074 6865 pattern for the │ │ │ │ +00018680: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ 00018690: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -000186a0: 6d65 6e75 2066 7261 6d65 2073 7479 6c65 menu frame style │ │ │ │ -000186b0: 6420 626f 782e 2020 4578 616d 706c 653a d box. Example: │ │ │ │ -000186c0: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ +000186a0: 2020 2020 6d65 6e75 2066 7261 6d65 2073 menu frame s │ │ │ │ +000186b0: 7479 6c65 6420 626f 782e 2020 4578 616d tyled box. Exam │ │ │ │ +000186c0: 706c 653a 0a20 2020 2020 2020 2020 2020 ple:. │ │ │ │ 000186d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -000186e0: 2020 2020 226d 656e 755f 2a2e 706e 6722 "menu_*.png" │ │ │ │ -000186f0: 2028 7468 6973 2077 696c 6c20 7573 6520 (this will use │ │ │ │ -00018700: 696d 6167 6573 0a20 2020 2020 2020 2020 images. │ │ │ │ +000186e0: 2020 2020 2020 2020 226d 656e 755f 2a2e "menu_*. │ │ │ │ +000186f0: 706e 6722 2028 7468 6973 2077 696c 6c20 png" (this will │ │ │ │ +00018700: 7573 6520 696d 6167 6573 0a20 2020 2020 use images. │ │ │ │ 00018710: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00018720: 2020 2020 2020 2020 2020 7375 6368 2061 such a │ │ │ │ -00018730: 7320 226d 656e 755f 632e 706e 6722 2c0a s "menu_c.png",. │ │ │ │ -00018740: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00018720: 2020 2020 2020 2020 2020 2020 2020 7375 su │ │ │ │ +00018730: 6368 2061 7320 226d 656e 755f 632e 706e ch as "menu_c.pn │ │ │ │ +00018740: 6722 2c0a 2020 2020 2020 2020 2020 2020 g",. │ │ │ │ 00018750: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00018760: 2020 2022 6d65 6e75 5f77 2e70 6e67 222c "menu_w.png", │ │ │ │ -00018770: 2027 6d65 6e75 5f6e 772e 706e 6722 2c20 'menu_nw.png", │ │ │ │ -00018780: 6574 632e 290a 2020 2020 2069 7465 6d5f etc.). item_ │ │ │ │ -00018790: 7069 786d 6170 5f73 7479 6c65 2020 2020 pixmap_style │ │ │ │ -000187a0: 2020 2020 2020 2020 2054 6865 2069 6d61 The ima │ │ │ │ -000187b0: 6765 2066 696c 6520 7061 7474 6572 6e20 ge file pattern │ │ │ │ -000187c0: 666f 7220 7468 650a 2020 2020 2020 2020 for the. │ │ │ │ +00018760: 2020 2020 2020 2022 6d65 6e75 5f77 2e70 "menu_w.p │ │ │ │ +00018770: 6e67 222c 2027 6d65 6e75 5f6e 772e 706e ng", 'menu_nw.pn │ │ │ │ +00018780: 6722 2c20 6574 632e 290a 2020 2020 2069 g", etc.). i │ │ │ │ +00018790: 7465 6d5f 7069 786d 6170 5f73 7479 6c65 tem_pixmap_style │ │ │ │ +000187a0: 2020 2020 2020 2020 2020 2020 2054 6865 The │ │ │ │ +000187b0: 2069 6d61 6765 2066 696c 6520 7061 7474 image file patt │ │ │ │ +000187c0: 6572 6e20 666f 7220 7468 650a 2020 2020 ern for the. │ │ │ │ 000187d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -000187e0: 2020 2020 2020 2020 2020 2069 7465 6d20 item │ │ │ │ -000187f0: 7374 796c 6564 2062 6f78 2e0a 2020 2020 styled box.. │ │ │ │ -00018800: 2073 656c 6563 7465 645f 6974 656d 5f70 selected_item_p │ │ │ │ -00018810: 6978 6d61 705f 7374 796c 6520 2020 2054 ixmap_style T │ │ │ │ -00018820: 6865 2069 6d61 6765 2066 696c 6520 7061 he image file pa │ │ │ │ -00018830: 7474 6572 6e20 666f 7220 7468 650a 2020 ttern for the. │ │ │ │ -00018840: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +000187e0: 2020 2020 2020 2020 2020 2020 2020 2069 i │ │ │ │ +000187f0: 7465 6d20 7374 796c 6564 2062 6f78 2e0a tem styled box.. │ │ │ │ +00018800: 2020 2020 2073 656c 6563 7465 645f 6974 selected_it │ │ │ │ +00018810: 656d 5f70 6978 6d61 705f 7374 796c 6520 em_pixmap_style │ │ │ │ +00018820: 2020 2054 6865 2069 6d61 6765 2066 696c The image fil │ │ │ │ +00018830: 6520 7061 7474 6572 6e20 666f 7220 7468 e pattern for th │ │ │ │ +00018840: 650a 2020 2020 2020 2020 2020 2020 2020 e. │ │ │ │ 00018850: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00018860: 2073 656c 6563 7465 6420 6974 656d 2068 selected item h │ │ │ │ -00018870: 6967 686c 6967 6874 2073 7479 6c65 640a ighlight styled. │ │ │ │ -00018880: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00018860: 2020 2020 2073 656c 6563 7465 6420 6974 selected it │ │ │ │ +00018870: 656d 2068 6967 686c 6967 6874 2073 7479 em highlight sty │ │ │ │ +00018880: 6c65 640a 2020 2020 2020 2020 2020 2020 led. │ │ │ │ 00018890: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -000188a0: 2020 2062 6f78 2e0a 2020 2020 2073 6372 box.. scr │ │ │ │ -000188b0: 6f6c 6c62 6172 2020 2020 2020 2020 2020 ollbar │ │ │ │ -000188c0: 2020 2020 2020 2020 2020 2042 6f6f 6c65 Boole │ │ │ │ -000188d0: 616e 2076 616c 7565 2069 6e64 6963 6174 an value indicat │ │ │ │ -000188e0: 696e 6720 7768 6574 6865 720a 2020 2020 ing whether. │ │ │ │ +000188a0: 2020 2020 2020 2062 6f78 2e0a 2020 2020 box.. │ │ │ │ +000188b0: 2073 6372 6f6c 6c62 6172 2020 2020 2020 scrollbar │ │ │ │ +000188c0: 2020 2020 2020 2020 2020 2020 2020 2042 B │ │ │ │ +000188d0: 6f6f 6c65 616e 2076 616c 7565 2069 6e64 oolean value ind │ │ │ │ +000188e0: 6963 6174 696e 6720 7768 6574 6865 720a icating whether. │ │ │ │ 000188f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00018900: 2020 2020 2020 2020 2020 2020 2020 2074 t │ │ │ │ -00018910: 6865 2073 6372 6f6c 6c20 6261 7220 7368 he scroll bar sh │ │ │ │ -00018920: 6f75 6c64 2062 6520 6472 6177 6e20 6966 ould be drawn if │ │ │ │ -00018930: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ +00018900: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00018910: 2020 2074 6865 2073 6372 6f6c 6c20 6261 the scroll ba │ │ │ │ +00018920: 7220 7368 6f75 6c64 2062 6520 6472 6177 r should be draw │ │ │ │ +00018930: 6e20 6966 0a20 2020 2020 2020 2020 2020 n if. │ │ │ │ 00018940: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00018950: 2020 2020 7468 6520 6672 616d 6520 616e the frame an │ │ │ │ -00018960: 6420 7468 756d 6220 7374 796c 6564 2062 d thumb styled b │ │ │ │ -00018970: 6f78 6573 0a20 2020 2020 2020 2020 2020 oxes. │ │ │ │ +00018950: 2020 2020 2020 2020 7468 6520 6672 616d the fram │ │ │ │ +00018960: 6520 616e 6420 7468 756d 6220 7374 796c e and thumb styl │ │ │ │ +00018970: 6564 2062 6f78 6573 0a20 2020 2020 2020 ed boxes. │ │ │ │ 00018980: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00018990: 2020 2020 2020 2020 6172 6520 636f 6e66 are conf │ │ │ │ -000189a0: 6967 7572 6564 2e0a 2020 2020 2073 6372 igured.. scr │ │ │ │ -000189b0: 6f6c 6c62 6172 5f66 7261 6d65 2020 2020 ollbar_frame │ │ │ │ -000189c0: 2020 2020 2020 2020 2020 2054 6865 2069 The i │ │ │ │ -000189d0: 6d61 6765 2066 696c 6520 7061 7474 6572 mage file patter │ │ │ │ -000189e0: 6e20 666f 7220 7468 650a 2020 2020 2020 n for the. │ │ │ │ +00018990: 2020 2020 2020 2020 2020 2020 6172 6520 are │ │ │ │ +000189a0: 636f 6e66 6967 7572 6564 2e0a 2020 2020 configured.. │ │ │ │ +000189b0: 2073 6372 6f6c 6c62 6172 5f66 7261 6d65 scrollbar_frame │ │ │ │ +000189c0: 2020 2020 2020 2020 2020 2020 2020 2054 T │ │ │ │ +000189d0: 6865 2069 6d61 6765 2066 696c 6520 7061 he image file pa │ │ │ │ +000189e0: 7474 6572 6e20 666f 7220 7468 650a 2020 ttern for the. │ │ │ │ 000189f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00018a00: 2020 2020 2020 2020 2020 2020 2065 6e74 ent │ │ │ │ -00018a10: 6972 6520 7363 726f 6c6c 2062 6172 2e20 ire scroll bar. │ │ │ │ -00018a20: 2045 7861 6d70 6c65 3a0a 2020 2020 2020 Example:. │ │ │ │ +00018a00: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00018a10: 2065 6e74 6972 6520 7363 726f 6c6c 2062 entire scroll b │ │ │ │ +00018a20: 6172 2e20 2045 7861 6d70 6c65 3a0a 2020 ar. Example:. │ │ │ │ 00018a30: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00018a40: 2020 2020 2020 2020 2020 2020 2022 7363 "sc │ │ │ │ -00018a50: 726f 6c6c 6261 725f 2a2e 706e 6722 0a20 rollbar_*.png". │ │ │ │ -00018a60: 2020 2020 7363 726f 6c6c 6261 725f 7468 scrollbar_th │ │ │ │ -00018a70: 756d 6220 2020 2020 2020 2020 2020 2020 umb │ │ │ │ -00018a80: 2020 5468 6520 696d 6167 6520 6669 6c65 The image file │ │ │ │ -00018a90: 2070 6174 7465 726e 2066 6f72 2074 6865 pattern for the │ │ │ │ -00018aa0: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ +00018a40: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00018a50: 2022 7363 726f 6c6c 6261 725f 2a2e 706e "scrollbar_*.pn │ │ │ │ +00018a60: 6722 0a20 2020 2020 7363 726f 6c6c 6261 g". scrollba │ │ │ │ +00018a70: 725f 7468 756d 6220 2020 2020 2020 2020 r_thumb │ │ │ │ +00018a80: 2020 2020 2020 5468 6520 696d 6167 6520 The image │ │ │ │ +00018a90: 6669 6c65 2070 6174 7465 726e 2066 6f72 file pattern for │ │ │ │ +00018aa0: 2074 6865 0a20 2020 2020 2020 2020 2020 the. │ │ │ │ 00018ab0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00018ac0: 2020 2020 7363 726f 6c6c 2062 6172 2074 scroll bar t │ │ │ │ -00018ad0: 6875 6d62 2028 7468 6520 7061 7274 206f humb (the part o │ │ │ │ -00018ae0: 6620 7468 650a 2020 2020 2020 2020 2020 f the. │ │ │ │ +00018ac0: 2020 2020 2020 2020 7363 726f 6c6c 2062 scroll b │ │ │ │ +00018ad0: 6172 2074 6875 6d62 2028 7468 6520 7061 ar thumb (the pa │ │ │ │ +00018ae0: 7274 206f 6620 7468 650a 2020 2020 2020 rt of the. │ │ │ │ 00018af0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00018b00: 2020 2020 2020 2020 2073 6372 6f6c 6c20 scroll │ │ │ │ -00018b10: 6261 7220 7468 6174 206d 6f76 6573 2061 bar that moves a │ │ │ │ -00018b20: 7320 7363 726f 6c6c 696e 670a 2020 2020 s scrolling. │ │ │ │ +00018b00: 2020 2020 2020 2020 2020 2020 2073 6372 scr │ │ │ │ +00018b10: 6f6c 6c20 6261 7220 7468 6174 206d 6f76 oll bar that mov │ │ │ │ +00018b20: 6573 2061 7320 7363 726f 6c6c 696e 670a es as scrolling. │ │ │ │ 00018b30: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00018b40: 2020 2020 2020 2020 2020 2020 2020 206f o │ │ │ │ -00018b50: 6363 7572 7329 2e20 2045 7861 6d70 6c65 ccurs). Example │ │ │ │ -00018b60: 3a0a 2020 2020 2020 2020 2020 2020 2020 :. │ │ │ │ +00018b40: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00018b50: 2020 206f 6363 7572 7329 2e20 2045 7861 occurs). Exa │ │ │ │ +00018b60: 6d70 6c65 3a0a 2020 2020 2020 2020 2020 mple:. │ │ │ │ 00018b70: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00018b80: 2020 2020 2022 7363 726f 6c6c 6261 725f "scrollbar_ │ │ │ │ -00018b90: 7468 756d 625f 2a2e 706e 6722 0a20 2020 thumb_*.png". │ │ │ │ -00018ba0: 2020 7363 726f 6c6c 6261 725f 7468 756d scrollbar_thum │ │ │ │ -00018bb0: 625f 6f76 6572 6c61 7920 2020 2020 2020 b_overlay │ │ │ │ -00018bc0: 4966 2074 6869 7320 6f70 7469 6f6e 2069 If this option i │ │ │ │ -00018bd0: 7320 7365 7420 746f 2022 7472 7565 220a s set to "true". │ │ │ │ -00018be0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00018b80: 2020 2020 2020 2020 2022 7363 726f 6c6c "scroll │ │ │ │ +00018b90: 6261 725f 7468 756d 625f 2a2e 706e 6722 bar_thumb_*.png" │ │ │ │ +00018ba0: 0a20 2020 2020 7363 726f 6c6c 6261 725f . scrollbar_ │ │ │ │ +00018bb0: 7468 756d 625f 6f76 6572 6c61 7920 2020 thumb_overlay │ │ │ │ +00018bc0: 2020 2020 4966 2074 6869 7320 6f70 7469 If this opti │ │ │ │ +00018bd0: 6f6e 2069 7320 7365 7420 746f 2022 7472 on is set to "tr │ │ │ │ +00018be0: 7565 220a 2020 2020 2020 2020 2020 2020 ue". │ │ │ │ 00018bf0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00018c00: 2020 2074 6865 6e20 7468 6520 7363 726f then the scro │ │ │ │ -00018c10: 6c6c 6261 7220 7468 756d 6220 7369 6465 llbar thumb side │ │ │ │ -00018c20: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ +00018c00: 2020 2020 2020 2074 6865 6e20 7468 6520 then the │ │ │ │ +00018c10: 7363 726f 6c6c 6261 7220 7468 756d 6220 scrollbar thumb │ │ │ │ +00018c20: 7369 6465 0a20 2020 2020 2020 2020 2020 side. │ │ │ │ 00018c30: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00018c40: 2020 2020 736c 6963 6573 2028 6576 6572 slices (ever │ │ │ │ -00018c50: 7920 736c 6963 6520 6578 6365 7074 2074 y slice except t │ │ │ │ -00018c60: 6865 0a20 2020 2020 2020 2020 2020 2020 he. │ │ │ │ +00018c40: 2020 2020 2020 2020 736c 6963 6573 2028 slices ( │ │ │ │ +00018c50: 6576 6572 7920 736c 6963 6520 6578 6365 every slice exce │ │ │ │ +00018c60: 7074 2074 6865 0a20 2020 2020 2020 2020 pt the. │ │ │ │ 00018c70: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00018c80: 2020 2020 2020 6365 6e74 6572 2073 6c69 center sli │ │ │ │ -00018c90: 6365 2920 7769 6c6c 206f 7665 726c 6179 ce) will overlay │ │ │ │ -00018ca0: 2074 6865 0a20 2020 2020 2020 2020 2020 the. │ │ │ │ +00018c80: 2020 2020 2020 2020 2020 6365 6e74 6572 center │ │ │ │ +00018c90: 2073 6c69 6365 2920 7769 6c6c 206f 7665 slice) will ove │ │ │ │ +00018ca0: 726c 6179 2074 6865 0a20 2020 2020 2020 rlay the. │ │ │ │ 00018cb0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00018cc0: 2020 2020 2020 2020 7363 726f 6c6c 6261 scrollba │ │ │ │ -00018cd0: 7220 6672 616d 6520 7369 6465 2073 6c69 r frame side sli │ │ │ │ -00018ce0: 6365 732e 2020 416e 640a 2020 2020 2020 ces. And. │ │ │ │ +00018cc0: 2020 2020 2020 2020 2020 2020 7363 726f scro │ │ │ │ +00018cd0: 6c6c 6261 7220 6672 616d 6520 7369 6465 llbar frame side │ │ │ │ +00018ce0: 2073 6c69 6365 732e 2020 416e 640a 2020 slices. And. │ │ │ │ 00018cf0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00018d00: 2020 2020 2020 2020 2020 2020 2074 6865 the │ │ │ │ -00018d10: 2063 656e 7465 7220 736c 6963 6520 6f66 center slice of │ │ │ │ -00018d20: 2074 6865 0a20 2020 2020 2020 2020 2020 the. │ │ │ │ +00018d00: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00018d10: 2074 6865 2063 656e 7465 7220 736c 6963 the center slic │ │ │ │ +00018d20: 6520 6f66 2074 6865 0a20 2020 2020 2020 e of the. │ │ │ │ 00018d30: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00018d40: 2020 2020 2020 2020 7363 726f 6c6c 6261 scrollba │ │ │ │ -00018d50: 725f 7468 756d 6220 6361 6e20 6d6f 7665 r_thumb can move │ │ │ │ -00018d60: 2061 6c6c 2074 6865 0a20 2020 2020 2020 all the. │ │ │ │ +00018d40: 2020 2020 2020 2020 2020 2020 7363 726f scro │ │ │ │ +00018d50: 6c6c 6261 725f 7468 756d 6220 6361 6e20 llbar_thumb can │ │ │ │ +00018d60: 6d6f 7665 2061 6c6c 2074 6865 0a20 2020 move all the. │ │ │ │ 00018d70: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00018d80: 2020 2020 2020 2020 2020 2020 7761 7920 way │ │ │ │ -00018d90: 2866 726f 6d20 746f 7020 746f 2062 6f74 (from top to bot │ │ │ │ -00018da0: 746f 6d29 2c20 6265 696e 670a 2020 2020 tom), being. │ │ │ │ +00018d80: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00018d90: 7761 7920 2866 726f 6d20 746f 7020 746f way (from top to │ │ │ │ +00018da0: 2062 6f74 746f 6d29 2c20 6265 696e 670a bottom), being. │ │ │ │ 00018db0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00018dc0: 2020 2020 2020 2020 2020 2020 2020 2064 d │ │ │ │ -00018dd0: 7261 776e 206f 6e20 7468 6520 6365 6e74 rawn on the cent │ │ │ │ -00018de0: 6572 2073 6c69 6365 206f 6620 7468 650a er slice of the. │ │ │ │ -00018df0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00018dc0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00018dd0: 2020 2064 7261 776e 206f 6e20 7468 6520 drawn on the │ │ │ │ +00018de0: 6365 6e74 6572 2073 6c69 6365 206f 6620 center slice of │ │ │ │ +00018df0: 7468 650a 2020 2020 2020 2020 2020 2020 the. │ │ │ │ 00018e00: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00018e10: 2020 2073 6372 6f6c 6c62 6172 2066 7261 scrollbar fra │ │ │ │ -00018e20: 6d65 2e20 2054 6861 7420 7761 7920 7765 me. That way we │ │ │ │ -00018e30: 2063 616e 0a20 2020 2020 2020 2020 2020 can. │ │ │ │ +00018e10: 2020 2020 2020 2073 6372 6f6c 6c62 6172 scrollbar │ │ │ │ +00018e20: 2066 7261 6d65 2e20 2054 6861 7420 7761 frame. That wa │ │ │ │ +00018e30: 7920 7765 2063 616e 0a20 2020 2020 2020 y we can. │ │ │ │ 00018e40: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00018e50: 2020 2020 2020 2020 6d61 6b65 2061 2073 make a s │ │ │ │ -00018e60: 6372 6f6c 6c62 6172 2077 6974 6820 726f crollbar with ro │ │ │ │ -00018e70: 756e 642d 7368 6170 6564 0a20 2020 2020 und-shaped. │ │ │ │ +00018e50: 2020 2020 2020 2020 2020 2020 6d61 6b65 make │ │ │ │ +00018e60: 2061 2073 6372 6f6c 6c62 6172 2077 6974 a scrollbar wit │ │ │ │ +00018e70: 6820 726f 756e 642d 7368 6170 6564 0a20 h round-shaped. │ │ │ │ 00018e80: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00018e90: 2020 2020 2020 2020 2020 2020 2020 6564 ed │ │ │ │ -00018ea0: 6765 7320 736f 2074 6865 7265 2077 6f6e ges so there won │ │ │ │ -00018eb0: 2774 2062 6520 6120 6672 6565 0a20 2020 't be a free. │ │ │ │ -00018ec0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00018e90: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00018ea0: 2020 6564 6765 7320 736f 2074 6865 7265 edges so there │ │ │ │ +00018eb0: 2077 6f6e 2774 2062 6520 6120 6672 6565 won't be a free │ │ │ │ +00018ec0: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ 00018ed0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00018ee0: 7370 6163 6520 6672 6f6d 2074 6865 2074 space from the t │ │ │ │ -00018ef0: 6875 6d62 2074 6f20 7468 6520 6672 616d humb to the fram │ │ │ │ -00018f00: 650a 2020 2020 2020 2020 2020 2020 2020 e. │ │ │ │ +00018ee0: 2020 2020 7370 6163 6520 6672 6f6d 2074 space from t │ │ │ │ +00018ef0: 6865 2074 6875 6d62 2074 6f20 7468 6520 he thumb to the │ │ │ │ +00018f00: 6672 616d 650a 2020 2020 2020 2020 2020 frame. │ │ │ │ 00018f10: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00018f20: 2020 2020 2069 6e20 746f 7020 616e 6420 in top and │ │ │ │ -00018f30: 626f 7474 6f6d 2073 6372 6f6c 6c62 6172 bottom scrollbar │ │ │ │ -00018f40: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ +00018f20: 2020 2020 2020 2020 2069 6e20 746f 7020 in top │ │ │ │ +00018f30: 616e 6420 626f 7474 6f6d 2073 6372 6f6c and bottom scrol │ │ │ │ +00018f40: 6c62 6172 0a20 2020 2020 2020 2020 2020 lbar. │ │ │ │ 00018f50: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00018f60: 2020 2020 706f 7369 7469 6f6e 732e 2020 positions. │ │ │ │ -00018f70: 4465 6661 756c 7420 6973 2022 6661 6c73 Default is "fals │ │ │ │ -00018f80: 6522 2e0a 2020 2020 2073 6372 6f6c 6c62 e".. scrollb │ │ │ │ -00018f90: 6172 5f73 6c69 6365 2020 2020 2020 2020 ar_slice │ │ │ │ -00018fa0: 2020 2020 2020 2054 6865 206d 656e 7520 The menu │ │ │ │ -00018fb0: 6672 616d 6520 7374 796c 6564 2062 6f78 frame styled box │ │ │ │ -00018fc0: 2773 2073 6c69 6365 0a20 2020 2020 2020 's slice. │ │ │ │ +00018f60: 2020 2020 2020 2020 706f 7369 7469 6f6e position │ │ │ │ +00018f70: 732e 2020 4465 6661 756c 7420 6973 2022 s. Default is " │ │ │ │ +00018f80: 6661 6c73 6522 2e0a 2020 2020 2073 6372 false".. scr │ │ │ │ +00018f90: 6f6c 6c62 6172 5f73 6c69 6365 2020 2020 ollbar_slice │ │ │ │ +00018fa0: 2020 2020 2020 2020 2020 2054 6865 206d The m │ │ │ │ +00018fb0: 656e 7520 6672 616d 6520 7374 796c 6564 enu frame styled │ │ │ │ +00018fc0: 2062 6f78 2773 2073 6c69 6365 0a20 2020 box's slice. │ │ │ │ 00018fd0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00018fe0: 2020 2020 2020 2020 2020 2020 696e 2077 in w │ │ │ │ -00018ff0: 6869 6368 2074 6865 2073 6372 6f6c 6c62 hich the scrollb │ │ │ │ -00019000: 6172 2077 696c 6c20 6265 0a20 2020 2020 ar will be. │ │ │ │ +00018fe0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00018ff0: 696e 2077 6869 6368 2074 6865 2073 6372 in which the scr │ │ │ │ +00019000: 6f6c 6c62 6172 2077 696c 6c20 6265 0a20 ollbar will be. │ │ │ │ 00019010: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00019020: 2020 2020 2020 2020 2020 2020 2020 6472 dr │ │ │ │ -00019030: 6177 6e2e 2020 506f 7373 6962 6c65 2076 awn. Possible v │ │ │ │ -00019040: 616c 7565 7320 6172 650a 2020 2020 2020 alues are. │ │ │ │ +00019020: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00019030: 2020 6472 6177 6e2e 2020 506f 7373 6962 drawn. Possib │ │ │ │ +00019040: 6c65 2076 616c 7565 7320 6172 650a 2020 le values are. │ │ │ │ 00019050: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00019060: 2020 2020 2020 2020 2020 2020 2022 7765 "we │ │ │ │ -00019070: 7374 222c 2022 6365 6e74 6572 222c 2022 st", "center", " │ │ │ │ -00019080: 6561 7374 220a 2020 2020 2020 2020 2020 east". │ │ │ │ +00019060: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00019070: 2022 7765 7374 222c 2022 6365 6e74 6572 "west", "center │ │ │ │ +00019080: 222c 2022 6561 7374 220a 2020 2020 2020 ", "east". │ │ │ │ 00019090: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -000190a0: 2020 2020 2020 2020 2028 6465 6661 756c (defaul │ │ │ │ -000190b0: 7429 2e20 2022 7765 7374 2220 2d20 7468 t). "west" - th │ │ │ │ -000190c0: 6520 7363 726f 6c6c 6261 720a 2020 2020 e scrollbar. │ │ │ │ +000190a0: 2020 2020 2020 2020 2020 2020 2028 6465 (de │ │ │ │ +000190b0: 6661 756c 7429 2e20 2022 7765 7374 2220 fault). "west" │ │ │ │ +000190c0: 2d20 7468 6520 7363 726f 6c6c 6261 720a - the scrollbar. │ │ │ │ 000190d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -000190e0: 2020 2020 2020 2020 2020 2020 2020 2077 w │ │ │ │ -000190f0: 696c 6c20 6265 2064 7261 776e 2069 6e20 ill be drawn in │ │ │ │ -00019100: 7468 6520 7765 7374 2073 6c69 6365 0a20 the west slice. │ │ │ │ -00019110: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +000190e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +000190f0: 2020 2077 696c 6c20 6265 2064 7261 776e will be drawn │ │ │ │ +00019100: 2069 6e20 7468 6520 7765 7374 2073 6c69 in the west sli │ │ │ │ +00019110: 6365 0a20 2020 2020 2020 2020 2020 2020 ce. │ │ │ │ 00019120: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00019130: 2020 2872 6967 6874 2d61 6c69 676e 6564 (right-aligned │ │ │ │ -00019140: 292e 2020 2265 6173 7422 202d 2074 6865 ). "east" - the │ │ │ │ -00019150: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ +00019130: 2020 2020 2020 2872 6967 6874 2d61 6c69 (right-ali │ │ │ │ +00019140: 676e 6564 292e 2020 2265 6173 7422 202d gned). "east" - │ │ │ │ +00019150: 2074 6865 0a20 2020 2020 2020 2020 2020 the. │ │ │ │ 00019160: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00019170: 2020 2020 7363 726f 6c6c 6261 7220 7769 scrollbar wi │ │ │ │ -00019180: 6c6c 2062 6520 6472 6177 6e20 696e 2074 ll be drawn in t │ │ │ │ -00019190: 6865 0a20 2020 2020 2020 2020 2020 2020 he. │ │ │ │ +00019170: 2020 2020 2020 2020 7363 726f 6c6c 6261 scrollba │ │ │ │ +00019180: 7220 7769 6c6c 2062 6520 6472 6177 6e20 r will be drawn │ │ │ │ +00019190: 696e 2074 6865 0a20 2020 2020 2020 2020 in the. │ │ │ │ 000191a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -000191b0: 2020 2020 2020 6561 7374 2073 6c69 6365 east slice │ │ │ │ -000191c0: 2028 6c65 6674 2d61 6c69 676e 6564 292e (left-aligned). │ │ │ │ -000191d0: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ +000191b0: 2020 2020 2020 2020 2020 6561 7374 2073 east s │ │ │ │ +000191c0: 6c69 6365 2028 6c65 6674 2d61 6c69 676e lice (left-align │ │ │ │ +000191d0: 6564 292e 0a20 2020 2020 2020 2020 2020 ed).. │ │ │ │ 000191e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -000191f0: 2020 2020 2263 656e 7465 7222 202d 2074 "center" - t │ │ │ │ -00019200: 6865 2073 6372 6f6c 6c62 6172 2077 696c he scrollbar wil │ │ │ │ -00019210: 6c20 6265 0a20 2020 2020 2020 2020 2020 l be. │ │ │ │ +000191f0: 2020 2020 2020 2020 2263 656e 7465 7222 "center" │ │ │ │ +00019200: 202d 2074 6865 2073 6372 6f6c 6c62 6172 - the scrollbar │ │ │ │ +00019210: 2077 696c 6c20 6265 0a20 2020 2020 2020 will be. │ │ │ │ 00019220: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00019230: 2020 2020 2020 2020 6472 6177 6e20 696e drawn in │ │ │ │ -00019240: 2074 6865 2063 656e 7465 7220 736c 6963 the center slic │ │ │ │ -00019250: 652e 2020 4e6f 7465 3a0a 2020 2020 2020 e. Note:. │ │ │ │ +00019230: 2020 2020 2020 2020 2020 2020 6472 6177 draw │ │ │ │ +00019240: 6e20 696e 2074 6865 2063 656e 7465 7220 n in the center │ │ │ │ +00019250: 736c 6963 652e 2020 4e6f 7465 3a0a 2020 slice. Note:. │ │ │ │ 00019260: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00019270: 2020 2020 2020 2020 2020 2020 2069 6e20 in │ │ │ │ -00019280: 6361 7365 206f 6620 2263 656e 7465 7222 case of "center" │ │ │ │ -00019290: 2073 6c69 6365 3a20 6129 2049 660a 2020 slice: a) If. │ │ │ │ -000192a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00019270: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00019280: 2069 6e20 6361 7365 206f 6620 2263 656e in case of "cen │ │ │ │ +00019290: 7465 7222 2073 6c69 6365 3a20 6129 2049 ter" slice: a) I │ │ │ │ +000192a0: 660a 2020 2020 2020 2020 2020 2020 2020 f. │ │ │ │ 000192b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -000192c0: 2074 6865 2073 6372 6f6c 6c62 6172 2073 the scrollbar s │ │ │ │ -000192d0: 686f 756c 6420 6265 2064 7261 776e 2074 hould be drawn t │ │ │ │ -000192e0: 6865 6e0a 2020 2020 2020 2020 2020 2020 hen. │ │ │ │ +000192c0: 2020 2020 2074 6865 2073 6372 6f6c 6c62 the scrollb │ │ │ │ +000192d0: 6172 2073 686f 756c 6420 6265 2064 7261 ar should be dra │ │ │ │ +000192e0: 776e 2074 6865 6e0a 2020 2020 2020 2020 wn then. │ │ │ │ 000192f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00019300: 2020 2020 2020 2062 6f6f 7420 6d65 6e75 boot menu │ │ │ │ -00019310: 2065 6e74 7279 2773 2077 6964 7468 2069 entry's width i │ │ │ │ -00019320: 730a 2020 2020 2020 2020 2020 2020 2020 s. │ │ │ │ +00019300: 2020 2020 2020 2020 2020 2062 6f6f 7420 boot │ │ │ │ +00019310: 6d65 6e75 2065 6e74 7279 2773 2077 6964 menu entry's wid │ │ │ │ +00019320: 7468 2069 730a 2020 2020 2020 2020 2020 th is. │ │ │ │ 00019330: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00019340: 2020 2020 2064 6563 7265 6173 6564 2062 decreased b │ │ │ │ -00019350: 7920 7468 6520 7363 726f 6c6c 6261 7227 y the scrollbar' │ │ │ │ -00019360: 7320 7769 6474 680a 2020 2020 2020 2020 s width. │ │ │ │ +00019340: 2020 2020 2020 2020 2064 6563 7265 6173 decreas │ │ │ │ +00019350: 6564 2062 7920 7468 6520 7363 726f 6c6c ed by the scroll │ │ │ │ +00019360: 6261 7227 7320 7769 6474 680a 2020 2020 bar's width. │ │ │ │ 00019370: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00019380: 2020 2020 2020 2020 2020 2061 6e64 2074 and t │ │ │ │ -00019390: 6865 2073 6372 6f6c 6c62 6172 2069 7320 he scrollbar is │ │ │ │ -000193a0: 6472 6177 6e20 6174 2074 6865 0a20 2020 drawn at the. │ │ │ │ -000193b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00019380: 2020 2020 2020 2020 2020 2020 2020 2061 a │ │ │ │ +00019390: 6e64 2074 6865 2073 6372 6f6c 6c62 6172 nd the scrollbar │ │ │ │ +000193a0: 2069 7320 6472 6177 6e20 6174 2074 6865 is drawn at the │ │ │ │ +000193b0: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ 000193c0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -000193d0: 7269 6768 7420 7369 6465 206f 6620 7468 right side of th │ │ │ │ -000193e0: 6520 6365 6e74 6572 2073 6c69 6365 2e0a e center slice.. │ │ │ │ -000193f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +000193d0: 2020 2020 7269 6768 7420 7369 6465 206f right side o │ │ │ │ +000193e0: 6620 7468 6520 6365 6e74 6572 2073 6c69 f the center sli │ │ │ │ +000193f0: 6365 2e0a 2020 2020 2020 2020 2020 2020 ce.. │ │ │ │ 00019400: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00019410: 2020 2062 2920 4966 2074 6865 2073 6372 b) If the scr │ │ │ │ -00019420: 6f6c 6c62 6172 2077 6f6e 2774 2062 6520 ollbar won't be │ │ │ │ -00019430: 6472 6177 6e0a 2020 2020 2020 2020 2020 drawn. │ │ │ │ +00019410: 2020 2020 2020 2062 2920 4966 2074 6865 b) If the │ │ │ │ +00019420: 2073 6372 6f6c 6c62 6172 2077 6f6e 2774 scrollbar won't │ │ │ │ +00019430: 2062 6520 6472 6177 6e0a 2020 2020 2020 be drawn. │ │ │ │ 00019440: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00019450: 2020 2020 2020 2020 2074 6865 6e20 7468 then th │ │ │ │ -00019460: 6520 626f 6f74 206d 656e 7520 656e 7472 e boot menu entr │ │ │ │ -00019470: 7927 7320 7769 6474 680a 2020 2020 2020 y's width. │ │ │ │ +00019450: 2020 2020 2020 2020 2020 2020 2074 6865 the │ │ │ │ +00019460: 6e20 7468 6520 626f 6f74 206d 656e 7520 n the boot menu │ │ │ │ +00019470: 656e 7472 7927 7320 7769 6474 680a 2020 entry's width. │ │ │ │ 00019480: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00019490: 2020 2020 2020 2020 2020 2020 2069 7320 is │ │ │ │ -000194a0: 7468 6520 7769 6474 6820 6f66 2074 6865 the width of the │ │ │ │ -000194b0: 2063 656e 7465 7220 736c 6963 652e 0a20 center slice.. │ │ │ │ -000194c0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00019490: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +000194a0: 2069 7320 7468 6520 7769 6474 6820 6f66 is the width of │ │ │ │ +000194b0: 2074 6865 2063 656e 7465 7220 736c 6963 the center slic │ │ │ │ +000194c0: 652e 0a20 2020 2020 2020 2020 2020 2020 e.. │ │ │ │ 000194d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -000194e0: 2020 6329 2057 6520 646f 6e27 7420 6e65 c) We don't ne │ │ │ │ -000194f0: 6365 7373 6172 7920 6e65 6564 2074 6865 cessary need the │ │ │ │ -00019500: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ +000194e0: 2020 2020 2020 6329 2057 6520 646f 6e27 c) We don' │ │ │ │ +000194f0: 7420 6e65 6365 7373 6172 7920 6e65 6564 t necessary need │ │ │ │ +00019500: 2074 6865 0a20 2020 2020 2020 2020 2020 the. │ │ │ │ 00019510: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00019520: 2020 2020 6d65 6e75 2070 6978 6d61 7020 menu pixmap │ │ │ │ -00019530: 626f 7820 746f 2064 6973 706c 6179 2074 box to display t │ │ │ │ -00019540: 6865 0a20 2020 2020 2020 2020 2020 2020 he. │ │ │ │ +00019520: 2020 2020 2020 2020 6d65 6e75 2070 6978 menu pix │ │ │ │ +00019530: 6d61 7020 626f 7820 746f 2064 6973 706c map box to displ │ │ │ │ +00019540: 6179 2074 6865 0a20 2020 2020 2020 2020 ay the. │ │ │ │ 00019550: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00019560: 2020 2020 2020 7363 726f 6c6c 6261 722e scrollbar. │ │ │ │ -00019570: 0a20 2020 2020 7363 726f 6c6c 6261 725f . scrollbar_ │ │ │ │ -00019580: 6c65 6674 5f70 6164 2020 2020 2020 2020 left_pad │ │ │ │ -00019590: 2020 2020 5468 6520 6c65 6674 2073 6372 The left scr │ │ │ │ -000195a0: 6f6c 6c62 6172 2070 6164 6469 6e67 2069 ollbar padding i │ │ │ │ -000195b0: 6e0a 2020 2020 2020 2020 2020 2020 2020 n. │ │ │ │ +00019560: 2020 2020 2020 2020 2020 7363 726f 6c6c scroll │ │ │ │ +00019570: 6261 722e 0a20 2020 2020 7363 726f 6c6c bar.. scroll │ │ │ │ +00019580: 6261 725f 6c65 6674 5f70 6164 2020 2020 bar_left_pad │ │ │ │ +00019590: 2020 2020 2020 2020 5468 6520 6c65 6674 The left │ │ │ │ +000195a0: 2073 6372 6f6c 6c62 6172 2070 6164 6469 scrollbar paddi │ │ │ │ +000195b0: 6e67 2069 6e0a 2020 2020 2020 2020 2020 ng in. │ │ │ │ 000195c0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -000195d0: 2020 2020 2070 6978 656c 732e 2020 556e pixels. Un │ │ │ │ -000195e0: 7573 6564 2069 660a 2020 2020 2020 2020 used if. │ │ │ │ +000195d0: 2020 2020 2020 2020 2070 6978 656c 732e pixels. │ │ │ │ +000195e0: 2020 556e 7573 6564 2069 660a 2020 2020 Unused if. │ │ │ │ 000195f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00019600: 2020 2020 2020 2020 2020 2022 7363 726f "scro │ │ │ │ -00019610: 6c6c 6261 725f 736c 6963 6522 2069 7320 llbar_slice" is │ │ │ │ -00019620: 2277 6573 7422 2e0a 2020 2020 2073 6372 "west".. scr │ │ │ │ -00019630: 6f6c 6c62 6172 5f72 6967 6874 5f70 6164 ollbar_right_pad │ │ │ │ -00019640: 2020 2020 2020 2020 2020 2054 6865 2072 The r │ │ │ │ -00019650: 6967 6874 2073 6372 6f6c 6c62 6172 2070 ight scrollbar p │ │ │ │ -00019660: 6164 6469 6e67 2069 6e0a 2020 2020 2020 adding in. │ │ │ │ +00019600: 2020 2020 2020 2020 2020 2020 2020 2022 " │ │ │ │ +00019610: 7363 726f 6c6c 6261 725f 736c 6963 6522 scrollbar_slice" │ │ │ │ +00019620: 2069 7320 2277 6573 7422 2e0a 2020 2020 is "west".. │ │ │ │ +00019630: 2073 6372 6f6c 6c62 6172 5f72 6967 6874 scrollbar_right │ │ │ │ +00019640: 5f70 6164 2020 2020 2020 2020 2020 2054 _pad T │ │ │ │ +00019650: 6865 2072 6967 6874 2073 6372 6f6c 6c62 he right scrollb │ │ │ │ +00019660: 6172 2070 6164 6469 6e67 2069 6e0a 2020 ar padding in. │ │ │ │ 00019670: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00019680: 2020 2020 2020 2020 2020 2020 2070 6978 pix │ │ │ │ -00019690: 656c 732e 2020 556e 7573 6564 2069 660a els. Unused if. │ │ │ │ -000196a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00019680: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00019690: 2070 6978 656c 732e 2020 556e 7573 6564 pixels. Unused │ │ │ │ +000196a0: 2069 660a 2020 2020 2020 2020 2020 2020 if. │ │ │ │ 000196b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -000196c0: 2020 2022 7363 726f 6c6c 6261 725f 736c "scrollbar_sl │ │ │ │ -000196d0: 6963 6522 2069 7320 2265 6173 7422 2e0a ice" is "east".. │ │ │ │ -000196e0: 2020 2020 2073 6372 6f6c 6c62 6172 5f74 scrollbar_t │ │ │ │ -000196f0: 6f70 5f70 6164 2020 2020 2020 2020 2020 op_pad │ │ │ │ -00019700: 2020 2054 6865 2074 6f70 2073 6372 6f6c The top scrol │ │ │ │ -00019710: 6c62 6172 2070 6164 6469 6e67 2069 6e0a lbar padding in. │ │ │ │ -00019720: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +000196c0: 2020 2020 2020 2022 7363 726f 6c6c 6261 "scrollba │ │ │ │ +000196d0: 725f 736c 6963 6522 2069 7320 2265 6173 r_slice" is "eas │ │ │ │ +000196e0: 7422 2e0a 2020 2020 2073 6372 6f6c 6c62 t".. scrollb │ │ │ │ +000196f0: 6172 5f74 6f70 5f70 6164 2020 2020 2020 ar_top_pad │ │ │ │ +00019700: 2020 2020 2020 2054 6865 2074 6f70 2073 The top s │ │ │ │ +00019710: 6372 6f6c 6c62 6172 2070 6164 6469 6e67 crollbar padding │ │ │ │ +00019720: 2069 6e0a 2020 2020 2020 2020 2020 2020 in. │ │ │ │ 00019730: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00019740: 2020 2070 6978 656c 732e 0a20 2020 2020 pixels.. │ │ │ │ -00019750: 7363 726f 6c6c 6261 725f 626f 7474 6f6d scrollbar_bottom │ │ │ │ -00019760: 5f70 6164 2020 2020 2020 2020 2020 5468 _pad Th │ │ │ │ -00019770: 6520 626f 7474 6f6d 2073 6372 6f6c 6c62 e bottom scrollb │ │ │ │ -00019780: 6172 2070 6164 6469 6e67 2069 6e0a 2020 ar padding in. │ │ │ │ -00019790: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00019740: 2020 2020 2020 2070 6978 656c 732e 0a20 pixels.. │ │ │ │ +00019750: 2020 2020 7363 726f 6c6c 6261 725f 626f scrollbar_bo │ │ │ │ +00019760: 7474 6f6d 5f70 6164 2020 2020 2020 2020 ttom_pad │ │ │ │ +00019770: 2020 5468 6520 626f 7474 6f6d 2073 6372 The bottom scr │ │ │ │ +00019780: 6f6c 6c62 6172 2070 6164 6469 6e67 2069 ollbar padding i │ │ │ │ +00019790: 6e0a 2020 2020 2020 2020 2020 2020 2020 n. │ │ │ │ 000197a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -000197b0: 2070 6978 656c 732e 0a20 2020 2020 7669 pixels.. vi │ │ │ │ -000197c0: 7369 626c 6520 2020 2020 2020 2020 2020 sible │ │ │ │ -000197d0: 2020 2020 2020 2020 2020 2020 5365 7420 Set │ │ │ │ -000197e0: 746f 2022 6661 6c73 6522 2074 6f20 6869 to "false" to hi │ │ │ │ -000197f0: 6465 2074 6865 2062 6f6f 740a 2020 2020 de the boot. │ │ │ │ +000197b0: 2020 2020 2070 6978 656c 732e 0a20 2020 pixels.. │ │ │ │ +000197c0: 2020 7669 7369 626c 6520 2020 2020 2020 visible │ │ │ │ +000197d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +000197e0: 5365 7420 746f 2022 6661 6c73 6522 2074 Set to "false" t │ │ │ │ +000197f0: 6f20 6869 6465 2074 6865 2062 6f6f 740a o hide the boot. │ │ │ │ 00019800: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00019810: 2020 2020 2020 2020 2020 2020 2020 206d m │ │ │ │ -00019820: 656e 752e 0a0a 2020 202a 2063 616e 7661 enu... * canva │ │ │ │ -00019830: 7320 4361 6e76 6173 2069 7320 6120 636f s Canvas is a co │ │ │ │ -00019840: 6e74 6169 6e65 7220 7468 6174 2061 6c6c ntainer that all │ │ │ │ -00019850: 6f77 7320 6d61 6e75 616c 2070 6c61 6365 ows manual place │ │ │ │ -00019860: 6d65 6e74 206f 660a 2020 2020 2063 6f6d ment of. com │ │ │ │ -00019870: 706f 6e65 6e74 7320 7769 7468 696e 2069 ponents within i │ │ │ │ -00019880: 742e 2020 4974 2064 6f65 7320 6e6f 7420 t. It does not │ │ │ │ -00019890: 616c 7465 7220 7468 6520 706f 7369 7469 alter the positi │ │ │ │ -000198a0: 6f6e 7320 6f66 2069 7473 2063 6869 6c64 ons of its child │ │ │ │ -000198b0: 0a20 2020 2020 636f 6d70 6f6e 656e 7473 . components │ │ │ │ -000198c0: 2e20 2049 7420 6173 7369 676e 7320 616c . It assigns al │ │ │ │ -000198d0: 6c20 6368 696c 6420 636f 6d70 6f6e 656e l child componen │ │ │ │ -000198e0: 7473 2074 6865 6972 2070 7265 6665 7272 ts their preferr │ │ │ │ -000198f0: 6564 2073 697a 6573 2e0a 0a20 2020 2a20 ed sizes... * │ │ │ │ -00019900: 6862 6f78 2054 6865 202a 6862 6f78 2a20 hbox The *hbox* │ │ │ │ -00019910: 636f 6e74 6169 6e65 7220 6c61 7973 206f container lays o │ │ │ │ -00019920: 7574 2069 7473 2063 6869 6c64 7265 6e20 ut its children │ │ │ │ -00019930: 6672 6f6d 206c 6566 7420 746f 2072 6967 from left to rig │ │ │ │ -00019940: 6874 2c0a 2020 2020 2067 6976 696e 6720 ht,. giving │ │ │ │ -00019950: 6561 6368 206f 6e65 2069 7473 2070 7265 each one its pre │ │ │ │ -00019960: 6665 7272 6564 2077 6964 7468 2e20 2054 ferred width. T │ │ │ │ -00019970: 6865 2068 6569 6768 7420 6f66 2065 6163 he height of eac │ │ │ │ -00019980: 6820 6368 696c 6420 6973 0a20 2020 2020 h child is. │ │ │ │ -00019990: 7365 7420 746f 2074 6865 206d 6178 696d set to the maxim │ │ │ │ -000199a0: 756d 206f 6620 7468 6520 7072 6566 6572 um of the prefer │ │ │ │ -000199b0: 7265 6420 6865 6967 6874 7320 6f66 2061 red heights of a │ │ │ │ -000199c0: 6c6c 2063 6869 6c64 7265 6e2e 0a0a 2020 ll children... │ │ │ │ -000199d0: 202a 2076 626f 7820 5468 6520 2a76 626f * vbox The *vbo │ │ │ │ -000199e0: 782a 2063 6f6e 7461 696e 6572 206c 6179 x* container lay │ │ │ │ -000199f0: 7320 6f75 7420 6974 7320 6368 696c 6472 s out its childr │ │ │ │ -00019a00: 656e 2066 726f 6d20 746f 7020 746f 2062 en from top to b │ │ │ │ -00019a10: 6f74 746f 6d2c 0a20 2020 2020 6769 7669 ottom,. givi │ │ │ │ -00019a20: 6e67 2065 6163 6820 6f6e 6520 6974 7320 ng each one its │ │ │ │ -00019a30: 7072 6566 6572 7265 6420 6865 6967 6874 preferred height │ │ │ │ -00019a40: 2e20 2054 6865 2077 6964 7468 206f 6620 . The width of │ │ │ │ -00019a50: 6561 6368 2063 6869 6c64 2069 730a 2020 each child is. │ │ │ │ -00019a60: 2020 2073 6574 2074 6f20 7468 6520 6d61 set to the ma │ │ │ │ -00019a70: 7869 6d75 6d20 6f66 2074 6865 2070 7265 ximum of the pre │ │ │ │ -00019a80: 6665 7272 6564 2077 6964 7468 7320 6f66 ferred widths of │ │ │ │ -00019a90: 2061 6c6c 2063 6869 6c64 7265 6e2e 0a0a all children... │ │ │ │ -00019aa0: 372e 332e 3620 436f 6d6d 6f6e 2070 726f 7.3.6 Common pro │ │ │ │ -00019ab0: 7065 7274 6965 730a 2d2d 2d2d 2d2d 2d2d perties.-------- │ │ │ │ -00019ac0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a ---------------. │ │ │ │ -00019ad0: 0a54 6865 2066 6f6c 6c6f 7769 6e67 2070 .The following p │ │ │ │ -00019ae0: 726f 7065 7274 6965 7320 6172 6520 7375 roperties are su │ │ │ │ -00019af0: 7070 6f72 7465 6420 6279 2061 6c6c 2063 pported by all c │ │ │ │ -00019b00: 6f6d 706f 6e65 6e74 733a 0a27 6c65 6674 omponents:.'left │ │ │ │ -00019b10: 270a 2020 2020 2054 6865 2064 6973 7461 '. The dista │ │ │ │ -00019b20: 6e63 6520 6672 6f6d 2074 6865 206c 6566 nce from the lef │ │ │ │ -00019b30: 7420 626f 7264 6572 206f 6620 636f 6e74 t border of cont │ │ │ │ -00019b40: 6169 6e65 7220 746f 206c 6566 7420 626f ainer to left bo │ │ │ │ -00019b50: 7264 6572 206f 660a 2020 2020 2074 6865 rder of. the │ │ │ │ -00019b60: 206f 626a 6563 7420 696e 2065 6974 6865 object in eithe │ │ │ │ -00019b70: 7220 6f66 2074 6872 6565 2066 6f72 6d61 r of three forma │ │ │ │ -00019b80: 7473 3a0a 2020 2020 2078 2020 2020 2020 ts:. x │ │ │ │ -00019b90: 2020 2020 2020 2020 5661 6c75 6520 696e Value in │ │ │ │ -00019ba0: 2070 6978 656c 730a 2020 2020 2070 2520 pixels. p% │ │ │ │ -00019bb0: 2020 2020 2020 2020 2020 2020 5065 7263 Perc │ │ │ │ -00019bc0: 656e 7461 6765 0a20 2020 2020 7025 2b78 entage. p%+x │ │ │ │ -00019bd0: 2020 2020 2020 2020 2020 206d 6978 7475 mixtu │ │ │ │ -00019be0: 7265 206f 6620 626f 7468 0a27 746f 7027 re of both.'top' │ │ │ │ -00019bf0: 0a20 2020 2020 5468 6520 6469 7374 616e . The distan │ │ │ │ -00019c00: 6365 2066 726f 6d20 7468 6520 6c65 6674 ce from the left │ │ │ │ -00019c10: 2062 6f72 6465 7220 6f66 2063 6f6e 7461 border of conta │ │ │ │ -00019c20: 696e 6572 2074 6f20 6c65 6674 2062 6f72 iner to left bor │ │ │ │ -00019c30: 6465 7220 6f66 0a20 2020 2020 7468 6520 der of. the │ │ │ │ -00019c40: 6f62 6a65 6374 2069 6e20 7361 6d65 2066 object in same f │ │ │ │ -00019c50: 6f72 6d61 742e 0a27 7769 6474 6827 0a20 ormat..'width'. │ │ │ │ -00019c60: 2020 2020 5468 6520 7769 6474 6820 6f66 The width of │ │ │ │ -00019c70: 206f 626a 6563 7420 696e 2073 616d 6520 object in same │ │ │ │ -00019c80: 666f 726d 6174 2e0a 2768 6569 6768 7427 format..'height' │ │ │ │ -00019c90: 0a20 2020 2020 5468 6520 6865 6967 6874 . The height │ │ │ │ -00019ca0: 206f 6620 6f62 6a65 6374 2069 6e20 7361 of object in sa │ │ │ │ -00019cb0: 6d65 2066 6f72 6d61 742e 0a27 6964 270a me format..'id'. │ │ │ │ -00019cc0: 2020 2020 2054 6865 2069 6465 6e74 6966 The identif │ │ │ │ -00019cd0: 6965 7220 666f 7220 7468 6520 636f 6d70 ier for the comp │ │ │ │ -00019ce0: 6f6e 656e 742e 2020 5468 6973 2063 616e onent. This can │ │ │ │ -00019cf0: 2062 6520 616e 7920 6172 6269 7472 6172 be any arbitrar │ │ │ │ -00019d00: 790a 2020 2020 2073 7472 696e 672e 2020 y. string. │ │ │ │ -00019d10: 5468 6520 4944 2063 616e 2062 6520 7573 The ID can be us │ │ │ │ -00019d20: 6564 2062 7920 7363 7269 7074 7320 746f ed by scripts to │ │ │ │ -00019d30: 2072 6566 6572 2074 6f20 7661 7269 6f75 refer to variou │ │ │ │ -00019d40: 730a 2020 2020 2063 6f6d 706f 6e65 6e74 s. component │ │ │ │ -00019d50: 7320 696e 2074 6865 2047 5549 2063 6f6d s in the GUI com │ │ │ │ -00019d60: 706f 6e65 6e74 2074 7265 652e 2020 4375 ponent tree. Cu │ │ │ │ -00019d70: 7272 656e 746c 792c 2074 6865 7265 2069 rrently, there i │ │ │ │ -00019d80: 7320 6f6e 650a 2020 2020 2073 7065 6369 s one. speci │ │ │ │ -00019d90: 616c 2049 4420 7661 6c75 6520 7468 6174 al ID value that │ │ │ │ -00019da0: 2047 5255 4220 7265 636f 676e 697a 6573 GRUB recognizes │ │ │ │ -00019db0: 3a0a 0a20 2020 2020 225f 5f74 696d 656f :.. "__timeo │ │ │ │ -00019dc0: 7574 5f5f 2220 2043 6f6d 706f 6e65 6e74 ut__" Component │ │ │ │ -00019dd0: 2077 6974 6820 7468 6973 2049 4420 7769 with this ID wi │ │ │ │ -00019de0: 6c6c 2062 6520 7570 6461 7465 6420 6279 ll be updated by │ │ │ │ -00019df0: 2047 5255 420a 2020 2020 2020 2020 2020 GRUB. │ │ │ │ -00019e00: 2020 2020 2020 2020 2020 616e 6420 7769 and wi │ │ │ │ -00019e10: 6c6c 2069 6e64 6963 6174 6520 7469 6d65 ll indicate time │ │ │ │ -00019e20: 2065 6c61 7073 6564 2074 6f20 616e 2061 elapsed to an a │ │ │ │ -00019e30: 7574 6f6d 6174 6963 616c 0a20 2020 2020 utomatical. │ │ │ │ -00019e40: 2020 2020 2020 2020 2020 2020 2020 2062 b │ │ │ │ -00019e50: 6f6f 7420 6f66 2074 6865 2064 6566 6175 oot of the defau │ │ │ │ -00019e60: 6c74 2065 6e74 7279 2e20 2041 6666 6563 lt entry. Affec │ │ │ │ -00019e70: 7465 6420 636f 6d70 6f6e 656e 7473 3a0a ted components:. │ │ │ │ -00019e80: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00019e90: 2020 2020 226c 6162 656c 222c 2022 6369 "label", "ci │ │ │ │ -00019ea0: 7263 756c 6172 5f70 726f 6772 6573 7322 rcular_progress" │ │ │ │ -00019eb0: 2c20 2270 726f 6772 6573 735f 6261 7222 , "progress_bar" │ │ │ │ -00019ec0: 2e0a 0a1f 0a46 696c 653a 2067 7275 622e .....File: grub. │ │ │ │ -00019ed0: 696e 666f 2c20 204e 6f64 653a 204e 6574 info, Node: Net │ │ │ │ -00019ee0: 776f 726b 2c20 204e 6578 743a 2053 6572 work, Next: Ser │ │ │ │ -00019ef0: 6961 6c20 7465 726d 696e 616c 2c20 2050 ial terminal, P │ │ │ │ -00019f00: 7265 763a 2054 6865 6d65 2066 696c 6520 rev: Theme file │ │ │ │ -00019f10: 666f 726d 6174 2c20 2055 703a 2054 6f70 format, Up: Top │ │ │ │ -00019f20: 0a0a 3820 426f 6f74 696e 6720 4752 5542 ..8 Booting GRUB │ │ │ │ -00019f30: 2066 726f 6d20 7468 6520 6e65 7477 6f72 from the networ │ │ │ │ -00019f40: 6b0a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a k.************** │ │ │ │ +00019810: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00019820: 2020 206d 656e 752e 0a0a 2020 202a 2063 menu... * c │ │ │ │ +00019830: 616e 7661 7320 4361 6e76 6173 2069 7320 anvas Canvas is │ │ │ │ +00019840: 6120 636f 6e74 6169 6e65 7220 7468 6174 a container that │ │ │ │ +00019850: 2061 6c6c 6f77 7320 6d61 6e75 616c 2070 allows manual p │ │ │ │ +00019860: 6c61 6365 6d65 6e74 206f 660a 2020 2020 lacement of. │ │ │ │ +00019870: 2063 6f6d 706f 6e65 6e74 7320 7769 7468 components with │ │ │ │ +00019880: 696e 2069 742e 2020 4974 2064 6f65 7320 in it. It does │ │ │ │ +00019890: 6e6f 7420 616c 7465 7220 7468 6520 706f not alter the po │ │ │ │ +000198a0: 7369 7469 6f6e 7320 6f66 2069 7473 2063 sitions of its c │ │ │ │ +000198b0: 6869 6c64 0a20 2020 2020 636f 6d70 6f6e hild. compon │ │ │ │ +000198c0: 656e 7473 2e20 2049 7420 6173 7369 676e ents. It assign │ │ │ │ +000198d0: 7320 616c 6c20 6368 696c 6420 636f 6d70 s all child comp │ │ │ │ +000198e0: 6f6e 656e 7473 2074 6865 6972 2070 7265 onents their pre │ │ │ │ +000198f0: 6665 7272 6564 2073 697a 6573 2e0a 0a20 ferred sizes... │ │ │ │ +00019900: 2020 2a20 6862 6f78 2054 6865 202a 6862 * hbox The *hb │ │ │ │ +00019910: 6f78 2a20 636f 6e74 6169 6e65 7220 6c61 ox* container la │ │ │ │ +00019920: 7973 206f 7574 2069 7473 2063 6869 6c64 ys out its child │ │ │ │ +00019930: 7265 6e20 6672 6f6d 206c 6566 7420 746f ren from left to │ │ │ │ +00019940: 2072 6967 6874 2c0a 2020 2020 2067 6976 right,. giv │ │ │ │ +00019950: 696e 6720 6561 6368 206f 6e65 2069 7473 ing each one its │ │ │ │ +00019960: 2070 7265 6665 7272 6564 2077 6964 7468 preferred width │ │ │ │ +00019970: 2e20 2054 6865 2068 6569 6768 7420 6f66 . The height of │ │ │ │ +00019980: 2065 6163 6820 6368 696c 6420 6973 0a20 each child is. │ │ │ │ +00019990: 2020 2020 7365 7420 746f 2074 6865 206d set to the m │ │ │ │ +000199a0: 6178 696d 756d 206f 6620 7468 6520 7072 aximum of the pr │ │ │ │ +000199b0: 6566 6572 7265 6420 6865 6967 6874 7320 eferred heights │ │ │ │ +000199c0: 6f66 2061 6c6c 2063 6869 6c64 7265 6e2e of all children. │ │ │ │ +000199d0: 0a0a 2020 202a 2076 626f 7820 5468 6520 .. * vbox The │ │ │ │ +000199e0: 2a76 626f 782a 2063 6f6e 7461 696e 6572 *vbox* container │ │ │ │ +000199f0: 206c 6179 7320 6f75 7420 6974 7320 6368 lays out its ch │ │ │ │ +00019a00: 696c 6472 656e 2066 726f 6d20 746f 7020 ildren from top │ │ │ │ +00019a10: 746f 2062 6f74 746f 6d2c 0a20 2020 2020 to bottom,. │ │ │ │ +00019a20: 6769 7669 6e67 2065 6163 6820 6f6e 6520 giving each one │ │ │ │ +00019a30: 6974 7320 7072 6566 6572 7265 6420 6865 its preferred he │ │ │ │ +00019a40: 6967 6874 2e20 2054 6865 2077 6964 7468 ight. The width │ │ │ │ +00019a50: 206f 6620 6561 6368 2063 6869 6c64 2069 of each child i │ │ │ │ +00019a60: 730a 2020 2020 2073 6574 2074 6f20 7468 s. set to th │ │ │ │ +00019a70: 6520 6d61 7869 6d75 6d20 6f66 2074 6865 e maximum of the │ │ │ │ +00019a80: 2070 7265 6665 7272 6564 2077 6964 7468 preferred width │ │ │ │ +00019a90: 7320 6f66 2061 6c6c 2063 6869 6c64 7265 s of all childre │ │ │ │ +00019aa0: 6e2e 0a0a 372e 332e 3620 436f 6d6d 6f6e n...7.3.6 Common │ │ │ │ +00019ab0: 2070 726f 7065 7274 6965 730a 2d2d 2d2d properties.---- │ │ │ │ +00019ac0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ +00019ad0: 2d2d 2d0a 0a54 6865 2066 6f6c 6c6f 7769 ---..The followi │ │ │ │ +00019ae0: 6e67 2070 726f 7065 7274 6965 7320 6172 ng properties ar │ │ │ │ +00019af0: 6520 7375 7070 6f72 7465 6420 6279 2061 e supported by a │ │ │ │ +00019b00: 6c6c 2063 6f6d 706f 6e65 6e74 733a 0a27 ll components:.' │ │ │ │ +00019b10: 6c65 6674 270a 2020 2020 2054 6865 2064 left'. The d │ │ │ │ +00019b20: 6973 7461 6e63 6520 6672 6f6d 2074 6865 istance from the │ │ │ │ +00019b30: 206c 6566 7420 626f 7264 6572 206f 6620 left border of │ │ │ │ +00019b40: 636f 6e74 6169 6e65 7220 746f 206c 6566 container to lef │ │ │ │ +00019b50: 7420 626f 7264 6572 206f 660a 2020 2020 t border of. │ │ │ │ +00019b60: 2074 6865 206f 626a 6563 7420 696e 2065 the object in e │ │ │ │ +00019b70: 6974 6865 7220 6f66 2074 6872 6565 2066 ither of three f │ │ │ │ +00019b80: 6f72 6d61 7473 3a0a 2020 2020 2078 2020 ormats:. x │ │ │ │ +00019b90: 2020 2020 2020 2020 2020 2020 5661 6c75 Valu │ │ │ │ +00019ba0: 6520 696e 2070 6978 656c 730a 2020 2020 e in pixels. │ │ │ │ +00019bb0: 2070 2520 2020 2020 2020 2020 2020 2020 p% │ │ │ │ +00019bc0: 5065 7263 656e 7461 6765 0a20 2020 2020 Percentage. │ │ │ │ +00019bd0: 7025 2b78 2020 2020 2020 2020 2020 206d p%+x m │ │ │ │ +00019be0: 6978 7475 7265 206f 6620 626f 7468 0a27 ixture of both.' │ │ │ │ +00019bf0: 746f 7027 0a20 2020 2020 5468 6520 6469 top'. The di │ │ │ │ +00019c00: 7374 616e 6365 2066 726f 6d20 7468 6520 stance from the │ │ │ │ +00019c10: 6c65 6674 2062 6f72 6465 7220 6f66 2063 left border of c │ │ │ │ +00019c20: 6f6e 7461 696e 6572 2074 6f20 6c65 6674 ontainer to left │ │ │ │ +00019c30: 2062 6f72 6465 7220 6f66 0a20 2020 2020 border of. │ │ │ │ +00019c40: 7468 6520 6f62 6a65 6374 2069 6e20 7361 the object in sa │ │ │ │ +00019c50: 6d65 2066 6f72 6d61 742e 0a27 7769 6474 me format..'widt │ │ │ │ +00019c60: 6827 0a20 2020 2020 5468 6520 7769 6474 h'. The widt │ │ │ │ +00019c70: 6820 6f66 206f 626a 6563 7420 696e 2073 h of object in s │ │ │ │ +00019c80: 616d 6520 666f 726d 6174 2e0a 2768 6569 ame format..'hei │ │ │ │ +00019c90: 6768 7427 0a20 2020 2020 5468 6520 6865 ght'. The he │ │ │ │ +00019ca0: 6967 6874 206f 6620 6f62 6a65 6374 2069 ight of object i │ │ │ │ +00019cb0: 6e20 7361 6d65 2066 6f72 6d61 742e 0a27 n same format..' │ │ │ │ +00019cc0: 6964 270a 2020 2020 2054 6865 2069 6465 id'. The ide │ │ │ │ +00019cd0: 6e74 6966 6965 7220 666f 7220 7468 6520 ntifier for the │ │ │ │ +00019ce0: 636f 6d70 6f6e 656e 742e 2020 5468 6973 component. This │ │ │ │ +00019cf0: 2063 616e 2062 6520 616e 7920 6172 6269 can be any arbi │ │ │ │ +00019d00: 7472 6172 790a 2020 2020 2073 7472 696e trary. strin │ │ │ │ +00019d10: 672e 2020 5468 6520 4944 2063 616e 2062 g. The ID can b │ │ │ │ +00019d20: 6520 7573 6564 2062 7920 7363 7269 7074 e used by script │ │ │ │ +00019d30: 7320 746f 2072 6566 6572 2074 6f20 7661 s to refer to va │ │ │ │ +00019d40: 7269 6f75 730a 2020 2020 2063 6f6d 706f rious. compo │ │ │ │ +00019d50: 6e65 6e74 7320 696e 2074 6865 2047 5549 nents in the GUI │ │ │ │ +00019d60: 2063 6f6d 706f 6e65 6e74 2074 7265 652e component tree. │ │ │ │ +00019d70: 2020 4375 7272 656e 746c 792c 2074 6865 Currently, the │ │ │ │ +00019d80: 7265 2069 7320 6f6e 650a 2020 2020 2073 re is one. s │ │ │ │ +00019d90: 7065 6369 616c 2049 4420 7661 6c75 6520 pecial ID value │ │ │ │ +00019da0: 7468 6174 2047 5255 4220 7265 636f 676e that GRUB recogn │ │ │ │ +00019db0: 697a 6573 3a0a 0a20 2020 2020 225f 5f74 izes:.. "__t │ │ │ │ +00019dc0: 696d 656f 7574 5f5f 2220 2043 6f6d 706f imeout__" Compo │ │ │ │ +00019dd0: 6e65 6e74 2077 6974 6820 7468 6973 2049 nent with this I │ │ │ │ +00019de0: 4420 7769 6c6c 2062 6520 7570 6461 7465 D will be update │ │ │ │ +00019df0: 6420 6279 2047 5255 420a 2020 2020 2020 d by GRUB. │ │ │ │ +00019e00: 2020 2020 2020 2020 2020 2020 2020 616e an │ │ │ │ +00019e10: 6420 7769 6c6c 2069 6e64 6963 6174 6520 d will indicate │ │ │ │ +00019e20: 7469 6d65 2065 6c61 7073 6564 2074 6f20 time elapsed to │ │ │ │ +00019e30: 616e 2061 7574 6f6d 6174 6963 616c 0a20 an automatical. │ │ │ │ +00019e40: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00019e50: 2020 2062 6f6f 7420 6f66 2074 6865 2064 boot of the d │ │ │ │ +00019e60: 6566 6175 6c74 2065 6e74 7279 2e20 2041 efault entry. A │ │ │ │ +00019e70: 6666 6563 7465 6420 636f 6d70 6f6e 656e ffected componen │ │ │ │ +00019e80: 7473 3a0a 2020 2020 2020 2020 2020 2020 ts:. │ │ │ │ +00019e90: 2020 2020 2020 2020 226c 6162 656c 222c "label", │ │ │ │ +00019ea0: 2022 6369 7263 756c 6172 5f70 726f 6772 "circular_progr │ │ │ │ +00019eb0: 6573 7322 2c20 2270 726f 6772 6573 735f ess", "progress_ │ │ │ │ +00019ec0: 6261 7222 2e0a 0a1f 0a46 696c 653a 2067 bar".....File: g │ │ │ │ +00019ed0: 7275 622e 696e 666f 2c20 204e 6f64 653a rub.info, Node: │ │ │ │ +00019ee0: 204e 6574 776f 726b 2c20 204e 6578 743a Network, Next: │ │ │ │ +00019ef0: 2053 6572 6961 6c20 7465 726d 696e 616c Serial terminal │ │ │ │ +00019f00: 2c20 2050 7265 763a 2054 6865 6d65 2066 , Prev: Theme f │ │ │ │ +00019f10: 696c 6520 666f 726d 6174 2c20 2055 703a ile format, Up: │ │ │ │ +00019f20: 2054 6f70 0a0a 3820 426f 6f74 696e 6720 Top..8 Booting │ │ │ │ +00019f30: 4752 5542 2066 726f 6d20 7468 6520 6e65 GRUB from the ne │ │ │ │ +00019f40: 7477 6f72 6b0a 2a2a 2a2a 2a2a 2a2a 2a2a twork.********** │ │ │ │ 00019f50: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ -00019f60: 2a0a 0a54 6865 2066 6f6c 6c6f 7769 6e67 *..The following │ │ │ │ -00019f70: 2069 6e73 7472 7563 7469 6f6e 7320 646f instructions do │ │ │ │ -00019f80: 6e27 7420 776f 726b 2066 6f72 202a 2d65 n't work for *-e │ │ │ │ -00019f90: 6d75 2c20 6933 3836 2d71 656d 752c 0a69 mu, i386-qemu,.i │ │ │ │ -00019fa0: 3338 362d 636f 7265 626f 6f74 2c20 6933 386-coreboot, i3 │ │ │ │ -00019fb0: 3836 2d6d 756c 7469 626f 6f74 2c20 6d69 86-multiboot, mi │ │ │ │ -00019fc0: 7073 5f6c 6f6f 6e67 736f 6e2c 206d 6970 ps_loongson, mip │ │ │ │ -00019fd0: 732d 6172 6320 616e 640a 6d69 7073 5f71 s-arc and.mips_q │ │ │ │ -00019fe0: 656d 755f 6d69 7073 0a0a 2020 2054 6f20 emu_mips.. To │ │ │ │ -00019ff0: 6765 6e65 7261 7465 2061 206e 6574 626f generate a netbo │ │ │ │ -0001a000: 6f74 6162 6c65 2064 6972 6563 746f 7279 otable directory │ │ │ │ -0001a010: 2c20 7275 6e3a 0a0a 2020 2020 2067 7275 , run:.. gru │ │ │ │ -0001a020: 622d 6d6b 6e65 7464 6972 202d 2d6e 6574 b-mknetdir --net │ │ │ │ -0001a030: 2d64 6972 6563 746f 7279 3d2f 7372 762f -directory=/srv/ │ │ │ │ -0001a040: 7466 7470 202d 2d73 7562 6469 723d 2f62 tftp --subdir=/b │ │ │ │ -0001a050: 6f6f 742f 6772 7562 202d 6420 2f75 7372 oot/grub -d /usr │ │ │ │ -0001a060: 2f6c 6962 2f67 7275 622f 3c70 6c61 7466 /lib/grub/.. E.g. f │ │ │ │ -0001a080: 6f72 2069 3338 362d 7063 3a0a 0a20 2020 or i386-pc:.. │ │ │ │ -0001a090: 2020 6772 7562 2d6d 6b6e 6574 6469 7220 grub-mknetdir │ │ │ │ -0001a0a0: 2d2d 6e65 742d 6469 7265 6374 6f72 793d --net-directory= │ │ │ │ -0001a0b0: 2f73 7276 2f74 6674 7020 2d2d 7375 6264 /srv/tftp --subd │ │ │ │ -0001a0c0: 6972 3d2f 626f 6f74 2f67 7275 6220 2d64 ir=/boot/grub -d │ │ │ │ -0001a0d0: 202f 7573 722f 6c69 622f 6772 7562 2f69 /usr/lib/grub/i │ │ │ │ -0001a0e0: 3338 362d 7063 0a0a 2020 2054 6865 6e20 386-pc.. Then │ │ │ │ -0001a0f0: 666f 6c6c 6f77 2069 6e73 7472 7563 7469 follow instructi │ │ │ │ -0001a100: 6f6e 7320 7072 696e 7465 6420 6f75 7420 ons printed out │ │ │ │ -0001a110: 6279 2067 7275 622d 6d6b 6e65 7464 6972 by grub-mknetdir │ │ │ │ -0001a120: 206f 6e20 636f 6e66 6967 7572 696e 670a on configuring. │ │ │ │ -0001a130: 796f 7572 2044 4843 5020 7365 7276 6572 your DHCP server │ │ │ │ -0001a140: 2e0a 0a20 2020 4166 7465 7220 4752 5542 ... After GRUB │ │ │ │ -0001a150: 2068 6173 2073 7461 7274 6564 2c20 6669 has started, fi │ │ │ │ -0001a160: 6c65 7320 6f6e 2074 6865 2054 4654 5020 les on the TFTP │ │ │ │ -0001a170: 7365 7276 6572 2077 696c 6c20 6265 2061 server will be a │ │ │ │ -0001a180: 6363 6573 7369 626c 650a 7669 6120 7468 ccessible.via th │ │ │ │ -0001a190: 6520 2728 7466 7470 2927 2064 6576 6963 e '(tftp)' devic │ │ │ │ -0001a1a0: 652e 0a0a 2020 2054 6865 2073 6572 7665 e... The serve │ │ │ │ -0001a1b0: 7220 4950 2061 6464 7265 7373 2063 616e r IP address can │ │ │ │ -0001a1c0: 2062 6520 636f 6e74 726f 6c6c 6564 2062 be controlled b │ │ │ │ -0001a1d0: 7920 6368 616e 6769 6e67 2074 6865 2027 y changing the ' │ │ │ │ -0001a1e0: 2874 6674 7029 270a 6465 7669 6365 206e (tftp)'.device n │ │ │ │ -0001a1f0: 616d 6520 746f 2027 2874 6674 702c 5345 ame to '(tftp,SE │ │ │ │ -0001a200: 5256 4552 2d49 5029 272e 2020 4e6f 7465 RVER-IP)'. Note │ │ │ │ -0001a210: 2074 6861 7420 7468 6973 2073 686f 756c that this shoul │ │ │ │ -0001a220: 6420 6265 2063 6861 6e67 6564 0a62 6f74 d be changed.bot │ │ │ │ -0001a230: 6820 696e 2074 6865 2070 7265 6669 7820 h in the prefix │ │ │ │ -0001a240: 616e 6420 696e 2061 6e79 2072 6566 6572 and in any refer │ │ │ │ -0001a250: 656e 6365 7320 746f 2074 6865 2064 6576 ences to the dev │ │ │ │ -0001a260: 6963 6520 6e61 6d65 2069 6e20 7468 650a ice name in the. │ │ │ │ -0001a270: 636f 6e66 6967 7572 6174 696f 6e20 6669 configuration fi │ │ │ │ -0001a280: 6c65 2e0a 0a20 2020 4752 5542 2070 726f le... GRUB pro │ │ │ │ -0001a290: 7669 6465 7320 7365 7665 7261 6c20 656e vides several en │ │ │ │ -0001a2a0: 7669 726f 6e6d 656e 7420 7661 7269 6162 vironment variab │ │ │ │ -0001a2b0: 6c65 7320 7768 6963 6820 6d61 7920 6265 les which may be │ │ │ │ -0001a2c0: 2075 7365 6420 746f 0a69 6e73 7065 6374 used to.inspect │ │ │ │ -0001a2d0: 206f 7220 6368 616e 6765 2074 6865 2062 or change the b │ │ │ │ -0001a2e0: 6568 6176 696f 7572 206f 6620 7468 6520 ehaviour of the │ │ │ │ -0001a2f0: 5058 4520 6465 7669 6365 2e20 2049 6e20 PXE device. In │ │ │ │ -0001a300: 7468 6520 666f 6c6c 6f77 696e 670a 6465 the following.de │ │ │ │ -0001a310: 7363 7269 7074 696f 6e20 3c49 4e54 4552 scription is placeho │ │ │ │ -0001a330: 6c64 6572 2066 6f72 2074 6865 206e 616d lder for the nam │ │ │ │ -0001a340: 6520 6f66 206e 6574 776f 726b 2069 6e74 e of network int │ │ │ │ -0001a350: 6572 6661 6365 0a28 706c 6174 666f 726d erface.(platform │ │ │ │ -0001a360: 2064 6570 656e 6465 6e74 293a 0a0a 276e dependent):..'n │ │ │ │ -0001a370: 6574 5f3c 494e 5445 5246 4143 453e 5f69 et__i │ │ │ │ -0001a380: 7027 0a20 2020 2020 5468 6520 6e65 7477 p'. The netw │ │ │ │ -0001a390: 6f72 6b20 696e 7465 7266 6163 6527 7320 ork interface's │ │ │ │ -0001a3a0: 4950 2061 6464 7265 7373 2e20 2052 6561 IP address. Rea │ │ │ │ -0001a3b0: 642d 6f6e 6c79 2e0a 0a27 6e65 745f 3c49 d-only...'net__mac'. │ │ │ │ -0001a3d0: 2020 2020 5468 6520 6e65 7477 6f72 6b20 The network │ │ │ │ -0001a3e0: 696e 7465 7266 6163 6527 7320 4d41 4320 interface's MAC │ │ │ │ -0001a3f0: 6164 6472 6573 732e 2020 5265 6164 2d6f address. Read-o │ │ │ │ -0001a400: 6e6c 792e 0a0a 276e 6574 5f3c 494e 5445 nly...'net__hostname' │ │ │ │ -0001a420: 0a20 2020 2020 5468 6520 636c 6965 6e74 . The client │ │ │ │ -0001a430: 2068 6f73 7420 6e61 6d65 2070 726f 7669 host name provi │ │ │ │ -0001a440: 6465 6420 6279 2044 4843 502e 2052 6561 ded by DHCP. Rea │ │ │ │ -0001a450: 642d 6f6e 6c79 2e0a 0a27 6e65 745f 3c49 d-only...'net__domain │ │ │ │ -0001a470: 270a 2020 2020 2054 6865 2063 6c69 656e '. The clien │ │ │ │ -0001a480: 7420 646f 6d61 696e 206e 616d 6520 7072 t domain name pr │ │ │ │ -0001a490: 6f76 6964 6564 2062 7920 4448 4350 2e20 ovided by DHCP. │ │ │ │ -0001a4a0: 5265 6164 2d6f 6e6c 792e 0a0a 276e 6574 Read-only...'net │ │ │ │ -0001a4b0: 5f3c 494e 5445 5246 4143 453e 5f72 6f6f __roo │ │ │ │ -0001a4c0: 7470 6174 6827 0a20 2020 2020 5468 6520 tpath'. The │ │ │ │ -0001a4d0: 7061 7468 2074 6f20 7468 6520 636c 6965 path to the clie │ │ │ │ -0001a4e0: 6e74 2773 2072 6f6f 7420 6469 736b 2070 nt's root disk p │ │ │ │ -0001a4f0: 726f 7669 6465 6420 6279 2044 4843 502e rovided by DHCP. │ │ │ │ -0001a500: 2052 6561 642d 6f6e 6c79 2e0a 0a27 6e65 Read-only...'ne │ │ │ │ -0001a510: 745f 3c49 4e54 4552 4641 4345 3e5f 6578 t__ex │ │ │ │ -0001a520: 7465 6e73 696f 6e73 7061 7468 270a 2020 tensionspath'. │ │ │ │ -0001a530: 2020 2054 6865 2070 6174 6820 746f 2061 The path to a │ │ │ │ -0001a540: 6464 6974 696f 6e61 6c20 4448 4350 2076 dditional DHCP v │ │ │ │ -0001a550: 656e 646f 7220 6578 7465 6e73 696f 6e73 endor extensions │ │ │ │ -0001a560: 2070 726f 7669 6465 6420 6279 2044 4843 provided by DHC │ │ │ │ -0001a570: 502e 0a20 2020 2020 5265 6164 2d6f 6e6c P.. Read-onl │ │ │ │ -0001a580: 792e 0a0a 276e 6574 5f3c 494e 5445 5246 y...'net__boot_file'. │ │ │ │ -0001a5a0: 2020 2020 2054 6865 2062 6f6f 7420 6669 The boot fi │ │ │ │ -0001a5b0: 6c65 206e 616d 6520 7072 6f76 6964 6564 le name provided │ │ │ │ -0001a5c0: 2062 7920 4448 4350 2e20 5265 6164 2d6f by DHCP. Read-o │ │ │ │ -0001a5d0: 6e6c 792e 0a0a 276e 6574 5f3c 494e 5445 nly...'net__dhcp_serv │ │ │ │ -0001a5f0: 6572 5f6e 616d 6527 0a20 2020 2020 5468 er_name'. Th │ │ │ │ -0001a600: 6520 6e61 6d65 206f 6620 7468 6520 4448 e name of the DH │ │ │ │ -0001a610: 4350 2073 6572 7665 7220 7265 7370 6f6e CP server respon │ │ │ │ -0001a620: 7369 626c 6520 666f 7220 7468 6573 6520 sible for these │ │ │ │ -0001a630: 626f 6f74 2070 6172 616d 6574 6572 732e boot parameters. │ │ │ │ -0001a640: 0a20 2020 2020 5265 6164 2d6f 6e6c 792e . Read-only. │ │ │ │ -0001a650: 0a0a 276e 6574 5f3c 494e 5445 5246 4143 ..'net__next_server'. │ │ │ │ -0001a670: 2020 2020 2054 6865 2049 5020 6164 6472 The IP addr │ │ │ │ -0001a680: 6573 7320 6f66 2074 6865 206e 6578 7420 ess of the next │ │ │ │ -0001a690: 2875 7375 616c 6c79 2c20 5446 5450 2920 (usually, TFTP) │ │ │ │ -0001a6a0: 7365 7276 6572 2070 726f 7669 6465 6420 server provided │ │ │ │ -0001a6b0: 6279 2044 4843 502e 0a20 2020 2020 5265 by DHCP.. Re │ │ │ │ -0001a6c0: 6164 2d6f 6e6c 792e 0a0a 276e 6574 5f64 ad-only...'net_d │ │ │ │ -0001a6d0: 6566 6175 6c74 5f69 6e74 6572 6661 6365 efault_interface │ │ │ │ -0001a6e0: 270a 2020 2020 2049 6e69 7469 616c 6c79 '. Initially │ │ │ │ -0001a6f0: 2073 6574 2074 6f20 6e61 6d65 206f 6620 set to name of │ │ │ │ -0001a700: 6e65 7477 6f72 6b20 696e 7465 7266 6163 network interfac │ │ │ │ -0001a710: 6520 7468 6174 2077 6173 2075 7365 6420 e that was used │ │ │ │ -0001a720: 746f 206c 6f61 640a 2020 2020 2067 7275 to load. gru │ │ │ │ -0001a730: 622e 2020 5265 6164 2d77 7269 7465 2c20 b. Read-write, │ │ │ │ -0001a740: 616c 7468 6f75 6768 2073 6574 7469 6e67 although setting │ │ │ │ -0001a750: 2069 7420 6166 6665 6374 7320 6f6e 6c79 it affects only │ │ │ │ -0001a760: 2069 6e74 6572 7072 6574 6174 696f 6e0a interpretation. │ │ │ │ -0001a770: 2020 2020 206f 6620 276e 6574 5f64 6566 of 'net_def │ │ │ │ -0001a780: 6175 6c74 5f69 7027 2061 6e64 2027 6e65 ault_ip' and 'ne │ │ │ │ -0001a790: 745f 6465 6661 756c 745f 6d61 6327 0a0a t_default_mac'.. │ │ │ │ -0001a7a0: 276e 6574 5f64 6566 6175 6c74 5f69 7027 'net_default_ip' │ │ │ │ -0001a7b0: 0a20 2020 2020 5468 6520 4950 2061 6464 . The IP add │ │ │ │ -0001a7c0: 7265 7373 206f 6620 6465 6661 756c 7420 ress of default │ │ │ │ -0001a7d0: 696e 7465 7266 6163 652e 2020 5265 6164 interface. Read │ │ │ │ -0001a7e0: 2d6f 6e6c 792e 2020 5468 6973 2069 7320 -only. This is │ │ │ │ -0001a7f0: 616c 6961 7320 666f 720a 2020 2020 2074 alias for. t │ │ │ │ -0001a800: 6865 2027 6e65 745f 247b 6e65 745f 6465 he 'net_${net_de │ │ │ │ -0001a810: 6661 756c 745f 696e 7465 7266 6163 657d fault_interface} │ │ │ │ -0001a820: 5f69 7027 2e0a 0a27 6e65 745f 6465 6661 _ip'...'net_defa │ │ │ │ -0001a830: 756c 745f 6d61 6327 0a20 2020 2020 5468 ult_mac'. Th │ │ │ │ -0001a840: 6520 6465 6661 756c 7420 696e 7465 7266 e default interf │ │ │ │ -0001a850: 6163 6527 7320 4d41 4320 6164 6472 6573 ace's MAC addres │ │ │ │ -0001a860: 732e 2020 5265 6164 2d6f 6e6c 792e 2020 s. Read-only. │ │ │ │ -0001a870: 5468 6973 2069 7320 616c 6961 7320 666f This is alias fo │ │ │ │ -0001a880: 720a 2020 2020 2074 6865 2027 6e65 745f r. the 'net_ │ │ │ │ -0001a890: 247b 6e65 745f 6465 6661 756c 745f 696e ${net_default_in │ │ │ │ -0001a8a0: 7465 7266 6163 657d 5f6d 6163 272e 0a0a terface}_mac'... │ │ │ │ -0001a8b0: 276e 6574 5f64 6566 6175 6c74 5f73 6572 'net_default_ser │ │ │ │ -0001a8c0: 7665 7227 0a20 2020 2020 5468 6520 6465 ver'. The de │ │ │ │ -0001a8d0: 6661 756c 7420 7365 7276 6572 2075 7365 fault server use │ │ │ │ -0001a8e0: 6420 6279 206e 6574 776f 726b 2064 7269 d by network dri │ │ │ │ -0001a8f0: 7665 7320 282a 6e6f 7465 2044 6576 6963 ves (*note Devic │ │ │ │ -0001a900: 6520 7379 6e74 6178 3a3a 292e 0a20 2020 e syntax::).. │ │ │ │ -0001a910: 2020 5265 6164 2d77 7269 7465 2c20 616c Read-write, al │ │ │ │ -0001a920: 7468 6f75 6768 2073 6574 7469 6e67 2074 though setting t │ │ │ │ -0001a930: 6869 7320 6973 206f 6e6c 7920 7573 6566 his is only usef │ │ │ │ -0001a940: 756c 2062 6566 6f72 6520 6f70 656e 696e ul before openin │ │ │ │ -0001a950: 6720 610a 2020 2020 206e 6574 776f 726b g a. network │ │ │ │ -0001a960: 2064 6576 6963 652e 0a0a 1f0a 4669 6c65 device.....File │ │ │ │ -0001a970: 3a20 6772 7562 2e69 6e66 6f2c 2020 4e6f : grub.info, No │ │ │ │ -0001a980: 6465 3a20 5365 7269 616c 2074 6572 6d69 de: Serial termi │ │ │ │ -0001a990: 6e61 6c2c 2020 4e65 7874 3a20 5665 6e64 nal, Next: Vend │ │ │ │ -0001a9a0: 6f72 2070 6f77 6572 2d6f 6e20 6b65 7973 or power-on keys │ │ │ │ -0001a9b0: 2c20 2050 7265 763a 204e 6574 776f 726b , Prev: Network │ │ │ │ -0001a9c0: 2c20 2055 703a 2054 6f70 0a0a 3920 5573 , Up: Top..9 Us │ │ │ │ -0001a9d0: 696e 6720 4752 5542 2076 6961 2061 2073 ing GRUB via a s │ │ │ │ -0001a9e0: 6572 6961 6c20 6c69 6e65 0a2a 2a2a 2a2a erial line.***** │ │ │ │ +00019f60: 2a2a 2a2a 2a0a 0a54 6865 2066 6f6c 6c6f *****..The follo │ │ │ │ +00019f70: 7769 6e67 2069 6e73 7472 7563 7469 6f6e wing instruction │ │ │ │ +00019f80: 7320 646f 6e27 7420 776f 726b 2066 6f72 s don't work for │ │ │ │ +00019f90: 202a 2d65 6d75 2c20 6933 3836 2d71 656d *-emu, i386-qem │ │ │ │ +00019fa0: 752c 0a69 3338 362d 636f 7265 626f 6f74 u,.i386-coreboot │ │ │ │ +00019fb0: 2c20 6933 3836 2d6d 756c 7469 626f 6f74 , i386-multiboot │ │ │ │ +00019fc0: 2c20 6d69 7073 5f6c 6f6f 6e67 736f 6e2c , mips_loongson, │ │ │ │ +00019fd0: 206d 6970 732d 6172 6320 616e 640a 6d69 mips-arc and.mi │ │ │ │ +00019fe0: 7073 5f71 656d 755f 6d69 7073 0a0a 2020 ps_qemu_mips.. │ │ │ │ +00019ff0: 2054 6f20 6765 6e65 7261 7465 2061 206e To generate a n │ │ │ │ +0001a000: 6574 626f 6f74 6162 6c65 2064 6972 6563 etbootable direc │ │ │ │ +0001a010: 746f 7279 2c20 7275 6e3a 0a0a 2020 2020 tory, run:.. │ │ │ │ +0001a020: 2067 7275 622d 6d6b 6e65 7464 6972 202d grub-mknetdir - │ │ │ │ +0001a030: 2d6e 6574 2d64 6972 6563 746f 7279 3d2f -net-directory=/ │ │ │ │ +0001a040: 7372 762f 7466 7470 202d 2d73 7562 6469 srv/tftp --subdi │ │ │ │ +0001a050: 723d 2f62 6f6f 742f 6772 7562 202d 6420 r=/boot/grub -d │ │ │ │ +0001a060: 2f75 7372 2f6c 6962 2f67 7275 622f 3c70 /usr/lib/grub/

.. E.g │ │ │ │ +0001a080: 2e20 2066 6f72 2069 3338 362d 7063 3a0a . for i386-pc:. │ │ │ │ +0001a090: 0a20 2020 2020 6772 7562 2d6d 6b6e 6574 . grub-mknet │ │ │ │ +0001a0a0: 6469 7220 2d2d 6e65 742d 6469 7265 6374 dir --net-direct │ │ │ │ +0001a0b0: 6f72 793d 2f73 7276 2f74 6674 7020 2d2d ory=/srv/tftp -- │ │ │ │ +0001a0c0: 7375 6264 6972 3d2f 626f 6f74 2f67 7275 subdir=/boot/gru │ │ │ │ +0001a0d0: 6220 2d64 202f 7573 722f 6c69 622f 6772 b -d /usr/lib/gr │ │ │ │ +0001a0e0: 7562 2f69 3338 362d 7063 0a0a 2020 2054 ub/i386-pc.. T │ │ │ │ +0001a0f0: 6865 6e20 666f 6c6c 6f77 2069 6e73 7472 hen follow instr │ │ │ │ +0001a100: 7563 7469 6f6e 7320 7072 696e 7465 6420 uctions printed │ │ │ │ +0001a110: 6f75 7420 6279 2067 7275 622d 6d6b 6e65 out by grub-mkne │ │ │ │ +0001a120: 7464 6972 206f 6e20 636f 6e66 6967 7572 tdir on configur │ │ │ │ +0001a130: 696e 670a 796f 7572 2044 4843 5020 7365 ing.your DHCP se │ │ │ │ +0001a140: 7276 6572 2e0a 0a20 2020 4166 7465 7220 rver... After │ │ │ │ +0001a150: 4752 5542 2068 6173 2073 7461 7274 6564 GRUB has started │ │ │ │ +0001a160: 2c20 6669 6c65 7320 6f6e 2074 6865 2054 , files on the T │ │ │ │ +0001a170: 4654 5020 7365 7276 6572 2077 696c 6c20 FTP server will │ │ │ │ +0001a180: 6265 2061 6363 6573 7369 626c 650a 7669 be accessible.vi │ │ │ │ +0001a190: 6120 7468 6520 2728 7466 7470 2927 2064 a the '(tftp)' d │ │ │ │ +0001a1a0: 6576 6963 652e 0a0a 2020 2054 6865 2073 evice... The s │ │ │ │ +0001a1b0: 6572 7665 7220 4950 2061 6464 7265 7373 erver IP address │ │ │ │ +0001a1c0: 2063 616e 2062 6520 636f 6e74 726f 6c6c can be controll │ │ │ │ +0001a1d0: 6564 2062 7920 6368 616e 6769 6e67 2074 ed by changing t │ │ │ │ +0001a1e0: 6865 2027 2874 6674 7029 270a 6465 7669 he '(tftp)'.devi │ │ │ │ +0001a1f0: 6365 206e 616d 6520 746f 2027 2874 6674 ce name to '(tft │ │ │ │ +0001a200: 702c 5345 5256 4552 2d49 5029 272e 2020 p,SERVER-IP)'. │ │ │ │ +0001a210: 4e6f 7465 2074 6861 7420 7468 6973 2073 Note that this s │ │ │ │ +0001a220: 686f 756c 6420 6265 2063 6861 6e67 6564 hould be changed │ │ │ │ +0001a230: 0a62 6f74 6820 696e 2074 6865 2070 7265 .both in the pre │ │ │ │ +0001a240: 6669 7820 616e 6420 696e 2061 6e79 2072 fix and in any r │ │ │ │ +0001a250: 6566 6572 656e 6365 7320 746f 2074 6865 eferences to the │ │ │ │ +0001a260: 2064 6576 6963 6520 6e61 6d65 2069 6e20 device name in │ │ │ │ +0001a270: 7468 650a 636f 6e66 6967 7572 6174 696f the.configuratio │ │ │ │ +0001a280: 6e20 6669 6c65 2e0a 0a20 2020 4752 5542 n file... GRUB │ │ │ │ +0001a290: 2070 726f 7669 6465 7320 7365 7665 7261 provides severa │ │ │ │ +0001a2a0: 6c20 656e 7669 726f 6e6d 656e 7420 7661 l environment va │ │ │ │ +0001a2b0: 7269 6162 6c65 7320 7768 6963 6820 6d61 riables which ma │ │ │ │ +0001a2c0: 7920 6265 2075 7365 6420 746f 0a69 6e73 y be used to.ins │ │ │ │ +0001a2d0: 7065 6374 206f 7220 6368 616e 6765 2074 pect or change t │ │ │ │ +0001a2e0: 6865 2062 6568 6176 696f 7572 206f 6620 he behaviour of │ │ │ │ +0001a2f0: 7468 6520 5058 4520 6465 7669 6365 2e20 the PXE device. │ │ │ │ +0001a300: 2049 6e20 7468 6520 666f 6c6c 6f77 696e In the followin │ │ │ │ +0001a310: 670a 6465 7363 7269 7074 696f 6e20 3c49 g.description is pla │ │ │ │ +0001a330: 6365 686f 6c64 6572 2066 6f72 2074 6865 ceholder for the │ │ │ │ +0001a340: 206e 616d 6520 6f66 206e 6574 776f 726b name of network │ │ │ │ +0001a350: 2069 6e74 6572 6661 6365 0a28 706c 6174 interface.(plat │ │ │ │ +0001a360: 666f 726d 2064 6570 656e 6465 6e74 293a form dependent): │ │ │ │ +0001a370: 0a0a 276e 6574 5f3c 494e 5445 5246 4143 ..'net__ip'. The │ │ │ │ +0001a390: 6e65 7477 6f72 6b20 696e 7465 7266 6163 network interfac │ │ │ │ +0001a3a0: 6527 7320 4950 2061 6464 7265 7373 2e20 e's IP address. │ │ │ │ +0001a3b0: 2052 6561 642d 6f6e 6c79 2e0a 0a27 6e65 Read-only...'ne │ │ │ │ +0001a3c0: 745f 3c49 4e54 4552 4641 4345 3e5f 6d61 t__ma │ │ │ │ +0001a3d0: 6327 0a20 2020 2020 5468 6520 6e65 7477 c'. The netw │ │ │ │ +0001a3e0: 6f72 6b20 696e 7465 7266 6163 6527 7320 ork interface's │ │ │ │ +0001a3f0: 4d41 4320 6164 6472 6573 732e 2020 5265 MAC address. Re │ │ │ │ +0001a400: 6164 2d6f 6e6c 792e 0a0a 276e 6574 5f3c ad-only...'net_< │ │ │ │ +0001a410: 494e 5445 5246 4143 453e 5f68 6f73 746e INTERFACE>_hostn │ │ │ │ +0001a420: 616d 6527 0a20 2020 2020 5468 6520 636c ame'. The cl │ │ │ │ +0001a430: 6965 6e74 2068 6f73 7420 6e61 6d65 2070 ient host name p │ │ │ │ +0001a440: 726f 7669 6465 6420 6279 2044 4843 502e rovided by DHCP. │ │ │ │ +0001a450: 2052 6561 642d 6f6e 6c79 2e0a 0a27 6e65 Read-only...'ne │ │ │ │ +0001a460: 745f 3c49 4e54 4552 4641 4345 3e5f 646f t__do │ │ │ │ +0001a470: 6d61 696e 270a 2020 2020 2054 6865 2063 main'. The c │ │ │ │ +0001a480: 6c69 656e 7420 646f 6d61 696e 206e 616d lient domain nam │ │ │ │ +0001a490: 6520 7072 6f76 6964 6564 2062 7920 4448 e provided by DH │ │ │ │ +0001a4a0: 4350 2e20 5265 6164 2d6f 6e6c 792e 0a0a CP. Read-only... │ │ │ │ +0001a4b0: 276e 6574 5f3c 494e 5445 5246 4143 453e 'net_ │ │ │ │ +0001a4c0: 5f72 6f6f 7470 6174 6827 0a20 2020 2020 _rootpath'. │ │ │ │ +0001a4d0: 5468 6520 7061 7468 2074 6f20 7468 6520 The path to the │ │ │ │ +0001a4e0: 636c 6965 6e74 2773 2072 6f6f 7420 6469 client's root di │ │ │ │ +0001a4f0: 736b 2070 726f 7669 6465 6420 6279 2044 sk provided by D │ │ │ │ +0001a500: 4843 502e 2052 6561 642d 6f6e 6c79 2e0a HCP. Read-only.. │ │ │ │ +0001a510: 0a27 6e65 745f 3c49 4e54 4552 4641 4345 .'net__extensionspath │ │ │ │ +0001a530: 270a 2020 2020 2054 6865 2070 6174 6820 '. The path │ │ │ │ +0001a540: 746f 2061 6464 6974 696f 6e61 6c20 4448 to additional DH │ │ │ │ +0001a550: 4350 2076 656e 646f 7220 6578 7465 6e73 CP vendor extens │ │ │ │ +0001a560: 696f 6e73 2070 726f 7669 6465 6420 6279 ions provided by │ │ │ │ +0001a570: 2044 4843 502e 0a20 2020 2020 5265 6164 DHCP.. Read │ │ │ │ +0001a580: 2d6f 6e6c 792e 0a0a 276e 6574 5f3c 494e -only...'net__boot_fi │ │ │ │ +0001a5a0: 6c65 270a 2020 2020 2054 6865 2062 6f6f le'. The boo │ │ │ │ +0001a5b0: 7420 6669 6c65 206e 616d 6520 7072 6f76 t file name prov │ │ │ │ +0001a5c0: 6964 6564 2062 7920 4448 4350 2e20 5265 ided by DHCP. Re │ │ │ │ +0001a5d0: 6164 2d6f 6e6c 792e 0a0a 276e 6574 5f3c ad-only...'net_< │ │ │ │ +0001a5e0: 494e 5445 5246 4143 453e 5f64 6863 705f INTERFACE>_dhcp_ │ │ │ │ +0001a5f0: 7365 7276 6572 5f6e 616d 6527 0a20 2020 server_name'. │ │ │ │ +0001a600: 2020 5468 6520 6e61 6d65 206f 6620 7468 The name of th │ │ │ │ +0001a610: 6520 4448 4350 2073 6572 7665 7220 7265 e DHCP server re │ │ │ │ +0001a620: 7370 6f6e 7369 626c 6520 666f 7220 7468 sponsible for th │ │ │ │ +0001a630: 6573 6520 626f 6f74 2070 6172 616d 6574 ese boot paramet │ │ │ │ +0001a640: 6572 732e 0a20 2020 2020 5265 6164 2d6f ers.. Read-o │ │ │ │ +0001a650: 6e6c 792e 0a0a 276e 6574 5f3c 494e 5445 nly...'net__next_serv │ │ │ │ +0001a670: 6572 270a 2020 2020 2054 6865 2049 5020 er'. The IP │ │ │ │ +0001a680: 6164 6472 6573 7320 6f66 2074 6865 206e address of the n │ │ │ │ +0001a690: 6578 7420 2875 7375 616c 6c79 2c20 5446 ext (usually, TF │ │ │ │ +0001a6a0: 5450 2920 7365 7276 6572 2070 726f 7669 TP) server provi │ │ │ │ +0001a6b0: 6465 6420 6279 2044 4843 502e 0a20 2020 ded by DHCP.. │ │ │ │ +0001a6c0: 2020 5265 6164 2d6f 6e6c 792e 0a0a 276e Read-only...'n │ │ │ │ +0001a6d0: 6574 5f64 6566 6175 6c74 5f69 6e74 6572 et_default_inter │ │ │ │ +0001a6e0: 6661 6365 270a 2020 2020 2049 6e69 7469 face'. Initi │ │ │ │ +0001a6f0: 616c 6c79 2073 6574 2074 6f20 6e61 6d65 ally set to name │ │ │ │ +0001a700: 206f 6620 6e65 7477 6f72 6b20 696e 7465 of network inte │ │ │ │ +0001a710: 7266 6163 6520 7468 6174 2077 6173 2075 rface that was u │ │ │ │ +0001a720: 7365 6420 746f 206c 6f61 640a 2020 2020 sed to load. │ │ │ │ +0001a730: 2067 7275 622e 2020 5265 6164 2d77 7269 grub. Read-wri │ │ │ │ +0001a740: 7465 2c20 616c 7468 6f75 6768 2073 6574 te, although set │ │ │ │ +0001a750: 7469 6e67 2069 7420 6166 6665 6374 7320 ting it affects │ │ │ │ +0001a760: 6f6e 6c79 2069 6e74 6572 7072 6574 6174 only interpretat │ │ │ │ +0001a770: 696f 6e0a 2020 2020 206f 6620 276e 6574 ion. of 'net │ │ │ │ +0001a780: 5f64 6566 6175 6c74 5f69 7027 2061 6e64 _default_ip' and │ │ │ │ +0001a790: 2027 6e65 745f 6465 6661 756c 745f 6d61 'net_default_ma │ │ │ │ +0001a7a0: 6327 0a0a 276e 6574 5f64 6566 6175 6c74 c'..'net_default │ │ │ │ +0001a7b0: 5f69 7027 0a20 2020 2020 5468 6520 4950 _ip'. The IP │ │ │ │ +0001a7c0: 2061 6464 7265 7373 206f 6620 6465 6661 address of defa │ │ │ │ +0001a7d0: 756c 7420 696e 7465 7266 6163 652e 2020 ult interface. │ │ │ │ +0001a7e0: 5265 6164 2d6f 6e6c 792e 2020 5468 6973 Read-only. This │ │ │ │ +0001a7f0: 2069 7320 616c 6961 7320 666f 720a 2020 is alias for. │ │ │ │ +0001a800: 2020 2074 6865 2027 6e65 745f 247b 6e65 the 'net_${ne │ │ │ │ +0001a810: 745f 6465 6661 756c 745f 696e 7465 7266 t_default_interf │ │ │ │ +0001a820: 6163 657d 5f69 7027 2e0a 0a27 6e65 745f ace}_ip'...'net_ │ │ │ │ +0001a830: 6465 6661 756c 745f 6d61 6327 0a20 2020 default_mac'. │ │ │ │ +0001a840: 2020 5468 6520 6465 6661 756c 7420 696e The default in │ │ │ │ +0001a850: 7465 7266 6163 6527 7320 4d41 4320 6164 terface's MAC ad │ │ │ │ +0001a860: 6472 6573 732e 2020 5265 6164 2d6f 6e6c dress. Read-onl │ │ │ │ +0001a870: 792e 2020 5468 6973 2069 7320 616c 6961 y. This is alia │ │ │ │ +0001a880: 7320 666f 720a 2020 2020 2074 6865 2027 s for. the ' │ │ │ │ +0001a890: 6e65 745f 247b 6e65 745f 6465 6661 756c net_${net_defaul │ │ │ │ +0001a8a0: 745f 696e 7465 7266 6163 657d 5f6d 6163 t_interface}_mac │ │ │ │ +0001a8b0: 272e 0a0a 276e 6574 5f64 6566 6175 6c74 '...'net_default │ │ │ │ +0001a8c0: 5f73 6572 7665 7227 0a20 2020 2020 5468 _server'. Th │ │ │ │ +0001a8d0: 6520 6465 6661 756c 7420 7365 7276 6572 e default server │ │ │ │ +0001a8e0: 2075 7365 6420 6279 206e 6574 776f 726b used by network │ │ │ │ +0001a8f0: 2064 7269 7665 7320 282a 6e6f 7465 2044 drives (*note D │ │ │ │ +0001a900: 6576 6963 6520 7379 6e74 6178 3a3a 292e evice syntax::). │ │ │ │ +0001a910: 0a20 2020 2020 5265 6164 2d77 7269 7465 . Read-write │ │ │ │ +0001a920: 2c20 616c 7468 6f75 6768 2073 6574 7469 , although setti │ │ │ │ +0001a930: 6e67 2074 6869 7320 6973 206f 6e6c 7920 ng this is only │ │ │ │ +0001a940: 7573 6566 756c 2062 6566 6f72 6520 6f70 useful before op │ │ │ │ +0001a950: 656e 696e 6720 610a 2020 2020 206e 6574 ening a. net │ │ │ │ +0001a960: 776f 726b 2064 6576 6963 652e 0a0a 1f0a work device..... │ │ │ │ +0001a970: 4669 6c65 3a20 6772 7562 2e69 6e66 6f2c File: grub.info, │ │ │ │ +0001a980: 2020 4e6f 6465 3a20 5365 7269 616c 2074 Node: Serial t │ │ │ │ +0001a990: 6572 6d69 6e61 6c2c 2020 4e65 7874 3a20 erminal, Next: │ │ │ │ +0001a9a0: 5665 6e64 6f72 2070 6f77 6572 2d6f 6e20 Vendor power-on │ │ │ │ +0001a9b0: 6b65 7973 2c20 2050 7265 763a 204e 6574 keys, Prev: Net │ │ │ │ +0001a9c0: 776f 726b 2c20 2055 703a 2054 6f70 0a0a work, Up: Top.. │ │ │ │ +0001a9d0: 3920 5573 696e 6720 4752 5542 2076 6961 9 Using GRUB via │ │ │ │ +0001a9e0: 2061 2073 6572 6961 6c20 6c69 6e65 0a2a a serial line.* │ │ │ │ 0001a9f0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ -0001aa00: 2a2a 2a2a 2a2a 2a2a 2a0a 0a54 6869 7320 *********..This │ │ │ │ -0001aa10: 6368 6170 7465 7220 6465 7363 7269 6265 chapter describe │ │ │ │ -0001aa20: 7320 686f 7720 746f 2075 7365 2074 6865 s how to use the │ │ │ │ -0001aa30: 2073 6572 6961 6c20 7465 726d 696e 616c serial terminal │ │ │ │ -0001aa40: 2073 7570 706f 7274 2069 6e20 4752 5542 support in GRUB │ │ │ │ -0001aa50: 2e0a 0a20 2020 4966 2079 6f75 2068 6176 ... If you hav │ │ │ │ -0001aa60: 6520 6d61 6e79 2063 6f6d 7075 7465 7273 e many computers │ │ │ │ -0001aa70: 206f 7220 636f 6d70 7574 6572 7320 7769 or computers wi │ │ │ │ -0001aa80: 7468 206e 6f20 6469 7370 6c61 792f 6b65 th no display/ke │ │ │ │ -0001aa90: 7962 6f61 7264 2c20 6974 0a63 6f75 6c64 yboard, it.could │ │ │ │ -0001aaa0: 2062 6520 7665 7279 2075 7365 6675 6c20 be very useful │ │ │ │ -0001aab0: 746f 2063 6f6e 7472 6f6c 2074 6865 2063 to control the c │ │ │ │ -0001aac0: 6f6d 7075 7465 7273 2074 6872 6f75 6768 omputers through │ │ │ │ -0001aad0: 2073 6572 6961 6c0a 636f 6d6d 756e 6963 serial.communic │ │ │ │ -0001aae0: 6174 696f 6e73 2e20 2054 6f20 636f 6e6e ations. To conn │ │ │ │ -0001aaf0: 6563 7420 6f6e 6520 636f 6d70 7574 6572 ect one computer │ │ │ │ -0001ab00: 2077 6974 6820 616e 6f74 6865 7220 7669 with another vi │ │ │ │ -0001ab10: 6120 6120 7365 7269 616c 206c 696e 652c a a serial line, │ │ │ │ -0001ab20: 0a79 6f75 206e 6565 6420 746f 2070 7265 .you need to pre │ │ │ │ -0001ab30: 7061 7265 2061 206e 756c 6c2d 6d6f 6465 pare a null-mode │ │ │ │ -0001ab40: 6d20 2863 726f 7373 2920 7365 7269 616c m (cross) serial │ │ │ │ -0001ab50: 2063 6162 6c65 2c20 616e 6420 796f 7520 cable, and you │ │ │ │ -0001ab60: 6d61 7920 6e65 6564 0a74 6f20 6861 7665 may need.to have │ │ │ │ -0001ab70: 206d 756c 7469 706f 7274 2073 6572 6961 multiport seria │ │ │ │ -0001ab80: 6c20 626f 6172 6473 2c20 6966 2079 6f75 l boards, if you │ │ │ │ -0001ab90: 7220 636f 6d70 7574 6572 2064 6f65 736e r computer doesn │ │ │ │ -0001aba0: 2774 2068 6176 6520 6578 7472 610a 7365 't have extra.se │ │ │ │ -0001abb0: 7269 616c 2070 6f72 7473 2e20 2049 6e20 rial ports. In │ │ │ │ -0001abc0: 6164 6469 7469 6f6e 2c20 6120 7465 726d addition, a term │ │ │ │ -0001abd0: 696e 616c 2065 6d75 6c61 746f 7220 6973 inal emulator is │ │ │ │ -0001abe0: 2061 6c73 6f20 7265 7175 6972 6564 2c20 also required, │ │ │ │ -0001abf0: 7375 6368 0a61 7320 6d69 6e69 636f 6d2e such.as minicom. │ │ │ │ -0001ac00: 2020 5265 6665 7220 746f 2061 206d 616e Refer to a man │ │ │ │ -0001ac10: 7561 6c20 6f66 2079 6f75 7220 6f70 6572 ual of your oper │ │ │ │ -0001ac20: 6174 696e 6720 7379 7374 656d 2c20 666f ating system, fo │ │ │ │ -0001ac30: 7220 6d6f 7265 0a69 6e66 6f72 6d61 7469 r more.informati │ │ │ │ -0001ac40: 6f6e 2e0a 0a20 2020 4173 2066 6f72 2047 on... As for G │ │ │ │ -0001ac50: 5255 422c 2074 6865 2069 6e73 7472 7563 RUB, the instruc │ │ │ │ -0001ac60: 7469 6f6e 2074 6f20 7365 7420 7570 2061 tion to set up a │ │ │ │ -0001ac70: 2073 6572 6961 6c20 7465 726d 696e 616c serial terminal │ │ │ │ -0001ac80: 2069 7320 7175 6974 650a 7369 6d70 6c65 is quite.simple │ │ │ │ -0001ac90: 2e20 2048 6572 6520 6973 2061 6e20 6578 . Here is an ex │ │ │ │ -0001aca0: 616d 706c 653a 0a0a 2020 2020 2067 7275 ample:.. gru │ │ │ │ -0001acb0: 623e 2073 6572 6961 6c20 2d2d 756e 6974 b> serial --unit │ │ │ │ -0001acc0: 3d30 202d 2d73 7065 6564 3d39 3630 300a =0 --speed=9600. │ │ │ │ -0001acd0: 2020 2020 2067 7275 623e 2074 6572 6d69 grub> termi │ │ │ │ -0001ace0: 6e61 6c5f 696e 7075 7420 7365 7269 616c nal_input serial │ │ │ │ -0001acf0: 3b20 7465 726d 696e 616c 5f6f 7574 7075 ; terminal_outpu │ │ │ │ -0001ad00: 7420 7365 7269 616c 0a0a 2020 2054 6865 t serial.. The │ │ │ │ -0001ad10: 2063 6f6d 6d61 6e64 2027 7365 7269 616c command 'serial │ │ │ │ -0001ad20: 2720 696e 6974 6961 6c69 7a65 7320 7468 ' initializes th │ │ │ │ -0001ad30: 6520 7365 7269 616c 2075 6e69 7420 3020 e serial unit 0 │ │ │ │ -0001ad40: 7769 7468 2074 6865 2073 7065 6564 0a39 with the speed.9 │ │ │ │ -0001ad50: 3630 3062 7073 2e20 2054 6865 2073 6572 600bps. The ser │ │ │ │ -0001ad60: 6961 6c20 756e 6974 2030 2069 7320 7573 ial unit 0 is us │ │ │ │ -0001ad70: 7561 6c6c 7920 6361 6c6c 6564 2027 434f ually called 'CO │ │ │ │ -0001ad80: 4d31 272c 2073 6f2c 2069 6620 796f 7520 M1', so, if you │ │ │ │ -0001ad90: 7761 6e74 2074 6f0a 7573 6520 434f 4d32 want to.use COM2 │ │ │ │ -0001ada0: 2c20 796f 7520 6d75 7374 2073 7065 6369 , you must speci │ │ │ │ -0001adb0: 6679 2027 2d2d 756e 6974 3d31 2720 696e fy '--unit=1' in │ │ │ │ -0001adc0: 7374 6561 642e 2020 5468 6973 2063 6f6d stead. This com │ │ │ │ -0001add0: 6d61 6e64 2061 6363 6570 7473 0a6d 616e mand accepts.man │ │ │ │ -0001ade0: 7920 6f74 6865 7220 6f70 7469 6f6e 732c y other options, │ │ │ │ -0001adf0: 2073 6f20 706c 6561 7365 2072 6566 6572 so please refer │ │ │ │ -0001ae00: 2074 6f20 2a6e 6f74 6520 7365 7269 616c to *note serial │ │ │ │ -0001ae10: 3a3a 2c20 666f 7220 6d6f 7265 2064 6574 ::, for more det │ │ │ │ -0001ae20: 6169 6c73 2e0a 0a20 2020 5468 6520 636f ails... The co │ │ │ │ -0001ae30: 6d6d 616e 6473 2027 7465 726d 696e 616c mmands 'terminal │ │ │ │ -0001ae40: 5f69 6e70 7574 2720 282a 6e6f 7465 2074 _input' (*note t │ │ │ │ -0001ae50: 6572 6d69 6e61 6c5f 696e 7075 743a 3a29 erminal_input::) │ │ │ │ -0001ae60: 2061 6e64 0a27 7465 726d 696e 616c 5f6f and.'terminal_o │ │ │ │ -0001ae70: 7574 7075 7427 2028 2a6e 6f74 6520 7465 utput' (*note te │ │ │ │ -0001ae80: 726d 696e 616c 5f6f 7574 7075 743a 3a29 rminal_output::) │ │ │ │ -0001ae90: 2063 686f 6f73 6520 7768 6963 6820 7479 choose which ty │ │ │ │ -0001aea0: 7065 206f 660a 7465 726d 696e 616c 2079 pe of.terminal y │ │ │ │ -0001aeb0: 6f75 2077 616e 7420 746f 2075 7365 2e20 ou want to use. │ │ │ │ -0001aec0: 2049 6e20 7468 6520 6361 7365 2061 626f In the case abo │ │ │ │ -0001aed0: 7665 2c20 7468 6520 7465 726d 696e 616c ve, the terminal │ │ │ │ -0001aee0: 2077 696c 6c20 6265 2061 0a73 6572 6961 will be a.seria │ │ │ │ -0001aef0: 6c20 7465 726d 696e 616c 2c20 6275 7420 l terminal, but │ │ │ │ -0001af00: 796f 7520 6361 6e20 616c 736f 2070 6173 you can also pas │ │ │ │ -0001af10: 7320 2763 6f6e 736f 6c65 2720 746f 2074 s 'console' to t │ │ │ │ -0001af20: 6865 2063 6f6d 6d61 6e64 2c20 6173 0a27 he command, as.' │ │ │ │ -0001af30: 7465 726d 696e 616c 5f69 6e70 7574 2073 terminal_input s │ │ │ │ -0001af40: 6572 6961 6c20 636f 6e73 6f6c 6527 2e20 erial console'. │ │ │ │ -0001af50: 2049 6e20 7468 6973 2063 6173 652c 2061 In this case, a │ │ │ │ -0001af60: 2074 6572 6d69 6e61 6c20 696e 2077 6869 terminal in whi │ │ │ │ -0001af70: 6368 2079 6f75 0a70 7265 7373 2061 6e79 ch you.press any │ │ │ │ -0001af80: 206b 6579 2077 696c 6c20 6265 2073 656c key will be sel │ │ │ │ -0001af90: 6563 7465 6420 6173 2061 2047 5255 4220 ected as a GRUB │ │ │ │ -0001afa0: 7465 726d 696e 616c 2e20 2049 6e20 7468 terminal. In th │ │ │ │ -0001afb0: 6520 6578 616d 706c 650a 6162 6f76 652c e example.above, │ │ │ │ -0001afc0: 206e 6f74 6520 7468 6174 2079 6f75 206e note that you n │ │ │ │ -0001afd0: 6565 6420 746f 2070 7574 2062 6f74 6820 eed to put both │ │ │ │ -0001afe0: 636f 6d6d 616e 6473 206f 6e20 7468 6520 commands on the │ │ │ │ -0001aff0: 7361 6d65 2063 6f6d 6d61 6e64 206c 696e same command lin │ │ │ │ -0001b000: 652c 0a61 7320 796f 7520 7769 6c6c 206c e,.as you will l │ │ │ │ -0001b010: 6f73 6520 7468 6520 6162 696c 6974 7920 ose the ability │ │ │ │ -0001b020: 746f 2074 7970 6520 636f 6d6d 616e 6473 to type commands │ │ │ │ -0001b030: 206f 6e20 7468 6520 636f 6e73 6f6c 6520 on the console │ │ │ │ -0001b040: 6166 7465 7220 7468 650a 6669 7273 7420 after the.first │ │ │ │ -0001b050: 636f 6d6d 616e 642e 0a0a 2020 2048 6f77 command... How │ │ │ │ -0001b060: 6576 6572 2c20 6e6f 7465 2074 6861 7420 ever, note that │ │ │ │ -0001b070: 4752 5542 2061 7373 756d 6573 2074 6861 GRUB assumes tha │ │ │ │ -0001b080: 7420 796f 7572 2074 6572 6d69 6e61 6c20 t your terminal │ │ │ │ -0001b090: 656d 756c 6174 6f72 2069 730a 636f 6d70 emulator is.comp │ │ │ │ -0001b0a0: 6174 6962 6c65 2077 6974 6820 5654 3130 atible with VT10 │ │ │ │ -0001b0b0: 3020 6279 2064 6566 6175 6c74 2e20 2054 0 by default. T │ │ │ │ -0001b0c0: 6869 7320 6973 2074 7275 6520 666f 7220 his is true for │ │ │ │ -0001b0d0: 6d6f 7374 2074 6572 6d69 6e61 6c0a 656d most terminal.em │ │ │ │ -0001b0e0: 756c 6174 6f72 7320 6e6f 7761 6461 7973 ulators nowadays │ │ │ │ -0001b0f0: 2c20 6275 7420 796f 7520 7368 6f75 6c64 , but you should │ │ │ │ -0001b100: 2070 6173 7320 7468 6520 6f70 7469 6f6e pass the option │ │ │ │ -0001b110: 2027 2d2d 6475 6d62 2720 746f 2074 6865 '--dumb' to the │ │ │ │ -0001b120: 0a63 6f6d 6d61 6e64 2069 6620 796f 7572 .command if your │ │ │ │ -0001b130: 2074 6572 6d69 6e61 6c20 656d 756c 6174 terminal emulat │ │ │ │ -0001b140: 6f72 2069 7320 6e6f 7420 5654 3130 302d or is not VT100- │ │ │ │ -0001b150: 636f 6d70 6174 6962 6c65 206f 7220 696d compatible or im │ │ │ │ -0001b160: 706c 656d 656e 7473 0a66 6577 2056 5431 plements.few VT1 │ │ │ │ -0001b170: 3030 2065 7363 6170 6520 7365 7175 656e 00 escape sequen │ │ │ │ -0001b180: 6365 732e 2020 4966 2079 6f75 2073 7065 ces. If you spe │ │ │ │ -0001b190: 6369 6679 2074 6869 7320 6f70 7469 6f6e cify this option │ │ │ │ -0001b1a0: 2074 6865 6e20 4752 5542 0a70 726f 7669 then GRUB.provi │ │ │ │ -0001b1b0: 6465 7320 796f 7520 7769 7468 2061 6e20 des you with an │ │ │ │ -0001b1c0: 616c 7465 726e 6174 6976 6520 6d65 6e75 alternative menu │ │ │ │ -0001b1d0: 2069 6e74 6572 6661 6365 2c20 6265 6361 interface, beca │ │ │ │ -0001b1e0: 7573 6520 7468 6520 6e6f 726d 616c 206d use the normal m │ │ │ │ -0001b1f0: 656e 750a 7265 7175 6972 6573 2073 6576 enu.requires sev │ │ │ │ -0001b200: 6572 616c 2066 616e 6379 2066 6561 7475 eral fancy featu │ │ │ │ -0001b210: 7265 7320 6f66 2079 6f75 7220 7465 726d res of your term │ │ │ │ -0001b220: 696e 616c 2e0a 0a1f 0a46 696c 653a 2067 inal.....File: g │ │ │ │ -0001b230: 7275 622e 696e 666f 2c20 204e 6f64 653a rub.info, Node: │ │ │ │ -0001b240: 2056 656e 646f 7220 706f 7765 722d 6f6e Vendor power-on │ │ │ │ -0001b250: 206b 6579 732c 2020 4e65 7874 3a20 496d keys, Next: Im │ │ │ │ -0001b260: 6167 6573 2c20 2050 7265 763a 2053 6572 ages, Prev: Ser │ │ │ │ -0001b270: 6961 6c20 7465 726d 696e 616c 2c20 2055 ial terminal, U │ │ │ │ -0001b280: 703a 2054 6f70 0a0a 3130 2055 7369 6e67 p: Top..10 Using │ │ │ │ -0001b290: 2047 5255 4220 7769 7468 2076 656e 646f GRUB with vendo │ │ │ │ -0001b2a0: 7220 706f 7765 722d 6f6e 206b 6579 730a r power-on keys. │ │ │ │ -0001b2b0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ +0001aa00: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a0a 0a54 *************..T │ │ │ │ +0001aa10: 6869 7320 6368 6170 7465 7220 6465 7363 his chapter desc │ │ │ │ +0001aa20: 7269 6265 7320 686f 7720 746f 2075 7365 ribes how to use │ │ │ │ +0001aa30: 2074 6865 2073 6572 6961 6c20 7465 726d the serial term │ │ │ │ +0001aa40: 696e 616c 2073 7570 706f 7274 2069 6e20 inal support in │ │ │ │ +0001aa50: 4752 5542 2e0a 0a20 2020 4966 2079 6f75 GRUB... If you │ │ │ │ +0001aa60: 2068 6176 6520 6d61 6e79 2063 6f6d 7075 have many compu │ │ │ │ +0001aa70: 7465 7273 206f 7220 636f 6d70 7574 6572 ters or computer │ │ │ │ +0001aa80: 7320 7769 7468 206e 6f20 6469 7370 6c61 s with no displa │ │ │ │ +0001aa90: 792f 6b65 7962 6f61 7264 2c20 6974 0a63 y/keyboard, it.c │ │ │ │ +0001aaa0: 6f75 6c64 2062 6520 7665 7279 2075 7365 ould be very use │ │ │ │ +0001aab0: 6675 6c20 746f 2063 6f6e 7472 6f6c 2074 ful to control t │ │ │ │ +0001aac0: 6865 2063 6f6d 7075 7465 7273 2074 6872 he computers thr │ │ │ │ +0001aad0: 6f75 6768 2073 6572 6961 6c0a 636f 6d6d ough serial.comm │ │ │ │ +0001aae0: 756e 6963 6174 696f 6e73 2e20 2054 6f20 unications. To │ │ │ │ +0001aaf0: 636f 6e6e 6563 7420 6f6e 6520 636f 6d70 connect one comp │ │ │ │ +0001ab00: 7574 6572 2077 6974 6820 616e 6f74 6865 uter with anothe │ │ │ │ +0001ab10: 7220 7669 6120 6120 7365 7269 616c 206c r via a serial l │ │ │ │ +0001ab20: 696e 652c 0a79 6f75 206e 6565 6420 746f ine,.you need to │ │ │ │ +0001ab30: 2070 7265 7061 7265 2061 206e 756c 6c2d prepare a null- │ │ │ │ +0001ab40: 6d6f 6465 6d20 2863 726f 7373 2920 7365 modem (cross) se │ │ │ │ +0001ab50: 7269 616c 2063 6162 6c65 2c20 616e 6420 rial cable, and │ │ │ │ +0001ab60: 796f 7520 6d61 7920 6e65 6564 0a74 6f20 you may need.to │ │ │ │ +0001ab70: 6861 7665 206d 756c 7469 706f 7274 2073 have multiport s │ │ │ │ +0001ab80: 6572 6961 6c20 626f 6172 6473 2c20 6966 erial boards, if │ │ │ │ +0001ab90: 2079 6f75 7220 636f 6d70 7574 6572 2064 your computer d │ │ │ │ +0001aba0: 6f65 736e 2774 2068 6176 6520 6578 7472 oesn't have extr │ │ │ │ +0001abb0: 610a 7365 7269 616c 2070 6f72 7473 2e20 a.serial ports. │ │ │ │ +0001abc0: 2049 6e20 6164 6469 7469 6f6e 2c20 6120 In addition, a │ │ │ │ +0001abd0: 7465 726d 696e 616c 2065 6d75 6c61 746f terminal emulato │ │ │ │ +0001abe0: 7220 6973 2061 6c73 6f20 7265 7175 6972 r is also requir │ │ │ │ +0001abf0: 6564 2c20 7375 6368 0a61 7320 6d69 6e69 ed, such.as mini │ │ │ │ +0001ac00: 636f 6d2e 2020 5265 6665 7220 746f 2061 com. Refer to a │ │ │ │ +0001ac10: 206d 616e 7561 6c20 6f66 2079 6f75 7220 manual of your │ │ │ │ +0001ac20: 6f70 6572 6174 696e 6720 7379 7374 656d operating system │ │ │ │ +0001ac30: 2c20 666f 7220 6d6f 7265 0a69 6e66 6f72 , for more.infor │ │ │ │ +0001ac40: 6d61 7469 6f6e 2e0a 0a20 2020 4173 2066 mation... As f │ │ │ │ +0001ac50: 6f72 2047 5255 422c 2074 6865 2069 6e73 or GRUB, the ins │ │ │ │ +0001ac60: 7472 7563 7469 6f6e 2074 6f20 7365 7420 truction to set │ │ │ │ +0001ac70: 7570 2061 2073 6572 6961 6c20 7465 726d up a serial term │ │ │ │ +0001ac80: 696e 616c 2069 7320 7175 6974 650a 7369 inal is quite.si │ │ │ │ +0001ac90: 6d70 6c65 2e20 2048 6572 6520 6973 2061 mple. Here is a │ │ │ │ +0001aca0: 6e20 6578 616d 706c 653a 0a0a 2020 2020 n example:.. │ │ │ │ +0001acb0: 2067 7275 623e 2073 6572 6961 6c20 2d2d grub> serial -- │ │ │ │ +0001acc0: 756e 6974 3d30 202d 2d73 7065 6564 3d39 unit=0 --speed=9 │ │ │ │ +0001acd0: 3630 300a 2020 2020 2067 7275 623e 2074 600. grub> t │ │ │ │ +0001ace0: 6572 6d69 6e61 6c5f 696e 7075 7420 7365 erminal_input se │ │ │ │ +0001acf0: 7269 616c 3b20 7465 726d 696e 616c 5f6f rial; terminal_o │ │ │ │ +0001ad00: 7574 7075 7420 7365 7269 616c 0a0a 2020 utput serial.. │ │ │ │ +0001ad10: 2054 6865 2063 6f6d 6d61 6e64 2027 7365 The command 'se │ │ │ │ +0001ad20: 7269 616c 2720 696e 6974 6961 6c69 7a65 rial' initialize │ │ │ │ +0001ad30: 7320 7468 6520 7365 7269 616c 2075 6e69 s the serial uni │ │ │ │ +0001ad40: 7420 3020 7769 7468 2074 6865 2073 7065 t 0 with the spe │ │ │ │ +0001ad50: 6564 0a39 3630 3062 7073 2e20 2054 6865 ed.9600bps. The │ │ │ │ +0001ad60: 2073 6572 6961 6c20 756e 6974 2030 2069 serial unit 0 i │ │ │ │ +0001ad70: 7320 7573 7561 6c6c 7920 6361 6c6c 6564 s usually called │ │ │ │ +0001ad80: 2027 434f 4d31 272c 2073 6f2c 2069 6620 'COM1', so, if │ │ │ │ +0001ad90: 796f 7520 7761 6e74 2074 6f0a 7573 6520 you want to.use │ │ │ │ +0001ada0: 434f 4d32 2c20 796f 7520 6d75 7374 2073 COM2, you must s │ │ │ │ +0001adb0: 7065 6369 6679 2027 2d2d 756e 6974 3d31 pecify '--unit=1 │ │ │ │ +0001adc0: 2720 696e 7374 6561 642e 2020 5468 6973 ' instead. This │ │ │ │ +0001add0: 2063 6f6d 6d61 6e64 2061 6363 6570 7473 command accepts │ │ │ │ +0001ade0: 0a6d 616e 7920 6f74 6865 7220 6f70 7469 .many other opti │ │ │ │ +0001adf0: 6f6e 732c 2073 6f20 706c 6561 7365 2072 ons, so please r │ │ │ │ +0001ae00: 6566 6572 2074 6f20 2a6e 6f74 6520 7365 efer to *note se │ │ │ │ +0001ae10: 7269 616c 3a3a 2c20 666f 7220 6d6f 7265 rial::, for more │ │ │ │ +0001ae20: 2064 6574 6169 6c73 2e0a 0a20 2020 5468 details... Th │ │ │ │ +0001ae30: 6520 636f 6d6d 616e 6473 2027 7465 726d e commands 'term │ │ │ │ +0001ae40: 696e 616c 5f69 6e70 7574 2720 282a 6e6f inal_input' (*no │ │ │ │ +0001ae50: 7465 2074 6572 6d69 6e61 6c5f 696e 7075 te terminal_inpu │ │ │ │ +0001ae60: 743a 3a29 2061 6e64 0a27 7465 726d 696e t::) and.'termin │ │ │ │ +0001ae70: 616c 5f6f 7574 7075 7427 2028 2a6e 6f74 al_output' (*not │ │ │ │ +0001ae80: 6520 7465 726d 696e 616c 5f6f 7574 7075 e terminal_outpu │ │ │ │ +0001ae90: 743a 3a29 2063 686f 6f73 6520 7768 6963 t::) choose whic │ │ │ │ +0001aea0: 6820 7479 7065 206f 660a 7465 726d 696e h type of.termin │ │ │ │ +0001aeb0: 616c 2079 6f75 2077 616e 7420 746f 2075 al you want to u │ │ │ │ +0001aec0: 7365 2e20 2049 6e20 7468 6520 6361 7365 se. In the case │ │ │ │ +0001aed0: 2061 626f 7665 2c20 7468 6520 7465 726d above, the term │ │ │ │ +0001aee0: 696e 616c 2077 696c 6c20 6265 2061 0a73 inal will be a.s │ │ │ │ +0001aef0: 6572 6961 6c20 7465 726d 696e 616c 2c20 erial terminal, │ │ │ │ +0001af00: 6275 7420 796f 7520 6361 6e20 616c 736f but you can also │ │ │ │ +0001af10: 2070 6173 7320 2763 6f6e 736f 6c65 2720 pass 'console' │ │ │ │ +0001af20: 746f 2074 6865 2063 6f6d 6d61 6e64 2c20 to the command, │ │ │ │ +0001af30: 6173 0a27 7465 726d 696e 616c 5f69 6e70 as.'terminal_inp │ │ │ │ +0001af40: 7574 2073 6572 6961 6c20 636f 6e73 6f6c ut serial consol │ │ │ │ +0001af50: 6527 2e20 2049 6e20 7468 6973 2063 6173 e'. In this cas │ │ │ │ +0001af60: 652c 2061 2074 6572 6d69 6e61 6c20 696e e, a terminal in │ │ │ │ +0001af70: 2077 6869 6368 2079 6f75 0a70 7265 7373 which you.press │ │ │ │ +0001af80: 2061 6e79 206b 6579 2077 696c 6c20 6265 any key will be │ │ │ │ +0001af90: 2073 656c 6563 7465 6420 6173 2061 2047 selected as a G │ │ │ │ +0001afa0: 5255 4220 7465 726d 696e 616c 2e20 2049 RUB terminal. I │ │ │ │ +0001afb0: 6e20 7468 6520 6578 616d 706c 650a 6162 n the example.ab │ │ │ │ +0001afc0: 6f76 652c 206e 6f74 6520 7468 6174 2079 ove, note that y │ │ │ │ +0001afd0: 6f75 206e 6565 6420 746f 2070 7574 2062 ou need to put b │ │ │ │ +0001afe0: 6f74 6820 636f 6d6d 616e 6473 206f 6e20 oth commands on │ │ │ │ +0001aff0: 7468 6520 7361 6d65 2063 6f6d 6d61 6e64 the same command │ │ │ │ +0001b000: 206c 696e 652c 0a61 7320 796f 7520 7769 line,.as you wi │ │ │ │ +0001b010: 6c6c 206c 6f73 6520 7468 6520 6162 696c ll lose the abil │ │ │ │ +0001b020: 6974 7920 746f 2074 7970 6520 636f 6d6d ity to type comm │ │ │ │ +0001b030: 616e 6473 206f 6e20 7468 6520 636f 6e73 ands on the cons │ │ │ │ +0001b040: 6f6c 6520 6166 7465 7220 7468 650a 6669 ole after the.fi │ │ │ │ +0001b050: 7273 7420 636f 6d6d 616e 642e 0a0a 2020 rst command... │ │ │ │ +0001b060: 2048 6f77 6576 6572 2c20 6e6f 7465 2074 However, note t │ │ │ │ +0001b070: 6861 7420 4752 5542 2061 7373 756d 6573 hat GRUB assumes │ │ │ │ +0001b080: 2074 6861 7420 796f 7572 2074 6572 6d69 that your termi │ │ │ │ +0001b090: 6e61 6c20 656d 756c 6174 6f72 2069 730a nal emulator is. │ │ │ │ +0001b0a0: 636f 6d70 6174 6962 6c65 2077 6974 6820 compatible with │ │ │ │ +0001b0b0: 5654 3130 3020 6279 2064 6566 6175 6c74 VT100 by default │ │ │ │ +0001b0c0: 2e20 2054 6869 7320 6973 2074 7275 6520 . This is true │ │ │ │ +0001b0d0: 666f 7220 6d6f 7374 2074 6572 6d69 6e61 for most termina │ │ │ │ +0001b0e0: 6c0a 656d 756c 6174 6f72 7320 6e6f 7761 l.emulators nowa │ │ │ │ +0001b0f0: 6461 7973 2c20 6275 7420 796f 7520 7368 days, but you sh │ │ │ │ +0001b100: 6f75 6c64 2070 6173 7320 7468 6520 6f70 ould pass the op │ │ │ │ +0001b110: 7469 6f6e 2027 2d2d 6475 6d62 2720 746f tion '--dumb' to │ │ │ │ +0001b120: 2074 6865 0a63 6f6d 6d61 6e64 2069 6620 the.command if │ │ │ │ +0001b130: 796f 7572 2074 6572 6d69 6e61 6c20 656d your terminal em │ │ │ │ +0001b140: 756c 6174 6f72 2069 7320 6e6f 7420 5654 ulator is not VT │ │ │ │ +0001b150: 3130 302d 636f 6d70 6174 6962 6c65 206f 100-compatible o │ │ │ │ +0001b160: 7220 696d 706c 656d 656e 7473 0a66 6577 r implements.few │ │ │ │ +0001b170: 2056 5431 3030 2065 7363 6170 6520 7365 VT100 escape se │ │ │ │ +0001b180: 7175 656e 6365 732e 2020 4966 2079 6f75 quences. If you │ │ │ │ +0001b190: 2073 7065 6369 6679 2074 6869 7320 6f70 specify this op │ │ │ │ +0001b1a0: 7469 6f6e 2074 6865 6e20 4752 5542 0a70 tion then GRUB.p │ │ │ │ +0001b1b0: 726f 7669 6465 7320 796f 7520 7769 7468 rovides you with │ │ │ │ +0001b1c0: 2061 6e20 616c 7465 726e 6174 6976 6520 an alternative │ │ │ │ +0001b1d0: 6d65 6e75 2069 6e74 6572 6661 6365 2c20 menu interface, │ │ │ │ +0001b1e0: 6265 6361 7573 6520 7468 6520 6e6f 726d because the norm │ │ │ │ +0001b1f0: 616c 206d 656e 750a 7265 7175 6972 6573 al menu.requires │ │ │ │ +0001b200: 2073 6576 6572 616c 2066 616e 6379 2066 several fancy f │ │ │ │ +0001b210: 6561 7475 7265 7320 6f66 2079 6f75 7220 eatures of your │ │ │ │ +0001b220: 7465 726d 696e 616c 2e0a 0a1f 0a46 696c terminal.....Fil │ │ │ │ +0001b230: 653a 2067 7275 622e 696e 666f 2c20 204e e: grub.info, N │ │ │ │ +0001b240: 6f64 653a 2056 656e 646f 7220 706f 7765 ode: Vendor powe │ │ │ │ +0001b250: 722d 6f6e 206b 6579 732c 2020 4e65 7874 r-on keys, Next │ │ │ │ +0001b260: 3a20 496d 6167 6573 2c20 2050 7265 763a : Images, Prev: │ │ │ │ +0001b270: 2053 6572 6961 6c20 7465 726d 696e 616c Serial terminal │ │ │ │ +0001b280: 2c20 2055 703a 2054 6f70 0a0a 3130 2055 , Up: Top..10 U │ │ │ │ +0001b290: 7369 6e67 2047 5255 4220 7769 7468 2076 sing GRUB with v │ │ │ │ +0001b2a0: 656e 646f 7220 706f 7765 722d 6f6e 206b endor power-on k │ │ │ │ +0001b2b0: 6579 730a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a eys.************ │ │ │ │ 0001b2c0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ -0001b2d0: 2a2a 2a2a 2a2a 2a0a 0a53 6f6d 6520 6c61 *******..Some la │ │ │ │ -0001b2e0: 7074 6f70 2076 656e 646f 7273 2070 726f ptop vendors pro │ │ │ │ -0001b2f0: 7669 6465 2061 6e20 6164 6469 7469 6f6e vide an addition │ │ │ │ -0001b300: 616c 2070 6f77 6572 2d6f 6e20 6275 7474 al power-on butt │ │ │ │ -0001b310: 6f6e 2077 6869 6368 2062 6f6f 7473 0a61 on which boots.a │ │ │ │ -0001b320: 6e6f 7468 6572 204f 532e 2047 5255 4220 nother OS. GRUB │ │ │ │ -0001b330: 7375 7070 6f72 7473 2073 7563 6820 6275 supports such bu │ │ │ │ -0001b340: 7474 6f6e 7320 7769 7468 2074 6865 2027 ttons with the ' │ │ │ │ -0001b350: 4752 5542 5f54 494d 454f 5554 5f42 5554 GRUB_TIMEOUT_BUT │ │ │ │ -0001b360: 544f 4e27 2c0a 2747 5255 425f 5449 4d45 TON',.'GRUB_TIME │ │ │ │ -0001b370: 4f55 545f 5354 594c 455f 4255 5454 4f4e OUT_STYLE_BUTTON │ │ │ │ -0001b380: 272c 2027 4752 5542 5f44 4546 4155 4c54 ', 'GRUB_DEFAULT │ │ │ │ -0001b390: 5f42 5554 544f 4e27 2c20 616e 640a 2747 _BUTTON', and.'G │ │ │ │ -0001b3a0: 5255 425f 4255 5454 4f4e 5f43 4d4f 535f RUB_BUTTON_CMOS_ │ │ │ │ -0001b3b0: 4144 4452 4553 5327 2076 6172 6961 626c ADDRESS' variabl │ │ │ │ -0001b3c0: 6573 2069 6e20 6465 6661 756c 742f 6772 es in default/gr │ │ │ │ -0001b3d0: 7562 2028 2a6e 6f74 6520 5369 6d70 6c65 ub (*note Simple │ │ │ │ -0001b3e0: 0a63 6f6e 6669 6775 7261 7469 6f6e 3a3a .configuration:: │ │ │ │ -0001b3f0: 292e 2020 2747 5255 425f 5449 4d45 4f55 ). 'GRUB_TIMEOU │ │ │ │ -0001b400: 545f 4255 5454 4f4e 272c 2027 4752 5542 T_BUTTON', 'GRUB │ │ │ │ -0001b410: 5f54 494d 454f 5554 5f53 5459 4c45 5f42 _TIMEOUT_STYLE_B │ │ │ │ -0001b420: 5554 544f 4e27 2c0a 616e 6420 2747 5255 UTTON',.and 'GRU │ │ │ │ -0001b430: 425f 4445 4641 554c 545f 4255 5454 4f4e B_DEFAULT_BUTTON │ │ │ │ -0001b440: 2720 6172 6520 7573 6564 2069 6e73 7465 ' are used inste │ │ │ │ -0001b450: 6164 206f 6620 7468 6520 636f 7272 6573 ad of the corres │ │ │ │ -0001b460: 706f 6e64 696e 670a 7661 7269 6162 6c65 ponding.variable │ │ │ │ -0001b470: 7320 7769 7468 6f75 7420 7468 6520 275f s without the '_ │ │ │ │ -0001b480: 4255 5454 4f4e 2720 7375 6666 6978 2077 BUTTON' suffix w │ │ │ │ -0001b490: 6865 6e20 706f 7765 7265 6420 6f6e 2075 hen powered on u │ │ │ │ -0001b4a0: 7369 6e67 2074 6865 2073 7065 6369 616c sing the special │ │ │ │ -0001b4b0: 0a62 7574 746f 6e2e 2020 2747 5255 425f .button. 'GRUB_ │ │ │ │ -0001b4c0: 4255 5454 4f4e 5f43 4d4f 535f 4144 4452 BUTTON_CMOS_ADDR │ │ │ │ -0001b4d0: 4553 5327 2069 7320 7665 6e64 6f72 2d73 ESS' is vendor-s │ │ │ │ -0001b4e0: 7065 6369 6669 6320 616e 6420 7061 7274 pecific and part │ │ │ │ -0001b4f0: 6961 6c6c 790a 6d6f 6465 6c2d 7370 6563 ially.model-spec │ │ │ │ -0001b500: 6966 6963 2e20 2056 616c 7565 7320 6b6e ific. Values kn │ │ │ │ -0001b510: 6f77 6e20 746f 2074 6865 2047 5255 4220 own to the GRUB │ │ │ │ -0001b520: 7465 616d 2061 7265 3a0a 0a3c 4465 6c6c team are:... │ │ │ │ -0001b540: 2020 3132 313a 330a 3c44 656c 6c20 5850 121:3.. 85 │ │ │ │ -0001b560: 3a33 0a3c 4465 6c6c 204c 6174 6974 7564 :3.. 85 │ │ │ │ -0001b580: 3a33 0a3c 4173 7573 2045 6565 5043 2031 :3.. 84:1 │ │ │ │ -0001b5a0: 2028 756e 636f 6e66 6972 6d65 6429 0a3c (unconfirmed).< │ │ │ │ -0001b5b0: 4c45 4e4f 564f 2054 6869 6e6b 5061 6420 LENOVO ThinkPad │ │ │ │ -0001b5c0: 5434 3130 7320 2832 3931 3257 3143 293e T410s (2912W1C)> │ │ │ │ -0001b5d0: 0a20 2020 2020 3130 313a 330a 0a20 2020 . 101:3.. │ │ │ │ -0001b5e0: 546f 2074 616b 6520 6675 6c6c 2061 6476 To take full adv │ │ │ │ -0001b5f0: 616e 7461 6765 206f 6620 7468 6973 2066 antage of this f │ │ │ │ -0001b600: 756e 6374 696f 6e2c 2069 6e73 7461 6c6c unction, install │ │ │ │ -0001b610: 2047 5255 4220 696e 746f 2074 6865 204d GRUB into the M │ │ │ │ -0001b620: 4252 0a28 2a6e 6f74 6520 496e 7374 616c BR.(*note Instal │ │ │ │ -0001b630: 6c69 6e67 2047 5255 4220 7573 696e 6720 ling GRUB using │ │ │ │ -0001b640: 6772 7562 2d69 6e73 7461 6c6c 3a3a 292e grub-install::). │ │ │ │ -0001b650: 0a0a 2020 2049 6620 796f 7520 6861 7665 .. If you have │ │ │ │ -0001b660: 2061 206c 6170 746f 7020 7768 6963 6820 a laptop which │ │ │ │ -0001b670: 6861 7320 6120 7369 6d69 6c61 7220 6665 has a similar fe │ │ │ │ -0001b680: 6174 7572 6520 616e 6420 6e6f 7420 696e ature and not in │ │ │ │ -0001b690: 2074 6865 2061 626f 7665 0a6c 6973 7420 the above.list │ │ │ │ -0001b6a0: 636f 756c 6420 796f 7520 6669 6775 7265 could you figure │ │ │ │ -0001b6b0: 2079 6f75 7220 6164 6472 6573 7320 616e your address an │ │ │ │ -0001b6c0: 6420 636f 6e74 7269 6275 7465 3f20 2054 d contribute? T │ │ │ │ -0001b6d0: 6f20 6469 7363 6f76 6572 2074 6865 0a61 o discover the.a │ │ │ │ -0001b6e0: 6464 7265 7373 2064 6f20 7468 6520 666f ddress do the fo │ │ │ │ -0001b6f0: 6c6c 6f77 696e 673a 0a20 2020 2a20 626f llowing:. * bo │ │ │ │ -0001b700: 6f74 206e 6f72 6d61 6c6c 790a 2020 202a ot normally. * │ │ │ │ -0001b710: 2020 2020 2020 7375 646f 206d 6f64 7072 sudo modpr │ │ │ │ -0001b720: 6f62 6520 6e76 7261 6d0a 2020 2020 2020 obe nvram. │ │ │ │ -0001b730: 2020 2020 7375 646f 2063 6174 202f 6465 sudo cat /de │ │ │ │ -0001b740: 762f 6e76 7261 6d20 7c20 7878 6420 3e20 v/nvram | xxd > │ │ │ │ -0001b750: 6e6f 726d 616c 5f62 7574 746f 6e2e 7478 normal_button.tx │ │ │ │ -0001b760: 740a 2020 202a 2062 6f6f 7420 7573 696e t. * boot usin │ │ │ │ -0001b770: 6720 7665 6e64 6f72 2062 7574 746f 6e0a g vendor button. │ │ │ │ -0001b780: 2020 202a 2020 2020 2020 7375 646f 206d * sudo m │ │ │ │ -0001b790: 6f64 7072 6f62 6520 6e76 7261 6d0a 2020 odprobe nvram. │ │ │ │ -0001b7a0: 2020 2020 2020 2020 7375 646f 2063 6174 sudo cat │ │ │ │ -0001b7b0: 202f 6465 762f 6e76 7261 6d20 7c20 7878 /dev/nvram | xx │ │ │ │ -0001b7c0: 6420 3e20 6e6f 726d 616c 5f76 656e 646f d > normal_vendo │ │ │ │ -0001b7d0: 722e 7478 740a 0a20 2020 5468 656e 2063 r.txt.. Then c │ │ │ │ -0001b7e0: 6f6d 7061 7265 2074 6865 7365 2074 6578 ompare these tex │ │ │ │ -0001b7f0: 7420 6669 6c65 7320 616e 6420 6669 6e64 t files and find │ │ │ │ -0001b800: 2077 6865 7265 2061 2062 6974 2077 6173 where a bit was │ │ │ │ -0001b810: 2074 6f67 676c 6564 2e20 2045 2e67 2e0a toggled. E.g.. │ │ │ │ -0001b820: 696e 2063 6173 6520 6f66 2044 656c 6c20 in case of Dell │ │ │ │ -0001b830: 5850 5320 6974 2077 6173 3a0a 2020 2020 XPS it was:. │ │ │ │ -0001b840: 2062 7974 6520 3078 3437 3a20 3230 202d byte 0x47: 20 - │ │ │ │ -0001b850: 2d3e 2032 380a 2020 2049 7427 7320 6120 -> 28. It's a │ │ │ │ -0001b860: 6269 7420 6e75 6d62 6572 2033 2061 7320 bit number 3 as │ │ │ │ -0001b870: 7365 656e 2066 726f 6d20 666f 6c6c 6f77 seen from follow │ │ │ │ -0001b880: 696e 6720 7461 626c 653a 0a30 2020 2020 ing table:.0 │ │ │ │ -0001b890: 2020 2020 2020 2020 2020 3031 0a31 2020 01.1 │ │ │ │ -0001b8a0: 2020 2020 2020 2020 2020 2020 3032 0a32 02.2 │ │ │ │ -0001b8b0: 2020 2020 2020 2020 2020 2020 2020 3034 04 │ │ │ │ -0001b8c0: 0a33 2020 2020 2020 2020 2020 2020 2020 .3 │ │ │ │ -0001b8d0: 3038 0a34 2020 2020 2020 2020 2020 2020 08.4 │ │ │ │ -0001b8e0: 2020 3130 0a35 2020 2020 2020 2020 2020 10.5 │ │ │ │ -0001b8f0: 2020 2020 3230 0a36 2020 2020 2020 2020 20.6 │ │ │ │ -0001b900: 2020 2020 2020 3430 0a37 2020 2020 2020 40.7 │ │ │ │ -0001b910: 2020 2020 2020 2020 3830 0a0a 2020 2030 80.. 0 │ │ │ │ -0001b920: 7834 3720 6973 2064 6563 696d 616c 2037 x47 is decimal 7 │ │ │ │ -0001b930: 312e 2020 4c69 6e75 7820 6e76 7261 6d20 1. Linux nvram │ │ │ │ -0001b940: 696d 706c 656d 656e 7461 7469 6f6e 2063 implementation c │ │ │ │ -0001b950: 7574 7320 6669 7273 7420 3134 2062 7974 uts first 14 byt │ │ │ │ -0001b960: 6573 0a6f 6620 434d 4f53 2e20 536f 2074 es.of CMOS. So t │ │ │ │ -0001b970: 6865 2072 6561 6c20 6279 7465 2061 6464 he real byte add │ │ │ │ -0001b980: 7265 7373 2069 6e20 434d 4f53 2069 7320 ress in CMOS is │ │ │ │ -0001b990: 3731 2b31 343d 3835 2053 6f20 636f 6d70 71+14=85 So comp │ │ │ │ -0001b9a0: 6c65 7465 0a61 6464 7265 7373 2069 7320 lete.address is │ │ │ │ -0001b9b0: 3835 3a33 0a0a 1f0a 4669 6c65 3a20 6772 85:3....File: gr │ │ │ │ -0001b9c0: 7562 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ub.info, Node: │ │ │ │ -0001b9d0: 496d 6167 6573 2c20 204e 6578 743a 2043 Images, Next: C │ │ │ │ -0001b9e0: 6f72 6520 696d 6167 6520 7369 7a65 206c ore image size l │ │ │ │ -0001b9f0: 696d 6974 6174 696f 6e2c 2020 5072 6576 imitation, Prev │ │ │ │ -0001ba00: 3a20 5665 6e64 6f72 2070 6f77 6572 2d6f : Vendor power-o │ │ │ │ -0001ba10: 6e20 6b65 7973 2c20 2055 703a 2054 6f70 n keys, Up: Top │ │ │ │ -0001ba20: 0a0a 3131 2047 5255 4220 696d 6167 6520 ..11 GRUB image │ │ │ │ -0001ba30: 6669 6c65 730a 2a2a 2a2a 2a2a 2a2a 2a2a files.********** │ │ │ │ -0001ba40: 2a2a 2a2a 2a2a 2a2a 2a0a 0a47 5255 4220 *********..GRUB │ │ │ │ -0001ba50: 636f 6e73 6973 7473 206f 6620 7365 7665 consists of seve │ │ │ │ -0001ba60: 7261 6c20 696d 6167 6573 3a20 6120 7661 ral images: a va │ │ │ │ -0001ba70: 7269 6574 7920 6f66 2062 6f6f 7473 7472 riety of bootstr │ │ │ │ -0001ba80: 6170 2069 6d61 6765 7320 666f 720a 7374 ap images for.st │ │ │ │ -0001ba90: 6172 7469 6e67 2047 5255 4220 696e 2076 arting GRUB in v │ │ │ │ -0001baa0: 6172 696f 7573 2077 6179 732c 2061 206b arious ways, a k │ │ │ │ -0001bab0: 6572 6e65 6c20 696d 6167 652c 2061 6e64 ernel image, and │ │ │ │ -0001bac0: 2061 2073 6574 206f 6620 6d6f 6475 6c65 a set of module │ │ │ │ -0001bad0: 730a 7768 6963 6820 6172 6520 636f 6d62 s.which are comb │ │ │ │ -0001bae0: 696e 6564 2077 6974 6820 7468 6520 6b65 ined with the ke │ │ │ │ -0001baf0: 726e 656c 2069 6d61 6765 2074 6f20 666f rnel image to fo │ │ │ │ -0001bb00: 726d 2061 2063 6f72 6520 696d 6167 652e rm a core image. │ │ │ │ -0001bb10: 2020 4865 7265 2069 730a 6120 7368 6f72 Here is.a shor │ │ │ │ -0001bb20: 7420 6f76 6572 7669 6577 206f 6620 7468 t overview of th │ │ │ │ -0001bb30: 656d 2e0a 0a27 626f 6f74 2e69 6d67 270a em...'boot.img'. │ │ │ │ -0001bb40: 2020 2020 204f 6e20 5043 2042 494f 5320 On PC BIOS │ │ │ │ -0001bb50: 7379 7374 656d 732c 2074 6869 7320 696d systems, this im │ │ │ │ -0001bb60: 6167 6520 6973 2074 6865 2066 6972 7374 age is the first │ │ │ │ -0001bb70: 2070 6172 7420 6f66 2047 5255 4220 746f part of GRUB to │ │ │ │ -0001bb80: 2073 7461 7274 2e0a 2020 2020 2049 7420 start.. It │ │ │ │ -0001bb90: 6973 2077 7269 7474 656e 2074 6f20 6120 is written to a │ │ │ │ -0001bba0: 6d61 7374 6572 2062 6f6f 7420 7265 636f master boot reco │ │ │ │ -0001bbb0: 7264 2028 4d42 5229 206f 7220 746f 2074 rd (MBR) or to t │ │ │ │ -0001bbc0: 6865 2062 6f6f 7420 7365 6374 6f72 0a20 he boot sector. │ │ │ │ -0001bbd0: 2020 2020 6f66 2061 2070 6172 7469 7469 of a partiti │ │ │ │ -0001bbe0: 6f6e 2e20 2042 6563 6175 7365 2061 2050 on. Because a P │ │ │ │ -0001bbf0: 4320 626f 6f74 2073 6563 746f 7220 6973 C boot sector is │ │ │ │ -0001bc00: 2035 3132 2062 7974 6573 2c20 7468 6520 512 bytes, the │ │ │ │ -0001bc10: 7369 7a65 206f 660a 2020 2020 2074 6869 size of. thi │ │ │ │ -0001bc20: 7320 696d 6167 6520 6973 2065 7861 6374 s image is exact │ │ │ │ -0001bc30: 6c79 2035 3132 2062 7974 6573 2e0a 0a20 ly 512 bytes... │ │ │ │ -0001bc40: 2020 2020 5468 6520 736f 6c65 2066 756e The sole fun │ │ │ │ -0001bc50: 6374 696f 6e20 6f66 2027 626f 6f74 2e69 ction of 'boot.i │ │ │ │ -0001bc60: 6d67 2720 6973 2074 6f20 7265 6164 2074 mg' is to read t │ │ │ │ -0001bc70: 6865 2066 6972 7374 2073 6563 746f 7220 he first sector │ │ │ │ -0001bc80: 6f66 2074 6865 0a20 2020 2020 636f 7265 of the. core │ │ │ │ -0001bc90: 2069 6d61 6765 2066 726f 6d20 6120 6c6f image from a lo │ │ │ │ -0001bca0: 6361 6c20 6469 736b 2061 6e64 206a 756d cal disk and jum │ │ │ │ -0001bcb0: 7020 746f 2069 742e 2020 4265 6361 7573 p to it. Becaus │ │ │ │ -0001bcc0: 6520 6f66 2074 6865 2073 697a 650a 2020 e of the size. │ │ │ │ -0001bcd0: 2020 2072 6573 7472 6963 7469 6f6e 2c20 restriction, │ │ │ │ -0001bce0: 2762 6f6f 742e 696d 6727 2063 616e 6e6f 'boot.img' canno │ │ │ │ -0001bcf0: 7420 756e 6465 7273 7461 6e64 2061 6e79 t understand any │ │ │ │ -0001bd00: 2066 696c 6520 7379 7374 656d 0a20 2020 file system. │ │ │ │ -0001bd10: 2020 7374 7275 6374 7572 652c 2073 6f20 structure, so │ │ │ │ -0001bd20: 2767 7275 622d 696e 7374 616c 6c27 2068 'grub-install' h │ │ │ │ -0001bd30: 6172 6463 6f64 6573 2074 6865 206c 6f63 ardcodes the loc │ │ │ │ -0001bd40: 6174 696f 6e20 6f66 2074 6865 2066 6972 ation of the fir │ │ │ │ -0001bd50: 7374 0a20 2020 2020 7365 6374 6f72 206f st. sector o │ │ │ │ -0001bd60: 6620 7468 6520 636f 7265 2069 6d61 6765 f the core image │ │ │ │ -0001bd70: 2069 6e74 6f20 2762 6f6f 742e 696d 6727 into 'boot.img' │ │ │ │ -0001bd80: 2077 6865 6e20 696e 7374 616c 6c69 6e67 when installing │ │ │ │ -0001bd90: 2047 5255 422e 0a0a 2764 6973 6b62 6f6f GRUB...'diskboo │ │ │ │ -0001bda0: 742e 696d 6727 0a20 2020 2020 5468 6973 t.img'. This │ │ │ │ -0001bdb0: 2069 6d61 6765 2069 7320 7573 6564 2061 image is used a │ │ │ │ -0001bdc0: 7320 7468 6520 6669 7273 7420 7365 6374 s the first sect │ │ │ │ -0001bdd0: 6f72 206f 6620 7468 6520 636f 7265 2069 or of the core i │ │ │ │ -0001bde0: 6d61 6765 2077 6865 6e0a 2020 2020 2062 mage when. b │ │ │ │ -0001bdf0: 6f6f 7469 6e67 2066 726f 6d20 6120 6861 ooting from a ha │ │ │ │ -0001be00: 7264 2064 6973 6b2e 2020 4974 2072 6561 rd disk. It rea │ │ │ │ -0001be10: 6473 2074 6865 2072 6573 7420 6f66 2074 ds the rest of t │ │ │ │ -0001be20: 6865 2063 6f72 6520 696d 6167 6520 696e he core image in │ │ │ │ -0001be30: 746f 0a20 2020 2020 6d65 6d6f 7279 2061 to. memory a │ │ │ │ -0001be40: 6e64 2073 7461 7274 7320 7468 6520 6b65 nd starts the ke │ │ │ │ -0001be50: 726e 656c 2e20 2053 696e 6365 2066 696c rnel. Since fil │ │ │ │ -0001be60: 6520 7379 7374 656d 2068 616e 646c 696e e system handlin │ │ │ │ -0001be70: 6720 6973 206e 6f74 0a20 2020 2020 7965 g is not. ye │ │ │ │ -0001be80: 7420 6176 6169 6c61 626c 652c 2069 7420 t available, it │ │ │ │ -0001be90: 656e 636f 6465 7320 7468 6520 6c6f 6361 encodes the loca │ │ │ │ -0001bea0: 7469 6f6e 206f 6620 7468 6520 636f 7265 tion of the core │ │ │ │ -0001beb0: 2069 6d61 6765 2075 7369 6e67 2061 0a20 image using a. │ │ │ │ -0001bec0: 2020 2020 626c 6f63 6b20 6c69 7374 2066 block list f │ │ │ │ -0001bed0: 6f72 6d61 742e 0a0a 2763 6462 6f6f 742e ormat...'cdboot. │ │ │ │ -0001bee0: 696d 6727 0a20 2020 2020 5468 6973 2069 img'. This i │ │ │ │ -0001bef0: 6d61 6765 2069 7320 7573 6564 2061 7320 mage is used as │ │ │ │ -0001bf00: 7468 6520 6669 7273 7420 7365 6374 6f72 the first sector │ │ │ │ -0001bf10: 206f 6620 7468 6520 636f 7265 2069 6d61 of the core ima │ │ │ │ -0001bf20: 6765 2077 6865 6e0a 2020 2020 2062 6f6f ge when. boo │ │ │ │ -0001bf30: 7469 6e67 2066 726f 6d20 6120 4344 2d52 ting from a CD-R │ │ │ │ -0001bf40: 4f4d 2064 7269 7665 2e20 2049 7420 7065 OM drive. It pe │ │ │ │ -0001bf50: 7266 6f72 6d73 2061 2073 696d 696c 6172 rforms a similar │ │ │ │ -0001bf60: 2066 756e 6374 696f 6e20 746f 0a20 2020 function to. │ │ │ │ -0001bf70: 2020 2764 6973 6b62 6f6f 742e 696d 6727 'diskboot.img' │ │ │ │ -0001bf80: 2e0a 0a27 7078 6562 6f6f 742e 696d 6727 ...'pxeboot.img' │ │ │ │ -0001bf90: 0a20 2020 2020 5468 6973 2069 6d61 6765 . This image │ │ │ │ -0001bfa0: 2069 7320 7573 6564 2061 7320 7468 6520 is used as the │ │ │ │ -0001bfb0: 7374 6172 7420 6f66 2074 6865 2063 6f72 start of the cor │ │ │ │ -0001bfc0: 6520 696d 6167 6520 7768 656e 2062 6f6f e image when boo │ │ │ │ -0001bfd0: 7469 6e67 2066 726f 6d0a 2020 2020 2074 ting from. t │ │ │ │ -0001bfe0: 6865 206e 6574 776f 726b 2075 7369 6e67 he network using │ │ │ │ -0001bff0: 2050 5845 2e20 2a4e 6f74 6520 4e65 7477 PXE. *Note Netw │ │ │ │ -0001c000: 6f72 6b3a 3a2e 0a0a 276c 6e78 626f 6f74 ork::...'lnxboot │ │ │ │ -0001c010: 2e69 6d67 270a 2020 2020 2054 6869 7320 .img'. This │ │ │ │ -0001c020: 696d 6167 6520 6d61 7920 6265 2070 6c61 image may be pla │ │ │ │ -0001c030: 6365 6420 6174 2074 6865 2073 7461 7274 ced at the start │ │ │ │ -0001c040: 206f 6620 7468 6520 636f 7265 2069 6d61 of the core ima │ │ │ │ -0001c050: 6765 2069 6e20 6f72 6465 7220 746f 0a20 ge in order to. │ │ │ │ -0001c060: 2020 2020 6d61 6b65 2047 5255 4220 6c6f make GRUB lo │ │ │ │ -0001c070: 6f6b 2065 6e6f 7567 6820 6c69 6b65 2061 ok enough like a │ │ │ │ -0001c080: 204c 696e 7578 206b 6572 6e65 6c20 7468 Linux kernel th │ │ │ │ -0001c090: 6174 2069 7420 6361 6e20 6265 2062 6f6f at it can be boo │ │ │ │ -0001c0a0: 7465 6420 6279 0a20 2020 2020 4c49 4c4f ted by. LILO │ │ │ │ -0001c0b0: 2075 7369 6e67 2061 6e20 2769 6d61 6765 using an 'image │ │ │ │ -0001c0c0: 3d27 2073 6563 7469 6f6e 2e0a 0a27 6b65 =' section...'ke │ │ │ │ -0001c0d0: 726e 656c 2e69 6d67 270a 2020 2020 2054 rnel.img'. T │ │ │ │ -0001c0e0: 6869 7320 696d 6167 6520 636f 6e74 6169 his image contai │ │ │ │ -0001c0f0: 6e73 2047 5255 4227 7320 6261 7369 6320 ns GRUB's basic │ │ │ │ -0001c100: 7275 6e2d 7469 6d65 2066 6163 696c 6974 run-time facilit │ │ │ │ -0001c110: 6965 733a 2066 7261 6d65 776f 726b 730a ies: frameworks. │ │ │ │ -0001c120: 2020 2020 2066 6f72 2064 6576 6963 6520 for device │ │ │ │ -0001c130: 616e 6420 6669 6c65 2068 616e 646c 696e and file handlin │ │ │ │ -0001c140: 672c 2065 6e76 6972 6f6e 6d65 6e74 2076 g, environment v │ │ │ │ -0001c150: 6172 6961 626c 6573 2c20 7468 6520 7265 ariables, the re │ │ │ │ -0001c160: 7363 7565 0a20 2020 2020 6d6f 6465 2063 scue. mode c │ │ │ │ -0001c170: 6f6d 6d61 6e64 2d6c 696e 6520 7061 7273 ommand-line pars │ │ │ │ -0001c180: 6572 2c20 616e 6420 736f 206f 6e2e 2020 er, and so on. │ │ │ │ -0001c190: 4974 2069 7320 7261 7265 6c79 2075 7365 It is rarely use │ │ │ │ -0001c1a0: 6420 6469 7265 6374 6c79 2c0a 2020 2020 d directly,. │ │ │ │ -0001c1b0: 2062 7574 2069 7320 6275 696c 7420 696e but is built in │ │ │ │ -0001c1c0: 746f 2061 6c6c 2063 6f72 6520 696d 6167 to all core imag │ │ │ │ -0001c1d0: 6573 2e0a 0a27 636f 7265 2e69 6d67 270a es...'core.img'. │ │ │ │ -0001c1e0: 2020 2020 2054 6869 7320 6973 2074 6865 This is the │ │ │ │ -0001c1f0: 2063 6f72 6520 696d 6167 6520 6f66 2047 core image of G │ │ │ │ -0001c200: 5255 422e 2049 7420 6973 2062 7569 6c74 RUB. It is built │ │ │ │ -0001c210: 2064 796e 616d 6963 616c 6c79 2066 726f dynamically fro │ │ │ │ -0001c220: 6d20 7468 650a 2020 2020 206b 6572 6e65 m the. kerne │ │ │ │ -0001c230: 6c20 696d 6167 6520 616e 6420 616e 2061 l image and an a │ │ │ │ -0001c240: 7262 6974 7261 7279 206c 6973 7420 6f66 rbitrary list of │ │ │ │ -0001c250: 206d 6f64 756c 6573 2062 7920 7468 6520 modules by the │ │ │ │ -0001c260: 2767 7275 622d 6d6b 696d 6167 6527 0a20 'grub-mkimage'. │ │ │ │ -0001c270: 2020 2020 7072 6f67 7261 6d2e 2020 5573 program. Us │ │ │ │ -0001c280: 7561 6c6c 792c 2069 7420 636f 6e74 6169 ually, it contai │ │ │ │ -0001c290: 6e73 2065 6e6f 7567 6820 6d6f 6475 6c65 ns enough module │ │ │ │ -0001c2a0: 7320 746f 2061 6363 6573 730a 2020 2020 s to access. │ │ │ │ -0001c2b0: 2027 2f62 6f6f 742f 6772 7562 272c 2061 '/boot/grub', a │ │ │ │ -0001c2c0: 6e64 206c 6f61 6473 2065 7665 7279 7468 nd loads everyth │ │ │ │ -0001c2d0: 696e 6720 656c 7365 2028 696e 636c 7564 ing else (includ │ │ │ │ -0001c2e0: 696e 6720 6d65 6e75 2068 616e 646c 696e ing menu handlin │ │ │ │ -0001c2f0: 672c 0a20 2020 2020 7468 6520 6162 696c g,. the abil │ │ │ │ -0001c300: 6974 7920 746f 206c 6f61 6420 7461 7267 ity to load targ │ │ │ │ -0001c310: 6574 206f 7065 7261 7469 6e67 2073 7973 et operating sys │ │ │ │ -0001c320: 7465 6d73 2c20 616e 6420 736f 206f 6e29 tems, and so on) │ │ │ │ -0001c330: 2066 726f 6d20 7468 650a 2020 2020 2066 from the. f │ │ │ │ -0001c340: 696c 6520 7379 7374 656d 2061 7420 7275 ile system at ru │ │ │ │ -0001c350: 6e2d 7469 6d65 2e20 2054 6865 206d 6f64 n-time. The mod │ │ │ │ -0001c360: 756c 6172 2064 6573 6967 6e20 616c 6c6f ular design allo │ │ │ │ -0001c370: 7773 2074 6865 2063 6f72 6520 696d 6167 ws the core imag │ │ │ │ -0001c380: 650a 2020 2020 2074 6f20 6265 206b 6570 e. to be kep │ │ │ │ -0001c390: 7420 736d 616c 6c2c 2073 696e 6365 2074 t small, since t │ │ │ │ -0001c3a0: 6865 2061 7265 6173 206f 6620 6469 736b he areas of disk │ │ │ │ -0001c3b0: 2077 6865 7265 2069 7420 6d75 7374 2062 where it must b │ │ │ │ -0001c3c0: 650a 2020 2020 2069 6e73 7461 6c6c 6564 e. installed │ │ │ │ -0001c3d0: 2061 7265 206f 6674 656e 2061 7320 736d are often as sm │ │ │ │ -0001c3e0: 616c 6c20 6173 2033 324b 422e 0a0a 2020 all as 32KB... │ │ │ │ -0001c3f0: 2020 202a 4e6f 7465 2042 494f 5320 696e *Note BIOS in │ │ │ │ -0001c400: 7374 616c 6c61 7469 6f6e 3a3a 2c20 666f stallation::, fo │ │ │ │ -0001c410: 7220 6465 7461 696c 7320 6f6e 2077 6865 r details on whe │ │ │ │ -0001c420: 7265 2074 6865 2063 6f72 6520 696d 6167 re the core imag │ │ │ │ -0001c430: 6520 6361 6e0a 2020 2020 2062 6520 696e e can. be in │ │ │ │ -0001c440: 7374 616c 6c65 6420 6f6e 2050 4320 7379 stalled on PC sy │ │ │ │ -0001c450: 7374 656d 732e 0a0a 272a 2e6d 6f64 270a stems...'*.mod'. │ │ │ │ -0001c460: 2020 2020 2045 7665 7279 7468 696e 6720 Everything │ │ │ │ -0001c470: 656c 7365 2069 6e20 4752 5542 2072 6573 else in GRUB res │ │ │ │ -0001c480: 6964 6573 2069 6e20 6479 6e61 6d69 6361 ides in dynamica │ │ │ │ -0001c490: 6c6c 7920 6c6f 6164 6162 6c65 206d 6f64 lly loadable mod │ │ │ │ -0001c4a0: 756c 6573 2e0a 2020 2020 2054 6865 7365 ules.. These │ │ │ │ -0001c4b0: 2061 7265 206f 6674 656e 206c 6f61 6465 are often loade │ │ │ │ -0001c4c0: 6420 6175 746f 6d61 7469 6361 6c6c 792c d automatically, │ │ │ │ -0001c4d0: 206f 7220 6275 696c 7420 696e 746f 2074 or built into t │ │ │ │ -0001c4e0: 6865 2063 6f72 6520 696d 6167 650a 2020 he core image. │ │ │ │ -0001c4f0: 2020 2069 6620 7468 6579 2061 7265 2065 if they are e │ │ │ │ -0001c500: 7373 656e 7469 616c 2c20 6275 7420 6d61 ssential, but ma │ │ │ │ -0001c510: 7920 616c 736f 2062 6520 6c6f 6164 6564 y also be loaded │ │ │ │ -0001c520: 206d 616e 7561 6c6c 7920 7573 696e 6720 manually using │ │ │ │ -0001c530: 7468 650a 2020 2020 2027 696e 736d 6f64 the. 'insmod │ │ │ │ -0001c540: 2720 636f 6d6d 616e 6420 282a 6e6f 7465 ' command (*note │ │ │ │ -0001c550: 2069 6e73 6d6f 643a 3a29 2e0a 0a46 6f72 insmod::)...For │ │ │ │ -0001c560: 2047 5255 4220 4c65 6761 6379 2075 7365 GRUB Legacy use │ │ │ │ -0001c570: 7273 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d rs.============= │ │ │ │ -0001c580: 3d3d 3d3d 3d3d 3d3d 0a0a 4752 5542 2032 ========..GRUB 2 │ │ │ │ -0001c590: 2068 6173 2061 2064 6966 6665 7265 6e74 has a different │ │ │ │ -0001c5a0: 2064 6573 6967 6e20 6672 6f6d 2047 5255 design from GRU │ │ │ │ -0001c5b0: 4220 4c65 6761 6379 2c20 616e 6420 736f B Legacy, and so │ │ │ │ -0001c5c0: 2063 6f72 7265 7370 6f6e 6465 6e63 6573 correspondences │ │ │ │ -0001c5d0: 0a77 6974 6820 7468 6520 696d 6167 6573 .with the images │ │ │ │ -0001c5e0: 2069 7420 7573 6564 2063 616e 6e6f 7420 it used cannot │ │ │ │ -0001c5f0: 6265 2065 7861 6374 2e20 204e 6576 6572 be exact. Never │ │ │ │ -0001c600: 7468 656c 6573 732c 2047 5255 4220 4c65 theless, GRUB Le │ │ │ │ -0001c610: 6761 6379 0a75 7365 7273 206f 6674 656e gacy.users often │ │ │ │ -0001c620: 2061 736b 2071 7565 7374 696f 6e73 2069 ask questions i │ │ │ │ -0001c630: 6e20 7468 6520 7465 726d 7320 7468 6579 n the terms they │ │ │ │ -0001c640: 2061 7265 2066 616d 696c 6961 7220 7769 are familiar wi │ │ │ │ -0001c650: 7468 2c20 616e 6420 736f 0a68 6572 6520 th, and so.here │ │ │ │ -0001c660: 6973 2061 2062 7269 6566 2067 7569 6465 is a brief guide │ │ │ │ -0001c670: 2074 6f20 686f 7720 4752 5542 2032 2773 to how GRUB 2's │ │ │ │ -0001c680: 2069 6d61 6765 7320 7265 6c61 7465 2074 images relate t │ │ │ │ -0001c690: 6f20 7468 6174 2e0a 0a27 7374 6167 6531 o that...'stage1 │ │ │ │ -0001c6a0: 270a 2020 2020 2053 7461 6765 2031 2066 '. Stage 1 f │ │ │ │ -0001c6b0: 726f 6d20 4752 5542 204c 6567 6163 7920 rom GRUB Legacy │ │ │ │ -0001c6c0: 7761 7320 7665 7279 2073 696d 696c 6172 was very similar │ │ │ │ -0001c6d0: 2074 6f20 2762 6f6f 742e 696d 6727 2069 to 'boot.img' i │ │ │ │ -0001c6e0: 6e20 4752 5542 2032 2c0a 2020 2020 2061 n GRUB 2,. a │ │ │ │ -0001c6f0: 6e64 2074 6865 7920 7365 7276 6520 7468 nd they serve th │ │ │ │ -0001c700: 6520 7361 6d65 2066 756e 6374 696f 6e2e e same function. │ │ │ │ -0001c710: 0a0a 272a 5f73 7461 6765 315f 3527 0a20 ..'*_stage1_5'. │ │ │ │ -0001c720: 2020 2020 496e 2047 5255 4220 4c65 6761 In GRUB Lega │ │ │ │ -0001c730: 6379 2c20 5374 6167 6520 312e 3527 7320 cy, Stage 1.5's │ │ │ │ -0001c740: 6675 6e63 7469 6f6e 2077 6173 2074 6f20 function was to │ │ │ │ -0001c750: 696e 636c 7564 6520 656e 6f75 6768 0a20 include enough. │ │ │ │ -0001c760: 2020 2020 6669 6c65 7379 7374 656d 2063 filesystem c │ │ │ │ -0001c770: 6f64 6520 746f 2061 6c6c 6f77 2074 6865 ode to allow the │ │ │ │ -0001c780: 206d 7563 6820 6c61 7267 6572 2053 7461 much larger Sta │ │ │ │ -0001c790: 6765 2032 2074 6f20 6265 2072 6561 6420 ge 2 to be read │ │ │ │ -0001c7a0: 6672 6f6d 2061 6e0a 2020 2020 206f 7264 from an. ord │ │ │ │ -0001c7b0: 696e 6172 7920 6669 6c65 7379 7374 656d inary filesystem │ │ │ │ -0001c7c0: 2e20 2049 6e20 7468 6973 2072 6573 7065 . In this respe │ │ │ │ -0001c7d0: 6374 2c20 6974 7320 6675 6e63 7469 6f6e ct, its function │ │ │ │ -0001c7e0: 2077 6173 2073 696d 696c 6172 2074 6f0a was similar to. │ │ │ │ -0001c7f0: 2020 2020 2027 636f 7265 2e69 6d67 2720 'core.img' │ │ │ │ -0001c800: 696e 2047 5255 4220 322e 2020 486f 7765 in GRUB 2. Howe │ │ │ │ -0001c810: 7665 722c 2027 636f 7265 2e69 6d67 2720 ver, 'core.img' │ │ │ │ -0001c820: 6973 206d 7563 6820 6d6f 7265 2063 6170 is much more cap │ │ │ │ -0001c830: 6162 6c65 0a20 2020 2020 7468 616e 2053 able. than S │ │ │ │ -0001c840: 7461 6765 2031 2e35 2077 6173 3b20 7369 tage 1.5 was; si │ │ │ │ -0001c850: 6e63 6520 6974 206f 6666 6572 7320 6120 nce it offers a │ │ │ │ -0001c860: 7265 7363 7565 2073 6865 6c6c 2c20 6974 rescue shell, it │ │ │ │ -0001c870: 2069 7320 736f 6d65 7469 6d65 730a 2020 is sometimes. │ │ │ │ -0001c880: 2020 2070 6f73 7369 626c 6520 746f 2072 possible to r │ │ │ │ -0001c890: 6563 6f76 6572 206d 616e 7561 6c6c 7920 ecover manually │ │ │ │ -0001c8a0: 696e 2074 6865 2065 7665 6e74 2074 6861 in the event tha │ │ │ │ -0001c8b0: 7420 6974 2069 7320 756e 6162 6c65 2074 t it is unable t │ │ │ │ -0001c8c0: 6f20 6c6f 6164 0a20 2020 2020 616e 7920 o load. any │ │ │ │ -0001c8d0: 6f74 6865 7220 6d6f 6475 6c65 732c 2066 other modules, f │ │ │ │ -0001c8e0: 6f72 2065 7861 6d70 6c65 2069 6620 7061 or example if pa │ │ │ │ -0001c8f0: 7274 6974 696f 6e20 6e75 6d62 6572 7320 rtition numbers │ │ │ │ -0001c900: 6861 7665 2063 6861 6e67 6564 2e0a 2020 have changed.. │ │ │ │ -0001c910: 2020 2027 636f 7265 2e69 6d67 2720 6973 'core.img' is │ │ │ │ -0001c920: 2062 7569 6c74 2069 6e20 6120 6d6f 7265 built in a more │ │ │ │ -0001c930: 2066 6c65 7869 626c 6520 7761 792c 2061 flexible way, a │ │ │ │ -0001c940: 6c6c 6f77 696e 6720 4752 5542 2032 2074 llowing GRUB 2 t │ │ │ │ -0001c950: 6f0a 2020 2020 2073 7570 706f 7274 2072 o. support r │ │ │ │ -0001c960: 6561 6469 6e67 206d 6f64 756c 6573 2066 eading modules f │ │ │ │ -0001c970: 726f 6d20 6164 7661 6e63 6564 2064 6973 rom advanced dis │ │ │ │ -0001c980: 6b20 7479 7065 7320 7375 6368 2061 7320 k types such as │ │ │ │ -0001c990: 4c56 4d20 616e 640a 2020 2020 2052 4149 LVM and. RAI │ │ │ │ -0001c9a0: 442e 0a0a 2020 2020 2047 5255 4220 4c65 D... GRUB Le │ │ │ │ -0001c9b0: 6761 6379 2063 6f75 6c64 2072 756e 2077 gacy could run w │ │ │ │ -0001c9c0: 6974 6820 6f6e 6c79 2053 7461 6765 2031 ith only Stage 1 │ │ │ │ -0001c9d0: 2061 6e64 2053 7461 6765 2032 2069 6e20 and Stage 2 in │ │ │ │ -0001c9e0: 736f 6d65 206c 696d 6974 6564 0a20 2020 some limited. │ │ │ │ -0001c9f0: 2020 636f 6e66 6967 7572 6174 696f 6e73 configurations │ │ │ │ -0001ca00: 2c20 7768 696c 6520 4752 5542 2032 2072 , while GRUB 2 r │ │ │ │ -0001ca10: 6571 7569 7265 7320 2763 6f72 652e 696d equires 'core.im │ │ │ │ -0001ca20: 6727 2061 6e64 2063 616e 6e6f 7420 776f g' and cannot wo │ │ │ │ -0001ca30: 726b 0a20 2020 2020 7769 7468 6f75 7420 rk. without │ │ │ │ -0001ca40: 6974 2e0a 0a27 7374 6167 6532 270a 2020 it...'stage2'. │ │ │ │ -0001ca50: 2020 2047 5255 4220 3220 6861 7320 6e6f GRUB 2 has no │ │ │ │ -0001ca60: 2073 696e 676c 6520 5374 6167 6520 3220 single Stage 2 │ │ │ │ -0001ca70: 696d 6167 652e 2020 496e 7374 6561 642c image. Instead, │ │ │ │ -0001ca80: 2069 7420 6c6f 6164 7320 6d6f 6475 6c65 it loads module │ │ │ │ -0001ca90: 7320 6672 6f6d 0a20 2020 2020 272f 626f s from. '/bo │ │ │ │ -0001caa0: 6f74 2f67 7275 6227 2061 7420 7275 6e2d ot/grub' at run- │ │ │ │ -0001cab0: 7469 6d65 2e0a 0a27 7374 6167 6532 5f65 time...'stage2_e │ │ │ │ -0001cac0: 6c74 6f72 6974 6f27 0a20 2020 2020 496e ltorito'. In │ │ │ │ -0001cad0: 2047 5255 4220 322c 2069 6d61 6765 7320 GRUB 2, images │ │ │ │ -0001cae0: 666f 7220 626f 6f74 696e 6720 6672 6f6d for booting from │ │ │ │ -0001caf0: 2043 442d 524f 4d20 6472 6976 6573 2061 CD-ROM drives a │ │ │ │ -0001cb00: 7265 206e 6f77 0a20 2020 2020 636f 6e73 re now. cons │ │ │ │ -0001cb10: 7472 7563 7465 6420 7573 696e 6720 2763 tructed using 'c │ │ │ │ -0001cb20: 6462 6f6f 742e 696d 6727 2061 6e64 2027 dboot.img' and ' │ │ │ │ -0001cb30: 636f 7265 2e69 6d67 272c 206d 616b 696e core.img', makin │ │ │ │ -0001cb40: 6720 7375 7265 2074 6861 7420 7468 650a g sure that the. │ │ │ │ -0001cb50: 2020 2020 2063 6f72 6520 696d 6167 6520 core image │ │ │ │ -0001cb60: 636f 6e74 6169 6e73 2074 6865 2027 6973 contains the 'is │ │ │ │ -0001cb70: 6f39 3636 3027 206d 6f64 756c 652e 2020 o9660' module. │ │ │ │ -0001cb80: 4974 2069 7320 7573 7561 6c6c 7920 6265 It is usually be │ │ │ │ -0001cb90: 7374 2074 6f0a 2020 2020 2075 7365 2074 st to. use t │ │ │ │ -0001cba0: 6865 2027 6772 7562 2d6d 6b72 6573 6375 he 'grub-mkrescu │ │ │ │ -0001cbb0: 6527 2070 726f 6772 616d 2066 6f72 2074 e' program for t │ │ │ │ -0001cbc0: 6869 732e 0a0a 276e 6267 7275 6227 0a20 his...'nbgrub'. │ │ │ │ -0001cbd0: 2020 2020 5468 6572 6520 6973 2061 7320 There is as │ │ │ │ -0001cbe0: 7965 7420 6e6f 2065 7175 6976 616c 656e yet no equivalen │ │ │ │ -0001cbf0: 7420 666f 7220 276e 6267 7275 6227 2069 t for 'nbgrub' i │ │ │ │ -0001cc00: 6e20 4752 5542 2032 3b20 6974 2077 6173 n GRUB 2; it was │ │ │ │ -0001cc10: 2075 7365 640a 2020 2020 2062 7920 4574 used. by Et │ │ │ │ -0001cc20: 6865 7262 6f6f 7420 616e 6420 736f 6d65 herboot and some │ │ │ │ -0001cc30: 206f 7468 6572 206e 6574 776f 726b 2062 other network b │ │ │ │ -0001cc40: 6f6f 7420 6c6f 6164 6572 732e 0a0a 2770 oot loaders...'p │ │ │ │ -0001cc50: 7865 6772 7562 270a 2020 2020 2049 6e20 xegrub'. In │ │ │ │ -0001cc60: 4752 5542 2032 2c20 696d 6167 6573 2066 GRUB 2, images f │ │ │ │ -0001cc70: 6f72 2050 5845 206e 6574 776f 726b 2062 or PXE network b │ │ │ │ -0001cc80: 6f6f 7469 6e67 2061 7265 206e 6f77 2063 ooting are now c │ │ │ │ -0001cc90: 6f6e 7374 7275 6374 6564 2075 7369 6e67 onstructed using │ │ │ │ -0001cca0: 0a20 2020 2020 2770 7865 626f 6f74 2e69 . 'pxeboot.i │ │ │ │ -0001ccb0: 6d67 2720 616e 6420 2763 6f72 652e 696d mg' and 'core.im │ │ │ │ -0001ccc0: 6727 2c20 6d61 6b69 6e67 2073 7572 6520 g', making sure │ │ │ │ -0001ccd0: 7468 6174 2074 6865 2063 6f72 6520 696d that the core im │ │ │ │ -0001cce0: 6167 650a 2020 2020 2063 6f6e 7461 696e age. contain │ │ │ │ -0001ccf0: 7320 7468 6520 2770 7865 2720 616e 6420 s the 'pxe' and │ │ │ │ -0001cd00: 2770 7865 636d 6427 206d 6f64 756c 6573 'pxecmd' modules │ │ │ │ -0001cd10: 2e20 202a 4e6f 7465 204e 6574 776f 726b . *Note Network │ │ │ │ -0001cd20: 3a3a 2e0a 0a1f 0a46 696c 653a 2067 7275 ::.....File: gru │ │ │ │ -0001cd30: 622e 696e 666f 2c20 204e 6f64 653a 2043 b.info, Node: C │ │ │ │ -0001cd40: 6f72 6520 696d 6167 6520 7369 7a65 206c ore image size l │ │ │ │ -0001cd50: 696d 6974 6174 696f 6e2c 2020 4e65 7874 imitation, Next │ │ │ │ -0001cd60: 3a20 4669 6c65 7379 7374 656d 2c20 2050 : Filesystem, P │ │ │ │ -0001cd70: 7265 763a 2049 6d61 6765 732c 2020 5570 rev: Images, Up │ │ │ │ -0001cd80: 3a20 546f 700a 0a31 3220 436f 7265 2069 : Top..12 Core i │ │ │ │ -0001cd90: 6d61 6765 2073 697a 6520 6c69 6d69 7461 mage size limita │ │ │ │ -0001cda0: 7469 6f6e 0a2a 2a2a 2a2a 2a2a 2a2a 2a2a tion.*********** │ │ │ │ +0001b2d0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a0a 0a53 6f6d ***********..Som │ │ │ │ +0001b2e0: 6520 6c61 7074 6f70 2076 656e 646f 7273 e laptop vendors │ │ │ │ +0001b2f0: 2070 726f 7669 6465 2061 6e20 6164 6469 provide an addi │ │ │ │ +0001b300: 7469 6f6e 616c 2070 6f77 6572 2d6f 6e20 tional power-on │ │ │ │ +0001b310: 6275 7474 6f6e 2077 6869 6368 2062 6f6f button which boo │ │ │ │ +0001b320: 7473 0a61 6e6f 7468 6572 204f 532e 2047 ts.another OS. G │ │ │ │ +0001b330: 5255 4220 7375 7070 6f72 7473 2073 7563 RUB supports suc │ │ │ │ +0001b340: 6820 6275 7474 6f6e 7320 7769 7468 2074 h buttons with t │ │ │ │ +0001b350: 6865 2027 4752 5542 5f54 494d 454f 5554 he 'GRUB_TIMEOUT │ │ │ │ +0001b360: 5f42 5554 544f 4e27 2c0a 2747 5255 425f _BUTTON',.'GRUB_ │ │ │ │ +0001b370: 5449 4d45 4f55 545f 5354 594c 455f 4255 TIMEOUT_STYLE_BU │ │ │ │ +0001b380: 5454 4f4e 272c 2027 4752 5542 5f44 4546 TTON', 'GRUB_DEF │ │ │ │ +0001b390: 4155 4c54 5f42 5554 544f 4e27 2c20 616e AULT_BUTTON', an │ │ │ │ +0001b3a0: 640a 2747 5255 425f 4255 5454 4f4e 5f43 d.'GRUB_BUTTON_C │ │ │ │ +0001b3b0: 4d4f 535f 4144 4452 4553 5327 2076 6172 MOS_ADDRESS' var │ │ │ │ +0001b3c0: 6961 626c 6573 2069 6e20 6465 6661 756c iables in defaul │ │ │ │ +0001b3d0: 742f 6772 7562 2028 2a6e 6f74 6520 5369 t/grub (*note Si │ │ │ │ +0001b3e0: 6d70 6c65 0a63 6f6e 6669 6775 7261 7469 mple.configurati │ │ │ │ +0001b3f0: 6f6e 3a3a 292e 2020 2747 5255 425f 5449 on::). 'GRUB_TI │ │ │ │ +0001b400: 4d45 4f55 545f 4255 5454 4f4e 272c 2027 MEOUT_BUTTON', ' │ │ │ │ +0001b410: 4752 5542 5f54 494d 454f 5554 5f53 5459 GRUB_TIMEOUT_STY │ │ │ │ +0001b420: 4c45 5f42 5554 544f 4e27 2c0a 616e 6420 LE_BUTTON',.and │ │ │ │ +0001b430: 2747 5255 425f 4445 4641 554c 545f 4255 'GRUB_DEFAULT_BU │ │ │ │ +0001b440: 5454 4f4e 2720 6172 6520 7573 6564 2069 TTON' are used i │ │ │ │ +0001b450: 6e73 7465 6164 206f 6620 7468 6520 636f nstead of the co │ │ │ │ +0001b460: 7272 6573 706f 6e64 696e 670a 7661 7269 rresponding.vari │ │ │ │ +0001b470: 6162 6c65 7320 7769 7468 6f75 7420 7468 ables without th │ │ │ │ +0001b480: 6520 275f 4255 5454 4f4e 2720 7375 6666 e '_BUTTON' suff │ │ │ │ +0001b490: 6978 2077 6865 6e20 706f 7765 7265 6420 ix when powered │ │ │ │ +0001b4a0: 6f6e 2075 7369 6e67 2074 6865 2073 7065 on using the spe │ │ │ │ +0001b4b0: 6369 616c 0a62 7574 746f 6e2e 2020 2747 cial.button. 'G │ │ │ │ +0001b4c0: 5255 425f 4255 5454 4f4e 5f43 4d4f 535f RUB_BUTTON_CMOS_ │ │ │ │ +0001b4d0: 4144 4452 4553 5327 2069 7320 7665 6e64 ADDRESS' is vend │ │ │ │ +0001b4e0: 6f72 2d73 7065 6369 6669 6320 616e 6420 or-specific and │ │ │ │ +0001b4f0: 7061 7274 6961 6c6c 790a 6d6f 6465 6c2d partially.model- │ │ │ │ +0001b500: 7370 6563 6966 6963 2e20 2056 616c 7565 specific. Value │ │ │ │ +0001b510: 7320 6b6e 6f77 6e20 746f 2074 6865 2047 s known to the G │ │ │ │ +0001b520: 5255 4220 7465 616d 2061 7265 3a0a 0a3c RUB team are:..< │ │ │ │ +0001b530: 4465 6c6c 2058 5053 204d 3133 3330 4d3e Dell XPS M1330M> │ │ │ │ +0001b540: 0a20 2020 2020 3132 313a 330a 3c44 656c . 121:3.. │ │ │ │ +0001b560: 2020 3835 3a33 0a3c 4465 6c6c 204c 6174 85:3.. │ │ │ │ +0001b580: 2020 3835 3a33 0a3c 4173 7573 2045 6565 85:3.. │ │ │ │ +0001b5a0: 3834 3a31 2028 756e 636f 6e66 6972 6d65 84:1 (unconfirme │ │ │ │ +0001b5b0: 6429 0a3c 4c45 4e4f 564f 2054 6869 6e6b d).. 101:3. │ │ │ │ +0001b5e0: 0a20 2020 546f 2074 616b 6520 6675 6c6c . To take full │ │ │ │ +0001b5f0: 2061 6476 616e 7461 6765 206f 6620 7468 advantage of th │ │ │ │ +0001b600: 6973 2066 756e 6374 696f 6e2c 2069 6e73 is function, ins │ │ │ │ +0001b610: 7461 6c6c 2047 5255 4220 696e 746f 2074 tall GRUB into t │ │ │ │ +0001b620: 6865 204d 4252 0a28 2a6e 6f74 6520 496e he MBR.(*note In │ │ │ │ +0001b630: 7374 616c 6c69 6e67 2047 5255 4220 7573 stalling GRUB us │ │ │ │ +0001b640: 696e 6720 6772 7562 2d69 6e73 7461 6c6c ing grub-install │ │ │ │ +0001b650: 3a3a 292e 0a0a 2020 2049 6620 796f 7520 ::)... If you │ │ │ │ +0001b660: 6861 7665 2061 206c 6170 746f 7020 7768 have a laptop wh │ │ │ │ +0001b670: 6963 6820 6861 7320 6120 7369 6d69 6c61 ich has a simila │ │ │ │ +0001b680: 7220 6665 6174 7572 6520 616e 6420 6e6f r feature and no │ │ │ │ +0001b690: 7420 696e 2074 6865 2061 626f 7665 0a6c t in the above.l │ │ │ │ +0001b6a0: 6973 7420 636f 756c 6420 796f 7520 6669 ist could you fi │ │ │ │ +0001b6b0: 6775 7265 2079 6f75 7220 6164 6472 6573 gure your addres │ │ │ │ +0001b6c0: 7320 616e 6420 636f 6e74 7269 6275 7465 s and contribute │ │ │ │ +0001b6d0: 3f20 2054 6f20 6469 7363 6f76 6572 2074 ? To discover t │ │ │ │ +0001b6e0: 6865 0a61 6464 7265 7373 2064 6f20 7468 he.address do th │ │ │ │ +0001b6f0: 6520 666f 6c6c 6f77 696e 673a 0a20 2020 e following:. │ │ │ │ +0001b700: 2a20 626f 6f74 206e 6f72 6d61 6c6c 790a * boot normally. │ │ │ │ +0001b710: 2020 202a 2020 2020 2020 7375 646f 206d * sudo m │ │ │ │ +0001b720: 6f64 7072 6f62 6520 6e76 7261 6d0a 2020 odprobe nvram. │ │ │ │ +0001b730: 2020 2020 2020 2020 7375 646f 2063 6174 sudo cat │ │ │ │ +0001b740: 202f 6465 762f 6e76 7261 6d20 7c20 7878 /dev/nvram | xx │ │ │ │ +0001b750: 6420 3e20 6e6f 726d 616c 5f62 7574 746f d > normal_butto │ │ │ │ +0001b760: 6e2e 7478 740a 2020 202a 2062 6f6f 7420 n.txt. * boot │ │ │ │ +0001b770: 7573 696e 6720 7665 6e64 6f72 2062 7574 using vendor but │ │ │ │ +0001b780: 746f 6e0a 2020 202a 2020 2020 2020 7375 ton. * su │ │ │ │ +0001b790: 646f 206d 6f64 7072 6f62 6520 6e76 7261 do modprobe nvra │ │ │ │ +0001b7a0: 6d0a 2020 2020 2020 2020 2020 7375 646f m. sudo │ │ │ │ +0001b7b0: 2063 6174 202f 6465 762f 6e76 7261 6d20 cat /dev/nvram │ │ │ │ +0001b7c0: 7c20 7878 6420 3e20 6e6f 726d 616c 5f76 | xxd > normal_v │ │ │ │ +0001b7d0: 656e 646f 722e 7478 740a 0a20 2020 5468 endor.txt.. Th │ │ │ │ +0001b7e0: 656e 2063 6f6d 7061 7265 2074 6865 7365 en compare these │ │ │ │ +0001b7f0: 2074 6578 7420 6669 6c65 7320 616e 6420 text files and │ │ │ │ +0001b800: 6669 6e64 2077 6865 7265 2061 2062 6974 find where a bit │ │ │ │ +0001b810: 2077 6173 2074 6f67 676c 6564 2e20 2045 was toggled. E │ │ │ │ +0001b820: 2e67 2e0a 696e 2063 6173 6520 6f66 2044 .g..in case of D │ │ │ │ +0001b830: 656c 6c20 5850 5320 6974 2077 6173 3a0a ell XPS it was:. │ │ │ │ +0001b840: 2020 2020 2062 7974 6520 3078 3437 3a20 byte 0x47: │ │ │ │ +0001b850: 3230 202d 2d3e 2032 380a 2020 2049 7427 20 --> 28. It' │ │ │ │ +0001b860: 7320 6120 6269 7420 6e75 6d62 6572 2033 s a bit number 3 │ │ │ │ +0001b870: 2061 7320 7365 656e 2066 726f 6d20 666f as seen from fo │ │ │ │ +0001b880: 6c6c 6f77 696e 6720 7461 626c 653a 0a30 llowing table:.0 │ │ │ │ +0001b890: 2020 2020 2020 2020 2020 2020 2020 3031 01 │ │ │ │ +0001b8a0: 0a31 2020 2020 2020 2020 2020 2020 2020 .1 │ │ │ │ +0001b8b0: 3032 0a32 2020 2020 2020 2020 2020 2020 02.2 │ │ │ │ +0001b8c0: 2020 3034 0a33 2020 2020 2020 2020 2020 04.3 │ │ │ │ +0001b8d0: 2020 2020 3038 0a34 2020 2020 2020 2020 08.4 │ │ │ │ +0001b8e0: 2020 2020 2020 3130 0a35 2020 2020 2020 10.5 │ │ │ │ +0001b8f0: 2020 2020 2020 2020 3230 0a36 2020 2020 20.6 │ │ │ │ +0001b900: 2020 2020 2020 2020 2020 3430 0a37 2020 40.7 │ │ │ │ +0001b910: 2020 2020 2020 2020 2020 2020 3830 0a0a 80.. │ │ │ │ +0001b920: 2020 2030 7834 3720 6973 2064 6563 696d 0x47 is decim │ │ │ │ +0001b930: 616c 2037 312e 2020 4c69 6e75 7820 6e76 al 71. Linux nv │ │ │ │ +0001b940: 7261 6d20 696d 706c 656d 656e 7461 7469 ram implementati │ │ │ │ +0001b950: 6f6e 2063 7574 7320 6669 7273 7420 3134 on cuts first 14 │ │ │ │ +0001b960: 2062 7974 6573 0a6f 6620 434d 4f53 2e20 bytes.of CMOS. │ │ │ │ +0001b970: 536f 2074 6865 2072 6561 6c20 6279 7465 So the real byte │ │ │ │ +0001b980: 2061 6464 7265 7373 2069 6e20 434d 4f53 address in CMOS │ │ │ │ +0001b990: 2069 7320 3731 2b31 343d 3835 2053 6f20 is 71+14=85 So │ │ │ │ +0001b9a0: 636f 6d70 6c65 7465 0a61 6464 7265 7373 complete.address │ │ │ │ +0001b9b0: 2069 7320 3835 3a33 0a0a 1f0a 4669 6c65 is 85:3....File │ │ │ │ +0001b9c0: 3a20 6772 7562 2e69 6e66 6f2c 2020 4e6f : grub.info, No │ │ │ │ +0001b9d0: 6465 3a20 496d 6167 6573 2c20 204e 6578 de: Images, Nex │ │ │ │ +0001b9e0: 743a 2043 6f72 6520 696d 6167 6520 7369 t: Core image si │ │ │ │ +0001b9f0: 7a65 206c 696d 6974 6174 696f 6e2c 2020 ze limitation, │ │ │ │ +0001ba00: 5072 6576 3a20 5665 6e64 6f72 2070 6f77 Prev: Vendor pow │ │ │ │ +0001ba10: 6572 2d6f 6e20 6b65 7973 2c20 2055 703a er-on keys, Up: │ │ │ │ +0001ba20: 2054 6f70 0a0a 3131 2047 5255 4220 696d Top..11 GRUB im │ │ │ │ +0001ba30: 6167 6520 6669 6c65 730a 2a2a 2a2a 2a2a age files.****** │ │ │ │ +0001ba40: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a0a 0a47 *************..G │ │ │ │ +0001ba50: 5255 4220 636f 6e73 6973 7473 206f 6620 RUB consists of │ │ │ │ +0001ba60: 7365 7665 7261 6c20 696d 6167 6573 3a20 several images: │ │ │ │ +0001ba70: 6120 7661 7269 6574 7920 6f66 2062 6f6f a variety of boo │ │ │ │ +0001ba80: 7473 7472 6170 2069 6d61 6765 7320 666f tstrap images fo │ │ │ │ +0001ba90: 720a 7374 6172 7469 6e67 2047 5255 4220 r.starting GRUB │ │ │ │ +0001baa0: 696e 2076 6172 696f 7573 2077 6179 732c in various ways, │ │ │ │ +0001bab0: 2061 206b 6572 6e65 6c20 696d 6167 652c a kernel image, │ │ │ │ +0001bac0: 2061 6e64 2061 2073 6574 206f 6620 6d6f and a set of mo │ │ │ │ +0001bad0: 6475 6c65 730a 7768 6963 6820 6172 6520 dules.which are │ │ │ │ +0001bae0: 636f 6d62 696e 6564 2077 6974 6820 7468 combined with th │ │ │ │ +0001baf0: 6520 6b65 726e 656c 2069 6d61 6765 2074 e kernel image t │ │ │ │ +0001bb00: 6f20 666f 726d 2061 2063 6f72 6520 696d o form a core im │ │ │ │ +0001bb10: 6167 652e 2020 4865 7265 2069 730a 6120 age. Here is.a │ │ │ │ +0001bb20: 7368 6f72 7420 6f76 6572 7669 6577 206f short overview o │ │ │ │ +0001bb30: 6620 7468 656d 2e0a 0a27 626f 6f74 2e69 f them...'boot.i │ │ │ │ +0001bb40: 6d67 270a 2020 2020 204f 6e20 5043 2042 mg'. On PC B │ │ │ │ +0001bb50: 494f 5320 7379 7374 656d 732c 2074 6869 IOS systems, thi │ │ │ │ +0001bb60: 7320 696d 6167 6520 6973 2074 6865 2066 s image is the f │ │ │ │ +0001bb70: 6972 7374 2070 6172 7420 6f66 2047 5255 irst part of GRU │ │ │ │ +0001bb80: 4220 746f 2073 7461 7274 2e0a 2020 2020 B to start.. │ │ │ │ +0001bb90: 2049 7420 6973 2077 7269 7474 656e 2074 It is written t │ │ │ │ +0001bba0: 6f20 6120 6d61 7374 6572 2062 6f6f 7420 o a master boot │ │ │ │ +0001bbb0: 7265 636f 7264 2028 4d42 5229 206f 7220 record (MBR) or │ │ │ │ +0001bbc0: 746f 2074 6865 2062 6f6f 7420 7365 6374 to the boot sect │ │ │ │ +0001bbd0: 6f72 0a20 2020 2020 6f66 2061 2070 6172 or. of a par │ │ │ │ +0001bbe0: 7469 7469 6f6e 2e20 2042 6563 6175 7365 tition. Because │ │ │ │ +0001bbf0: 2061 2050 4320 626f 6f74 2073 6563 746f a PC boot secto │ │ │ │ +0001bc00: 7220 6973 2035 3132 2062 7974 6573 2c20 r is 512 bytes, │ │ │ │ +0001bc10: 7468 6520 7369 7a65 206f 660a 2020 2020 the size of. │ │ │ │ +0001bc20: 2074 6869 7320 696d 6167 6520 6973 2065 this image is e │ │ │ │ +0001bc30: 7861 6374 6c79 2035 3132 2062 7974 6573 xactly 512 bytes │ │ │ │ +0001bc40: 2e0a 0a20 2020 2020 5468 6520 736f 6c65 ... The sole │ │ │ │ +0001bc50: 2066 756e 6374 696f 6e20 6f66 2027 626f function of 'bo │ │ │ │ +0001bc60: 6f74 2e69 6d67 2720 6973 2074 6f20 7265 ot.img' is to re │ │ │ │ +0001bc70: 6164 2074 6865 2066 6972 7374 2073 6563 ad the first sec │ │ │ │ +0001bc80: 746f 7220 6f66 2074 6865 0a20 2020 2020 tor of the. │ │ │ │ +0001bc90: 636f 7265 2069 6d61 6765 2066 726f 6d20 core image from │ │ │ │ +0001bca0: 6120 6c6f 6361 6c20 6469 736b 2061 6e64 a local disk and │ │ │ │ +0001bcb0: 206a 756d 7020 746f 2069 742e 2020 4265 jump to it. Be │ │ │ │ +0001bcc0: 6361 7573 6520 6f66 2074 6865 2073 697a cause of the siz │ │ │ │ +0001bcd0: 650a 2020 2020 2072 6573 7472 6963 7469 e. restricti │ │ │ │ +0001bce0: 6f6e 2c20 2762 6f6f 742e 696d 6727 2063 on, 'boot.img' c │ │ │ │ +0001bcf0: 616e 6e6f 7420 756e 6465 7273 7461 6e64 annot understand │ │ │ │ +0001bd00: 2061 6e79 2066 696c 6520 7379 7374 656d any file system │ │ │ │ +0001bd10: 0a20 2020 2020 7374 7275 6374 7572 652c . structure, │ │ │ │ +0001bd20: 2073 6f20 2767 7275 622d 696e 7374 616c so 'grub-instal │ │ │ │ +0001bd30: 6c27 2068 6172 6463 6f64 6573 2074 6865 l' hardcodes the │ │ │ │ +0001bd40: 206c 6f63 6174 696f 6e20 6f66 2074 6865 location of the │ │ │ │ +0001bd50: 2066 6972 7374 0a20 2020 2020 7365 6374 first. sect │ │ │ │ +0001bd60: 6f72 206f 6620 7468 6520 636f 7265 2069 or of the core i │ │ │ │ +0001bd70: 6d61 6765 2069 6e74 6f20 2762 6f6f 742e mage into 'boot. │ │ │ │ +0001bd80: 696d 6727 2077 6865 6e20 696e 7374 616c img' when instal │ │ │ │ +0001bd90: 6c69 6e67 2047 5255 422e 0a0a 2764 6973 ling GRUB...'dis │ │ │ │ +0001bda0: 6b62 6f6f 742e 696d 6727 0a20 2020 2020 kboot.img'. │ │ │ │ +0001bdb0: 5468 6973 2069 6d61 6765 2069 7320 7573 This image is us │ │ │ │ +0001bdc0: 6564 2061 7320 7468 6520 6669 7273 7420 ed as the first │ │ │ │ +0001bdd0: 7365 6374 6f72 206f 6620 7468 6520 636f sector of the co │ │ │ │ +0001bde0: 7265 2069 6d61 6765 2077 6865 6e0a 2020 re image when. │ │ │ │ +0001bdf0: 2020 2062 6f6f 7469 6e67 2066 726f 6d20 booting from │ │ │ │ +0001be00: 6120 6861 7264 2064 6973 6b2e 2020 4974 a hard disk. It │ │ │ │ +0001be10: 2072 6561 6473 2074 6865 2072 6573 7420 reads the rest │ │ │ │ +0001be20: 6f66 2074 6865 2063 6f72 6520 696d 6167 of the core imag │ │ │ │ +0001be30: 6520 696e 746f 0a20 2020 2020 6d65 6d6f e into. memo │ │ │ │ +0001be40: 7279 2061 6e64 2073 7461 7274 7320 7468 ry and starts th │ │ │ │ +0001be50: 6520 6b65 726e 656c 2e20 2053 696e 6365 e kernel. Since │ │ │ │ +0001be60: 2066 696c 6520 7379 7374 656d 2068 616e file system han │ │ │ │ +0001be70: 646c 696e 6720 6973 206e 6f74 0a20 2020 dling is not. │ │ │ │ +0001be80: 2020 7965 7420 6176 6169 6c61 626c 652c yet available, │ │ │ │ +0001be90: 2069 7420 656e 636f 6465 7320 7468 6520 it encodes the │ │ │ │ +0001bea0: 6c6f 6361 7469 6f6e 206f 6620 7468 6520 location of the │ │ │ │ +0001beb0: 636f 7265 2069 6d61 6765 2075 7369 6e67 core image using │ │ │ │ +0001bec0: 2061 0a20 2020 2020 626c 6f63 6b20 6c69 a. block li │ │ │ │ +0001bed0: 7374 2066 6f72 6d61 742e 0a0a 2763 6462 st format...'cdb │ │ │ │ +0001bee0: 6f6f 742e 696d 6727 0a20 2020 2020 5468 oot.img'. Th │ │ │ │ +0001bef0: 6973 2069 6d61 6765 2069 7320 7573 6564 is image is used │ │ │ │ +0001bf00: 2061 7320 7468 6520 6669 7273 7420 7365 as the first se │ │ │ │ +0001bf10: 6374 6f72 206f 6620 7468 6520 636f 7265 ctor of the core │ │ │ │ +0001bf20: 2069 6d61 6765 2077 6865 6e0a 2020 2020 image when. │ │ │ │ +0001bf30: 2062 6f6f 7469 6e67 2066 726f 6d20 6120 booting from a │ │ │ │ +0001bf40: 4344 2d52 4f4d 2064 7269 7665 2e20 2049 CD-ROM drive. I │ │ │ │ +0001bf50: 7420 7065 7266 6f72 6d73 2061 2073 696d t performs a sim │ │ │ │ +0001bf60: 696c 6172 2066 756e 6374 696f 6e20 746f ilar function to │ │ │ │ +0001bf70: 0a20 2020 2020 2764 6973 6b62 6f6f 742e . 'diskboot. │ │ │ │ +0001bf80: 696d 6727 2e0a 0a27 7078 6562 6f6f 742e img'...'pxeboot. │ │ │ │ +0001bf90: 696d 6727 0a20 2020 2020 5468 6973 2069 img'. This i │ │ │ │ +0001bfa0: 6d61 6765 2069 7320 7573 6564 2061 7320 mage is used as │ │ │ │ +0001bfb0: 7468 6520 7374 6172 7420 6f66 2074 6865 the start of the │ │ │ │ +0001bfc0: 2063 6f72 6520 696d 6167 6520 7768 656e core image when │ │ │ │ +0001bfd0: 2062 6f6f 7469 6e67 2066 726f 6d0a 2020 booting from. │ │ │ │ +0001bfe0: 2020 2074 6865 206e 6574 776f 726b 2075 the network u │ │ │ │ +0001bff0: 7369 6e67 2050 5845 2e20 2a4e 6f74 6520 sing PXE. *Note │ │ │ │ +0001c000: 4e65 7477 6f72 6b3a 3a2e 0a0a 276c 6e78 Network::...'lnx │ │ │ │ +0001c010: 626f 6f74 2e69 6d67 270a 2020 2020 2054 boot.img'. T │ │ │ │ +0001c020: 6869 7320 696d 6167 6520 6d61 7920 6265 his image may be │ │ │ │ +0001c030: 2070 6c61 6365 6420 6174 2074 6865 2073 placed at the s │ │ │ │ +0001c040: 7461 7274 206f 6620 7468 6520 636f 7265 tart of the core │ │ │ │ +0001c050: 2069 6d61 6765 2069 6e20 6f72 6465 7220 image in order │ │ │ │ +0001c060: 746f 0a20 2020 2020 6d61 6b65 2047 5255 to. make GRU │ │ │ │ +0001c070: 4220 6c6f 6f6b 2065 6e6f 7567 6820 6c69 B look enough li │ │ │ │ +0001c080: 6b65 2061 204c 696e 7578 206b 6572 6e65 ke a Linux kerne │ │ │ │ +0001c090: 6c20 7468 6174 2069 7420 6361 6e20 6265 l that it can be │ │ │ │ +0001c0a0: 2062 6f6f 7465 6420 6279 0a20 2020 2020 booted by. │ │ │ │ +0001c0b0: 4c49 4c4f 2075 7369 6e67 2061 6e20 2769 LILO using an 'i │ │ │ │ +0001c0c0: 6d61 6765 3d27 2073 6563 7469 6f6e 2e0a mage=' section.. │ │ │ │ +0001c0d0: 0a27 6b65 726e 656c 2e69 6d67 270a 2020 .'kernel.img'. │ │ │ │ +0001c0e0: 2020 2054 6869 7320 696d 6167 6520 636f This image co │ │ │ │ +0001c0f0: 6e74 6169 6e73 2047 5255 4227 7320 6261 ntains GRUB's ba │ │ │ │ +0001c100: 7369 6320 7275 6e2d 7469 6d65 2066 6163 sic run-time fac │ │ │ │ +0001c110: 696c 6974 6965 733a 2066 7261 6d65 776f ilities: framewo │ │ │ │ +0001c120: 726b 730a 2020 2020 2066 6f72 2064 6576 rks. for dev │ │ │ │ +0001c130: 6963 6520 616e 6420 6669 6c65 2068 616e ice and file han │ │ │ │ +0001c140: 646c 696e 672c 2065 6e76 6972 6f6e 6d65 dling, environme │ │ │ │ +0001c150: 6e74 2076 6172 6961 626c 6573 2c20 7468 nt variables, th │ │ │ │ +0001c160: 6520 7265 7363 7565 0a20 2020 2020 6d6f e rescue. mo │ │ │ │ +0001c170: 6465 2063 6f6d 6d61 6e64 2d6c 696e 6520 de command-line │ │ │ │ +0001c180: 7061 7273 6572 2c20 616e 6420 736f 206f parser, and so o │ │ │ │ +0001c190: 6e2e 2020 4974 2069 7320 7261 7265 6c79 n. It is rarely │ │ │ │ +0001c1a0: 2075 7365 6420 6469 7265 6374 6c79 2c0a used directly,. │ │ │ │ +0001c1b0: 2020 2020 2062 7574 2069 7320 6275 696c but is buil │ │ │ │ +0001c1c0: 7420 696e 746f 2061 6c6c 2063 6f72 6520 t into all core │ │ │ │ +0001c1d0: 696d 6167 6573 2e0a 0a27 636f 7265 2e69 images...'core.i │ │ │ │ +0001c1e0: 6d67 270a 2020 2020 2054 6869 7320 6973 mg'. This is │ │ │ │ +0001c1f0: 2074 6865 2063 6f72 6520 696d 6167 6520 the core image │ │ │ │ +0001c200: 6f66 2047 5255 422e 2049 7420 6973 2062 of GRUB. It is b │ │ │ │ +0001c210: 7569 6c74 2064 796e 616d 6963 616c 6c79 uilt dynamically │ │ │ │ +0001c220: 2066 726f 6d20 7468 650a 2020 2020 206b from the. k │ │ │ │ +0001c230: 6572 6e65 6c20 696d 6167 6520 616e 6420 ernel image and │ │ │ │ +0001c240: 616e 2061 7262 6974 7261 7279 206c 6973 an arbitrary lis │ │ │ │ +0001c250: 7420 6f66 206d 6f64 756c 6573 2062 7920 t of modules by │ │ │ │ +0001c260: 7468 6520 2767 7275 622d 6d6b 696d 6167 the 'grub-mkimag │ │ │ │ +0001c270: 6527 0a20 2020 2020 7072 6f67 7261 6d2e e'. program. │ │ │ │ +0001c280: 2020 5573 7561 6c6c 792c 2069 7420 636f Usually, it co │ │ │ │ +0001c290: 6e74 6169 6e73 2065 6e6f 7567 6820 6d6f ntains enough mo │ │ │ │ +0001c2a0: 6475 6c65 7320 746f 2061 6363 6573 730a dules to access. │ │ │ │ +0001c2b0: 2020 2020 2027 2f62 6f6f 742f 6772 7562 '/boot/grub │ │ │ │ +0001c2c0: 272c 2061 6e64 206c 6f61 6473 2065 7665 ', and loads eve │ │ │ │ +0001c2d0: 7279 7468 696e 6720 656c 7365 2028 696e rything else (in │ │ │ │ +0001c2e0: 636c 7564 696e 6720 6d65 6e75 2068 616e cluding menu han │ │ │ │ +0001c2f0: 646c 696e 672c 0a20 2020 2020 7468 6520 dling,. the │ │ │ │ +0001c300: 6162 696c 6974 7920 746f 206c 6f61 6420 ability to load │ │ │ │ +0001c310: 7461 7267 6574 206f 7065 7261 7469 6e67 target operating │ │ │ │ +0001c320: 2073 7973 7465 6d73 2c20 616e 6420 736f systems, and so │ │ │ │ +0001c330: 206f 6e29 2066 726f 6d20 7468 650a 2020 on) from the. │ │ │ │ +0001c340: 2020 2066 696c 6520 7379 7374 656d 2061 file system a │ │ │ │ +0001c350: 7420 7275 6e2d 7469 6d65 2e20 2054 6865 t run-time. The │ │ │ │ +0001c360: 206d 6f64 756c 6172 2064 6573 6967 6e20 modular design │ │ │ │ +0001c370: 616c 6c6f 7773 2074 6865 2063 6f72 6520 allows the core │ │ │ │ +0001c380: 696d 6167 650a 2020 2020 2074 6f20 6265 image. to be │ │ │ │ +0001c390: 206b 6570 7420 736d 616c 6c2c 2073 696e kept small, sin │ │ │ │ +0001c3a0: 6365 2074 6865 2061 7265 6173 206f 6620 ce the areas of │ │ │ │ +0001c3b0: 6469 736b 2077 6865 7265 2069 7420 6d75 disk where it mu │ │ │ │ +0001c3c0: 7374 2062 650a 2020 2020 2069 6e73 7461 st be. insta │ │ │ │ +0001c3d0: 6c6c 6564 2061 7265 206f 6674 656e 2061 lled are often a │ │ │ │ +0001c3e0: 7320 736d 616c 6c20 6173 2033 324b 422e s small as 32KB. │ │ │ │ +0001c3f0: 0a0a 2020 2020 202a 4e6f 7465 2042 494f .. *Note BIO │ │ │ │ +0001c400: 5320 696e 7374 616c 6c61 7469 6f6e 3a3a S installation:: │ │ │ │ +0001c410: 2c20 666f 7220 6465 7461 696c 7320 6f6e , for details on │ │ │ │ +0001c420: 2077 6865 7265 2074 6865 2063 6f72 6520 where the core │ │ │ │ +0001c430: 696d 6167 6520 6361 6e0a 2020 2020 2062 image can. b │ │ │ │ +0001c440: 6520 696e 7374 616c 6c65 6420 6f6e 2050 e installed on P │ │ │ │ +0001c450: 4320 7379 7374 656d 732e 0a0a 272a 2e6d C systems...'*.m │ │ │ │ +0001c460: 6f64 270a 2020 2020 2045 7665 7279 7468 od'. Everyth │ │ │ │ +0001c470: 696e 6720 656c 7365 2069 6e20 4752 5542 ing else in GRUB │ │ │ │ +0001c480: 2072 6573 6964 6573 2069 6e20 6479 6e61 resides in dyna │ │ │ │ +0001c490: 6d69 6361 6c6c 7920 6c6f 6164 6162 6c65 mically loadable │ │ │ │ +0001c4a0: 206d 6f64 756c 6573 2e0a 2020 2020 2054 modules.. T │ │ │ │ +0001c4b0: 6865 7365 2061 7265 206f 6674 656e 206c hese are often l │ │ │ │ +0001c4c0: 6f61 6465 6420 6175 746f 6d61 7469 6361 oaded automatica │ │ │ │ +0001c4d0: 6c6c 792c 206f 7220 6275 696c 7420 696e lly, or built in │ │ │ │ +0001c4e0: 746f 2074 6865 2063 6f72 6520 696d 6167 to the core imag │ │ │ │ +0001c4f0: 650a 2020 2020 2069 6620 7468 6579 2061 e. if they a │ │ │ │ +0001c500: 7265 2065 7373 656e 7469 616c 2c20 6275 re essential, bu │ │ │ │ +0001c510: 7420 6d61 7920 616c 736f 2062 6520 6c6f t may also be lo │ │ │ │ +0001c520: 6164 6564 206d 616e 7561 6c6c 7920 7573 aded manually us │ │ │ │ +0001c530: 696e 6720 7468 650a 2020 2020 2027 696e ing the. 'in │ │ │ │ +0001c540: 736d 6f64 2720 636f 6d6d 616e 6420 282a smod' command (* │ │ │ │ +0001c550: 6e6f 7465 2069 6e73 6d6f 643a 3a29 2e0a note insmod::).. │ │ │ │ +0001c560: 0a46 6f72 2047 5255 4220 4c65 6761 6379 .For GRUB Legacy │ │ │ │ +0001c570: 2075 7365 7273 0a3d 3d3d 3d3d 3d3d 3d3d users.========= │ │ │ │ +0001c580: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a 4752 ============..GR │ │ │ │ +0001c590: 5542 2032 2068 6173 2061 2064 6966 6665 UB 2 has a diffe │ │ │ │ +0001c5a0: 7265 6e74 2064 6573 6967 6e20 6672 6f6d rent design from │ │ │ │ +0001c5b0: 2047 5255 4220 4c65 6761 6379 2c20 616e GRUB Legacy, an │ │ │ │ +0001c5c0: 6420 736f 2063 6f72 7265 7370 6f6e 6465 d so corresponde │ │ │ │ +0001c5d0: 6e63 6573 0a77 6974 6820 7468 6520 696d nces.with the im │ │ │ │ +0001c5e0: 6167 6573 2069 7420 7573 6564 2063 616e ages it used can │ │ │ │ +0001c5f0: 6e6f 7420 6265 2065 7861 6374 2e20 204e not be exact. N │ │ │ │ +0001c600: 6576 6572 7468 656c 6573 732c 2047 5255 evertheless, GRU │ │ │ │ +0001c610: 4220 4c65 6761 6379 0a75 7365 7273 206f B Legacy.users o │ │ │ │ +0001c620: 6674 656e 2061 736b 2071 7565 7374 696f ften ask questio │ │ │ │ +0001c630: 6e73 2069 6e20 7468 6520 7465 726d 7320 ns in the terms │ │ │ │ +0001c640: 7468 6579 2061 7265 2066 616d 696c 6961 they are familia │ │ │ │ +0001c650: 7220 7769 7468 2c20 616e 6420 736f 0a68 r with, and so.h │ │ │ │ +0001c660: 6572 6520 6973 2061 2062 7269 6566 2067 ere is a brief g │ │ │ │ +0001c670: 7569 6465 2074 6f20 686f 7720 4752 5542 uide to how GRUB │ │ │ │ +0001c680: 2032 2773 2069 6d61 6765 7320 7265 6c61 2's images rela │ │ │ │ +0001c690: 7465 2074 6f20 7468 6174 2e0a 0a27 7374 te to that...'st │ │ │ │ +0001c6a0: 6167 6531 270a 2020 2020 2053 7461 6765 age1'. Stage │ │ │ │ +0001c6b0: 2031 2066 726f 6d20 4752 5542 204c 6567 1 from GRUB Leg │ │ │ │ +0001c6c0: 6163 7920 7761 7320 7665 7279 2073 696d acy was very sim │ │ │ │ +0001c6d0: 696c 6172 2074 6f20 2762 6f6f 742e 696d ilar to 'boot.im │ │ │ │ +0001c6e0: 6727 2069 6e20 4752 5542 2032 2c0a 2020 g' in GRUB 2,. │ │ │ │ +0001c6f0: 2020 2061 6e64 2074 6865 7920 7365 7276 and they serv │ │ │ │ +0001c700: 6520 7468 6520 7361 6d65 2066 756e 6374 e the same funct │ │ │ │ +0001c710: 696f 6e2e 0a0a 272a 5f73 7461 6765 315f ion...'*_stage1_ │ │ │ │ +0001c720: 3527 0a20 2020 2020 496e 2047 5255 4220 5'. In GRUB │ │ │ │ +0001c730: 4c65 6761 6379 2c20 5374 6167 6520 312e Legacy, Stage 1. │ │ │ │ +0001c740: 3527 7320 6675 6e63 7469 6f6e 2077 6173 5's function was │ │ │ │ +0001c750: 2074 6f20 696e 636c 7564 6520 656e 6f75 to include enou │ │ │ │ +0001c760: 6768 0a20 2020 2020 6669 6c65 7379 7374 gh. filesyst │ │ │ │ +0001c770: 656d 2063 6f64 6520 746f 2061 6c6c 6f77 em code to allow │ │ │ │ +0001c780: 2074 6865 206d 7563 6820 6c61 7267 6572 the much larger │ │ │ │ +0001c790: 2053 7461 6765 2032 2074 6f20 6265 2072 Stage 2 to be r │ │ │ │ +0001c7a0: 6561 6420 6672 6f6d 2061 6e0a 2020 2020 ead from an. │ │ │ │ +0001c7b0: 206f 7264 696e 6172 7920 6669 6c65 7379 ordinary filesy │ │ │ │ +0001c7c0: 7374 656d 2e20 2049 6e20 7468 6973 2072 stem. In this r │ │ │ │ +0001c7d0: 6573 7065 6374 2c20 6974 7320 6675 6e63 espect, its func │ │ │ │ +0001c7e0: 7469 6f6e 2077 6173 2073 696d 696c 6172 tion was similar │ │ │ │ +0001c7f0: 2074 6f0a 2020 2020 2027 636f 7265 2e69 to. 'core.i │ │ │ │ +0001c800: 6d67 2720 696e 2047 5255 4220 322e 2020 mg' in GRUB 2. │ │ │ │ +0001c810: 486f 7765 7665 722c 2027 636f 7265 2e69 However, 'core.i │ │ │ │ +0001c820: 6d67 2720 6973 206d 7563 6820 6d6f 7265 mg' is much more │ │ │ │ +0001c830: 2063 6170 6162 6c65 0a20 2020 2020 7468 capable. th │ │ │ │ +0001c840: 616e 2053 7461 6765 2031 2e35 2077 6173 an Stage 1.5 was │ │ │ │ +0001c850: 3b20 7369 6e63 6520 6974 206f 6666 6572 ; since it offer │ │ │ │ +0001c860: 7320 6120 7265 7363 7565 2073 6865 6c6c s a rescue shell │ │ │ │ +0001c870: 2c20 6974 2069 7320 736f 6d65 7469 6d65 , it is sometime │ │ │ │ +0001c880: 730a 2020 2020 2070 6f73 7369 626c 6520 s. possible │ │ │ │ +0001c890: 746f 2072 6563 6f76 6572 206d 616e 7561 to recover manua │ │ │ │ +0001c8a0: 6c6c 7920 696e 2074 6865 2065 7665 6e74 lly in the event │ │ │ │ +0001c8b0: 2074 6861 7420 6974 2069 7320 756e 6162 that it is unab │ │ │ │ +0001c8c0: 6c65 2074 6f20 6c6f 6164 0a20 2020 2020 le to load. │ │ │ │ +0001c8d0: 616e 7920 6f74 6865 7220 6d6f 6475 6c65 any other module │ │ │ │ +0001c8e0: 732c 2066 6f72 2065 7861 6d70 6c65 2069 s, for example i │ │ │ │ +0001c8f0: 6620 7061 7274 6974 696f 6e20 6e75 6d62 f partition numb │ │ │ │ +0001c900: 6572 7320 6861 7665 2063 6861 6e67 6564 ers have changed │ │ │ │ +0001c910: 2e0a 2020 2020 2027 636f 7265 2e69 6d67 .. 'core.img │ │ │ │ +0001c920: 2720 6973 2062 7569 6c74 2069 6e20 6120 ' is built in a │ │ │ │ +0001c930: 6d6f 7265 2066 6c65 7869 626c 6520 7761 more flexible wa │ │ │ │ +0001c940: 792c 2061 6c6c 6f77 696e 6720 4752 5542 y, allowing GRUB │ │ │ │ +0001c950: 2032 2074 6f0a 2020 2020 2073 7570 706f 2 to. suppo │ │ │ │ +0001c960: 7274 2072 6561 6469 6e67 206d 6f64 756c rt reading modul │ │ │ │ +0001c970: 6573 2066 726f 6d20 6164 7661 6e63 6564 es from advanced │ │ │ │ +0001c980: 2064 6973 6b20 7479 7065 7320 7375 6368 disk types such │ │ │ │ +0001c990: 2061 7320 4c56 4d20 616e 640a 2020 2020 as LVM and. │ │ │ │ +0001c9a0: 2052 4149 442e 0a0a 2020 2020 2047 5255 RAID... GRU │ │ │ │ +0001c9b0: 4220 4c65 6761 6379 2063 6f75 6c64 2072 B Legacy could r │ │ │ │ +0001c9c0: 756e 2077 6974 6820 6f6e 6c79 2053 7461 un with only Sta │ │ │ │ +0001c9d0: 6765 2031 2061 6e64 2053 7461 6765 2032 ge 1 and Stage 2 │ │ │ │ +0001c9e0: 2069 6e20 736f 6d65 206c 696d 6974 6564 in some limited │ │ │ │ +0001c9f0: 0a20 2020 2020 636f 6e66 6967 7572 6174 . configurat │ │ │ │ +0001ca00: 696f 6e73 2c20 7768 696c 6520 4752 5542 ions, while GRUB │ │ │ │ +0001ca10: 2032 2072 6571 7569 7265 7320 2763 6f72 2 requires 'cor │ │ │ │ +0001ca20: 652e 696d 6727 2061 6e64 2063 616e 6e6f e.img' and canno │ │ │ │ +0001ca30: 7420 776f 726b 0a20 2020 2020 7769 7468 t work. with │ │ │ │ +0001ca40: 6f75 7420 6974 2e0a 0a27 7374 6167 6532 out it...'stage2 │ │ │ │ +0001ca50: 270a 2020 2020 2047 5255 4220 3220 6861 '. GRUB 2 ha │ │ │ │ +0001ca60: 7320 6e6f 2073 696e 676c 6520 5374 6167 s no single Stag │ │ │ │ +0001ca70: 6520 3220 696d 6167 652e 2020 496e 7374 e 2 image. Inst │ │ │ │ +0001ca80: 6561 642c 2069 7420 6c6f 6164 7320 6d6f ead, it loads mo │ │ │ │ +0001ca90: 6475 6c65 7320 6672 6f6d 0a20 2020 2020 dules from. │ │ │ │ +0001caa0: 272f 626f 6f74 2f67 7275 6227 2061 7420 '/boot/grub' at │ │ │ │ +0001cab0: 7275 6e2d 7469 6d65 2e0a 0a27 7374 6167 run-time...'stag │ │ │ │ +0001cac0: 6532 5f65 6c74 6f72 6974 6f27 0a20 2020 e2_eltorito'. │ │ │ │ +0001cad0: 2020 496e 2047 5255 4220 322c 2069 6d61 In GRUB 2, ima │ │ │ │ +0001cae0: 6765 7320 666f 7220 626f 6f74 696e 6720 ges for booting │ │ │ │ +0001caf0: 6672 6f6d 2043 442d 524f 4d20 6472 6976 from CD-ROM driv │ │ │ │ +0001cb00: 6573 2061 7265 206e 6f77 0a20 2020 2020 es are now. │ │ │ │ +0001cb10: 636f 6e73 7472 7563 7465 6420 7573 696e constructed usin │ │ │ │ +0001cb20: 6720 2763 6462 6f6f 742e 696d 6727 2061 g 'cdboot.img' a │ │ │ │ +0001cb30: 6e64 2027 636f 7265 2e69 6d67 272c 206d nd 'core.img', m │ │ │ │ +0001cb40: 616b 696e 6720 7375 7265 2074 6861 7420 aking sure that │ │ │ │ +0001cb50: 7468 650a 2020 2020 2063 6f72 6520 696d the. core im │ │ │ │ +0001cb60: 6167 6520 636f 6e74 6169 6e73 2074 6865 age contains the │ │ │ │ +0001cb70: 2027 6973 6f39 3636 3027 206d 6f64 756c 'iso9660' modul │ │ │ │ +0001cb80: 652e 2020 4974 2069 7320 7573 7561 6c6c e. It is usuall │ │ │ │ +0001cb90: 7920 6265 7374 2074 6f0a 2020 2020 2075 y best to. u │ │ │ │ +0001cba0: 7365 2074 6865 2027 6772 7562 2d6d 6b72 se the 'grub-mkr │ │ │ │ +0001cbb0: 6573 6375 6527 2070 726f 6772 616d 2066 escue' program f │ │ │ │ +0001cbc0: 6f72 2074 6869 732e 0a0a 276e 6267 7275 or this...'nbgru │ │ │ │ +0001cbd0: 6227 0a20 2020 2020 5468 6572 6520 6973 b'. There is │ │ │ │ +0001cbe0: 2061 7320 7965 7420 6e6f 2065 7175 6976 as yet no equiv │ │ │ │ +0001cbf0: 616c 656e 7420 666f 7220 276e 6267 7275 alent for 'nbgru │ │ │ │ +0001cc00: 6227 2069 6e20 4752 5542 2032 3b20 6974 b' in GRUB 2; it │ │ │ │ +0001cc10: 2077 6173 2075 7365 640a 2020 2020 2062 was used. b │ │ │ │ +0001cc20: 7920 4574 6865 7262 6f6f 7420 616e 6420 y Etherboot and │ │ │ │ +0001cc30: 736f 6d65 206f 7468 6572 206e 6574 776f some other netwo │ │ │ │ +0001cc40: 726b 2062 6f6f 7420 6c6f 6164 6572 732e rk boot loaders. │ │ │ │ +0001cc50: 0a0a 2770 7865 6772 7562 270a 2020 2020 ..'pxegrub'. │ │ │ │ +0001cc60: 2049 6e20 4752 5542 2032 2c20 696d 6167 In GRUB 2, imag │ │ │ │ +0001cc70: 6573 2066 6f72 2050 5845 206e 6574 776f es for PXE netwo │ │ │ │ +0001cc80: 726b 2062 6f6f 7469 6e67 2061 7265 206e rk booting are n │ │ │ │ +0001cc90: 6f77 2063 6f6e 7374 7275 6374 6564 2075 ow constructed u │ │ │ │ +0001cca0: 7369 6e67 0a20 2020 2020 2770 7865 626f sing. 'pxebo │ │ │ │ +0001ccb0: 6f74 2e69 6d67 2720 616e 6420 2763 6f72 ot.img' and 'cor │ │ │ │ +0001ccc0: 652e 696d 6727 2c20 6d61 6b69 6e67 2073 e.img', making s │ │ │ │ +0001ccd0: 7572 6520 7468 6174 2074 6865 2063 6f72 ure that the cor │ │ │ │ +0001cce0: 6520 696d 6167 650a 2020 2020 2063 6f6e e image. con │ │ │ │ +0001ccf0: 7461 696e 7320 7468 6520 2770 7865 2720 tains the 'pxe' │ │ │ │ +0001cd00: 616e 6420 2770 7865 636d 6427 206d 6f64 and 'pxecmd' mod │ │ │ │ +0001cd10: 756c 6573 2e20 202a 4e6f 7465 204e 6574 ules. *Note Net │ │ │ │ +0001cd20: 776f 726b 3a3a 2e0a 0a1f 0a46 696c 653a work::.....File: │ │ │ │ +0001cd30: 2067 7275 622e 696e 666f 2c20 204e 6f64 grub.info, Nod │ │ │ │ +0001cd40: 653a 2043 6f72 6520 696d 6167 6520 7369 e: Core image si │ │ │ │ +0001cd50: 7a65 206c 696d 6974 6174 696f 6e2c 2020 ze limitation, │ │ │ │ +0001cd60: 4e65 7874 3a20 4669 6c65 7379 7374 656d Next: Filesystem │ │ │ │ +0001cd70: 2c20 2050 7265 763a 2049 6d61 6765 732c , Prev: Images, │ │ │ │ +0001cd80: 2020 5570 3a20 546f 700a 0a31 3220 436f Up: Top..12 Co │ │ │ │ +0001cd90: 7265 2069 6d61 6765 2073 697a 6520 6c69 re image size li │ │ │ │ +0001cda0: 6d69 7461 7469 6f6e 0a2a 2a2a 2a2a 2a2a mitation.******* │ │ │ │ 0001cdb0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ -0001cdc0: 2a2a 0a0a 4865 6176 696c 7920 6c69 6d69 **..Heavily limi │ │ │ │ -0001cdd0: 7465 6420 706c 6174 666f 726d 733a 0a20 ted platforms:. │ │ │ │ -0001cde0: 2020 2a20 6933 3836 2d70 6320 286e 6f72 * i386-pc (nor │ │ │ │ -0001cdf0: 6d61 6c20 616e 6420 5058 4529 3a20 7468 mal and PXE): th │ │ │ │ -0001ce00: 6520 636f 7265 2069 6d61 6765 2073 697a e core image siz │ │ │ │ -0001ce10: 6520 2863 6f6d 7072 6573 7365 6429 2069 e (compressed) i │ │ │ │ -0001ce20: 730a 2020 2020 206c 696d 6974 6564 2062 s. limited b │ │ │ │ -0001ce30: 7920 3435 3832 3430 2062 7974 6573 2e20 y 458240 bytes. │ │ │ │ -0001ce40: 206b 6572 6e65 6c2e 696d 6720 282e 7465 kernel.img (.te │ │ │ │ -0001ce50: 7874 202b 202e 6461 7461 202b 202e 6273 xt + .data + .bs │ │ │ │ -0001ce60: 732c 0a20 2020 2020 756e 636f 6d70 7265 s,. uncompre │ │ │ │ -0001ce70: 7373 6564 2920 6973 206c 696d 6974 6564 ssed) is limited │ │ │ │ -0001ce80: 2062 7920 3339 3237 3034 2062 7974 6573 by 392704 bytes │ │ │ │ -0001ce90: 2e20 206d 6f64 756c 6520 7369 7a65 0a20 . module size. │ │ │ │ -0001cea0: 2020 2020 2875 6e63 6f6d 7072 6573 7365 (uncompresse │ │ │ │ -0001ceb0: 6429 202b 206b 6572 6e65 6c2e 696d 6720 d) + kernel.img │ │ │ │ -0001cec0: 282e 7465 7874 202b 202e 6461 7461 2c20 (.text + .data, │ │ │ │ -0001ced0: 756e 636f 6d70 7265 7373 6564 2920 6973 uncompressed) is │ │ │ │ -0001cee0: 0a20 2020 2020 6c69 6d69 7465 6420 6279 . limited by │ │ │ │ -0001cef0: 2074 6865 2073 697a 6520 6f66 2063 6f6e the size of con │ │ │ │ -0001cf00: 7469 6775 6f75 7320 6368 756e 6b20 6174 tiguous chunk at │ │ │ │ -0001cf10: 2031 4d20 6164 6472 6573 732e 0a20 2020 1M address.. │ │ │ │ -0001cf20: 2a20 7370 6172 6336 342d 6965 6565 3132 * sparc64-ieee12 │ │ │ │ -0001cf30: 3735 3a20 6b65 726e 656c 2e69 6d67 2028 75: kernel.img ( │ │ │ │ -0001cf40: 2e74 6578 7420 2b20 2e64 6174 6120 2b20 .text + .data + │ │ │ │ -0001cf50: 2e62 7373 2920 2b20 6d6f 6475 6c65 7320 .bss) + modules │ │ │ │ -0001cf60: 2b0a 2020 2020 2032 3536 4b20 2873 7461 +. 256K (sta │ │ │ │ -0001cf70: 636b 2920 2b20 324d 2028 6865 6170 2920 ck) + 2M (heap) │ │ │ │ -0001cf80: 6973 206c 696d 6974 6564 2062 7920 7370 is limited by sp │ │ │ │ -0001cf90: 6163 6520 6176 6169 6c61 626c 6520 6174 ace available at │ │ │ │ -0001cfa0: 2030 7834 3430 302e 0a20 2020 2020 4f6e 0x4400.. On │ │ │ │ -0001cfb0: 206d 6f73 7420 706c 6174 666f 726d 7320 most platforms │ │ │ │ -0001cfc0: 6974 2773 206a 7573 7420 3320 6f72 2034 it's just 3 or 4 │ │ │ │ -0001cfd0: 4d20 7369 6e63 6520 6965 6565 3132 3735 M since ieee1275 │ │ │ │ -0001cfe0: 206d 6170 7320 6f6e 6c79 2073 6f0a 2020 maps only so. │ │ │ │ -0001cff0: 2020 206d 7563 682e 0a20 2020 2a20 6933 much.. * i3 │ │ │ │ -0001d000: 3836 2d69 6565 6531 3237 353a 206b 6572 86-ieee1275: ker │ │ │ │ -0001d010: 6e65 6c2e 696d 6720 282e 7465 7874 202b nel.img (.text + │ │ │ │ -0001d020: 202e 6461 7461 202b 202e 6273 7329 202b .data + .bss) + │ │ │ │ -0001d030: 206d 6f64 756c 6573 2069 730a 2020 2020 modules is. │ │ │ │ -0001d040: 206c 696d 6974 6564 2062 7920 6d65 6d6f limited by memo │ │ │ │ -0001d050: 7279 2061 7661 696c 6162 6c65 2061 7420 ry available at │ │ │ │ -0001d060: 3078 3130 3030 302c 2061 7420 6d6f 7374 0x10000, at most │ │ │ │ -0001d070: 2035 3936 4b0a 0a20 2020 4c69 6768 746c 596K.. Lightl │ │ │ │ -0001d080: 7920 6c69 6d69 7465 6420 706c 6174 666f y limited platfo │ │ │ │ -0001d090: 726d 733a 0a0a 2020 202a 202a 2d78 656e rms:.. * *-xen │ │ │ │ -0001d0a0: 3a20 6c69 6d69 7465 6420 6f6e 6c79 2062 : limited only b │ │ │ │ -0001d0b0: 7920 6164 7265 7373 2073 7061 6365 2061 y adress space a │ │ │ │ -0001d0c0: 6e64 2052 414d 2073 697a 652e 0a20 2020 nd RAM size.. │ │ │ │ -0001d0d0: 2a20 6933 3836 2d71 656d 753a 206b 6572 * i386-qemu: ker │ │ │ │ -0001d0e0: 6e65 6c2e 696d 6720 282e 7465 7874 202b nel.img (.text + │ │ │ │ -0001d0f0: 202e 6461 7461 202b 202e 6273 7329 2069 .data + .bss) i │ │ │ │ -0001d100: 7320 6c69 6d69 7465 6420 6279 2033 3932 s limited by 392 │ │ │ │ -0001d110: 3730 340a 2020 2020 2062 7974 6573 2e20 704. bytes. │ │ │ │ -0001d120: 2028 636f 7265 2e69 6d67 2077 6f75 6c64 (core.img would │ │ │ │ -0001d130: 2062 6520 6c69 6d69 7465 6420 6279 2052 be limited by R │ │ │ │ -0001d140: 4f4d 2073 697a 6520 6275 7420 6974 2773 OM size but it's │ │ │ │ -0001d150: 2075 6e6c 696d 6974 6564 0a20 2020 2020 unlimited. │ │ │ │ -0001d160: 6f6e 2071 656d 750a 2020 202a 2041 6c6c on qemu. * All │ │ │ │ -0001d170: 2045 4649 2070 6c61 7466 6f72 6d73 3a20 EFI platforms: │ │ │ │ -0001d180: 6c69 6d69 7465 6420 6279 2063 6f6e 7469 limited by conti │ │ │ │ -0001d190: 6775 6f75 7320 5241 4d20 7369 7a65 2061 guous RAM size a │ │ │ │ -0001d1a0: 6e64 2070 6f73 7369 626c 790a 2020 2020 nd possibly. │ │ │ │ -0001d1b0: 2066 6972 6d77 6172 6520 6275 6773 0a20 firmware bugs. │ │ │ │ -0001d1c0: 2020 2a20 436f 7265 626f 6f74 2061 6e64 * Coreboot and │ │ │ │ -0001d1d0: 206d 756c 7469 626f 6f74 2e20 206b 6572 multiboot. ker │ │ │ │ -0001d1e0: 6e65 6c2e 696d 6720 282e 7465 7874 202b nel.img (.text + │ │ │ │ -0001d1f0: 202e 6461 7461 202b 202e 6273 7329 2069 .data + .bss) i │ │ │ │ -0001d200: 730a 2020 2020 206c 696d 6974 6564 2062 s. limited b │ │ │ │ -0001d210: 7920 3339 3237 3034 2062 7974 6573 2e20 y 392704 bytes. │ │ │ │ -0001d220: 206d 6f64 756c 6520 7369 7a65 2069 7320 module size is │ │ │ │ -0001d230: 6c69 6d69 7465 6420 6279 2074 6865 2073 limited by the s │ │ │ │ -0001d240: 697a 6520 6f66 0a20 2020 2020 636f 6e74 ize of. cont │ │ │ │ -0001d250: 6967 756f 7573 2063 6875 6e6b 2061 7420 iguous chunk at │ │ │ │ -0001d260: 314d 2061 6464 7265 7373 2e0a 2020 202a 1M address.. * │ │ │ │ -0001d270: 206d 6970 7365 6c2d 6c6f 6f6e 6773 6f6e mipsel-loongson │ │ │ │ -0001d280: 2028 454c 4629 2c20 6d69 7073 2865 6c29 (ELF), mips(el) │ │ │ │ -0001d290: 2d71 656d 755f 6d69 7073 2028 454c 4629 -qemu_mips (ELF) │ │ │ │ -0001d2a0: 3a20 6966 2075 6e63 6f6d 7072 6573 7365 : if uncompresse │ │ │ │ -0001d2b0: 643a 0a20 2020 2020 6b65 726e 656c 2e69 d:. kernel.i │ │ │ │ -0001d2c0: 6d67 2028 2e74 6578 7420 2b20 2e64 6174 mg (.text + .dat │ │ │ │ -0001d2d0: 6129 202b 206d 6f64 756c 6573 2069 7320 a) + modules is │ │ │ │ -0001d2e0: 6c69 6d69 7465 6420 6279 2074 6865 2073 limited by the s │ │ │ │ -0001d2f0: 7061 6365 2066 726f 6d0a 2020 2020 2038 pace from. 8 │ │ │ │ -0001d300: 3032 3030 3030 3020 666f 7277 6172 6420 0200000 forward │ │ │ │ -0001d310: 6966 2063 6f6d 7072 6573 7365 643a 206b if compressed: k │ │ │ │ -0001d320: 6572 6e65 6c2e 696d 6720 282e 7465 7874 ernel.img (.text │ │ │ │ -0001d330: 202b 202e 6461 7461 2c0a 2020 2020 2075 + .data,. u │ │ │ │ -0001d340: 6e63 6f6d 7072 6573 7365 6429 202b 206d ncompressed) + m │ │ │ │ -0001d350: 6f64 756c 6573 2028 756e 636f 6d70 7265 odules (uncompre │ │ │ │ -0001d360: 7373 6564 2920 2b20 286d 6f64 756c 6573 ssed) + (modules │ │ │ │ -0001d370: 202b 206b 6572 6e65 6c2e 696d 670a 2020 + kernel.img. │ │ │ │ -0001d380: 2020 2028 2e74 6578 7420 2b20 2e64 6174 (.text + .dat │ │ │ │ -0001d390: 6129 2920 2863 6f6d 7072 6573 7365 6429 a)) (compressed) │ │ │ │ -0001d3a0: 202b 2064 6563 6f6d 7072 6573 736f 7220 + decompressor │ │ │ │ -0001d3b0: 6973 206c 696d 6974 6564 2062 7920 7468 is limited by th │ │ │ │ -0001d3c0: 650a 2020 2020 2073 7061 6365 2066 726f e. space fro │ │ │ │ -0001d3d0: 6d20 3830 3230 3030 3030 2066 6f72 7761 m 80200000 forwa │ │ │ │ -0001d3e0: 7264 0a20 2020 2a20 6d69 7073 656c 2d6c rd. * mipsel-l │ │ │ │ -0001d3f0: 6f6f 6e67 736f 6e20 2846 6c61 7368 292c oongson (Flash), │ │ │ │ -0001d400: 206d 6970 7328 656c 292d 7165 6d75 5f6d mips(el)-qemu_m │ │ │ │ -0001d410: 6970 7320 2846 6c61 7368 293a 206b 6572 ips (Flash): ker │ │ │ │ -0001d420: 6e65 6c2e 696d 670a 2020 2020 2028 2e74 nel.img. (.t │ │ │ │ -0001d430: 6578 7420 2b20 2e64 6174 6129 202b 206d ext + .data) + m │ │ │ │ -0001d440: 6f64 756c 6573 2069 7320 6c69 6d69 7465 odules is limite │ │ │ │ -0001d450: 6420 6279 2074 6865 2073 7061 6365 2066 d by the space f │ │ │ │ -0001d460: 726f 6d20 3830 3230 3030 3030 0a20 2020 rom 80200000. │ │ │ │ -0001d470: 2020 666f 7277 6172 6420 636f 7265 2e69 forward core.i │ │ │ │ -0001d480: 6d67 2028 6669 6e61 6c29 2069 7320 6c69 mg (final) is li │ │ │ │ -0001d490: 6d69 7465 6420 6279 2066 6c61 7368 2073 mited by flash s │ │ │ │ -0001d4a0: 697a 6520 2835 3132 4b20 6f6e 2079 6565 ize (512K on yee │ │ │ │ -0001d4b0: 6c6f 6f6e 670a 2020 2020 2061 6e64 2066 loong. and f │ │ │ │ -0001d4c0: 756c 6f6f 6f6e 6729 0a20 2020 2a20 6d69 ulooong). * mi │ │ │ │ -0001d4d0: 7073 2d61 7263 3a20 6966 2075 6e63 6f6d ps-arc: if uncom │ │ │ │ -0001d4e0: 7072 6573 7365 643a 206b 6572 6e65 6c2e pressed: kernel. │ │ │ │ -0001d4f0: 696d 6720 282e 7465 7874 202b 202e 6461 img (.text + .da │ │ │ │ -0001d500: 7461 2920 6973 206c 696d 6974 6564 2062 ta) is limited b │ │ │ │ -0001d510: 790a 2020 2020 2074 6865 2073 7061 6365 y. the space │ │ │ │ -0001d520: 2066 726f 6d20 3862 6430 3030 3030 2066 from 8bd00000 f │ │ │ │ -0001d530: 6f72 7761 7264 206d 6f64 756c 6573 202b orward modules + │ │ │ │ -0001d540: 2064 756d 6d79 2064 6563 6f6d 7072 6573 dummy decompres │ │ │ │ -0001d550: 736f 7220 6973 0a20 2020 2020 6c69 6d69 sor is. limi │ │ │ │ -0001d560: 7465 6420 6279 2074 6865 2073 7061 6365 ted by the space │ │ │ │ -0001d570: 2066 726f 6d20 3862 6430 3030 3030 2062 from 8bd00000 b │ │ │ │ -0001d580: 6163 6b77 6172 6420 6966 2063 6f6d 7072 ackward if compr │ │ │ │ -0001d590: 6573 7365 643a 0a20 2020 2020 6b65 726e essed:. kern │ │ │ │ -0001d5a0: 656c 2e69 6d67 2028 2e74 6578 7420 2b20 el.img (.text + │ │ │ │ -0001d5b0: 2e64 6174 612c 2075 6e63 6f6d 7072 6573 .data, uncompres │ │ │ │ -0001d5c0: 7365 6429 2069 7320 6c69 6d69 7465 6420 sed) is limited │ │ │ │ -0001d5d0: 6279 2074 6865 2073 7061 6365 0a20 2020 by the space. │ │ │ │ -0001d5e0: 2020 6672 6f6d 2038 6264 3030 3030 3020 from 8bd00000 │ │ │ │ -0001d5f0: 666f 7277 6172 6420 6d6f 6475 6c65 7320 forward modules │ │ │ │ -0001d600: 2875 6e63 6f6d 7072 6573 7365 6429 202b (uncompressed) + │ │ │ │ -0001d610: 2028 6d6f 6475 6c65 7320 2b0a 2020 2020 (modules +. │ │ │ │ -0001d620: 206b 6572 6e65 6c2e 696d 6720 282e 7465 kernel.img (.te │ │ │ │ -0001d630: 7874 202b 202e 6461 7461 2929 2028 636f xt + .data)) (co │ │ │ │ -0001d640: 6d70 7265 7373 6564 2c20 616c 6967 6e65 mpressed, aligne │ │ │ │ -0001d650: 6420 746f 2031 4d29 202b 2031 4d0a 2020 d to 1M) + 1M. │ │ │ │ -0001d660: 2020 2028 6465 636f 6d70 7265 7373 6f72 (decompressor │ │ │ │ -0001d670: 202b 2073 6372 6174 6368 2073 7061 6365 + scratch space │ │ │ │ -0001d680: 2920 6973 206c 696d 6974 6564 2062 7920 ) is limited by │ │ │ │ -0001d690: 7468 6520 7370 6163 6520 6672 6f6d 0a20 the space from. │ │ │ │ -0001d6a0: 2020 2020 3862 6430 3030 3030 2062 6163 8bd00000 bac │ │ │ │ -0001d6b0: 6b77 6172 640a 2020 202a 2070 6f77 6572 kward. * power │ │ │ │ -0001d6c0: 7063 2d69 6565 6531 3237 353a 206b 6572 pc-ieee1275: ker │ │ │ │ -0001d6d0: 6e65 6c2e 696d 6720 282e 7465 7874 202b nel.img (.text + │ │ │ │ -0001d6e0: 202e 6461 7461 202b 202e 6273 7329 202b .data + .bss) + │ │ │ │ -0001d6f0: 206d 6f64 756c 6573 2069 730a 2020 2020 modules is. │ │ │ │ -0001d700: 206c 696d 6974 6564 2062 7920 7370 6163 limited by spac │ │ │ │ -0001d710: 6520 6176 6169 6c61 626c 6520 6174 2030 e available at 0 │ │ │ │ -0001d720: 7832 3030 3030 300a 0a1f 0a46 696c 653a x200000....File: │ │ │ │ -0001d730: 2067 7275 622e 696e 666f 2c20 204e 6f64 grub.info, Nod │ │ │ │ -0001d740: 653a 2046 696c 6573 7973 7465 6d2c 2020 e: Filesystem, │ │ │ │ -0001d750: 4e65 7874 3a20 496e 7465 7266 6163 652c Next: Interface, │ │ │ │ -0001d760: 2020 5072 6576 3a20 436f 7265 2069 6d61 Prev: Core ima │ │ │ │ -0001d770: 6765 2073 697a 6520 6c69 6d69 7461 7469 ge size limitati │ │ │ │ -0001d780: 6f6e 2c20 2055 703a 2054 6f70 0a0a 3133 on, Up: Top..13 │ │ │ │ -0001d790: 2046 696c 6573 7973 7465 6d20 7379 6e74 Filesystem synt │ │ │ │ -0001d7a0: 6178 2061 6e64 2073 656d 616e 7469 6373 ax and semantics │ │ │ │ -0001d7b0: 0a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a .*************** │ │ │ │ +0001cdc0: 2a2a 2a2a 2a2a 0a0a 4865 6176 696c 7920 ******..Heavily │ │ │ │ +0001cdd0: 6c69 6d69 7465 6420 706c 6174 666f 726d limited platform │ │ │ │ +0001cde0: 733a 0a20 2020 2a20 6933 3836 2d70 6320 s:. * i386-pc │ │ │ │ +0001cdf0: 286e 6f72 6d61 6c20 616e 6420 5058 4529 (normal and PXE) │ │ │ │ +0001ce00: 3a20 7468 6520 636f 7265 2069 6d61 6765 : the core image │ │ │ │ +0001ce10: 2073 697a 6520 2863 6f6d 7072 6573 7365 size (compresse │ │ │ │ +0001ce20: 6429 2069 730a 2020 2020 206c 696d 6974 d) is. limit │ │ │ │ +0001ce30: 6564 2062 7920 3435 3832 3430 2062 7974 ed by 458240 byt │ │ │ │ +0001ce40: 6573 2e20 206b 6572 6e65 6c2e 696d 6720 es. kernel.img │ │ │ │ +0001ce50: 282e 7465 7874 202b 202e 6461 7461 202b (.text + .data + │ │ │ │ +0001ce60: 202e 6273 732c 0a20 2020 2020 756e 636f .bss,. unco │ │ │ │ +0001ce70: 6d70 7265 7373 6564 2920 6973 206c 696d mpressed) is lim │ │ │ │ +0001ce80: 6974 6564 2062 7920 3339 3237 3034 2062 ited by 392704 b │ │ │ │ +0001ce90: 7974 6573 2e20 206d 6f64 756c 6520 7369 ytes. module si │ │ │ │ +0001cea0: 7a65 0a20 2020 2020 2875 6e63 6f6d 7072 ze. (uncompr │ │ │ │ +0001ceb0: 6573 7365 6429 202b 206b 6572 6e65 6c2e essed) + kernel. │ │ │ │ +0001cec0: 696d 6720 282e 7465 7874 202b 202e 6461 img (.text + .da │ │ │ │ +0001ced0: 7461 2c20 756e 636f 6d70 7265 7373 6564 ta, uncompressed │ │ │ │ +0001cee0: 2920 6973 0a20 2020 2020 6c69 6d69 7465 ) is. limite │ │ │ │ +0001cef0: 6420 6279 2074 6865 2073 697a 6520 6f66 d by the size of │ │ │ │ +0001cf00: 2063 6f6e 7469 6775 6f75 7320 6368 756e contiguous chun │ │ │ │ +0001cf10: 6b20 6174 2031 4d20 6164 6472 6573 732e k at 1M address. │ │ │ │ +0001cf20: 0a20 2020 2a20 7370 6172 6336 342d 6965 . * sparc64-ie │ │ │ │ +0001cf30: 6565 3132 3735 3a20 6b65 726e 656c 2e69 ee1275: kernel.i │ │ │ │ +0001cf40: 6d67 2028 2e74 6578 7420 2b20 2e64 6174 mg (.text + .dat │ │ │ │ +0001cf50: 6120 2b20 2e62 7373 2920 2b20 6d6f 6475 a + .bss) + modu │ │ │ │ +0001cf60: 6c65 7320 2b0a 2020 2020 2032 3536 4b20 les +. 256K │ │ │ │ +0001cf70: 2873 7461 636b 2920 2b20 324d 2028 6865 (stack) + 2M (he │ │ │ │ +0001cf80: 6170 2920 6973 206c 696d 6974 6564 2062 ap) is limited b │ │ │ │ +0001cf90: 7920 7370 6163 6520 6176 6169 6c61 626c y space availabl │ │ │ │ +0001cfa0: 6520 6174 2030 7834 3430 302e 0a20 2020 e at 0x4400.. │ │ │ │ +0001cfb0: 2020 4f6e 206d 6f73 7420 706c 6174 666f On most platfo │ │ │ │ +0001cfc0: 726d 7320 6974 2773 206a 7573 7420 3320 rms it's just 3 │ │ │ │ +0001cfd0: 6f72 2034 4d20 7369 6e63 6520 6965 6565 or 4M since ieee │ │ │ │ +0001cfe0: 3132 3735 206d 6170 7320 6f6e 6c79 2073 1275 maps only s │ │ │ │ +0001cff0: 6f0a 2020 2020 206d 7563 682e 0a20 2020 o. much.. │ │ │ │ +0001d000: 2a20 6933 3836 2d69 6565 6531 3237 353a * i386-ieee1275: │ │ │ │ +0001d010: 206b 6572 6e65 6c2e 696d 6720 282e 7465 kernel.img (.te │ │ │ │ +0001d020: 7874 202b 202e 6461 7461 202b 202e 6273 xt + .data + .bs │ │ │ │ +0001d030: 7329 202b 206d 6f64 756c 6573 2069 730a s) + modules is. │ │ │ │ +0001d040: 2020 2020 206c 696d 6974 6564 2062 7920 limited by │ │ │ │ +0001d050: 6d65 6d6f 7279 2061 7661 696c 6162 6c65 memory available │ │ │ │ +0001d060: 2061 7420 3078 3130 3030 302c 2061 7420 at 0x10000, at │ │ │ │ +0001d070: 6d6f 7374 2035 3936 4b0a 0a20 2020 4c69 most 596K.. Li │ │ │ │ +0001d080: 6768 746c 7920 6c69 6d69 7465 6420 706c ghtly limited pl │ │ │ │ +0001d090: 6174 666f 726d 733a 0a0a 2020 202a 202a atforms:.. * * │ │ │ │ +0001d0a0: 2d78 656e 3a20 6c69 6d69 7465 6420 6f6e -xen: limited on │ │ │ │ +0001d0b0: 6c79 2062 7920 6164 7265 7373 2073 7061 ly by adress spa │ │ │ │ +0001d0c0: 6365 2061 6e64 2052 414d 2073 697a 652e ce and RAM size. │ │ │ │ +0001d0d0: 0a20 2020 2a20 6933 3836 2d71 656d 753a . * i386-qemu: │ │ │ │ +0001d0e0: 206b 6572 6e65 6c2e 696d 6720 282e 7465 kernel.img (.te │ │ │ │ +0001d0f0: 7874 202b 202e 6461 7461 202b 202e 6273 xt + .data + .bs │ │ │ │ +0001d100: 7329 2069 7320 6c69 6d69 7465 6420 6279 s) is limited by │ │ │ │ +0001d110: 2033 3932 3730 340a 2020 2020 2062 7974 392704. byt │ │ │ │ +0001d120: 6573 2e20 2028 636f 7265 2e69 6d67 2077 es. (core.img w │ │ │ │ +0001d130: 6f75 6c64 2062 6520 6c69 6d69 7465 6420 ould be limited │ │ │ │ +0001d140: 6279 2052 4f4d 2073 697a 6520 6275 7420 by ROM size but │ │ │ │ +0001d150: 6974 2773 2075 6e6c 696d 6974 6564 0a20 it's unlimited. │ │ │ │ +0001d160: 2020 2020 6f6e 2071 656d 750a 2020 202a on qemu. * │ │ │ │ +0001d170: 2041 6c6c 2045 4649 2070 6c61 7466 6f72 All EFI platfor │ │ │ │ +0001d180: 6d73 3a20 6c69 6d69 7465 6420 6279 2063 ms: limited by c │ │ │ │ +0001d190: 6f6e 7469 6775 6f75 7320 5241 4d20 7369 ontiguous RAM si │ │ │ │ +0001d1a0: 7a65 2061 6e64 2070 6f73 7369 626c 790a ze and possibly. │ │ │ │ +0001d1b0: 2020 2020 2066 6972 6d77 6172 6520 6275 firmware bu │ │ │ │ +0001d1c0: 6773 0a20 2020 2a20 436f 7265 626f 6f74 gs. * Coreboot │ │ │ │ +0001d1d0: 2061 6e64 206d 756c 7469 626f 6f74 2e20 and multiboot. │ │ │ │ +0001d1e0: 206b 6572 6e65 6c2e 696d 6720 282e 7465 kernel.img (.te │ │ │ │ +0001d1f0: 7874 202b 202e 6461 7461 202b 202e 6273 xt + .data + .bs │ │ │ │ +0001d200: 7329 2069 730a 2020 2020 206c 696d 6974 s) is. limit │ │ │ │ +0001d210: 6564 2062 7920 3339 3237 3034 2062 7974 ed by 392704 byt │ │ │ │ +0001d220: 6573 2e20 206d 6f64 756c 6520 7369 7a65 es. module size │ │ │ │ +0001d230: 2069 7320 6c69 6d69 7465 6420 6279 2074 is limited by t │ │ │ │ +0001d240: 6865 2073 697a 6520 6f66 0a20 2020 2020 he size of. │ │ │ │ +0001d250: 636f 6e74 6967 756f 7573 2063 6875 6e6b contiguous chunk │ │ │ │ +0001d260: 2061 7420 314d 2061 6464 7265 7373 2e0a at 1M address.. │ │ │ │ +0001d270: 2020 202a 206d 6970 7365 6c2d 6c6f 6f6e * mipsel-loon │ │ │ │ +0001d280: 6773 6f6e 2028 454c 4629 2c20 6d69 7073 gson (ELF), mips │ │ │ │ +0001d290: 2865 6c29 2d71 656d 755f 6d69 7073 2028 (el)-qemu_mips ( │ │ │ │ +0001d2a0: 454c 4629 3a20 6966 2075 6e63 6f6d 7072 ELF): if uncompr │ │ │ │ +0001d2b0: 6573 7365 643a 0a20 2020 2020 6b65 726e essed:. kern │ │ │ │ +0001d2c0: 656c 2e69 6d67 2028 2e74 6578 7420 2b20 el.img (.text + │ │ │ │ +0001d2d0: 2e64 6174 6129 202b 206d 6f64 756c 6573 .data) + modules │ │ │ │ +0001d2e0: 2069 7320 6c69 6d69 7465 6420 6279 2074 is limited by t │ │ │ │ +0001d2f0: 6865 2073 7061 6365 2066 726f 6d0a 2020 he space from. │ │ │ │ +0001d300: 2020 2038 3032 3030 3030 3020 666f 7277 80200000 forw │ │ │ │ +0001d310: 6172 6420 6966 2063 6f6d 7072 6573 7365 ard if compresse │ │ │ │ +0001d320: 643a 206b 6572 6e65 6c2e 696d 6720 282e d: kernel.img (. │ │ │ │ +0001d330: 7465 7874 202b 202e 6461 7461 2c0a 2020 text + .data,. │ │ │ │ +0001d340: 2020 2075 6e63 6f6d 7072 6573 7365 6429 uncompressed) │ │ │ │ +0001d350: 202b 206d 6f64 756c 6573 2028 756e 636f + modules (unco │ │ │ │ +0001d360: 6d70 7265 7373 6564 2920 2b20 286d 6f64 mpressed) + (mod │ │ │ │ +0001d370: 756c 6573 202b 206b 6572 6e65 6c2e 696d ules + kernel.im │ │ │ │ +0001d380: 670a 2020 2020 2028 2e74 6578 7420 2b20 g. (.text + │ │ │ │ +0001d390: 2e64 6174 6129 2920 2863 6f6d 7072 6573 .data)) (compres │ │ │ │ +0001d3a0: 7365 6429 202b 2064 6563 6f6d 7072 6573 sed) + decompres │ │ │ │ +0001d3b0: 736f 7220 6973 206c 696d 6974 6564 2062 sor is limited b │ │ │ │ +0001d3c0: 7920 7468 650a 2020 2020 2073 7061 6365 y the. space │ │ │ │ +0001d3d0: 2066 726f 6d20 3830 3230 3030 3030 2066 from 80200000 f │ │ │ │ +0001d3e0: 6f72 7761 7264 0a20 2020 2a20 6d69 7073 orward. * mips │ │ │ │ +0001d3f0: 656c 2d6c 6f6f 6e67 736f 6e20 2846 6c61 el-loongson (Fla │ │ │ │ +0001d400: 7368 292c 206d 6970 7328 656c 292d 7165 sh), mips(el)-qe │ │ │ │ +0001d410: 6d75 5f6d 6970 7320 2846 6c61 7368 293a mu_mips (Flash): │ │ │ │ +0001d420: 206b 6572 6e65 6c2e 696d 670a 2020 2020 kernel.img. │ │ │ │ +0001d430: 2028 2e74 6578 7420 2b20 2e64 6174 6129 (.text + .data) │ │ │ │ +0001d440: 202b 206d 6f64 756c 6573 2069 7320 6c69 + modules is li │ │ │ │ +0001d450: 6d69 7465 6420 6279 2074 6865 2073 7061 mited by the spa │ │ │ │ +0001d460: 6365 2066 726f 6d20 3830 3230 3030 3030 ce from 80200000 │ │ │ │ +0001d470: 0a20 2020 2020 666f 7277 6172 6420 636f . forward co │ │ │ │ +0001d480: 7265 2e69 6d67 2028 6669 6e61 6c29 2069 re.img (final) i │ │ │ │ +0001d490: 7320 6c69 6d69 7465 6420 6279 2066 6c61 s limited by fla │ │ │ │ +0001d4a0: 7368 2073 697a 6520 2835 3132 4b20 6f6e sh size (512K on │ │ │ │ +0001d4b0: 2079 6565 6c6f 6f6e 670a 2020 2020 2061 yeeloong. a │ │ │ │ +0001d4c0: 6e64 2066 756c 6f6f 6f6e 6729 0a20 2020 nd fulooong). │ │ │ │ +0001d4d0: 2a20 6d69 7073 2d61 7263 3a20 6966 2075 * mips-arc: if u │ │ │ │ +0001d4e0: 6e63 6f6d 7072 6573 7365 643a 206b 6572 ncompressed: ker │ │ │ │ +0001d4f0: 6e65 6c2e 696d 6720 282e 7465 7874 202b nel.img (.text + │ │ │ │ +0001d500: 202e 6461 7461 2920 6973 206c 696d 6974 .data) is limit │ │ │ │ +0001d510: 6564 2062 790a 2020 2020 2074 6865 2073 ed by. the s │ │ │ │ +0001d520: 7061 6365 2066 726f 6d20 3862 6430 3030 pace from 8bd000 │ │ │ │ +0001d530: 3030 2066 6f72 7761 7264 206d 6f64 756c 00 forward modul │ │ │ │ +0001d540: 6573 202b 2064 756d 6d79 2064 6563 6f6d es + dummy decom │ │ │ │ +0001d550: 7072 6573 736f 7220 6973 0a20 2020 2020 pressor is. │ │ │ │ +0001d560: 6c69 6d69 7465 6420 6279 2074 6865 2073 limited by the s │ │ │ │ +0001d570: 7061 6365 2066 726f 6d20 3862 6430 3030 pace from 8bd000 │ │ │ │ +0001d580: 3030 2062 6163 6b77 6172 6420 6966 2063 00 backward if c │ │ │ │ +0001d590: 6f6d 7072 6573 7365 643a 0a20 2020 2020 ompressed:. │ │ │ │ +0001d5a0: 6b65 726e 656c 2e69 6d67 2028 2e74 6578 kernel.img (.tex │ │ │ │ +0001d5b0: 7420 2b20 2e64 6174 612c 2075 6e63 6f6d t + .data, uncom │ │ │ │ +0001d5c0: 7072 6573 7365 6429 2069 7320 6c69 6d69 pressed) is limi │ │ │ │ +0001d5d0: 7465 6420 6279 2074 6865 2073 7061 6365 ted by the space │ │ │ │ +0001d5e0: 0a20 2020 2020 6672 6f6d 2038 6264 3030 . from 8bd00 │ │ │ │ +0001d5f0: 3030 3020 666f 7277 6172 6420 6d6f 6475 000 forward modu │ │ │ │ +0001d600: 6c65 7320 2875 6e63 6f6d 7072 6573 7365 les (uncompresse │ │ │ │ +0001d610: 6429 202b 2028 6d6f 6475 6c65 7320 2b0a d) + (modules +. │ │ │ │ +0001d620: 2020 2020 206b 6572 6e65 6c2e 696d 6720 kernel.img │ │ │ │ +0001d630: 282e 7465 7874 202b 202e 6461 7461 2929 (.text + .data)) │ │ │ │ +0001d640: 2028 636f 6d70 7265 7373 6564 2c20 616c (compressed, al │ │ │ │ +0001d650: 6967 6e65 6420 746f 2031 4d29 202b 2031 igned to 1M) + 1 │ │ │ │ +0001d660: 4d0a 2020 2020 2028 6465 636f 6d70 7265 M. (decompre │ │ │ │ +0001d670: 7373 6f72 202b 2073 6372 6174 6368 2073 ssor + scratch s │ │ │ │ +0001d680: 7061 6365 2920 6973 206c 696d 6974 6564 pace) is limited │ │ │ │ +0001d690: 2062 7920 7468 6520 7370 6163 6520 6672 by the space fr │ │ │ │ +0001d6a0: 6f6d 0a20 2020 2020 3862 6430 3030 3030 om. 8bd00000 │ │ │ │ +0001d6b0: 2062 6163 6b77 6172 640a 2020 202a 2070 backward. * p │ │ │ │ +0001d6c0: 6f77 6572 7063 2d69 6565 6531 3237 353a owerpc-ieee1275: │ │ │ │ +0001d6d0: 206b 6572 6e65 6c2e 696d 6720 282e 7465 kernel.img (.te │ │ │ │ +0001d6e0: 7874 202b 202e 6461 7461 202b 202e 6273 xt + .data + .bs │ │ │ │ +0001d6f0: 7329 202b 206d 6f64 756c 6573 2069 730a s) + modules is. │ │ │ │ +0001d700: 2020 2020 206c 696d 6974 6564 2062 7920 limited by │ │ │ │ +0001d710: 7370 6163 6520 6176 6169 6c61 626c 6520 space available │ │ │ │ +0001d720: 6174 2030 7832 3030 3030 300a 0a1f 0a46 at 0x200000....F │ │ │ │ +0001d730: 696c 653a 2067 7275 622e 696e 666f 2c20 ile: grub.info, │ │ │ │ +0001d740: 204e 6f64 653a 2046 696c 6573 7973 7465 Node: Filesyste │ │ │ │ +0001d750: 6d2c 2020 4e65 7874 3a20 496e 7465 7266 m, Next: Interf │ │ │ │ +0001d760: 6163 652c 2020 5072 6576 3a20 436f 7265 ace, Prev: Core │ │ │ │ +0001d770: 2069 6d61 6765 2073 697a 6520 6c69 6d69 image size limi │ │ │ │ +0001d780: 7461 7469 6f6e 2c20 2055 703a 2054 6f70 tation, Up: Top │ │ │ │ +0001d790: 0a0a 3133 2046 696c 6573 7973 7465 6d20 ..13 Filesystem │ │ │ │ +0001d7a0: 7379 6e74 6178 2061 6e64 2073 656d 616e syntax and seman │ │ │ │ +0001d7b0: 7469 6373 0a2a 2a2a 2a2a 2a2a 2a2a 2a2a tics.*********** │ │ │ │ 0001d7c0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ -0001d7d0: 2a2a 2a0a 0a47 5255 4220 7573 6573 2061 ***..GRUB uses a │ │ │ │ -0001d7e0: 2073 7065 6369 616c 2073 796e 7461 7820 special syntax │ │ │ │ -0001d7f0: 666f 7220 7370 6563 6966 7969 6e67 2064 for specifying d │ │ │ │ -0001d800: 6973 6b20 6472 6976 6573 2077 6869 6368 isk drives which │ │ │ │ -0001d810: 2063 616e 2062 650a 6163 6365 7373 6564 can be.accessed │ │ │ │ -0001d820: 2062 7920 4249 4f53 2e20 4265 6361 7573 by BIOS. Becaus │ │ │ │ -0001d830: 6520 6f66 2042 494f 5320 6c69 6d69 7461 e of BIOS limita │ │ │ │ -0001d840: 7469 6f6e 732c 2047 5255 4220 6361 6e6e tions, GRUB cann │ │ │ │ -0001d850: 6f74 2064 6973 7469 6e67 7569 7368 0a62 ot distinguish.b │ │ │ │ -0001d860: 6574 7765 656e 2049 4445 2c20 4553 4449 etween IDE, ESDI │ │ │ │ -0001d870: 2c20 5343 5349 2c20 6f72 206f 7468 6572 , SCSI, or other │ │ │ │ -0001d880: 732e 2020 596f 7520 6d75 7374 206b 6e6f s. You must kno │ │ │ │ -0001d890: 7720 796f 7572 7365 6c66 2077 6869 6368 w yourself which │ │ │ │ -0001d8a0: 2042 494f 530a 6465 7669 6365 2069 7320 BIOS.device is │ │ │ │ -0001d8b0: 6571 7569 7661 6c65 6e74 2074 6f20 7768 equivalent to wh │ │ │ │ -0001d8c0: 6963 6820 4f53 2064 6576 6963 652e 2020 ich OS device. │ │ │ │ -0001d8d0: 4e6f 726d 616c 6c79 2c20 7468 6174 2077 Normally, that w │ │ │ │ -0001d8e0: 696c 6c20 6265 2063 6c65 6172 0a69 6620 ill be clear.if │ │ │ │ -0001d8f0: 796f 7520 7365 6520 7468 6520 6669 6c65 you see the file │ │ │ │ -0001d900: 7320 696e 2061 2064 6576 6963 6520 6f72 s in a device or │ │ │ │ -0001d910: 2075 7365 2074 6865 2063 6f6d 6d61 6e64 use the command │ │ │ │ -0001d920: 2027 7365 6172 6368 2720 282a 6e6f 7465 'search' (*note │ │ │ │ -0001d930: 0a73 6561 7263 683a 3a29 2e0a 0a2a 204d .search::)...* M │ │ │ │ -0001d940: 656e 753a 0a0a 2a20 4465 7669 6365 2073 enu:..* Device s │ │ │ │ -0001d950: 796e 7461 783a 3a20 2020 2020 2020 2020 yntax:: │ │ │ │ -0001d960: 2020 2020 2020 486f 7720 746f 2073 7065 How to spe │ │ │ │ -0001d970: 6369 6679 2064 6576 6963 6573 0a2a 2046 cify devices.* F │ │ │ │ -0001d980: 696c 6520 6e61 6d65 2073 796e 7461 783a ile name syntax: │ │ │ │ -0001d990: 3a20 2020 2020 2020 2020 2020 2048 6f77 : How │ │ │ │ -0001d9a0: 2074 6f20 7370 6563 6966 7920 6669 6c65 to specify file │ │ │ │ -0001d9b0: 730a 2a20 426c 6f63 6b20 6c69 7374 2073 s.* Block list s │ │ │ │ -0001d9c0: 796e 7461 783a 3a20 2020 2020 2020 2020 yntax:: │ │ │ │ -0001d9d0: 2020 486f 7720 746f 2073 7065 6369 6679 How to specify │ │ │ │ -0001d9e0: 2062 6c6f 636b 206c 6973 7473 0a0a 1f0a block lists.... │ │ │ │ -0001d9f0: 4669 6c65 3a20 6772 7562 2e69 6e66 6f2c File: grub.info, │ │ │ │ -0001da00: 2020 4e6f 6465 3a20 4465 7669 6365 2073 Node: Device s │ │ │ │ -0001da10: 796e 7461 782c 2020 4e65 7874 3a20 4669 yntax, Next: Fi │ │ │ │ -0001da20: 6c65 206e 616d 6520 7379 6e74 6178 2c20 le name syntax, │ │ │ │ -0001da30: 2055 703a 2046 696c 6573 7973 7465 6d0a Up: Filesystem. │ │ │ │ -0001da40: 0a31 332e 3120 486f 7720 746f 2073 7065 .13.1 How to spe │ │ │ │ -0001da50: 6369 6679 2064 6576 6963 6573 0a3d 3d3d cify devices.=== │ │ │ │ -0001da60: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ -0001da70: 3d3d 3d3d 3d3d 3d3d 0a0a 5468 6520 6465 ========..The de │ │ │ │ -0001da80: 7669 6365 2073 796e 7461 7820 6973 206c vice syntax is l │ │ │ │ -0001da90: 696b 6520 7468 6973 3a0a 0a20 2020 2020 ike this:.. │ │ │ │ -0001daa0: 2844 4556 4943 455b 2c50 4152 544d 4150 (DEVICE[,PARTMAP │ │ │ │ -0001dab0: 2d4e 414d 4531 5041 5254 2d4e 554d 315b -NAME1PART-NUM1[ │ │ │ │ -0001dac0: 2c50 4152 544d 4150 2d4e 414d 4532 5041 ,PARTMAP-NAME2PA │ │ │ │ -0001dad0: 5254 2d4e 554d 325b 2c2e 2e2e 5d5d 5d29 RT-NUM2[,...]]]) │ │ │ │ -0001dae0: 0a0a 2020 2027 5b5d 2720 6d65 616e 7320 .. '[]' means │ │ │ │ -0001daf0: 7468 6520 7061 7261 6d65 7465 7220 6973 the parameter is │ │ │ │ -0001db00: 206f 7074 696f 6e61 6c2e 2020 4445 5649 optional. DEVI │ │ │ │ -0001db10: 4345 2064 6570 656e 6473 206f 6e20 7468 CE depends on th │ │ │ │ -0001db20: 6520 6469 736b 0a64 7269 7665 7220 696e e disk.driver in │ │ │ │ -0001db30: 2075 7365 2e20 2042 494f 5320 616e 6420 use. BIOS and │ │ │ │ -0001db40: 4546 4920 6469 736b 7320 7573 6520 6569 EFI disks use ei │ │ │ │ -0001db50: 7468 6572 2027 6664 2720 6f72 2027 6864 ther 'fd' or 'hd │ │ │ │ -0001db60: 2720 666f 6c6c 6f77 6564 2062 7920 610a ' followed by a. │ │ │ │ -0001db70: 6469 6769 742c 206c 696b 6520 2766 6430 digit, like 'fd0 │ │ │ │ -0001db80: 272c 206f 7220 2763 6427 2e20 2041 4843 ', or 'cd'. AHC │ │ │ │ -0001db90: 492c 2050 4154 4120 2861 7461 292c 2063 I, PATA (ata), c │ │ │ │ -0001dba0: 7279 7074 6f2c 2055 5342 2075 7365 2074 rypto, USB use t │ │ │ │ -0001dbb0: 6865 206e 616d 650a 6f66 2064 7269 7665 he name.of drive │ │ │ │ -0001dbc0: 7220 666f 6c6c 6f77 6564 2062 7920 6120 r followed by a │ │ │ │ -0001dbd0: 6e75 6d62 6572 2e20 204d 656d 6469 736b number. Memdisk │ │ │ │ -0001dbe0: 2061 6e64 2068 6f73 7420 6172 6520 6c69 and host are li │ │ │ │ -0001dbf0: 6d69 7465 6420 746f 206f 6e65 0a64 6973 mited to one.dis │ │ │ │ -0001dc00: 6b20 616e 6420 736f 2069 7427 7320 7265 k and so it's re │ │ │ │ -0001dc10: 6665 7265 6420 6a75 7374 2062 7920 6472 fered just by dr │ │ │ │ -0001dc20: 6976 6572 206e 616d 652e 2020 5241 4944 iver name. RAID │ │ │ │ -0001dc30: 2028 6d64 292c 206f 6664 6973 6b0a 2869 (md), ofdisk.(i │ │ │ │ -0001dc40: 6565 6531 3237 3520 616e 6420 6e61 6e64 eee1275 and nand │ │ │ │ -0001dc50: 292c 204c 564d 2028 6c76 6d29 2c20 4c44 ), LVM (lvm), LD │ │ │ │ -0001dc60: 4d2c 2076 6972 7469 6f20 2876 6473 6b29 M, virtio (vdsk) │ │ │ │ -0001dc70: 2061 6e64 2061 7263 6469 736b 2028 6172 and arcdisk (ar │ │ │ │ -0001dc80: 6329 2075 7365 0a69 6e74 7269 6e73 6963 c) use.intrinsic │ │ │ │ -0001dc90: 206e 616d 6520 6f66 2064 6973 6b20 7072 name of disk pr │ │ │ │ -0001dca0: 6566 6978 6564 2062 7920 6472 6976 6572 efixed by driver │ │ │ │ -0001dcb0: 206e 616d 652e 2020 4164 6469 7469 6f6e name. Addition │ │ │ │ -0001dcc0: 616c 6c79 206a 7573 740a 226e 616e 6422 ally just."nand" │ │ │ │ -0001dcd0: 2072 6566 6572 7320 746f 2074 6865 2064 refers to the d │ │ │ │ -0001dce0: 6973 6b20 616c 6961 7365 6420 6173 2022 isk aliased as " │ │ │ │ -0001dcf0: 6e61 6e64 222e 2020 436f 6e66 6c69 6374 nand". Conflict │ │ │ │ -0001dd00: 7320 6172 6520 736f 6c76 6564 2062 790a s are solved by. │ │ │ │ -0001dd10: 7375 6666 6978 696e 6720 6120 6e75 6d62 suffixing a numb │ │ │ │ -0001dd20: 6572 2069 6620 6e65 6365 7373 6172 7279 er if necessarry │ │ │ │ -0001dd30: 2e20 2043 6f6d 6d61 7320 6e65 6564 2074 . Commas need t │ │ │ │ -0001dd40: 6f20 6265 2065 7363 6170 6564 2e20 204c o be escaped. L │ │ │ │ -0001dd50: 6f6f 7062 6163 6b0a 7573 6573 2077 6861 oopback.uses wha │ │ │ │ -0001dd60: 7465 7665 7220 6e61 6d65 2073 7065 6369 tever name speci │ │ │ │ -0001dd70: 6669 6564 2074 6f20 276c 6f6f 7062 6163 fied to 'loopbac │ │ │ │ -0001dd80: 6b27 2063 6f6d 6d61 6e64 2e20 2048 6f73 k' command. Hos │ │ │ │ -0001dd90: 7464 6973 6b20 7573 6573 206e 616d 6573 tdisk uses names │ │ │ │ -0001dda0: 0a73 7065 6369 6669 6564 2069 6e20 6465 .specified in de │ │ │ │ -0001ddb0: 7669 6365 2e6d 6170 2061 7320 6c6f 6e67 vice.map as long │ │ │ │ -0001ddc0: 2061 7320 6974 2773 206f 6620 7468 6520 as it's of the │ │ │ │ -0001ddd0: 666f 726d 205b 6668 635d 645b 302d 395d form [fhc]d[0-9] │ │ │ │ -0001dde0: 2a20 6f72 0a68 6f73 7464 6973 6b2f 3c4f * or.hostdisk/. For │ │ │ │ -0001de00: 6372 7970 746f 2061 6e64 2052 4149 4420 crypto and RAID │ │ │ │ -0001de10: 286d 6429 2061 6464 6974 696f 6e61 6c6c (md) additionall │ │ │ │ -0001de20: 7920 796f 7520 6361 6e20 7573 650a 7468 y you can use.th │ │ │ │ -0001de30: 6520 7379 6e74 6178 203c 6472 6976 6572 e syntax uuid/. For LVM addi │ │ │ │ -0001de60: 7469 6f6e 616c 6c79 2079 6f75 2063 616e tionally you can │ │ │ │ -0001de70: 2075 7365 0a74 6865 2073 796e 7461 7820 use.the syntax │ │ │ │ -0001de80: 6c76 6d69 642f 3c76 6f6c 756d 652d 6772 lvmid//... ( │ │ │ │ -0001deb0: 6664 3029 0a20 2020 2020 2868 6430 290a fd0). (hd0). │ │ │ │ -0001dec0: 2020 2020 2028 6364 290a 2020 2020 2028 (cd). ( │ │ │ │ -0001ded0: 6168 6369 3029 0a20 2020 2020 2861 7461 ahci0). (ata │ │ │ │ -0001dee0: 3029 0a20 2020 2020 2863 7279 7074 6f30 0). (crypto0 │ │ │ │ -0001def0: 290a 2020 2020 2028 7573 6230 290a 2020 ). (usb0). │ │ │ │ -0001df00: 2020 2028 6372 7970 746f 7575 6964 2f31 (cryptouuid/1 │ │ │ │ -0001df10: 3233 3435 3637 3839 6162 6364 6566 3031 23456789abcdef01 │ │ │ │ -0001df20: 3233 3435 3637 3839 6162 6364 6566 3029 23456789abcdef0) │ │ │ │ -0001df30: 0a20 2020 2020 286d 6475 7569 642f 3132 . (mduuid/12 │ │ │ │ -0001df40: 3334 3536 3738 3961 6263 6465 6630 3132 3456789abcdef012 │ │ │ │ -0001df50: 3334 3536 3738 3961 6263 6465 6630 290a 3456789abcdef0). │ │ │ │ -0001df60: 2020 2020 2028 6c76 6d2f 7379 7374 656d (lvm/system │ │ │ │ -0001df70: 2d72 6f6f 7429 0a20 2020 2020 286c 766d -root). (lvm │ │ │ │ -0001df80: 6964 2f46 3169 6b67 442d 3252 4553 2d33 id/F1ikgD-2RES-3 │ │ │ │ -0001df90: 3036 472d 696c 394d 2d37 6977 612d 344e 06G-il9M-7iwa-4N │ │ │ │ -0001dfa0: 4b57 2d45 6256 314e 562f 654c 4775 4351 KW-EbV1NV/eLGuCQ │ │ │ │ -0001dfb0: 2d4c 344b 612d 5855 6752 2d73 6a74 4a2d -L4Ka-XUgR-sjtJ- │ │ │ │ -0001dfc0: 6666 6368 2d62 616a 722d 6643 4e66 7a35 ffch-bajr-fCNfz5 │ │ │ │ -0001dfd0: 290a 2020 2020 2028 6d64 2f6d 7972 6169 ). (md/myrai │ │ │ │ -0001dfe0: 6429 0a20 2020 2020 286d 642f 3029 0a20 d). (md/0). │ │ │ │ -0001dff0: 2020 2020 2869 6565 6531 3237 352f 6469 (ieee1275/di │ │ │ │ -0001e000: 736b 3229 0a20 2020 2020 2869 6565 6531 sk2). (ieee1 │ │ │ │ -0001e010: 3237 352f 2f70 6369 4031 665c 2c30 2f69 275//pci@1f\,0/i │ │ │ │ -0001e020: 6465 4064 2f64 6973 6b40 3229 0a20 2020 de@d/disk@2). │ │ │ │ -0001e030: 2020 286e 616e 6429 0a20 2020 2020 286d (nand). (m │ │ │ │ -0001e040: 656d 6469 736b 290a 2020 2020 2028 686f emdisk). (ho │ │ │ │ -0001e050: 7374 290a 2020 2020 2028 6d79 6c6f 6f70 st). (myloop │ │ │ │ -0001e060: 290a 2020 2020 2028 686f 7374 6469 736b ). (hostdisk │ │ │ │ -0001e070: 2f2f 6465 762f 7364 6129 0a0a 2020 2050 //dev/sda).. P │ │ │ │ -0001e080: 4152 542d 4e55 4d20 7265 7072 6573 656e ART-NUM represen │ │ │ │ -0001e090: 7473 2074 6865 2070 6172 7469 7469 6f6e ts the partition │ │ │ │ -0001e0a0: 206e 756d 6265 7220 6f66 2044 4556 4943 number of DEVIC │ │ │ │ -0001e0b0: 452c 2073 7461 7274 696e 6720 6672 6f6d E, starting from │ │ │ │ -0001e0c0: 0a6f 6e65 2e20 2050 4152 544e 414d 4520 .one. PARTNAME │ │ │ │ -0001e0d0: 6973 206f 7074 696f 6e61 6c20 6275 7420 is optional but │ │ │ │ -0001e0e0: 6973 2072 6563 6f6d 6d65 6e64 6564 2073 is recommended s │ │ │ │ -0001e0f0: 696e 6365 2064 6973 6b20 6d61 7920 6861 ince disk may ha │ │ │ │ -0001e100: 7665 0a73 6576 6572 616c 2074 6f70 2d6c ve.several top-l │ │ │ │ -0001e110: 6576 656c 2070 6172 746d 6170 732e 2020 evel partmaps. │ │ │ │ -0001e120: 5370 6563 6966 7969 6e67 2074 6869 7264 Specifying third │ │ │ │ -0001e130: 2061 6e64 206c 6174 6572 2063 6f6d 706f and later compo │ │ │ │ -0001e140: 6e65 6e74 2079 6f75 0a63 616e 2061 6363 nent you.can acc │ │ │ │ -0001e150: 6573 7320 746f 2073 7562 7061 7274 6974 ess to subpartit │ │ │ │ -0001e160: 696f 6e73 2e0a 0a20 2020 5468 6520 7379 ions... The sy │ │ │ │ -0001e170: 6e74 6178 2027 2868 6430 2927 2072 6570 ntax '(hd0)' rep │ │ │ │ -0001e180: 7265 7365 6e74 7320 7573 696e 6720 7468 resents using th │ │ │ │ -0001e190: 6520 656e 7469 7265 2064 6973 6b20 286f e entire disk (o │ │ │ │ -0001e1a0: 7220 7468 6520 4d42 5220 7768 656e 0a69 r the MBR when.i │ │ │ │ -0001e1b0: 6e73 7461 6c6c 696e 6720 4752 5542 292c nstalling GRUB), │ │ │ │ -0001e1c0: 2077 6869 6c65 2074 6865 2073 796e 7461 while the synta │ │ │ │ -0001e1d0: 7820 2728 6864 302c 3129 2720 7265 7072 x '(hd0,1)' repr │ │ │ │ -0001e1e0: 6573 656e 7473 2075 7369 6e67 2074 6865 esents using the │ │ │ │ -0001e1f0: 2066 6972 7374 0a70 6172 7469 7469 6f6e first.partition │ │ │ │ -0001e200: 206f 6620 7468 6520 6469 736b 2028 6f72 of the disk (or │ │ │ │ -0001e210: 2074 6865 2062 6f6f 7420 7365 6374 6f72 the boot sector │ │ │ │ -0001e220: 206f 6620 7468 6520 7061 7274 6974 696f of the partitio │ │ │ │ -0001e230: 6e20 7768 656e 0a69 6e73 7461 6c6c 696e n when.installin │ │ │ │ -0001e240: 6720 4752 5542 292e 0a0a 2020 2020 2028 g GRUB)... ( │ │ │ │ -0001e250: 6864 302c 6d73 646f 7331 290a 2020 2020 hd0,msdos1). │ │ │ │ -0001e260: 2028 6864 302c 6d73 646f 7331 2c6d 7364 (hd0,msdos1,msd │ │ │ │ -0001e270: 6f73 3529 0a20 2020 2020 2868 6430 2c6d os5). (hd0,m │ │ │ │ -0001e280: 7364 6f73 312c 6273 6433 290a 2020 2020 sdos1,bsd3). │ │ │ │ -0001e290: 2028 6864 302c 6e65 7462 7364 3129 0a20 (hd0,netbsd1). │ │ │ │ -0001e2a0: 2020 2020 2868 6430 2c67 7074 3129 0a20 (hd0,gpt1). │ │ │ │ -0001e2b0: 2020 2020 2868 6430 2c31 2c33 290a 0a20 (hd0,1,3).. │ │ │ │ -0001e2c0: 2020 4966 2079 6f75 2065 6e61 626c 6564 If you enabled │ │ │ │ -0001e2d0: 2074 6865 206e 6574 776f 726b 2073 7570 the network sup │ │ │ │ -0001e2e0: 706f 7274 2c20 7468 6520 7370 6563 6961 port, the specia │ │ │ │ -0001e2f0: 6c20 6472 6976 6573 0a27 2850 524f 544f l drives.'(PROTO │ │ │ │ -0001e300: 434f 4c5b 2c53 4552 5645 525d 2927 2061 COL[,SERVER])' a │ │ │ │ -0001e310: 7265 2061 6c73 6f20 6176 6169 6c61 626c re also availabl │ │ │ │ -0001e320: 652e 2020 5375 7070 6f72 7465 6420 7072 e. Supported pr │ │ │ │ -0001e330: 6f74 6f63 6f6c 7320 6172 650a 2768 7474 otocols are.'htt │ │ │ │ -0001e340: 7027 2061 6e64 2027 7466 7470 272e 2020 p' and 'tftp'. │ │ │ │ -0001e350: 4966 2053 4552 5645 5220 6973 206f 6d69 If SERVER is omi │ │ │ │ -0001e360: 7474 6564 2c20 7661 6c75 6520 6f66 2065 tted, value of e │ │ │ │ -0001e370: 6e76 6972 6f6e 6d65 6e74 2076 6172 6961 nvironment varia │ │ │ │ -0001e380: 626c 650a 276e 6574 5f64 6566 6175 6c74 ble.'net_default │ │ │ │ -0001e390: 5f73 6572 7665 7227 2069 7320 7573 6564 _server' is used │ │ │ │ -0001e3a0: 2e20 2042 6566 6f72 6520 7573 696e 6720 . Before using │ │ │ │ -0001e3b0: 7468 6520 6e65 7477 6f72 6b20 6472 6976 the network driv │ │ │ │ -0001e3c0: 652c 2079 6f75 206d 7573 740a 696e 6974 e, you must.init │ │ │ │ -0001e3d0: 6961 6c69 7a65 2074 6865 206e 6574 776f ialize the netwo │ │ │ │ -0001e3e0: 726b 2e20 202a 4e6f 7465 204e 6574 776f rk. *Note Netwo │ │ │ │ -0001e3f0: 726b 3a3a 2c20 666f 7220 6d6f 7265 2069 rk::, for more i │ │ │ │ -0001e400: 6e66 6f72 6d61 7469 6f6e 2e0a 0a20 2020 nformation... │ │ │ │ -0001e410: 4966 2079 6f75 2062 6f6f 7420 4752 5542 If you boot GRUB │ │ │ │ -0001e420: 2066 726f 6d20 6120 4344 2d52 4f4d 2c20 from a CD-ROM, │ │ │ │ -0001e430: 2728 6364 2927 2069 7320 6176 6169 6c61 '(cd)' is availa │ │ │ │ -0001e440: 626c 652e 2020 2a4e 6f74 6520 4d61 6b69 ble. *Note Maki │ │ │ │ -0001e450: 6e67 2061 0a47 5255 4220 626f 6f74 6162 ng a.GRUB bootab │ │ │ │ -0001e460: 6c65 2043 442d 524f 4d3a 3a2c 2066 6f72 le CD-ROM::, for │ │ │ │ -0001e470: 2064 6574 6169 6c73 2e0a 0a1f 0a46 696c details.....Fil │ │ │ │ -0001e480: 653a 2067 7275 622e 696e 666f 2c20 204e e: grub.info, N │ │ │ │ -0001e490: 6f64 653a 2046 696c 6520 6e61 6d65 2073 ode: File name s │ │ │ │ -0001e4a0: 796e 7461 782c 2020 4e65 7874 3a20 426c yntax, Next: Bl │ │ │ │ -0001e4b0: 6f63 6b20 6c69 7374 2073 796e 7461 782c ock list syntax, │ │ │ │ -0001e4c0: 2020 5072 6576 3a20 4465 7669 6365 2073 Prev: Device s │ │ │ │ -0001e4d0: 796e 7461 782c 2020 5570 3a20 4669 6c65 yntax, Up: File │ │ │ │ -0001e4e0: 7379 7374 656d 0a0a 3133 2e32 2048 6f77 system..13.2 How │ │ │ │ -0001e4f0: 2074 6f20 7370 6563 6966 7920 6669 6c65 to specify file │ │ │ │ -0001e500: 730a 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d s.============== │ │ │ │ -0001e510: 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a54 6865 ===========..The │ │ │ │ -0001e520: 7265 2061 7265 2074 776f 2077 6179 7320 re are two ways │ │ │ │ -0001e530: 746f 2073 7065 6369 6679 2066 696c 6573 to specify files │ │ │ │ -0001e540: 2c20 6279 2022 6162 736f 6c75 7465 2066 , by "absolute f │ │ │ │ -0001e550: 696c 6520 6e61 6d65 2220 616e 6420 6279 ile name" and by │ │ │ │ -0001e560: 0a22 626c 6f63 6b20 6c69 7374 222e 0a0a ."block list"... │ │ │ │ -0001e570: 2020 2041 6e20 6162 736f 6c75 7465 2066 An absolute f │ │ │ │ -0001e580: 696c 6520 6e61 6d65 2072 6573 656d 626c ile name resembl │ │ │ │ -0001e590: 6573 2061 2055 6e69 7820 6162 736f 6c75 es a Unix absolu │ │ │ │ -0001e5a0: 7465 2066 696c 6520 6e61 6d65 2c20 7573 te file name, us │ │ │ │ -0001e5b0: 696e 6720 272f 270a 666f 7220 7468 6520 ing '/'.for the │ │ │ │ -0001e5c0: 6469 7265 6374 6f72 7920 7365 7061 7261 directory separa │ │ │ │ -0001e5d0: 746f 7220 286e 6f74 2027 5c27 2061 7320 tor (not '\' as │ │ │ │ -0001e5e0: 696e 2044 4f53 292e 204f 6e65 2065 7861 in DOS). One exa │ │ │ │ -0001e5f0: 6d70 6c65 2069 730a 2728 6864 302c 3129 mple is.'(hd0,1) │ │ │ │ -0001e600: 2f62 6f6f 742f 6772 7562 2f67 7275 622e /boot/grub/grub. │ │ │ │ -0001e610: 6366 6727 2e20 2054 6869 7320 6d65 616e cfg'. This mean │ │ │ │ -0001e620: 7320 7468 6520 6669 6c65 2027 2f62 6f6f s the file '/boo │ │ │ │ -0001e630: 742f 6772 7562 2f67 7275 622e 6366 6727 t/grub/grub.cfg' │ │ │ │ -0001e640: 0a69 6e20 7468 6520 6669 7273 7420 7061 .in the first pa │ │ │ │ -0001e650: 7274 6974 696f 6e20 6f66 2074 6865 2066 rtition of the f │ │ │ │ -0001e660: 6972 7374 2068 6172 6420 6469 736b 2e20 irst hard disk. │ │ │ │ -0001e670: 2049 6620 796f 7520 6f6d 6974 2074 6865 If you omit the │ │ │ │ -0001e680: 2064 6576 6963 650a 6e61 6d65 2069 6e20 device.name in │ │ │ │ -0001e690: 616e 2061 6273 6f6c 7574 6520 6669 6c65 an absolute file │ │ │ │ -0001e6a0: 206e 616d 652c 2047 5255 4220 7573 6573 name, GRUB uses │ │ │ │ -0001e6b0: 2047 5255 4227 7320 2272 6f6f 7420 6465 GRUB's "root de │ │ │ │ -0001e6c0: 7669 6365 220a 696d 706c 6963 6974 6c79 vice".implicitly │ │ │ │ -0001e6d0: 2e20 2053 6f20 6966 2079 6f75 2073 6574 . So if you set │ │ │ │ -0001e6e0: 2074 6865 2072 6f6f 7420 6465 7669 6365 the root device │ │ │ │ -0001e6f0: 2074 6f2c 2073 6179 2c20 2728 6864 312c to, say, '(hd1, │ │ │ │ -0001e700: 3129 2720 6279 2074 6865 0a63 6f6d 6d61 1)' by the.comma │ │ │ │ -0001e710: 6e64 2027 7365 7420 726f 6f74 3d28 6864 nd 'set root=(hd │ │ │ │ -0001e720: 312c 3129 2720 282a 6e6f 7465 2073 6574 1,1)' (*note set │ │ │ │ -0001e730: 3a3a 292c 2074 6865 6e20 272f 626f 6f74 ::), then '/boot │ │ │ │ -0001e740: 2f6b 6572 6e65 6c27 2069 7320 7468 650a /kernel' is the. │ │ │ │ -0001e750: 7361 6d65 2061 7320 2728 6864 312c 3129 same as '(hd1,1) │ │ │ │ -0001e760: 2f62 6f6f 742f 6b65 726e 656c 272e 0a0a /boot/kernel'... │ │ │ │ -0001e770: 2020 204f 6e20 5a46 5320 6669 6c65 7379 On ZFS filesy │ │ │ │ -0001e780: 7374 656d 2074 6865 2066 6972 7374 2070 stem the first p │ │ │ │ -0001e790: 6174 6820 636f 6d70 6f6e 656e 7420 6d75 ath component mu │ │ │ │ -0001e7a0: 7374 2062 650a 564f 4c55 4d45 2740 275b st be.VOLUME'@'[ │ │ │ │ -0001e7b0: 534e 4150 5348 4f54 5d2e 2020 536f 2027 SNAPSHOT]. So ' │ │ │ │ -0001e7c0: 2f72 6f6f 7476 6f6c 4073 6e61 702d 3132 /rootvol@snap-12 │ │ │ │ -0001e7d0: 392f 626f 6f74 2f67 7275 622f 6772 7562 9/boot/grub/grub │ │ │ │ -0001e7e0: 2e63 6667 2720 7265 6665 7273 0a74 6f20 .cfg' refers.to │ │ │ │ -0001e7f0: 6669 6c65 2027 2f62 6f6f 742f 6772 7562 file '/boot/grub │ │ │ │ -0001e800: 2f67 7275 622e 6366 6727 2069 6e20 736e /grub.cfg' in sn │ │ │ │ -0001e810: 6170 7368 6f74 206f 6620 766f 6c75 6d65 apshot of volume │ │ │ │ -0001e820: 2027 726f 6f74 766f 6c27 2077 6974 6820 'rootvol' with │ │ │ │ -0001e830: 6e61 6d65 0a27 736e 6170 2d31 3239 272e name.'snap-129'. │ │ │ │ -0001e840: 2020 5472 6169 6c69 6e67 2027 4027 2061 Trailing '@' a │ │ │ │ -0001e850: 6674 6572 2076 6f6c 756d 6520 6e61 6d65 fter volume name │ │ │ │ -0001e860: 2069 7320 6d61 6e64 6174 6f72 7920 6576 is mandatory ev │ │ │ │ -0001e870: 656e 2069 660a 736e 6170 7368 6f74 206e en if.snapshot n │ │ │ │ -0001e880: 616d 6520 6973 206f 6d69 7474 6564 2e0a ame is omitted.. │ │ │ │ -0001e890: 0a1f 0a46 696c 653a 2067 7275 622e 696e ...File: grub.in │ │ │ │ -0001e8a0: 666f 2c20 204e 6f64 653a 2042 6c6f 636b fo, Node: Block │ │ │ │ -0001e8b0: 206c 6973 7420 7379 6e74 6178 2c20 2050 list syntax, P │ │ │ │ -0001e8c0: 7265 763a 2046 696c 6520 6e61 6d65 2073 rev: File name s │ │ │ │ -0001e8d0: 796e 7461 782c 2020 5570 3a20 4669 6c65 yntax, Up: File │ │ │ │ -0001e8e0: 7379 7374 656d 0a0a 3133 2e33 2048 6f77 system..13.3 How │ │ │ │ -0001e8f0: 2074 6f20 7370 6563 6966 7920 626c 6f63 to specify bloc │ │ │ │ -0001e900: 6b20 6c69 7374 730a 3d3d 3d3d 3d3d 3d3d k lists.======== │ │ │ │ +0001d7d0: 2a2a 2a2a 2a2a 2a0a 0a47 5255 4220 7573 *******..GRUB us │ │ │ │ +0001d7e0: 6573 2061 2073 7065 6369 616c 2073 796e es a special syn │ │ │ │ +0001d7f0: 7461 7820 666f 7220 7370 6563 6966 7969 tax for specifyi │ │ │ │ +0001d800: 6e67 2064 6973 6b20 6472 6976 6573 2077 ng disk drives w │ │ │ │ +0001d810: 6869 6368 2063 616e 2062 650a 6163 6365 hich can be.acce │ │ │ │ +0001d820: 7373 6564 2062 7920 4249 4f53 2e20 4265 ssed by BIOS. Be │ │ │ │ +0001d830: 6361 7573 6520 6f66 2042 494f 5320 6c69 cause of BIOS li │ │ │ │ +0001d840: 6d69 7461 7469 6f6e 732c 2047 5255 4220 mitations, GRUB │ │ │ │ +0001d850: 6361 6e6e 6f74 2064 6973 7469 6e67 7569 cannot distingui │ │ │ │ +0001d860: 7368 0a62 6574 7765 656e 2049 4445 2c20 sh.between IDE, │ │ │ │ +0001d870: 4553 4449 2c20 5343 5349 2c20 6f72 206f ESDI, SCSI, or o │ │ │ │ +0001d880: 7468 6572 732e 2020 596f 7520 6d75 7374 thers. You must │ │ │ │ +0001d890: 206b 6e6f 7720 796f 7572 7365 6c66 2077 know yourself w │ │ │ │ +0001d8a0: 6869 6368 2042 494f 530a 6465 7669 6365 hich BIOS.device │ │ │ │ +0001d8b0: 2069 7320 6571 7569 7661 6c65 6e74 2074 is equivalent t │ │ │ │ +0001d8c0: 6f20 7768 6963 6820 4f53 2064 6576 6963 o which OS devic │ │ │ │ +0001d8d0: 652e 2020 4e6f 726d 616c 6c79 2c20 7468 e. Normally, th │ │ │ │ +0001d8e0: 6174 2077 696c 6c20 6265 2063 6c65 6172 at will be clear │ │ │ │ +0001d8f0: 0a69 6620 796f 7520 7365 6520 7468 6520 .if you see the │ │ │ │ +0001d900: 6669 6c65 7320 696e 2061 2064 6576 6963 files in a devic │ │ │ │ +0001d910: 6520 6f72 2075 7365 2074 6865 2063 6f6d e or use the com │ │ │ │ +0001d920: 6d61 6e64 2027 7365 6172 6368 2720 282a mand 'search' (* │ │ │ │ +0001d930: 6e6f 7465 0a73 6561 7263 683a 3a29 2e0a note.search::).. │ │ │ │ +0001d940: 0a2a 204d 656e 753a 0a0a 2a20 4465 7669 .* Menu:..* Devi │ │ │ │ +0001d950: 6365 2073 796e 7461 783a 3a20 2020 2020 ce syntax:: │ │ │ │ +0001d960: 2020 2020 2020 2020 2020 486f 7720 746f How to │ │ │ │ +0001d970: 2073 7065 6369 6679 2064 6576 6963 6573 specify devices │ │ │ │ +0001d980: 0a2a 2046 696c 6520 6e61 6d65 2073 796e .* File name syn │ │ │ │ +0001d990: 7461 783a 3a20 2020 2020 2020 2020 2020 tax:: │ │ │ │ +0001d9a0: 2048 6f77 2074 6f20 7370 6563 6966 7920 How to specify │ │ │ │ +0001d9b0: 6669 6c65 730a 2a20 426c 6f63 6b20 6c69 files.* Block li │ │ │ │ +0001d9c0: 7374 2073 796e 7461 783a 3a20 2020 2020 st syntax:: │ │ │ │ +0001d9d0: 2020 2020 2020 486f 7720 746f 2073 7065 How to spe │ │ │ │ +0001d9e0: 6369 6679 2062 6c6f 636b 206c 6973 7473 cify block lists │ │ │ │ +0001d9f0: 0a0a 1f0a 4669 6c65 3a20 6772 7562 2e69 ....File: grub.i │ │ │ │ +0001da00: 6e66 6f2c 2020 4e6f 6465 3a20 4465 7669 nfo, Node: Devi │ │ │ │ +0001da10: 6365 2073 796e 7461 782c 2020 4e65 7874 ce syntax, Next │ │ │ │ +0001da20: 3a20 4669 6c65 206e 616d 6520 7379 6e74 : File name synt │ │ │ │ +0001da30: 6178 2c20 2055 703a 2046 696c 6573 7973 ax, Up: Filesys │ │ │ │ +0001da40: 7465 6d0a 0a31 332e 3120 486f 7720 746f tem..13.1 How to │ │ │ │ +0001da50: 2073 7065 6369 6679 2064 6576 6963 6573 specify devices │ │ │ │ +0001da60: 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d .=============== │ │ │ │ +0001da70: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a 5468 ============..Th │ │ │ │ +0001da80: 6520 6465 7669 6365 2073 796e 7461 7820 e device syntax │ │ │ │ +0001da90: 6973 206c 696b 6520 7468 6973 3a0a 0a20 is like this:.. │ │ │ │ +0001daa0: 2020 2020 2844 4556 4943 455b 2c50 4152 (DEVICE[,PAR │ │ │ │ +0001dab0: 544d 4150 2d4e 414d 4531 5041 5254 2d4e TMAP-NAME1PART-N │ │ │ │ +0001dac0: 554d 315b 2c50 4152 544d 4150 2d4e 414d UM1[,PARTMAP-NAM │ │ │ │ +0001dad0: 4532 5041 5254 2d4e 554d 325b 2c2e 2e2e E2PART-NUM2[,... │ │ │ │ +0001dae0: 5d5d 5d29 0a0a 2020 2027 5b5d 2720 6d65 ]]]).. '[]' me │ │ │ │ +0001daf0: 616e 7320 7468 6520 7061 7261 6d65 7465 ans the paramete │ │ │ │ +0001db00: 7220 6973 206f 7074 696f 6e61 6c2e 2020 r is optional. │ │ │ │ +0001db10: 4445 5649 4345 2064 6570 656e 6473 206f DEVICE depends o │ │ │ │ +0001db20: 6e20 7468 6520 6469 736b 0a64 7269 7665 n the disk.drive │ │ │ │ +0001db30: 7220 696e 2075 7365 2e20 2042 494f 5320 r in use. BIOS │ │ │ │ +0001db40: 616e 6420 4546 4920 6469 736b 7320 7573 and EFI disks us │ │ │ │ +0001db50: 6520 6569 7468 6572 2027 6664 2720 6f72 e either 'fd' or │ │ │ │ +0001db60: 2027 6864 2720 666f 6c6c 6f77 6564 2062 'hd' followed b │ │ │ │ +0001db70: 7920 610a 6469 6769 742c 206c 696b 6520 y a.digit, like │ │ │ │ +0001db80: 2766 6430 272c 206f 7220 2763 6427 2e20 'fd0', or 'cd'. │ │ │ │ +0001db90: 2041 4843 492c 2050 4154 4120 2861 7461 AHCI, PATA (ata │ │ │ │ +0001dba0: 292c 2063 7279 7074 6f2c 2055 5342 2075 ), crypto, USB u │ │ │ │ +0001dbb0: 7365 2074 6865 206e 616d 650a 6f66 2064 se the name.of d │ │ │ │ +0001dbc0: 7269 7665 7220 666f 6c6c 6f77 6564 2062 river followed b │ │ │ │ +0001dbd0: 7920 6120 6e75 6d62 6572 2e20 204d 656d y a number. Mem │ │ │ │ +0001dbe0: 6469 736b 2061 6e64 2068 6f73 7420 6172 disk and host ar │ │ │ │ +0001dbf0: 6520 6c69 6d69 7465 6420 746f 206f 6e65 e limited to one │ │ │ │ +0001dc00: 0a64 6973 6b20 616e 6420 736f 2069 7427 .disk and so it' │ │ │ │ +0001dc10: 7320 7265 6665 7265 6420 6a75 7374 2062 s refered just b │ │ │ │ +0001dc20: 7920 6472 6976 6572 206e 616d 652e 2020 y driver name. │ │ │ │ +0001dc30: 5241 4944 2028 6d64 292c 206f 6664 6973 RAID (md), ofdis │ │ │ │ +0001dc40: 6b0a 2869 6565 6531 3237 3520 616e 6420 k.(ieee1275 and │ │ │ │ +0001dc50: 6e61 6e64 292c 204c 564d 2028 6c76 6d29 nand), LVM (lvm) │ │ │ │ +0001dc60: 2c20 4c44 4d2c 2076 6972 7469 6f20 2876 , LDM, virtio (v │ │ │ │ +0001dc70: 6473 6b29 2061 6e64 2061 7263 6469 736b dsk) and arcdisk │ │ │ │ +0001dc80: 2028 6172 6329 2075 7365 0a69 6e74 7269 (arc) use.intri │ │ │ │ +0001dc90: 6e73 6963 206e 616d 6520 6f66 2064 6973 nsic name of dis │ │ │ │ +0001dca0: 6b20 7072 6566 6978 6564 2062 7920 6472 k prefixed by dr │ │ │ │ +0001dcb0: 6976 6572 206e 616d 652e 2020 4164 6469 iver name. Addi │ │ │ │ +0001dcc0: 7469 6f6e 616c 6c79 206a 7573 740a 226e tionally just."n │ │ │ │ +0001dcd0: 616e 6422 2072 6566 6572 7320 746f 2074 and" refers to t │ │ │ │ +0001dce0: 6865 2064 6973 6b20 616c 6961 7365 6420 he disk aliased │ │ │ │ +0001dcf0: 6173 2022 6e61 6e64 222e 2020 436f 6e66 as "nand". Conf │ │ │ │ +0001dd00: 6c69 6374 7320 6172 6520 736f 6c76 6564 licts are solved │ │ │ │ +0001dd10: 2062 790a 7375 6666 6978 696e 6720 6120 by.suffixing a │ │ │ │ +0001dd20: 6e75 6d62 6572 2069 6620 6e65 6365 7373 number if necess │ │ │ │ +0001dd30: 6172 7279 2e20 2043 6f6d 6d61 7320 6e65 arry. Commas ne │ │ │ │ +0001dd40: 6564 2074 6f20 6265 2065 7363 6170 6564 ed to be escaped │ │ │ │ +0001dd50: 2e20 204c 6f6f 7062 6163 6b0a 7573 6573 . Loopback.uses │ │ │ │ +0001dd60: 2077 6861 7465 7665 7220 6e61 6d65 2073 whatever name s │ │ │ │ +0001dd70: 7065 6369 6669 6564 2074 6f20 276c 6f6f pecified to 'loo │ │ │ │ +0001dd80: 7062 6163 6b27 2063 6f6d 6d61 6e64 2e20 pback' command. │ │ │ │ +0001dd90: 2048 6f73 7464 6973 6b20 7573 6573 206e Hostdisk uses n │ │ │ │ +0001dda0: 616d 6573 0a73 7065 6369 6669 6564 2069 ames.specified i │ │ │ │ +0001ddb0: 6e20 6465 7669 6365 2e6d 6170 2061 7320 n device.map as │ │ │ │ +0001ddc0: 6c6f 6e67 2061 7320 6974 2773 206f 6620 long as it's of │ │ │ │ +0001ddd0: 7468 6520 666f 726d 205b 6668 635d 645b the form [fhc]d[ │ │ │ │ +0001dde0: 302d 395d 2a20 6f72 0a68 6f73 7464 6973 0-9]* or.hostdis │ │ │ │ +0001ddf0: 6b2f 3c4f 5320 4445 5649 4345 3e2e 2020 k/. │ │ │ │ +0001de00: 466f 7220 6372 7970 746f 2061 6e64 2052 For crypto and R │ │ │ │ +0001de10: 4149 4420 286d 6429 2061 6464 6974 696f AID (md) additio │ │ │ │ +0001de20: 6e61 6c6c 7920 796f 7520 6361 6e20 7573 nally you can us │ │ │ │ +0001de30: 650a 7468 6520 7379 6e74 6178 203c 6472 e.the syntax uuid/< │ │ │ │ +0001de50: 7575 6964 3e2e 2020 466f 7220 4c56 4d20 uuid>. For LVM │ │ │ │ +0001de60: 6164 6469 7469 6f6e 616c 6c79 2079 6f75 additionally you │ │ │ │ +0001de70: 2063 616e 2075 7365 0a74 6865 2073 796e can use.the syn │ │ │ │ +0001de80: 7461 7820 6c76 6d69 642f 3c76 6f6c 756d tax lvmid//... │ │ │ │ +0001deb0: 2020 2028 6664 3029 0a20 2020 2020 2868 (fd0). (h │ │ │ │ +0001dec0: 6430 290a 2020 2020 2028 6364 290a 2020 d0). (cd). │ │ │ │ +0001ded0: 2020 2028 6168 6369 3029 0a20 2020 2020 (ahci0). │ │ │ │ +0001dee0: 2861 7461 3029 0a20 2020 2020 2863 7279 (ata0). (cry │ │ │ │ +0001def0: 7074 6f30 290a 2020 2020 2028 7573 6230 pto0). (usb0 │ │ │ │ +0001df00: 290a 2020 2020 2028 6372 7970 746f 7575 ). (cryptouu │ │ │ │ +0001df10: 6964 2f31 3233 3435 3637 3839 6162 6364 id/123456789abcd │ │ │ │ +0001df20: 6566 3031 3233 3435 3637 3839 6162 6364 ef0123456789abcd │ │ │ │ +0001df30: 6566 3029 0a20 2020 2020 286d 6475 7569 ef0). (mduui │ │ │ │ +0001df40: 642f 3132 3334 3536 3738 3961 6263 6465 d/123456789abcde │ │ │ │ +0001df50: 6630 3132 3334 3536 3738 3961 6263 6465 f0123456789abcde │ │ │ │ +0001df60: 6630 290a 2020 2020 2028 6c76 6d2f 7379 f0). (lvm/sy │ │ │ │ +0001df70: 7374 656d 2d72 6f6f 7429 0a20 2020 2020 stem-root). │ │ │ │ +0001df80: 286c 766d 6964 2f46 3169 6b67 442d 3252 (lvmid/F1ikgD-2R │ │ │ │ +0001df90: 4553 2d33 3036 472d 696c 394d 2d37 6977 ES-306G-il9M-7iw │ │ │ │ +0001dfa0: 612d 344e 4b57 2d45 6256 314e 562f 654c a-4NKW-EbV1NV/eL │ │ │ │ +0001dfb0: 4775 4351 2d4c 344b 612d 5855 6752 2d73 GuCQ-L4Ka-XUgR-s │ │ │ │ +0001dfc0: 6a74 4a2d 6666 6368 2d62 616a 722d 6643 jtJ-ffch-bajr-fC │ │ │ │ +0001dfd0: 4e66 7a35 290a 2020 2020 2028 6d64 2f6d Nfz5). (md/m │ │ │ │ +0001dfe0: 7972 6169 6429 0a20 2020 2020 286d 642f yraid). (md/ │ │ │ │ +0001dff0: 3029 0a20 2020 2020 2869 6565 6531 3237 0). (ieee127 │ │ │ │ +0001e000: 352f 6469 736b 3229 0a20 2020 2020 2869 5/disk2). (i │ │ │ │ +0001e010: 6565 6531 3237 352f 2f70 6369 4031 665c eee1275//pci@1f\ │ │ │ │ +0001e020: 2c30 2f69 6465 4064 2f64 6973 6b40 3229 ,0/ide@d/disk@2) │ │ │ │ +0001e030: 0a20 2020 2020 286e 616e 6429 0a20 2020 . (nand). │ │ │ │ +0001e040: 2020 286d 656d 6469 736b 290a 2020 2020 (memdisk). │ │ │ │ +0001e050: 2028 686f 7374 290a 2020 2020 2028 6d79 (host). (my │ │ │ │ +0001e060: 6c6f 6f70 290a 2020 2020 2028 686f 7374 loop). (host │ │ │ │ +0001e070: 6469 736b 2f2f 6465 762f 7364 6129 0a0a disk//dev/sda).. │ │ │ │ +0001e080: 2020 2050 4152 542d 4e55 4d20 7265 7072 PART-NUM repr │ │ │ │ +0001e090: 6573 656e 7473 2074 6865 2070 6172 7469 esents the parti │ │ │ │ +0001e0a0: 7469 6f6e 206e 756d 6265 7220 6f66 2044 tion number of D │ │ │ │ +0001e0b0: 4556 4943 452c 2073 7461 7274 696e 6720 EVICE, starting │ │ │ │ +0001e0c0: 6672 6f6d 0a6f 6e65 2e20 2050 4152 544e from.one. PARTN │ │ │ │ +0001e0d0: 414d 4520 6973 206f 7074 696f 6e61 6c20 AME is optional │ │ │ │ +0001e0e0: 6275 7420 6973 2072 6563 6f6d 6d65 6e64 but is recommend │ │ │ │ +0001e0f0: 6564 2073 696e 6365 2064 6973 6b20 6d61 ed since disk ma │ │ │ │ +0001e100: 7920 6861 7665 0a73 6576 6572 616c 2074 y have.several t │ │ │ │ +0001e110: 6f70 2d6c 6576 656c 2070 6172 746d 6170 op-level partmap │ │ │ │ +0001e120: 732e 2020 5370 6563 6966 7969 6e67 2074 s. Specifying t │ │ │ │ +0001e130: 6869 7264 2061 6e64 206c 6174 6572 2063 hird and later c │ │ │ │ +0001e140: 6f6d 706f 6e65 6e74 2079 6f75 0a63 616e omponent you.can │ │ │ │ +0001e150: 2061 6363 6573 7320 746f 2073 7562 7061 access to subpa │ │ │ │ +0001e160: 7274 6974 696f 6e73 2e0a 0a20 2020 5468 rtitions... Th │ │ │ │ +0001e170: 6520 7379 6e74 6178 2027 2868 6430 2927 e syntax '(hd0)' │ │ │ │ +0001e180: 2072 6570 7265 7365 6e74 7320 7573 696e represents usin │ │ │ │ +0001e190: 6720 7468 6520 656e 7469 7265 2064 6973 g the entire dis │ │ │ │ +0001e1a0: 6b20 286f 7220 7468 6520 4d42 5220 7768 k (or the MBR wh │ │ │ │ +0001e1b0: 656e 0a69 6e73 7461 6c6c 696e 6720 4752 en.installing GR │ │ │ │ +0001e1c0: 5542 292c 2077 6869 6c65 2074 6865 2073 UB), while the s │ │ │ │ +0001e1d0: 796e 7461 7820 2728 6864 302c 3129 2720 yntax '(hd0,1)' │ │ │ │ +0001e1e0: 7265 7072 6573 656e 7473 2075 7369 6e67 represents using │ │ │ │ +0001e1f0: 2074 6865 2066 6972 7374 0a70 6172 7469 the first.parti │ │ │ │ +0001e200: 7469 6f6e 206f 6620 7468 6520 6469 736b tion of the disk │ │ │ │ +0001e210: 2028 6f72 2074 6865 2062 6f6f 7420 7365 (or the boot se │ │ │ │ +0001e220: 6374 6f72 206f 6620 7468 6520 7061 7274 ctor of the part │ │ │ │ +0001e230: 6974 696f 6e20 7768 656e 0a69 6e73 7461 ition when.insta │ │ │ │ +0001e240: 6c6c 696e 6720 4752 5542 292e 0a0a 2020 lling GRUB)... │ │ │ │ +0001e250: 2020 2028 6864 302c 6d73 646f 7331 290a (hd0,msdos1). │ │ │ │ +0001e260: 2020 2020 2028 6864 302c 6d73 646f 7331 (hd0,msdos1 │ │ │ │ +0001e270: 2c6d 7364 6f73 3529 0a20 2020 2020 2868 ,msdos5). (h │ │ │ │ +0001e280: 6430 2c6d 7364 6f73 312c 6273 6433 290a d0,msdos1,bsd3). │ │ │ │ +0001e290: 2020 2020 2028 6864 302c 6e65 7462 7364 (hd0,netbsd │ │ │ │ +0001e2a0: 3129 0a20 2020 2020 2868 6430 2c67 7074 1). (hd0,gpt │ │ │ │ +0001e2b0: 3129 0a20 2020 2020 2868 6430 2c31 2c33 1). (hd0,1,3 │ │ │ │ +0001e2c0: 290a 0a20 2020 4966 2079 6f75 2065 6e61 ).. If you ena │ │ │ │ +0001e2d0: 626c 6564 2074 6865 206e 6574 776f 726b bled the network │ │ │ │ +0001e2e0: 2073 7570 706f 7274 2c20 7468 6520 7370 support, the sp │ │ │ │ +0001e2f0: 6563 6961 6c20 6472 6976 6573 0a27 2850 ecial drives.'(P │ │ │ │ +0001e300: 524f 544f 434f 4c5b 2c53 4552 5645 525d ROTOCOL[,SERVER] │ │ │ │ +0001e310: 2927 2061 7265 2061 6c73 6f20 6176 6169 )' are also avai │ │ │ │ +0001e320: 6c61 626c 652e 2020 5375 7070 6f72 7465 lable. Supporte │ │ │ │ +0001e330: 6420 7072 6f74 6f63 6f6c 7320 6172 650a d protocols are. │ │ │ │ +0001e340: 2768 7474 7027 2061 6e64 2027 7466 7470 'http' and 'tftp │ │ │ │ +0001e350: 272e 2020 4966 2053 4552 5645 5220 6973 '. If SERVER is │ │ │ │ +0001e360: 206f 6d69 7474 6564 2c20 7661 6c75 6520 omitted, value │ │ │ │ +0001e370: 6f66 2065 6e76 6972 6f6e 6d65 6e74 2076 of environment v │ │ │ │ +0001e380: 6172 6961 626c 650a 276e 6574 5f64 6566 ariable.'net_def │ │ │ │ +0001e390: 6175 6c74 5f73 6572 7665 7227 2069 7320 ault_server' is │ │ │ │ +0001e3a0: 7573 6564 2e20 2042 6566 6f72 6520 7573 used. Before us │ │ │ │ +0001e3b0: 696e 6720 7468 6520 6e65 7477 6f72 6b20 ing the network │ │ │ │ +0001e3c0: 6472 6976 652c 2079 6f75 206d 7573 740a drive, you must. │ │ │ │ +0001e3d0: 696e 6974 6961 6c69 7a65 2074 6865 206e initialize the n │ │ │ │ +0001e3e0: 6574 776f 726b 2e20 202a 4e6f 7465 204e etwork. *Note N │ │ │ │ +0001e3f0: 6574 776f 726b 3a3a 2c20 666f 7220 6d6f etwork::, for mo │ │ │ │ +0001e400: 7265 2069 6e66 6f72 6d61 7469 6f6e 2e0a re information.. │ │ │ │ +0001e410: 0a20 2020 4966 2079 6f75 2062 6f6f 7420 . If you boot │ │ │ │ +0001e420: 4752 5542 2066 726f 6d20 6120 4344 2d52 GRUB from a CD-R │ │ │ │ +0001e430: 4f4d 2c20 2728 6364 2927 2069 7320 6176 OM, '(cd)' is av │ │ │ │ +0001e440: 6169 6c61 626c 652e 2020 2a4e 6f74 6520 ailable. *Note │ │ │ │ +0001e450: 4d61 6b69 6e67 2061 0a47 5255 4220 626f Making a.GRUB bo │ │ │ │ +0001e460: 6f74 6162 6c65 2043 442d 524f 4d3a 3a2c otable CD-ROM::, │ │ │ │ +0001e470: 2066 6f72 2064 6574 6169 6c73 2e0a 0a1f for details.... │ │ │ │ +0001e480: 0a46 696c 653a 2067 7275 622e 696e 666f .File: grub.info │ │ │ │ +0001e490: 2c20 204e 6f64 653a 2046 696c 6520 6e61 , Node: File na │ │ │ │ +0001e4a0: 6d65 2073 796e 7461 782c 2020 4e65 7874 me syntax, Next │ │ │ │ +0001e4b0: 3a20 426c 6f63 6b20 6c69 7374 2073 796e : Block list syn │ │ │ │ +0001e4c0: 7461 782c 2020 5072 6576 3a20 4465 7669 tax, Prev: Devi │ │ │ │ +0001e4d0: 6365 2073 796e 7461 782c 2020 5570 3a20 ce syntax, Up: │ │ │ │ +0001e4e0: 4669 6c65 7379 7374 656d 0a0a 3133 2e32 Filesystem..13.2 │ │ │ │ +0001e4f0: 2048 6f77 2074 6f20 7370 6563 6966 7920 How to specify │ │ │ │ +0001e500: 6669 6c65 730a 3d3d 3d3d 3d3d 3d3d 3d3d files.========== │ │ │ │ +0001e510: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a ===============. │ │ │ │ +0001e520: 0a54 6865 7265 2061 7265 2074 776f 2077 .There are two w │ │ │ │ +0001e530: 6179 7320 746f 2073 7065 6369 6679 2066 ays to specify f │ │ │ │ +0001e540: 696c 6573 2c20 6279 2022 6162 736f 6c75 iles, by "absolu │ │ │ │ +0001e550: 7465 2066 696c 6520 6e61 6d65 2220 616e te file name" an │ │ │ │ +0001e560: 6420 6279 0a22 626c 6f63 6b20 6c69 7374 d by."block list │ │ │ │ +0001e570: 222e 0a0a 2020 2041 6e20 6162 736f 6c75 "... An absolu │ │ │ │ +0001e580: 7465 2066 696c 6520 6e61 6d65 2072 6573 te file name res │ │ │ │ +0001e590: 656d 626c 6573 2061 2055 6e69 7820 6162 embles a Unix ab │ │ │ │ +0001e5a0: 736f 6c75 7465 2066 696c 6520 6e61 6d65 solute file name │ │ │ │ +0001e5b0: 2c20 7573 696e 6720 272f 270a 666f 7220 , using '/'.for │ │ │ │ +0001e5c0: 7468 6520 6469 7265 6374 6f72 7920 7365 the directory se │ │ │ │ +0001e5d0: 7061 7261 746f 7220 286e 6f74 2027 5c27 parator (not '\' │ │ │ │ +0001e5e0: 2061 7320 696e 2044 4f53 292e 204f 6e65 as in DOS). One │ │ │ │ +0001e5f0: 2065 7861 6d70 6c65 2069 730a 2728 6864 example is.'(hd │ │ │ │ +0001e600: 302c 3129 2f62 6f6f 742f 6772 7562 2f67 0,1)/boot/grub/g │ │ │ │ +0001e610: 7275 622e 6366 6727 2e20 2054 6869 7320 rub.cfg'. This │ │ │ │ +0001e620: 6d65 616e 7320 7468 6520 6669 6c65 2027 means the file ' │ │ │ │ +0001e630: 2f62 6f6f 742f 6772 7562 2f67 7275 622e /boot/grub/grub. │ │ │ │ +0001e640: 6366 6727 0a69 6e20 7468 6520 6669 7273 cfg'.in the firs │ │ │ │ +0001e650: 7420 7061 7274 6974 696f 6e20 6f66 2074 t partition of t │ │ │ │ +0001e660: 6865 2066 6972 7374 2068 6172 6420 6469 he first hard di │ │ │ │ +0001e670: 736b 2e20 2049 6620 796f 7520 6f6d 6974 sk. If you omit │ │ │ │ +0001e680: 2074 6865 2064 6576 6963 650a 6e61 6d65 the device.name │ │ │ │ +0001e690: 2069 6e20 616e 2061 6273 6f6c 7574 6520 in an absolute │ │ │ │ +0001e6a0: 6669 6c65 206e 616d 652c 2047 5255 4220 file name, GRUB │ │ │ │ +0001e6b0: 7573 6573 2047 5255 4227 7320 2272 6f6f uses GRUB's "roo │ │ │ │ +0001e6c0: 7420 6465 7669 6365 220a 696d 706c 6963 t device".implic │ │ │ │ +0001e6d0: 6974 6c79 2e20 2053 6f20 6966 2079 6f75 itly. So if you │ │ │ │ +0001e6e0: 2073 6574 2074 6865 2072 6f6f 7420 6465 set the root de │ │ │ │ +0001e6f0: 7669 6365 2074 6f2c 2073 6179 2c20 2728 vice to, say, '( │ │ │ │ +0001e700: 6864 312c 3129 2720 6279 2074 6865 0a63 hd1,1)' by the.c │ │ │ │ +0001e710: 6f6d 6d61 6e64 2027 7365 7420 726f 6f74 ommand 'set root │ │ │ │ +0001e720: 3d28 6864 312c 3129 2720 282a 6e6f 7465 =(hd1,1)' (*note │ │ │ │ +0001e730: 2073 6574 3a3a 292c 2074 6865 6e20 272f set::), then '/ │ │ │ │ +0001e740: 626f 6f74 2f6b 6572 6e65 6c27 2069 7320 boot/kernel' is │ │ │ │ +0001e750: 7468 650a 7361 6d65 2061 7320 2728 6864 the.same as '(hd │ │ │ │ +0001e760: 312c 3129 2f62 6f6f 742f 6b65 726e 656c 1,1)/boot/kernel │ │ │ │ +0001e770: 272e 0a0a 2020 204f 6e20 5a46 5320 6669 '... On ZFS fi │ │ │ │ +0001e780: 6c65 7379 7374 656d 2074 6865 2066 6972 lesystem the fir │ │ │ │ +0001e790: 7374 2070 6174 6820 636f 6d70 6f6e 656e st path componen │ │ │ │ +0001e7a0: 7420 6d75 7374 2062 650a 564f 4c55 4d45 t must be.VOLUME │ │ │ │ +0001e7b0: 2740 275b 534e 4150 5348 4f54 5d2e 2020 '@'[SNAPSHOT]. │ │ │ │ +0001e7c0: 536f 2027 2f72 6f6f 7476 6f6c 4073 6e61 So '/rootvol@sna │ │ │ │ +0001e7d0: 702d 3132 392f 626f 6f74 2f67 7275 622f p-129/boot/grub/ │ │ │ │ +0001e7e0: 6772 7562 2e63 6667 2720 7265 6665 7273 grub.cfg' refers │ │ │ │ +0001e7f0: 0a74 6f20 6669 6c65 2027 2f62 6f6f 742f .to file '/boot/ │ │ │ │ +0001e800: 6772 7562 2f67 7275 622e 6366 6727 2069 grub/grub.cfg' i │ │ │ │ +0001e810: 6e20 736e 6170 7368 6f74 206f 6620 766f n snapshot of vo │ │ │ │ +0001e820: 6c75 6d65 2027 726f 6f74 766f 6c27 2077 lume 'rootvol' w │ │ │ │ +0001e830: 6974 6820 6e61 6d65 0a27 736e 6170 2d31 ith name.'snap-1 │ │ │ │ +0001e840: 3239 272e 2020 5472 6169 6c69 6e67 2027 29'. Trailing ' │ │ │ │ +0001e850: 4027 2061 6674 6572 2076 6f6c 756d 6520 @' after volume │ │ │ │ +0001e860: 6e61 6d65 2069 7320 6d61 6e64 6174 6f72 name is mandator │ │ │ │ +0001e870: 7920 6576 656e 2069 660a 736e 6170 7368 y even if.snapsh │ │ │ │ +0001e880: 6f74 206e 616d 6520 6973 206f 6d69 7474 ot name is omitt │ │ │ │ +0001e890: 6564 2e0a 0a1f 0a46 696c 653a 2067 7275 ed.....File: gru │ │ │ │ +0001e8a0: 622e 696e 666f 2c20 204e 6f64 653a 2042 b.info, Node: B │ │ │ │ +0001e8b0: 6c6f 636b 206c 6973 7420 7379 6e74 6178 lock list syntax │ │ │ │ +0001e8c0: 2c20 2050 7265 763a 2046 696c 6520 6e61 , Prev: File na │ │ │ │ +0001e8d0: 6d65 2073 796e 7461 782c 2020 5570 3a20 me syntax, Up: │ │ │ │ +0001e8e0: 4669 6c65 7379 7374 656d 0a0a 3133 2e33 Filesystem..13.3 │ │ │ │ +0001e8f0: 2048 6f77 2074 6f20 7370 6563 6966 7920 How to specify │ │ │ │ +0001e900: 626c 6f63 6b20 6c69 7374 730a 3d3d 3d3d block lists.==== │ │ │ │ 0001e910: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ -0001e920: 3d3d 3d3d 3d3d 3d0a 0a41 2062 6c6f 636b =======..A block │ │ │ │ -0001e930: 206c 6973 7420 6973 2075 7365 6420 666f list is used fo │ │ │ │ -0001e940: 7220 7370 6563 6966 7969 6e67 2061 2066 r specifying a f │ │ │ │ -0001e950: 696c 6520 7468 6174 2064 6f65 736e 2774 ile that doesn't │ │ │ │ -0001e960: 2061 7070 6561 7220 696e 2074 6865 0a66 appear in the.f │ │ │ │ -0001e970: 696c 6573 7973 7465 6d2c 206c 696b 6520 ilesystem, like │ │ │ │ -0001e980: 6120 6368 6169 6e6c 6f61 6465 722e 2020 a chainloader. │ │ │ │ -0001e990: 5468 6520 7379 6e74 6178 2069 730a 275b The syntax is.'[ │ │ │ │ -0001e9a0: 4f46 4653 4554 5d2b 4c45 4e47 5448 5b2c OFFSET]+LENGTH[, │ │ │ │ -0001e9b0: 5b4f 4646 5345 545d 2b4c 454e 4754 485d [OFFSET]+LENGTH] │ │ │ │ -0001e9c0: 2e2e 2e27 2e20 2048 6572 6520 6973 2061 ...'. Here is a │ │ │ │ -0001e9d0: 6e20 6578 616d 706c 653a 0a0a 2020 2020 n example:.. │ │ │ │ -0001e9e0: 2030 2b31 3030 2c32 3030 2b31 2c33 3030 0+100,200+1,300 │ │ │ │ -0001e9f0: 2b33 3030 0a0a 2020 2054 6869 7320 7265 +300.. This re │ │ │ │ -0001ea00: 7072 6573 656e 7473 2074 6861 7420 4752 presents that GR │ │ │ │ -0001ea10: 5542 2073 686f 756c 6420 7265 6164 2062 UB should read b │ │ │ │ -0001ea20: 6c6f 636b 7320 3020 7468 726f 7567 6820 locks 0 through │ │ │ │ -0001ea30: 3939 2c20 626c 6f63 6b20 3230 302c 0a61 99, block 200,.a │ │ │ │ -0001ea40: 6e64 2062 6c6f 636b 7320 3330 3020 7468 nd blocks 300 th │ │ │ │ -0001ea50: 726f 7567 6820 3539 392e 2020 4966 2079 rough 599. If y │ │ │ │ -0001ea60: 6f75 206f 6d69 7420 616e 206f 6666 7365 ou omit an offse │ │ │ │ -0001ea70: 742c 2074 6865 6e20 4752 5542 2061 7373 t, then GRUB ass │ │ │ │ -0001ea80: 756d 6573 0a74 6865 206f 6666 7365 7420 umes.the offset │ │ │ │ -0001ea90: 6973 207a 6572 6f2e 0a0a 2020 204c 696b is zero... Lik │ │ │ │ -0001eaa0: 6520 7468 6520 6669 6c65 206e 616d 6520 e the file name │ │ │ │ -0001eab0: 7379 6e74 6178 2028 2a6e 6f74 6520 4669 syntax (*note Fi │ │ │ │ -0001eac0: 6c65 206e 616d 6520 7379 6e74 6178 3a3a le name syntax:: │ │ │ │ -0001ead0: 292c 2069 6620 6120 626c 6f63 6b6c 6973 ), if a blocklis │ │ │ │ -0001eae0: 740a 646f 6573 206e 6f74 2063 6f6e 7461 t.does not conta │ │ │ │ -0001eaf0: 696e 2061 2064 6576 6963 6520 6e61 6d65 in a device name │ │ │ │ -0001eb00: 2c20 7468 656e 2047 5255 4220 7573 6573 , then GRUB uses │ │ │ │ -0001eb10: 2047 5255 4227 7320 2272 6f6f 7420 6465 GRUB's "root de │ │ │ │ -0001eb20: 7669 6365 222e 2020 536f 0a27 2868 6430 vice". So.'(hd0 │ │ │ │ -0001eb30: 2c32 292b 3127 2069 7320 7468 6520 7361 ,2)+1' is the sa │ │ │ │ -0001eb40: 6d65 2061 7320 272b 3127 2077 6865 6e20 me as '+1' when │ │ │ │ -0001eb50: 7468 6520 726f 6f74 2064 6576 6963 6520 the root device │ │ │ │ -0001eb60: 6973 2027 2868 6430 2c32 2927 2e0a 0a1f is '(hd0,2)'.... │ │ │ │ -0001eb70: 0a46 696c 653a 2067 7275 622e 696e 666f .File: grub.info │ │ │ │ -0001eb80: 2c20 204e 6f64 653a 2049 6e74 6572 6661 , Node: Interfa │ │ │ │ -0001eb90: 6365 2c20 204e 6578 743a 2045 6e76 6972 ce, Next: Envir │ │ │ │ -0001eba0: 6f6e 6d65 6e74 2c20 2050 7265 763a 2046 onment, Prev: F │ │ │ │ -0001ebb0: 696c 6573 7973 7465 6d2c 2020 5570 3a20 ilesystem, Up: │ │ │ │ -0001ebc0: 546f 700a 0a31 3420 4752 5542 2773 2075 Top..14 GRUB's u │ │ │ │ -0001ebd0: 7365 7220 696e 7465 7266 6163 650a 2a2a ser interface.** │ │ │ │ -0001ebe0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ -0001ebf0: 2a2a 2a2a 2a2a 0a0a 4752 5542 2068 6173 ******..GRUB has │ │ │ │ -0001ec00: 2062 6f74 6820 6120 7369 6d70 6c65 206d both a simple m │ │ │ │ -0001ec10: 656e 7520 696e 7465 7266 6163 6520 666f enu interface fo │ │ │ │ -0001ec20: 7220 6368 6f6f 7369 6e67 2070 7265 7365 r choosing prese │ │ │ │ -0001ec30: 7420 656e 7472 6965 7320 6672 6f6d 2061 t entries from a │ │ │ │ -0001ec40: 0a63 6f6e 6669 6775 7261 7469 6f6e 2066 .configuration f │ │ │ │ -0001ec50: 696c 652c 2061 6e64 2061 2068 6967 686c ile, and a highl │ │ │ │ -0001ec60: 7920 666c 6578 6962 6c65 2063 6f6d 6d61 y flexible comma │ │ │ │ -0001ec70: 6e64 2d6c 696e 6520 666f 7220 7065 7266 nd-line for perf │ │ │ │ -0001ec80: 6f72 6d69 6e67 0a61 6e79 2064 6573 6972 orming.any desir │ │ │ │ -0001ec90: 6564 2063 6f6d 6269 6e61 7469 6f6e 206f ed combination o │ │ │ │ -0001eca0: 6620 626f 6f74 2063 6f6d 6d61 6e64 732e f boot commands. │ │ │ │ -0001ecb0: 0a0a 2020 2047 5255 4220 6c6f 6f6b 7320 .. GRUB looks │ │ │ │ -0001ecc0: 666f 7220 6974 7320 636f 6e66 6967 7572 for its configur │ │ │ │ -0001ecd0: 6174 696f 6e20 6669 6c65 2061 7320 736f ation file as so │ │ │ │ -0001ece0: 6f6e 2061 7320 6974 2069 7320 6c6f 6164 on as it is load │ │ │ │ -0001ecf0: 6564 2e20 2049 660a 6f6e 6520 6973 2066 ed. If.one is f │ │ │ │ -0001ed00: 6f75 6e64 2c20 7468 656e 2074 6865 2066 ound, then the f │ │ │ │ -0001ed10: 756c 6c20 6d65 6e75 2069 6e74 6572 6661 ull menu interfa │ │ │ │ -0001ed20: 6365 2069 7320 6163 7469 7661 7465 6420 ce is activated │ │ │ │ -0001ed30: 7573 696e 6720 7768 6174 6576 6572 0a65 using whatever.e │ │ │ │ -0001ed40: 6e74 7269 6573 2077 6572 6520 666f 756e ntries were foun │ │ │ │ -0001ed50: 6420 696e 2074 6865 2066 696c 652e 2020 d in the file. │ │ │ │ -0001ed60: 4966 2079 6f75 2063 686f 6f73 6520 7468 If you choose th │ │ │ │ -0001ed70: 6520 2263 6f6d 6d61 6e64 2d6c 696e 6522 e "command-line" │ │ │ │ -0001ed80: 206d 656e 750a 6f70 7469 6f6e 2c20 6f72 menu.option, or │ │ │ │ -0001ed90: 2069 6620 7468 6520 636f 6e66 6967 7572 if the configur │ │ │ │ -0001eda0: 6174 696f 6e20 6669 6c65 2077 6173 206e ation file was n │ │ │ │ -0001edb0: 6f74 2066 6f75 6e64 2c20 7468 656e 2047 ot found, then G │ │ │ │ -0001edc0: 5255 4220 6472 6f70 7320 746f 0a74 6865 RUB drops to.the │ │ │ │ -0001edd0: 2063 6f6d 6d61 6e64 2d6c 696e 6520 696e command-line in │ │ │ │ -0001ede0: 7465 7266 6163 652e 0a0a 2a20 4d65 6e75 terface...* Menu │ │ │ │ -0001edf0: 3a0a 0a2a 2043 6f6d 6d61 6e64 2d6c 696e :..* Command-lin │ │ │ │ -0001ee00: 6520 696e 7465 7266 6163 653a 3a20 2020 e interface:: │ │ │ │ -0001ee10: 2020 2054 6865 2066 6c65 7869 626c 6520 The flexible │ │ │ │ -0001ee20: 636f 6d6d 616e 642d 6c69 6e65 2069 6e74 command-line int │ │ │ │ -0001ee30: 6572 6661 6365 0a2a 204d 656e 7520 696e erface.* Menu in │ │ │ │ -0001ee40: 7465 7266 6163 653a 3a20 2020 2020 2020 terface:: │ │ │ │ -0001ee50: 2020 2020 2020 2054 6865 2073 696d 706c The simpl │ │ │ │ -0001ee60: 6520 6d65 6e75 2069 6e74 6572 6661 6365 e menu interface │ │ │ │ -0001ee70: 0a2a 204d 656e 7520 656e 7472 7920 6564 .* Menu entry ed │ │ │ │ -0001ee80: 6974 6f72 3a3a 2020 2020 2020 2020 2020 itor:: │ │ │ │ -0001ee90: 2045 6469 7469 6e67 2061 206d 656e 7520 Editing a menu │ │ │ │ -0001eea0: 656e 7472 790a 0a1f 0a46 696c 653a 2067 entry....File: g │ │ │ │ -0001eeb0: 7275 622e 696e 666f 2c20 204e 6f64 653a rub.info, Node: │ │ │ │ -0001eec0: 2043 6f6d 6d61 6e64 2d6c 696e 6520 696e Command-line in │ │ │ │ -0001eed0: 7465 7266 6163 652c 2020 4e65 7874 3a20 terface, Next: │ │ │ │ -0001eee0: 4d65 6e75 2069 6e74 6572 6661 6365 2c20 Menu interface, │ │ │ │ -0001eef0: 2055 703a 2049 6e74 6572 6661 6365 0a0a Up: Interface.. │ │ │ │ -0001ef00: 3134 2e31 2054 6865 2066 6c65 7869 626c 14.1 The flexibl │ │ │ │ -0001ef10: 6520 636f 6d6d 616e 642d 6c69 6e65 2069 e command-line i │ │ │ │ -0001ef20: 6e74 6572 6661 6365 0a3d 3d3d 3d3d 3d3d nterface.======= │ │ │ │ +0001e920: 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a41 2062 ===========..A b │ │ │ │ +0001e930: 6c6f 636b 206c 6973 7420 6973 2075 7365 lock list is use │ │ │ │ +0001e940: 6420 666f 7220 7370 6563 6966 7969 6e67 d for specifying │ │ │ │ +0001e950: 2061 2066 696c 6520 7468 6174 2064 6f65 a file that doe │ │ │ │ +0001e960: 736e 2774 2061 7070 6561 7220 696e 2074 sn't appear in t │ │ │ │ +0001e970: 6865 0a66 696c 6573 7973 7465 6d2c 206c he.filesystem, l │ │ │ │ +0001e980: 696b 6520 6120 6368 6169 6e6c 6f61 6465 ike a chainloade │ │ │ │ +0001e990: 722e 2020 5468 6520 7379 6e74 6178 2069 r. The syntax i │ │ │ │ +0001e9a0: 730a 275b 4f46 4653 4554 5d2b 4c45 4e47 s.'[OFFSET]+LENG │ │ │ │ +0001e9b0: 5448 5b2c 5b4f 4646 5345 545d 2b4c 454e TH[,[OFFSET]+LEN │ │ │ │ +0001e9c0: 4754 485d 2e2e 2e27 2e20 2048 6572 6520 GTH]...'. Here │ │ │ │ +0001e9d0: 6973 2061 6e20 6578 616d 706c 653a 0a0a is an example:.. │ │ │ │ +0001e9e0: 2020 2020 2030 2b31 3030 2c32 3030 2b31 0+100,200+1 │ │ │ │ +0001e9f0: 2c33 3030 2b33 3030 0a0a 2020 2054 6869 ,300+300.. Thi │ │ │ │ +0001ea00: 7320 7265 7072 6573 656e 7473 2074 6861 s represents tha │ │ │ │ +0001ea10: 7420 4752 5542 2073 686f 756c 6420 7265 t GRUB should re │ │ │ │ +0001ea20: 6164 2062 6c6f 636b 7320 3020 7468 726f ad blocks 0 thro │ │ │ │ +0001ea30: 7567 6820 3939 2c20 626c 6f63 6b20 3230 ugh 99, block 20 │ │ │ │ +0001ea40: 302c 0a61 6e64 2062 6c6f 636b 7320 3330 0,.and blocks 30 │ │ │ │ +0001ea50: 3020 7468 726f 7567 6820 3539 392e 2020 0 through 599. │ │ │ │ +0001ea60: 4966 2079 6f75 206f 6d69 7420 616e 206f If you omit an o │ │ │ │ +0001ea70: 6666 7365 742c 2074 6865 6e20 4752 5542 ffset, then GRUB │ │ │ │ +0001ea80: 2061 7373 756d 6573 0a74 6865 206f 6666 assumes.the off │ │ │ │ +0001ea90: 7365 7420 6973 207a 6572 6f2e 0a0a 2020 set is zero... │ │ │ │ +0001eaa0: 204c 696b 6520 7468 6520 6669 6c65 206e Like the file n │ │ │ │ +0001eab0: 616d 6520 7379 6e74 6178 2028 2a6e 6f74 ame syntax (*not │ │ │ │ +0001eac0: 6520 4669 6c65 206e 616d 6520 7379 6e74 e File name synt │ │ │ │ +0001ead0: 6178 3a3a 292c 2069 6620 6120 626c 6f63 ax::), if a bloc │ │ │ │ +0001eae0: 6b6c 6973 740a 646f 6573 206e 6f74 2063 klist.does not c │ │ │ │ +0001eaf0: 6f6e 7461 696e 2061 2064 6576 6963 6520 ontain a device │ │ │ │ +0001eb00: 6e61 6d65 2c20 7468 656e 2047 5255 4220 name, then GRUB │ │ │ │ +0001eb10: 7573 6573 2047 5255 4227 7320 2272 6f6f uses GRUB's "roo │ │ │ │ +0001eb20: 7420 6465 7669 6365 222e 2020 536f 0a27 t device". So.' │ │ │ │ +0001eb30: 2868 6430 2c32 292b 3127 2069 7320 7468 (hd0,2)+1' is th │ │ │ │ +0001eb40: 6520 7361 6d65 2061 7320 272b 3127 2077 e same as '+1' w │ │ │ │ +0001eb50: 6865 6e20 7468 6520 726f 6f74 2064 6576 hen the root dev │ │ │ │ +0001eb60: 6963 6520 6973 2027 2868 6430 2c32 2927 ice is '(hd0,2)' │ │ │ │ +0001eb70: 2e0a 0a1f 0a46 696c 653a 2067 7275 622e .....File: grub. │ │ │ │ +0001eb80: 696e 666f 2c20 204e 6f64 653a 2049 6e74 info, Node: Int │ │ │ │ +0001eb90: 6572 6661 6365 2c20 204e 6578 743a 2045 erface, Next: E │ │ │ │ +0001eba0: 6e76 6972 6f6e 6d65 6e74 2c20 2050 7265 nvironment, Pre │ │ │ │ +0001ebb0: 763a 2046 696c 6573 7973 7465 6d2c 2020 v: Filesystem, │ │ │ │ +0001ebc0: 5570 3a20 546f 700a 0a31 3420 4752 5542 Up: Top..14 GRUB │ │ │ │ +0001ebd0: 2773 2075 7365 7220 696e 7465 7266 6163 's user interfac │ │ │ │ +0001ebe0: 650a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a e.************** │ │ │ │ +0001ebf0: 2a2a 2a2a 2a2a 2a2a 2a2a 0a0a 4752 5542 **********..GRUB │ │ │ │ +0001ec00: 2068 6173 2062 6f74 6820 6120 7369 6d70 has both a simp │ │ │ │ +0001ec10: 6c65 206d 656e 7520 696e 7465 7266 6163 le menu interfac │ │ │ │ +0001ec20: 6520 666f 7220 6368 6f6f 7369 6e67 2070 e for choosing p │ │ │ │ +0001ec30: 7265 7365 7420 656e 7472 6965 7320 6672 reset entries fr │ │ │ │ +0001ec40: 6f6d 2061 0a63 6f6e 6669 6775 7261 7469 om a.configurati │ │ │ │ +0001ec50: 6f6e 2066 696c 652c 2061 6e64 2061 2068 on file, and a h │ │ │ │ +0001ec60: 6967 686c 7920 666c 6578 6962 6c65 2063 ighly flexible c │ │ │ │ +0001ec70: 6f6d 6d61 6e64 2d6c 696e 6520 666f 7220 ommand-line for │ │ │ │ +0001ec80: 7065 7266 6f72 6d69 6e67 0a61 6e79 2064 performing.any d │ │ │ │ +0001ec90: 6573 6972 6564 2063 6f6d 6269 6e61 7469 esired combinati │ │ │ │ +0001eca0: 6f6e 206f 6620 626f 6f74 2063 6f6d 6d61 on of boot comma │ │ │ │ +0001ecb0: 6e64 732e 0a0a 2020 2047 5255 4220 6c6f nds... GRUB lo │ │ │ │ +0001ecc0: 6f6b 7320 666f 7220 6974 7320 636f 6e66 oks for its conf │ │ │ │ +0001ecd0: 6967 7572 6174 696f 6e20 6669 6c65 2061 iguration file a │ │ │ │ +0001ece0: 7320 736f 6f6e 2061 7320 6974 2069 7320 s soon as it is │ │ │ │ +0001ecf0: 6c6f 6164 6564 2e20 2049 660a 6f6e 6520 loaded. If.one │ │ │ │ +0001ed00: 6973 2066 6f75 6e64 2c20 7468 656e 2074 is found, then t │ │ │ │ +0001ed10: 6865 2066 756c 6c20 6d65 6e75 2069 6e74 he full menu int │ │ │ │ +0001ed20: 6572 6661 6365 2069 7320 6163 7469 7661 erface is activa │ │ │ │ +0001ed30: 7465 6420 7573 696e 6720 7768 6174 6576 ted using whatev │ │ │ │ +0001ed40: 6572 0a65 6e74 7269 6573 2077 6572 6520 er.entries were │ │ │ │ +0001ed50: 666f 756e 6420 696e 2074 6865 2066 696c found in the fil │ │ │ │ +0001ed60: 652e 2020 4966 2079 6f75 2063 686f 6f73 e. If you choos │ │ │ │ +0001ed70: 6520 7468 6520 2263 6f6d 6d61 6e64 2d6c e the "command-l │ │ │ │ +0001ed80: 696e 6522 206d 656e 750a 6f70 7469 6f6e ine" menu.option │ │ │ │ +0001ed90: 2c20 6f72 2069 6620 7468 6520 636f 6e66 , or if the conf │ │ │ │ +0001eda0: 6967 7572 6174 696f 6e20 6669 6c65 2077 iguration file w │ │ │ │ +0001edb0: 6173 206e 6f74 2066 6f75 6e64 2c20 7468 as not found, th │ │ │ │ +0001edc0: 656e 2047 5255 4220 6472 6f70 7320 746f en GRUB drops to │ │ │ │ +0001edd0: 0a74 6865 2063 6f6d 6d61 6e64 2d6c 696e .the command-lin │ │ │ │ +0001ede0: 6520 696e 7465 7266 6163 652e 0a0a 2a20 e interface...* │ │ │ │ +0001edf0: 4d65 6e75 3a0a 0a2a 2043 6f6d 6d61 6e64 Menu:..* Command │ │ │ │ +0001ee00: 2d6c 696e 6520 696e 7465 7266 6163 653a -line interface: │ │ │ │ +0001ee10: 3a20 2020 2020 2054 6865 2066 6c65 7869 : The flexi │ │ │ │ +0001ee20: 626c 6520 636f 6d6d 616e 642d 6c69 6e65 ble command-line │ │ │ │ +0001ee30: 2069 6e74 6572 6661 6365 0a2a 204d 656e interface.* Men │ │ │ │ +0001ee40: 7520 696e 7465 7266 6163 653a 3a20 2020 u interface:: │ │ │ │ +0001ee50: 2020 2020 2020 2020 2020 2054 6865 2073 The s │ │ │ │ +0001ee60: 696d 706c 6520 6d65 6e75 2069 6e74 6572 imple menu inter │ │ │ │ +0001ee70: 6661 6365 0a2a 204d 656e 7520 656e 7472 face.* Menu entr │ │ │ │ +0001ee80: 7920 6564 6974 6f72 3a3a 2020 2020 2020 y editor:: │ │ │ │ +0001ee90: 2020 2020 2045 6469 7469 6e67 2061 206d Editing a m │ │ │ │ +0001eea0: 656e 7520 656e 7472 790a 0a1f 0a46 696c enu entry....Fil │ │ │ │ +0001eeb0: 653a 2067 7275 622e 696e 666f 2c20 204e e: grub.info, N │ │ │ │ +0001eec0: 6f64 653a 2043 6f6d 6d61 6e64 2d6c 696e ode: Command-lin │ │ │ │ +0001eed0: 6520 696e 7465 7266 6163 652c 2020 4e65 e interface, Ne │ │ │ │ +0001eee0: 7874 3a20 4d65 6e75 2069 6e74 6572 6661 xt: Menu interfa │ │ │ │ +0001eef0: 6365 2c20 2055 703a 2049 6e74 6572 6661 ce, Up: Interfa │ │ │ │ +0001ef00: 6365 0a0a 3134 2e31 2054 6865 2066 6c65 ce..14.1 The fle │ │ │ │ +0001ef10: 7869 626c 6520 636f 6d6d 616e 642d 6c69 xible command-li │ │ │ │ +0001ef20: 6e65 2069 6e74 6572 6661 6365 0a3d 3d3d ne interface.=== │ │ │ │ 0001ef30: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ 0001ef40: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ -0001ef50: 3d0a 0a54 6865 2063 6f6d 6d61 6e64 2d6c =..The command-l │ │ │ │ -0001ef60: 696e 6520 696e 7465 7266 6163 6520 7072 ine interface pr │ │ │ │ -0001ef70: 6f76 6964 6573 2061 2070 726f 6d70 7420 ovides a prompt │ │ │ │ -0001ef80: 616e 6420 6166 7465 7220 6974 2061 6e20 and after it an │ │ │ │ -0001ef90: 6564 6974 6162 6c65 0a74 6578 7420 6172 editable.text ar │ │ │ │ -0001efa0: 6561 206d 7563 6820 6c69 6b65 2061 2063 ea much like a c │ │ │ │ -0001efb0: 6f6d 6d61 6e64 2d6c 696e 6520 696e 2055 ommand-line in U │ │ │ │ -0001efc0: 6e69 7820 6f72 2044 4f53 2e20 4561 6368 nix or DOS. Each │ │ │ │ -0001efd0: 2063 6f6d 6d61 6e64 2069 730a 696d 6d65 command is.imme │ │ │ │ -0001efe0: 6469 6174 656c 7920 6578 6563 7574 6564 diately executed │ │ │ │ -0001eff0: 2061 6674 6572 2069 7420 6973 2065 6e74 after it is ent │ │ │ │ -0001f000: 6572 6564 2831 2920 282a 6e6f 7465 2043 ered(1) (*note C │ │ │ │ -0001f010: 6f6d 6d61 6e64 2d6c 696e 650a 696e 7465 ommand-line.inte │ │ │ │ -0001f020: 7266 6163 652d 466f 6f74 6e6f 7465 2d31 rface-Footnote-1 │ │ │ │ -0001f030: 3a3a 292e 2020 5468 6520 636f 6d6d 616e ::). The comman │ │ │ │ -0001f040: 6473 2028 2a6e 6f74 6520 436f 6d6d 616e ds (*note Comman │ │ │ │ -0001f050: 642d 6c69 6e65 2061 6e64 206d 656e 750a d-line and menu. │ │ │ │ -0001f060: 656e 7472 7920 636f 6d6d 616e 6473 3a3a entry commands:: │ │ │ │ -0001f070: 2920 6172 6520 6120 7375 6273 6574 206f ) are a subset o │ │ │ │ -0001f080: 6620 7468 6f73 6520 6176 6169 6c61 626c f those availabl │ │ │ │ -0001f090: 6520 696e 2074 6865 2063 6f6e 6669 6775 e in the configu │ │ │ │ -0001f0a0: 7261 7469 6f6e 0a66 696c 652c 2075 7365 ration.file, use │ │ │ │ -0001f0b0: 6420 7769 7468 2065 7861 6374 6c79 2074 d with exactly t │ │ │ │ -0001f0c0: 6865 2073 616d 6520 7379 6e74 6178 2e0a he same syntax.. │ │ │ │ -0001f0d0: 0a20 2020 4375 7273 6f72 206d 6f76 656d . Cursor movem │ │ │ │ -0001f0e0: 656e 7420 616e 6420 6564 6974 696e 6720 ent and editing │ │ │ │ -0001f0f0: 6f66 2074 6865 2074 6578 7420 6f6e 2074 of the text on t │ │ │ │ -0001f100: 6865 206c 696e 6520 6361 6e20 6265 2064 he line can be d │ │ │ │ -0001f110: 6f6e 6520 7669 6120 610a 7375 6273 6574 one via a.subset │ │ │ │ -0001f120: 206f 6620 7468 6520 6675 6e63 7469 6f6e of the function │ │ │ │ -0001f130: 7320 6176 6169 6c61 626c 6520 696e 2074 s available in t │ │ │ │ -0001f140: 6865 2042 6173 6820 7368 656c 6c3a 0a0a he Bash shell:.. │ │ │ │ -0001f150: 3c43 2d66 3e0a 3c50 4320 7269 6768 7420 .. Move f │ │ │ │ -0001f170: 6f72 7761 7264 206f 6e65 2063 6861 7261 orward one chara │ │ │ │ -0001f180: 6374 6572 2e0a 0a3c 432d 623e 0a3c 5043 cter..... │ │ │ │ -0001f1a0: 4d6f 7665 2062 6163 6b20 6f6e 6520 6368 Move back one ch │ │ │ │ -0001f1b0: 6172 6163 7465 722e 0a0a 3c43 2d61 3e0a aracter.... │ │ │ │ -0001f1c0: 3c48 4f4d 453e 0a20 2020 2020 4d6f 7665 . Move │ │ │ │ -0001f1d0: 2074 6f20 7468 6520 7374 6172 7420 6f66 to the start of │ │ │ │ -0001f1e0: 2074 6865 206c 696e 652e 0a0a 3c43 2d65 the line..... Mov │ │ │ │ -0001f200: 6520 7468 6520 7468 6520 656e 6420 6f66 e the the end of │ │ │ │ -0001f210: 2074 6865 206c 696e 652e 0a0a 3c43 2d64 the line..... Del │ │ │ │ -0001f230: 6574 6520 7468 6520 6368 6172 6163 7465 ete the characte │ │ │ │ -0001f240: 7220 756e 6465 726e 6561 7468 2074 6865 r underneath the │ │ │ │ -0001f250: 2063 7572 736f 722e 0a0a 3c43 2d68 3e0a cursor.... │ │ │ │ -0001f260: 3c42 533e 0a20 2020 2020 4465 6c65 7465 . Delete │ │ │ │ -0001f270: 2074 6865 2063 6861 7261 6374 6572 2074 the character t │ │ │ │ -0001f280: 6f20 7468 6520 6c65 6674 206f 6620 7468 o the left of th │ │ │ │ -0001f290: 6520 6375 7273 6f72 2e0a 0a3c 432d 6b3e e cursor... │ │ │ │ -0001f2a0: 0a20 2020 2020 4b69 6c6c 2074 6865 2074 . Kill the t │ │ │ │ -0001f2b0: 6578 7420 6672 6f6d 2074 6865 2063 7572 ext from the cur │ │ │ │ -0001f2c0: 7265 6e74 2063 7572 736f 7220 706f 7369 rent cursor posi │ │ │ │ -0001f2d0: 7469 6f6e 2074 6f20 7468 6520 656e 6420 tion to the end │ │ │ │ -0001f2e0: 6f66 2074 6865 0a20 2020 2020 6c69 6e65 of the. line │ │ │ │ -0001f2f0: 2e0a 0a3c 432d 753e 0a20 2020 2020 4b69 .... Ki │ │ │ │ -0001f300: 6c6c 2062 6163 6b77 6172 6420 6672 6f6d ll backward from │ │ │ │ -0001f310: 2074 6865 2063 7572 736f 7220 746f 2074 the cursor to t │ │ │ │ -0001f320: 6865 2062 6567 696e 6e69 6e67 206f 6620 he beginning of │ │ │ │ -0001f330: 7468 6520 6c69 6e65 2e0a 0a3c 432d 793e the line... │ │ │ │ -0001f340: 0a20 2020 2020 5961 6e6b 2074 6865 206b . Yank the k │ │ │ │ -0001f350: 696c 6c65 6420 7465 7874 2062 6163 6b20 illed text back │ │ │ │ -0001f360: 696e 746f 2074 6865 2062 7566 6665 7220 into the buffer │ │ │ │ -0001f370: 6174 2074 6865 2063 7572 736f 722e 0a0a at the cursor... │ │ │ │ -0001f380: 3c43 2d70 3e0a 3c50 4320 7570 206b 6579 .. Move up t │ │ │ │ -0001f3a0: 6872 6f75 6768 2074 6865 2068 6973 746f hrough the histo │ │ │ │ -0001f3b0: 7279 206c 6973 742e 0a0a 3c43 2d6e 3e0a ry list.... │ │ │ │ -0001f3c0: 3c50 4320 646f 776e 206b 6579 3e0a 2020 . │ │ │ │ -0001f3d0: 2020 204d 6f76 6520 646f 776e 2074 6872 Move down thr │ │ │ │ -0001f3e0: 6f75 6768 2074 6865 2068 6973 746f 7279 ough the history │ │ │ │ -0001f3f0: 206c 6973 742e 0a0a 2020 2057 6865 6e20 list... When │ │ │ │ -0001f400: 7479 7069 6e67 2063 6f6d 6d61 6e64 7320 typing commands │ │ │ │ -0001f410: 696e 7465 7261 6374 6976 656c 792c 2069 interactively, i │ │ │ │ -0001f420: 6620 7468 6520 6375 7273 6f72 2069 7320 f the cursor is │ │ │ │ -0001f430: 7769 7468 696e 206f 7220 6265 666f 7265 within or before │ │ │ │ -0001f440: 0a74 6865 2066 6972 7374 2077 6f72 6420 .the first word │ │ │ │ -0001f450: 696e 2074 6865 2063 6f6d 6d61 6e64 2d6c in the command-l │ │ │ │ -0001f460: 696e 652c 2070 7265 7373 696e 6720 7468 ine, pressing th │ │ │ │ -0001f470: 6520 3c54 4142 3e20 6b65 7920 286f 7220 e key (or │ │ │ │ -0001f480: 3c43 2d69 3e29 0a77 696c 6c20 6469 7370 ).will disp │ │ │ │ -0001f490: 6c61 7920 6120 6c69 7374 696e 6720 6f66 lay a listing of │ │ │ │ -0001f4a0: 2074 6865 2061 7661 696c 6162 6c65 2063 the available c │ │ │ │ -0001f4b0: 6f6d 6d61 6e64 732c 2061 6e64 2069 6620 ommands, and if │ │ │ │ -0001f4c0: 7468 6520 6375 7273 6f72 2069 730a 6166 the cursor is.af │ │ │ │ -0001f4d0: 7465 7220 7468 6520 6669 7273 7420 776f ter the first wo │ │ │ │ -0001f4e0: 7264 2c20 7468 6520 273c 5441 423e 2720 rd, the '' │ │ │ │ -0001f4f0: 7769 6c6c 2070 726f 7669 6465 2061 2063 will provide a c │ │ │ │ -0001f500: 6f6d 706c 6574 696f 6e20 6c69 7374 696e ompletion listin │ │ │ │ -0001f510: 6720 6f66 0a64 6973 6b73 2c20 7061 7274 g of.disks, part │ │ │ │ -0001f520: 6974 696f 6e73 2c20 616e 6420 6669 6c65 itions, and file │ │ │ │ -0001f530: 206e 616d 6573 2064 6570 656e 6469 6e67 names depending │ │ │ │ -0001f540: 206f 6e20 7468 6520 636f 6e74 6578 742e on the context. │ │ │ │ -0001f550: 2020 4e6f 7465 2074 6861 740a 746f 206f Note that.to o │ │ │ │ -0001f560: 6274 6169 6e20 6120 6c69 7374 206f 6620 btain a list of │ │ │ │ -0001f570: 6472 6976 6573 2c20 6f6e 6520 6d75 7374 drives, one must │ │ │ │ -0001f580: 206f 7065 6e20 6120 7061 7265 6e74 6865 open a parenthe │ │ │ │ -0001f590: 7369 732c 2061 7320 2772 6f6f 7420 2827 sis, as 'root (' │ │ │ │ -0001f5a0: 2e0a 0a20 2020 4e6f 7465 2074 6861 7420 ... Note that │ │ │ │ -0001f5b0: 796f 7520 6361 6e6e 6f74 2075 7365 2074 you cannot use t │ │ │ │ -0001f5c0: 6865 2063 6f6d 706c 6574 696f 6e20 6675 he completion fu │ │ │ │ -0001f5d0: 6e63 7469 6f6e 616c 6974 7920 696e 2074 nctionality in t │ │ │ │ -0001f5e0: 6865 2054 4654 500a 6669 6c65 7379 7374 he TFTP.filesyst │ │ │ │ -0001f5f0: 656d 2e20 2054 6869 7320 6973 2062 6563 em. This is bec │ │ │ │ -0001f600: 6175 7365 2054 4654 5020 646f 6573 6e27 ause TFTP doesn' │ │ │ │ -0001f610: 7420 7375 7070 6f72 7420 6669 6c65 206e t support file n │ │ │ │ -0001f620: 616d 6520 6c69 7374 696e 6720 666f 720a ame listing for. │ │ │ │ -0001f630: 7468 6520 7365 6375 7269 7479 2e0a 0a1f the security.... │ │ │ │ -0001f640: 0a46 696c 653a 2067 7275 622e 696e 666f .File: grub.info │ │ │ │ -0001f650: 2c20 204e 6f64 653a 2043 6f6d 6d61 6e64 , Node: Command │ │ │ │ -0001f660: 2d6c 696e 6520 696e 7465 7266 6163 652d -line interface- │ │ │ │ -0001f670: 466f 6f74 6e6f 7465 732c 2020 5570 3a20 Footnotes, Up: │ │ │ │ -0001f680: 436f 6d6d 616e 642d 6c69 6e65 2069 6e74 Command-line int │ │ │ │ -0001f690: 6572 6661 6365 0a0a 2020 2028 3129 2048 erface.. (1) H │ │ │ │ -0001f6a0: 6f77 6576 6572 2c20 7468 6973 2062 6568 owever, this beh │ │ │ │ -0001f6b0: 6176 696f 7220 7769 6c6c 2062 6520 6368 avior will be ch │ │ │ │ -0001f6c0: 616e 6765 6420 696e 2074 6865 2066 7574 anged in the fut │ │ │ │ -0001f6d0: 7572 6520 7665 7273 696f 6e2c 2069 6e0a ure version, in. │ │ │ │ -0001f6e0: 6120 7573 6572 2d69 6e76 6973 6962 6c65 a user-invisible │ │ │ │ -0001f6f0: 2077 6179 2e0a 0a1f 0a46 696c 653a 2067 way.....File: g │ │ │ │ -0001f700: 7275 622e 696e 666f 2c20 204e 6f64 653a rub.info, Node: │ │ │ │ -0001f710: 204d 656e 7520 696e 7465 7266 6163 652c Menu interface, │ │ │ │ -0001f720: 2020 4e65 7874 3a20 4d65 6e75 2065 6e74 Next: Menu ent │ │ │ │ -0001f730: 7279 2065 6469 746f 722c 2020 5072 6576 ry editor, Prev │ │ │ │ -0001f740: 3a20 436f 6d6d 616e 642d 6c69 6e65 2069 : Command-line i │ │ │ │ -0001f750: 6e74 6572 6661 6365 2c20 2055 703a 2049 nterface, Up: I │ │ │ │ -0001f760: 6e74 6572 6661 6365 0a0a 3134 2e32 2054 nterface..14.2 T │ │ │ │ -0001f770: 6865 2073 696d 706c 6520 6d65 6e75 2069 he simple menu i │ │ │ │ -0001f780: 6e74 6572 6661 6365 0a3d 3d3d 3d3d 3d3d nterface.======= │ │ │ │ +0001ef50: 3d3d 3d3d 3d0a 0a54 6865 2063 6f6d 6d61 =====..The comma │ │ │ │ +0001ef60: 6e64 2d6c 696e 6520 696e 7465 7266 6163 nd-line interfac │ │ │ │ +0001ef70: 6520 7072 6f76 6964 6573 2061 2070 726f e provides a pro │ │ │ │ +0001ef80: 6d70 7420 616e 6420 6166 7465 7220 6974 mpt and after it │ │ │ │ +0001ef90: 2061 6e20 6564 6974 6162 6c65 0a74 6578 an editable.tex │ │ │ │ +0001efa0: 7420 6172 6561 206d 7563 6820 6c69 6b65 t area much like │ │ │ │ +0001efb0: 2061 2063 6f6d 6d61 6e64 2d6c 696e 6520 a command-line │ │ │ │ +0001efc0: 696e 2055 6e69 7820 6f72 2044 4f53 2e20 in Unix or DOS. │ │ │ │ +0001efd0: 4561 6368 2063 6f6d 6d61 6e64 2069 730a Each command is. │ │ │ │ +0001efe0: 696d 6d65 6469 6174 656c 7920 6578 6563 immediately exec │ │ │ │ +0001eff0: 7574 6564 2061 6674 6572 2069 7420 6973 uted after it is │ │ │ │ +0001f000: 2065 6e74 6572 6564 2831 2920 282a 6e6f entered(1) (*no │ │ │ │ +0001f010: 7465 2043 6f6d 6d61 6e64 2d6c 696e 650a te Command-line. │ │ │ │ +0001f020: 696e 7465 7266 6163 652d 466f 6f74 6e6f interface-Footno │ │ │ │ +0001f030: 7465 2d31 3a3a 292e 2020 5468 6520 636f te-1::). The co │ │ │ │ +0001f040: 6d6d 616e 6473 2028 2a6e 6f74 6520 436f mmands (*note Co │ │ │ │ +0001f050: 6d6d 616e 642d 6c69 6e65 2061 6e64 206d mmand-line and m │ │ │ │ +0001f060: 656e 750a 656e 7472 7920 636f 6d6d 616e enu.entry comman │ │ │ │ +0001f070: 6473 3a3a 2920 6172 6520 6120 7375 6273 ds::) are a subs │ │ │ │ +0001f080: 6574 206f 6620 7468 6f73 6520 6176 6169 et of those avai │ │ │ │ +0001f090: 6c61 626c 6520 696e 2074 6865 2063 6f6e lable in the con │ │ │ │ +0001f0a0: 6669 6775 7261 7469 6f6e 0a66 696c 652c figuration.file, │ │ │ │ +0001f0b0: 2075 7365 6420 7769 7468 2065 7861 6374 used with exact │ │ │ │ +0001f0c0: 6c79 2074 6865 2073 616d 6520 7379 6e74 ly the same synt │ │ │ │ +0001f0d0: 6178 2e0a 0a20 2020 4375 7273 6f72 206d ax... Cursor m │ │ │ │ +0001f0e0: 6f76 656d 656e 7420 616e 6420 6564 6974 ovement and edit │ │ │ │ +0001f0f0: 696e 6720 6f66 2074 6865 2074 6578 7420 ing of the text │ │ │ │ +0001f100: 6f6e 2074 6865 206c 696e 6520 6361 6e20 on the line can │ │ │ │ +0001f110: 6265 2064 6f6e 6520 7669 6120 610a 7375 be done via a.su │ │ │ │ +0001f120: 6273 6574 206f 6620 7468 6520 6675 6e63 bset of the func │ │ │ │ +0001f130: 7469 6f6e 7320 6176 6169 6c61 626c 6520 tions available │ │ │ │ +0001f140: 696e 2074 6865 2042 6173 6820 7368 656c in the Bash shel │ │ │ │ +0001f150: 6c3a 0a0a 3c43 2d66 3e0a 3c50 4320 7269 l:.... Mo │ │ │ │ +0001f170: 7665 2066 6f72 7761 7264 206f 6e65 2063 ve forward one c │ │ │ │ +0001f180: 6861 7261 6374 6572 2e0a 0a3c 432d 623e haracter... │ │ │ │ +0001f190: 0a3c 5043 206c 6566 7420 6b65 793e 0a20 .. │ │ │ │ +0001f1a0: 2020 2020 4d6f 7665 2062 6163 6b20 6f6e Move back on │ │ │ │ +0001f1b0: 6520 6368 6172 6163 7465 722e 0a0a 3c43 e character..... │ │ │ │ +0001f1d0: 4d6f 7665 2074 6f20 7468 6520 7374 6172 Move to the star │ │ │ │ +0001f1e0: 7420 6f66 2074 6865 206c 696e 652e 0a0a t of the line... │ │ │ │ +0001f1f0: 3c43 2d65 3e0a 3c45 4e44 3e0a 2020 2020 .. │ │ │ │ +0001f200: 204d 6f76 6520 7468 6520 7468 6520 656e Move the the en │ │ │ │ +0001f210: 6420 6f66 2074 6865 206c 696e 652e 0a0a d of the line... │ │ │ │ +0001f220: 3c43 2d64 3e0a 3c44 454c 3e0a 2020 2020 .. │ │ │ │ +0001f230: 2044 656c 6574 6520 7468 6520 6368 6172 Delete the char │ │ │ │ +0001f240: 6163 7465 7220 756e 6465 726e 6561 7468 acter underneath │ │ │ │ +0001f250: 2074 6865 2063 7572 736f 722e 0a0a 3c43 the cursor..... De │ │ │ │ +0001f270: 6c65 7465 2074 6865 2063 6861 7261 6374 lete the charact │ │ │ │ +0001f280: 6572 2074 6f20 7468 6520 6c65 6674 206f er to the left o │ │ │ │ +0001f290: 6620 7468 6520 6375 7273 6f72 2e0a 0a3c f the cursor...< │ │ │ │ +0001f2a0: 432d 6b3e 0a20 2020 2020 4b69 6c6c 2074 C-k>. Kill t │ │ │ │ +0001f2b0: 6865 2074 6578 7420 6672 6f6d 2074 6865 he text from the │ │ │ │ +0001f2c0: 2063 7572 7265 6e74 2063 7572 736f 7220 current cursor │ │ │ │ +0001f2d0: 706f 7369 7469 6f6e 2074 6f20 7468 6520 position to the │ │ │ │ +0001f2e0: 656e 6420 6f66 2074 6865 0a20 2020 2020 end of the. │ │ │ │ +0001f2f0: 6c69 6e65 2e0a 0a3c 432d 753e 0a20 2020 line.... │ │ │ │ +0001f300: 2020 4b69 6c6c 2062 6163 6b77 6172 6420 Kill backward │ │ │ │ +0001f310: 6672 6f6d 2074 6865 2063 7572 736f 7220 from the cursor │ │ │ │ +0001f320: 746f 2074 6865 2062 6567 696e 6e69 6e67 to the beginning │ │ │ │ +0001f330: 206f 6620 7468 6520 6c69 6e65 2e0a 0a3c of the line...< │ │ │ │ +0001f340: 432d 793e 0a20 2020 2020 5961 6e6b 2074 C-y>. Yank t │ │ │ │ +0001f350: 6865 206b 696c 6c65 6420 7465 7874 2062 he killed text b │ │ │ │ +0001f360: 6163 6b20 696e 746f 2074 6865 2062 7566 ack into the buf │ │ │ │ +0001f370: 6665 7220 6174 2074 6865 2063 7572 736f fer at the curso │ │ │ │ +0001f380: 722e 0a0a 3c43 2d70 3e0a 3c50 4320 7570 r..... Move │ │ │ │ +0001f3a0: 7570 2074 6872 6f75 6768 2074 6865 2068 up through the h │ │ │ │ +0001f3b0: 6973 746f 7279 206c 6973 742e 0a0a 3c43 istory list..... Move down │ │ │ │ +0001f3e0: 2074 6872 6f75 6768 2074 6865 2068 6973 through the his │ │ │ │ +0001f3f0: 746f 7279 206c 6973 742e 0a0a 2020 2057 tory list... W │ │ │ │ +0001f400: 6865 6e20 7479 7069 6e67 2063 6f6d 6d61 hen typing comma │ │ │ │ +0001f410: 6e64 7320 696e 7465 7261 6374 6976 656c nds interactivel │ │ │ │ +0001f420: 792c 2069 6620 7468 6520 6375 7273 6f72 y, if the cursor │ │ │ │ +0001f430: 2069 7320 7769 7468 696e 206f 7220 6265 is within or be │ │ │ │ +0001f440: 666f 7265 0a74 6865 2066 6972 7374 2077 fore.the first w │ │ │ │ +0001f450: 6f72 6420 696e 2074 6865 2063 6f6d 6d61 ord in the comma │ │ │ │ +0001f460: 6e64 2d6c 696e 652c 2070 7265 7373 696e nd-line, pressin │ │ │ │ +0001f470: 6720 7468 6520 3c54 4142 3e20 6b65 7920 g the key │ │ │ │ +0001f480: 286f 7220 3c43 2d69 3e29 0a77 696c 6c20 (or ).will │ │ │ │ +0001f490: 6469 7370 6c61 7920 6120 6c69 7374 696e display a listin │ │ │ │ +0001f4a0: 6720 6f66 2074 6865 2061 7661 696c 6162 g of the availab │ │ │ │ +0001f4b0: 6c65 2063 6f6d 6d61 6e64 732c 2061 6e64 le commands, and │ │ │ │ +0001f4c0: 2069 6620 7468 6520 6375 7273 6f72 2069 if the cursor i │ │ │ │ +0001f4d0: 730a 6166 7465 7220 7468 6520 6669 7273 s.after the firs │ │ │ │ +0001f4e0: 7420 776f 7264 2c20 7468 6520 273c 5441 t word, the '' will provide │ │ │ │ +0001f500: 2061 2063 6f6d 706c 6574 696f 6e20 6c69 a completion li │ │ │ │ +0001f510: 7374 696e 6720 6f66 0a64 6973 6b73 2c20 sting of.disks, │ │ │ │ +0001f520: 7061 7274 6974 696f 6e73 2c20 616e 6420 partitions, and │ │ │ │ +0001f530: 6669 6c65 206e 616d 6573 2064 6570 656e file names depen │ │ │ │ +0001f540: 6469 6e67 206f 6e20 7468 6520 636f 6e74 ding on the cont │ │ │ │ +0001f550: 6578 742e 2020 4e6f 7465 2074 6861 740a ext. Note that. │ │ │ │ +0001f560: 746f 206f 6274 6169 6e20 6120 6c69 7374 to obtain a list │ │ │ │ +0001f570: 206f 6620 6472 6976 6573 2c20 6f6e 6520 of drives, one │ │ │ │ +0001f580: 6d75 7374 206f 7065 6e20 6120 7061 7265 must open a pare │ │ │ │ +0001f590: 6e74 6865 7369 732c 2061 7320 2772 6f6f nthesis, as 'roo │ │ │ │ +0001f5a0: 7420 2827 2e0a 0a20 2020 4e6f 7465 2074 t ('... Note t │ │ │ │ +0001f5b0: 6861 7420 796f 7520 6361 6e6e 6f74 2075 hat you cannot u │ │ │ │ +0001f5c0: 7365 2074 6865 2063 6f6d 706c 6574 696f se the completio │ │ │ │ +0001f5d0: 6e20 6675 6e63 7469 6f6e 616c 6974 7920 n functionality │ │ │ │ +0001f5e0: 696e 2074 6865 2054 4654 500a 6669 6c65 in the TFTP.file │ │ │ │ +0001f5f0: 7379 7374 656d 2e20 2054 6869 7320 6973 system. This is │ │ │ │ +0001f600: 2062 6563 6175 7365 2054 4654 5020 646f because TFTP do │ │ │ │ +0001f610: 6573 6e27 7420 7375 7070 6f72 7420 6669 esn't support fi │ │ │ │ +0001f620: 6c65 206e 616d 6520 6c69 7374 696e 6720 le name listing │ │ │ │ +0001f630: 666f 720a 7468 6520 7365 6375 7269 7479 for.the security │ │ │ │ +0001f640: 2e0a 0a1f 0a46 696c 653a 2067 7275 622e .....File: grub. │ │ │ │ +0001f650: 696e 666f 2c20 204e 6f64 653a 2043 6f6d info, Node: Com │ │ │ │ +0001f660: 6d61 6e64 2d6c 696e 6520 696e 7465 7266 mand-line interf │ │ │ │ +0001f670: 6163 652d 466f 6f74 6e6f 7465 732c 2020 ace-Footnotes, │ │ │ │ +0001f680: 5570 3a20 436f 6d6d 616e 642d 6c69 6e65 Up: Command-line │ │ │ │ +0001f690: 2069 6e74 6572 6661 6365 0a0a 2020 2028 interface.. ( │ │ │ │ +0001f6a0: 3129 2048 6f77 6576 6572 2c20 7468 6973 1) However, this │ │ │ │ +0001f6b0: 2062 6568 6176 696f 7220 7769 6c6c 2062 behavior will b │ │ │ │ +0001f6c0: 6520 6368 616e 6765 6420 696e 2074 6865 e changed in the │ │ │ │ +0001f6d0: 2066 7574 7572 6520 7665 7273 696f 6e2c future version, │ │ │ │ +0001f6e0: 2069 6e0a 6120 7573 6572 2d69 6e76 6973 in.a user-invis │ │ │ │ +0001f6f0: 6962 6c65 2077 6179 2e0a 0a1f 0a46 696c ible way.....Fil │ │ │ │ +0001f700: 653a 2067 7275 622e 696e 666f 2c20 204e e: grub.info, N │ │ │ │ +0001f710: 6f64 653a 204d 656e 7520 696e 7465 7266 ode: Menu interf │ │ │ │ +0001f720: 6163 652c 2020 4e65 7874 3a20 4d65 6e75 ace, Next: Menu │ │ │ │ +0001f730: 2065 6e74 7279 2065 6469 746f 722c 2020 entry editor, │ │ │ │ +0001f740: 5072 6576 3a20 436f 6d6d 616e 642d 6c69 Prev: Command-li │ │ │ │ +0001f750: 6e65 2069 6e74 6572 6661 6365 2c20 2055 ne interface, U │ │ │ │ +0001f760: 703a 2049 6e74 6572 6661 6365 0a0a 3134 p: Interface..14 │ │ │ │ +0001f770: 2e32 2054 6865 2073 696d 706c 6520 6d65 .2 The simple me │ │ │ │ +0001f780: 6e75 2069 6e74 6572 6661 6365 0a3d 3d3d nu interface.=== │ │ │ │ 0001f790: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ -0001f7a0: 3d3d 3d3d 3d3d 3d0a 0a54 6865 206d 656e =======..The men │ │ │ │ -0001f7b0: 7520 696e 7465 7266 6163 6520 6973 2071 u interface is q │ │ │ │ -0001f7c0: 7569 7465 2065 6173 7920 746f 2075 7365 uite easy to use │ │ │ │ -0001f7d0: 2e20 2049 7473 2063 6f6d 6d61 6e64 7320 . Its commands │ │ │ │ -0001f7e0: 6172 6520 626f 7468 0a72 6561 736f 6e61 are both.reasona │ │ │ │ -0001f7f0: 626c 7920 696e 7475 6974 6976 6520 616e bly intuitive an │ │ │ │ -0001f800: 6420 6465 7363 7269 6265 6420 6f6e 2073 d described on s │ │ │ │ -0001f810: 6372 6565 6e2e 0a0a 2020 2042 6173 6963 creen... Basic │ │ │ │ -0001f820: 616c 6c79 2c20 7468 6520 6d65 6e75 2069 ally, the menu i │ │ │ │ -0001f830: 6e74 6572 6661 6365 2070 726f 7669 6465 nterface provide │ │ │ │ -0001f840: 7320 6120 6c69 7374 206f 6620 2262 6f6f s a list of "boo │ │ │ │ -0001f850: 7420 656e 7472 6965 7322 2074 6f0a 7468 t entries" to.th │ │ │ │ -0001f860: 6520 7573 6572 2074 6f20 6368 6f6f 7365 e user to choose │ │ │ │ -0001f870: 2066 726f 6d2e 2020 5573 6520 7468 6520 from. Use the │ │ │ │ -0001f880: 6172 726f 7720 6b65 7973 2074 6f20 7365 arrow keys to se │ │ │ │ -0001f890: 6c65 6374 2074 6865 2065 6e74 7279 206f lect the entry o │ │ │ │ -0001f8a0: 660a 6368 6f69 6365 2c20 7468 656e 2070 f.choice, then p │ │ │ │ -0001f8b0: 7265 7373 203c 5245 543e 2074 6f20 7275 ress to ru │ │ │ │ -0001f8c0: 6e20 6974 2e20 2041 6e20 6f70 7469 6f6e n it. An option │ │ │ │ -0001f8d0: 616c 2074 696d 656f 7574 2069 7320 6176 al timeout is av │ │ │ │ -0001f8e0: 6169 6c61 626c 6520 746f 0a62 6f6f 7420 ailable to.boot │ │ │ │ -0001f8f0: 7468 6520 6465 6661 756c 7420 656e 7472 the default entr │ │ │ │ -0001f900: 7920 2874 6865 2066 6972 7374 206f 6e65 y (the first one │ │ │ │ -0001f910: 2069 6620 6e6f 7420 7365 7429 2c20 7768 if not set), wh │ │ │ │ -0001f920: 6963 6820 6973 2061 626f 7274 6564 2062 ich is aborted b │ │ │ │ -0001f930: 790a 7072 6573 7369 6e67 2061 6e79 206b y.pressing any k │ │ │ │ -0001f940: 6579 2e0a 0a20 2020 436f 6d6d 616e 6473 ey... Commands │ │ │ │ -0001f950: 2061 7265 2061 7661 696c 6162 6c65 2074 are available t │ │ │ │ -0001f960: 6f20 656e 7465 7220 6120 6261 7265 2063 o enter a bare c │ │ │ │ -0001f970: 6f6d 6d61 6e64 2d6c 696e 6520 6279 2070 ommand-line by p │ │ │ │ -0001f980: 7265 7373 696e 6720 3c63 3e0a 2877 6869 ressing .(whi │ │ │ │ -0001f990: 6368 206f 7065 7261 7465 7320 6578 6163 ch operates exac │ │ │ │ -0001f9a0: 746c 7920 6c69 6b65 2074 6865 206e 6f6e tly like the non │ │ │ │ -0001f9b0: 2d63 6f6e 6669 672d 6669 6c65 2076 6572 -config-file ver │ │ │ │ -0001f9c0: 7369 6f6e 206f 6620 4752 5542 2c20 6275 sion of GRUB, bu │ │ │ │ -0001f9d0: 740a 616c 6c6f 7773 206f 6e65 2074 6f20 t.allows one to │ │ │ │ -0001f9e0: 7265 7475 726e 2074 6f20 7468 6520 6d65 return to the me │ │ │ │ -0001f9f0: 6e75 2069 6620 6465 7369 7265 6420 6279 nu if desired by │ │ │ │ -0001fa00: 2070 7265 7373 696e 6720 3c45 5343 3e29 pressing ) │ │ │ │ -0001fa10: 206f 7220 746f 0a65 6469 7420 616e 7920 or to.edit any │ │ │ │ -0001fa20: 6f66 2074 6865 2022 626f 6f74 2065 6e74 of the "boot ent │ │ │ │ -0001fa30: 7269 6573 2220 6279 2070 7265 7373 696e ries" by pressin │ │ │ │ -0001fa40: 6720 3c65 3e2e 0a0a 2020 2049 6620 796f g ... If yo │ │ │ │ -0001fa50: 7520 7072 6f74 6563 7420 7468 6520 6d65 u protect the me │ │ │ │ -0001fa60: 6e75 2069 6e74 6572 6661 6365 2077 6974 nu interface wit │ │ │ │ -0001fa70: 6820 6120 7061 7373 776f 7264 2028 2a6e h a password (*n │ │ │ │ -0001fa80: 6f74 6520 5365 6375 7269 7479 3a3a 292c ote Security::), │ │ │ │ -0001fa90: 0a61 6c6c 2079 6f75 2063 616e 2064 6f20 .all you can do │ │ │ │ -0001faa0: 6973 2063 686f 6f73 6520 616e 2065 6e74 is choose an ent │ │ │ │ -0001fab0: 7279 2062 7920 7072 6573 7369 6e67 203c ry by pressing < │ │ │ │ -0001fac0: 5245 543e 2c20 6f72 2070 7265 7373 203c RET>, or press < │ │ │ │ -0001fad0: 703e 2074 6f0a 656e 7465 7220 7468 6520 p> to.enter the │ │ │ │ -0001fae0: 7061 7373 776f 7264 2e0a 0a1f 0a46 696c password.....Fil │ │ │ │ -0001faf0: 653a 2067 7275 622e 696e 666f 2c20 204e e: grub.info, N │ │ │ │ -0001fb00: 6f64 653a 204d 656e 7520 656e 7472 7920 ode: Menu entry │ │ │ │ -0001fb10: 6564 6974 6f72 2c20 2050 7265 763a 204d editor, Prev: M │ │ │ │ -0001fb20: 656e 7520 696e 7465 7266 6163 652c 2020 enu interface, │ │ │ │ -0001fb30: 5570 3a20 496e 7465 7266 6163 650a 0a31 Up: Interface..1 │ │ │ │ -0001fb40: 342e 3320 4564 6974 696e 6720 6120 6d65 4.3 Editing a me │ │ │ │ -0001fb50: 6e75 2065 6e74 7279 0a3d 3d3d 3d3d 3d3d nu entry.======= │ │ │ │ +0001f7a0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a54 6865 ===========..The │ │ │ │ +0001f7b0: 206d 656e 7520 696e 7465 7266 6163 6520 menu interface │ │ │ │ +0001f7c0: 6973 2071 7569 7465 2065 6173 7920 746f is quite easy to │ │ │ │ +0001f7d0: 2075 7365 2e20 2049 7473 2063 6f6d 6d61 use. Its comma │ │ │ │ +0001f7e0: 6e64 7320 6172 6520 626f 7468 0a72 6561 nds are both.rea │ │ │ │ +0001f7f0: 736f 6e61 626c 7920 696e 7475 6974 6976 sonably intuitiv │ │ │ │ +0001f800: 6520 616e 6420 6465 7363 7269 6265 6420 e and described │ │ │ │ +0001f810: 6f6e 2073 6372 6565 6e2e 0a0a 2020 2042 on screen... B │ │ │ │ +0001f820: 6173 6963 616c 6c79 2c20 7468 6520 6d65 asically, the me │ │ │ │ +0001f830: 6e75 2069 6e74 6572 6661 6365 2070 726f nu interface pro │ │ │ │ +0001f840: 7669 6465 7320 6120 6c69 7374 206f 6620 vides a list of │ │ │ │ +0001f850: 2262 6f6f 7420 656e 7472 6965 7322 2074 "boot entries" t │ │ │ │ +0001f860: 6f0a 7468 6520 7573 6572 2074 6f20 6368 o.the user to ch │ │ │ │ +0001f870: 6f6f 7365 2066 726f 6d2e 2020 5573 6520 oose from. Use │ │ │ │ +0001f880: 7468 6520 6172 726f 7720 6b65 7973 2074 the arrow keys t │ │ │ │ +0001f890: 6f20 7365 6c65 6374 2074 6865 2065 6e74 o select the ent │ │ │ │ +0001f8a0: 7279 206f 660a 6368 6f69 6365 2c20 7468 ry of.choice, th │ │ │ │ +0001f8b0: 656e 2070 7265 7373 203c 5245 543e 2074 en press t │ │ │ │ +0001f8c0: 6f20 7275 6e20 6974 2e20 2041 6e20 6f70 o run it. An op │ │ │ │ +0001f8d0: 7469 6f6e 616c 2074 696d 656f 7574 2069 tional timeout i │ │ │ │ +0001f8e0: 7320 6176 6169 6c61 626c 6520 746f 0a62 s available to.b │ │ │ │ +0001f8f0: 6f6f 7420 7468 6520 6465 6661 756c 7420 oot the default │ │ │ │ +0001f900: 656e 7472 7920 2874 6865 2066 6972 7374 entry (the first │ │ │ │ +0001f910: 206f 6e65 2069 6620 6e6f 7420 7365 7429 one if not set) │ │ │ │ +0001f920: 2c20 7768 6963 6820 6973 2061 626f 7274 , which is abort │ │ │ │ +0001f930: 6564 2062 790a 7072 6573 7369 6e67 2061 ed by.pressing a │ │ │ │ +0001f940: 6e79 206b 6579 2e0a 0a20 2020 436f 6d6d ny key... Comm │ │ │ │ +0001f950: 616e 6473 2061 7265 2061 7661 696c 6162 ands are availab │ │ │ │ +0001f960: 6c65 2074 6f20 656e 7465 7220 6120 6261 le to enter a ba │ │ │ │ +0001f970: 7265 2063 6f6d 6d61 6e64 2d6c 696e 6520 re command-line │ │ │ │ +0001f980: 6279 2070 7265 7373 696e 6720 3c63 3e0a by pressing . │ │ │ │ +0001f990: 2877 6869 6368 206f 7065 7261 7465 7320 (which operates │ │ │ │ +0001f9a0: 6578 6163 746c 7920 6c69 6b65 2074 6865 exactly like the │ │ │ │ +0001f9b0: 206e 6f6e 2d63 6f6e 6669 672d 6669 6c65 non-config-file │ │ │ │ +0001f9c0: 2076 6572 7369 6f6e 206f 6620 4752 5542 version of GRUB │ │ │ │ +0001f9d0: 2c20 6275 740a 616c 6c6f 7773 206f 6e65 , but.allows one │ │ │ │ +0001f9e0: 2074 6f20 7265 7475 726e 2074 6f20 7468 to return to th │ │ │ │ +0001f9f0: 6520 6d65 6e75 2069 6620 6465 7369 7265 e menu if desire │ │ │ │ +0001fa00: 6420 6279 2070 7265 7373 696e 6720 3c45 d by pressing ) or to.edit │ │ │ │ +0001fa20: 616e 7920 6f66 2074 6865 2022 626f 6f74 any of the "boot │ │ │ │ +0001fa30: 2065 6e74 7269 6573 2220 6279 2070 7265 entries" by pre │ │ │ │ +0001fa40: 7373 696e 6720 3c65 3e2e 0a0a 2020 2049 ssing ... I │ │ │ │ +0001fa50: 6620 796f 7520 7072 6f74 6563 7420 7468 f you protect th │ │ │ │ +0001fa60: 6520 6d65 6e75 2069 6e74 6572 6661 6365 e menu interface │ │ │ │ +0001fa70: 2077 6974 6820 6120 7061 7373 776f 7264 with a password │ │ │ │ +0001fa80: 2028 2a6e 6f74 6520 5365 6375 7269 7479 (*note Security │ │ │ │ +0001fa90: 3a3a 292c 0a61 6c6c 2079 6f75 2063 616e ::),.all you can │ │ │ │ +0001faa0: 2064 6f20 6973 2063 686f 6f73 6520 616e do is choose an │ │ │ │ +0001fab0: 2065 6e74 7279 2062 7920 7072 6573 7369 entry by pressi │ │ │ │ +0001fac0: 6e67 203c 5245 543e 2c20 6f72 2070 7265 ng , or pre │ │ │ │ +0001fad0: 7373 203c 703e 2074 6f0a 656e 7465 7220 ss

to.enter │ │ │ │ +0001fae0: 7468 6520 7061 7373 776f 7264 2e0a 0a1f the password.... │ │ │ │ +0001faf0: 0a46 696c 653a 2067 7275 622e 696e 666f .File: grub.info │ │ │ │ +0001fb00: 2c20 204e 6f64 653a 204d 656e 7520 656e , Node: Menu en │ │ │ │ +0001fb10: 7472 7920 6564 6974 6f72 2c20 2050 7265 try editor, Pre │ │ │ │ +0001fb20: 763a 204d 656e 7520 696e 7465 7266 6163 v: Menu interfac │ │ │ │ +0001fb30: 652c 2020 5570 3a20 496e 7465 7266 6163 e, Up: Interfac │ │ │ │ +0001fb40: 650a 0a31 342e 3320 4564 6974 696e 6720 e..14.3 Editing │ │ │ │ +0001fb50: 6120 6d65 6e75 2065 6e74 7279 0a3d 3d3d a menu entry.=== │ │ │ │ 0001fb60: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ -0001fb70: 3d3d 0a0a 5468 6520 6d65 6e75 2065 6e74 ==..The menu ent │ │ │ │ -0001fb80: 7279 2065 6469 746f 7220 6c6f 6f6b 7320 ry editor looks │ │ │ │ -0001fb90: 6d75 6368 206c 696b 6520 7468 6520 6d61 much like the ma │ │ │ │ -0001fba0: 696e 206d 656e 7520 696e 7465 7266 6163 in menu interfac │ │ │ │ -0001fbb0: 652c 2062 7574 2074 6865 0a6c 696e 6573 e, but the.lines │ │ │ │ -0001fbc0: 2069 6e20 7468 6520 6d65 6e75 2061 7265 in the menu are │ │ │ │ -0001fbd0: 2069 6e64 6976 6964 7561 6c20 636f 6d6d individual comm │ │ │ │ -0001fbe0: 616e 6473 2069 6e20 7468 6520 7365 6c65 ands in the sele │ │ │ │ -0001fbf0: 6374 6564 2065 6e74 7279 2069 6e73 7465 cted entry inste │ │ │ │ -0001fc00: 6164 0a6f 6620 656e 7472 7920 6e61 6d65 ad.of entry name │ │ │ │ -0001fc10: 732e 0a0a 2020 2049 6620 616e 203c 4553 s... If an is pressed in │ │ │ │ -0001fc30: 2074 6865 2065 6469 746f 722c 2069 7420 the editor, it │ │ │ │ -0001fc40: 6162 6f72 7473 2061 6c6c 2074 6865 2063 aborts all the c │ │ │ │ -0001fc50: 6861 6e67 6573 206d 6164 650a 746f 2074 hanges made.to t │ │ │ │ -0001fc60: 6865 2063 6f6e 6669 6775 7261 7469 6f6e he configuration │ │ │ │ -0001fc70: 2065 6e74 7279 2061 6e64 2072 6574 7572 entry and retur │ │ │ │ -0001fc80: 6e73 2074 6f20 7468 6520 6d61 696e 206d ns to the main m │ │ │ │ -0001fc90: 656e 7520 696e 7465 7266 6163 652e 0a0a enu interface... │ │ │ │ -0001fca0: 2020 2045 6163 6820 6c69 6e65 2069 6e20 Each line in │ │ │ │ -0001fcb0: 7468 6520 6d65 6e75 2065 6e74 7279 2063 the menu entry c │ │ │ │ -0001fcc0: 616e 2062 6520 6564 6974 6564 2066 7265 an be edited fre │ │ │ │ -0001fcd0: 656c 792c 2061 6e64 2079 6f75 2063 616e ely, and you can │ │ │ │ -0001fce0: 2061 6464 206e 6577 0a6c 696e 6573 2062 add new.lines b │ │ │ │ -0001fcf0: 7920 7072 6573 7369 6e67 203c 5245 543e y pressing │ │ │ │ -0001fd00: 2061 7420 7468 6520 656e 6420 6f66 2061 at the end of a │ │ │ │ -0001fd10: 206c 696e 652e 2020 546f 2062 6f6f 7420 line. To boot │ │ │ │ -0001fd20: 7468 6520 6564 6974 6564 2065 6e74 7279 the edited entry │ │ │ │ -0001fd30: 2c0a 7072 6573 7320 3c43 7472 6c2d 783e ,.press │ │ │ │ -0001fd40: 2e0a 0a20 2020 416c 7468 6f75 6768 2047 ... Although G │ │ │ │ -0001fd50: 5255 4220 756e 666f 7274 756e 6174 656c RUB unfortunatel │ │ │ │ -0001fd60: 7920 646f 6573 206e 6f74 2073 7570 706f y does not suppo │ │ │ │ -0001fd70: 7274 2022 756e 646f 222c 2079 6f75 2063 rt "undo", you c │ │ │ │ -0001fd80: 616e 2064 6f0a 616c 6d6f 7374 2074 6865 an do.almost the │ │ │ │ -0001fd90: 2073 616d 6520 7468 696e 6720 6279 206a same thing by j │ │ │ │ -0001fda0: 7573 7420 7265 7475 726e 696e 6720 746f ust returning to │ │ │ │ -0001fdb0: 2074 6865 206d 6169 6e20 6d65 6e75 2075 the main menu u │ │ │ │ -0001fdc0: 7369 6e67 203c 4553 433e 2e0a 0a1f 0a46 sing .....F │ │ │ │ -0001fdd0: 696c 653a 2067 7275 622e 696e 666f 2c20 ile: grub.info, │ │ │ │ -0001fde0: 204e 6f64 653a 2045 6e76 6972 6f6e 6d65 Node: Environme │ │ │ │ -0001fdf0: 6e74 2c20 204e 6578 743a 2043 6f6d 6d61 nt, Next: Comma │ │ │ │ -0001fe00: 6e64 732c 2020 5072 6576 3a20 496e 7465 nds, Prev: Inte │ │ │ │ -0001fe10: 7266 6163 652c 2020 5570 3a20 546f 700a rface, Up: Top. │ │ │ │ -0001fe20: 0a31 3520 4752 5542 2065 6e76 6972 6f6e .15 GRUB environ │ │ │ │ -0001fe30: 6d65 6e74 2076 6172 6961 626c 6573 0a2a ment variables.* │ │ │ │ -0001fe40: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ -0001fe50: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 0a0a 4752 ************..GR │ │ │ │ -0001fe60: 5542 2073 7570 706f 7274 7320 656e 7669 UB supports envi │ │ │ │ -0001fe70: 726f 6e6d 656e 7420 7661 7269 6162 6c65 ronment variable │ │ │ │ -0001fe80: 7320 7768 6963 6820 6172 6520 7261 7468 s which are rath │ │ │ │ -0001fe90: 6572 206c 696b 6520 7468 6f73 6520 6f66 er like those of │ │ │ │ -0001fea0: 6665 7265 640a 6279 2061 6c6c 2055 6e69 fered.by all Uni │ │ │ │ -0001feb0: 782d 6c69 6b65 2073 7973 7465 6d73 2e20 x-like systems. │ │ │ │ -0001fec0: 2045 6e76 6972 6f6e 6d65 6e74 2076 6172 Environment var │ │ │ │ -0001fed0: 6961 626c 6573 2068 6176 6520 6120 6e61 iables have a na │ │ │ │ -0001fee0: 6d65 2c20 7768 6963 6820 6973 0a75 6e69 me, which is.uni │ │ │ │ -0001fef0: 7175 6520 616e 6420 6973 2075 7375 616c que and is usual │ │ │ │ -0001ff00: 6c79 2061 2073 686f 7274 2069 6465 6e74 ly a short ident │ │ │ │ -0001ff10: 6966 6965 722c 2061 6e64 2061 2076 616c ifier, and a val │ │ │ │ -0001ff20: 7565 2c20 7768 6963 6820 6973 2061 6e0a ue, which is an. │ │ │ │ -0001ff30: 6172 6269 7472 6172 7920 7374 7269 6e67 arbitrary string │ │ │ │ -0001ff40: 206f 6620 6368 6172 6163 7465 7273 2e20 of characters. │ │ │ │ -0001ff50: 2054 6865 7920 6d61 7920 6265 2073 6574 They may be set │ │ │ │ -0001ff60: 2028 2a6e 6f74 6520 7365 743a 3a29 2c20 (*note set::), │ │ │ │ -0001ff70: 756e 7365 740a 282a 6e6f 7465 2075 6e73 unset.(*note uns │ │ │ │ -0001ff80: 6574 3a3a 292c 206f 7220 6c6f 6f6b 6564 et::), or looked │ │ │ │ -0001ff90: 2075 7020 282a 6e6f 7465 2053 6865 6c6c up (*note Shell │ │ │ │ -0001ffa0: 2d6c 696b 6520 7363 7269 7074 696e 673a -like scripting: │ │ │ │ -0001ffb0: 3a29 2062 7920 6e61 6d65 2e0a 0a20 2020 :) by name... │ │ │ │ -0001ffc0: 4120 6e75 6d62 6572 206f 6620 656e 7669 A number of envi │ │ │ │ -0001ffd0: 726f 6e6d 656e 7420 7661 7269 6162 6c65 ronment variable │ │ │ │ -0001ffe0: 7320 6861 7665 2073 7065 6369 616c 206d s have special m │ │ │ │ -0001fff0: 6561 6e69 6e67 7320 746f 2076 6172 696f eanings to vario │ │ │ │ -00020000: 7573 0a70 6172 7473 206f 6620 4752 5542 us.parts of GRUB │ │ │ │ -00020010: 2e20 4f74 6865 7273 206d 6179 2062 6520 . Others may be │ │ │ │ -00020020: 7573 6564 2066 7265 656c 7920 696e 2047 used freely in G │ │ │ │ -00020030: 5255 4220 636f 6e66 6967 7572 6174 696f RUB configuratio │ │ │ │ -00020040: 6e20 6669 6c65 732e 0a0a 2a20 4d65 6e75 n files...* Menu │ │ │ │ -00020050: 3a0a 0a2a 2053 7065 6369 616c 2065 6e76 :..* Special env │ │ │ │ -00020060: 6972 6f6e 6d65 6e74 2076 6172 6961 626c ironment variabl │ │ │ │ -00020070: 6573 3a3a 0a2a 2045 6e76 6972 6f6e 6d65 es::.* Environme │ │ │ │ -00020080: 6e74 2062 6c6f 636b 3a3a 0a0a 1f0a 4669 nt block::....Fi │ │ │ │ -00020090: 6c65 3a20 6772 7562 2e69 6e66 6f2c 2020 le: grub.info, │ │ │ │ -000200a0: 4e6f 6465 3a20 5370 6563 6961 6c20 656e Node: Special en │ │ │ │ -000200b0: 7669 726f 6e6d 656e 7420 7661 7269 6162 vironment variab │ │ │ │ -000200c0: 6c65 732c 2020 4e65 7874 3a20 456e 7669 les, Next: Envi │ │ │ │ -000200d0: 726f 6e6d 656e 7420 626c 6f63 6b2c 2020 ronment block, │ │ │ │ -000200e0: 5570 3a20 456e 7669 726f 6e6d 656e 740a Up: Environment. │ │ │ │ -000200f0: 0a31 352e 3120 5370 6563 6961 6c20 656e .15.1 Special en │ │ │ │ -00020100: 7669 726f 6e6d 656e 7420 7661 7269 6162 vironment variab │ │ │ │ -00020110: 6c65 730a 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d les.============ │ │ │ │ +0001fb70: 3d3d 3d3d 3d3d 0a0a 5468 6520 6d65 6e75 ======..The menu │ │ │ │ +0001fb80: 2065 6e74 7279 2065 6469 746f 7220 6c6f entry editor lo │ │ │ │ +0001fb90: 6f6b 7320 6d75 6368 206c 696b 6520 7468 oks much like th │ │ │ │ +0001fba0: 6520 6d61 696e 206d 656e 7520 696e 7465 e main menu inte │ │ │ │ +0001fbb0: 7266 6163 652c 2062 7574 2074 6865 0a6c rface, but the.l │ │ │ │ +0001fbc0: 696e 6573 2069 6e20 7468 6520 6d65 6e75 ines in the menu │ │ │ │ +0001fbd0: 2061 7265 2069 6e64 6976 6964 7561 6c20 are individual │ │ │ │ +0001fbe0: 636f 6d6d 616e 6473 2069 6e20 7468 6520 commands in the │ │ │ │ +0001fbf0: 7365 6c65 6374 6564 2065 6e74 7279 2069 selected entry i │ │ │ │ +0001fc00: 6e73 7465 6164 0a6f 6620 656e 7472 7920 nstead.of entry │ │ │ │ +0001fc10: 6e61 6d65 732e 0a0a 2020 2049 6620 616e names... If an │ │ │ │ +0001fc20: 203c 4553 433e 2069 7320 7072 6573 7365 is presse │ │ │ │ +0001fc30: 6420 696e 2074 6865 2065 6469 746f 722c d in the editor, │ │ │ │ +0001fc40: 2069 7420 6162 6f72 7473 2061 6c6c 2074 it aborts all t │ │ │ │ +0001fc50: 6865 2063 6861 6e67 6573 206d 6164 650a he changes made. │ │ │ │ +0001fc60: 746f 2074 6865 2063 6f6e 6669 6775 7261 to the configura │ │ │ │ +0001fc70: 7469 6f6e 2065 6e74 7279 2061 6e64 2072 tion entry and r │ │ │ │ +0001fc80: 6574 7572 6e73 2074 6f20 7468 6520 6d61 eturns to the ma │ │ │ │ +0001fc90: 696e 206d 656e 7520 696e 7465 7266 6163 in menu interfac │ │ │ │ +0001fca0: 652e 0a0a 2020 2045 6163 6820 6c69 6e65 e... Each line │ │ │ │ +0001fcb0: 2069 6e20 7468 6520 6d65 6e75 2065 6e74 in the menu ent │ │ │ │ +0001fcc0: 7279 2063 616e 2062 6520 6564 6974 6564 ry can be edited │ │ │ │ +0001fcd0: 2066 7265 656c 792c 2061 6e64 2079 6f75 freely, and you │ │ │ │ +0001fce0: 2063 616e 2061 6464 206e 6577 0a6c 696e can add new.lin │ │ │ │ +0001fcf0: 6573 2062 7920 7072 6573 7369 6e67 203c es by pressing < │ │ │ │ +0001fd00: 5245 543e 2061 7420 7468 6520 656e 6420 RET> at the end │ │ │ │ +0001fd10: 6f66 2061 206c 696e 652e 2020 546f 2062 of a line. To b │ │ │ │ +0001fd20: 6f6f 7420 7468 6520 6564 6974 6564 2065 oot the edited e │ │ │ │ +0001fd30: 6e74 7279 2c0a 7072 6573 7320 3c43 7472 ntry,.press ... Althou │ │ │ │ +0001fd50: 6768 2047 5255 4220 756e 666f 7274 756e gh GRUB unfortun │ │ │ │ +0001fd60: 6174 656c 7920 646f 6573 206e 6f74 2073 ately does not s │ │ │ │ +0001fd70: 7570 706f 7274 2022 756e 646f 222c 2079 upport "undo", y │ │ │ │ +0001fd80: 6f75 2063 616e 2064 6f0a 616c 6d6f 7374 ou can do.almost │ │ │ │ +0001fd90: 2074 6865 2073 616d 6520 7468 696e 6720 the same thing │ │ │ │ +0001fda0: 6279 206a 7573 7420 7265 7475 726e 696e by just returnin │ │ │ │ +0001fdb0: 6720 746f 2074 6865 206d 6169 6e20 6d65 g to the main me │ │ │ │ +0001fdc0: 6e75 2075 7369 6e67 203c 4553 433e 2e0a nu using .. │ │ │ │ +0001fdd0: 0a1f 0a46 696c 653a 2067 7275 622e 696e ...File: grub.in │ │ │ │ +0001fde0: 666f 2c20 204e 6f64 653a 2045 6e76 6972 fo, Node: Envir │ │ │ │ +0001fdf0: 6f6e 6d65 6e74 2c20 204e 6578 743a 2043 onment, Next: C │ │ │ │ +0001fe00: 6f6d 6d61 6e64 732c 2020 5072 6576 3a20 ommands, Prev: │ │ │ │ +0001fe10: 496e 7465 7266 6163 652c 2020 5570 3a20 Interface, Up: │ │ │ │ +0001fe20: 546f 700a 0a31 3520 4752 5542 2065 6e76 Top..15 GRUB env │ │ │ │ +0001fe30: 6972 6f6e 6d65 6e74 2076 6172 6961 626c ironment variabl │ │ │ │ +0001fe40: 6573 0a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a es.************* │ │ │ │ +0001fe50: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ +0001fe60: 0a0a 4752 5542 2073 7570 706f 7274 7320 ..GRUB supports │ │ │ │ +0001fe70: 656e 7669 726f 6e6d 656e 7420 7661 7269 environment vari │ │ │ │ +0001fe80: 6162 6c65 7320 7768 6963 6820 6172 6520 ables which are │ │ │ │ +0001fe90: 7261 7468 6572 206c 696b 6520 7468 6f73 rather like thos │ │ │ │ +0001fea0: 6520 6f66 6665 7265 640a 6279 2061 6c6c e offered.by all │ │ │ │ +0001feb0: 2055 6e69 782d 6c69 6b65 2073 7973 7465 Unix-like syste │ │ │ │ +0001fec0: 6d73 2e20 2045 6e76 6972 6f6e 6d65 6e74 ms. Environment │ │ │ │ +0001fed0: 2076 6172 6961 626c 6573 2068 6176 6520 variables have │ │ │ │ +0001fee0: 6120 6e61 6d65 2c20 7768 6963 6820 6973 a name, which is │ │ │ │ +0001fef0: 0a75 6e69 7175 6520 616e 6420 6973 2075 .unique and is u │ │ │ │ +0001ff00: 7375 616c 6c79 2061 2073 686f 7274 2069 sually a short i │ │ │ │ +0001ff10: 6465 6e74 6966 6965 722c 2061 6e64 2061 dentifier, and a │ │ │ │ +0001ff20: 2076 616c 7565 2c20 7768 6963 6820 6973 value, which is │ │ │ │ +0001ff30: 2061 6e0a 6172 6269 7472 6172 7920 7374 an.arbitrary st │ │ │ │ +0001ff40: 7269 6e67 206f 6620 6368 6172 6163 7465 ring of characte │ │ │ │ +0001ff50: 7273 2e20 2054 6865 7920 6d61 7920 6265 rs. They may be │ │ │ │ +0001ff60: 2073 6574 2028 2a6e 6f74 6520 7365 743a set (*note set: │ │ │ │ +0001ff70: 3a29 2c20 756e 7365 740a 282a 6e6f 7465 :), unset.(*note │ │ │ │ +0001ff80: 2075 6e73 6574 3a3a 292c 206f 7220 6c6f unset::), or lo │ │ │ │ +0001ff90: 6f6b 6564 2075 7020 282a 6e6f 7465 2053 oked up (*note S │ │ │ │ +0001ffa0: 6865 6c6c 2d6c 696b 6520 7363 7269 7074 hell-like script │ │ │ │ +0001ffb0: 696e 673a 3a29 2062 7920 6e61 6d65 2e0a ing::) by name.. │ │ │ │ +0001ffc0: 0a20 2020 4120 6e75 6d62 6572 206f 6620 . A number of │ │ │ │ +0001ffd0: 656e 7669 726f 6e6d 656e 7420 7661 7269 environment vari │ │ │ │ +0001ffe0: 6162 6c65 7320 6861 7665 2073 7065 6369 ables have speci │ │ │ │ +0001fff0: 616c 206d 6561 6e69 6e67 7320 746f 2076 al meanings to v │ │ │ │ +00020000: 6172 696f 7573 0a70 6172 7473 206f 6620 arious.parts of │ │ │ │ +00020010: 4752 5542 2e20 4f74 6865 7273 206d 6179 GRUB. Others may │ │ │ │ +00020020: 2062 6520 7573 6564 2066 7265 656c 7920 be used freely │ │ │ │ +00020030: 696e 2047 5255 4220 636f 6e66 6967 7572 in GRUB configur │ │ │ │ +00020040: 6174 696f 6e20 6669 6c65 732e 0a0a 2a20 ation files...* │ │ │ │ +00020050: 4d65 6e75 3a0a 0a2a 2053 7065 6369 616c Menu:..* Special │ │ │ │ +00020060: 2065 6e76 6972 6f6e 6d65 6e74 2076 6172 environment var │ │ │ │ +00020070: 6961 626c 6573 3a3a 0a2a 2045 6e76 6972 iables::.* Envir │ │ │ │ +00020080: 6f6e 6d65 6e74 2062 6c6f 636b 3a3a 0a0a onment block::.. │ │ │ │ +00020090: 1f0a 4669 6c65 3a20 6772 7562 2e69 6e66 ..File: grub.inf │ │ │ │ +000200a0: 6f2c 2020 4e6f 6465 3a20 5370 6563 6961 o, Node: Specia │ │ │ │ +000200b0: 6c20 656e 7669 726f 6e6d 656e 7420 7661 l environment va │ │ │ │ +000200c0: 7269 6162 6c65 732c 2020 4e65 7874 3a20 riables, Next: │ │ │ │ +000200d0: 456e 7669 726f 6e6d 656e 7420 626c 6f63 Environment bloc │ │ │ │ +000200e0: 6b2c 2020 5570 3a20 456e 7669 726f 6e6d k, Up: Environm │ │ │ │ +000200f0: 656e 740a 0a31 352e 3120 5370 6563 6961 ent..15.1 Specia │ │ │ │ +00020100: 6c20 656e 7669 726f 6e6d 656e 7420 7661 l environment va │ │ │ │ +00020110: 7269 6162 6c65 730a 3d3d 3d3d 3d3d 3d3d riables.======== │ │ │ │ 00020120: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ -00020130: 3d3d 3d3d 3d3d 0a0a 5468 6573 6520 7661 ======..These va │ │ │ │ -00020140: 7269 6162 6c65 7320 6861 7665 2073 7065 riables have spe │ │ │ │ -00020150: 6369 616c 206d 6561 6e69 6e67 2074 6f20 cial meaning to │ │ │ │ -00020160: 4752 5542 2e0a 0a2a 204d 656e 753a 0a0a GRUB...* Menu:.. │ │ │ │ -00020170: 2a20 6269 6f73 6e75 6d3a 3a0a 2a20 6368 * biosnum::.* ch │ │ │ │ -00020180: 6563 6b5f 7369 676e 6174 7572 6573 3a3a eck_signatures:: │ │ │ │ -00020190: 0a2a 2063 686f 7365 6e3a 3a0a 2a20 636d .* chosen::.* cm │ │ │ │ -000201a0: 6470 6174 683a 3a0a 2a20 636f 6c6f 725f dpath::.* color_ │ │ │ │ -000201b0: 6869 6768 6c69 6768 743a 3a0a 2a20 636f highlight::.* co │ │ │ │ -000201c0: 6c6f 725f 6e6f 726d 616c 3a3a 0a2a 2063 lor_normal::.* c │ │ │ │ -000201d0: 6f6e 6669 675f 6469 7265 6374 6f72 793a onfig_directory: │ │ │ │ -000201e0: 3a0a 2a20 636f 6e66 6967 5f66 696c 653a :.* config_file: │ │ │ │ -000201f0: 3a0a 2a20 6465 6275 673a 3a0a 2a20 6465 :.* debug::.* de │ │ │ │ -00020200: 6661 756c 743a 3a0a 2a20 6661 6c6c 6261 fault::.* fallba │ │ │ │ -00020210: 636b 3a3a 0a2a 2067 6678 6d6f 6465 3a3a ck::.* gfxmode:: │ │ │ │ -00020220: 0a2a 2067 6678 7061 796c 6f61 643a 3a0a .* gfxpayload::. │ │ │ │ -00020230: 2a20 6766 7874 6572 6d5f 666f 6e74 3a3a * gfxterm_font:: │ │ │ │ -00020240: 0a2a 2067 7275 625f 6370 753a 3a0a 2a20 .* grub_cpu::.* │ │ │ │ -00020250: 6772 7562 5f70 6c61 7466 6f72 6d3a 3a0a grub_platform::. │ │ │ │ -00020260: 2a20 6963 6f6e 6469 723a 3a0a 2a20 6c61 * icondir::.* la │ │ │ │ -00020270: 6e67 3a3a 0a2a 206c 6f63 616c 655f 6469 ng::.* locale_di │ │ │ │ -00020280: 723a 3a0a 2a20 6d65 6e75 5f63 6f6c 6f72 r::.* menu_color │ │ │ │ -00020290: 5f68 6967 686c 6967 6874 3a3a 0a2a 206d _highlight::.* m │ │ │ │ -000202a0: 656e 755f 636f 6c6f 725f 6e6f 726d 616c enu_color_normal │ │ │ │ -000202b0: 3a3a 0a2a 206e 6574 5f3c 494e 5445 5246 ::.* net__boot_file:: │ │ │ │ -000202d0: 0a2a 206e 6574 5f3c 494e 5445 5246 4143 .* net__dhcp_server_n │ │ │ │ -000202f0: 616d 653a 3a0a 2a20 6e65 745f 3c49 4e54 ame::.* net__domain:: │ │ │ │ -00020310: 0a2a 206e 6574 5f3c 494e 5445 5246 4143 .* net__extensionspat │ │ │ │ -00020330: 683a 3a0a 2a20 6e65 745f 3c49 4e54 4552 h::.* net__hostname:: │ │ │ │ -00020350: 0a2a 206e 6574 5f3c 494e 5445 5246 4143 .* net__ip::.* net__mac::. │ │ │ │ -00020380: 2a20 6e65 745f 3c49 4e54 4552 4641 4345 * net__next_server::. │ │ │ │ -000203a0: 2a20 6e65 745f 3c49 4e54 4552 4641 4345 * net__rootpath::.* n │ │ │ │ -000203c0: 6574 5f64 6566 6175 6c74 5f69 6e74 6572 et_default_inter │ │ │ │ -000203d0: 6661 6365 3a3a 0a2a 206e 6574 5f64 6566 face::.* net_def │ │ │ │ -000203e0: 6175 6c74 5f69 703a 3a0a 2a20 6e65 745f ault_ip::.* net_ │ │ │ │ -000203f0: 6465 6661 756c 745f 6d61 633a 3a0a 2a20 default_mac::.* │ │ │ │ -00020400: 6e65 745f 6465 6661 756c 745f 7365 7276 net_default_serv │ │ │ │ -00020410: 6572 3a3a 0a2a 2070 6167 6572 3a3a 0a2a er::.* pager::.* │ │ │ │ -00020420: 2070 7265 6669 783a 3a0a 2a20 7078 655f prefix::.* pxe_ │ │ │ │ -00020430: 626c 6b73 697a 653a 3a0a 2a20 7078 655f blksize::.* pxe_ │ │ │ │ -00020440: 6465 6661 756c 745f 6761 7465 7761 793a default_gateway: │ │ │ │ -00020450: 3a0a 2a20 7078 655f 6465 6661 756c 745f :.* pxe_default_ │ │ │ │ -00020460: 7365 7276 6572 3a3a 0a2a 2072 6f6f 743a server::.* root: │ │ │ │ -00020470: 3a0a 2a20 7375 7065 7275 7365 7273 3a3a :.* superusers:: │ │ │ │ -00020480: 0a2a 2074 6865 6d65 3a3a 0a2a 2074 696d .* theme::.* tim │ │ │ │ -00020490: 656f 7574 3a3a 0a2a 2074 696d 656f 7574 eout::.* timeout │ │ │ │ -000204a0: 5f73 7479 6c65 3a3a 0a0a 1f0a 4669 6c65 _style::....File │ │ │ │ -000204b0: 3a20 6772 7562 2e69 6e66 6f2c 2020 4e6f : grub.info, No │ │ │ │ -000204c0: 6465 3a20 6269 6f73 6e75 6d2c 2020 4e65 de: biosnum, Ne │ │ │ │ -000204d0: 7874 3a20 6368 6563 6b5f 7369 676e 6174 xt: check_signat │ │ │ │ -000204e0: 7572 6573 2c20 2055 703a 2053 7065 6369 ures, Up: Speci │ │ │ │ -000204f0: 616c 2065 6e76 6972 6f6e 6d65 6e74 2076 al environment v │ │ │ │ -00020500: 6172 6961 626c 6573 0a0a 3135 2e31 2e31 ariables..15.1.1 │ │ │ │ -00020510: 2062 696f 736e 756d 0a2d 2d2d 2d2d 2d2d biosnum.------- │ │ │ │ -00020520: 2d2d 2d2d 2d2d 2d0a 0a57 6865 6e20 6368 -------..When ch │ │ │ │ -00020530: 6169 6e2d 6c6f 6164 696e 6720 616e 6f74 ain-loading anot │ │ │ │ -00020540: 6865 7220 626f 6f74 206c 6f61 6465 7220 her boot loader │ │ │ │ -00020550: 282a 6e6f 7465 2043 6861 696e 2d6c 6f61 (*note Chain-loa │ │ │ │ -00020560: 6469 6e67 3a3a 292c 2047 5255 4220 6d61 ding::), GRUB ma │ │ │ │ -00020570: 790a 6e65 6564 2074 6f20 6b6e 6f77 2077 y.need to know w │ │ │ │ -00020580: 6861 7420 4249 4f53 2064 7269 7665 206e hat BIOS drive n │ │ │ │ -00020590: 756d 6265 7220 636f 7272 6573 706f 6e64 umber correspond │ │ │ │ -000205a0: 7320 746f 2074 6865 2072 6f6f 7420 6465 s to the root de │ │ │ │ -000205b0: 7669 6365 0a28 2a6e 6f74 6520 726f 6f74 vice.(*note root │ │ │ │ -000205c0: 3a3a 2920 736f 2074 6861 7420 6974 2063 ::) so that it c │ │ │ │ -000205d0: 616e 2073 6574 2075 7020 7265 6769 7374 an set up regist │ │ │ │ -000205e0: 6572 7320 7072 6f70 6572 6c79 2e20 2049 ers properly. I │ │ │ │ -000205f0: 6620 7468 6520 4249 4f53 4e55 4d0a 7661 f the BIOSNUM.va │ │ │ │ -00020600: 7269 6162 6c65 2069 7320 7365 742c 2069 riable is set, i │ │ │ │ -00020610: 7420 6f76 6572 7269 6465 7320 4752 5542 t overrides GRUB │ │ │ │ -00020620: 2773 206f 776e 206d 6561 6e73 206f 6620 's own means of │ │ │ │ -00020630: 6775 6573 7369 6e67 2074 6869 732e 0a0a guessing this... │ │ │ │ -00020640: 2020 2046 6f72 2061 6e20 616c 7465 726e For an altern │ │ │ │ -00020650: 6174 6976 6520 6170 7072 6f61 6368 2077 ative approach w │ │ │ │ -00020660: 6869 6368 2061 6c73 6f20 6368 616e 6765 hich also change │ │ │ │ -00020670: 7320 4249 4f53 2064 7269 7665 206d 6170 s BIOS drive map │ │ │ │ -00020680: 7069 6e67 730a 666f 7220 7468 6520 6368 pings.for the ch │ │ │ │ -00020690: 6169 6e2d 6c6f 6164 6564 2073 7973 7465 ain-loaded syste │ │ │ │ -000206a0: 6d2c 202a 6e6f 7465 2064 7269 7665 6d61 m, *note drivema │ │ │ │ -000206b0: 703a 3a2e 0a0a 1f0a 4669 6c65 3a20 6772 p::.....File: gr │ │ │ │ -000206c0: 7562 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ub.info, Node: │ │ │ │ -000206d0: 6368 6563 6b5f 7369 676e 6174 7572 6573 check_signatures │ │ │ │ -000206e0: 2c20 204e 6578 743a 2063 686f 7365 6e2c , Next: chosen, │ │ │ │ -000206f0: 2020 5072 6576 3a20 6269 6f73 6e75 6d2c Prev: biosnum, │ │ │ │ -00020700: 2020 5570 3a20 5370 6563 6961 6c20 656e Up: Special en │ │ │ │ -00020710: 7669 726f 6e6d 656e 7420 7661 7269 6162 vironment variab │ │ │ │ -00020720: 6c65 730a 0a31 352e 312e 3220 6368 6563 les..15.1.2 chec │ │ │ │ -00020730: 6b5f 7369 676e 6174 7572 6573 0a2d 2d2d k_signatures.--- │ │ │ │ -00020740: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ -00020750: 2d2d 2d2d 0a0a 5468 6973 2076 6172 6961 ----..This varia │ │ │ │ -00020760: 626c 6520 636f 6e74 726f 6c73 2077 6865 ble controls whe │ │ │ │ -00020770: 7468 6572 2047 5255 4220 656e 666f 7263 ther GRUB enforc │ │ │ │ -00020780: 6573 2064 6967 6974 616c 2073 6967 6e61 es digital signa │ │ │ │ -00020790: 7475 7265 0a76 616c 6964 6174 696f 6e20 ture.validation │ │ │ │ -000207a0: 6f6e 206c 6f61 6465 6420 6669 6c65 732e on loaded files. │ │ │ │ -000207b0: 2020 2a4e 6f74 6520 5573 696e 6720 6469 *Note Using di │ │ │ │ -000207c0: 6769 7461 6c20 7369 676e 6174 7572 6573 gital signatures │ │ │ │ -000207d0: 3a3a 2e0a 0a1f 0a46 696c 653a 2067 7275 ::.....File: gru │ │ │ │ -000207e0: 622e 696e 666f 2c20 204e 6f64 653a 2063 b.info, Node: c │ │ │ │ -000207f0: 686f 7365 6e2c 2020 4e65 7874 3a20 636d hosen, Next: cm │ │ │ │ -00020800: 6470 6174 682c 2020 5072 6576 3a20 6368 dpath, Prev: ch │ │ │ │ -00020810: 6563 6b5f 7369 676e 6174 7572 6573 2c20 eck_signatures, │ │ │ │ -00020820: 2055 703a 2053 7065 6369 616c 2065 6e76 Up: Special env │ │ │ │ -00020830: 6972 6f6e 6d65 6e74 2076 6172 6961 626c ironment variabl │ │ │ │ -00020840: 6573 0a0a 3135 2e31 2e33 2063 686f 7365 es..15.1.3 chose │ │ │ │ -00020850: 6e0a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a n.-------------. │ │ │ │ -00020860: 0a57 6865 6e20 6578 6563 7574 696e 6720 .When executing │ │ │ │ -00020870: 6120 6d65 6e75 2065 6e74 7279 2c20 4752 a menu entry, GR │ │ │ │ -00020880: 5542 2073 6574 7320 7468 6520 4348 4f53 UB sets the CHOS │ │ │ │ -00020890: 454e 2076 6172 6961 626c 6520 746f 2074 EN variable to t │ │ │ │ -000208a0: 6865 2074 6974 6c65 0a6f 6620 7468 6520 he title.of the │ │ │ │ -000208b0: 656e 7472 7920 6265 696e 6720 6578 6563 entry being exec │ │ │ │ -000208c0: 7574 6564 2e0a 0a20 2020 4966 2074 6865 uted... If the │ │ │ │ -000208d0: 206d 656e 7520 656e 7472 7920 6973 2069 menu entry is i │ │ │ │ -000208e0: 6e20 6f6e 6520 6f72 206d 6f72 6520 7375 n one or more su │ │ │ │ -000208f0: 626d 656e 7573 2c20 7468 656e 2043 484f bmenus, then CHO │ │ │ │ -00020900: 5345 4e20 6973 2073 6574 2074 6f0a 7468 SEN is set to.th │ │ │ │ -00020910: 6520 7469 746c 6573 206f 6620 6561 6368 e titles of each │ │ │ │ -00020920: 206f 6620 7468 6520 7375 626d 656e 7573 of the submenus │ │ │ │ -00020930: 2073 7461 7274 696e 6720 6672 6f6d 2074 starting from t │ │ │ │ -00020940: 6865 2074 6f70 206c 6576 656c 2066 6f6c he top level fol │ │ │ │ -00020950: 6c6f 7765 640a 6279 2074 6865 2074 6974 lowed.by the tit │ │ │ │ -00020960: 6c65 206f 6620 7468 6520 6d65 6e75 2065 le of the menu e │ │ │ │ -00020970: 6e74 7279 2069 7473 656c 662c 2073 6570 ntry itself, sep │ │ │ │ -00020980: 6172 6174 6564 2062 7920 273e 272e 0a0a arated by '>'... │ │ │ │ -00020990: 1f0a 4669 6c65 3a20 6772 7562 2e69 6e66 ..File: grub.inf │ │ │ │ -000209a0: 6f2c 2020 4e6f 6465 3a20 636d 6470 6174 o, Node: cmdpat │ │ │ │ -000209b0: 682c 2020 4e65 7874 3a20 636f 6c6f 725f h, Next: color_ │ │ │ │ -000209c0: 6869 6768 6c69 6768 742c 2020 5072 6576 highlight, Prev │ │ │ │ -000209d0: 3a20 6368 6f73 656e 2c20 2055 703a 2053 : chosen, Up: S │ │ │ │ -000209e0: 7065 6369 616c 2065 6e76 6972 6f6e 6d65 pecial environme │ │ │ │ -000209f0: 6e74 2076 6172 6961 626c 6573 0a0a 3135 nt variables..15 │ │ │ │ -00020a00: 2e31 2e34 2063 6d64 7061 7468 0a2d 2d2d .1.4 cmdpath.--- │ │ │ │ -00020a10: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a54 6865 -----------..The │ │ │ │ -00020a20: 206c 6f63 6174 696f 6e20 6672 6f6d 2077 location from w │ │ │ │ -00020a30: 6869 6368 2027 636f 7265 2e69 6d67 2720 hich 'core.img' │ │ │ │ -00020a40: 7761 7320 6c6f 6164 6564 2061 7320 616e was loaded as an │ │ │ │ -00020a50: 2061 6273 6f6c 7574 6520 6469 7265 6374 absolute direct │ │ │ │ -00020a60: 6f72 790a 6e61 6d65 2028 2a6e 6f74 6520 ory.name (*note │ │ │ │ -00020a70: 4669 6c65 206e 616d 6520 7379 6e74 6178 File name syntax │ │ │ │ -00020a80: 3a3a 292e 2020 5468 6973 2069 7320 7365 ::). This is se │ │ │ │ -00020a90: 7420 6279 2047 5255 4220 6174 2073 7461 t by GRUB at sta │ │ │ │ -00020aa0: 7274 7570 2062 6173 6564 0a6f 6e20 696e rtup based.on in │ │ │ │ -00020ab0: 666f 726d 6174 696f 6e20 7265 7475 726e formation return │ │ │ │ -00020ac0: 6564 2062 7920 706c 6174 666f 726d 2066 ed by platform f │ │ │ │ -00020ad0: 6972 6d77 6172 652e 2020 4e6f 7420 6576 irmware. Not ev │ │ │ │ -00020ae0: 6572 7920 706c 6174 666f 726d 0a70 726f ery platform.pro │ │ │ │ -00020af0: 7669 6465 7320 7468 6973 2069 6e66 6f72 vides this infor │ │ │ │ -00020b00: 6d61 7469 6f6e 2061 6e64 2073 6f6d 6520 mation and some │ │ │ │ -00020b10: 6d61 7920 7265 7475 726e 206f 6e6c 7920 may return only │ │ │ │ -00020b20: 6465 7669 6365 2077 6974 686f 7574 2070 device without p │ │ │ │ -00020b30: 6174 680a 6e61 6d65 2e0a 0a1f 0a46 696c ath.name.....Fil │ │ │ │ -00020b40: 653a 2067 7275 622e 696e 666f 2c20 204e e: grub.info, N │ │ │ │ -00020b50: 6f64 653a 2063 6f6c 6f72 5f68 6967 686c ode: color_highl │ │ │ │ -00020b60: 6967 6874 2c20 204e 6578 743a 2063 6f6c ight, Next: col │ │ │ │ -00020b70: 6f72 5f6e 6f72 6d61 6c2c 2020 5072 6576 or_normal, Prev │ │ │ │ -00020b80: 3a20 636d 6470 6174 682c 2020 5570 3a20 : cmdpath, Up: │ │ │ │ -00020b90: 5370 6563 6961 6c20 656e 7669 726f 6e6d Special environm │ │ │ │ -00020ba0: 656e 7420 7661 7269 6162 6c65 730a 0a31 ent variables..1 │ │ │ │ -00020bb0: 352e 312e 3520 636f 6c6f 725f 6869 6768 5.1.5 color_high │ │ │ │ -00020bc0: 6c69 6768 740a 2d2d 2d2d 2d2d 2d2d 2d2d light.---------- │ │ │ │ -00020bd0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 5468 ------------..Th │ │ │ │ -00020be0: 6973 2076 6172 6961 626c 6520 636f 6e74 is variable cont │ │ │ │ -00020bf0: 6169 6e73 2074 6865 2022 6869 6768 6c69 ains the "highli │ │ │ │ -00020c00: 6768 7422 2066 6f72 6567 726f 756e 6420 ght" foreground │ │ │ │ -00020c10: 616e 6420 6261 636b 6772 6f75 6e64 0a74 and background.t │ │ │ │ -00020c20: 6572 6d69 6e61 6c20 636f 6c6f 7273 2c20 erminal colors, │ │ │ │ -00020c30: 7365 7061 7261 7465 6420 6279 2061 2073 separated by a s │ │ │ │ -00020c40: 6c61 7368 2028 272f 2729 2e20 2053 6574 lash ('/'). Set │ │ │ │ -00020c50: 7469 6e67 2074 6869 7320 7661 7269 6162 ting this variab │ │ │ │ -00020c60: 6c65 0a63 6861 6e67 6573 2074 686f 7365 le.changes those │ │ │ │ -00020c70: 2063 6f6c 6f72 732e 2020 466f 7220 7468 colors. For th │ │ │ │ -00020c80: 6520 6176 6169 6c61 626c 6520 636f 6c6f e available colo │ │ │ │ -00020c90: 7220 6e61 6d65 732c 202a 6e6f 7465 0a63 r names, *note.c │ │ │ │ -00020ca0: 6f6c 6f72 5f6e 6f72 6d61 6c3a 3a2e 0a0a olor_normal::... │ │ │ │ -00020cb0: 2020 2054 6865 2064 6566 6175 6c74 2069 The default i │ │ │ │ -00020cc0: 7320 2762 6c61 636b 2f6c 6967 6874 2d67 s 'black/light-g │ │ │ │ -00020cd0: 7261 7927 2e0a 0a1f 0a46 696c 653a 2067 ray'.....File: g │ │ │ │ -00020ce0: 7275 622e 696e 666f 2c20 204e 6f64 653a rub.info, Node: │ │ │ │ -00020cf0: 2063 6f6c 6f72 5f6e 6f72 6d61 6c2c 2020 color_normal, │ │ │ │ -00020d00: 4e65 7874 3a20 636f 6e66 6967 5f64 6972 Next: config_dir │ │ │ │ -00020d10: 6563 746f 7279 2c20 2050 7265 763a 2063 ectory, Prev: c │ │ │ │ -00020d20: 6f6c 6f72 5f68 6967 686c 6967 6874 2c20 olor_highlight, │ │ │ │ -00020d30: 2055 703a 2053 7065 6369 616c 2065 6e76 Up: Special env │ │ │ │ -00020d40: 6972 6f6e 6d65 6e74 2076 6172 6961 626c ironment variabl │ │ │ │ -00020d50: 6573 0a0a 3135 2e31 2e36 2063 6f6c 6f72 es..15.1.6 color │ │ │ │ -00020d60: 5f6e 6f72 6d61 6c0a 2d2d 2d2d 2d2d 2d2d _normal.-------- │ │ │ │ -00020d70: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a54 6869 -----------..Thi │ │ │ │ -00020d80: 7320 7661 7269 6162 6c65 2063 6f6e 7461 s variable conta │ │ │ │ -00020d90: 696e 7320 7468 6520 226e 6f72 6d61 6c22 ins the "normal" │ │ │ │ -00020da0: 2066 6f72 6567 726f 756e 6420 616e 6420 foreground and │ │ │ │ -00020db0: 6261 636b 6772 6f75 6e64 2074 6572 6d69 background termi │ │ │ │ -00020dc0: 6e61 6c0a 636f 6c6f 7273 2c20 7365 7061 nal.colors, sepa │ │ │ │ -00020dd0: 7261 7465 6420 6279 2061 2073 6c61 7368 rated by a slash │ │ │ │ -00020de0: 2028 272f 2729 2e20 2053 6574 7469 6e67 ('/'). Setting │ │ │ │ -00020df0: 2074 6869 7320 7661 7269 6162 6c65 2063 this variable c │ │ │ │ -00020e00: 6861 6e67 6573 2074 686f 7365 0a63 6f6c hanges those.col │ │ │ │ -00020e10: 6f72 732e 2020 4561 6368 2063 6f6c 6f72 ors. Each color │ │ │ │ -00020e20: 206d 7573 7420 6265 2061 206e 616d 6520 must be a name │ │ │ │ -00020e30: 6672 6f6d 2074 6865 2066 6f6c 6c6f 7769 from the followi │ │ │ │ -00020e40: 6e67 206c 6973 743a 0a0a 2020 202a 2062 ng list:.. * b │ │ │ │ -00020e50: 6c61 636b 0a20 2020 2a20 626c 7565 0a20 lack. * blue. │ │ │ │ -00020e60: 2020 2a20 6772 6565 6e0a 2020 202a 2063 * green. * c │ │ │ │ -00020e70: 7961 6e0a 2020 202a 2072 6564 0a20 2020 yan. * red. │ │ │ │ -00020e80: 2a20 6d61 6765 6e74 610a 2020 202a 2062 * magenta. * b │ │ │ │ -00020e90: 726f 776e 0a20 2020 2a20 6c69 6768 742d rown. * light- │ │ │ │ -00020ea0: 6772 6179 0a20 2020 2a20 6461 726b 2d67 gray. * dark-g │ │ │ │ -00020eb0: 7261 790a 2020 202a 206c 6967 6874 2d62 ray. * light-b │ │ │ │ -00020ec0: 6c75 650a 2020 202a 206c 6967 6874 2d67 lue. * light-g │ │ │ │ -00020ed0: 7265 656e 0a20 2020 2a20 6c69 6768 742d reen. * light- │ │ │ │ -00020ee0: 6379 616e 0a20 2020 2a20 6c69 6768 742d cyan. * light- │ │ │ │ -00020ef0: 7265 640a 2020 202a 206c 6967 6874 2d6d red. * light-m │ │ │ │ -00020f00: 6167 656e 7461 0a20 2020 2a20 7965 6c6c agenta. * yell │ │ │ │ -00020f10: 6f77 0a20 2020 2a20 7768 6974 650a 0a20 ow. * white.. │ │ │ │ -00020f20: 2020 5468 6520 6465 6661 756c 7420 6973 The default is │ │ │ │ -00020f30: 2027 6c69 6768 742d 6772 6179 2f62 6c61 'light-gray/bla │ │ │ │ -00020f40: 636b 272e 0a0a 2020 2054 6865 2063 6f6c ck'... The col │ │ │ │ -00020f50: 6f72 2073 7570 706f 7274 2073 7570 706f or support suppo │ │ │ │ -00020f60: 7274 2076 6172 6965 7320 6672 6f6d 2074 rt varies from t │ │ │ │ -00020f70: 6572 6d69 6e61 6c20 746f 2074 6572 6d69 erminal to termi │ │ │ │ -00020f80: 6e61 6c2e 0a0a 2020 2027 6d6f 7273 6527 nal... 'morse' │ │ │ │ -00020f90: 2068 6173 206e 6f20 636f 6c6f 7220 7375 has no color su │ │ │ │ -00020fa0: 7070 6f72 7420 6174 2061 6c6c 2e0a 0a20 pport at all... │ │ │ │ -00020fb0: 2020 276d 6461 5f74 6578 7427 2063 6f6c 'mda_text' col │ │ │ │ -00020fc0: 6f72 2073 7570 706f 7274 2069 7320 6c69 or support is li │ │ │ │ -00020fd0: 6d69 7465 6420 746f 2068 6967 686c 6967 mited to highlig │ │ │ │ -00020fe0: 6874 696e 6720 6279 2062 6c61 636b 2f77 hting by black/w │ │ │ │ -00020ff0: 6869 7465 0a72 6576 6572 7361 6c2e 0a0a hite.reversal... │ │ │ │ -00021000: 2020 2027 636f 6e73 6f6c 6527 206f 6e20 'console' on │ │ │ │ -00021010: 4152 432c 2045 4d55 2061 6e64 2049 4545 ARC, EMU and IEE │ │ │ │ -00021020: 4531 3237 352c 2027 7365 7269 616c 5f2a E1275, 'serial_* │ │ │ │ -00021030: 2720 616e 6420 2773 706b 6d6f 6465 6d27 ' and 'spkmodem' │ │ │ │ -00021040: 2061 7265 0a67 6f76 6572 6e65 6420 6279 are.governed by │ │ │ │ -00021050: 2074 6572 6d69 6e66 6f20 616e 6420 7375 terminfo and su │ │ │ │ -00021060: 7070 6f72 7420 6f6e 6c79 2038 2063 6f6c pport only 8 col │ │ │ │ -00021070: 6f72 7320 6966 2069 6e20 6d6f 6465 7320 ors if in modes │ │ │ │ -00021080: 2776 7431 3030 2d63 6f6c 6f72 270a 2864 'vt100-color'.(d │ │ │ │ -00021090: 6566 6175 6c74 2066 6f72 2063 6f6e 736f efault for conso │ │ │ │ -000210a0: 6c65 206f 6e20 656d 7529 2c20 2761 7263 le on emu), 'arc │ │ │ │ -000210b0: 2720 2864 6566 6175 6c74 2066 6f72 2063 ' (default for c │ │ │ │ -000210c0: 6f6e 736f 6c65 206f 6e20 4152 4329 2c0a onsole on ARC),. │ │ │ │ -000210d0: 2769 6565 6531 3237 3527 2028 6465 6661 'ieee1275' (defa │ │ │ │ -000210e0: 756c 7420 666f 7220 636f 6e73 6f6c 6520 ult for console │ │ │ │ -000210f0: 6f6e 2049 4545 4531 3237 3529 2e20 2057 on IEEE1275). W │ │ │ │ -00021100: 6865 6e20 696e 206d 6f64 6520 2776 7431 hen in mode 'vt1 │ │ │ │ -00021110: 3030 2720 7468 656e 0a74 6865 2063 6f6c 00' then.the col │ │ │ │ -00021120: 6f72 2073 7570 706f 7274 2069 7320 6c69 or support is li │ │ │ │ -00021130: 6d69 7465 6420 746f 2068 6967 686c 6967 mited to highlig │ │ │ │ -00021140: 6874 696e 6720 6279 2062 6c61 636b 2f77 hting by black/w │ │ │ │ -00021150: 6869 7465 2072 6576 6572 7361 6c2e 0a57 hite reversal..W │ │ │ │ -00021160: 6865 6e20 696e 206d 6f64 6520 2764 756d hen in mode 'dum │ │ │ │ -00021170: 6227 2074 6865 7265 2069 7320 6e6f 2063 b' there is no c │ │ │ │ -00021180: 6f6c 6f72 2073 7570 706f 7274 2e0a 0a20 olor support... │ │ │ │ -00021190: 2020 5768 656e 2063 6f6e 736f 6c65 2073 When console s │ │ │ │ -000211a0: 7570 706f 7274 7320 6e6f 2063 6f6c 6f72 upports no color │ │ │ │ -000211b0: 7320 7468 6973 2073 6574 7469 6e67 2069 s this setting i │ │ │ │ -000211c0: 7320 6967 6e6f 7265 642e 2020 5768 656e s ignored. When │ │ │ │ -000211d0: 0a63 6f6e 736f 6c65 2073 7570 706f 7274 .console support │ │ │ │ -000211e0: 7320 3820 636f 6c6f 7273 2c20 7468 656e s 8 colors, then │ │ │ │ -000211f0: 2074 6865 2063 6f6c 6f72 7320 6672 6f6d the colors from │ │ │ │ -00021200: 2074 6865 2073 6563 6f6e 6420 6861 6c66 the second half │ │ │ │ -00021210: 206f 6620 7468 650a 7072 6576 696f 7573 of the.previous │ │ │ │ -00021220: 206c 6973 7420 6172 6520 6d61 7070 6564 list are mapped │ │ │ │ -00021230: 2074 6f20 7468 6520 6d61 7463 6869 6e67 to the matching │ │ │ │ -00021240: 2063 6f6c 6f72 7320 6f66 2066 6972 7374 colors of first │ │ │ │ -00021250: 2068 616c 662e 0a0a 2020 2027 636f 6e73 half... 'cons │ │ │ │ -00021260: 6f6c 6527 206f 6e20 4546 4920 616e 6420 ole' on EFI and │ │ │ │ -00021270: 4249 4f53 2061 6e64 2027 7667 615f 7465 BIOS and 'vga_te │ │ │ │ -00021280: 7874 2720 7375 7070 6f72 7420 616c 6c20 xt' support all │ │ │ │ -00021290: 3136 2063 6f6c 6f72 732e 0a0a 2020 2027 16 colors... ' │ │ │ │ -000212a0: 6766 7874 6572 6d27 2073 7570 706f 7274 gfxterm' support │ │ │ │ -000212b0: 7320 616c 6c20 3136 2063 6f6c 6f72 7320 s all 16 colors │ │ │ │ -000212c0: 616e 6420 776f 756c 6420 6265 2074 6865 and would be the │ │ │ │ -000212d0: 6f72 6574 6963 616c 6c79 0a65 7874 656e oretically.exten │ │ │ │ -000212e0: 6461 626c 6520 746f 2073 7570 706f 7274 dable to support │ │ │ │ -000212f0: 2077 686f 6c65 2072 6762 3234 2070 616c whole rgb24 pal │ │ │ │ -00021300: 6574 7465 2062 7574 2063 7572 7265 6e74 ette but current │ │ │ │ -00021310: 6c79 2074 6865 7265 2069 7320 6e6f 0a63 ly there is no.c │ │ │ │ -00021320: 6f6d 7065 6c6c 696e 6720 7265 6173 6f6e ompelling reason │ │ │ │ -00021330: 2074 6f20 676f 2062 6579 6f6e 6420 7468 to go beyond th │ │ │ │ -00021340: 6520 6375 7272 656e 7420 3136 2063 6f6c e current 16 col │ │ │ │ -00021350: 6f72 732e 0a0a 1f0a 4669 6c65 3a20 6772 ors.....File: gr │ │ │ │ -00021360: 7562 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ub.info, Node: │ │ │ │ -00021370: 636f 6e66 6967 5f64 6972 6563 746f 7279 config_directory │ │ │ │ -00021380: 2c20 204e 6578 743a 2063 6f6e 6669 675f , Next: config_ │ │ │ │ -00021390: 6669 6c65 2c20 2050 7265 763a 2063 6f6c file, Prev: col │ │ │ │ -000213a0: 6f72 5f6e 6f72 6d61 6c2c 2020 5570 3a20 or_normal, Up: │ │ │ │ -000213b0: 5370 6563 6961 6c20 656e 7669 726f 6e6d Special environm │ │ │ │ -000213c0: 656e 7420 7661 7269 6162 6c65 730a 0a31 ent variables..1 │ │ │ │ -000213d0: 352e 312e 3720 636f 6e66 6967 5f64 6972 5.1.7 config_dir │ │ │ │ -000213e0: 6563 746f 7279 0a2d 2d2d 2d2d 2d2d 2d2d ectory.--------- │ │ │ │ -000213f0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a --------------.. │ │ │ │ -00021400: 5468 6973 2076 6172 6961 626c 6520 6973 This variable is │ │ │ │ -00021410: 2061 7574 6f6d 6174 6963 616c 6c79 2073 automatically s │ │ │ │ -00021420: 6574 2062 7920 4752 5542 2074 6f20 7468 et by GRUB to th │ │ │ │ -00021430: 6520 6469 7265 6374 6f72 7920 7061 7274 e directory part │ │ │ │ -00021440: 206f 660a 6375 7272 656e 7420 636f 6e66 of.current conf │ │ │ │ -00021450: 6967 7572 6174 696f 6e20 6669 6c65 206e iguration file n │ │ │ │ -00021460: 616d 6520 282a 6e6f 7465 2063 6f6e 6669 ame (*note confi │ │ │ │ -00021470: 675f 6669 6c65 3a3a 292e 0a0a 1f0a 4669 g_file::).....Fi │ │ │ │ -00021480: 6c65 3a20 6772 7562 2e69 6e66 6f2c 2020 le: grub.info, │ │ │ │ -00021490: 4e6f 6465 3a20 636f 6e66 6967 5f66 696c Node: config_fil │ │ │ │ -000214a0: 652c 2020 4e65 7874 3a20 6465 6275 672c e, Next: debug, │ │ │ │ -000214b0: 2020 5072 6576 3a20 636f 6e66 6967 5f64 Prev: config_d │ │ │ │ -000214c0: 6972 6563 746f 7279 2c20 2055 703a 2053 irectory, Up: S │ │ │ │ -000214d0: 7065 6369 616c 2065 6e76 6972 6f6e 6d65 pecial environme │ │ │ │ -000214e0: 6e74 2076 6172 6961 626c 6573 0a0a 3135 nt variables..15 │ │ │ │ -000214f0: 2e31 2e38 2063 6f6e 6669 675f 6669 6c65 .1.8 config_file │ │ │ │ -00021500: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d .--------------- │ │ │ │ -00021510: 2d2d 2d0a 0a54 6869 7320 7661 7269 6162 ---..This variab │ │ │ │ -00021520: 6c65 2069 7320 6175 746f 6d61 7469 6361 le is automatica │ │ │ │ -00021530: 6c6c 7920 7365 7420 6279 2047 5255 4220 lly set by GRUB │ │ │ │ -00021540: 746f 2074 6865 206e 616d 6520 6f66 2063 to the name of c │ │ │ │ -00021550: 6f6e 6669 6775 7261 7469 6f6e 0a66 696c onfiguration.fil │ │ │ │ -00021560: 6520 7468 6174 2069 7320 6265 696e 6720 e that is being │ │ │ │ -00021570: 7072 6f63 6573 7365 6420 6279 2063 6f6d processed by com │ │ │ │ -00021580: 6d61 6e64 7320 2763 6f6e 6669 6766 696c mands 'configfil │ │ │ │ -00021590: 6527 2028 2a6e 6f74 650a 636f 6e66 6967 e' (*note.config │ │ │ │ -000215a0: 6669 6c65 3a3a 2920 6f72 2027 6e6f 726d file::) or 'norm │ │ │ │ -000215b0: 616c 2720 282a 6e6f 7465 206e 6f72 6d61 al' (*note norma │ │ │ │ -000215c0: 6c3a 3a29 2e20 2049 7420 6973 2072 6573 l::). It is res │ │ │ │ -000215d0: 746f 7265 6420 746f 2074 6865 0a70 7265 tored to the.pre │ │ │ │ -000215e0: 7669 6f75 7320 7661 6c75 6520 7768 656e vious value when │ │ │ │ -000215f0: 2063 6f6d 6d61 6e64 2063 6f6d 706c 6574 command complet │ │ │ │ -00021600: 6573 2e0a 0a1f 0a46 696c 653a 2067 7275 es.....File: gru │ │ │ │ -00021610: 622e 696e 666f 2c20 204e 6f64 653a 2064 b.info, Node: d │ │ │ │ -00021620: 6562 7567 2c20 204e 6578 743a 2064 6566 ebug, Next: def │ │ │ │ -00021630: 6175 6c74 2c20 2050 7265 763a 2063 6f6e ault, Prev: con │ │ │ │ -00021640: 6669 675f 6669 6c65 2c20 2055 703a 2053 fig_file, Up: S │ │ │ │ -00021650: 7065 6369 616c 2065 6e76 6972 6f6e 6d65 pecial environme │ │ │ │ -00021660: 6e74 2076 6172 6961 626c 6573 0a0a 3135 nt variables..15 │ │ │ │ -00021670: 2e31 2e39 2064 6562 7567 0a2d 2d2d 2d2d .1.9 debug.----- │ │ │ │ -00021680: 2d2d 2d2d 2d2d 2d0a 0a54 6869 7320 7661 -------..This va │ │ │ │ -00021690: 7269 6162 6c65 206d 6179 2062 6520 7365 riable may be se │ │ │ │ -000216a0: 7420 746f 2065 6e61 626c 6520 6465 6275 t to enable debu │ │ │ │ -000216b0: 6767 696e 6720 6f75 7470 7574 2066 726f gging output fro │ │ │ │ -000216c0: 6d20 7661 7269 6f75 730a 636f 6d70 6f6e m various.compon │ │ │ │ -000216d0: 656e 7473 206f 6620 4752 5542 2e20 5468 ents of GRUB. Th │ │ │ │ -000216e0: 6520 7661 6c75 6520 6973 2061 206c 6973 e value is a lis │ │ │ │ -000216f0: 7420 6f66 2064 6562 7567 2066 6163 696c t of debug facil │ │ │ │ -00021700: 6974 7920 6e61 6d65 730a 7365 7061 7261 ity names.separa │ │ │ │ -00021710: 7465 6420 6279 2077 6869 7465 7370 6163 ted by whitespac │ │ │ │ -00021720: 6520 6f72 2027 2c27 2c20 6f72 2027 616c e or ',', or 'al │ │ │ │ -00021730: 6c27 2074 6f20 656e 6162 6c65 2061 6c6c l' to enable all │ │ │ │ -00021740: 2061 7661 696c 6162 6c65 0a64 6562 7567 available.debug │ │ │ │ -00021750: 6769 6e67 206f 7574 7075 742e 2020 5468 ging output. Th │ │ │ │ -00021760: 6520 6661 6369 6c69 7479 206e 616d 6573 e facility names │ │ │ │ -00021770: 2061 7265 2074 6865 2066 6972 7374 2061 are the first a │ │ │ │ -00021780: 7267 756d 656e 7420 746f 0a67 7275 625f rgument to.grub_ │ │ │ │ -00021790: 6470 7269 6e74 662e 2020 436f 6e73 756c dprintf. Consul │ │ │ │ -000217a0: 7420 736f 7572 6365 2066 6f72 206d 6f72 t source for mor │ │ │ │ -000217b0: 6520 6465 7461 696c 732e 0a0a 1f0a 4669 e details.....Fi │ │ │ │ -000217c0: 6c65 3a20 6772 7562 2e69 6e66 6f2c 2020 le: grub.info, │ │ │ │ -000217d0: 4e6f 6465 3a20 6465 6661 756c 742c 2020 Node: default, │ │ │ │ -000217e0: 4e65 7874 3a20 6661 6c6c 6261 636b 2c20 Next: fallback, │ │ │ │ -000217f0: 2050 7265 763a 2064 6562 7567 2c20 2055 Prev: debug, U │ │ │ │ -00021800: 703a 2053 7065 6369 616c 2065 6e76 6972 p: Special envir │ │ │ │ -00021810: 6f6e 6d65 6e74 2076 6172 6961 626c 6573 onment variables │ │ │ │ -00021820: 0a0a 3135 2e31 2e31 3020 6465 6661 756c ..15.1.10 defaul │ │ │ │ -00021830: 740a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d t.-------------- │ │ │ │ -00021840: 2d0a 0a49 6620 7468 6973 2076 6172 6961 -..If this varia │ │ │ │ -00021850: 626c 6520 6973 2073 6574 2c20 6974 2069 ble is set, it i │ │ │ │ -00021860: 6465 6e74 6966 6965 7320 6120 6d65 6e75 dentifies a menu │ │ │ │ -00021870: 2065 6e74 7279 2074 6861 7420 7368 6f75 entry that shou │ │ │ │ -00021880: 6c64 2062 650a 7365 6c65 6374 6564 2062 ld be.selected b │ │ │ │ -00021890: 7920 6465 6661 756c 742c 2070 6f73 7369 y default, possi │ │ │ │ -000218a0: 626c 7920 6166 7465 7220 6120 7469 6d65 bly after a time │ │ │ │ -000218b0: 6f75 7420 282a 6e6f 7465 2074 696d 656f out (*note timeo │ │ │ │ -000218c0: 7574 3a3a 292e 2020 5468 650a 656e 7472 ut::). The.entr │ │ │ │ -000218d0: 7920 6d61 7920 6265 2069 6465 6e74 6966 y may be identif │ │ │ │ -000218e0: 6965 6420 6279 206e 756d 6265 7220 2873 ied by number (s │ │ │ │ -000218f0: 7461 7274 696e 6720 6672 6f6d 2030 2061 tarting from 0 a │ │ │ │ -00021900: 7420 6561 6368 206c 6576 656c 206f 6620 t each level of │ │ │ │ -00021910: 7468 650a 6869 6572 6172 6368 7929 2c20 the.hierarchy), │ │ │ │ -00021920: 6279 2074 6974 6c65 2c20 6f72 2062 7920 by title, or by │ │ │ │ -00021930: 6964 2e0a 0a20 2020 466f 7220 6578 616d id... For exam │ │ │ │ -00021940: 706c 652c 2069 6620 796f 7520 6861 7665 ple, if you have │ │ │ │ -00021950: 3a0a 0a6d 656e 7565 6e74 7279 2027 4578 :..menuentry 'Ex │ │ │ │ -00021960: 616d 706c 6520 474e 552f 4c69 6e75 7820 ample GNU/Linux │ │ │ │ -00021970: 6469 7374 7269 6275 7469 6f6e 2720 2d2d distribution' -- │ │ │ │ -00021980: 636c 6173 7320 676e 752d 6c69 6e75 7820 class gnu-linux │ │ │ │ -00021990: 2d2d 6964 2065 7861 6d70 6c65 2d67 6e75 --id example-gnu │ │ │ │ -000219a0: 2d6c 696e 7578 207b 0a09 2e2e 2e0a 7d0a -linux {......}. │ │ │ │ -000219b0: 0a20 2020 7468 656e 2079 6f75 2063 616e . then you can │ │ │ │ -000219c0: 206d 616b 6520 7468 6973 2074 6865 2064 make this the d │ │ │ │ -000219d0: 6566 6175 6c74 2075 7369 6e67 3a0a 0a20 efault using:.. │ │ │ │ -000219e0: 2020 2020 6465 6661 756c 743d 6578 616d default=exam │ │ │ │ -000219f0: 706c 652d 676e 752d 6c69 6e75 780a 0a20 ple-gnu-linux.. │ │ │ │ -00021a00: 2020 4966 2074 6865 2065 6e74 7279 2069 If the entry i │ │ │ │ -00021a10: 7320 696e 2061 2073 7562 6d65 6e75 2c20 s in a submenu, │ │ │ │ -00021a20: 7468 656e 2069 7420 6d75 7374 2062 6520 then it must be │ │ │ │ -00021a30: 6964 656e 7469 6669 6564 2075 7369 6e67 identified using │ │ │ │ -00021a40: 2074 6865 0a6e 756d 6265 722c 2074 6974 the.number, tit │ │ │ │ -00021a50: 6c65 2c20 6f72 2069 6420 6f66 2065 6163 le, or id of eac │ │ │ │ -00021a60: 6820 6f66 2074 6865 2073 7562 6d65 6e75 h of the submenu │ │ │ │ -00021a70: 7320 7374 6172 7469 6e67 2066 726f 6d20 s starting from │ │ │ │ -00021a80: 7468 6520 746f 700a 6c65 7665 6c2c 2066 the top.level, f │ │ │ │ -00021a90: 6f6c 6c6f 7765 6420 6279 2074 6865 206e ollowed by the n │ │ │ │ -00021aa0: 756d 6265 722c 2074 6974 6c65 2c20 6f72 umber, title, or │ │ │ │ -00021ab0: 2069 6420 6f66 2074 6865 206d 656e 7520 id of the menu │ │ │ │ -00021ac0: 656e 7472 7920 6974 7365 6c66 2c0a 7769 entry itself,.wi │ │ │ │ -00021ad0: 7468 2065 6163 6820 656c 656d 656e 7420 th each element │ │ │ │ -00021ae0: 7365 7061 7261 7465 6420 6279 2027 3e27 separated by '>' │ │ │ │ -00021af0: 2e20 2046 6f72 2065 7861 6d70 6c65 2c20 . For example, │ │ │ │ -00021b00: 7461 6b65 2074 6865 2066 6f6c 6c6f 7769 take the followi │ │ │ │ -00021b10: 6e67 0a6d 656e 7520 7374 7275 6374 7572 ng.menu structur │ │ │ │ -00021b20: 653a 0a0a 2020 2020 2047 4e55 2f48 7572 e:.. GNU/Hur │ │ │ │ -00021b30: 6420 2d2d 6964 2067 6e75 2d68 7572 640a d --id gnu-hurd. │ │ │ │ -00021b40: 2020 2020 2020 2053 7461 6e64 6172 6420 Standard │ │ │ │ -00021b50: 426f 6f74 202d 2d69 643d 676e 752d 6875 Boot --id=gnu-hu │ │ │ │ -00021b60: 7264 2d73 7464 0a20 2020 2020 2020 5265 rd-std. Re │ │ │ │ -00021b70: 7363 7565 2073 6865 6c6c 202d 2d69 643d scue shell --id= │ │ │ │ -00021b80: 676e 752d 6875 7264 2d72 6573 6375 650a gnu-hurd-rescue. │ │ │ │ -00021b90: 2020 2020 204f 7468 6572 2070 6c61 7466 Other platf │ │ │ │ -00021ba0: 6f72 6d73 202d 2d69 643d 6f74 6865 720a orms --id=other. │ │ │ │ -00021bb0: 2020 2020 2020 204d 696e 6978 202d 2d69 Minix --i │ │ │ │ -00021bc0: 643d 6d69 6e69 780a 2020 2020 2020 2020 d=minix. │ │ │ │ -00021bd0: 2056 6572 7369 6f6e 2033 2e34 2e30 202d Version 3.4.0 - │ │ │ │ -00021be0: 2d69 643d 6d69 6e69 782d 332e 342e 300a -id=minix-3.4.0. │ │ │ │ -00021bf0: 2020 2020 2020 2020 2056 6572 7369 6f6e Version │ │ │ │ -00021c00: 2033 2e33 2e30 202d 2d69 643d 6d69 6e69 3.3.0 --id=mini │ │ │ │ -00021c10: 782d 332e 332e 300a 2020 2020 2020 2047 x-3.3.0. G │ │ │ │ -00021c20: 5255 4220 496e 7661 6465 7273 202d 2d69 RUB Invaders --i │ │ │ │ -00021c30: 643d 6772 7562 2d69 6e76 6164 6572 730a d=grub-invaders. │ │ │ │ -00021c40: 0a20 2020 5468 6520 6d6f 7265 2072 6563 . The more rec │ │ │ │ -00021c50: 656e 7420 7265 6c65 6173 6520 6f66 204d ent release of M │ │ │ │ -00021c60: 696e 6978 2077 6f75 6c64 2074 6865 6e20 inix would then │ │ │ │ -00021c70: 6265 2069 6465 6e74 6966 6965 6420 6173 be identified as │ │ │ │ -00021c80: 2027 4f74 6865 720a 706c 6174 666f 726d 'Other.platform │ │ │ │ -00021c90: 733e 4d69 6e69 783e 5665 7273 696f 6e20 s>Minix>Version │ │ │ │ -00021ca0: 332e 342e 3027 2c20 6f72 2061 7320 2731 3.4.0', or as '1 │ │ │ │ -00021cb0: 3e30 3e30 272c 206f 7220 6173 0a27 6f74 >0>0', or as.'ot │ │ │ │ -00021cc0: 6865 723e 6d69 6e69 783e 6d69 6e69 782d her>minix>minix- │ │ │ │ -00021cd0: 332e 342e 3027 2e0a 0a20 2020 5468 6973 3.4.0'... This │ │ │ │ -00021ce0: 2076 6172 6961 626c 6520 6973 206f 6674 variable is oft │ │ │ │ -00021cf0: 656e 2073 6574 2062 7920 2747 5255 425f en set by 'GRUB_ │ │ │ │ -00021d00: 4445 4641 554c 5427 2028 2a6e 6f74 6520 DEFAULT' (*note │ │ │ │ -00021d10: 5369 6d70 6c65 0a63 6f6e 6669 6775 7261 Simple.configura │ │ │ │ -00021d20: 7469 6f6e 3a3a 292c 2027 6772 7562 2d73 tion::), 'grub-s │ │ │ │ -00021d30: 6574 2d64 6566 6175 6c74 272c 206f 7220 et-default', or │ │ │ │ -00021d40: 2767 7275 622d 7265 626f 6f74 272e 0a0a 'grub-reboot'... │ │ │ │ -00021d50: 1f0a 4669 6c65 3a20 6772 7562 2e69 6e66 ..File: grub.inf │ │ │ │ -00021d60: 6f2c 2020 4e6f 6465 3a20 6661 6c6c 6261 o, Node: fallba │ │ │ │ -00021d70: 636b 2c20 204e 6578 743a 2067 6678 6d6f ck, Next: gfxmo │ │ │ │ -00021d80: 6465 2c20 2050 7265 763a 2064 6566 6175 de, Prev: defau │ │ │ │ -00021d90: 6c74 2c20 2055 703a 2053 7065 6369 616c lt, Up: Special │ │ │ │ -00021da0: 2065 6e76 6972 6f6e 6d65 6e74 2076 6172 environment var │ │ │ │ -00021db0: 6961 626c 6573 0a0a 3135 2e31 2e31 3120 iables..15.1.11 │ │ │ │ -00021dc0: 6661 6c6c 6261 636b 0a2d 2d2d 2d2d 2d2d fallback.------- │ │ │ │ -00021dd0: 2d2d 2d2d 2d2d 2d2d 2d0a 0a49 6620 7468 ---------..If th │ │ │ │ -00021de0: 6973 2076 6172 6961 626c 6520 6973 2073 is variable is s │ │ │ │ -00021df0: 6574 2c20 6974 2069 6465 6e74 6966 6965 et, it identifie │ │ │ │ -00021e00: 7320 6120 6d65 6e75 2065 6e74 7279 2074 s a menu entry t │ │ │ │ -00021e10: 6861 7420 7368 6f75 6c64 2062 650a 7365 hat should be.se │ │ │ │ -00021e20: 6c65 6374 6564 2069 6620 7468 6520 6465 lected if the de │ │ │ │ -00021e30: 6661 756c 7420 6d65 6e75 2065 6e74 7279 fault menu entry │ │ │ │ -00021e40: 2066 6169 6c73 2074 6f20 626f 6f74 2e20 fails to boot. │ │ │ │ -00021e50: 2045 6e74 7269 6573 2061 7265 0a69 6465 Entries are.ide │ │ │ │ -00021e60: 6e74 6966 6965 6420 696e 2074 6865 2073 ntified in the s │ │ │ │ -00021e70: 616d 6520 7761 7920 6173 2066 6f72 2027 ame way as for ' │ │ │ │ -00021e80: 6465 6661 756c 7427 2028 2a6e 6f74 6520 default' (*note │ │ │ │ -00021e90: 6465 6661 756c 743a 3a29 2e0a 0a1f 0a46 default::).....F │ │ │ │ -00021ea0: 696c 653a 2067 7275 622e 696e 666f 2c20 ile: grub.info, │ │ │ │ -00021eb0: 204e 6f64 653a 2067 6678 6d6f 6465 2c20 Node: gfxmode, │ │ │ │ -00021ec0: 204e 6578 743a 2067 6678 7061 796c 6f61 Next: gfxpayloa │ │ │ │ -00021ed0: 642c 2020 5072 6576 3a20 6661 6c6c 6261 d, Prev: fallba │ │ │ │ -00021ee0: 636b 2c20 2055 703a 2053 7065 6369 616c ck, Up: Special │ │ │ │ -00021ef0: 2065 6e76 6972 6f6e 6d65 6e74 2076 6172 environment var │ │ │ │ -00021f00: 6961 626c 6573 0a0a 3135 2e31 2e31 3220 iables..15.1.12 │ │ │ │ -00021f10: 6766 786d 6f64 650a 2d2d 2d2d 2d2d 2d2d gfxmode.-------- │ │ │ │ -00021f20: 2d2d 2d2d 2d2d 2d0a 0a49 6620 7468 6973 -------..If this │ │ │ │ -00021f30: 2076 6172 6961 626c 6520 6973 2073 6574 variable is set │ │ │ │ -00021f40: 2c20 6974 2073 6574 7320 7468 6520 7265 , it sets the re │ │ │ │ -00021f50: 736f 6c75 7469 6f6e 2075 7365 6420 6f6e solution used on │ │ │ │ -00021f60: 2074 6865 2027 6766 7874 6572 6d27 0a67 the 'gfxterm'.g │ │ │ │ -00021f70: 7261 7068 6963 616c 2074 6572 6d69 6e61 raphical termina │ │ │ │ -00021f80: 6c2e 2020 4e6f 7465 2074 6861 7420 796f l. Note that yo │ │ │ │ -00021f90: 7520 6361 6e20 6f6e 6c79 2075 7365 206d u can only use m │ │ │ │ -00021fa0: 6f64 6573 2077 6869 6368 2079 6f75 720a odes which your. │ │ │ │ -00021fb0: 6772 6170 6869 6373 2063 6172 6420 7375 graphics card su │ │ │ │ -00021fc0: 7070 6f72 7473 2076 6961 2056 4553 4120 pports via VESA │ │ │ │ -00021fd0: 4249 4f53 2045 7874 656e 7369 6f6e 7320 BIOS Extensions │ │ │ │ -00021fe0: 2856 4245 292c 2073 6f20 666f 7220 6578 (VBE), so for ex │ │ │ │ -00021ff0: 616d 706c 650a 6e61 7469 7665 204c 4344 ample.native LCD │ │ │ │ -00022000: 2070 616e 656c 2072 6573 6f6c 7574 696f panel resolutio │ │ │ │ -00022010: 6e73 206d 6179 206e 6f74 2062 6520 6176 ns may not be av │ │ │ │ -00022020: 6169 6c61 626c 652e 2020 5468 6520 6465 ailable. The de │ │ │ │ -00022030: 6661 756c 7420 6973 0a27 6175 746f 272c fault is.'auto', │ │ │ │ -00022040: 2077 6869 6368 2073 656c 6563 7473 2061 which selects a │ │ │ │ -00022050: 2070 6c61 7466 6f72 6d2d 7370 6563 6966 platform-specif │ │ │ │ -00022060: 6963 2064 6566 6175 6c74 2074 6861 7420 ic default that │ │ │ │ -00022070: 7368 6f75 6c64 206c 6f6f 6b0a 7265 6173 should look.reas │ │ │ │ -00022080: 6f6e 6162 6c65 2e20 2053 7570 706f 7274 onable. Support │ │ │ │ -00022090: 6564 206d 6f64 6573 2063 616e 2062 6520 ed modes can be │ │ │ │ -000220a0: 6c69 7374 6564 2062 7920 2776 6964 656f listed by 'video │ │ │ │ -000220b0: 696e 666f 2720 636f 6d6d 616e 6420 696e info' command in │ │ │ │ -000220c0: 0a47 5255 422e 0a0a 2020 2054 6865 2072 .GRUB... The r │ │ │ │ -000220d0: 6573 6f6c 7574 696f 6e20 6d61 7920 6265 esolution may be │ │ │ │ -000220e0: 2073 7065 6369 6669 6564 2061 7320 6120 specified as a │ │ │ │ -000220f0: 7365 7175 656e 6365 206f 6620 6f6e 6520 sequence of one │ │ │ │ -00022100: 6f72 206d 6f72 6520 6d6f 6465 732c 0a73 or more modes,.s │ │ │ │ -00022110: 6570 6172 6174 6564 2062 7920 636f 6d6d eparated by comm │ │ │ │ -00022120: 6173 2028 272c 2729 206f 7220 7365 6d69 as (',') or semi │ │ │ │ -00022130: 636f 6c6f 6e73 2028 273b 2729 3b20 6561 colons (';'); ea │ │ │ │ -00022140: 6368 2077 696c 6c20 6265 2074 7269 6564 ch will be tried │ │ │ │ -00022150: 2069 6e0a 7475 726e 2075 6e74 696c 206f in.turn until o │ │ │ │ -00022160: 6e65 2069 7320 666f 756e 642e 2020 4561 ne is found. Ea │ │ │ │ -00022170: 6368 206d 6f64 6520 7368 6f75 6c64 2062 ch mode should b │ │ │ │ -00022180: 6520 6569 7468 6572 2027 6175 746f 272c e either 'auto', │ │ │ │ -00022190: 0a27 5749 4454 4878 4845 4947 4854 272c .'WIDTHxHEIGHT', │ │ │ │ -000221a0: 206f 7220 2757 4944 5448 7848 4549 4748 or 'WIDTHxHEIGH │ │ │ │ -000221b0: 5478 4445 5054 4827 2e0a 0a1f 0a46 696c TxDEPTH'.....Fil │ │ │ │ -000221c0: 653a 2067 7275 622e 696e 666f 2c20 204e e: grub.info, N │ │ │ │ -000221d0: 6f64 653a 2067 6678 7061 796c 6f61 642c ode: gfxpayload, │ │ │ │ -000221e0: 2020 4e65 7874 3a20 6766 7874 6572 6d5f Next: gfxterm_ │ │ │ │ -000221f0: 666f 6e74 2c20 2050 7265 763a 2067 6678 font, Prev: gfx │ │ │ │ -00022200: 6d6f 6465 2c20 2055 703a 2053 7065 6369 mode, Up: Speci │ │ │ │ -00022210: 616c 2065 6e76 6972 6f6e 6d65 6e74 2076 al environment v │ │ │ │ -00022220: 6172 6961 626c 6573 0a0a 3135 2e31 2e31 ariables..15.1.1 │ │ │ │ -00022230: 3320 6766 7870 6179 6c6f 6164 0a2d 2d2d 3 gfxpayload.--- │ │ │ │ -00022240: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a ---------------. │ │ │ │ -00022250: 0a49 6620 7468 6973 2076 6172 6961 626c .If this variabl │ │ │ │ -00022260: 6520 6973 2073 6574 2c20 6974 2063 6f6e e is set, it con │ │ │ │ -00022270: 7472 6f6c 7320 7468 6520 7669 6465 6f20 trols the video │ │ │ │ -00022280: 6d6f 6465 2069 6e20 7768 6963 6820 7468 mode in which th │ │ │ │ -00022290: 6520 4c69 6e75 780a 6b65 726e 656c 2073 e Linux.kernel s │ │ │ │ -000222a0: 7461 7274 7320 7570 2c20 7265 706c 6163 tarts up, replac │ │ │ │ -000222b0: 696e 6720 7468 6520 2776 6761 3d27 2062 ing the 'vga=' b │ │ │ │ -000222c0: 6f6f 7420 6f70 7469 6f6e 2028 2a6e 6f74 oot option (*not │ │ │ │ -000222d0: 6520 6c69 6e75 783a 3a29 2e20 2049 740a e linux::). It. │ │ │ │ -000222e0: 6d61 7920 6265 2073 6574 2074 6f20 2774 may be set to 't │ │ │ │ -000222f0: 6578 7427 2074 6f20 666f 7263 6520 7468 ext' to force th │ │ │ │ -00022300: 6520 4c69 6e75 7820 6b65 726e 656c 2074 e Linux kernel t │ │ │ │ -00022310: 6f20 626f 6f74 2069 6e20 6e6f 726d 616c o boot in normal │ │ │ │ -00022320: 2074 6578 740a 6d6f 6465 2c20 276b 6565 text.mode, 'kee │ │ │ │ -00022330: 7027 2074 6f20 7072 6573 6572 7665 2074 p' to preserve t │ │ │ │ -00022340: 6865 2067 7261 7068 6963 7320 6d6f 6465 he graphics mode │ │ │ │ -00022350: 2073 6574 2075 7369 6e67 2027 6766 786d set using 'gfxm │ │ │ │ -00022360: 6f64 6527 2c20 6f72 2061 6e79 0a6f 6620 ode', or any.of │ │ │ │ -00022370: 7468 6520 7065 726d 6974 7465 6420 7661 the permitted va │ │ │ │ -00022380: 6c75 6573 2066 6f72 2027 6766 786d 6f64 lues for 'gfxmod │ │ │ │ -00022390: 6527 2074 6f20 7365 7420 6120 7061 7274 e' to set a part │ │ │ │ -000223a0: 6963 756c 6172 2067 7261 7068 6963 7320 icular graphics │ │ │ │ -000223b0: 6d6f 6465 0a28 2a6e 6f74 6520 6766 786d mode.(*note gfxm │ │ │ │ -000223c0: 6f64 653a 3a29 2e0a 0a20 2020 4465 7065 ode::)... Depe │ │ │ │ -000223d0: 6e64 696e 6720 6f6e 2079 6f75 7220 6b65 nding on your ke │ │ │ │ -000223e0: 726e 656c 2c20 796f 7572 2064 6973 7472 rnel, your distr │ │ │ │ -000223f0: 6962 7574 696f 6e2c 2079 6f75 7220 6772 ibution, your gr │ │ │ │ -00022400: 6170 6869 6373 2063 6172 642c 2061 6e64 aphics card, and │ │ │ │ -00022410: 0a74 6865 2070 6861 7365 206f 6620 7468 .the phase of th │ │ │ │ -00022420: 6520 6d6f 6f6e 2c20 6e6f 7465 2074 6861 e moon, note tha │ │ │ │ -00022430: 7420 7573 696e 6720 7468 6973 206f 7074 t using this opt │ │ │ │ -00022440: 696f 6e20 6d61 7920 6361 7573 6520 474e ion may cause GN │ │ │ │ -00022450: 552f 4c69 6e75 780a 746f 2073 7566 6665 U/Linux.to suffe │ │ │ │ -00022460: 7220 6672 6f6d 2076 6172 696f 7573 2064 r from various d │ │ │ │ -00022470: 6973 706c 6179 2070 726f 626c 656d 732c isplay problems, │ │ │ │ -00022480: 2070 6172 7469 6375 6c61 726c 7920 6475 particularly du │ │ │ │ -00022490: 7269 6e67 2074 6865 2065 6172 6c79 0a70 ring the early.p │ │ │ │ -000224a0: 6172 7420 6f66 2074 6865 2062 6f6f 7420 art of the boot │ │ │ │ -000224b0: 7365 7175 656e 6365 2e20 2049 6620 796f sequence. If yo │ │ │ │ -000224c0: 7520 6861 7665 2070 726f 626c 656d 732c u have problems, │ │ │ │ -000224d0: 2073 6574 2074 6869 7320 7661 7269 6162 set this variab │ │ │ │ -000224e0: 6c65 2074 6f0a 2774 6578 7427 2061 6e64 le to.'text' and │ │ │ │ -000224f0: 2047 5255 4220 7769 6c6c 2074 656c 6c20 GRUB will tell │ │ │ │ -00022500: 4c69 6e75 7820 746f 2062 6f6f 7420 696e Linux to boot in │ │ │ │ -00022510: 206e 6f72 6d61 6c20 7465 7874 206d 6f64 normal text mod │ │ │ │ -00022520: 652e 0a0a 2020 2054 6865 2064 6566 6175 e... The defau │ │ │ │ -00022530: 6c74 2069 7320 706c 6174 666f 726d 2d73 lt is platform-s │ │ │ │ -00022540: 7065 6369 6669 632e 2020 4f6e 2070 6c61 pecific. On pla │ │ │ │ -00022550: 7466 6f72 6d73 2077 6974 6820 6120 6e61 tforms with a na │ │ │ │ -00022560: 7469 7665 2074 6578 740a 6d6f 6465 2028 tive text.mode ( │ │ │ │ -00022570: 7375 6368 2061 7320 5043 2042 494f 5320 such as PC BIOS │ │ │ │ -00022580: 706c 6174 666f 726d 7329 2c20 7468 6520 platforms), the │ │ │ │ -00022590: 6465 6661 756c 7420 6973 2027 7465 7874 default is 'text │ │ │ │ -000225a0: 272e 2020 4f74 6865 7277 6973 6520 7468 '. Otherwise th │ │ │ │ -000225b0: 650a 6465 6661 756c 7420 6d61 7920 6265 e.default may be │ │ │ │ -000225c0: 2027 6175 746f 2720 6f72 2061 2073 7065 'auto' or a spe │ │ │ │ -000225d0: 6369 6669 6320 7669 6465 6f20 6d6f 6465 cific video mode │ │ │ │ -000225e0: 2e0a 0a20 2020 5468 6973 2076 6172 6961 ... This varia │ │ │ │ -000225f0: 626c 6520 6973 206f 6674 656e 2073 6574 ble is often set │ │ │ │ -00022600: 2062 7920 2747 5255 425f 4746 5850 4159 by 'GRUB_GFXPAY │ │ │ │ -00022610: 4c4f 4144 5f4c 494e 5558 2720 282a 6e6f LOAD_LINUX' (*no │ │ │ │ -00022620: 7465 2053 696d 706c 650a 636f 6e66 6967 te Simple.config │ │ │ │ -00022630: 7572 6174 696f 6e3a 3a29 2e0a 0a1f 0a46 uration::).....F │ │ │ │ -00022640: 696c 653a 2067 7275 622e 696e 666f 2c20 ile: grub.info, │ │ │ │ -00022650: 204e 6f64 653a 2067 6678 7465 726d 5f66 Node: gfxterm_f │ │ │ │ -00022660: 6f6e 742c 2020 4e65 7874 3a20 6772 7562 ont, Next: grub │ │ │ │ -00022670: 5f63 7075 2c20 2050 7265 763a 2067 6678 _cpu, Prev: gfx │ │ │ │ -00022680: 7061 796c 6f61 642c 2020 5570 3a20 5370 payload, Up: Sp │ │ │ │ -00022690: 6563 6961 6c20 656e 7669 726f 6e6d 656e ecial environmen │ │ │ │ -000226a0: 7420 7661 7269 6162 6c65 730a 0a31 352e t variables..15. │ │ │ │ -000226b0: 312e 3134 2067 6678 7465 726d 5f66 6f6e 1.14 gfxterm_fon │ │ │ │ -000226c0: 740a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d t.-------------- │ │ │ │ -000226d0: 2d2d 2d2d 2d2d 0a0a 4966 2074 6869 7320 ------..If this │ │ │ │ -000226e0: 7661 7269 6162 6c65 2069 7320 7365 742c variable is set, │ │ │ │ -000226f0: 2069 7420 6e61 6d65 7320 6120 666f 6e74 it names a font │ │ │ │ -00022700: 2074 6f20 7573 6520 666f 7220 7465 7874 to use for text │ │ │ │ -00022710: 206f 6e20 7468 650a 2767 6678 7465 726d on the.'gfxterm │ │ │ │ -00022720: 2720 6772 6170 6869 6361 6c20 7465 726d ' graphical term │ │ │ │ -00022730: 696e 616c 2e20 204f 7468 6572 7769 7365 inal. Otherwise │ │ │ │ -00022740: 2c20 2767 6678 7465 726d 2720 6d61 7920 , 'gfxterm' may │ │ │ │ -00022750: 7573 6520 616e 790a 6176 6169 6c61 626c use any.availabl │ │ │ │ -00022760: 6520 666f 6e74 2e0a 0a1f 0a46 696c 653a e font.....File: │ │ │ │ -00022770: 2067 7275 622e 696e 666f 2c20 204e 6f64 grub.info, Nod │ │ │ │ -00022780: 653a 2067 7275 625f 6370 752c 2020 4e65 e: grub_cpu, Ne │ │ │ │ -00022790: 7874 3a20 6772 7562 5f70 6c61 7466 6f72 xt: grub_platfor │ │ │ │ -000227a0: 6d2c 2020 5072 6576 3a20 6766 7874 6572 m, Prev: gfxter │ │ │ │ -000227b0: 6d5f 666f 6e74 2c20 2055 703a 2053 7065 m_font, Up: Spe │ │ │ │ -000227c0: 6369 616c 2065 6e76 6972 6f6e 6d65 6e74 cial environment │ │ │ │ -000227d0: 2076 6172 6961 626c 6573 0a0a 3135 2e31 variables..15.1 │ │ │ │ -000227e0: 2e31 3520 6772 7562 5f63 7075 0a2d 2d2d .15 grub_cpu.--- │ │ │ │ -000227f0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a49 -------------..I │ │ │ │ -00022800: 6e20 6e6f 726d 616c 206d 6f64 6520 282a n normal mode (* │ │ │ │ -00022810: 6e6f 7465 206e 6f72 6d61 6c3a 3a29 2c20 note normal::), │ │ │ │ -00022820: 4752 5542 2073 6574 7320 7468 6520 2767 GRUB sets the 'g │ │ │ │ -00022830: 7275 625f 6370 7527 2076 6172 6961 626c rub_cpu' variabl │ │ │ │ -00022840: 6520 746f 0a74 6865 2043 5055 2074 7970 e to.the CPU typ │ │ │ │ -00022850: 6520 666f 7220 7768 6963 6820 4752 5542 e for which GRUB │ │ │ │ -00022860: 2077 6173 2062 7569 6c74 2028 652e 672e was built (e.g. │ │ │ │ -00022870: 2020 2769 3338 3627 206f 7220 2770 6f77 'i386' or 'pow │ │ │ │ -00022880: 6572 7063 2729 2e0a 0a1f 0a46 696c 653a erpc').....File: │ │ │ │ -00022890: 2067 7275 622e 696e 666f 2c20 204e 6f64 grub.info, Nod │ │ │ │ -000228a0: 653a 2067 7275 625f 706c 6174 666f 726d e: grub_platform │ │ │ │ -000228b0: 2c20 204e 6578 743a 2069 636f 6e64 6972 , Next: icondir │ │ │ │ -000228c0: 2c20 2050 7265 763a 2067 7275 625f 6370 , Prev: grub_cp │ │ │ │ -000228d0: 752c 2020 5570 3a20 5370 6563 6961 6c20 u, Up: Special │ │ │ │ -000228e0: 656e 7669 726f 6e6d 656e 7420 7661 7269 environment vari │ │ │ │ -000228f0: 6162 6c65 730a 0a31 352e 312e 3136 2067 ables..15.1.16 g │ │ │ │ -00022900: 7275 625f 706c 6174 666f 726d 0a2d 2d2d rub_platform.--- │ │ │ │ -00022910: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ -00022920: 2d2d 0a0a 496e 206e 6f72 6d61 6c20 6d6f --..In normal mo │ │ │ │ -00022930: 6465 2028 2a6e 6f74 6520 6e6f 726d 616c de (*note normal │ │ │ │ -00022940: 3a3a 292c 2047 5255 4220 7365 7473 2074 ::), GRUB sets t │ │ │ │ -00022950: 6865 2027 6772 7562 5f70 6c61 7466 6f72 he 'grub_platfor │ │ │ │ -00022960: 6d27 2076 6172 6961 626c 650a 746f 2074 m' variable.to t │ │ │ │ -00022970: 6865 2070 6c61 7466 6f72 6d20 666f 7220 he platform for │ │ │ │ -00022980: 7768 6963 6820 4752 5542 2077 6173 2062 which GRUB was b │ │ │ │ -00022990: 7569 6c74 2028 652e 672e 2020 2770 6327 uilt (e.g. 'pc' │ │ │ │ -000229a0: 206f 7220 2765 6669 2729 2e0a 0a1f 0a46 or 'efi').....F │ │ │ │ -000229b0: 696c 653a 2067 7275 622e 696e 666f 2c20 ile: grub.info, │ │ │ │ -000229c0: 204e 6f64 653a 2069 636f 6e64 6972 2c20 Node: icondir, │ │ │ │ -000229d0: 204e 6578 743a 206c 616e 672c 2020 5072 Next: lang, Pr │ │ │ │ -000229e0: 6576 3a20 6772 7562 5f70 6c61 7466 6f72 ev: grub_platfor │ │ │ │ -000229f0: 6d2c 2020 5570 3a20 5370 6563 6961 6c20 m, Up: Special │ │ │ │ -00022a00: 656e 7669 726f 6e6d 656e 7420 7661 7269 environment vari │ │ │ │ -00022a10: 6162 6c65 730a 0a31 352e 312e 3137 2069 ables..15.1.17 i │ │ │ │ -00022a20: 636f 6e64 6972 0a2d 2d2d 2d2d 2d2d 2d2d condir.--------- │ │ │ │ -00022a30: 2d2d 2d2d 2d2d 0a0a 4966 2074 6869 7320 ------..If this │ │ │ │ -00022a40: 7661 7269 6162 6c65 2069 7320 7365 742c variable is set, │ │ │ │ -00022a50: 2069 7420 6e61 6d65 7320 6120 6469 7265 it names a dire │ │ │ │ -00022a60: 6374 6f72 7920 696e 2077 6869 6368 2074 ctory in which t │ │ │ │ -00022a70: 6865 2047 5255 420a 6772 6170 6869 6361 he GRUB.graphica │ │ │ │ -00022a80: 6c20 6d65 6e75 2073 686f 756c 6420 6c6f l menu should lo │ │ │ │ -00022a90: 6f6b 2066 6f72 2069 636f 6e73 2061 6674 ok for icons aft │ │ │ │ -00022aa0: 6572 206c 6f6f 6b69 6e67 2069 6e20 7468 er looking in th │ │ │ │ -00022ab0: 6520 7468 656d 6527 730a 2769 636f 6e73 e theme's.'icons │ │ │ │ -00022ac0: 2720 6469 7265 6374 6f72 792e 2020 2a4e ' directory. *N │ │ │ │ -00022ad0: 6f74 6520 5468 656d 6520 6669 6c65 2066 ote Theme file f │ │ │ │ -00022ae0: 6f72 6d61 743a 3a2e 0a0a 1f0a 4669 6c65 ormat::.....File │ │ │ │ -00022af0: 3a20 6772 7562 2e69 6e66 6f2c 2020 4e6f : grub.info, No │ │ │ │ -00022b00: 6465 3a20 6c61 6e67 2c20 204e 6578 743a de: lang, Next: │ │ │ │ -00022b10: 206c 6f63 616c 655f 6469 722c 2020 5072 locale_dir, Pr │ │ │ │ -00022b20: 6576 3a20 6963 6f6e 6469 722c 2020 5570 ev: icondir, Up │ │ │ │ -00022b30: 3a20 5370 6563 6961 6c20 656e 7669 726f : Special enviro │ │ │ │ -00022b40: 6e6d 656e 7420 7661 7269 6162 6c65 730a nment variables. │ │ │ │ -00022b50: 0a31 352e 312e 3138 206c 616e 670a 2d2d .15.1.18 lang.-- │ │ │ │ -00022b60: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 4966 2074 ----------..If t │ │ │ │ -00022b70: 6869 7320 7661 7269 6162 6c65 2069 7320 his variable is │ │ │ │ -00022b80: 7365 742c 2069 7420 6e61 6d65 7320 7468 set, it names th │ │ │ │ -00022b90: 6520 6c61 6e67 7561 6765 2063 6f64 6520 e language code │ │ │ │ -00022ba0: 7468 6174 2074 6865 2027 6765 7474 6578 that the 'gettex │ │ │ │ -00022bb0: 7427 0a63 6f6d 6d61 6e64 2028 2a6e 6f74 t'.command (*not │ │ │ │ -00022bc0: 6520 6765 7474 6578 743a 3a29 2075 7365 e gettext::) use │ │ │ │ -00022bd0: 7320 746f 2074 7261 6e73 6c61 7465 2073 s to translate s │ │ │ │ -00022be0: 7472 696e 6773 2e20 2046 6f72 2065 7861 trings. For exa │ │ │ │ -00022bf0: 6d70 6c65 2c0a 4672 656e 6368 2077 6f75 mple,.French wou │ │ │ │ -00022c00: 6c64 2062 6520 6e61 6d65 6420 6173 2027 ld be named as ' │ │ │ │ -00022c10: 6672 272c 2061 6e64 2053 696d 706c 6966 fr', and Simplif │ │ │ │ -00022c20: 6965 6420 4368 696e 6573 6520 6173 2027 ied Chinese as ' │ │ │ │ -00022c30: 7a68 5f43 4e27 2e0a 0a20 2020 2767 7275 zh_CN'... 'gru │ │ │ │ -00022c40: 622d 6d6b 636f 6e66 6967 2720 282a 6e6f b-mkconfig' (*no │ │ │ │ -00022c50: 7465 2053 696d 706c 6520 636f 6e66 6967 te Simple config │ │ │ │ -00022c60: 7572 6174 696f 6e3a 3a29 2077 696c 6c20 uration::) will │ │ │ │ -00022c70: 7472 7920 746f 2073 6574 2061 0a72 6561 try to set a.rea │ │ │ │ -00022c80: 736f 6e61 626c 6520 6465 6661 756c 7420 sonable default │ │ │ │ -00022c90: 666f 7220 7468 6973 2076 6172 6961 626c for this variabl │ │ │ │ -00022ca0: 6520 6261 7365 6420 6f6e 2074 6865 2073 e based on the s │ │ │ │ -00022cb0: 7973 7465 6d20 6c6f 6361 6c65 2e0a 0a1f ystem locale.... │ │ │ │ -00022cc0: 0a46 696c 653a 2067 7275 622e 696e 666f .File: grub.info │ │ │ │ -00022cd0: 2c20 204e 6f64 653a 206c 6f63 616c 655f , Node: locale_ │ │ │ │ -00022ce0: 6469 722c 2020 4e65 7874 3a20 6d65 6e75 dir, Next: menu │ │ │ │ -00022cf0: 5f63 6f6c 6f72 5f68 6967 686c 6967 6874 _color_highlight │ │ │ │ -00022d00: 2c20 2050 7265 763a 206c 616e 672c 2020 , Prev: lang, │ │ │ │ -00022d10: 5570 3a20 5370 6563 6961 6c20 656e 7669 Up: Special envi │ │ │ │ -00022d20: 726f 6e6d 656e 7420 7661 7269 6162 6c65 ronment variable │ │ │ │ -00022d30: 730a 0a31 352e 312e 3139 206c 6f63 616c s..15.1.19 local │ │ │ │ -00022d40: 655f 6469 720a 2d2d 2d2d 2d2d 2d2d 2d2d e_dir.---------- │ │ │ │ -00022d50: 2d2d 2d2d 2d2d 2d2d 0a0a 4966 2074 6869 --------..If thi │ │ │ │ -00022d60: 7320 7661 7269 6162 6c65 2069 7320 7365 s variable is se │ │ │ │ -00022d70: 742c 2069 7420 6e61 6d65 7320 7468 6520 t, it names the │ │ │ │ -00022d80: 6469 7265 6374 6f72 7920 7768 6572 6520 directory where │ │ │ │ -00022d90: 7472 616e 736c 6174 696f 6e20 6669 6c65 translation file │ │ │ │ -00022da0: 730a 6d61 7920 6265 2066 6f75 6e64 2028 s.may be found ( │ │ │ │ -00022db0: 2a6e 6f74 6520 6765 7474 6578 743a 3a29 *note gettext::) │ │ │ │ -00022dc0: 2c20 7573 7561 6c6c 7920 272f 626f 6f74 , usually '/boot │ │ │ │ -00022dd0: 2f67 7275 622f 6c6f 6361 6c65 272e 2020 /grub/locale'. │ │ │ │ -00022de0: 4f74 6865 7277 6973 652c 0a69 6e74 6572 Otherwise,.inter │ │ │ │ -00022df0: 6e61 7469 6f6e 616c 697a 6174 696f 6e20 nationalization │ │ │ │ -00022e00: 6973 2064 6973 6162 6c65 642e 0a0a 2020 is disabled... │ │ │ │ -00022e10: 2027 6772 7562 2d6d 6b63 6f6e 6669 6727 'grub-mkconfig' │ │ │ │ -00022e20: 2028 2a6e 6f74 6520 5369 6d70 6c65 2063 (*note Simple c │ │ │ │ -00022e30: 6f6e 6669 6775 7261 7469 6f6e 3a3a 2920 onfiguration::) │ │ │ │ -00022e40: 7769 6c6c 2073 6574 2061 2072 6561 736f will set a reaso │ │ │ │ -00022e50: 6e61 626c 650a 6465 6661 756c 7420 666f nable.default fo │ │ │ │ -00022e60: 7220 7468 6973 2076 6172 6961 626c 6520 r this variable │ │ │ │ -00022e70: 6966 2069 6e74 6572 6e61 7469 6f6e 616c if international │ │ │ │ -00022e80: 697a 6174 696f 6e20 6973 206e 6565 6465 ization is neede │ │ │ │ -00022e90: 6420 616e 6420 616e 790a 7472 616e 736c d and any.transl │ │ │ │ -00022ea0: 6174 696f 6e20 6669 6c65 7320 6172 6520 ation files are │ │ │ │ -00022eb0: 6176 6169 6c61 626c 652e 0a0a 1f0a 4669 available.....Fi │ │ │ │ -00022ec0: 6c65 3a20 6772 7562 2e69 6e66 6f2c 2020 le: grub.info, │ │ │ │ -00022ed0: 4e6f 6465 3a20 6d65 6e75 5f63 6f6c 6f72 Node: menu_color │ │ │ │ -00022ee0: 5f68 6967 686c 6967 6874 2c20 204e 6578 _highlight, Nex │ │ │ │ -00022ef0: 743a 206d 656e 755f 636f 6c6f 725f 6e6f t: menu_color_no │ │ │ │ -00022f00: 726d 616c 2c20 2050 7265 763a 206c 6f63 rmal, Prev: loc │ │ │ │ -00022f10: 616c 655f 6469 722c 2020 5570 3a20 5370 ale_dir, Up: Sp │ │ │ │ -00022f20: 6563 6961 6c20 656e 7669 726f 6e6d 656e ecial environmen │ │ │ │ -00022f30: 7420 7661 7269 6162 6c65 730a 0a31 352e t variables..15. │ │ │ │ -00022f40: 312e 3230 206d 656e 755f 636f 6c6f 725f 1.20 menu_color_ │ │ │ │ -00022f50: 6869 6768 6c69 6768 740a 2d2d 2d2d 2d2d highlight.------ │ │ │ │ +00020130: 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a 5468 6573 ==========..Thes │ │ │ │ +00020140: 6520 7661 7269 6162 6c65 7320 6861 7665 e variables have │ │ │ │ +00020150: 2073 7065 6369 616c 206d 6561 6e69 6e67 special meaning │ │ │ │ +00020160: 2074 6f20 4752 5542 2e0a 0a2a 204d 656e to GRUB...* Men │ │ │ │ +00020170: 753a 0a0a 2a20 6269 6f73 6e75 6d3a 3a0a u:..* biosnum::. │ │ │ │ +00020180: 2a20 6368 6563 6b5f 7369 676e 6174 7572 * check_signatur │ │ │ │ +00020190: 6573 3a3a 0a2a 2063 686f 7365 6e3a 3a0a es::.* chosen::. │ │ │ │ +000201a0: 2a20 636d 6470 6174 683a 3a0a 2a20 636f * cmdpath::.* co │ │ │ │ +000201b0: 6c6f 725f 6869 6768 6c69 6768 743a 3a0a lor_highlight::. │ │ │ │ +000201c0: 2a20 636f 6c6f 725f 6e6f 726d 616c 3a3a * color_normal:: │ │ │ │ +000201d0: 0a2a 2063 6f6e 6669 675f 6469 7265 6374 .* config_direct │ │ │ │ +000201e0: 6f72 793a 3a0a 2a20 636f 6e66 6967 5f66 ory::.* config_f │ │ │ │ +000201f0: 696c 653a 3a0a 2a20 6465 6275 673a 3a0a ile::.* debug::. │ │ │ │ +00020200: 2a20 6465 6661 756c 743a 3a0a 2a20 6661 * default::.* fa │ │ │ │ +00020210: 6c6c 6261 636b 3a3a 0a2a 2067 6678 6d6f llback::.* gfxmo │ │ │ │ +00020220: 6465 3a3a 0a2a 2067 6678 7061 796c 6f61 de::.* gfxpayloa │ │ │ │ +00020230: 643a 3a0a 2a20 6766 7874 6572 6d5f 666f d::.* gfxterm_fo │ │ │ │ +00020240: 6e74 3a3a 0a2a 2067 7275 625f 6370 753a nt::.* grub_cpu: │ │ │ │ +00020250: 3a0a 2a20 6772 7562 5f70 6c61 7466 6f72 :.* grub_platfor │ │ │ │ +00020260: 6d3a 3a0a 2a20 6963 6f6e 6469 723a 3a0a m::.* icondir::. │ │ │ │ +00020270: 2a20 6c61 6e67 3a3a 0a2a 206c 6f63 616c * lang::.* local │ │ │ │ +00020280: 655f 6469 723a 3a0a 2a20 6d65 6e75 5f63 e_dir::.* menu_c │ │ │ │ +00020290: 6f6c 6f72 5f68 6967 686c 6967 6874 3a3a olor_highlight:: │ │ │ │ +000202a0: 0a2a 206d 656e 755f 636f 6c6f 725f 6e6f .* menu_color_no │ │ │ │ +000202b0: 726d 616c 3a3a 0a2a 206e 6574 5f3c 494e rmal::.* net__boot_fi │ │ │ │ +000202d0: 6c65 3a3a 0a2a 206e 6574 5f3c 494e 5445 le::.* net__dhcp_serv │ │ │ │ +000202f0: 6572 5f6e 616d 653a 3a0a 2a20 6e65 745f er_name::.* net_ │ │ │ │ +00020300: 3c49 4e54 4552 4641 4345 3e5f 646f 6d61 _doma │ │ │ │ +00020310: 696e 3a3a 0a2a 206e 6574 5f3c 494e 5445 in::.* net__extension │ │ │ │ +00020330: 7370 6174 683a 3a0a 2a20 6e65 745f 3c49 spath::.* net__hostna │ │ │ │ +00020350: 6d65 3a3a 0a2a 206e 6574 5f3c 494e 5445 me::.* net__ip::.* ne │ │ │ │ +00020370: 745f 3c49 4e54 4552 4641 4345 3e5f 6d61 t__ma │ │ │ │ +00020380: 633a 3a0a 2a20 6e65 745f 3c49 4e54 4552 c::.* net__next_serve │ │ │ │ +000203a0: 723a 3a0a 2a20 6e65 745f 3c49 4e54 4552 r::.* net__rootpath:: │ │ │ │ +000203c0: 0a2a 206e 6574 5f64 6566 6175 6c74 5f69 .* net_default_i │ │ │ │ +000203d0: 6e74 6572 6661 6365 3a3a 0a2a 206e 6574 nterface::.* net │ │ │ │ +000203e0: 5f64 6566 6175 6c74 5f69 703a 3a0a 2a20 _default_ip::.* │ │ │ │ +000203f0: 6e65 745f 6465 6661 756c 745f 6d61 633a net_default_mac: │ │ │ │ +00020400: 3a0a 2a20 6e65 745f 6465 6661 756c 745f :.* net_default_ │ │ │ │ +00020410: 7365 7276 6572 3a3a 0a2a 2070 6167 6572 server::.* pager │ │ │ │ +00020420: 3a3a 0a2a 2070 7265 6669 783a 3a0a 2a20 ::.* prefix::.* │ │ │ │ +00020430: 7078 655f 626c 6b73 697a 653a 3a0a 2a20 pxe_blksize::.* │ │ │ │ +00020440: 7078 655f 6465 6661 756c 745f 6761 7465 pxe_default_gate │ │ │ │ +00020450: 7761 793a 3a0a 2a20 7078 655f 6465 6661 way::.* pxe_defa │ │ │ │ +00020460: 756c 745f 7365 7276 6572 3a3a 0a2a 2072 ult_server::.* r │ │ │ │ +00020470: 6f6f 743a 3a0a 2a20 7375 7065 7275 7365 oot::.* superuse │ │ │ │ +00020480: 7273 3a3a 0a2a 2074 6865 6d65 3a3a 0a2a rs::.* theme::.* │ │ │ │ +00020490: 2074 696d 656f 7574 3a3a 0a2a 2074 696d timeout::.* tim │ │ │ │ +000204a0: 656f 7574 5f73 7479 6c65 3a3a 0a0a 1f0a eout_style::.... │ │ │ │ +000204b0: 4669 6c65 3a20 6772 7562 2e69 6e66 6f2c File: grub.info, │ │ │ │ +000204c0: 2020 4e6f 6465 3a20 6269 6f73 6e75 6d2c Node: biosnum, │ │ │ │ +000204d0: 2020 4e65 7874 3a20 6368 6563 6b5f 7369 Next: check_si │ │ │ │ +000204e0: 676e 6174 7572 6573 2c20 2055 703a 2053 gnatures, Up: S │ │ │ │ +000204f0: 7065 6369 616c 2065 6e76 6972 6f6e 6d65 pecial environme │ │ │ │ +00020500: 6e74 2076 6172 6961 626c 6573 0a0a 3135 nt variables..15 │ │ │ │ +00020510: 2e31 2e31 2062 696f 736e 756d 0a2d 2d2d .1.1 biosnum.--- │ │ │ │ +00020520: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a57 6865 -----------..Whe │ │ │ │ +00020530: 6e20 6368 6169 6e2d 6c6f 6164 696e 6720 n chain-loading │ │ │ │ +00020540: 616e 6f74 6865 7220 626f 6f74 206c 6f61 another boot loa │ │ │ │ +00020550: 6465 7220 282a 6e6f 7465 2043 6861 696e der (*note Chain │ │ │ │ +00020560: 2d6c 6f61 6469 6e67 3a3a 292c 2047 5255 -loading::), GRU │ │ │ │ +00020570: 4220 6d61 790a 6e65 6564 2074 6f20 6b6e B may.need to kn │ │ │ │ +00020580: 6f77 2077 6861 7420 4249 4f53 2064 7269 ow what BIOS dri │ │ │ │ +00020590: 7665 206e 756d 6265 7220 636f 7272 6573 ve number corres │ │ │ │ +000205a0: 706f 6e64 7320 746f 2074 6865 2072 6f6f ponds to the roo │ │ │ │ +000205b0: 7420 6465 7669 6365 0a28 2a6e 6f74 6520 t device.(*note │ │ │ │ +000205c0: 726f 6f74 3a3a 2920 736f 2074 6861 7420 root::) so that │ │ │ │ +000205d0: 6974 2063 616e 2073 6574 2075 7020 7265 it can set up re │ │ │ │ +000205e0: 6769 7374 6572 7320 7072 6f70 6572 6c79 gisters properly │ │ │ │ +000205f0: 2e20 2049 6620 7468 6520 4249 4f53 4e55 . If the BIOSNU │ │ │ │ +00020600: 4d0a 7661 7269 6162 6c65 2069 7320 7365 M.variable is se │ │ │ │ +00020610: 742c 2069 7420 6f76 6572 7269 6465 7320 t, it overrides │ │ │ │ +00020620: 4752 5542 2773 206f 776e 206d 6561 6e73 GRUB's own means │ │ │ │ +00020630: 206f 6620 6775 6573 7369 6e67 2074 6869 of guessing thi │ │ │ │ +00020640: 732e 0a0a 2020 2046 6f72 2061 6e20 616c s... For an al │ │ │ │ +00020650: 7465 726e 6174 6976 6520 6170 7072 6f61 ternative approa │ │ │ │ +00020660: 6368 2077 6869 6368 2061 6c73 6f20 6368 ch which also ch │ │ │ │ +00020670: 616e 6765 7320 4249 4f53 2064 7269 7665 anges BIOS drive │ │ │ │ +00020680: 206d 6170 7069 6e67 730a 666f 7220 7468 mappings.for th │ │ │ │ +00020690: 6520 6368 6169 6e2d 6c6f 6164 6564 2073 e chain-loaded s │ │ │ │ +000206a0: 7973 7465 6d2c 202a 6e6f 7465 2064 7269 ystem, *note dri │ │ │ │ +000206b0: 7665 6d61 703a 3a2e 0a0a 1f0a 4669 6c65 vemap::.....File │ │ │ │ +000206c0: 3a20 6772 7562 2e69 6e66 6f2c 2020 4e6f : grub.info, No │ │ │ │ +000206d0: 6465 3a20 6368 6563 6b5f 7369 676e 6174 de: check_signat │ │ │ │ +000206e0: 7572 6573 2c20 204e 6578 743a 2063 686f ures, Next: cho │ │ │ │ +000206f0: 7365 6e2c 2020 5072 6576 3a20 6269 6f73 sen, Prev: bios │ │ │ │ +00020700: 6e75 6d2c 2020 5570 3a20 5370 6563 6961 num, Up: Specia │ │ │ │ +00020710: 6c20 656e 7669 726f 6e6d 656e 7420 7661 l environment va │ │ │ │ +00020720: 7269 6162 6c65 730a 0a31 352e 312e 3220 riables..15.1.2 │ │ │ │ +00020730: 6368 6563 6b5f 7369 676e 6174 7572 6573 check_signatures │ │ │ │ +00020740: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d .--------------- │ │ │ │ +00020750: 2d2d 2d2d 2d2d 2d2d 0a0a 5468 6973 2076 --------..This v │ │ │ │ +00020760: 6172 6961 626c 6520 636f 6e74 726f 6c73 ariable controls │ │ │ │ +00020770: 2077 6865 7468 6572 2047 5255 4220 656e whether GRUB en │ │ │ │ +00020780: 666f 7263 6573 2064 6967 6974 616c 2073 forces digital s │ │ │ │ +00020790: 6967 6e61 7475 7265 0a76 616c 6964 6174 ignature.validat │ │ │ │ +000207a0: 696f 6e20 6f6e 206c 6f61 6465 6420 6669 ion on loaded fi │ │ │ │ +000207b0: 6c65 732e 2020 2a4e 6f74 6520 5573 696e les. *Note Usin │ │ │ │ +000207c0: 6720 6469 6769 7461 6c20 7369 676e 6174 g digital signat │ │ │ │ +000207d0: 7572 6573 3a3a 2e0a 0a1f 0a46 696c 653a ures::.....File: │ │ │ │ +000207e0: 2067 7275 622e 696e 666f 2c20 204e 6f64 grub.info, Nod │ │ │ │ +000207f0: 653a 2063 686f 7365 6e2c 2020 4e65 7874 e: chosen, Next │ │ │ │ +00020800: 3a20 636d 6470 6174 682c 2020 5072 6576 : cmdpath, Prev │ │ │ │ +00020810: 3a20 6368 6563 6b5f 7369 676e 6174 7572 : check_signatur │ │ │ │ +00020820: 6573 2c20 2055 703a 2053 7065 6369 616c es, Up: Special │ │ │ │ +00020830: 2065 6e76 6972 6f6e 6d65 6e74 2076 6172 environment var │ │ │ │ +00020840: 6961 626c 6573 0a0a 3135 2e31 2e33 2063 iables..15.1.3 c │ │ │ │ +00020850: 686f 7365 6e0a 2d2d 2d2d 2d2d 2d2d 2d2d hosen.---------- │ │ │ │ +00020860: 2d2d 2d0a 0a57 6865 6e20 6578 6563 7574 ---..When execut │ │ │ │ +00020870: 696e 6720 6120 6d65 6e75 2065 6e74 7279 ing a menu entry │ │ │ │ +00020880: 2c20 4752 5542 2073 6574 7320 7468 6520 , GRUB sets the │ │ │ │ +00020890: 4348 4f53 454e 2076 6172 6961 626c 6520 CHOSEN variable │ │ │ │ +000208a0: 746f 2074 6865 2074 6974 6c65 0a6f 6620 to the title.of │ │ │ │ +000208b0: 7468 6520 656e 7472 7920 6265 696e 6720 the entry being │ │ │ │ +000208c0: 6578 6563 7574 6564 2e0a 0a20 2020 4966 executed... If │ │ │ │ +000208d0: 2074 6865 206d 656e 7520 656e 7472 7920 the menu entry │ │ │ │ +000208e0: 6973 2069 6e20 6f6e 6520 6f72 206d 6f72 is in one or mor │ │ │ │ +000208f0: 6520 7375 626d 656e 7573 2c20 7468 656e e submenus, then │ │ │ │ +00020900: 2043 484f 5345 4e20 6973 2073 6574 2074 CHOSEN is set t │ │ │ │ +00020910: 6f0a 7468 6520 7469 746c 6573 206f 6620 o.the titles of │ │ │ │ +00020920: 6561 6368 206f 6620 7468 6520 7375 626d each of the subm │ │ │ │ +00020930: 656e 7573 2073 7461 7274 696e 6720 6672 enus starting fr │ │ │ │ +00020940: 6f6d 2074 6865 2074 6f70 206c 6576 656c om the top level │ │ │ │ +00020950: 2066 6f6c 6c6f 7765 640a 6279 2074 6865 followed.by the │ │ │ │ +00020960: 2074 6974 6c65 206f 6620 7468 6520 6d65 title of the me │ │ │ │ +00020970: 6e75 2065 6e74 7279 2069 7473 656c 662c nu entry itself, │ │ │ │ +00020980: 2073 6570 6172 6174 6564 2062 7920 273e separated by '> │ │ │ │ +00020990: 272e 0a0a 1f0a 4669 6c65 3a20 6772 7562 '.....File: grub │ │ │ │ +000209a0: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 636d .info, Node: cm │ │ │ │ +000209b0: 6470 6174 682c 2020 4e65 7874 3a20 636f dpath, Next: co │ │ │ │ +000209c0: 6c6f 725f 6869 6768 6c69 6768 742c 2020 lor_highlight, │ │ │ │ +000209d0: 5072 6576 3a20 6368 6f73 656e 2c20 2055 Prev: chosen, U │ │ │ │ +000209e0: 703a 2053 7065 6369 616c 2065 6e76 6972 p: Special envir │ │ │ │ +000209f0: 6f6e 6d65 6e74 2076 6172 6961 626c 6573 onment variables │ │ │ │ +00020a00: 0a0a 3135 2e31 2e34 2063 6d64 7061 7468 ..15.1.4 cmdpath │ │ │ │ +00020a10: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a .--------------. │ │ │ │ +00020a20: 0a54 6865 206c 6f63 6174 696f 6e20 6672 .The location fr │ │ │ │ +00020a30: 6f6d 2077 6869 6368 2027 636f 7265 2e69 om which 'core.i │ │ │ │ +00020a40: 6d67 2720 7761 7320 6c6f 6164 6564 2061 mg' was loaded a │ │ │ │ +00020a50: 7320 616e 2061 6273 6f6c 7574 6520 6469 s an absolute di │ │ │ │ +00020a60: 7265 6374 6f72 790a 6e61 6d65 2028 2a6e rectory.name (*n │ │ │ │ +00020a70: 6f74 6520 4669 6c65 206e 616d 6520 7379 ote File name sy │ │ │ │ +00020a80: 6e74 6178 3a3a 292e 2020 5468 6973 2069 ntax::). This i │ │ │ │ +00020a90: 7320 7365 7420 6279 2047 5255 4220 6174 s set by GRUB at │ │ │ │ +00020aa0: 2073 7461 7274 7570 2062 6173 6564 0a6f startup based.o │ │ │ │ +00020ab0: 6e20 696e 666f 726d 6174 696f 6e20 7265 n information re │ │ │ │ +00020ac0: 7475 726e 6564 2062 7920 706c 6174 666f turned by platfo │ │ │ │ +00020ad0: 726d 2066 6972 6d77 6172 652e 2020 4e6f rm firmware. No │ │ │ │ +00020ae0: 7420 6576 6572 7920 706c 6174 666f 726d t every platform │ │ │ │ +00020af0: 0a70 726f 7669 6465 7320 7468 6973 2069 .provides this i │ │ │ │ +00020b00: 6e66 6f72 6d61 7469 6f6e 2061 6e64 2073 nformation and s │ │ │ │ +00020b10: 6f6d 6520 6d61 7920 7265 7475 726e 206f ome may return o │ │ │ │ +00020b20: 6e6c 7920 6465 7669 6365 2077 6974 686f nly device witho │ │ │ │ +00020b30: 7574 2070 6174 680a 6e61 6d65 2e0a 0a1f ut path.name.... │ │ │ │ +00020b40: 0a46 696c 653a 2067 7275 622e 696e 666f .File: grub.info │ │ │ │ +00020b50: 2c20 204e 6f64 653a 2063 6f6c 6f72 5f68 , Node: color_h │ │ │ │ +00020b60: 6967 686c 6967 6874 2c20 204e 6578 743a ighlight, Next: │ │ │ │ +00020b70: 2063 6f6c 6f72 5f6e 6f72 6d61 6c2c 2020 color_normal, │ │ │ │ +00020b80: 5072 6576 3a20 636d 6470 6174 682c 2020 Prev: cmdpath, │ │ │ │ +00020b90: 5570 3a20 5370 6563 6961 6c20 656e 7669 Up: Special envi │ │ │ │ +00020ba0: 726f 6e6d 656e 7420 7661 7269 6162 6c65 ronment variable │ │ │ │ +00020bb0: 730a 0a31 352e 312e 3520 636f 6c6f 725f s..15.1.5 color_ │ │ │ │ +00020bc0: 6869 6768 6c69 6768 740a 2d2d 2d2d 2d2d highlight.------ │ │ │ │ +00020bd0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ +00020be0: 0a0a 5468 6973 2076 6172 6961 626c 6520 ..This variable │ │ │ │ +00020bf0: 636f 6e74 6169 6e73 2074 6865 2022 6869 contains the "hi │ │ │ │ +00020c00: 6768 6c69 6768 7422 2066 6f72 6567 726f ghlight" foregro │ │ │ │ +00020c10: 756e 6420 616e 6420 6261 636b 6772 6f75 und and backgrou │ │ │ │ +00020c20: 6e64 0a74 6572 6d69 6e61 6c20 636f 6c6f nd.terminal colo │ │ │ │ +00020c30: 7273 2c20 7365 7061 7261 7465 6420 6279 rs, separated by │ │ │ │ +00020c40: 2061 2073 6c61 7368 2028 272f 2729 2e20 a slash ('/'). │ │ │ │ +00020c50: 2053 6574 7469 6e67 2074 6869 7320 7661 Setting this va │ │ │ │ +00020c60: 7269 6162 6c65 0a63 6861 6e67 6573 2074 riable.changes t │ │ │ │ +00020c70: 686f 7365 2063 6f6c 6f72 732e 2020 466f hose colors. Fo │ │ │ │ +00020c80: 7220 7468 6520 6176 6169 6c61 626c 6520 r the available │ │ │ │ +00020c90: 636f 6c6f 7220 6e61 6d65 732c 202a 6e6f color names, *no │ │ │ │ +00020ca0: 7465 0a63 6f6c 6f72 5f6e 6f72 6d61 6c3a te.color_normal: │ │ │ │ +00020cb0: 3a2e 0a0a 2020 2054 6865 2064 6566 6175 :... The defau │ │ │ │ +00020cc0: 6c74 2069 7320 2762 6c61 636b 2f6c 6967 lt is 'black/lig │ │ │ │ +00020cd0: 6874 2d67 7261 7927 2e0a 0a1f 0a46 696c ht-gray'.....Fil │ │ │ │ +00020ce0: 653a 2067 7275 622e 696e 666f 2c20 204e e: grub.info, N │ │ │ │ +00020cf0: 6f64 653a 2063 6f6c 6f72 5f6e 6f72 6d61 ode: color_norma │ │ │ │ +00020d00: 6c2c 2020 4e65 7874 3a20 636f 6e66 6967 l, Next: config │ │ │ │ +00020d10: 5f64 6972 6563 746f 7279 2c20 2050 7265 _directory, Pre │ │ │ │ +00020d20: 763a 2063 6f6c 6f72 5f68 6967 686c 6967 v: color_highlig │ │ │ │ +00020d30: 6874 2c20 2055 703a 2053 7065 6369 616c ht, Up: Special │ │ │ │ +00020d40: 2065 6e76 6972 6f6e 6d65 6e74 2076 6172 environment var │ │ │ │ +00020d50: 6961 626c 6573 0a0a 3135 2e31 2e36 2063 iables..15.1.6 c │ │ │ │ +00020d60: 6f6c 6f72 5f6e 6f72 6d61 6c0a 2d2d 2d2d olor_normal.---- │ │ │ │ +00020d70: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a ---------------. │ │ │ │ +00020d80: 0a54 6869 7320 7661 7269 6162 6c65 2063 .This variable c │ │ │ │ +00020d90: 6f6e 7461 696e 7320 7468 6520 226e 6f72 ontains the "nor │ │ │ │ +00020da0: 6d61 6c22 2066 6f72 6567 726f 756e 6420 mal" foreground │ │ │ │ +00020db0: 616e 6420 6261 636b 6772 6f75 6e64 2074 and background t │ │ │ │ +00020dc0: 6572 6d69 6e61 6c0a 636f 6c6f 7273 2c20 erminal.colors, │ │ │ │ +00020dd0: 7365 7061 7261 7465 6420 6279 2061 2073 separated by a s │ │ │ │ +00020de0: 6c61 7368 2028 272f 2729 2e20 2053 6574 lash ('/'). Set │ │ │ │ +00020df0: 7469 6e67 2074 6869 7320 7661 7269 6162 ting this variab │ │ │ │ +00020e00: 6c65 2063 6861 6e67 6573 2074 686f 7365 le changes those │ │ │ │ +00020e10: 0a63 6f6c 6f72 732e 2020 4561 6368 2063 .colors. Each c │ │ │ │ +00020e20: 6f6c 6f72 206d 7573 7420 6265 2061 206e olor must be a n │ │ │ │ +00020e30: 616d 6520 6672 6f6d 2074 6865 2066 6f6c ame from the fol │ │ │ │ +00020e40: 6c6f 7769 6e67 206c 6973 743a 0a0a 2020 lowing list:.. │ │ │ │ +00020e50: 202a 2062 6c61 636b 0a20 2020 2a20 626c * black. * bl │ │ │ │ +00020e60: 7565 0a20 2020 2a20 6772 6565 6e0a 2020 ue. * green. │ │ │ │ +00020e70: 202a 2063 7961 6e0a 2020 202a 2072 6564 * cyan. * red │ │ │ │ +00020e80: 0a20 2020 2a20 6d61 6765 6e74 610a 2020 . * magenta. │ │ │ │ +00020e90: 202a 2062 726f 776e 0a20 2020 2a20 6c69 * brown. * li │ │ │ │ +00020ea0: 6768 742d 6772 6179 0a20 2020 2a20 6461 ght-gray. * da │ │ │ │ +00020eb0: 726b 2d67 7261 790a 2020 202a 206c 6967 rk-gray. * lig │ │ │ │ +00020ec0: 6874 2d62 6c75 650a 2020 202a 206c 6967 ht-blue. * lig │ │ │ │ +00020ed0: 6874 2d67 7265 656e 0a20 2020 2a20 6c69 ht-green. * li │ │ │ │ +00020ee0: 6768 742d 6379 616e 0a20 2020 2a20 6c69 ght-cyan. * li │ │ │ │ +00020ef0: 6768 742d 7265 640a 2020 202a 206c 6967 ght-red. * lig │ │ │ │ +00020f00: 6874 2d6d 6167 656e 7461 0a20 2020 2a20 ht-magenta. * │ │ │ │ +00020f10: 7965 6c6c 6f77 0a20 2020 2a20 7768 6974 yellow. * whit │ │ │ │ +00020f20: 650a 0a20 2020 5468 6520 6465 6661 756c e.. The defaul │ │ │ │ +00020f30: 7420 6973 2027 6c69 6768 742d 6772 6179 t is 'light-gray │ │ │ │ +00020f40: 2f62 6c61 636b 272e 0a0a 2020 2054 6865 /black'... The │ │ │ │ +00020f50: 2063 6f6c 6f72 2073 7570 706f 7274 2073 color support s │ │ │ │ +00020f60: 7570 706f 7274 2076 6172 6965 7320 6672 upport varies fr │ │ │ │ +00020f70: 6f6d 2074 6572 6d69 6e61 6c20 746f 2074 om terminal to t │ │ │ │ +00020f80: 6572 6d69 6e61 6c2e 0a0a 2020 2027 6d6f erminal... 'mo │ │ │ │ +00020f90: 7273 6527 2068 6173 206e 6f20 636f 6c6f rse' has no colo │ │ │ │ +00020fa0: 7220 7375 7070 6f72 7420 6174 2061 6c6c r support at all │ │ │ │ +00020fb0: 2e0a 0a20 2020 276d 6461 5f74 6578 7427 ... 'mda_text' │ │ │ │ +00020fc0: 2063 6f6c 6f72 2073 7570 706f 7274 2069 color support i │ │ │ │ +00020fd0: 7320 6c69 6d69 7465 6420 746f 2068 6967 s limited to hig │ │ │ │ +00020fe0: 686c 6967 6874 696e 6720 6279 2062 6c61 hlighting by bla │ │ │ │ +00020ff0: 636b 2f77 6869 7465 0a72 6576 6572 7361 ck/white.reversa │ │ │ │ +00021000: 6c2e 0a0a 2020 2027 636f 6e73 6f6c 6527 l... 'console' │ │ │ │ +00021010: 206f 6e20 4152 432c 2045 4d55 2061 6e64 on ARC, EMU and │ │ │ │ +00021020: 2049 4545 4531 3237 352c 2027 7365 7269 IEEE1275, 'seri │ │ │ │ +00021030: 616c 5f2a 2720 616e 6420 2773 706b 6d6f al_*' and 'spkmo │ │ │ │ +00021040: 6465 6d27 2061 7265 0a67 6f76 6572 6e65 dem' are.governe │ │ │ │ +00021050: 6420 6279 2074 6572 6d69 6e66 6f20 616e d by terminfo an │ │ │ │ +00021060: 6420 7375 7070 6f72 7420 6f6e 6c79 2038 d support only 8 │ │ │ │ +00021070: 2063 6f6c 6f72 7320 6966 2069 6e20 6d6f colors if in mo │ │ │ │ +00021080: 6465 7320 2776 7431 3030 2d63 6f6c 6f72 des 'vt100-color │ │ │ │ +00021090: 270a 2864 6566 6175 6c74 2066 6f72 2063 '.(default for c │ │ │ │ +000210a0: 6f6e 736f 6c65 206f 6e20 656d 7529 2c20 onsole on emu), │ │ │ │ +000210b0: 2761 7263 2720 2864 6566 6175 6c74 2066 'arc' (default f │ │ │ │ +000210c0: 6f72 2063 6f6e 736f 6c65 206f 6e20 4152 or console on AR │ │ │ │ +000210d0: 4329 2c0a 2769 6565 6531 3237 3527 2028 C),.'ieee1275' ( │ │ │ │ +000210e0: 6465 6661 756c 7420 666f 7220 636f 6e73 default for cons │ │ │ │ +000210f0: 6f6c 6520 6f6e 2049 4545 4531 3237 3529 ole on IEEE1275) │ │ │ │ +00021100: 2e20 2057 6865 6e20 696e 206d 6f64 6520 . When in mode │ │ │ │ +00021110: 2776 7431 3030 2720 7468 656e 0a74 6865 'vt100' then.the │ │ │ │ +00021120: 2063 6f6c 6f72 2073 7570 706f 7274 2069 color support i │ │ │ │ +00021130: 7320 6c69 6d69 7465 6420 746f 2068 6967 s limited to hig │ │ │ │ +00021140: 686c 6967 6874 696e 6720 6279 2062 6c61 hlighting by bla │ │ │ │ +00021150: 636b 2f77 6869 7465 2072 6576 6572 7361 ck/white reversa │ │ │ │ +00021160: 6c2e 0a57 6865 6e20 696e 206d 6f64 6520 l..When in mode │ │ │ │ +00021170: 2764 756d 6227 2074 6865 7265 2069 7320 'dumb' there is │ │ │ │ +00021180: 6e6f 2063 6f6c 6f72 2073 7570 706f 7274 no color support │ │ │ │ +00021190: 2e0a 0a20 2020 5768 656e 2063 6f6e 736f ... When conso │ │ │ │ +000211a0: 6c65 2073 7570 706f 7274 7320 6e6f 2063 le supports no c │ │ │ │ +000211b0: 6f6c 6f72 7320 7468 6973 2073 6574 7469 olors this setti │ │ │ │ +000211c0: 6e67 2069 7320 6967 6e6f 7265 642e 2020 ng is ignored. │ │ │ │ +000211d0: 5768 656e 0a63 6f6e 736f 6c65 2073 7570 When.console sup │ │ │ │ +000211e0: 706f 7274 7320 3820 636f 6c6f 7273 2c20 ports 8 colors, │ │ │ │ +000211f0: 7468 656e 2074 6865 2063 6f6c 6f72 7320 then the colors │ │ │ │ +00021200: 6672 6f6d 2074 6865 2073 6563 6f6e 6420 from the second │ │ │ │ +00021210: 6861 6c66 206f 6620 7468 650a 7072 6576 half of the.prev │ │ │ │ +00021220: 696f 7573 206c 6973 7420 6172 6520 6d61 ious list are ma │ │ │ │ +00021230: 7070 6564 2074 6f20 7468 6520 6d61 7463 pped to the matc │ │ │ │ +00021240: 6869 6e67 2063 6f6c 6f72 7320 6f66 2066 hing colors of f │ │ │ │ +00021250: 6972 7374 2068 616c 662e 0a0a 2020 2027 irst half... ' │ │ │ │ +00021260: 636f 6e73 6f6c 6527 206f 6e20 4546 4920 console' on EFI │ │ │ │ +00021270: 616e 6420 4249 4f53 2061 6e64 2027 7667 and BIOS and 'vg │ │ │ │ +00021280: 615f 7465 7874 2720 7375 7070 6f72 7420 a_text' support │ │ │ │ +00021290: 616c 6c20 3136 2063 6f6c 6f72 732e 0a0a all 16 colors... │ │ │ │ +000212a0: 2020 2027 6766 7874 6572 6d27 2073 7570 'gfxterm' sup │ │ │ │ +000212b0: 706f 7274 7320 616c 6c20 3136 2063 6f6c ports all 16 col │ │ │ │ +000212c0: 6f72 7320 616e 6420 776f 756c 6420 6265 ors and would be │ │ │ │ +000212d0: 2074 6865 6f72 6574 6963 616c 6c79 0a65 theoretically.e │ │ │ │ +000212e0: 7874 656e 6461 626c 6520 746f 2073 7570 xtendable to sup │ │ │ │ +000212f0: 706f 7274 2077 686f 6c65 2072 6762 3234 port whole rgb24 │ │ │ │ +00021300: 2070 616c 6574 7465 2062 7574 2063 7572 palette but cur │ │ │ │ +00021310: 7265 6e74 6c79 2074 6865 7265 2069 7320 rently there is │ │ │ │ +00021320: 6e6f 0a63 6f6d 7065 6c6c 696e 6720 7265 no.compelling re │ │ │ │ +00021330: 6173 6f6e 2074 6f20 676f 2062 6579 6f6e ason to go beyon │ │ │ │ +00021340: 6420 7468 6520 6375 7272 656e 7420 3136 d the current 16 │ │ │ │ +00021350: 2063 6f6c 6f72 732e 0a0a 1f0a 4669 6c65 colors.....File │ │ │ │ +00021360: 3a20 6772 7562 2e69 6e66 6f2c 2020 4e6f : grub.info, No │ │ │ │ +00021370: 6465 3a20 636f 6e66 6967 5f64 6972 6563 de: config_direc │ │ │ │ +00021380: 746f 7279 2c20 204e 6578 743a 2063 6f6e tory, Next: con │ │ │ │ +00021390: 6669 675f 6669 6c65 2c20 2050 7265 763a fig_file, Prev: │ │ │ │ +000213a0: 2063 6f6c 6f72 5f6e 6f72 6d61 6c2c 2020 color_normal, │ │ │ │ +000213b0: 5570 3a20 5370 6563 6961 6c20 656e 7669 Up: Special envi │ │ │ │ +000213c0: 726f 6e6d 656e 7420 7661 7269 6162 6c65 ronment variable │ │ │ │ +000213d0: 730a 0a31 352e 312e 3720 636f 6e66 6967 s..15.1.7 config │ │ │ │ +000213e0: 5f64 6972 6563 746f 7279 0a2d 2d2d 2d2d _directory.----- │ │ │ │ +000213f0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ +00021400: 2d2d 0a0a 5468 6973 2076 6172 6961 626c --..This variabl │ │ │ │ +00021410: 6520 6973 2061 7574 6f6d 6174 6963 616c e is automatical │ │ │ │ +00021420: 6c79 2073 6574 2062 7920 4752 5542 2074 ly set by GRUB t │ │ │ │ +00021430: 6f20 7468 6520 6469 7265 6374 6f72 7920 o the directory │ │ │ │ +00021440: 7061 7274 206f 660a 6375 7272 656e 7420 part of.current │ │ │ │ +00021450: 636f 6e66 6967 7572 6174 696f 6e20 6669 configuration fi │ │ │ │ +00021460: 6c65 206e 616d 6520 282a 6e6f 7465 2063 le name (*note c │ │ │ │ +00021470: 6f6e 6669 675f 6669 6c65 3a3a 292e 0a0a onfig_file::)... │ │ │ │ +00021480: 1f0a 4669 6c65 3a20 6772 7562 2e69 6e66 ..File: grub.inf │ │ │ │ +00021490: 6f2c 2020 4e6f 6465 3a20 636f 6e66 6967 o, Node: config │ │ │ │ +000214a0: 5f66 696c 652c 2020 4e65 7874 3a20 6465 _file, Next: de │ │ │ │ +000214b0: 6275 672c 2020 5072 6576 3a20 636f 6e66 bug, Prev: conf │ │ │ │ +000214c0: 6967 5f64 6972 6563 746f 7279 2c20 2055 ig_directory, U │ │ │ │ +000214d0: 703a 2053 7065 6369 616c 2065 6e76 6972 p: Special envir │ │ │ │ +000214e0: 6f6e 6d65 6e74 2076 6172 6961 626c 6573 onment variables │ │ │ │ +000214f0: 0a0a 3135 2e31 2e38 2063 6f6e 6669 675f ..15.1.8 config_ │ │ │ │ +00021500: 6669 6c65 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d file.----------- │ │ │ │ +00021510: 2d2d 2d2d 2d2d 2d0a 0a54 6869 7320 7661 -------..This va │ │ │ │ +00021520: 7269 6162 6c65 2069 7320 6175 746f 6d61 riable is automa │ │ │ │ +00021530: 7469 6361 6c6c 7920 7365 7420 6279 2047 tically set by G │ │ │ │ +00021540: 5255 4220 746f 2074 6865 206e 616d 6520 RUB to the name │ │ │ │ +00021550: 6f66 2063 6f6e 6669 6775 7261 7469 6f6e of configuration │ │ │ │ +00021560: 0a66 696c 6520 7468 6174 2069 7320 6265 .file that is be │ │ │ │ +00021570: 696e 6720 7072 6f63 6573 7365 6420 6279 ing processed by │ │ │ │ +00021580: 2063 6f6d 6d61 6e64 7320 2763 6f6e 6669 commands 'confi │ │ │ │ +00021590: 6766 696c 6527 2028 2a6e 6f74 650a 636f gfile' (*note.co │ │ │ │ +000215a0: 6e66 6967 6669 6c65 3a3a 2920 6f72 2027 nfigfile::) or ' │ │ │ │ +000215b0: 6e6f 726d 616c 2720 282a 6e6f 7465 206e normal' (*note n │ │ │ │ +000215c0: 6f72 6d61 6c3a 3a29 2e20 2049 7420 6973 ormal::). It is │ │ │ │ +000215d0: 2072 6573 746f 7265 6420 746f 2074 6865 restored to the │ │ │ │ +000215e0: 0a70 7265 7669 6f75 7320 7661 6c75 6520 .previous value │ │ │ │ +000215f0: 7768 656e 2063 6f6d 6d61 6e64 2063 6f6d when command com │ │ │ │ +00021600: 706c 6574 6573 2e0a 0a1f 0a46 696c 653a pletes.....File: │ │ │ │ +00021610: 2067 7275 622e 696e 666f 2c20 204e 6f64 grub.info, Nod │ │ │ │ +00021620: 653a 2064 6562 7567 2c20 204e 6578 743a e: debug, Next: │ │ │ │ +00021630: 2064 6566 6175 6c74 2c20 2050 7265 763a default, Prev: │ │ │ │ +00021640: 2063 6f6e 6669 675f 6669 6c65 2c20 2055 config_file, U │ │ │ │ +00021650: 703a 2053 7065 6369 616c 2065 6e76 6972 p: Special envir │ │ │ │ +00021660: 6f6e 6d65 6e74 2076 6172 6961 626c 6573 onment variables │ │ │ │ +00021670: 0a0a 3135 2e31 2e39 2064 6562 7567 0a2d ..15.1.9 debug.- │ │ │ │ +00021680: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a54 6869 -----------..Thi │ │ │ │ +00021690: 7320 7661 7269 6162 6c65 206d 6179 2062 s variable may b │ │ │ │ +000216a0: 6520 7365 7420 746f 2065 6e61 626c 6520 e set to enable │ │ │ │ +000216b0: 6465 6275 6767 696e 6720 6f75 7470 7574 debugging output │ │ │ │ +000216c0: 2066 726f 6d20 7661 7269 6f75 730a 636f from various.co │ │ │ │ +000216d0: 6d70 6f6e 656e 7473 206f 6620 4752 5542 mponents of GRUB │ │ │ │ +000216e0: 2e20 5468 6520 7661 6c75 6520 6973 2061 . The value is a │ │ │ │ +000216f0: 206c 6973 7420 6f66 2064 6562 7567 2066 list of debug f │ │ │ │ +00021700: 6163 696c 6974 7920 6e61 6d65 730a 7365 acility names.se │ │ │ │ +00021710: 7061 7261 7465 6420 6279 2077 6869 7465 parated by white │ │ │ │ +00021720: 7370 6163 6520 6f72 2027 2c27 2c20 6f72 space or ',', or │ │ │ │ +00021730: 2027 616c 6c27 2074 6f20 656e 6162 6c65 'all' to enable │ │ │ │ +00021740: 2061 6c6c 2061 7661 696c 6162 6c65 0a64 all available.d │ │ │ │ +00021750: 6562 7567 6769 6e67 206f 7574 7075 742e ebugging output. │ │ │ │ +00021760: 2020 5468 6520 6661 6369 6c69 7479 206e The facility n │ │ │ │ +00021770: 616d 6573 2061 7265 2074 6865 2066 6972 ames are the fir │ │ │ │ +00021780: 7374 2061 7267 756d 656e 7420 746f 0a67 st argument to.g │ │ │ │ +00021790: 7275 625f 6470 7269 6e74 662e 2020 436f rub_dprintf. Co │ │ │ │ +000217a0: 6e73 756c 7420 736f 7572 6365 2066 6f72 nsult source for │ │ │ │ +000217b0: 206d 6f72 6520 6465 7461 696c 732e 0a0a more details... │ │ │ │ +000217c0: 1f0a 4669 6c65 3a20 6772 7562 2e69 6e66 ..File: grub.inf │ │ │ │ +000217d0: 6f2c 2020 4e6f 6465 3a20 6465 6661 756c o, Node: defaul │ │ │ │ +000217e0: 742c 2020 4e65 7874 3a20 6661 6c6c 6261 t, Next: fallba │ │ │ │ +000217f0: 636b 2c20 2050 7265 763a 2064 6562 7567 ck, Prev: debug │ │ │ │ +00021800: 2c20 2055 703a 2053 7065 6369 616c 2065 , Up: Special e │ │ │ │ +00021810: 6e76 6972 6f6e 6d65 6e74 2076 6172 6961 nvironment varia │ │ │ │ +00021820: 626c 6573 0a0a 3135 2e31 2e31 3020 6465 bles..15.1.10 de │ │ │ │ +00021830: 6661 756c 740a 2d2d 2d2d 2d2d 2d2d 2d2d fault.---------- │ │ │ │ +00021840: 2d2d 2d2d 2d0a 0a49 6620 7468 6973 2076 -----..If this v │ │ │ │ +00021850: 6172 6961 626c 6520 6973 2073 6574 2c20 ariable is set, │ │ │ │ +00021860: 6974 2069 6465 6e74 6966 6965 7320 6120 it identifies a │ │ │ │ +00021870: 6d65 6e75 2065 6e74 7279 2074 6861 7420 menu entry that │ │ │ │ +00021880: 7368 6f75 6c64 2062 650a 7365 6c65 6374 should be.select │ │ │ │ +00021890: 6564 2062 7920 6465 6661 756c 742c 2070 ed by default, p │ │ │ │ +000218a0: 6f73 7369 626c 7920 6166 7465 7220 6120 ossibly after a │ │ │ │ +000218b0: 7469 6d65 6f75 7420 282a 6e6f 7465 2074 timeout (*note t │ │ │ │ +000218c0: 696d 656f 7574 3a3a 292e 2020 5468 650a imeout::). The. │ │ │ │ +000218d0: 656e 7472 7920 6d61 7920 6265 2069 6465 entry may be ide │ │ │ │ +000218e0: 6e74 6966 6965 6420 6279 206e 756d 6265 ntified by numbe │ │ │ │ +000218f0: 7220 2873 7461 7274 696e 6720 6672 6f6d r (starting from │ │ │ │ +00021900: 2030 2061 7420 6561 6368 206c 6576 656c 0 at each level │ │ │ │ +00021910: 206f 6620 7468 650a 6869 6572 6172 6368 of the.hierarch │ │ │ │ +00021920: 7929 2c20 6279 2074 6974 6c65 2c20 6f72 y), by title, or │ │ │ │ +00021930: 2062 7920 6964 2e0a 0a20 2020 466f 7220 by id... For │ │ │ │ +00021940: 6578 616d 706c 652c 2069 6620 796f 7520 example, if you │ │ │ │ +00021950: 6861 7665 3a0a 0a6d 656e 7565 6e74 7279 have:..menuentry │ │ │ │ +00021960: 2027 4578 616d 706c 6520 474e 552f 4c69 'Example GNU/Li │ │ │ │ +00021970: 6e75 7820 6469 7374 7269 6275 7469 6f6e nux distribution │ │ │ │ +00021980: 2720 2d2d 636c 6173 7320 676e 752d 6c69 ' --class gnu-li │ │ │ │ +00021990: 6e75 7820 2d2d 6964 2065 7861 6d70 6c65 nux --id example │ │ │ │ +000219a0: 2d67 6e75 2d6c 696e 7578 207b 0a09 2e2e -gnu-linux {.... │ │ │ │ +000219b0: 2e0a 7d0a 0a20 2020 7468 656e 2079 6f75 ..}.. then you │ │ │ │ +000219c0: 2063 616e 206d 616b 6520 7468 6973 2074 can make this t │ │ │ │ +000219d0: 6865 2064 6566 6175 6c74 2075 7369 6e67 he default using │ │ │ │ +000219e0: 3a0a 0a20 2020 2020 6465 6661 756c 743d :.. default= │ │ │ │ +000219f0: 6578 616d 706c 652d 676e 752d 6c69 6e75 example-gnu-linu │ │ │ │ +00021a00: 780a 0a20 2020 4966 2074 6865 2065 6e74 x.. If the ent │ │ │ │ +00021a10: 7279 2069 7320 696e 2061 2073 7562 6d65 ry is in a subme │ │ │ │ +00021a20: 6e75 2c20 7468 656e 2069 7420 6d75 7374 nu, then it must │ │ │ │ +00021a30: 2062 6520 6964 656e 7469 6669 6564 2075 be identified u │ │ │ │ +00021a40: 7369 6e67 2074 6865 0a6e 756d 6265 722c sing the.number, │ │ │ │ +00021a50: 2074 6974 6c65 2c20 6f72 2069 6420 6f66 title, or id of │ │ │ │ +00021a60: 2065 6163 6820 6f66 2074 6865 2073 7562 each of the sub │ │ │ │ +00021a70: 6d65 6e75 7320 7374 6172 7469 6e67 2066 menus starting f │ │ │ │ +00021a80: 726f 6d20 7468 6520 746f 700a 6c65 7665 rom the top.leve │ │ │ │ +00021a90: 6c2c 2066 6f6c 6c6f 7765 6420 6279 2074 l, followed by t │ │ │ │ +00021aa0: 6865 206e 756d 6265 722c 2074 6974 6c65 he number, title │ │ │ │ +00021ab0: 2c20 6f72 2069 6420 6f66 2074 6865 206d , or id of the m │ │ │ │ +00021ac0: 656e 7520 656e 7472 7920 6974 7365 6c66 enu entry itself │ │ │ │ +00021ad0: 2c0a 7769 7468 2065 6163 6820 656c 656d ,.with each elem │ │ │ │ +00021ae0: 656e 7420 7365 7061 7261 7465 6420 6279 ent separated by │ │ │ │ +00021af0: 2027 3e27 2e20 2046 6f72 2065 7861 6d70 '>'. For examp │ │ │ │ +00021b00: 6c65 2c20 7461 6b65 2074 6865 2066 6f6c le, take the fol │ │ │ │ +00021b10: 6c6f 7769 6e67 0a6d 656e 7520 7374 7275 lowing.menu stru │ │ │ │ +00021b20: 6374 7572 653a 0a0a 2020 2020 2047 4e55 cture:.. GNU │ │ │ │ +00021b30: 2f48 7572 6420 2d2d 6964 2067 6e75 2d68 /Hurd --id gnu-h │ │ │ │ +00021b40: 7572 640a 2020 2020 2020 2053 7461 6e64 urd. Stand │ │ │ │ +00021b50: 6172 6420 426f 6f74 202d 2d69 643d 676e ard Boot --id=gn │ │ │ │ +00021b60: 752d 6875 7264 2d73 7464 0a20 2020 2020 u-hurd-std. │ │ │ │ +00021b70: 2020 5265 7363 7565 2073 6865 6c6c 202d Rescue shell - │ │ │ │ +00021b80: 2d69 643d 676e 752d 6875 7264 2d72 6573 -id=gnu-hurd-res │ │ │ │ +00021b90: 6375 650a 2020 2020 204f 7468 6572 2070 cue. Other p │ │ │ │ +00021ba0: 6c61 7466 6f72 6d73 202d 2d69 643d 6f74 latforms --id=ot │ │ │ │ +00021bb0: 6865 720a 2020 2020 2020 204d 696e 6978 her. Minix │ │ │ │ +00021bc0: 202d 2d69 643d 6d69 6e69 780a 2020 2020 --id=minix. │ │ │ │ +00021bd0: 2020 2020 2056 6572 7369 6f6e 2033 2e34 Version 3.4 │ │ │ │ +00021be0: 2e30 202d 2d69 643d 6d69 6e69 782d 332e .0 --id=minix-3. │ │ │ │ +00021bf0: 342e 300a 2020 2020 2020 2020 2056 6572 4.0. Ver │ │ │ │ +00021c00: 7369 6f6e 2033 2e33 2e30 202d 2d69 643d sion 3.3.0 --id= │ │ │ │ +00021c10: 6d69 6e69 782d 332e 332e 300a 2020 2020 minix-3.3.0. │ │ │ │ +00021c20: 2020 2047 5255 4220 496e 7661 6465 7273 GRUB Invaders │ │ │ │ +00021c30: 202d 2d69 643d 6772 7562 2d69 6e76 6164 --id=grub-invad │ │ │ │ +00021c40: 6572 730a 0a20 2020 5468 6520 6d6f 7265 ers.. The more │ │ │ │ +00021c50: 2072 6563 656e 7420 7265 6c65 6173 6520 recent release │ │ │ │ +00021c60: 6f66 204d 696e 6978 2077 6f75 6c64 2074 of Minix would t │ │ │ │ +00021c70: 6865 6e20 6265 2069 6465 6e74 6966 6965 hen be identifie │ │ │ │ +00021c80: 6420 6173 2027 4f74 6865 720a 706c 6174 d as 'Other.plat │ │ │ │ +00021c90: 666f 726d 733e 4d69 6e69 783e 5665 7273 forms>Minix>Vers │ │ │ │ +00021ca0: 696f 6e20 332e 342e 3027 2c20 6f72 2061 ion 3.4.0', or a │ │ │ │ +00021cb0: 7320 2731 3e30 3e30 272c 206f 7220 6173 s '1>0>0', or as │ │ │ │ +00021cc0: 0a27 6f74 6865 723e 6d69 6e69 783e 6d69 .'other>minix>mi │ │ │ │ +00021cd0: 6e69 782d 332e 342e 3027 2e0a 0a20 2020 nix-3.4.0'... │ │ │ │ +00021ce0: 5468 6973 2076 6172 6961 626c 6520 6973 This variable is │ │ │ │ +00021cf0: 206f 6674 656e 2073 6574 2062 7920 2747 often set by 'G │ │ │ │ +00021d00: 5255 425f 4445 4641 554c 5427 2028 2a6e RUB_DEFAULT' (*n │ │ │ │ +00021d10: 6f74 6520 5369 6d70 6c65 0a63 6f6e 6669 ote Simple.confi │ │ │ │ +00021d20: 6775 7261 7469 6f6e 3a3a 292c 2027 6772 guration::), 'gr │ │ │ │ +00021d30: 7562 2d73 6574 2d64 6566 6175 6c74 272c ub-set-default', │ │ │ │ +00021d40: 206f 7220 2767 7275 622d 7265 626f 6f74 or 'grub-reboot │ │ │ │ +00021d50: 272e 0a0a 1f0a 4669 6c65 3a20 6772 7562 '.....File: grub │ │ │ │ +00021d60: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 6661 .info, Node: fa │ │ │ │ +00021d70: 6c6c 6261 636b 2c20 204e 6578 743a 2067 llback, Next: g │ │ │ │ +00021d80: 6678 6d6f 6465 2c20 2050 7265 763a 2064 fxmode, Prev: d │ │ │ │ +00021d90: 6566 6175 6c74 2c20 2055 703a 2053 7065 efault, Up: Spe │ │ │ │ +00021da0: 6369 616c 2065 6e76 6972 6f6e 6d65 6e74 cial environment │ │ │ │ +00021db0: 2076 6172 6961 626c 6573 0a0a 3135 2e31 variables..15.1 │ │ │ │ +00021dc0: 2e31 3120 6661 6c6c 6261 636b 0a2d 2d2d .11 fallback.--- │ │ │ │ +00021dd0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a49 -------------..I │ │ │ │ +00021de0: 6620 7468 6973 2076 6172 6961 626c 6520 f this variable │ │ │ │ +00021df0: 6973 2073 6574 2c20 6974 2069 6465 6e74 is set, it ident │ │ │ │ +00021e00: 6966 6965 7320 6120 6d65 6e75 2065 6e74 ifies a menu ent │ │ │ │ +00021e10: 7279 2074 6861 7420 7368 6f75 6c64 2062 ry that should b │ │ │ │ +00021e20: 650a 7365 6c65 6374 6564 2069 6620 7468 e.selected if th │ │ │ │ +00021e30: 6520 6465 6661 756c 7420 6d65 6e75 2065 e default menu e │ │ │ │ +00021e40: 6e74 7279 2066 6169 6c73 2074 6f20 626f ntry fails to bo │ │ │ │ +00021e50: 6f74 2e20 2045 6e74 7269 6573 2061 7265 ot. Entries are │ │ │ │ +00021e60: 0a69 6465 6e74 6966 6965 6420 696e 2074 .identified in t │ │ │ │ +00021e70: 6865 2073 616d 6520 7761 7920 6173 2066 he same way as f │ │ │ │ +00021e80: 6f72 2027 6465 6661 756c 7427 2028 2a6e or 'default' (*n │ │ │ │ +00021e90: 6f74 6520 6465 6661 756c 743a 3a29 2e0a ote default::).. │ │ │ │ +00021ea0: 0a1f 0a46 696c 653a 2067 7275 622e 696e ...File: grub.in │ │ │ │ +00021eb0: 666f 2c20 204e 6f64 653a 2067 6678 6d6f fo, Node: gfxmo │ │ │ │ +00021ec0: 6465 2c20 204e 6578 743a 2067 6678 7061 de, Next: gfxpa │ │ │ │ +00021ed0: 796c 6f61 642c 2020 5072 6576 3a20 6661 yload, Prev: fa │ │ │ │ +00021ee0: 6c6c 6261 636b 2c20 2055 703a 2053 7065 llback, Up: Spe │ │ │ │ +00021ef0: 6369 616c 2065 6e76 6972 6f6e 6d65 6e74 cial environment │ │ │ │ +00021f00: 2076 6172 6961 626c 6573 0a0a 3135 2e31 variables..15.1 │ │ │ │ +00021f10: 2e31 3220 6766 786d 6f64 650a 2d2d 2d2d .12 gfxmode.---- │ │ │ │ +00021f20: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a49 6620 -----------..If │ │ │ │ +00021f30: 7468 6973 2076 6172 6961 626c 6520 6973 this variable is │ │ │ │ +00021f40: 2073 6574 2c20 6974 2073 6574 7320 7468 set, it sets th │ │ │ │ +00021f50: 6520 7265 736f 6c75 7469 6f6e 2075 7365 e resolution use │ │ │ │ +00021f60: 6420 6f6e 2074 6865 2027 6766 7874 6572 d on the 'gfxter │ │ │ │ +00021f70: 6d27 0a67 7261 7068 6963 616c 2074 6572 m'.graphical ter │ │ │ │ +00021f80: 6d69 6e61 6c2e 2020 4e6f 7465 2074 6861 minal. Note tha │ │ │ │ +00021f90: 7420 796f 7520 6361 6e20 6f6e 6c79 2075 t you can only u │ │ │ │ +00021fa0: 7365 206d 6f64 6573 2077 6869 6368 2079 se modes which y │ │ │ │ +00021fb0: 6f75 720a 6772 6170 6869 6373 2063 6172 our.graphics car │ │ │ │ +00021fc0: 6420 7375 7070 6f72 7473 2076 6961 2056 d supports via V │ │ │ │ +00021fd0: 4553 4120 4249 4f53 2045 7874 656e 7369 ESA BIOS Extensi │ │ │ │ +00021fe0: 6f6e 7320 2856 4245 292c 2073 6f20 666f ons (VBE), so fo │ │ │ │ +00021ff0: 7220 6578 616d 706c 650a 6e61 7469 7665 r example.native │ │ │ │ +00022000: 204c 4344 2070 616e 656c 2072 6573 6f6c LCD panel resol │ │ │ │ +00022010: 7574 696f 6e73 206d 6179 206e 6f74 2062 utions may not b │ │ │ │ +00022020: 6520 6176 6169 6c61 626c 652e 2020 5468 e available. Th │ │ │ │ +00022030: 6520 6465 6661 756c 7420 6973 0a27 6175 e default is.'au │ │ │ │ +00022040: 746f 272c 2077 6869 6368 2073 656c 6563 to', which selec │ │ │ │ +00022050: 7473 2061 2070 6c61 7466 6f72 6d2d 7370 ts a platform-sp │ │ │ │ +00022060: 6563 6966 6963 2064 6566 6175 6c74 2074 ecific default t │ │ │ │ +00022070: 6861 7420 7368 6f75 6c64 206c 6f6f 6b0a hat should look. │ │ │ │ +00022080: 7265 6173 6f6e 6162 6c65 2e20 2053 7570 reasonable. Sup │ │ │ │ +00022090: 706f 7274 6564 206d 6f64 6573 2063 616e ported modes can │ │ │ │ +000220a0: 2062 6520 6c69 7374 6564 2062 7920 2776 be listed by 'v │ │ │ │ +000220b0: 6964 656f 696e 666f 2720 636f 6d6d 616e ideoinfo' comman │ │ │ │ +000220c0: 6420 696e 0a47 5255 422e 0a0a 2020 2054 d in.GRUB... T │ │ │ │ +000220d0: 6865 2072 6573 6f6c 7574 696f 6e20 6d61 he resolution ma │ │ │ │ +000220e0: 7920 6265 2073 7065 6369 6669 6564 2061 y be specified a │ │ │ │ +000220f0: 7320 6120 7365 7175 656e 6365 206f 6620 s a sequence of │ │ │ │ +00022100: 6f6e 6520 6f72 206d 6f72 6520 6d6f 6465 one or more mode │ │ │ │ +00022110: 732c 0a73 6570 6172 6174 6564 2062 7920 s,.separated by │ │ │ │ +00022120: 636f 6d6d 6173 2028 272c 2729 206f 7220 commas (',') or │ │ │ │ +00022130: 7365 6d69 636f 6c6f 6e73 2028 273b 2729 semicolons (';') │ │ │ │ +00022140: 3b20 6561 6368 2077 696c 6c20 6265 2074 ; each will be t │ │ │ │ +00022150: 7269 6564 2069 6e0a 7475 726e 2075 6e74 ried in.turn unt │ │ │ │ +00022160: 696c 206f 6e65 2069 7320 666f 756e 642e il one is found. │ │ │ │ +00022170: 2020 4561 6368 206d 6f64 6520 7368 6f75 Each mode shou │ │ │ │ +00022180: 6c64 2062 6520 6569 7468 6572 2027 6175 ld be either 'au │ │ │ │ +00022190: 746f 272c 0a27 5749 4454 4878 4845 4947 to',.'WIDTHxHEIG │ │ │ │ +000221a0: 4854 272c 206f 7220 2757 4944 5448 7848 HT', or 'WIDTHxH │ │ │ │ +000221b0: 4549 4748 5478 4445 5054 4827 2e0a 0a1f EIGHTxDEPTH'.... │ │ │ │ +000221c0: 0a46 696c 653a 2067 7275 622e 696e 666f .File: grub.info │ │ │ │ +000221d0: 2c20 204e 6f64 653a 2067 6678 7061 796c , Node: gfxpayl │ │ │ │ +000221e0: 6f61 642c 2020 4e65 7874 3a20 6766 7874 oad, Next: gfxt │ │ │ │ +000221f0: 6572 6d5f 666f 6e74 2c20 2050 7265 763a erm_font, Prev: │ │ │ │ +00022200: 2067 6678 6d6f 6465 2c20 2055 703a 2053 gfxmode, Up: S │ │ │ │ +00022210: 7065 6369 616c 2065 6e76 6972 6f6e 6d65 pecial environme │ │ │ │ +00022220: 6e74 2076 6172 6961 626c 6573 0a0a 3135 nt variables..15 │ │ │ │ +00022230: 2e31 2e31 3320 6766 7870 6179 6c6f 6164 .1.13 gfxpayload │ │ │ │ +00022240: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d .--------------- │ │ │ │ +00022250: 2d2d 2d0a 0a49 6620 7468 6973 2076 6172 ---..If this var │ │ │ │ +00022260: 6961 626c 6520 6973 2073 6574 2c20 6974 iable is set, it │ │ │ │ +00022270: 2063 6f6e 7472 6f6c 7320 7468 6520 7669 controls the vi │ │ │ │ +00022280: 6465 6f20 6d6f 6465 2069 6e20 7768 6963 deo mode in whic │ │ │ │ +00022290: 6820 7468 6520 4c69 6e75 780a 6b65 726e h the Linux.kern │ │ │ │ +000222a0: 656c 2073 7461 7274 7320 7570 2c20 7265 el starts up, re │ │ │ │ +000222b0: 706c 6163 696e 6720 7468 6520 2776 6761 placing the 'vga │ │ │ │ +000222c0: 3d27 2062 6f6f 7420 6f70 7469 6f6e 2028 =' boot option ( │ │ │ │ +000222d0: 2a6e 6f74 6520 6c69 6e75 783a 3a29 2e20 *note linux::). │ │ │ │ +000222e0: 2049 740a 6d61 7920 6265 2073 6574 2074 It.may be set t │ │ │ │ +000222f0: 6f20 2774 6578 7427 2074 6f20 666f 7263 o 'text' to forc │ │ │ │ +00022300: 6520 7468 6520 4c69 6e75 7820 6b65 726e e the Linux kern │ │ │ │ +00022310: 656c 2074 6f20 626f 6f74 2069 6e20 6e6f el to boot in no │ │ │ │ +00022320: 726d 616c 2074 6578 740a 6d6f 6465 2c20 rmal text.mode, │ │ │ │ +00022330: 276b 6565 7027 2074 6f20 7072 6573 6572 'keep' to preser │ │ │ │ +00022340: 7665 2074 6865 2067 7261 7068 6963 7320 ve the graphics │ │ │ │ +00022350: 6d6f 6465 2073 6574 2075 7369 6e67 2027 mode set using ' │ │ │ │ +00022360: 6766 786d 6f64 6527 2c20 6f72 2061 6e79 gfxmode', or any │ │ │ │ +00022370: 0a6f 6620 7468 6520 7065 726d 6974 7465 .of the permitte │ │ │ │ +00022380: 6420 7661 6c75 6573 2066 6f72 2027 6766 d values for 'gf │ │ │ │ +00022390: 786d 6f64 6527 2074 6f20 7365 7420 6120 xmode' to set a │ │ │ │ +000223a0: 7061 7274 6963 756c 6172 2067 7261 7068 particular graph │ │ │ │ +000223b0: 6963 7320 6d6f 6465 0a28 2a6e 6f74 6520 ics mode.(*note │ │ │ │ +000223c0: 6766 786d 6f64 653a 3a29 2e0a 0a20 2020 gfxmode::)... │ │ │ │ +000223d0: 4465 7065 6e64 696e 6720 6f6e 2079 6f75 Depending on you │ │ │ │ +000223e0: 7220 6b65 726e 656c 2c20 796f 7572 2064 r kernel, your d │ │ │ │ +000223f0: 6973 7472 6962 7574 696f 6e2c 2079 6f75 istribution, you │ │ │ │ +00022400: 7220 6772 6170 6869 6373 2063 6172 642c r graphics card, │ │ │ │ +00022410: 2061 6e64 0a74 6865 2070 6861 7365 206f and.the phase o │ │ │ │ +00022420: 6620 7468 6520 6d6f 6f6e 2c20 6e6f 7465 f the moon, note │ │ │ │ +00022430: 2074 6861 7420 7573 696e 6720 7468 6973 that using this │ │ │ │ +00022440: 206f 7074 696f 6e20 6d61 7920 6361 7573 option may caus │ │ │ │ +00022450: 6520 474e 552f 4c69 6e75 780a 746f 2073 e GNU/Linux.to s │ │ │ │ +00022460: 7566 6665 7220 6672 6f6d 2076 6172 696f uffer from vario │ │ │ │ +00022470: 7573 2064 6973 706c 6179 2070 726f 626c us display probl │ │ │ │ +00022480: 656d 732c 2070 6172 7469 6375 6c61 726c ems, particularl │ │ │ │ +00022490: 7920 6475 7269 6e67 2074 6865 2065 6172 y during the ear │ │ │ │ +000224a0: 6c79 0a70 6172 7420 6f66 2074 6865 2062 ly.part of the b │ │ │ │ +000224b0: 6f6f 7420 7365 7175 656e 6365 2e20 2049 oot sequence. I │ │ │ │ +000224c0: 6620 796f 7520 6861 7665 2070 726f 626c f you have probl │ │ │ │ +000224d0: 656d 732c 2073 6574 2074 6869 7320 7661 ems, set this va │ │ │ │ +000224e0: 7269 6162 6c65 2074 6f0a 2774 6578 7427 riable to.'text' │ │ │ │ +000224f0: 2061 6e64 2047 5255 4220 7769 6c6c 2074 and GRUB will t │ │ │ │ +00022500: 656c 6c20 4c69 6e75 7820 746f 2062 6f6f ell Linux to boo │ │ │ │ +00022510: 7420 696e 206e 6f72 6d61 6c20 7465 7874 t in normal text │ │ │ │ +00022520: 206d 6f64 652e 0a0a 2020 2054 6865 2064 mode... The d │ │ │ │ +00022530: 6566 6175 6c74 2069 7320 706c 6174 666f efault is platfo │ │ │ │ +00022540: 726d 2d73 7065 6369 6669 632e 2020 4f6e rm-specific. On │ │ │ │ +00022550: 2070 6c61 7466 6f72 6d73 2077 6974 6820 platforms with │ │ │ │ +00022560: 6120 6e61 7469 7665 2074 6578 740a 6d6f a native text.mo │ │ │ │ +00022570: 6465 2028 7375 6368 2061 7320 5043 2042 de (such as PC B │ │ │ │ +00022580: 494f 5320 706c 6174 666f 726d 7329 2c20 IOS platforms), │ │ │ │ +00022590: 7468 6520 6465 6661 756c 7420 6973 2027 the default is ' │ │ │ │ +000225a0: 7465 7874 272e 2020 4f74 6865 7277 6973 text'. Otherwis │ │ │ │ +000225b0: 6520 7468 650a 6465 6661 756c 7420 6d61 e the.default ma │ │ │ │ +000225c0: 7920 6265 2027 6175 746f 2720 6f72 2061 y be 'auto' or a │ │ │ │ +000225d0: 2073 7065 6369 6669 6320 7669 6465 6f20 specific video │ │ │ │ +000225e0: 6d6f 6465 2e0a 0a20 2020 5468 6973 2076 mode... This v │ │ │ │ +000225f0: 6172 6961 626c 6520 6973 206f 6674 656e ariable is often │ │ │ │ +00022600: 2073 6574 2062 7920 2747 5255 425f 4746 set by 'GRUB_GF │ │ │ │ +00022610: 5850 4159 4c4f 4144 5f4c 494e 5558 2720 XPAYLOAD_LINUX' │ │ │ │ +00022620: 282a 6e6f 7465 2053 696d 706c 650a 636f (*note Simple.co │ │ │ │ +00022630: 6e66 6967 7572 6174 696f 6e3a 3a29 2e0a nfiguration::).. │ │ │ │ +00022640: 0a1f 0a46 696c 653a 2067 7275 622e 696e ...File: grub.in │ │ │ │ +00022650: 666f 2c20 204e 6f64 653a 2067 6678 7465 fo, Node: gfxte │ │ │ │ +00022660: 726d 5f66 6f6e 742c 2020 4e65 7874 3a20 rm_font, Next: │ │ │ │ +00022670: 6772 7562 5f63 7075 2c20 2050 7265 763a grub_cpu, Prev: │ │ │ │ +00022680: 2067 6678 7061 796c 6f61 642c 2020 5570 gfxpayload, Up │ │ │ │ +00022690: 3a20 5370 6563 6961 6c20 656e 7669 726f : Special enviro │ │ │ │ +000226a0: 6e6d 656e 7420 7661 7269 6162 6c65 730a nment variables. │ │ │ │ +000226b0: 0a31 352e 312e 3134 2067 6678 7465 726d .15.1.14 gfxterm │ │ │ │ +000226c0: 5f66 6f6e 740a 2d2d 2d2d 2d2d 2d2d 2d2d _font.---------- │ │ │ │ +000226d0: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 4966 2074 ----------..If t │ │ │ │ +000226e0: 6869 7320 7661 7269 6162 6c65 2069 7320 his variable is │ │ │ │ +000226f0: 7365 742c 2069 7420 6e61 6d65 7320 6120 set, it names a │ │ │ │ +00022700: 666f 6e74 2074 6f20 7573 6520 666f 7220 font to use for │ │ │ │ +00022710: 7465 7874 206f 6e20 7468 650a 2767 6678 text on the.'gfx │ │ │ │ +00022720: 7465 726d 2720 6772 6170 6869 6361 6c20 term' graphical │ │ │ │ +00022730: 7465 726d 696e 616c 2e20 204f 7468 6572 terminal. Other │ │ │ │ +00022740: 7769 7365 2c20 2767 6678 7465 726d 2720 wise, 'gfxterm' │ │ │ │ +00022750: 6d61 7920 7573 6520 616e 790a 6176 6169 may use any.avai │ │ │ │ +00022760: 6c61 626c 6520 666f 6e74 2e0a 0a1f 0a46 lable font.....F │ │ │ │ +00022770: 696c 653a 2067 7275 622e 696e 666f 2c20 ile: grub.info, │ │ │ │ +00022780: 204e 6f64 653a 2067 7275 625f 6370 752c Node: grub_cpu, │ │ │ │ +00022790: 2020 4e65 7874 3a20 6772 7562 5f70 6c61 Next: grub_pla │ │ │ │ +000227a0: 7466 6f72 6d2c 2020 5072 6576 3a20 6766 tform, Prev: gf │ │ │ │ +000227b0: 7874 6572 6d5f 666f 6e74 2c20 2055 703a xterm_font, Up: │ │ │ │ +000227c0: 2053 7065 6369 616c 2065 6e76 6972 6f6e Special environ │ │ │ │ +000227d0: 6d65 6e74 2076 6172 6961 626c 6573 0a0a ment variables.. │ │ │ │ +000227e0: 3135 2e31 2e31 3520 6772 7562 5f63 7075 15.1.15 grub_cpu │ │ │ │ +000227f0: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d .--------------- │ │ │ │ +00022800: 2d0a 0a49 6e20 6e6f 726d 616c 206d 6f64 -..In normal mod │ │ │ │ +00022810: 6520 282a 6e6f 7465 206e 6f72 6d61 6c3a e (*note normal: │ │ │ │ +00022820: 3a29 2c20 4752 5542 2073 6574 7320 7468 :), GRUB sets th │ │ │ │ +00022830: 6520 2767 7275 625f 6370 7527 2076 6172 e 'grub_cpu' var │ │ │ │ +00022840: 6961 626c 6520 746f 0a74 6865 2043 5055 iable to.the CPU │ │ │ │ +00022850: 2074 7970 6520 666f 7220 7768 6963 6820 type for which │ │ │ │ +00022860: 4752 5542 2077 6173 2062 7569 6c74 2028 GRUB was built ( │ │ │ │ +00022870: 652e 672e 2020 2769 3338 3627 206f 7220 e.g. 'i386' or │ │ │ │ +00022880: 2770 6f77 6572 7063 2729 2e0a 0a1f 0a46 'powerpc').....F │ │ │ │ +00022890: 696c 653a 2067 7275 622e 696e 666f 2c20 ile: grub.info, │ │ │ │ +000228a0: 204e 6f64 653a 2067 7275 625f 706c 6174 Node: grub_plat │ │ │ │ +000228b0: 666f 726d 2c20 204e 6578 743a 2069 636f form, Next: ico │ │ │ │ +000228c0: 6e64 6972 2c20 2050 7265 763a 2067 7275 ndir, Prev: gru │ │ │ │ +000228d0: 625f 6370 752c 2020 5570 3a20 5370 6563 b_cpu, Up: Spec │ │ │ │ +000228e0: 6961 6c20 656e 7669 726f 6e6d 656e 7420 ial environment │ │ │ │ +000228f0: 7661 7269 6162 6c65 730a 0a31 352e 312e variables..15.1. │ │ │ │ +00022900: 3136 2067 7275 625f 706c 6174 666f 726d 16 grub_platform │ │ │ │ +00022910: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d .--------------- │ │ │ │ +00022920: 2d2d 2d2d 2d2d 0a0a 496e 206e 6f72 6d61 ------..In norma │ │ │ │ +00022930: 6c20 6d6f 6465 2028 2a6e 6f74 6520 6e6f l mode (*note no │ │ │ │ +00022940: 726d 616c 3a3a 292c 2047 5255 4220 7365 rmal::), GRUB se │ │ │ │ +00022950: 7473 2074 6865 2027 6772 7562 5f70 6c61 ts the 'grub_pla │ │ │ │ +00022960: 7466 6f72 6d27 2076 6172 6961 626c 650a tform' variable. │ │ │ │ +00022970: 746f 2074 6865 2070 6c61 7466 6f72 6d20 to the platform │ │ │ │ +00022980: 666f 7220 7768 6963 6820 4752 5542 2077 for which GRUB w │ │ │ │ +00022990: 6173 2062 7569 6c74 2028 652e 672e 2020 as built (e.g. │ │ │ │ +000229a0: 2770 6327 206f 7220 2765 6669 2729 2e0a 'pc' or 'efi').. │ │ │ │ +000229b0: 0a1f 0a46 696c 653a 2067 7275 622e 696e ...File: grub.in │ │ │ │ +000229c0: 666f 2c20 204e 6f64 653a 2069 636f 6e64 fo, Node: icond │ │ │ │ +000229d0: 6972 2c20 204e 6578 743a 206c 616e 672c ir, Next: lang, │ │ │ │ +000229e0: 2020 5072 6576 3a20 6772 7562 5f70 6c61 Prev: grub_pla │ │ │ │ +000229f0: 7466 6f72 6d2c 2020 5570 3a20 5370 6563 tform, Up: Spec │ │ │ │ +00022a00: 6961 6c20 656e 7669 726f 6e6d 656e 7420 ial environment │ │ │ │ +00022a10: 7661 7269 6162 6c65 730a 0a31 352e 312e variables..15.1. │ │ │ │ +00022a20: 3137 2069 636f 6e64 6972 0a2d 2d2d 2d2d 17 icondir.----- │ │ │ │ +00022a30: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 4966 2074 ----------..If t │ │ │ │ +00022a40: 6869 7320 7661 7269 6162 6c65 2069 7320 his variable is │ │ │ │ +00022a50: 7365 742c 2069 7420 6e61 6d65 7320 6120 set, it names a │ │ │ │ +00022a60: 6469 7265 6374 6f72 7920 696e 2077 6869 directory in whi │ │ │ │ +00022a70: 6368 2074 6865 2047 5255 420a 6772 6170 ch the GRUB.grap │ │ │ │ +00022a80: 6869 6361 6c20 6d65 6e75 2073 686f 756c hical menu shoul │ │ │ │ +00022a90: 6420 6c6f 6f6b 2066 6f72 2069 636f 6e73 d look for icons │ │ │ │ +00022aa0: 2061 6674 6572 206c 6f6f 6b69 6e67 2069 after looking i │ │ │ │ +00022ab0: 6e20 7468 6520 7468 656d 6527 730a 2769 n the theme's.'i │ │ │ │ +00022ac0: 636f 6e73 2720 6469 7265 6374 6f72 792e cons' directory. │ │ │ │ +00022ad0: 2020 2a4e 6f74 6520 5468 656d 6520 6669 *Note Theme fi │ │ │ │ +00022ae0: 6c65 2066 6f72 6d61 743a 3a2e 0a0a 1f0a le format::..... │ │ │ │ +00022af0: 4669 6c65 3a20 6772 7562 2e69 6e66 6f2c File: grub.info, │ │ │ │ +00022b00: 2020 4e6f 6465 3a20 6c61 6e67 2c20 204e Node: lang, N │ │ │ │ +00022b10: 6578 743a 206c 6f63 616c 655f 6469 722c ext: locale_dir, │ │ │ │ +00022b20: 2020 5072 6576 3a20 6963 6f6e 6469 722c Prev: icondir, │ │ │ │ +00022b30: 2020 5570 3a20 5370 6563 6961 6c20 656e Up: Special en │ │ │ │ +00022b40: 7669 726f 6e6d 656e 7420 7661 7269 6162 vironment variab │ │ │ │ +00022b50: 6c65 730a 0a31 352e 312e 3138 206c 616e les..15.1.18 lan │ │ │ │ +00022b60: 670a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a g.------------.. │ │ │ │ +00022b70: 4966 2074 6869 7320 7661 7269 6162 6c65 If this variable │ │ │ │ +00022b80: 2069 7320 7365 742c 2069 7420 6e61 6d65 is set, it name │ │ │ │ +00022b90: 7320 7468 6520 6c61 6e67 7561 6765 2063 s the language c │ │ │ │ +00022ba0: 6f64 6520 7468 6174 2074 6865 2027 6765 ode that the 'ge │ │ │ │ +00022bb0: 7474 6578 7427 0a63 6f6d 6d61 6e64 2028 ttext'.command ( │ │ │ │ +00022bc0: 2a6e 6f74 6520 6765 7474 6578 743a 3a29 *note gettext::) │ │ │ │ +00022bd0: 2075 7365 7320 746f 2074 7261 6e73 6c61 uses to transla │ │ │ │ +00022be0: 7465 2073 7472 696e 6773 2e20 2046 6f72 te strings. For │ │ │ │ +00022bf0: 2065 7861 6d70 6c65 2c0a 4672 656e 6368 example,.French │ │ │ │ +00022c00: 2077 6f75 6c64 2062 6520 6e61 6d65 6420 would be named │ │ │ │ +00022c10: 6173 2027 6672 272c 2061 6e64 2053 696d as 'fr', and Sim │ │ │ │ +00022c20: 706c 6966 6965 6420 4368 696e 6573 6520 plified Chinese │ │ │ │ +00022c30: 6173 2027 7a68 5f43 4e27 2e0a 0a20 2020 as 'zh_CN'... │ │ │ │ +00022c40: 2767 7275 622d 6d6b 636f 6e66 6967 2720 'grub-mkconfig' │ │ │ │ +00022c50: 282a 6e6f 7465 2053 696d 706c 6520 636f (*note Simple co │ │ │ │ +00022c60: 6e66 6967 7572 6174 696f 6e3a 3a29 2077 nfiguration::) w │ │ │ │ +00022c70: 696c 6c20 7472 7920 746f 2073 6574 2061 ill try to set a │ │ │ │ +00022c80: 0a72 6561 736f 6e61 626c 6520 6465 6661 .reasonable defa │ │ │ │ +00022c90: 756c 7420 666f 7220 7468 6973 2076 6172 ult for this var │ │ │ │ +00022ca0: 6961 626c 6520 6261 7365 6420 6f6e 2074 iable based on t │ │ │ │ +00022cb0: 6865 2073 7973 7465 6d20 6c6f 6361 6c65 he system locale │ │ │ │ +00022cc0: 2e0a 0a1f 0a46 696c 653a 2067 7275 622e .....File: grub. │ │ │ │ +00022cd0: 696e 666f 2c20 204e 6f64 653a 206c 6f63 info, Node: loc │ │ │ │ +00022ce0: 616c 655f 6469 722c 2020 4e65 7874 3a20 ale_dir, Next: │ │ │ │ +00022cf0: 6d65 6e75 5f63 6f6c 6f72 5f68 6967 686c menu_color_highl │ │ │ │ +00022d00: 6967 6874 2c20 2050 7265 763a 206c 616e ight, Prev: lan │ │ │ │ +00022d10: 672c 2020 5570 3a20 5370 6563 6961 6c20 g, Up: Special │ │ │ │ +00022d20: 656e 7669 726f 6e6d 656e 7420 7661 7269 environment vari │ │ │ │ +00022d30: 6162 6c65 730a 0a31 352e 312e 3139 206c ables..15.1.19 l │ │ │ │ +00022d40: 6f63 616c 655f 6469 720a 2d2d 2d2d 2d2d ocale_dir.------ │ │ │ │ +00022d50: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 4966 ------------..If │ │ │ │ +00022d60: 2074 6869 7320 7661 7269 6162 6c65 2069 this variable i │ │ │ │ +00022d70: 7320 7365 742c 2069 7420 6e61 6d65 7320 s set, it names │ │ │ │ +00022d80: 7468 6520 6469 7265 6374 6f72 7920 7768 the directory wh │ │ │ │ +00022d90: 6572 6520 7472 616e 736c 6174 696f 6e20 ere translation │ │ │ │ +00022da0: 6669 6c65 730a 6d61 7920 6265 2066 6f75 files.may be fou │ │ │ │ +00022db0: 6e64 2028 2a6e 6f74 6520 6765 7474 6578 nd (*note gettex │ │ │ │ +00022dc0: 743a 3a29 2c20 7573 7561 6c6c 7920 272f t::), usually '/ │ │ │ │ +00022dd0: 626f 6f74 2f67 7275 622f 6c6f 6361 6c65 boot/grub/locale │ │ │ │ +00022de0: 272e 2020 4f74 6865 7277 6973 652c 0a69 '. Otherwise,.i │ │ │ │ +00022df0: 6e74 6572 6e61 7469 6f6e 616c 697a 6174 nternationalizat │ │ │ │ +00022e00: 696f 6e20 6973 2064 6973 6162 6c65 642e ion is disabled. │ │ │ │ +00022e10: 0a0a 2020 2027 6772 7562 2d6d 6b63 6f6e .. 'grub-mkcon │ │ │ │ +00022e20: 6669 6727 2028 2a6e 6f74 6520 5369 6d70 fig' (*note Simp │ │ │ │ +00022e30: 6c65 2063 6f6e 6669 6775 7261 7469 6f6e le configuration │ │ │ │ +00022e40: 3a3a 2920 7769 6c6c 2073 6574 2061 2072 ::) will set a r │ │ │ │ +00022e50: 6561 736f 6e61 626c 650a 6465 6661 756c easonable.defaul │ │ │ │ +00022e60: 7420 666f 7220 7468 6973 2076 6172 6961 t for this varia │ │ │ │ +00022e70: 626c 6520 6966 2069 6e74 6572 6e61 7469 ble if internati │ │ │ │ +00022e80: 6f6e 616c 697a 6174 696f 6e20 6973 206e onalization is n │ │ │ │ +00022e90: 6565 6465 6420 616e 6420 616e 790a 7472 eeded and any.tr │ │ │ │ +00022ea0: 616e 736c 6174 696f 6e20 6669 6c65 7320 anslation files │ │ │ │ +00022eb0: 6172 6520 6176 6169 6c61 626c 652e 0a0a are available... │ │ │ │ +00022ec0: 1f0a 4669 6c65 3a20 6772 7562 2e69 6e66 ..File: grub.inf │ │ │ │ +00022ed0: 6f2c 2020 4e6f 6465 3a20 6d65 6e75 5f63 o, Node: menu_c │ │ │ │ +00022ee0: 6f6c 6f72 5f68 6967 686c 6967 6874 2c20 olor_highlight, │ │ │ │ +00022ef0: 204e 6578 743a 206d 656e 755f 636f 6c6f Next: menu_colo │ │ │ │ +00022f00: 725f 6e6f 726d 616c 2c20 2050 7265 763a r_normal, Prev: │ │ │ │ +00022f10: 206c 6f63 616c 655f 6469 722c 2020 5570 locale_dir, Up │ │ │ │ +00022f20: 3a20 5370 6563 6961 6c20 656e 7669 726f : Special enviro │ │ │ │ +00022f30: 6e6d 656e 7420 7661 7269 6162 6c65 730a nment variables. │ │ │ │ +00022f40: 0a31 352e 312e 3230 206d 656e 755f 636f .15.1.20 menu_co │ │ │ │ +00022f50: 6c6f 725f 6869 6768 6c69 6768 740a 2d2d lor_highlight.-- │ │ │ │ 00022f60: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ -00022f70: 2d2d 2d2d 2d2d 0a0a 5468 6973 2076 6172 ------..This var │ │ │ │ -00022f80: 6961 626c 6520 636f 6e74 6169 6e73 2074 iable contains t │ │ │ │ -00022f90: 6865 2066 6f72 6567 726f 756e 6420 616e he foreground an │ │ │ │ -00022fa0: 6420 6261 636b 6772 6f75 6e64 2063 6f6c d background col │ │ │ │ -00022fb0: 6f72 7320 746f 2062 6520 7573 6564 0a66 ors to be used.f │ │ │ │ -00022fc0: 6f72 2074 6865 2068 6967 686c 6967 6874 or the highlight │ │ │ │ -00022fd0: 6564 206d 656e 7520 656e 7472 792c 2073 ed menu entry, s │ │ │ │ -00022fe0: 6570 6172 6174 6564 2062 7920 6120 736c eparated by a sl │ │ │ │ -00022ff0: 6173 6820 2827 2f27 292e 2020 5365 7474 ash ('/'). Sett │ │ │ │ -00023000: 696e 670a 7468 6973 2076 6172 6961 626c ing.this variabl │ │ │ │ -00023010: 6520 6368 616e 6765 7320 7468 6f73 6520 e changes those │ │ │ │ -00023020: 636f 6c6f 7273 2e20 2046 6f72 2074 6865 colors. For the │ │ │ │ -00023030: 2061 7661 696c 6162 6c65 2063 6f6c 6f72 available color │ │ │ │ -00023040: 206e 616d 6573 2c0a 2a6e 6f74 6520 636f names,.*note co │ │ │ │ -00023050: 6c6f 725f 6e6f 726d 616c 3a3a 2e0a 0a20 lor_normal::... │ │ │ │ -00023060: 2020 5468 6520 6465 6661 756c 7420 6973 The default is │ │ │ │ -00023070: 2074 6865 2076 616c 7565 206f 6620 2763 the value of 'c │ │ │ │ -00023080: 6f6c 6f72 5f68 6967 686c 6967 6874 2720 olor_highlight' │ │ │ │ -00023090: 282a 6e6f 7465 0a63 6f6c 6f72 5f68 6967 (*note.color_hig │ │ │ │ -000230a0: 686c 6967 6874 3a3a 292e 0a0a 1f0a 4669 hlight::).....Fi │ │ │ │ -000230b0: 6c65 3a20 6772 7562 2e69 6e66 6f2c 2020 le: grub.info, │ │ │ │ -000230c0: 4e6f 6465 3a20 6d65 6e75 5f63 6f6c 6f72 Node: menu_color │ │ │ │ -000230d0: 5f6e 6f72 6d61 6c2c 2020 4e65 7874 3a20 _normal, Next: │ │ │ │ -000230e0: 6e65 745f 3c49 4e54 4552 4641 4345 3e5f net__ │ │ │ │ -000230f0: 626f 6f74 5f66 696c 652c 2020 5072 6576 boot_file, Prev │ │ │ │ -00023100: 3a20 6d65 6e75 5f63 6f6c 6f72 5f68 6967 : menu_color_hig │ │ │ │ -00023110: 686c 6967 6874 2c20 2055 703a 2053 7065 hlight, Up: Spe │ │ │ │ -00023120: 6369 616c 2065 6e76 6972 6f6e 6d65 6e74 cial environment │ │ │ │ -00023130: 2076 6172 6961 626c 6573 0a0a 3135 2e31 variables..15.1 │ │ │ │ -00023140: 2e32 3120 6d65 6e75 5f63 6f6c 6f72 5f6e .21 menu_color_n │ │ │ │ -00023150: 6f72 6d61 6c0a 2d2d 2d2d 2d2d 2d2d 2d2d ormal.---------- │ │ │ │ -00023160: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a ---------------. │ │ │ │ -00023170: 0a54 6869 7320 7661 7269 6162 6c65 2063 .This variable c │ │ │ │ -00023180: 6f6e 7461 696e 7320 7468 6520 666f 7265 ontains the fore │ │ │ │ -00023190: 6772 6f75 6e64 2061 6e64 2062 6163 6b67 ground and backg │ │ │ │ -000231a0: 726f 756e 6420 636f 6c6f 7273 2074 6f20 round colors to │ │ │ │ -000231b0: 6265 2075 7365 640a 666f 7220 6e6f 6e2d be used.for non- │ │ │ │ -000231c0: 6869 6768 6c69 6768 7465 6420 6d65 6e75 highlighted menu │ │ │ │ -000231d0: 2065 6e74 7269 6573 2c20 7365 7061 7261 entries, separa │ │ │ │ -000231e0: 7465 6420 6279 2061 2073 6c61 7368 2028 ted by a slash ( │ │ │ │ -000231f0: 272f 2729 2e20 2053 6574 7469 6e67 0a74 '/'). Setting.t │ │ │ │ -00023200: 6869 7320 7661 7269 6162 6c65 2063 6861 his variable cha │ │ │ │ -00023210: 6e67 6573 2074 686f 7365 2063 6f6c 6f72 nges those color │ │ │ │ -00023220: 732e 2020 466f 7220 7468 6520 6176 6169 s. For the avai │ │ │ │ -00023230: 6c61 626c 6520 636f 6c6f 7220 6e61 6d65 lable color name │ │ │ │ -00023240: 732c 0a2a 6e6f 7465 2063 6f6c 6f72 5f6e s,.*note color_n │ │ │ │ -00023250: 6f72 6d61 6c3a 3a2e 0a0a 2020 2054 6865 ormal::... The │ │ │ │ -00023260: 2064 6566 6175 6c74 2069 7320 7468 6520 default is the │ │ │ │ -00023270: 7661 6c75 6520 6f66 2027 636f 6c6f 725f value of 'color_ │ │ │ │ -00023280: 6e6f 726d 616c 2720 282a 6e6f 7465 2063 normal' (*note c │ │ │ │ -00023290: 6f6c 6f72 5f6e 6f72 6d61 6c3a 3a29 2e0a olor_normal::).. │ │ │ │ -000232a0: 0a1f 0a46 696c 653a 2067 7275 622e 696e ...File: grub.in │ │ │ │ -000232b0: 666f 2c20 204e 6f64 653a 206e 6574 5f3c fo, Node: net_< │ │ │ │ -000232c0: 494e 5445 5246 4143 453e 5f62 6f6f 745f INTERFACE>_boot_ │ │ │ │ -000232d0: 6669 6c65 2c20 204e 6578 743a 206e 6574 file, Next: net │ │ │ │ -000232e0: 5f3c 494e 5445 5246 4143 453e 5f64 6863 __dhc │ │ │ │ -000232f0: 705f 7365 7276 6572 5f6e 616d 652c 2020 p_server_name, │ │ │ │ -00023300: 5072 6576 3a20 6d65 6e75 5f63 6f6c 6f72 Prev: menu_color │ │ │ │ -00023310: 5f6e 6f72 6d61 6c2c 2020 5570 3a20 5370 _normal, Up: Sp │ │ │ │ -00023320: 6563 6961 6c20 656e 7669 726f 6e6d 656e ecial environmen │ │ │ │ -00023330: 7420 7661 7269 6162 6c65 730a 0a31 352e t variables..15. │ │ │ │ -00023340: 312e 3232 206e 6574 5f3c 494e 5445 5246 1.22 net__boot_file.- │ │ │ │ -00023360: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ +00022f70: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 5468 6973 ----------..This │ │ │ │ +00022f80: 2076 6172 6961 626c 6520 636f 6e74 6169 variable contai │ │ │ │ +00022f90: 6e73 2074 6865 2066 6f72 6567 726f 756e ns the foregroun │ │ │ │ +00022fa0: 6420 616e 6420 6261 636b 6772 6f75 6e64 d and background │ │ │ │ +00022fb0: 2063 6f6c 6f72 7320 746f 2062 6520 7573 colors to be us │ │ │ │ +00022fc0: 6564 0a66 6f72 2074 6865 2068 6967 686c ed.for the highl │ │ │ │ +00022fd0: 6967 6874 6564 206d 656e 7520 656e 7472 ighted menu entr │ │ │ │ +00022fe0: 792c 2073 6570 6172 6174 6564 2062 7920 y, separated by │ │ │ │ +00022ff0: 6120 736c 6173 6820 2827 2f27 292e 2020 a slash ('/'). │ │ │ │ +00023000: 5365 7474 696e 670a 7468 6973 2076 6172 Setting.this var │ │ │ │ +00023010: 6961 626c 6520 6368 616e 6765 7320 7468 iable changes th │ │ │ │ +00023020: 6f73 6520 636f 6c6f 7273 2e20 2046 6f72 ose colors. For │ │ │ │ +00023030: 2074 6865 2061 7661 696c 6162 6c65 2063 the available c │ │ │ │ +00023040: 6f6c 6f72 206e 616d 6573 2c0a 2a6e 6f74 olor names,.*not │ │ │ │ +00023050: 6520 636f 6c6f 725f 6e6f 726d 616c 3a3a e color_normal:: │ │ │ │ +00023060: 2e0a 0a20 2020 5468 6520 6465 6661 756c ... The defaul │ │ │ │ +00023070: 7420 6973 2074 6865 2076 616c 7565 206f t is the value o │ │ │ │ +00023080: 6620 2763 6f6c 6f72 5f68 6967 686c 6967 f 'color_highlig │ │ │ │ +00023090: 6874 2720 282a 6e6f 7465 0a63 6f6c 6f72 ht' (*note.color │ │ │ │ +000230a0: 5f68 6967 686c 6967 6874 3a3a 292e 0a0a _highlight::)... │ │ │ │ +000230b0: 1f0a 4669 6c65 3a20 6772 7562 2e69 6e66 ..File: grub.inf │ │ │ │ +000230c0: 6f2c 2020 4e6f 6465 3a20 6d65 6e75 5f63 o, Node: menu_c │ │ │ │ +000230d0: 6f6c 6f72 5f6e 6f72 6d61 6c2c 2020 4e65 olor_normal, Ne │ │ │ │ +000230e0: 7874 3a20 6e65 745f 3c49 4e54 4552 4641 xt: net__boot_file, │ │ │ │ +00023100: 5072 6576 3a20 6d65 6e75 5f63 6f6c 6f72 Prev: menu_color │ │ │ │ +00023110: 5f68 6967 686c 6967 6874 2c20 2055 703a _highlight, Up: │ │ │ │ +00023120: 2053 7065 6369 616c 2065 6e76 6972 6f6e Special environ │ │ │ │ +00023130: 6d65 6e74 2076 6172 6961 626c 6573 0a0a ment variables.. │ │ │ │ +00023140: 3135 2e31 2e32 3120 6d65 6e75 5f63 6f6c 15.1.21 menu_col │ │ │ │ +00023150: 6f72 5f6e 6f72 6d61 6c0a 2d2d 2d2d 2d2d or_normal.------ │ │ │ │ +00023160: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ +00023170: 2d2d 2d0a 0a54 6869 7320 7661 7269 6162 ---..This variab │ │ │ │ +00023180: 6c65 2063 6f6e 7461 696e 7320 7468 6520 le contains the │ │ │ │ +00023190: 666f 7265 6772 6f75 6e64 2061 6e64 2062 foreground and b │ │ │ │ +000231a0: 6163 6b67 726f 756e 6420 636f 6c6f 7273 ackground colors │ │ │ │ +000231b0: 2074 6f20 6265 2075 7365 640a 666f 7220 to be used.for │ │ │ │ +000231c0: 6e6f 6e2d 6869 6768 6c69 6768 7465 6420 non-highlighted │ │ │ │ +000231d0: 6d65 6e75 2065 6e74 7269 6573 2c20 7365 menu entries, se │ │ │ │ +000231e0: 7061 7261 7465 6420 6279 2061 2073 6c61 parated by a sla │ │ │ │ +000231f0: 7368 2028 272f 2729 2e20 2053 6574 7469 sh ('/'). Setti │ │ │ │ +00023200: 6e67 0a74 6869 7320 7661 7269 6162 6c65 ng.this variable │ │ │ │ +00023210: 2063 6861 6e67 6573 2074 686f 7365 2063 changes those c │ │ │ │ +00023220: 6f6c 6f72 732e 2020 466f 7220 7468 6520 olors. For the │ │ │ │ +00023230: 6176 6169 6c61 626c 6520 636f 6c6f 7220 available color │ │ │ │ +00023240: 6e61 6d65 732c 0a2a 6e6f 7465 2063 6f6c names,.*note col │ │ │ │ +00023250: 6f72 5f6e 6f72 6d61 6c3a 3a2e 0a0a 2020 or_normal::... │ │ │ │ +00023260: 2054 6865 2064 6566 6175 6c74 2069 7320 The default is │ │ │ │ +00023270: 7468 6520 7661 6c75 6520 6f66 2027 636f the value of 'co │ │ │ │ +00023280: 6c6f 725f 6e6f 726d 616c 2720 282a 6e6f lor_normal' (*no │ │ │ │ +00023290: 7465 2063 6f6c 6f72 5f6e 6f72 6d61 6c3a te color_normal: │ │ │ │ +000232a0: 3a29 2e0a 0a1f 0a46 696c 653a 2067 7275 :).....File: gru │ │ │ │ +000232b0: 622e 696e 666f 2c20 204e 6f64 653a 206e b.info, Node: n │ │ │ │ +000232c0: 6574 5f3c 494e 5445 5246 4143 453e 5f62 et__b │ │ │ │ +000232d0: 6f6f 745f 6669 6c65 2c20 204e 6578 743a oot_file, Next: │ │ │ │ +000232e0: 206e 6574 5f3c 494e 5445 5246 4143 453e net_ │ │ │ │ +000232f0: 5f64 6863 705f 7365 7276 6572 5f6e 616d _dhcp_server_nam │ │ │ │ +00023300: 652c 2020 5072 6576 3a20 6d65 6e75 5f63 e, Prev: menu_c │ │ │ │ +00023310: 6f6c 6f72 5f6e 6f72 6d61 6c2c 2020 5570 olor_normal, Up │ │ │ │ +00023320: 3a20 5370 6563 6961 6c20 656e 7669 726f : Special enviro │ │ │ │ +00023330: 6e6d 656e 7420 7661 7269 6162 6c65 730a nment variables. │ │ │ │ +00023340: 0a31 352e 312e 3232 206e 6574 5f3c 494e .15.1.22 net__boot_fi │ │ │ │ +00023360: 6c65 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d le.------------- │ │ │ │ 00023370: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ -00023380: 0a0a 2a4e 6f74 6520 4e65 7477 6f72 6b3a ..*Note Network: │ │ │ │ -00023390: 3a2e 0a0a 1f0a 4669 6c65 3a20 6772 7562 :.....File: grub │ │ │ │ -000233a0: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 6e65 .info, Node: ne │ │ │ │ -000233b0: 745f 3c49 4e54 4552 4641 4345 3e5f 6468 t__dh │ │ │ │ -000233c0: 6370 5f73 6572 7665 725f 6e61 6d65 2c20 cp_server_name, │ │ │ │ -000233d0: 204e 6578 743a 206e 6574 5f3c 494e 5445 Next: net__domain, │ │ │ │ -000233f0: 5072 6576 3a20 6e65 745f 3c49 4e54 4552 Prev: net__boot_file, │ │ │ │ -00023410: 2020 5570 3a20 5370 6563 6961 6c20 656e Up: Special en │ │ │ │ -00023420: 7669 726f 6e6d 656e 7420 7661 7269 6162 vironment variab │ │ │ │ -00023430: 6c65 730a 0a31 352e 312e 3233 206e 6574 les..15.1.23 net │ │ │ │ -00023440: 5f3c 494e 5445 5246 4143 453e 5f64 6863 __dhc │ │ │ │ -00023450: 705f 7365 7276 6572 5f6e 616d 650a 2d2d p_server_name.-- │ │ │ │ -00023460: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ +00023380: 2d2d 2d2d 0a0a 2a4e 6f74 6520 4e65 7477 ----..*Note Netw │ │ │ │ +00023390: 6f72 6b3a 3a2e 0a0a 1f0a 4669 6c65 3a20 ork::.....File: │ │ │ │ +000233a0: 6772 7562 2e69 6e66 6f2c 2020 4e6f 6465 grub.info, Node │ │ │ │ +000233b0: 3a20 6e65 745f 3c49 4e54 4552 4641 4345 : net__dhcp_server_na │ │ │ │ +000233d0: 6d65 2c20 204e 6578 743a 206e 6574 5f3c me, Next: net_< │ │ │ │ +000233e0: 494e 5445 5246 4143 453e 5f64 6f6d 6169 INTERFACE>_domai │ │ │ │ +000233f0: 6e2c 2020 5072 6576 3a20 6e65 745f 3c49 n, Prev: net__boot_f │ │ │ │ +00023410: 696c 652c 2020 5570 3a20 5370 6563 6961 ile, Up: Specia │ │ │ │ +00023420: 6c20 656e 7669 726f 6e6d 656e 7420 7661 l environment va │ │ │ │ +00023430: 7269 6162 6c65 730a 0a31 352e 312e 3233 riables..15.1.23 │ │ │ │ +00023440: 206e 6574 5f3c 494e 5445 5246 4143 453e net_ │ │ │ │ +00023450: 5f64 6863 705f 7365 7276 6572 5f6e 616d _dhcp_server_nam │ │ │ │ +00023460: 650a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d e.-------------- │ │ │ │ 00023470: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ -00023480: 2d2d 2d2d 2d2d 0a0a 2a4e 6f74 6520 4e65 ------..*Note Ne │ │ │ │ -00023490: 7477 6f72 6b3a 3a2e 0a0a 1f0a 4669 6c65 twork::.....File │ │ │ │ -000234a0: 3a20 6772 7562 2e69 6e66 6f2c 2020 4e6f : grub.info, No │ │ │ │ -000234b0: 6465 3a20 6e65 745f 3c49 4e54 4552 4641 de: net__domain, Nex │ │ │ │ -000234d0: 743a 206e 6574 5f3c 494e 5445 5246 4143 t: net__extensionspat │ │ │ │ -000234f0: 682c 2020 5072 6576 3a20 6e65 745f 3c49 h, Prev: net__dhcp_s │ │ │ │ -00023510: 6572 7665 725f 6e61 6d65 2c20 2055 703a erver_name, Up: │ │ │ │ -00023520: 2053 7065 6369 616c 2065 6e76 6972 6f6e Special environ │ │ │ │ -00023530: 6d65 6e74 2076 6172 6961 626c 6573 0a0a ment variables.. │ │ │ │ -00023540: 3135 2e31 2e32 3420 6e65 745f 3c49 4e54 15.1.24 net__domain.- │ │ │ │ -00023560: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ -00023570: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a2a -------------..* │ │ │ │ -00023580: 4e6f 7465 204e 6574 776f 726b 3a3a 2e0a Note Network::.. │ │ │ │ -00023590: 0a1f 0a46 696c 653a 2067 7275 622e 696e ...File: grub.in │ │ │ │ -000235a0: 666f 2c20 204e 6f64 653a 206e 6574 5f3c fo, Node: net_< │ │ │ │ -000235b0: 494e 5445 5246 4143 453e 5f65 7874 656e INTERFACE>_exten │ │ │ │ -000235c0: 7369 6f6e 7370 6174 682c 2020 4e65 7874 sionspath, Next │ │ │ │ -000235d0: 3a20 6e65 745f 3c49 4e54 4552 4641 4345 : net__hostname, Pre │ │ │ │ -000235f0: 763a 206e 6574 5f3c 494e 5445 5246 4143 v: net__domain, Up: │ │ │ │ -00023610: 5370 6563 6961 6c20 656e 7669 726f 6e6d Special environm │ │ │ │ -00023620: 656e 7420 7661 7269 6162 6c65 730a 0a31 ent variables..1 │ │ │ │ -00023630: 352e 312e 3235 206e 6574 5f3c 494e 5445 5.1.25 net__extension │ │ │ │ -00023650: 7370 6174 680a 2d2d 2d2d 2d2d 2d2d 2d2d spath.---------- │ │ │ │ +00023480: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 2a4e 6f74 ----------..*Not │ │ │ │ +00023490: 6520 4e65 7477 6f72 6b3a 3a2e 0a0a 1f0a e Network::..... │ │ │ │ +000234a0: 4669 6c65 3a20 6772 7562 2e69 6e66 6f2c File: grub.info, │ │ │ │ +000234b0: 2020 4e6f 6465 3a20 6e65 745f 3c49 4e54 Node: net__domain, │ │ │ │ +000234d0: 204e 6578 743a 206e 6574 5f3c 494e 5445 Next: net__extension │ │ │ │ +000234f0: 7370 6174 682c 2020 5072 6576 3a20 6e65 spath, Prev: ne │ │ │ │ +00023500: 745f 3c49 4e54 4552 4641 4345 3e5f 6468 t__dh │ │ │ │ +00023510: 6370 5f73 6572 7665 725f 6e61 6d65 2c20 cp_server_name, │ │ │ │ +00023520: 2055 703a 2053 7065 6369 616c 2065 6e76 Up: Special env │ │ │ │ +00023530: 6972 6f6e 6d65 6e74 2076 6172 6961 626c ironment variabl │ │ │ │ +00023540: 6573 0a0a 3135 2e31 2e32 3420 6e65 745f es..15.1.24 net_ │ │ │ │ +00023550: 3c49 4e54 4552 4641 4345 3e5f 646f 6d61 _doma │ │ │ │ +00023560: 696e 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d in.------------- │ │ │ │ +00023570: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ +00023580: 2d0a 0a2a 4e6f 7465 204e 6574 776f 726b -..*Note Network │ │ │ │ +00023590: 3a3a 2e0a 0a1f 0a46 696c 653a 2067 7275 ::.....File: gru │ │ │ │ +000235a0: 622e 696e 666f 2c20 204e 6f64 653a 206e b.info, Node: n │ │ │ │ +000235b0: 6574 5f3c 494e 5445 5246 4143 453e 5f65 et__e │ │ │ │ +000235c0: 7874 656e 7369 6f6e 7370 6174 682c 2020 xtensionspath, │ │ │ │ +000235d0: 4e65 7874 3a20 6e65 745f 3c49 4e54 4552 Next: net__hostname, │ │ │ │ +000235f0: 2050 7265 763a 206e 6574 5f3c 494e 5445 Prev: net__domain, │ │ │ │ +00023610: 5570 3a20 5370 6563 6961 6c20 656e 7669 Up: Special envi │ │ │ │ +00023620: 726f 6e6d 656e 7420 7661 7269 6162 6c65 ronment variable │ │ │ │ +00023630: 730a 0a31 352e 312e 3235 206e 6574 5f3c s..15.1.25 net_< │ │ │ │ +00023640: 494e 5445 5246 4143 453e 5f65 7874 656e INTERFACE>_exten │ │ │ │ +00023650: 7369 6f6e 7370 6174 680a 2d2d 2d2d 2d2d sionspath.------ │ │ │ │ 00023660: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ -00023670: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 2a4e ------------..*N │ │ │ │ -00023680: 6f74 6520 4e65 7477 6f72 6b3a 3a2e 0a0a ote Network::... │ │ │ │ -00023690: 1f0a 4669 6c65 3a20 6772 7562 2e69 6e66 ..File: grub.inf │ │ │ │ -000236a0: 6f2c 2020 4e6f 6465 3a20 6e65 745f 3c49 o, Node: net__hostna │ │ │ │ -000236c0: 6d65 2c20 204e 6578 743a 206e 6574 5f3c me, Next: net_< │ │ │ │ -000236d0: 494e 5445 5246 4143 453e 5f69 702c 2020 INTERFACE>_ip, │ │ │ │ -000236e0: 5072 6576 3a20 6e65 745f 3c49 4e54 4552 Prev: net__extensions │ │ │ │ -00023700: 7061 7468 2c20 2055 703a 2053 7065 6369 path, Up: Speci │ │ │ │ -00023710: 616c 2065 6e76 6972 6f6e 6d65 6e74 2076 al environment v │ │ │ │ -00023720: 6172 6961 626c 6573 0a0a 3135 2e31 2e32 ariables..15.1.2 │ │ │ │ -00023730: 3620 6e65 745f 3c49 4e54 4552 4641 4345 6 net__hostname.----- │ │ │ │ +00023670: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ +00023680: 0a0a 2a4e 6f74 6520 4e65 7477 6f72 6b3a ..*Note Network: │ │ │ │ +00023690: 3a2e 0a0a 1f0a 4669 6c65 3a20 6772 7562 :.....File: grub │ │ │ │ +000236a0: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 6e65 .info, Node: ne │ │ │ │ +000236b0: 745f 3c49 4e54 4552 4641 4345 3e5f 686f t__ho │ │ │ │ +000236c0: 7374 6e61 6d65 2c20 204e 6578 743a 206e stname, Next: n │ │ │ │ +000236d0: 6574 5f3c 494e 5445 5246 4143 453e 5f69 et__i │ │ │ │ +000236e0: 702c 2020 5072 6576 3a20 6e65 745f 3c49 p, Prev: net__extens │ │ │ │ +00023700: 696f 6e73 7061 7468 2c20 2055 703a 2053 ionspath, Up: S │ │ │ │ +00023710: 7065 6369 616c 2065 6e76 6972 6f6e 6d65 pecial environme │ │ │ │ +00023720: 6e74 2076 6172 6961 626c 6573 0a0a 3135 nt variables..15 │ │ │ │ +00023730: 2e31 2e32 3620 6e65 745f 3c49 4e54 4552 .1.26 net__hostname.- │ │ │ │ 00023750: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ -00023760: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a2a 4e6f -----------..*No │ │ │ │ -00023770: 7465 204e 6574 776f 726b 3a3a 2e0a 0a1f te Network::.... │ │ │ │ -00023780: 0a46 696c 653a 2067 7275 622e 696e 666f .File: grub.info │ │ │ │ -00023790: 2c20 204e 6f64 653a 206e 6574 5f3c 494e , Node: net__ip, Ne │ │ │ │ -000237b0: 7874 3a20 6e65 745f 3c49 4e54 4552 4641 xt: net__mac, Prev: │ │ │ │ -000237d0: 6e65 745f 3c49 4e54 4552 4641 4345 3e5f net__ │ │ │ │ -000237e0: 686f 7374 6e61 6d65 2c20 2055 703a 2053 hostname, Up: S │ │ │ │ -000237f0: 7065 6369 616c 2065 6e76 6972 6f6e 6d65 pecial environme │ │ │ │ -00023800: 6e74 2076 6172 6961 626c 6573 0a0a 3135 nt variables..15 │ │ │ │ -00023810: 2e31 2e32 3720 6e65 745f 3c49 4e54 4552 .1.27 net__ip.------- │ │ │ │ +00023760: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a ---------------. │ │ │ │ +00023770: 0a2a 4e6f 7465 204e 6574 776f 726b 3a3a .*Note Network:: │ │ │ │ +00023780: 2e0a 0a1f 0a46 696c 653a 2067 7275 622e .....File: grub. │ │ │ │ +00023790: 696e 666f 2c20 204e 6f64 653a 206e 6574 info, Node: net │ │ │ │ +000237a0: 5f3c 494e 5445 5246 4143 453e 5f69 702c __ip, │ │ │ │ +000237b0: 2020 4e65 7874 3a20 6e65 745f 3c49 4e54 Next: net__mac, Pr │ │ │ │ +000237d0: 6576 3a20 6e65 745f 3c49 4e54 4552 4641 ev: net__hostname, U │ │ │ │ +000237f0: 703a 2053 7065 6369 616c 2065 6e76 6972 p: Special envir │ │ │ │ +00023800: 6f6e 6d65 6e74 2076 6172 6961 626c 6573 onment variables │ │ │ │ +00023810: 0a0a 3135 2e31 2e32 3720 6e65 745f 3c49 ..15.1.27 net__ip.--- │ │ │ │ 00023830: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ -00023840: 2d2d 2d0a 0a2a 4e6f 7465 204e 6574 776f ---..*Note Netwo │ │ │ │ -00023850: 726b 3a3a 2e0a 0a1f 0a46 696c 653a 2067 rk::.....File: g │ │ │ │ -00023860: 7275 622e 696e 666f 2c20 204e 6f64 653a rub.info, Node: │ │ │ │ -00023870: 206e 6574 5f3c 494e 5445 5246 4143 453e net_ │ │ │ │ -00023880: 5f6d 6163 2c20 204e 6578 743a 206e 6574 _mac, Next: net │ │ │ │ -00023890: 5f3c 494e 5445 5246 4143 453e 5f6e 6578 __nex │ │ │ │ -000238a0: 745f 7365 7276 6572 2c20 2050 7265 763a t_server, Prev: │ │ │ │ -000238b0: 206e 6574 5f3c 494e 5445 5246 4143 453e net_ │ │ │ │ -000238c0: 5f69 702c 2020 5570 3a20 5370 6563 6961 _ip, Up: Specia │ │ │ │ -000238d0: 6c20 656e 7669 726f 6e6d 656e 7420 7661 l environment va │ │ │ │ -000238e0: 7269 6162 6c65 730a 0a31 352e 312e 3238 riables..15.1.28 │ │ │ │ -000238f0: 206e 6574 5f3c 494e 5445 5246 4143 453e net_ │ │ │ │ -00023900: 5f6d 6163 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d _mac.----------- │ │ │ │ +00023840: 2d2d 2d2d 2d2d 2d0a 0a2a 4e6f 7465 204e -------..*Note N │ │ │ │ +00023850: 6574 776f 726b 3a3a 2e0a 0a1f 0a46 696c etwork::.....Fil │ │ │ │ +00023860: 653a 2067 7275 622e 696e 666f 2c20 204e e: grub.info, N │ │ │ │ +00023870: 6f64 653a 206e 6574 5f3c 494e 5445 5246 ode: net__mac, Next: │ │ │ │ +00023890: 206e 6574 5f3c 494e 5445 5246 4143 453e net_ │ │ │ │ +000238a0: 5f6e 6578 745f 7365 7276 6572 2c20 2050 _next_server, P │ │ │ │ +000238b0: 7265 763a 206e 6574 5f3c 494e 5445 5246 rev: net__ip, Up: Sp │ │ │ │ +000238d0: 6563 6961 6c20 656e 7669 726f 6e6d 656e ecial environmen │ │ │ │ +000238e0: 7420 7661 7269 6162 6c65 730a 0a31 352e t variables..15. │ │ │ │ +000238f0: 312e 3238 206e 6574 5f3c 494e 5445 5246 1.28 net__mac.------- │ │ │ │ 00023910: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ -00023920: 0a0a 2a4e 6f74 6520 4e65 7477 6f72 6b3a ..*Note Network: │ │ │ │ -00023930: 3a2e 0a0a 1f0a 4669 6c65 3a20 6772 7562 :.....File: grub │ │ │ │ -00023940: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 6e65 .info, Node: ne │ │ │ │ -00023950: 745f 3c49 4e54 4552 4641 4345 3e5f 6e65 t__ne │ │ │ │ -00023960: 7874 5f73 6572 7665 722c 2020 4e65 7874 xt_server, Next │ │ │ │ -00023970: 3a20 6e65 745f 3c49 4e54 4552 4641 4345 : net__rootpath, Pre │ │ │ │ -00023990: 763a 206e 6574 5f3c 494e 5445 5246 4143 v: net__mac, Up: Spe │ │ │ │ -000239b0: 6369 616c 2065 6e76 6972 6f6e 6d65 6e74 cial environment │ │ │ │ -000239c0: 2076 6172 6961 626c 6573 0a0a 3135 2e31 variables..15.1 │ │ │ │ -000239d0: 2e32 3920 6e65 745f 3c49 4e54 4552 4641 .29 net__next_server. │ │ │ │ -000239f0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ +00023920: 2d2d 2d2d 0a0a 2a4e 6f74 6520 4e65 7477 ----..*Note Netw │ │ │ │ +00023930: 6f72 6b3a 3a2e 0a0a 1f0a 4669 6c65 3a20 ork::.....File: │ │ │ │ +00023940: 6772 7562 2e69 6e66 6f2c 2020 4e6f 6465 grub.info, Node │ │ │ │ +00023950: 3a20 6e65 745f 3c49 4e54 4552 4641 4345 : net__next_server, │ │ │ │ +00023970: 4e65 7874 3a20 6e65 745f 3c49 4e54 4552 Next: net__rootpath, │ │ │ │ +00023990: 2050 7265 763a 206e 6574 5f3c 494e 5445 Prev: net__mac, Up: │ │ │ │ +000239b0: 2053 7065 6369 616c 2065 6e76 6972 6f6e Special environ │ │ │ │ +000239c0: 6d65 6e74 2076 6172 6961 626c 6573 0a0a ment variables.. │ │ │ │ +000239d0: 3135 2e31 2e32 3920 6e65 745f 3c49 4e54 15.1.29 net__next_ser │ │ │ │ +000239f0: 7665 720a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ver.------------ │ │ │ │ 00023a00: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ -00023a10: 2d2d 2d0a 0a2a 4e6f 7465 204e 6574 776f ---..*Note Netwo │ │ │ │ -00023a20: 726b 3a3a 2e0a 0a1f 0a46 696c 653a 2067 rk::.....File: g │ │ │ │ -00023a30: 7275 622e 696e 666f 2c20 204e 6f64 653a rub.info, Node: │ │ │ │ -00023a40: 206e 6574 5f3c 494e 5445 5246 4143 453e net_ │ │ │ │ -00023a50: 5f72 6f6f 7470 6174 682c 2020 4e65 7874 _rootpath, Next │ │ │ │ -00023a60: 3a20 6e65 745f 6465 6661 756c 745f 696e : net_default_in │ │ │ │ -00023a70: 7465 7266 6163 652c 2020 5072 6576 3a20 terface, Prev: │ │ │ │ -00023a80: 6e65 745f 3c49 4e54 4552 4641 4345 3e5f net__ │ │ │ │ -00023a90: 6e65 7874 5f73 6572 7665 722c 2020 5570 next_server, Up │ │ │ │ -00023aa0: 3a20 5370 6563 6961 6c20 656e 7669 726f : Special enviro │ │ │ │ -00023ab0: 6e6d 656e 7420 7661 7269 6162 6c65 730a nment variables. │ │ │ │ -00023ac0: 0a31 352e 312e 3330 206e 6574 5f3c 494e .15.1.30 net__rootpat │ │ │ │ -00023ae0: 680a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d h.-------------- │ │ │ │ +00023a10: 2d2d 2d2d 2d2d 2d0a 0a2a 4e6f 7465 204e -------..*Note N │ │ │ │ +00023a20: 6574 776f 726b 3a3a 2e0a 0a1f 0a46 696c etwork::.....Fil │ │ │ │ +00023a30: 653a 2067 7275 622e 696e 666f 2c20 204e e: grub.info, N │ │ │ │ +00023a40: 6f64 653a 206e 6574 5f3c 494e 5445 5246 ode: net__rootpath, │ │ │ │ +00023a60: 4e65 7874 3a20 6e65 745f 6465 6661 756c Next: net_defaul │ │ │ │ +00023a70: 745f 696e 7465 7266 6163 652c 2020 5072 t_interface, Pr │ │ │ │ +00023a80: 6576 3a20 6e65 745f 3c49 4e54 4552 4641 ev: net__next_server, │ │ │ │ +00023aa0: 2020 5570 3a20 5370 6563 6961 6c20 656e Up: Special en │ │ │ │ +00023ab0: 7669 726f 6e6d 656e 7420 7661 7269 6162 vironment variab │ │ │ │ +00023ac0: 6c65 730a 0a31 352e 312e 3330 206e 6574 les..15.1.30 net │ │ │ │ +00023ad0: 5f3c 494e 5445 5246 4143 453e 5f72 6f6f __roo │ │ │ │ +00023ae0: 7470 6174 680a 2d2d 2d2d 2d2d 2d2d 2d2d tpath.---------- │ │ │ │ 00023af0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ -00023b00: 2d2d 0a0a 2a4e 6f74 6520 4e65 7477 6f72 --..*Note Networ │ │ │ │ -00023b10: 6b3a 3a2e 0a0a 1f0a 4669 6c65 3a20 6772 k::.....File: gr │ │ │ │ -00023b20: 7562 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ub.info, Node: │ │ │ │ -00023b30: 6e65 745f 6465 6661 756c 745f 696e 7465 net_default_inte │ │ │ │ -00023b40: 7266 6163 652c 2020 4e65 7874 3a20 6e65 rface, Next: ne │ │ │ │ -00023b50: 745f 6465 6661 756c 745f 6970 2c20 2050 t_default_ip, P │ │ │ │ -00023b60: 7265 763a 206e 6574 5f3c 494e 5445 5246 rev: net__rootpath, │ │ │ │ -00023b80: 5570 3a20 5370 6563 6961 6c20 656e 7669 Up: Special envi │ │ │ │ -00023b90: 726f 6e6d 656e 7420 7661 7269 6162 6c65 ronment variable │ │ │ │ -00023ba0: 730a 0a31 352e 312e 3331 206e 6574 5f64 s..15.1.31 net_d │ │ │ │ -00023bb0: 6566 6175 6c74 5f69 6e74 6572 6661 6365 efault_interface │ │ │ │ -00023bc0: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d .--------------- │ │ │ │ -00023bd0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a --------------.. │ │ │ │ -00023be0: 2a4e 6f74 6520 4e65 7477 6f72 6b3a 3a2e *Note Network::. │ │ │ │ -00023bf0: 0a0a 1f0a 4669 6c65 3a20 6772 7562 2e69 ....File: grub.i │ │ │ │ -00023c00: 6e66 6f2c 2020 4e6f 6465 3a20 6e65 745f nfo, Node: net_ │ │ │ │ -00023c10: 6465 6661 756c 745f 6970 2c20 204e 6578 default_ip, Nex │ │ │ │ -00023c20: 743a 206e 6574 5f64 6566 6175 6c74 5f6d t: net_default_m │ │ │ │ -00023c30: 6163 2c20 2050 7265 763a 206e 6574 5f64 ac, Prev: net_d │ │ │ │ -00023c40: 6566 6175 6c74 5f69 6e74 6572 6661 6365 efault_interface │ │ │ │ -00023c50: 2c20 2055 703a 2053 7065 6369 616c 2065 , Up: Special e │ │ │ │ -00023c60: 6e76 6972 6f6e 6d65 6e74 2076 6172 6961 nvironment varia │ │ │ │ -00023c70: 626c 6573 0a0a 3135 2e31 2e33 3220 6e65 bles..15.1.32 ne │ │ │ │ -00023c80: 745f 6465 6661 756c 745f 6970 0a2d 2d2d t_default_ip.--- │ │ │ │ -00023c90: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ -00023ca0: 2d2d 2d0a 0a2a 4e6f 7465 204e 6574 776f ---..*Note Netwo │ │ │ │ -00023cb0: 726b 3a3a 2e0a 0a1f 0a46 696c 653a 2067 rk::.....File: g │ │ │ │ -00023cc0: 7275 622e 696e 666f 2c20 204e 6f64 653a rub.info, Node: │ │ │ │ -00023cd0: 206e 6574 5f64 6566 6175 6c74 5f6d 6163 net_default_mac │ │ │ │ -00023ce0: 2c20 204e 6578 743a 206e 6574 5f64 6566 , Next: net_def │ │ │ │ -00023cf0: 6175 6c74 5f73 6572 7665 722c 2020 5072 ault_server, Pr │ │ │ │ -00023d00: 6576 3a20 6e65 745f 6465 6661 756c 745f ev: net_default_ │ │ │ │ -00023d10: 6970 2c20 2055 703a 2053 7065 6369 616c ip, Up: Special │ │ │ │ -00023d20: 2065 6e76 6972 6f6e 6d65 6e74 2076 6172 environment var │ │ │ │ -00023d30: 6961 626c 6573 0a0a 3135 2e31 2e33 3320 iables..15.1.33 │ │ │ │ -00023d40: 6e65 745f 6465 6661 756c 745f 6d61 630a net_default_mac. │ │ │ │ -00023d50: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ -00023d60: 2d2d 2d2d 2d2d 2d0a 0a2a 4e6f 7465 204e -------..*Note N │ │ │ │ -00023d70: 6574 776f 726b 3a3a 2e0a 0a1f 0a46 696c etwork::.....Fil │ │ │ │ -00023d80: 653a 2067 7275 622e 696e 666f 2c20 204e e: grub.info, N │ │ │ │ -00023d90: 6f64 653a 206e 6574 5f64 6566 6175 6c74 ode: net_default │ │ │ │ -00023da0: 5f73 6572 7665 722c 2020 4e65 7874 3a20 _server, Next: │ │ │ │ -00023db0: 7061 6765 722c 2020 5072 6576 3a20 6e65 pager, Prev: ne │ │ │ │ -00023dc0: 745f 6465 6661 756c 745f 6d61 632c 2020 t_default_mac, │ │ │ │ -00023dd0: 5570 3a20 5370 6563 6961 6c20 656e 7669 Up: Special envi │ │ │ │ -00023de0: 726f 6e6d 656e 7420 7661 7269 6162 6c65 ronment variable │ │ │ │ -00023df0: 730a 0a31 352e 312e 3334 206e 6574 5f64 s..15.1.34 net_d │ │ │ │ -00023e00: 6566 6175 6c74 5f73 6572 7665 720a 2d2d efault_server.-- │ │ │ │ -00023e10: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ -00023e20: 2d2d 2d2d 2d2d 2d2d 0a0a 2a4e 6f74 6520 --------..*Note │ │ │ │ -00023e30: 4e65 7477 6f72 6b3a 3a2e 0a0a 1f0a 4669 Network::.....Fi │ │ │ │ -00023e40: 6c65 3a20 6772 7562 2e69 6e66 6f2c 2020 le: grub.info, │ │ │ │ -00023e50: 4e6f 6465 3a20 7061 6765 722c 2020 4e65 Node: pager, Ne │ │ │ │ -00023e60: 7874 3a20 7072 6566 6978 2c20 2050 7265 xt: prefix, Pre │ │ │ │ -00023e70: 763a 206e 6574 5f64 6566 6175 6c74 5f73 v: net_default_s │ │ │ │ -00023e80: 6572 7665 722c 2020 5570 3a20 5370 6563 erver, Up: Spec │ │ │ │ -00023e90: 6961 6c20 656e 7669 726f 6e6d 656e 7420 ial environment │ │ │ │ -00023ea0: 7661 7269 6162 6c65 730a 0a31 352e 312e variables..15.1. │ │ │ │ -00023eb0: 3335 2070 6167 6572 0a2d 2d2d 2d2d 2d2d 35 pager.------- │ │ │ │ -00023ec0: 2d2d 2d2d 2d2d 0a0a 4966 2073 6574 2074 ------..If set t │ │ │ │ -00023ed0: 6f20 2731 272c 2070 6175 7365 206f 7574 o '1', pause out │ │ │ │ -00023ee0: 7075 7420 6166 7465 7220 6561 6368 2073 put after each s │ │ │ │ -00023ef0: 6372 6565 6e66 756c 2061 6e64 2077 6169 creenful and wai │ │ │ │ -00023f00: 7420 666f 7220 6b65 7962 6f61 7264 0a69 t for keyboard.i │ │ │ │ -00023f10: 6e70 7574 2e20 2054 6865 2064 6566 6175 nput. The defau │ │ │ │ -00023f20: 6c74 2069 7320 6e6f 7420 746f 2070 6175 lt is not to pau │ │ │ │ -00023f30: 7365 206f 7574 7075 742e 0a0a 1f0a 4669 se output.....Fi │ │ │ │ -00023f40: 6c65 3a20 6772 7562 2e69 6e66 6f2c 2020 le: grub.info, │ │ │ │ -00023f50: 4e6f 6465 3a20 7072 6566 6978 2c20 204e Node: prefix, N │ │ │ │ -00023f60: 6578 743a 2070 7865 5f62 6c6b 7369 7a65 ext: pxe_blksize │ │ │ │ -00023f70: 2c20 2050 7265 763a 2070 6167 6572 2c20 , Prev: pager, │ │ │ │ -00023f80: 2055 703a 2053 7065 6369 616c 2065 6e76 Up: Special env │ │ │ │ -00023f90: 6972 6f6e 6d65 6e74 2076 6172 6961 626c ironment variabl │ │ │ │ -00023fa0: 6573 0a0a 3135 2e31 2e33 3620 7072 6566 es..15.1.36 pref │ │ │ │ -00023fb0: 6978 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ix.------------- │ │ │ │ -00023fc0: 2d0a 0a54 6865 206c 6f63 6174 696f 6e20 -..The location │ │ │ │ -00023fd0: 6f66 2074 6865 2027 2f62 6f6f 742f 6772 of the '/boot/gr │ │ │ │ -00023fe0: 7562 2720 6469 7265 6374 6f72 7920 6173 ub' directory as │ │ │ │ -00023ff0: 2061 6e20 6162 736f 6c75 7465 2066 696c an absolute fil │ │ │ │ -00024000: 6520 6e61 6d65 0a28 2a6e 6f74 6520 4669 e name.(*note Fi │ │ │ │ -00024010: 6c65 206e 616d 6520 7379 6e74 6178 3a3a le name syntax:: │ │ │ │ -00024020: 292e 2020 5468 6973 2069 7320 6e6f 726d ). This is norm │ │ │ │ -00024030: 616c 6c79 2073 6574 2062 7920 4752 5542 ally set by GRUB │ │ │ │ -00024040: 2061 7420 7374 6172 7475 700a 6261 7365 at startup.base │ │ │ │ -00024050: 6420 6f6e 2069 6e66 6f72 6d61 7469 6f6e d on information │ │ │ │ -00024060: 2070 726f 7669 6465 6420 6279 2027 6772 provided by 'gr │ │ │ │ -00024070: 7562 2d69 6e73 7461 6c6c 272e 2020 4752 ub-install'. GR │ │ │ │ -00024080: 5542 206d 6f64 756c 6573 2061 7265 0a64 UB modules are.d │ │ │ │ -00024090: 796e 616d 6963 616c 6c79 206c 6f61 6465 ynamically loade │ │ │ │ -000240a0: 6420 6672 6f6d 2074 6869 7320 6469 7265 d from this dire │ │ │ │ -000240b0: 6374 6f72 792c 2073 6f20 6974 206d 7573 ctory, so it mus │ │ │ │ -000240c0: 7420 6265 2073 6574 2063 6f72 7265 6374 t be set correct │ │ │ │ -000240d0: 6c79 2069 6e0a 6f72 6465 7220 666f 7220 ly in.order for │ │ │ │ -000240e0: 6d61 6e79 2070 6172 7473 206f 6620 4752 many parts of GR │ │ │ │ -000240f0: 5542 2074 6f20 776f 726b 2e0a 0a1f 0a46 UB to work.....F │ │ │ │ -00024100: 696c 653a 2067 7275 622e 696e 666f 2c20 ile: grub.info, │ │ │ │ -00024110: 204e 6f64 653a 2070 7865 5f62 6c6b 7369 Node: pxe_blksi │ │ │ │ -00024120: 7a65 2c20 204e 6578 743a 2070 7865 5f64 ze, Next: pxe_d │ │ │ │ -00024130: 6566 6175 6c74 5f67 6174 6577 6179 2c20 efault_gateway, │ │ │ │ -00024140: 2050 7265 763a 2070 7265 6669 782c 2020 Prev: prefix, │ │ │ │ -00024150: 5570 3a20 5370 6563 6961 6c20 656e 7669 Up: Special envi │ │ │ │ -00024160: 726f 6e6d 656e 7420 7661 7269 6162 6c65 ronment variable │ │ │ │ -00024170: 730a 0a31 352e 312e 3337 2070 7865 5f62 s..15.1.37 pxe_b │ │ │ │ -00024180: 6c6b 7369 7a65 0a2d 2d2d 2d2d 2d2d 2d2d lksize.--------- │ │ │ │ -00024190: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 2a4e 6f74 ----------..*Not │ │ │ │ -000241a0: 6520 4e65 7477 6f72 6b3a 3a2e 0a0a 1f0a e Network::..... │ │ │ │ -000241b0: 4669 6c65 3a20 6772 7562 2e69 6e66 6f2c File: grub.info, │ │ │ │ -000241c0: 2020 4e6f 6465 3a20 7078 655f 6465 6661 Node: pxe_defa │ │ │ │ -000241d0: 756c 745f 6761 7465 7761 792c 2020 4e65 ult_gateway, Ne │ │ │ │ -000241e0: 7874 3a20 7078 655f 6465 6661 756c 745f xt: pxe_default_ │ │ │ │ -000241f0: 7365 7276 6572 2c20 2050 7265 763a 2070 server, Prev: p │ │ │ │ -00024200: 7865 5f62 6c6b 7369 7a65 2c20 2055 703a xe_blksize, Up: │ │ │ │ -00024210: 2053 7065 6369 616c 2065 6e76 6972 6f6e Special environ │ │ │ │ -00024220: 6d65 6e74 2076 6172 6961 626c 6573 0a0a ment variables.. │ │ │ │ -00024230: 3135 2e31 2e33 3820 7078 655f 6465 6661 15.1.38 pxe_defa │ │ │ │ -00024240: 756c 745f 6761 7465 7761 790a 2d2d 2d2d ult_gateway.---- │ │ │ │ +00023b00: 2d2d 2d2d 2d2d 0a0a 2a4e 6f74 6520 4e65 ------..*Note Ne │ │ │ │ +00023b10: 7477 6f72 6b3a 3a2e 0a0a 1f0a 4669 6c65 twork::.....File │ │ │ │ +00023b20: 3a20 6772 7562 2e69 6e66 6f2c 2020 4e6f : grub.info, No │ │ │ │ +00023b30: 6465 3a20 6e65 745f 6465 6661 756c 745f de: net_default_ │ │ │ │ +00023b40: 696e 7465 7266 6163 652c 2020 4e65 7874 interface, Next │ │ │ │ +00023b50: 3a20 6e65 745f 6465 6661 756c 745f 6970 : net_default_ip │ │ │ │ +00023b60: 2c20 2050 7265 763a 206e 6574 5f3c 494e , Prev: net__rootpat │ │ │ │ +00023b80: 682c 2020 5570 3a20 5370 6563 6961 6c20 h, Up: Special │ │ │ │ +00023b90: 656e 7669 726f 6e6d 656e 7420 7661 7269 environment vari │ │ │ │ +00023ba0: 6162 6c65 730a 0a31 352e 312e 3331 206e ables..15.1.31 n │ │ │ │ +00023bb0: 6574 5f64 6566 6175 6c74 5f69 6e74 6572 et_default_inter │ │ │ │ +00023bc0: 6661 6365 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d face.----------- │ │ │ │ +00023bd0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ +00023be0: 2d2d 0a0a 2a4e 6f74 6520 4e65 7477 6f72 --..*Note Networ │ │ │ │ +00023bf0: 6b3a 3a2e 0a0a 1f0a 4669 6c65 3a20 6772 k::.....File: gr │ │ │ │ +00023c00: 7562 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ub.info, Node: │ │ │ │ +00023c10: 6e65 745f 6465 6661 756c 745f 6970 2c20 net_default_ip, │ │ │ │ +00023c20: 204e 6578 743a 206e 6574 5f64 6566 6175 Next: net_defau │ │ │ │ +00023c30: 6c74 5f6d 6163 2c20 2050 7265 763a 206e lt_mac, Prev: n │ │ │ │ +00023c40: 6574 5f64 6566 6175 6c74 5f69 6e74 6572 et_default_inter │ │ │ │ +00023c50: 6661 6365 2c20 2055 703a 2053 7065 6369 face, Up: Speci │ │ │ │ +00023c60: 616c 2065 6e76 6972 6f6e 6d65 6e74 2076 al environment v │ │ │ │ +00023c70: 6172 6961 626c 6573 0a0a 3135 2e31 2e33 ariables..15.1.3 │ │ │ │ +00023c80: 3220 6e65 745f 6465 6661 756c 745f 6970 2 net_default_ip │ │ │ │ +00023c90: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d .--------------- │ │ │ │ +00023ca0: 2d2d 2d2d 2d2d 2d0a 0a2a 4e6f 7465 204e -------..*Note N │ │ │ │ +00023cb0: 6574 776f 726b 3a3a 2e0a 0a1f 0a46 696c etwork::.....Fil │ │ │ │ +00023cc0: 653a 2067 7275 622e 696e 666f 2c20 204e e: grub.info, N │ │ │ │ +00023cd0: 6f64 653a 206e 6574 5f64 6566 6175 6c74 ode: net_default │ │ │ │ +00023ce0: 5f6d 6163 2c20 204e 6578 743a 206e 6574 _mac, Next: net │ │ │ │ +00023cf0: 5f64 6566 6175 6c74 5f73 6572 7665 722c _default_server, │ │ │ │ +00023d00: 2020 5072 6576 3a20 6e65 745f 6465 6661 Prev: net_defa │ │ │ │ +00023d10: 756c 745f 6970 2c20 2055 703a 2053 7065 ult_ip, Up: Spe │ │ │ │ +00023d20: 6369 616c 2065 6e76 6972 6f6e 6d65 6e74 cial environment │ │ │ │ +00023d30: 2076 6172 6961 626c 6573 0a0a 3135 2e31 variables..15.1 │ │ │ │ +00023d40: 2e33 3320 6e65 745f 6465 6661 756c 745f .33 net_default_ │ │ │ │ +00023d50: 6d61 630a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d mac.------------ │ │ │ │ +00023d60: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a2a 4e6f -----------..*No │ │ │ │ +00023d70: 7465 204e 6574 776f 726b 3a3a 2e0a 0a1f te Network::.... │ │ │ │ +00023d80: 0a46 696c 653a 2067 7275 622e 696e 666f .File: grub.info │ │ │ │ +00023d90: 2c20 204e 6f64 653a 206e 6574 5f64 6566 , Node: net_def │ │ │ │ +00023da0: 6175 6c74 5f73 6572 7665 722c 2020 4e65 ault_server, Ne │ │ │ │ +00023db0: 7874 3a20 7061 6765 722c 2020 5072 6576 xt: pager, Prev │ │ │ │ +00023dc0: 3a20 6e65 745f 6465 6661 756c 745f 6d61 : net_default_ma │ │ │ │ +00023dd0: 632c 2020 5570 3a20 5370 6563 6961 6c20 c, Up: Special │ │ │ │ +00023de0: 656e 7669 726f 6e6d 656e 7420 7661 7269 environment vari │ │ │ │ +00023df0: 6162 6c65 730a 0a31 352e 312e 3334 206e ables..15.1.34 n │ │ │ │ +00023e00: 6574 5f64 6566 6175 6c74 5f73 6572 7665 et_default_serve │ │ │ │ +00023e10: 720a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d r.-------------- │ │ │ │ +00023e20: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 2a4e ------------..*N │ │ │ │ +00023e30: 6f74 6520 4e65 7477 6f72 6b3a 3a2e 0a0a ote Network::... │ │ │ │ +00023e40: 1f0a 4669 6c65 3a20 6772 7562 2e69 6e66 ..File: grub.inf │ │ │ │ +00023e50: 6f2c 2020 4e6f 6465 3a20 7061 6765 722c o, Node: pager, │ │ │ │ +00023e60: 2020 4e65 7874 3a20 7072 6566 6978 2c20 Next: prefix, │ │ │ │ +00023e70: 2050 7265 763a 206e 6574 5f64 6566 6175 Prev: net_defau │ │ │ │ +00023e80: 6c74 5f73 6572 7665 722c 2020 5570 3a20 lt_server, Up: │ │ │ │ +00023e90: 5370 6563 6961 6c20 656e 7669 726f 6e6d Special environm │ │ │ │ +00023ea0: 656e 7420 7661 7269 6162 6c65 730a 0a31 ent variables..1 │ │ │ │ +00023eb0: 352e 312e 3335 2070 6167 6572 0a2d 2d2d 5.1.35 pager.--- │ │ │ │ +00023ec0: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 4966 2073 ----------..If s │ │ │ │ +00023ed0: 6574 2074 6f20 2731 272c 2070 6175 7365 et to '1', pause │ │ │ │ +00023ee0: 206f 7574 7075 7420 6166 7465 7220 6561 output after ea │ │ │ │ +00023ef0: 6368 2073 6372 6565 6e66 756c 2061 6e64 ch screenful and │ │ │ │ +00023f00: 2077 6169 7420 666f 7220 6b65 7962 6f61 wait for keyboa │ │ │ │ +00023f10: 7264 0a69 6e70 7574 2e20 2054 6865 2064 rd.input. The d │ │ │ │ +00023f20: 6566 6175 6c74 2069 7320 6e6f 7420 746f efault is not to │ │ │ │ +00023f30: 2070 6175 7365 206f 7574 7075 742e 0a0a pause output... │ │ │ │ +00023f40: 1f0a 4669 6c65 3a20 6772 7562 2e69 6e66 ..File: grub.inf │ │ │ │ +00023f50: 6f2c 2020 4e6f 6465 3a20 7072 6566 6978 o, Node: prefix │ │ │ │ +00023f60: 2c20 204e 6578 743a 2070 7865 5f62 6c6b , Next: pxe_blk │ │ │ │ +00023f70: 7369 7a65 2c20 2050 7265 763a 2070 6167 size, Prev: pag │ │ │ │ +00023f80: 6572 2c20 2055 703a 2053 7065 6369 616c er, Up: Special │ │ │ │ +00023f90: 2065 6e76 6972 6f6e 6d65 6e74 2076 6172 environment var │ │ │ │ +00023fa0: 6961 626c 6573 0a0a 3135 2e31 2e33 3620 iables..15.1.36 │ │ │ │ +00023fb0: 7072 6566 6978 0a2d 2d2d 2d2d 2d2d 2d2d prefix.--------- │ │ │ │ +00023fc0: 2d2d 2d2d 2d0a 0a54 6865 206c 6f63 6174 -----..The locat │ │ │ │ +00023fd0: 696f 6e20 6f66 2074 6865 2027 2f62 6f6f ion of the '/boo │ │ │ │ +00023fe0: 742f 6772 7562 2720 6469 7265 6374 6f72 t/grub' director │ │ │ │ +00023ff0: 7920 6173 2061 6e20 6162 736f 6c75 7465 y as an absolute │ │ │ │ +00024000: 2066 696c 6520 6e61 6d65 0a28 2a6e 6f74 file name.(*not │ │ │ │ +00024010: 6520 4669 6c65 206e 616d 6520 7379 6e74 e File name synt │ │ │ │ +00024020: 6178 3a3a 292e 2020 5468 6973 2069 7320 ax::). This is │ │ │ │ +00024030: 6e6f 726d 616c 6c79 2073 6574 2062 7920 normally set by │ │ │ │ +00024040: 4752 5542 2061 7420 7374 6172 7475 700a GRUB at startup. │ │ │ │ +00024050: 6261 7365 6420 6f6e 2069 6e66 6f72 6d61 based on informa │ │ │ │ +00024060: 7469 6f6e 2070 726f 7669 6465 6420 6279 tion provided by │ │ │ │ +00024070: 2027 6772 7562 2d69 6e73 7461 6c6c 272e 'grub-install'. │ │ │ │ +00024080: 2020 4752 5542 206d 6f64 756c 6573 2061 GRUB modules a │ │ │ │ +00024090: 7265 0a64 796e 616d 6963 616c 6c79 206c re.dynamically l │ │ │ │ +000240a0: 6f61 6465 6420 6672 6f6d 2074 6869 7320 oaded from this │ │ │ │ +000240b0: 6469 7265 6374 6f72 792c 2073 6f20 6974 directory, so it │ │ │ │ +000240c0: 206d 7573 7420 6265 2073 6574 2063 6f72 must be set cor │ │ │ │ +000240d0: 7265 6374 6c79 2069 6e0a 6f72 6465 7220 rectly in.order │ │ │ │ +000240e0: 666f 7220 6d61 6e79 2070 6172 7473 206f for many parts o │ │ │ │ +000240f0: 6620 4752 5542 2074 6f20 776f 726b 2e0a f GRUB to work.. │ │ │ │ +00024100: 0a1f 0a46 696c 653a 2067 7275 622e 696e ...File: grub.in │ │ │ │ +00024110: 666f 2c20 204e 6f64 653a 2070 7865 5f62 fo, Node: pxe_b │ │ │ │ +00024120: 6c6b 7369 7a65 2c20 204e 6578 743a 2070 lksize, Next: p │ │ │ │ +00024130: 7865 5f64 6566 6175 6c74 5f67 6174 6577 xe_default_gatew │ │ │ │ +00024140: 6179 2c20 2050 7265 763a 2070 7265 6669 ay, Prev: prefi │ │ │ │ +00024150: 782c 2020 5570 3a20 5370 6563 6961 6c20 x, Up: Special │ │ │ │ +00024160: 656e 7669 726f 6e6d 656e 7420 7661 7269 environment vari │ │ │ │ +00024170: 6162 6c65 730a 0a31 352e 312e 3337 2070 ables..15.1.37 p │ │ │ │ +00024180: 7865 5f62 6c6b 7369 7a65 0a2d 2d2d 2d2d xe_blksize.----- │ │ │ │ +00024190: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a --------------.. │ │ │ │ +000241a0: 2a4e 6f74 6520 4e65 7477 6f72 6b3a 3a2e *Note Network::. │ │ │ │ +000241b0: 0a0a 1f0a 4669 6c65 3a20 6772 7562 2e69 ....File: grub.i │ │ │ │ +000241c0: 6e66 6f2c 2020 4e6f 6465 3a20 7078 655f nfo, Node: pxe_ │ │ │ │ +000241d0: 6465 6661 756c 745f 6761 7465 7761 792c default_gateway, │ │ │ │ +000241e0: 2020 4e65 7874 3a20 7078 655f 6465 6661 Next: pxe_defa │ │ │ │ +000241f0: 756c 745f 7365 7276 6572 2c20 2050 7265 ult_server, Pre │ │ │ │ +00024200: 763a 2070 7865 5f62 6c6b 7369 7a65 2c20 v: pxe_blksize, │ │ │ │ +00024210: 2055 703a 2053 7065 6369 616c 2065 6e76 Up: Special env │ │ │ │ +00024220: 6972 6f6e 6d65 6e74 2076 6172 6961 626c ironment variabl │ │ │ │ +00024230: 6573 0a0a 3135 2e31 2e33 3820 7078 655f es..15.1.38 pxe_ │ │ │ │ +00024240: 6465 6661 756c 745f 6761 7465 7761 790a default_gateway. │ │ │ │ 00024250: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ -00024260: 2d2d 2d2d 2d2d 2d0a 0a2a 4e6f 7465 204e -------..*Note N │ │ │ │ -00024270: 6574 776f 726b 3a3a 2e0a 0a1f 0a46 696c etwork::.....Fil │ │ │ │ -00024280: 653a 2067 7275 622e 696e 666f 2c20 204e e: grub.info, N │ │ │ │ -00024290: 6f64 653a 2070 7865 5f64 6566 6175 6c74 ode: pxe_default │ │ │ │ -000242a0: 5f73 6572 7665 722c 2020 4e65 7874 3a20 _server, Next: │ │ │ │ -000242b0: 726f 6f74 2c20 2050 7265 763a 2070 7865 root, Prev: pxe │ │ │ │ -000242c0: 5f64 6566 6175 6c74 5f67 6174 6577 6179 _default_gateway │ │ │ │ -000242d0: 2c20 2055 703a 2053 7065 6369 616c 2065 , Up: Special e │ │ │ │ -000242e0: 6e76 6972 6f6e 6d65 6e74 2076 6172 6961 nvironment varia │ │ │ │ -000242f0: 626c 6573 0a0a 3135 2e31 2e33 3920 7078 bles..15.1.39 px │ │ │ │ -00024300: 655f 6465 6661 756c 745f 7365 7276 6572 e_default_server │ │ │ │ -00024310: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d .--------------- │ │ │ │ -00024320: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a2a 4e6f -----------..*No │ │ │ │ -00024330: 7465 204e 6574 776f 726b 3a3a 2e0a 0a1f te Network::.... │ │ │ │ -00024340: 0a46 696c 653a 2067 7275 622e 696e 666f .File: grub.info │ │ │ │ -00024350: 2c20 204e 6f64 653a 2072 6f6f 742c 2020 , Node: root, │ │ │ │ -00024360: 4e65 7874 3a20 7375 7065 7275 7365 7273 Next: superusers │ │ │ │ -00024370: 2c20 2050 7265 763a 2070 7865 5f64 6566 , Prev: pxe_def │ │ │ │ -00024380: 6175 6c74 5f73 6572 7665 722c 2020 5570 ault_server, Up │ │ │ │ -00024390: 3a20 5370 6563 6961 6c20 656e 7669 726f : Special enviro │ │ │ │ -000243a0: 6e6d 656e 7420 7661 7269 6162 6c65 730a nment variables. │ │ │ │ -000243b0: 0a31 352e 312e 3430 2072 6f6f 740a 2d2d .15.1.40 root.-- │ │ │ │ -000243c0: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 5468 6520 ----------..The │ │ │ │ -000243d0: 726f 6f74 2064 6576 6963 6520 6e61 6d65 root device name │ │ │ │ -000243e0: 2028 2a6e 6f74 6520 4465 7669 6365 2073 (*note Device s │ │ │ │ -000243f0: 796e 7461 783a 3a29 2e20 2041 6e79 2066 yntax::). Any f │ │ │ │ -00024400: 696c 6520 6e61 6d65 7320 7468 6174 2064 ile names that d │ │ │ │ -00024410: 6f0a 6e6f 7420 7370 6563 6966 7920 616e o.not specify an │ │ │ │ -00024420: 2065 7870 6c69 6369 7420 6465 7669 6365 explicit device │ │ │ │ -00024430: 206e 616d 6520 6172 6520 7265 6164 2066 name are read f │ │ │ │ -00024440: 726f 6d20 7468 6973 2064 6576 6963 652e rom this device. │ │ │ │ -00024450: 2020 5468 650a 6465 6661 756c 7420 6973 The.default is │ │ │ │ -00024460: 206e 6f72 6d61 6c6c 7920 7365 7420 6279 normally set by │ │ │ │ -00024470: 2047 5255 4220 6174 2073 7461 7274 7570 GRUB at startup │ │ │ │ -00024480: 2062 6173 6564 206f 6e20 7468 6520 7661 based on the va │ │ │ │ -00024490: 6c75 6520 6f66 0a27 7072 6566 6978 2720 lue of.'prefix' │ │ │ │ -000244a0: 282a 6e6f 7465 2070 7265 6669 783a 3a29 (*note prefix::) │ │ │ │ -000244b0: 2e0a 0a20 2020 466f 7220 6578 616d 706c ... For exampl │ │ │ │ -000244c0: 652c 2069 6620 4752 5542 2077 6173 2069 e, if GRUB was i │ │ │ │ -000244d0: 6e73 7461 6c6c 6564 2074 6f20 7468 6520 nstalled to the │ │ │ │ -000244e0: 6669 7273 7420 7061 7274 6974 696f 6e20 first partition │ │ │ │ -000244f0: 6f66 2074 6865 0a66 6972 7374 2068 6172 of the.first har │ │ │ │ -00024500: 6420 6469 736b 2c20 7468 656e 2027 7072 d disk, then 'pr │ │ │ │ -00024510: 6566 6978 2720 6d69 6768 7420 6265 2073 efix' might be s │ │ │ │ -00024520: 6574 2074 6f20 2728 6864 302c 6d73 646f et to '(hd0,msdo │ │ │ │ -00024530: 7331 292f 626f 6f74 2f67 7275 6227 0a61 s1)/boot/grub'.a │ │ │ │ -00024540: 6e64 2027 726f 6f74 2720 746f 2027 6864 nd 'root' to 'hd │ │ │ │ -00024550: 302c 6d73 646f 7331 272e 0a0a 1f0a 4669 0,msdos1'.....Fi │ │ │ │ -00024560: 6c65 3a20 6772 7562 2e69 6e66 6f2c 2020 le: grub.info, │ │ │ │ -00024570: 4e6f 6465 3a20 7375 7065 7275 7365 7273 Node: superusers │ │ │ │ -00024580: 2c20 204e 6578 743a 2074 6865 6d65 2c20 , Next: theme, │ │ │ │ -00024590: 2050 7265 763a 2072 6f6f 742c 2020 5570 Prev: root, Up │ │ │ │ -000245a0: 3a20 5370 6563 6961 6c20 656e 7669 726f : Special enviro │ │ │ │ -000245b0: 6e6d 656e 7420 7661 7269 6162 6c65 730a nment variables. │ │ │ │ -000245c0: 0a31 352e 312e 3431 2073 7570 6572 7573 .15.1.41 superus │ │ │ │ -000245d0: 6572 730a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ers.------------ │ │ │ │ -000245e0: 2d2d 2d2d 2d2d 0a0a 5468 6973 2076 6172 ------..This var │ │ │ │ -000245f0: 6961 626c 6520 6d61 7920 6265 2073 6574 iable may be set │ │ │ │ -00024600: 2074 6f20 6120 6c69 7374 206f 6620 7375 to a list of su │ │ │ │ -00024610: 7065 7275 7365 7220 6e61 6d65 7320 746f peruser names to │ │ │ │ -00024620: 2065 6e61 626c 650a 6175 7468 656e 7469 enable.authenti │ │ │ │ -00024630: 6361 7469 6f6e 2073 7570 706f 7274 2e20 cation support. │ │ │ │ -00024640: 202a 4e6f 7465 2053 6563 7572 6974 793a *Note Security: │ │ │ │ -00024650: 3a2e 0a0a 1f0a 4669 6c65 3a20 6772 7562 :.....File: grub │ │ │ │ -00024660: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 7468 .info, Node: th │ │ │ │ -00024670: 656d 652c 2020 4e65 7874 3a20 7469 6d65 eme, Next: time │ │ │ │ -00024680: 6f75 742c 2020 5072 6576 3a20 7375 7065 out, Prev: supe │ │ │ │ -00024690: 7275 7365 7273 2c20 2055 703a 2053 7065 rusers, Up: Spe │ │ │ │ -000246a0: 6369 616c 2065 6e76 6972 6f6e 6d65 6e74 cial environment │ │ │ │ -000246b0: 2076 6172 6961 626c 6573 0a0a 3135 2e31 variables..15.1 │ │ │ │ -000246c0: 2e34 3220 7468 656d 650a 2d2d 2d2d 2d2d .42 theme.------ │ │ │ │ -000246d0: 2d2d 2d2d 2d2d 2d0a 0a54 6869 7320 7661 -------..This va │ │ │ │ -000246e0: 7269 6162 6c65 206d 6179 2062 6520 7365 riable may be se │ │ │ │ -000246f0: 7420 746f 2061 2064 6972 6563 746f 7279 t to a directory │ │ │ │ -00024700: 2063 6f6e 7461 696e 696e 6720 6120 4752 containing a GR │ │ │ │ -00024710: 5542 2067 7261 7068 6963 616c 206d 656e UB graphical men │ │ │ │ -00024720: 750a 7468 656d 652e 2020 2a4e 6f74 6520 u.theme. *Note │ │ │ │ -00024730: 5468 656d 6520 6669 6c65 2066 6f72 6d61 Theme file forma │ │ │ │ -00024740: 743a 3a2e 0a0a 2020 2054 6869 7320 7661 t::... This va │ │ │ │ -00024750: 7269 6162 6c65 2069 7320 6f66 7465 6e20 riable is often │ │ │ │ -00024760: 7365 7420 6279 2027 4752 5542 5f54 4845 set by 'GRUB_THE │ │ │ │ -00024770: 4d45 2720 282a 6e6f 7465 2053 696d 706c ME' (*note Simpl │ │ │ │ -00024780: 650a 636f 6e66 6967 7572 6174 696f 6e3a e.configuration: │ │ │ │ -00024790: 3a29 2e0a 0a1f 0a46 696c 653a 2067 7275 :).....File: gru │ │ │ │ -000247a0: 622e 696e 666f 2c20 204e 6f64 653a 2074 b.info, Node: t │ │ │ │ -000247b0: 696d 656f 7574 2c20 204e 6578 743a 2074 imeout, Next: t │ │ │ │ -000247c0: 696d 656f 7574 5f73 7479 6c65 2c20 2050 imeout_style, P │ │ │ │ -000247d0: 7265 763a 2074 6865 6d65 2c20 2055 703a rev: theme, Up: │ │ │ │ -000247e0: 2053 7065 6369 616c 2065 6e76 6972 6f6e Special environ │ │ │ │ -000247f0: 6d65 6e74 2076 6172 6961 626c 6573 0a0a ment variables.. │ │ │ │ -00024800: 3135 2e31 2e34 3320 7469 6d65 6f75 740a 15.1.43 timeout. │ │ │ │ -00024810: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a ---------------. │ │ │ │ -00024820: 0a49 6620 7468 6973 2076 6172 6961 626c .If this variabl │ │ │ │ -00024830: 6520 6973 2073 6574 2c20 6974 2073 7065 e is set, it spe │ │ │ │ -00024840: 6369 6669 6573 2074 6865 2074 696d 6520 cifies the time │ │ │ │ -00024850: 696e 2073 6563 6f6e 6473 2074 6f20 7761 in seconds to wa │ │ │ │ -00024860: 6974 2066 6f72 0a6b 6579 626f 6172 6420 it for.keyboard │ │ │ │ -00024870: 696e 7075 7420 6265 666f 7265 2062 6f6f input before boo │ │ │ │ -00024880: 7469 6e67 2074 6865 2064 6566 6175 6c74 ting the default │ │ │ │ -00024890: 206d 656e 7520 656e 7472 792e 2020 4120 menu entry. A │ │ │ │ -000248a0: 7469 6d65 6f75 7420 6f66 2027 3027 0a6d timeout of '0'.m │ │ │ │ -000248b0: 6561 6e73 2074 6f20 626f 6f74 2074 6865 eans to boot the │ │ │ │ -000248c0: 2064 6566 6175 6c74 2065 6e74 7279 2069 default entry i │ │ │ │ -000248d0: 6d6d 6564 6961 7465 6c79 2077 6974 686f mmediately witho │ │ │ │ -000248e0: 7574 2064 6973 706c 6179 696e 6720 7468 ut displaying th │ │ │ │ -000248f0: 6520 6d65 6e75 3b0a 6120 7469 6d65 6f75 e menu;.a timeou │ │ │ │ -00024900: 7420 6f66 2027 2d31 2720 286f 7220 756e t of '-1' (or un │ │ │ │ -00024910: 7365 7429 206d 6561 6e73 2074 6f20 7761 set) means to wa │ │ │ │ -00024920: 6974 2069 6e64 6566 696e 6974 656c 792e it indefinitely. │ │ │ │ -00024930: 0a0a 2020 2049 6620 2774 696d 656f 7574 .. If 'timeout │ │ │ │ -00024940: 5f73 7479 6c65 2720 282a 6e6f 7465 2074 _style' (*note t │ │ │ │ -00024950: 696d 656f 7574 5f73 7479 6c65 3a3a 2920 imeout_style::) │ │ │ │ -00024960: 6973 2073 6574 2074 6f20 2763 6f75 6e74 is set to 'count │ │ │ │ -00024970: 646f 776e 2720 6f72 0a27 6869 6464 656e down' or.'hidden │ │ │ │ -00024980: 272c 2074 6865 2074 696d 656f 7574 2069 ', the timeout i │ │ │ │ -00024990: 7320 696e 7374 6561 6420 636f 756e 7465 s instead counte │ │ │ │ -000249a0: 6420 6265 666f 7265 2074 6865 206d 656e d before the men │ │ │ │ -000249b0: 7520 6973 2064 6973 706c 6179 6564 2e0a u is displayed.. │ │ │ │ -000249c0: 0a20 2020 5468 6973 2076 6172 6961 626c . This variabl │ │ │ │ -000249d0: 6520 6973 206f 6674 656e 2073 6574 2062 e is often set b │ │ │ │ -000249e0: 7920 2747 5255 425f 5449 4d45 4f55 5427 y 'GRUB_TIMEOUT' │ │ │ │ -000249f0: 2028 2a6e 6f74 6520 5369 6d70 6c65 0a63 (*note Simple.c │ │ │ │ -00024a00: 6f6e 6669 6775 7261 7469 6f6e 3a3a 292e onfiguration::). │ │ │ │ -00024a10: 0a0a 1f0a 4669 6c65 3a20 6772 7562 2e69 ....File: grub.i │ │ │ │ -00024a20: 6e66 6f2c 2020 4e6f 6465 3a20 7469 6d65 nfo, Node: time │ │ │ │ -00024a30: 6f75 745f 7374 796c 652c 2020 5072 6576 out_style, Prev │ │ │ │ -00024a40: 3a20 7469 6d65 6f75 742c 2020 5570 3a20 : timeout, Up: │ │ │ │ -00024a50: 5370 6563 6961 6c20 656e 7669 726f 6e6d Special environm │ │ │ │ -00024a60: 656e 7420 7661 7269 6162 6c65 730a 0a31 ent variables..1 │ │ │ │ -00024a70: 352e 312e 3434 2074 696d 656f 7574 5f73 5.1.44 timeout_s │ │ │ │ -00024a80: 7479 6c65 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d tyle.----------- │ │ │ │ -00024a90: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 5468 6973 ----------..This │ │ │ │ -00024aa0: 2076 6172 6961 626c 6520 6d61 7920 6265 variable may be │ │ │ │ -00024ab0: 2073 6574 2074 6f20 276d 656e 7527 2c20 set to 'menu', │ │ │ │ -00024ac0: 2763 6f75 6e74 646f 776e 272c 206f 7220 'countdown', or │ │ │ │ -00024ad0: 2768 6964 6465 6e27 2074 6f20 636f 6e74 'hidden' to cont │ │ │ │ -00024ae0: 726f 6c0a 7468 6520 7761 7920 696e 2077 rol.the way in w │ │ │ │ -00024af0: 6869 6368 2074 6865 2074 696d 656f 7574 hich the timeout │ │ │ │ -00024b00: 2028 2a6e 6f74 6520 7469 6d65 6f75 743a (*note timeout: │ │ │ │ -00024b10: 3a29 2069 6e74 6572 6163 7473 2077 6974 :) interacts wit │ │ │ │ -00024b20: 6820 6469 7370 6c61 7969 6e67 0a74 6865 h displaying.the │ │ │ │ -00024b30: 206d 656e 752e 2020 5365 6520 7468 6520 menu. See the │ │ │ │ -00024b40: 646f 6375 6d65 6e74 6174 696f 6e20 6f66 documentation of │ │ │ │ -00024b50: 2027 4752 5542 5f54 494d 454f 5554 5f53 'GRUB_TIMEOUT_S │ │ │ │ -00024b60: 5459 4c45 2720 282a 6e6f 7465 2053 696d TYLE' (*note Sim │ │ │ │ -00024b70: 706c 650a 636f 6e66 6967 7572 6174 696f ple.configuratio │ │ │ │ -00024b80: 6e3a 3a29 2066 6f72 2064 6574 6169 6c73 n::) for details │ │ │ │ -00024b90: 2e0a 0a1f 0a46 696c 653a 2067 7275 622e .....File: grub. │ │ │ │ -00024ba0: 696e 666f 2c20 204e 6f64 653a 2045 6e76 info, Node: Env │ │ │ │ -00024bb0: 6972 6f6e 6d65 6e74 2062 6c6f 636b 2c20 ironment block, │ │ │ │ -00024bc0: 2050 7265 763a 2053 7065 6369 616c 2065 Prev: Special e │ │ │ │ -00024bd0: 6e76 6972 6f6e 6d65 6e74 2076 6172 6961 nvironment varia │ │ │ │ -00024be0: 626c 6573 2c20 2055 703a 2045 6e76 6972 bles, Up: Envir │ │ │ │ -00024bf0: 6f6e 6d65 6e74 0a0a 3135 2e32 2054 6865 onment..15.2 The │ │ │ │ -00024c00: 2047 5255 4220 656e 7669 726f 6e6d 656e GRUB environmen │ │ │ │ -00024c10: 7420 626c 6f63 6b0a 3d3d 3d3d 3d3d 3d3d t block.======== │ │ │ │ +00024260: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a2a 4e6f -----------..*No │ │ │ │ +00024270: 7465 204e 6574 776f 726b 3a3a 2e0a 0a1f te Network::.... │ │ │ │ +00024280: 0a46 696c 653a 2067 7275 622e 696e 666f .File: grub.info │ │ │ │ +00024290: 2c20 204e 6f64 653a 2070 7865 5f64 6566 , Node: pxe_def │ │ │ │ +000242a0: 6175 6c74 5f73 6572 7665 722c 2020 4e65 ault_server, Ne │ │ │ │ +000242b0: 7874 3a20 726f 6f74 2c20 2050 7265 763a xt: root, Prev: │ │ │ │ +000242c0: 2070 7865 5f64 6566 6175 6c74 5f67 6174 pxe_default_gat │ │ │ │ +000242d0: 6577 6179 2c20 2055 703a 2053 7065 6369 eway, Up: Speci │ │ │ │ +000242e0: 616c 2065 6e76 6972 6f6e 6d65 6e74 2076 al environment v │ │ │ │ +000242f0: 6172 6961 626c 6573 0a0a 3135 2e31 2e33 ariables..15.1.3 │ │ │ │ +00024300: 3920 7078 655f 6465 6661 756c 745f 7365 9 pxe_default_se │ │ │ │ +00024310: 7276 6572 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d rver.----------- │ │ │ │ +00024320: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a ---------------. │ │ │ │ +00024330: 0a2a 4e6f 7465 204e 6574 776f 726b 3a3a .*Note Network:: │ │ │ │ +00024340: 2e0a 0a1f 0a46 696c 653a 2067 7275 622e .....File: grub. │ │ │ │ +00024350: 696e 666f 2c20 204e 6f64 653a 2072 6f6f info, Node: roo │ │ │ │ +00024360: 742c 2020 4e65 7874 3a20 7375 7065 7275 t, Next: superu │ │ │ │ +00024370: 7365 7273 2c20 2050 7265 763a 2070 7865 sers, Prev: pxe │ │ │ │ +00024380: 5f64 6566 6175 6c74 5f73 6572 7665 722c _default_server, │ │ │ │ +00024390: 2020 5570 3a20 5370 6563 6961 6c20 656e Up: Special en │ │ │ │ +000243a0: 7669 726f 6e6d 656e 7420 7661 7269 6162 vironment variab │ │ │ │ +000243b0: 6c65 730a 0a31 352e 312e 3430 2072 6f6f les..15.1.40 roo │ │ │ │ +000243c0: 740a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a t.------------.. │ │ │ │ +000243d0: 5468 6520 726f 6f74 2064 6576 6963 6520 The root device │ │ │ │ +000243e0: 6e61 6d65 2028 2a6e 6f74 6520 4465 7669 name (*note Devi │ │ │ │ +000243f0: 6365 2073 796e 7461 783a 3a29 2e20 2041 ce syntax::). A │ │ │ │ +00024400: 6e79 2066 696c 6520 6e61 6d65 7320 7468 ny file names th │ │ │ │ +00024410: 6174 2064 6f0a 6e6f 7420 7370 6563 6966 at do.not specif │ │ │ │ +00024420: 7920 616e 2065 7870 6c69 6369 7420 6465 y an explicit de │ │ │ │ +00024430: 7669 6365 206e 616d 6520 6172 6520 7265 vice name are re │ │ │ │ +00024440: 6164 2066 726f 6d20 7468 6973 2064 6576 ad from this dev │ │ │ │ +00024450: 6963 652e 2020 5468 650a 6465 6661 756c ice. The.defaul │ │ │ │ +00024460: 7420 6973 206e 6f72 6d61 6c6c 7920 7365 t is normally se │ │ │ │ +00024470: 7420 6279 2047 5255 4220 6174 2073 7461 t by GRUB at sta │ │ │ │ +00024480: 7274 7570 2062 6173 6564 206f 6e20 7468 rtup based on th │ │ │ │ +00024490: 6520 7661 6c75 6520 6f66 0a27 7072 6566 e value of.'pref │ │ │ │ +000244a0: 6978 2720 282a 6e6f 7465 2070 7265 6669 ix' (*note prefi │ │ │ │ +000244b0: 783a 3a29 2e0a 0a20 2020 466f 7220 6578 x::)... For ex │ │ │ │ +000244c0: 616d 706c 652c 2069 6620 4752 5542 2077 ample, if GRUB w │ │ │ │ +000244d0: 6173 2069 6e73 7461 6c6c 6564 2074 6f20 as installed to │ │ │ │ +000244e0: 7468 6520 6669 7273 7420 7061 7274 6974 the first partit │ │ │ │ +000244f0: 696f 6e20 6f66 2074 6865 0a66 6972 7374 ion of the.first │ │ │ │ +00024500: 2068 6172 6420 6469 736b 2c20 7468 656e hard disk, then │ │ │ │ +00024510: 2027 7072 6566 6978 2720 6d69 6768 7420 'prefix' might │ │ │ │ +00024520: 6265 2073 6574 2074 6f20 2728 6864 302c be set to '(hd0, │ │ │ │ +00024530: 6d73 646f 7331 292f 626f 6f74 2f67 7275 msdos1)/boot/gru │ │ │ │ +00024540: 6227 0a61 6e64 2027 726f 6f74 2720 746f b'.and 'root' to │ │ │ │ +00024550: 2027 6864 302c 6d73 646f 7331 272e 0a0a 'hd0,msdos1'... │ │ │ │ +00024560: 1f0a 4669 6c65 3a20 6772 7562 2e69 6e66 ..File: grub.inf │ │ │ │ +00024570: 6f2c 2020 4e6f 6465 3a20 7375 7065 7275 o, Node: superu │ │ │ │ +00024580: 7365 7273 2c20 204e 6578 743a 2074 6865 sers, Next: the │ │ │ │ +00024590: 6d65 2c20 2050 7265 763a 2072 6f6f 742c me, Prev: root, │ │ │ │ +000245a0: 2020 5570 3a20 5370 6563 6961 6c20 656e Up: Special en │ │ │ │ +000245b0: 7669 726f 6e6d 656e 7420 7661 7269 6162 vironment variab │ │ │ │ +000245c0: 6c65 730a 0a31 352e 312e 3431 2073 7570 les..15.1.41 sup │ │ │ │ +000245d0: 6572 7573 6572 730a 2d2d 2d2d 2d2d 2d2d erusers.-------- │ │ │ │ +000245e0: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 5468 6973 ----------..This │ │ │ │ +000245f0: 2076 6172 6961 626c 6520 6d61 7920 6265 variable may be │ │ │ │ +00024600: 2073 6574 2074 6f20 6120 6c69 7374 206f set to a list o │ │ │ │ +00024610: 6620 7375 7065 7275 7365 7220 6e61 6d65 f superuser name │ │ │ │ +00024620: 7320 746f 2065 6e61 626c 650a 6175 7468 s to enable.auth │ │ │ │ +00024630: 656e 7469 6361 7469 6f6e 2073 7570 706f entication suppo │ │ │ │ +00024640: 7274 2e20 202a 4e6f 7465 2053 6563 7572 rt. *Note Secur │ │ │ │ +00024650: 6974 793a 3a2e 0a0a 1f0a 4669 6c65 3a20 ity::.....File: │ │ │ │ +00024660: 6772 7562 2e69 6e66 6f2c 2020 4e6f 6465 grub.info, Node │ │ │ │ +00024670: 3a20 7468 656d 652c 2020 4e65 7874 3a20 : theme, Next: │ │ │ │ +00024680: 7469 6d65 6f75 742c 2020 5072 6576 3a20 timeout, Prev: │ │ │ │ +00024690: 7375 7065 7275 7365 7273 2c20 2055 703a superusers, Up: │ │ │ │ +000246a0: 2053 7065 6369 616c 2065 6e76 6972 6f6e Special environ │ │ │ │ +000246b0: 6d65 6e74 2076 6172 6961 626c 6573 0a0a ment variables.. │ │ │ │ +000246c0: 3135 2e31 2e34 3220 7468 656d 650a 2d2d 15.1.42 theme.-- │ │ │ │ +000246d0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a54 6869 -----------..Thi │ │ │ │ +000246e0: 7320 7661 7269 6162 6c65 206d 6179 2062 s variable may b │ │ │ │ +000246f0: 6520 7365 7420 746f 2061 2064 6972 6563 e set to a direc │ │ │ │ +00024700: 746f 7279 2063 6f6e 7461 696e 696e 6720 tory containing │ │ │ │ +00024710: 6120 4752 5542 2067 7261 7068 6963 616c a GRUB graphical │ │ │ │ +00024720: 206d 656e 750a 7468 656d 652e 2020 2a4e menu.theme. *N │ │ │ │ +00024730: 6f74 6520 5468 656d 6520 6669 6c65 2066 ote Theme file f │ │ │ │ +00024740: 6f72 6d61 743a 3a2e 0a0a 2020 2054 6869 ormat::... Thi │ │ │ │ +00024750: 7320 7661 7269 6162 6c65 2069 7320 6f66 s variable is of │ │ │ │ +00024760: 7465 6e20 7365 7420 6279 2027 4752 5542 ten set by 'GRUB │ │ │ │ +00024770: 5f54 4845 4d45 2720 282a 6e6f 7465 2053 _THEME' (*note S │ │ │ │ +00024780: 696d 706c 650a 636f 6e66 6967 7572 6174 imple.configurat │ │ │ │ +00024790: 696f 6e3a 3a29 2e0a 0a1f 0a46 696c 653a ion::).....File: │ │ │ │ +000247a0: 2067 7275 622e 696e 666f 2c20 204e 6f64 grub.info, Nod │ │ │ │ +000247b0: 653a 2074 696d 656f 7574 2c20 204e 6578 e: timeout, Nex │ │ │ │ +000247c0: 743a 2074 696d 656f 7574 5f73 7479 6c65 t: timeout_style │ │ │ │ +000247d0: 2c20 2050 7265 763a 2074 6865 6d65 2c20 , Prev: theme, │ │ │ │ +000247e0: 2055 703a 2053 7065 6369 616c 2065 6e76 Up: Special env │ │ │ │ +000247f0: 6972 6f6e 6d65 6e74 2076 6172 6961 626c ironment variabl │ │ │ │ +00024800: 6573 0a0a 3135 2e31 2e34 3320 7469 6d65 es..15.1.43 time │ │ │ │ +00024810: 6f75 740a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d out.------------ │ │ │ │ +00024820: 2d2d 2d0a 0a49 6620 7468 6973 2076 6172 ---..If this var │ │ │ │ +00024830: 6961 626c 6520 6973 2073 6574 2c20 6974 iable is set, it │ │ │ │ +00024840: 2073 7065 6369 6669 6573 2074 6865 2074 specifies the t │ │ │ │ +00024850: 696d 6520 696e 2073 6563 6f6e 6473 2074 ime in seconds t │ │ │ │ +00024860: 6f20 7761 6974 2066 6f72 0a6b 6579 626f o wait for.keybo │ │ │ │ +00024870: 6172 6420 696e 7075 7420 6265 666f 7265 ard input before │ │ │ │ +00024880: 2062 6f6f 7469 6e67 2074 6865 2064 6566 booting the def │ │ │ │ +00024890: 6175 6c74 206d 656e 7520 656e 7472 792e ault menu entry. │ │ │ │ +000248a0: 2020 4120 7469 6d65 6f75 7420 6f66 2027 A timeout of ' │ │ │ │ +000248b0: 3027 0a6d 6561 6e73 2074 6f20 626f 6f74 0'.means to boot │ │ │ │ +000248c0: 2074 6865 2064 6566 6175 6c74 2065 6e74 the default ent │ │ │ │ +000248d0: 7279 2069 6d6d 6564 6961 7465 6c79 2077 ry immediately w │ │ │ │ +000248e0: 6974 686f 7574 2064 6973 706c 6179 696e ithout displayin │ │ │ │ +000248f0: 6720 7468 6520 6d65 6e75 3b0a 6120 7469 g the menu;.a ti │ │ │ │ +00024900: 6d65 6f75 7420 6f66 2027 2d31 2720 286f meout of '-1' (o │ │ │ │ +00024910: 7220 756e 7365 7429 206d 6561 6e73 2074 r unset) means t │ │ │ │ +00024920: 6f20 7761 6974 2069 6e64 6566 696e 6974 o wait indefinit │ │ │ │ +00024930: 656c 792e 0a0a 2020 2049 6620 2774 696d ely... If 'tim │ │ │ │ +00024940: 656f 7574 5f73 7479 6c65 2720 282a 6e6f eout_style' (*no │ │ │ │ +00024950: 7465 2074 696d 656f 7574 5f73 7479 6c65 te timeout_style │ │ │ │ +00024960: 3a3a 2920 6973 2073 6574 2074 6f20 2763 ::) is set to 'c │ │ │ │ +00024970: 6f75 6e74 646f 776e 2720 6f72 0a27 6869 ountdown' or.'hi │ │ │ │ +00024980: 6464 656e 272c 2074 6865 2074 696d 656f dden', the timeo │ │ │ │ +00024990: 7574 2069 7320 696e 7374 6561 6420 636f ut is instead co │ │ │ │ +000249a0: 756e 7465 6420 6265 666f 7265 2074 6865 unted before the │ │ │ │ +000249b0: 206d 656e 7520 6973 2064 6973 706c 6179 menu is display │ │ │ │ +000249c0: 6564 2e0a 0a20 2020 5468 6973 2076 6172 ed... This var │ │ │ │ +000249d0: 6961 626c 6520 6973 206f 6674 656e 2073 iable is often s │ │ │ │ +000249e0: 6574 2062 7920 2747 5255 425f 5449 4d45 et by 'GRUB_TIME │ │ │ │ +000249f0: 4f55 5427 2028 2a6e 6f74 6520 5369 6d70 OUT' (*note Simp │ │ │ │ +00024a00: 6c65 0a63 6f6e 6669 6775 7261 7469 6f6e le.configuration │ │ │ │ +00024a10: 3a3a 292e 0a0a 1f0a 4669 6c65 3a20 6772 ::).....File: gr │ │ │ │ +00024a20: 7562 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ub.info, Node: │ │ │ │ +00024a30: 7469 6d65 6f75 745f 7374 796c 652c 2020 timeout_style, │ │ │ │ +00024a40: 5072 6576 3a20 7469 6d65 6f75 742c 2020 Prev: timeout, │ │ │ │ +00024a50: 5570 3a20 5370 6563 6961 6c20 656e 7669 Up: Special envi │ │ │ │ +00024a60: 726f 6e6d 656e 7420 7661 7269 6162 6c65 ronment variable │ │ │ │ +00024a70: 730a 0a31 352e 312e 3434 2074 696d 656f s..15.1.44 timeo │ │ │ │ +00024a80: 7574 5f73 7479 6c65 0a2d 2d2d 2d2d 2d2d ut_style.------- │ │ │ │ +00024a90: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a --------------.. │ │ │ │ +00024aa0: 5468 6973 2076 6172 6961 626c 6520 6d61 This variable ma │ │ │ │ +00024ab0: 7920 6265 2073 6574 2074 6f20 276d 656e y be set to 'men │ │ │ │ +00024ac0: 7527 2c20 2763 6f75 6e74 646f 776e 272c u', 'countdown', │ │ │ │ +00024ad0: 206f 7220 2768 6964 6465 6e27 2074 6f20 or 'hidden' to │ │ │ │ +00024ae0: 636f 6e74 726f 6c0a 7468 6520 7761 7920 control.the way │ │ │ │ +00024af0: 696e 2077 6869 6368 2074 6865 2074 696d in which the tim │ │ │ │ +00024b00: 656f 7574 2028 2a6e 6f74 6520 7469 6d65 eout (*note time │ │ │ │ +00024b10: 6f75 743a 3a29 2069 6e74 6572 6163 7473 out::) interacts │ │ │ │ +00024b20: 2077 6974 6820 6469 7370 6c61 7969 6e67 with displaying │ │ │ │ +00024b30: 0a74 6865 206d 656e 752e 2020 5365 6520 .the menu. See │ │ │ │ +00024b40: 7468 6520 646f 6375 6d65 6e74 6174 696f the documentatio │ │ │ │ +00024b50: 6e20 6f66 2027 4752 5542 5f54 494d 454f n of 'GRUB_TIMEO │ │ │ │ +00024b60: 5554 5f53 5459 4c45 2720 282a 6e6f 7465 UT_STYLE' (*note │ │ │ │ +00024b70: 2053 696d 706c 650a 636f 6e66 6967 7572 Simple.configur │ │ │ │ +00024b80: 6174 696f 6e3a 3a29 2066 6f72 2064 6574 ation::) for det │ │ │ │ +00024b90: 6169 6c73 2e0a 0a1f 0a46 696c 653a 2067 ails.....File: g │ │ │ │ +00024ba0: 7275 622e 696e 666f 2c20 204e 6f64 653a rub.info, Node: │ │ │ │ +00024bb0: 2045 6e76 6972 6f6e 6d65 6e74 2062 6c6f Environment blo │ │ │ │ +00024bc0: 636b 2c20 2050 7265 763a 2053 7065 6369 ck, Prev: Speci │ │ │ │ +00024bd0: 616c 2065 6e76 6972 6f6e 6d65 6e74 2076 al environment v │ │ │ │ +00024be0: 6172 6961 626c 6573 2c20 2055 703a 2045 ariables, Up: E │ │ │ │ +00024bf0: 6e76 6972 6f6e 6d65 6e74 0a0a 3135 2e32 nvironment..15.2 │ │ │ │ +00024c00: 2054 6865 2047 5255 4220 656e 7669 726f The GRUB enviro │ │ │ │ +00024c10: 6e6d 656e 7420 626c 6f63 6b0a 3d3d 3d3d nment block.==== │ │ │ │ 00024c20: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ -00024c30: 3d3d 3d3d 3d3d 3d0a 0a49 7420 6973 206f =======..It is o │ │ │ │ -00024c40: 6674 656e 2075 7365 6675 6c20 746f 2062 ften useful to b │ │ │ │ -00024c50: 6520 6162 6c65 2074 6f20 7265 6d65 6d62 e able to rememb │ │ │ │ -00024c60: 6572 2061 2073 6d61 6c6c 2061 6d6f 756e er a small amoun │ │ │ │ -00024c70: 7420 6f66 2069 6e66 6f72 6d61 7469 6f6e t of information │ │ │ │ -00024c80: 0a66 726f 6d20 6f6e 6520 626f 6f74 2074 .from one boot t │ │ │ │ -00024c90: 6f20 7468 6520 6e65 7874 2e20 2046 6f72 o the next. For │ │ │ │ -00024ca0: 2065 7861 6d70 6c65 2c20 796f 7520 6d69 example, you mi │ │ │ │ -00024cb0: 6768 7420 7761 6e74 2074 6f20 7365 7420 ght want to set │ │ │ │ -00024cc0: 7468 650a 6465 6661 756c 7420 6d65 6e75 the.default menu │ │ │ │ -00024cd0: 2065 6e74 7279 2062 6173 6564 206f 6e20 entry based on │ │ │ │ -00024ce0: 7768 6174 2077 6173 2073 656c 6563 7465 what was selecte │ │ │ │ -00024cf0: 6420 7468 6520 6c61 7374 2074 696d 652e d the last time. │ │ │ │ -00024d00: 2020 4752 5542 0a64 656c 6962 6572 6174 GRUB.deliberat │ │ │ │ -00024d10: 656c 7920 646f 6573 206e 6f74 2069 6d70 ely does not imp │ │ │ │ -00024d20: 6c65 6d65 6e74 2073 7570 706f 7274 2066 lement support f │ │ │ │ -00024d30: 6f72 2077 7269 7469 6e67 2066 696c 6573 or writing files │ │ │ │ -00024d40: 2069 6e20 6f72 6465 7220 746f 0a6d 696e in order to.min │ │ │ │ -00024d50: 696d 6973 6520 7468 6520 706f 7373 6962 imise the possib │ │ │ │ -00024d60: 696c 6974 7920 6f66 2074 6865 2062 6f6f ility of the boo │ │ │ │ -00024d70: 7420 6c6f 6164 6572 2062 6569 6e67 2072 t loader being r │ │ │ │ -00024d80: 6573 706f 6e73 6962 6c65 2066 6f72 2066 esponsible for f │ │ │ │ -00024d90: 696c 650a 7379 7374 656d 2063 6f72 7275 ile.system corru │ │ │ │ -00024da0: 7074 696f 6e2c 2073 6f20 6120 4752 5542 ption, so a GRUB │ │ │ │ -00024db0: 2063 6f6e 6669 6775 7261 7469 6f6e 2066 configuration f │ │ │ │ -00024dc0: 696c 6520 6361 6e6e 6f74 206a 7573 7420 ile cannot just │ │ │ │ -00024dd0: 6372 6561 7465 2061 0a66 696c 6520 696e create a.file in │ │ │ │ -00024de0: 2074 6865 206f 7264 696e 6172 7920 7761 the ordinary wa │ │ │ │ -00024df0: 792e 2020 486f 7765 7665 722c 2047 5255 y. However, GRU │ │ │ │ -00024e00: 4220 7072 6f76 6964 6573 2061 6e20 2265 B provides an "e │ │ │ │ -00024e10: 6e76 6972 6f6e 6d65 6e74 2062 6c6f 636b nvironment block │ │ │ │ -00024e20: 220a 7768 6963 6820 6361 6e20 6265 2075 ".which can be u │ │ │ │ -00024e30: 7365 6420 746f 2073 6176 6520 6120 736d sed to save a sm │ │ │ │ -00024e40: 616c 6c20 616d 6f75 6e74 206f 6620 7374 all amount of st │ │ │ │ -00024e50: 6174 652e 0a0a 2020 2054 6865 2065 6e76 ate... The env │ │ │ │ -00024e60: 6972 6f6e 6d65 6e74 2062 6c6f 636b 2069 ironment block i │ │ │ │ -00024e70: 7320 6120 7072 6561 6c6c 6f63 6174 6564 s a preallocated │ │ │ │ -00024e80: 2031 3032 342d 6279 7465 2066 696c 652c 1024-byte file, │ │ │ │ -00024e90: 2077 6869 6368 0a6e 6f72 6d61 6c6c 7920 which.normally │ │ │ │ -00024ea0: 6c69 7665 7320 696e 2027 2f62 6f6f 742f lives in '/boot/ │ │ │ │ -00024eb0: 6772 7562 2f67 7275 6265 6e76 2720 2861 grub/grubenv' (a │ │ │ │ -00024ec0: 6c74 686f 7567 6820 796f 7520 7368 6f75 lthough you shou │ │ │ │ -00024ed0: 6c64 206e 6f74 2061 7373 756d 650a 7468 ld not assume.th │ │ │ │ -00024ee0: 6973 292e 2020 4174 2062 6f6f 7420 7469 is). At boot ti │ │ │ │ -00024ef0: 6d65 2c20 7468 6520 276c 6f61 645f 656e me, the 'load_en │ │ │ │ -00024f00: 7627 2063 6f6d 6d61 6e64 2028 2a6e 6f74 v' command (*not │ │ │ │ -00024f10: 6520 6c6f 6164 5f65 6e76 3a3a 2920 6c6f e load_env::) lo │ │ │ │ -00024f20: 6164 730a 656e 7669 726f 6e6d 656e 7420 ads.environment │ │ │ │ -00024f30: 7661 7269 6162 6c65 7320 6672 6f6d 2069 variables from i │ │ │ │ -00024f40: 742c 2061 6e64 2074 6865 2027 7361 7665 t, and the 'save │ │ │ │ -00024f50: 5f65 6e76 2720 282a 6e6f 7465 2073 6176 _env' (*note sav │ │ │ │ -00024f60: 655f 656e 763a 3a29 0a63 6f6d 6d61 6e64 e_env::).command │ │ │ │ -00024f70: 2073 6176 6573 2065 6e76 6972 6f6e 6d65 saves environme │ │ │ │ -00024f80: 6e74 2076 6172 6961 626c 6573 2074 6f20 nt variables to │ │ │ │ -00024f90: 6974 2e20 2046 726f 6d20 6120 7275 6e6e it. From a runn │ │ │ │ -00024fa0: 696e 6720 7379 7374 656d 2c20 7468 650a ing system, the. │ │ │ │ -00024fb0: 2767 7275 622d 6564 6974 656e 7627 2075 'grub-editenv' u │ │ │ │ -00024fc0: 7469 6c69 7479 2063 616e 2062 6520 7573 tility can be us │ │ │ │ -00024fd0: 6564 2074 6f20 6564 6974 2074 6865 2065 ed to edit the e │ │ │ │ -00024fe0: 6e76 6972 6f6e 6d65 6e74 2062 6c6f 636b nvironment block │ │ │ │ -00024ff0: 2e0a 0a20 2020 466f 7220 7361 6665 7479 ... For safety │ │ │ │ -00025000: 2072 6561 736f 6e73 2c20 7468 6973 2073 reasons, this s │ │ │ │ -00025010: 746f 7261 6765 2069 7320 6f6e 6c79 2061 torage is only a │ │ │ │ -00025020: 7661 696c 6162 6c65 2077 6865 6e20 696e vailable when in │ │ │ │ -00025030: 7374 616c 6c65 6420 6f6e 0a61 2070 6c61 stalled on.a pla │ │ │ │ -00025040: 696e 2064 6973 6b20 286e 6f20 4c56 4d20 in disk (no LVM │ │ │ │ -00025050: 6f72 2052 4149 4429 2c20 7573 696e 6720 or RAID), using │ │ │ │ -00025060: 6120 6e6f 6e2d 6368 6563 6b73 756d 6d69 a non-checksummi │ │ │ │ -00025070: 6e67 2066 696c 6573 7973 7465 6d20 286e ng filesystem (n │ │ │ │ -00025080: 6f0a 5a46 5329 2c20 616e 6420 7573 696e o.ZFS), and usin │ │ │ │ -00025090: 6720 4249 4f53 206f 7220 4546 4920 6675 g BIOS or EFI fu │ │ │ │ -000250a0: 6e63 7469 6f6e 7320 286e 6f20 4154 412c nctions (no ATA, │ │ │ │ -000250b0: 2055 5342 206f 7220 4945 4545 3132 3735 USB or IEEE1275 │ │ │ │ -000250c0: 292e 0a0a 2020 2027 6772 7562 2d6d 6b63 )... 'grub-mkc │ │ │ │ -000250d0: 6f6e 6669 6727 2075 7365 7320 7468 6973 onfig' uses this │ │ │ │ -000250e0: 2066 6163 696c 6974 7920 746f 2069 6d70 facility to imp │ │ │ │ -000250f0: 6c65 6d65 6e74 2027 4752 5542 5f53 4156 lement 'GRUB_SAV │ │ │ │ -00025100: 4544 4546 4155 4c54 270a 282a 6e6f 7465 EDEFAULT'.(*note │ │ │ │ -00025110: 2053 696d 706c 6520 636f 6e66 6967 7572 Simple configur │ │ │ │ -00025120: 6174 696f 6e3a 3a29 2e0a 0a1f 0a46 696c ation::).....Fil │ │ │ │ -00025130: 653a 2067 7275 622e 696e 666f 2c20 204e e: grub.info, N │ │ │ │ -00025140: 6f64 653a 2043 6f6d 6d61 6e64 732c 2020 ode: Commands, │ │ │ │ -00025150: 4e65 7874 3a20 496e 7465 726e 6174 696f Next: Internatio │ │ │ │ -00025160: 6e61 6c69 7361 7469 6f6e 2c20 2050 7265 nalisation, Pre │ │ │ │ -00025170: 763a 2045 6e76 6972 6f6e 6d65 6e74 2c20 v: Environment, │ │ │ │ -00025180: 2055 703a 2054 6f70 0a0a 3136 2054 6865 Up: Top..16 The │ │ │ │ -00025190: 206c 6973 7420 6f66 2061 7661 696c 6162 list of availab │ │ │ │ -000251a0: 6c65 2063 6f6d 6d61 6e64 730a 2a2a 2a2a le commands.**** │ │ │ │ +00024c30: 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a49 7420 ===========..It │ │ │ │ +00024c40: 6973 206f 6674 656e 2075 7365 6675 6c20 is often useful │ │ │ │ +00024c50: 746f 2062 6520 6162 6c65 2074 6f20 7265 to be able to re │ │ │ │ +00024c60: 6d65 6d62 6572 2061 2073 6d61 6c6c 2061 member a small a │ │ │ │ +00024c70: 6d6f 756e 7420 6f66 2069 6e66 6f72 6d61 mount of informa │ │ │ │ +00024c80: 7469 6f6e 0a66 726f 6d20 6f6e 6520 626f tion.from one bo │ │ │ │ +00024c90: 6f74 2074 6f20 7468 6520 6e65 7874 2e20 ot to the next. │ │ │ │ +00024ca0: 2046 6f72 2065 7861 6d70 6c65 2c20 796f For example, yo │ │ │ │ +00024cb0: 7520 6d69 6768 7420 7761 6e74 2074 6f20 u might want to │ │ │ │ +00024cc0: 7365 7420 7468 650a 6465 6661 756c 7420 set the.default │ │ │ │ +00024cd0: 6d65 6e75 2065 6e74 7279 2062 6173 6564 menu entry based │ │ │ │ +00024ce0: 206f 6e20 7768 6174 2077 6173 2073 656c on what was sel │ │ │ │ +00024cf0: 6563 7465 6420 7468 6520 6c61 7374 2074 ected the last t │ │ │ │ +00024d00: 696d 652e 2020 4752 5542 0a64 656c 6962 ime. GRUB.delib │ │ │ │ +00024d10: 6572 6174 656c 7920 646f 6573 206e 6f74 erately does not │ │ │ │ +00024d20: 2069 6d70 6c65 6d65 6e74 2073 7570 706f implement suppo │ │ │ │ +00024d30: 7274 2066 6f72 2077 7269 7469 6e67 2066 rt for writing f │ │ │ │ +00024d40: 696c 6573 2069 6e20 6f72 6465 7220 746f iles in order to │ │ │ │ +00024d50: 0a6d 696e 696d 6973 6520 7468 6520 706f .minimise the po │ │ │ │ +00024d60: 7373 6962 696c 6974 7920 6f66 2074 6865 ssibility of the │ │ │ │ +00024d70: 2062 6f6f 7420 6c6f 6164 6572 2062 6569 boot loader bei │ │ │ │ +00024d80: 6e67 2072 6573 706f 6e73 6962 6c65 2066 ng responsible f │ │ │ │ +00024d90: 6f72 2066 696c 650a 7379 7374 656d 2063 or file.system c │ │ │ │ +00024da0: 6f72 7275 7074 696f 6e2c 2073 6f20 6120 orruption, so a │ │ │ │ +00024db0: 4752 5542 2063 6f6e 6669 6775 7261 7469 GRUB configurati │ │ │ │ +00024dc0: 6f6e 2066 696c 6520 6361 6e6e 6f74 206a on file cannot j │ │ │ │ +00024dd0: 7573 7420 6372 6561 7465 2061 0a66 696c ust create a.fil │ │ │ │ +00024de0: 6520 696e 2074 6865 206f 7264 696e 6172 e in the ordinar │ │ │ │ +00024df0: 7920 7761 792e 2020 486f 7765 7665 722c y way. However, │ │ │ │ +00024e00: 2047 5255 4220 7072 6f76 6964 6573 2061 GRUB provides a │ │ │ │ +00024e10: 6e20 2265 6e76 6972 6f6e 6d65 6e74 2062 n "environment b │ │ │ │ +00024e20: 6c6f 636b 220a 7768 6963 6820 6361 6e20 lock".which can │ │ │ │ +00024e30: 6265 2075 7365 6420 746f 2073 6176 6520 be used to save │ │ │ │ +00024e40: 6120 736d 616c 6c20 616d 6f75 6e74 206f a small amount o │ │ │ │ +00024e50: 6620 7374 6174 652e 0a0a 2020 2054 6865 f state... The │ │ │ │ +00024e60: 2065 6e76 6972 6f6e 6d65 6e74 2062 6c6f environment blo │ │ │ │ +00024e70: 636b 2069 7320 6120 7072 6561 6c6c 6f63 ck is a prealloc │ │ │ │ +00024e80: 6174 6564 2031 3032 342d 6279 7465 2066 ated 1024-byte f │ │ │ │ +00024e90: 696c 652c 2077 6869 6368 0a6e 6f72 6d61 ile, which.norma │ │ │ │ +00024ea0: 6c6c 7920 6c69 7665 7320 696e 2027 2f62 lly lives in '/b │ │ │ │ +00024eb0: 6f6f 742f 6772 7562 2f67 7275 6265 6e76 oot/grub/grubenv │ │ │ │ +00024ec0: 2720 2861 6c74 686f 7567 6820 796f 7520 ' (although you │ │ │ │ +00024ed0: 7368 6f75 6c64 206e 6f74 2061 7373 756d should not assum │ │ │ │ +00024ee0: 650a 7468 6973 292e 2020 4174 2062 6f6f e.this). At boo │ │ │ │ +00024ef0: 7420 7469 6d65 2c20 7468 6520 276c 6f61 t time, the 'loa │ │ │ │ +00024f00: 645f 656e 7627 2063 6f6d 6d61 6e64 2028 d_env' command ( │ │ │ │ +00024f10: 2a6e 6f74 6520 6c6f 6164 5f65 6e76 3a3a *note load_env:: │ │ │ │ +00024f20: 2920 6c6f 6164 730a 656e 7669 726f 6e6d ) loads.environm │ │ │ │ +00024f30: 656e 7420 7661 7269 6162 6c65 7320 6672 ent variables fr │ │ │ │ +00024f40: 6f6d 2069 742c 2061 6e64 2074 6865 2027 om it, and the ' │ │ │ │ +00024f50: 7361 7665 5f65 6e76 2720 282a 6e6f 7465 save_env' (*note │ │ │ │ +00024f60: 2073 6176 655f 656e 763a 3a29 0a63 6f6d save_env::).com │ │ │ │ +00024f70: 6d61 6e64 2073 6176 6573 2065 6e76 6972 mand saves envir │ │ │ │ +00024f80: 6f6e 6d65 6e74 2076 6172 6961 626c 6573 onment variables │ │ │ │ +00024f90: 2074 6f20 6974 2e20 2046 726f 6d20 6120 to it. From a │ │ │ │ +00024fa0: 7275 6e6e 696e 6720 7379 7374 656d 2c20 running system, │ │ │ │ +00024fb0: 7468 650a 2767 7275 622d 6564 6974 656e the.'grub-editen │ │ │ │ +00024fc0: 7627 2075 7469 6c69 7479 2063 616e 2062 v' utility can b │ │ │ │ +00024fd0: 6520 7573 6564 2074 6f20 6564 6974 2074 e used to edit t │ │ │ │ +00024fe0: 6865 2065 6e76 6972 6f6e 6d65 6e74 2062 he environment b │ │ │ │ +00024ff0: 6c6f 636b 2e0a 0a20 2020 466f 7220 7361 lock... For sa │ │ │ │ +00025000: 6665 7479 2072 6561 736f 6e73 2c20 7468 fety reasons, th │ │ │ │ +00025010: 6973 2073 746f 7261 6765 2069 7320 6f6e is storage is on │ │ │ │ +00025020: 6c79 2061 7661 696c 6162 6c65 2077 6865 ly available whe │ │ │ │ +00025030: 6e20 696e 7374 616c 6c65 6420 6f6e 0a61 n installed on.a │ │ │ │ +00025040: 2070 6c61 696e 2064 6973 6b20 286e 6f20 plain disk (no │ │ │ │ +00025050: 4c56 4d20 6f72 2052 4149 4429 2c20 7573 LVM or RAID), us │ │ │ │ +00025060: 696e 6720 6120 6e6f 6e2d 6368 6563 6b73 ing a non-checks │ │ │ │ +00025070: 756d 6d69 6e67 2066 696c 6573 7973 7465 umming filesyste │ │ │ │ +00025080: 6d20 286e 6f0a 5a46 5329 2c20 616e 6420 m (no.ZFS), and │ │ │ │ +00025090: 7573 696e 6720 4249 4f53 206f 7220 4546 using BIOS or EF │ │ │ │ +000250a0: 4920 6675 6e63 7469 6f6e 7320 286e 6f20 I functions (no │ │ │ │ +000250b0: 4154 412c 2055 5342 206f 7220 4945 4545 ATA, USB or IEEE │ │ │ │ +000250c0: 3132 3735 292e 0a0a 2020 2027 6772 7562 1275)... 'grub │ │ │ │ +000250d0: 2d6d 6b63 6f6e 6669 6727 2075 7365 7320 -mkconfig' uses │ │ │ │ +000250e0: 7468 6973 2066 6163 696c 6974 7920 746f this facility to │ │ │ │ +000250f0: 2069 6d70 6c65 6d65 6e74 2027 4752 5542 implement 'GRUB │ │ │ │ +00025100: 5f53 4156 4544 4546 4155 4c54 270a 282a _SAVEDEFAULT'.(* │ │ │ │ +00025110: 6e6f 7465 2053 696d 706c 6520 636f 6e66 note Simple conf │ │ │ │ +00025120: 6967 7572 6174 696f 6e3a 3a29 2e0a 0a1f iguration::).... │ │ │ │ +00025130: 0a46 696c 653a 2067 7275 622e 696e 666f .File: grub.info │ │ │ │ +00025140: 2c20 204e 6f64 653a 2043 6f6d 6d61 6e64 , Node: Command │ │ │ │ +00025150: 732c 2020 4e65 7874 3a20 496e 7465 726e s, Next: Intern │ │ │ │ +00025160: 6174 696f 6e61 6c69 7361 7469 6f6e 2c20 ationalisation, │ │ │ │ +00025170: 2050 7265 763a 2045 6e76 6972 6f6e 6d65 Prev: Environme │ │ │ │ +00025180: 6e74 2c20 2055 703a 2054 6f70 0a0a 3136 nt, Up: Top..16 │ │ │ │ +00025190: 2054 6865 206c 6973 7420 6f66 2061 7661 The list of ava │ │ │ │ +000251a0: 696c 6162 6c65 2063 6f6d 6d61 6e64 730a ilable commands. │ │ │ │ 000251b0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ -000251c0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a0a 0a49 *************..I │ │ │ │ -000251d0: 6e20 7468 6973 2063 6861 7074 6572 2c20 n this chapter, │ │ │ │ -000251e0: 7765 206c 6973 7420 616c 6c20 636f 6d6d we list all comm │ │ │ │ -000251f0: 616e 6473 2074 6861 7420 6172 6520 6176 ands that are av │ │ │ │ -00025200: 6169 6c61 626c 6520 696e 2047 5255 422e ailable in GRUB. │ │ │ │ -00025210: 0a0a 2020 2043 6f6d 6d61 6e64 7320 6265 .. Commands be │ │ │ │ -00025220: 6c6f 6e67 2074 6f20 6469 6666 6572 656e long to differen │ │ │ │ -00025230: 7420 6772 6f75 7073 2e20 2041 2066 6577 t groups. A few │ │ │ │ -00025240: 2063 616e 206f 6e6c 7920 6265 2075 7365 can only be use │ │ │ │ -00025250: 6420 696e 2074 6865 0a67 6c6f 6261 6c20 d in the.global │ │ │ │ -00025260: 7365 6374 696f 6e20 6f66 2074 6865 2063 section of the c │ │ │ │ -00025270: 6f6e 6669 6775 7261 7469 6f6e 2066 696c onfiguration fil │ │ │ │ -00025280: 6520 286f 7220 226d 656e 7522 293b 206d e (or "menu"); m │ │ │ │ -00025290: 6f73 7420 6f66 2074 6865 6d20 6361 6e0a ost of them can. │ │ │ │ -000252a0: 6265 2065 6e74 6572 6564 206f 6e20 7468 be entered on th │ │ │ │ -000252b0: 6520 636f 6d6d 616e 642d 6c69 6e65 2061 e command-line a │ │ │ │ -000252c0: 6e64 2063 616e 2062 6520 7573 6564 2065 nd can be used e │ │ │ │ -000252d0: 6974 6865 7220 616e 7977 6865 7265 2069 ither anywhere i │ │ │ │ -000252e0: 6e20 7468 650a 6d65 6e75 206f 7220 7370 n the.menu or sp │ │ │ │ -000252f0: 6563 6966 6963 616c 6c79 2069 6e20 7468 ecifically in th │ │ │ │ -00025300: 6520 6d65 6e75 2065 6e74 7269 6573 2e0a e menu entries.. │ │ │ │ -00025310: 0a20 2020 496e 2072 6573 6375 6520 6d6f . In rescue mo │ │ │ │ -00025320: 6465 2c20 6f6e 6c79 2074 6865 2027 696e de, only the 'in │ │ │ │ -00025330: 736d 6f64 2720 282a 6e6f 7465 2069 6e73 smod' (*note ins │ │ │ │ -00025340: 6d6f 643a 3a29 2c20 276c 7327 2028 2a6e mod::), 'ls' (*n │ │ │ │ -00025350: 6f74 650a 6c73 3a3a 292c 2027 7365 7427 ote.ls::), 'set' │ │ │ │ -00025360: 2028 2a6e 6f74 6520 7365 743a 3a29 2c20 (*note set::), │ │ │ │ -00025370: 616e 6420 2775 6e73 6574 2720 282a 6e6f and 'unset' (*no │ │ │ │ -00025380: 7465 2075 6e73 6574 3a3a 2920 636f 6d6d te unset::) comm │ │ │ │ -00025390: 616e 6473 2061 7265 0a6e 6f72 6d61 6c6c ands are.normall │ │ │ │ -000253a0: 7920 6176 6169 6c61 626c 652e 2020 4966 y available. If │ │ │ │ -000253b0: 2079 6f75 2065 6e64 2075 7020 696e 2072 you end up in r │ │ │ │ -000253c0: 6573 6375 6520 6d6f 6465 2061 6e64 2064 escue mode and d │ │ │ │ -000253d0: 6f20 6e6f 7420 6b6e 6f77 2077 6861 740a o not know what. │ │ │ │ -000253e0: 746f 2064 6f2c 2074 6865 6e20 2a6e 6f74 to do, then *not │ │ │ │ -000253f0: 6520 4752 5542 206f 6e6c 7920 6f66 6665 e GRUB only offe │ │ │ │ -00025400: 7273 2061 2072 6573 6375 6520 7368 656c rs a rescue shel │ │ │ │ -00025410: 6c3a 3a2e 0a0a 2a20 4d65 6e75 3a0a 0a2a l::...* Menu:..* │ │ │ │ -00025420: 204d 656e 752d 7370 6563 6966 6963 2063 Menu-specific c │ │ │ │ -00025430: 6f6d 6d61 6e64 733a 3a0a 2a20 4765 6e65 ommands::.* Gene │ │ │ │ -00025440: 7261 6c20 636f 6d6d 616e 6473 3a3a 0a2a ral commands::.* │ │ │ │ -00025450: 2043 6f6d 6d61 6e64 2d6c 696e 6520 616e Command-line an │ │ │ │ -00025460: 6420 6d65 6e75 2065 6e74 7279 2063 6f6d d menu entry com │ │ │ │ -00025470: 6d61 6e64 733a 3a0a 2a20 4e65 7477 6f72 mands::.* Networ │ │ │ │ -00025480: 6b69 6e67 2063 6f6d 6d61 6e64 733a 3a0a king commands::. │ │ │ │ -00025490: 0a1f 0a46 696c 653a 2067 7275 622e 696e ...File: grub.in │ │ │ │ -000254a0: 666f 2c20 204e 6f64 653a 204d 656e 752d fo, Node: Menu- │ │ │ │ -000254b0: 7370 6563 6966 6963 2063 6f6d 6d61 6e64 specific command │ │ │ │ -000254c0: 732c 2020 4e65 7874 3a20 4765 6e65 7261 s, Next: Genera │ │ │ │ -000254d0: 6c20 636f 6d6d 616e 6473 2c20 2055 703a l commands, Up: │ │ │ │ -000254e0: 2043 6f6d 6d61 6e64 730a 0a31 362e 3120 Commands..16.1 │ │ │ │ -000254f0: 5468 6520 6c69 7374 206f 6620 636f 6d6d The list of comm │ │ │ │ -00025500: 616e 6473 2066 6f72 2074 6865 206d 656e ands for the men │ │ │ │ -00025510: 7520 6f6e 6c79 0a3d 3d3d 3d3d 3d3d 3d3d u only.========= │ │ │ │ +000251c0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ +000251d0: 2a0a 0a49 6e20 7468 6973 2063 6861 7074 *..In this chapt │ │ │ │ +000251e0: 6572 2c20 7765 206c 6973 7420 616c 6c20 er, we list all │ │ │ │ +000251f0: 636f 6d6d 616e 6473 2074 6861 7420 6172 commands that ar │ │ │ │ +00025200: 6520 6176 6169 6c61 626c 6520 696e 2047 e available in G │ │ │ │ +00025210: 5255 422e 0a0a 2020 2043 6f6d 6d61 6e64 RUB... Command │ │ │ │ +00025220: 7320 6265 6c6f 6e67 2074 6f20 6469 6666 s belong to diff │ │ │ │ +00025230: 6572 656e 7420 6772 6f75 7073 2e20 2041 erent groups. A │ │ │ │ +00025240: 2066 6577 2063 616e 206f 6e6c 7920 6265 few can only be │ │ │ │ +00025250: 2075 7365 6420 696e 2074 6865 0a67 6c6f used in the.glo │ │ │ │ +00025260: 6261 6c20 7365 6374 696f 6e20 6f66 2074 bal section of t │ │ │ │ +00025270: 6865 2063 6f6e 6669 6775 7261 7469 6f6e he configuration │ │ │ │ +00025280: 2066 696c 6520 286f 7220 226d 656e 7522 file (or "menu" │ │ │ │ +00025290: 293b 206d 6f73 7420 6f66 2074 6865 6d20 ); most of them │ │ │ │ +000252a0: 6361 6e0a 6265 2065 6e74 6572 6564 206f can.be entered o │ │ │ │ +000252b0: 6e20 7468 6520 636f 6d6d 616e 642d 6c69 n the command-li │ │ │ │ +000252c0: 6e65 2061 6e64 2063 616e 2062 6520 7573 ne and can be us │ │ │ │ +000252d0: 6564 2065 6974 6865 7220 616e 7977 6865 ed either anywhe │ │ │ │ +000252e0: 7265 2069 6e20 7468 650a 6d65 6e75 206f re in the.menu o │ │ │ │ +000252f0: 7220 7370 6563 6966 6963 616c 6c79 2069 r specifically i │ │ │ │ +00025300: 6e20 7468 6520 6d65 6e75 2065 6e74 7269 n the menu entri │ │ │ │ +00025310: 6573 2e0a 0a20 2020 496e 2072 6573 6375 es... In rescu │ │ │ │ +00025320: 6520 6d6f 6465 2c20 6f6e 6c79 2074 6865 e mode, only the │ │ │ │ +00025330: 2027 696e 736d 6f64 2720 282a 6e6f 7465 'insmod' (*note │ │ │ │ +00025340: 2069 6e73 6d6f 643a 3a29 2c20 276c 7327 insmod::), 'ls' │ │ │ │ +00025350: 2028 2a6e 6f74 650a 6c73 3a3a 292c 2027 (*note.ls::), ' │ │ │ │ +00025360: 7365 7427 2028 2a6e 6f74 6520 7365 743a set' (*note set: │ │ │ │ +00025370: 3a29 2c20 616e 6420 2775 6e73 6574 2720 :), and 'unset' │ │ │ │ +00025380: 282a 6e6f 7465 2075 6e73 6574 3a3a 2920 (*note unset::) │ │ │ │ +00025390: 636f 6d6d 616e 6473 2061 7265 0a6e 6f72 commands are.nor │ │ │ │ +000253a0: 6d61 6c6c 7920 6176 6169 6c61 626c 652e mally available. │ │ │ │ +000253b0: 2020 4966 2079 6f75 2065 6e64 2075 7020 If you end up │ │ │ │ +000253c0: 696e 2072 6573 6375 6520 6d6f 6465 2061 in rescue mode a │ │ │ │ +000253d0: 6e64 2064 6f20 6e6f 7420 6b6e 6f77 2077 nd do not know w │ │ │ │ +000253e0: 6861 740a 746f 2064 6f2c 2074 6865 6e20 hat.to do, then │ │ │ │ +000253f0: 2a6e 6f74 6520 4752 5542 206f 6e6c 7920 *note GRUB only │ │ │ │ +00025400: 6f66 6665 7273 2061 2072 6573 6375 6520 offers a rescue │ │ │ │ +00025410: 7368 656c 6c3a 3a2e 0a0a 2a20 4d65 6e75 shell::...* Menu │ │ │ │ +00025420: 3a0a 0a2a 204d 656e 752d 7370 6563 6966 :..* Menu-specif │ │ │ │ +00025430: 6963 2063 6f6d 6d61 6e64 733a 3a0a 2a20 ic commands::.* │ │ │ │ +00025440: 4765 6e65 7261 6c20 636f 6d6d 616e 6473 General commands │ │ │ │ +00025450: 3a3a 0a2a 2043 6f6d 6d61 6e64 2d6c 696e ::.* Command-lin │ │ │ │ +00025460: 6520 616e 6420 6d65 6e75 2065 6e74 7279 e and menu entry │ │ │ │ +00025470: 2063 6f6d 6d61 6e64 733a 3a0a 2a20 4e65 commands::.* Ne │ │ │ │ +00025480: 7477 6f72 6b69 6e67 2063 6f6d 6d61 6e64 tworking command │ │ │ │ +00025490: 733a 3a0a 0a1f 0a46 696c 653a 2067 7275 s::....File: gru │ │ │ │ +000254a0: 622e 696e 666f 2c20 204e 6f64 653a 204d b.info, Node: M │ │ │ │ +000254b0: 656e 752d 7370 6563 6966 6963 2063 6f6d enu-specific com │ │ │ │ +000254c0: 6d61 6e64 732c 2020 4e65 7874 3a20 4765 mands, Next: Ge │ │ │ │ +000254d0: 6e65 7261 6c20 636f 6d6d 616e 6473 2c20 neral commands, │ │ │ │ +000254e0: 2055 703a 2043 6f6d 6d61 6e64 730a 0a31 Up: Commands..1 │ │ │ │ +000254f0: 362e 3120 5468 6520 6c69 7374 206f 6620 6.1 The list of │ │ │ │ +00025500: 636f 6d6d 616e 6473 2066 6f72 2074 6865 commands for the │ │ │ │ +00025510: 206d 656e 7520 6f6e 6c79 0a3d 3d3d 3d3d menu only.===== │ │ │ │ 00025520: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ 00025530: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ -00025540: 3d3d 0a0a 5468 6520 7365 6d61 6e74 6963 ==..The semantic │ │ │ │ -00025550: 7320 7573 6564 2069 6e20 7061 7273 696e s used in parsin │ │ │ │ -00025560: 6720 7468 6520 636f 6e66 6967 7572 6174 g the configurat │ │ │ │ -00025570: 696f 6e20 6669 6c65 2061 7265 2074 6865 ion file are the │ │ │ │ -00025580: 2066 6f6c 6c6f 7769 6e67 3a0a 0a20 2020 following:.. │ │ │ │ -00025590: 2a20 5468 6520 6669 6c65 7320 5f6d 7573 * The files _mus │ │ │ │ -000255a0: 745f 2062 6520 696e 2070 6c61 696e 2d74 t_ be in plain-t │ │ │ │ -000255b0: 6578 7420 666f 726d 6174 2e0a 0a20 2020 ext format... │ │ │ │ -000255c0: 2a20 2723 2720 6174 2074 6865 2062 6567 * '#' at the beg │ │ │ │ -000255d0: 696e 6e69 6e67 206f 6620 6120 6c69 6e65 inning of a line │ │ │ │ -000255e0: 2069 6e20 6120 636f 6e66 6967 7572 6174 in a configurat │ │ │ │ -000255f0: 696f 6e20 6669 6c65 206d 6561 6e73 2069 ion file means i │ │ │ │ -00025600: 7420 6973 0a20 2020 2020 6f6e 6c79 2061 t is. only a │ │ │ │ -00025610: 2063 6f6d 6d65 6e74 2e0a 0a20 2020 2a20 comment... * │ │ │ │ -00025620: 4f70 7469 6f6e 7320 6172 6520 7365 7061 Options are sepa │ │ │ │ -00025630: 7261 7465 6420 6279 2073 7061 6365 732e rated by spaces. │ │ │ │ -00025640: 0a0a 2020 202a 2041 6c6c 206e 756d 6265 .. * All numbe │ │ │ │ -00025650: 7273 2063 616e 2062 6520 6569 7468 6572 rs can be either │ │ │ │ -00025660: 2064 6563 696d 616c 206f 7220 6865 7861 decimal or hexa │ │ │ │ -00025670: 6465 6369 6d61 6c2e 2020 4120 6865 7861 decimal. A hexa │ │ │ │ -00025680: 6465 6369 6d61 6c0a 2020 2020 206e 756d decimal. num │ │ │ │ -00025690: 6265 7220 6d75 7374 2062 6520 7072 6563 ber must be prec │ │ │ │ -000256a0: 6564 6564 2062 7920 2730 7827 2c20 616e eded by '0x', an │ │ │ │ -000256b0: 6420 6973 2063 6173 652d 696e 7365 6e73 d is case-insens │ │ │ │ -000256c0: 6974 6976 652e 0a0a 2020 2054 6865 7365 itive... These │ │ │ │ -000256d0: 2063 6f6d 6d61 6e64 7320 6361 6e20 6f6e commands can on │ │ │ │ -000256e0: 6c79 2062 6520 7573 6564 2069 6e20 7468 ly be used in th │ │ │ │ -000256f0: 6520 6d65 6e75 3a0a 0a2a 204d 656e 753a e menu:..* Menu: │ │ │ │ -00025700: 0a0a 2a20 6d65 6e75 656e 7472 793a 3a20 ..* menuentry:: │ │ │ │ -00025710: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00025720: 2020 5374 6172 7420 6120 6d65 6e75 2065 Start a menu e │ │ │ │ -00025730: 6e74 7279 0a2a 2073 7562 6d65 6e75 3a3a ntry.* submenu:: │ │ │ │ -00025740: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00025750: 2020 2020 2047 726f 7570 206d 656e 7520 Group menu │ │ │ │ -00025760: 656e 7472 6965 730a 0a1f 0a46 696c 653a entries....File: │ │ │ │ -00025770: 2067 7275 622e 696e 666f 2c20 204e 6f64 grub.info, Nod │ │ │ │ -00025780: 653a 206d 656e 7565 6e74 7279 2c20 204e e: menuentry, N │ │ │ │ -00025790: 6578 743a 2073 7562 6d65 6e75 2c20 2055 ext: submenu, U │ │ │ │ -000257a0: 703a 204d 656e 752d 7370 6563 6966 6963 p: Menu-specific │ │ │ │ -000257b0: 2063 6f6d 6d61 6e64 730a 0a31 362e 312e commands..16.1. │ │ │ │ -000257c0: 3120 6d65 6e75 656e 7472 790a 2d2d 2d2d 1 menuentry.---- │ │ │ │ -000257d0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d ------------.. - │ │ │ │ -000257e0: 2d20 436f 6d6d 616e 643a 206d 656e 7565 - Command: menue │ │ │ │ -000257f0: 6e74 7279 2054 4954 4c45 205b 272d 2d63 ntry TITLE ['--c │ │ │ │ -00025800: 6c61 7373 3d63 6c61 7373 2720 2e2e 2e5d lass=class' ...] │ │ │ │ -00025810: 205b 272d 2d75 7365 7273 3d75 7365 7273 ['--users=users │ │ │ │ -00025820: 275d 0a20 2020 2020 2020 2020 205b 272d ']. ['- │ │ │ │ -00025830: 2d75 6e72 6573 7472 6963 7465 6427 5d20 -unrestricted'] │ │ │ │ -00025840: 5b27 2d2d 686f 746b 6579 3d6b 6579 275d ['--hotkey=key'] │ │ │ │ -00025850: 205b 272d 2d69 643d 6964 275d 205b 4152 ['--id=id'] [AR │ │ │ │ -00025860: 4720 2e2e 2e5d 207b 0a20 2020 2020 2020 G ...] {. │ │ │ │ -00025870: 2020 2043 4f4d 4d41 4e44 3b20 2e2e 2e20 COMMAND; ... │ │ │ │ -00025880: 7d0a 2020 2020 2054 6869 7320 6465 6669 }. This defi │ │ │ │ -00025890: 6e65 7320 6120 4752 5542 206d 656e 7520 nes a GRUB menu │ │ │ │ -000258a0: 656e 7472 7920 6e61 6d65 6420 5449 544c entry named TITL │ │ │ │ -000258b0: 452e 2020 5768 656e 2074 6869 7320 656e E. When this en │ │ │ │ -000258c0: 7472 7920 6973 0a20 2020 2020 7365 6c65 try is. sele │ │ │ │ -000258d0: 6374 6564 2066 726f 6d20 7468 6520 6d65 cted from the me │ │ │ │ -000258e0: 6e75 2c20 4752 5542 2077 696c 6c20 7365 nu, GRUB will se │ │ │ │ -000258f0: 7420 7468 6520 4348 4f53 454e 2065 6e76 t the CHOSEN env │ │ │ │ -00025900: 6972 6f6e 6d65 6e74 0a20 2020 2020 7661 ironment. va │ │ │ │ -00025910: 7269 6162 6c65 2074 6f20 7661 6c75 6520 riable to value │ │ │ │ -00025920: 6f66 2027 2d2d 6964 2720 6966 2027 2d2d of '--id' if '-- │ │ │ │ -00025930: 6964 2720 6973 2067 6976 656e 2c20 6578 id' is given, ex │ │ │ │ -00025940: 6563 7574 6520 7468 6520 6c69 7374 206f ecute the list o │ │ │ │ -00025950: 660a 2020 2020 2063 6f6d 6d61 6e64 7320 f. commands │ │ │ │ -00025960: 6769 7665 6e20 7769 7468 696e 2062 7261 given within bra │ │ │ │ -00025970: 6365 732c 2061 6e64 2069 6620 7468 6520 ces, and if the │ │ │ │ -00025980: 6c61 7374 2063 6f6d 6d61 6e64 2069 6e20 last command in │ │ │ │ -00025990: 7468 6520 6c69 7374 0a20 2020 2020 7265 the list. re │ │ │ │ -000259a0: 7475 726e 6564 2073 7563 6365 7373 6675 turned successfu │ │ │ │ -000259b0: 6c6c 7920 616e 6420 6120 6b65 726e 656c lly and a kernel │ │ │ │ -000259c0: 2077 6173 206c 6f61 6465 6420 6974 2077 was loaded it w │ │ │ │ -000259d0: 696c 6c20 6578 6563 7574 6520 7468 650a ill execute the. │ │ │ │ -000259e0: 2020 2020 2027 626f 6f74 2720 636f 6d6d 'boot' comm │ │ │ │ -000259f0: 616e 642e 0a0a 2020 2020 2054 6865 2027 and... The ' │ │ │ │ -00025a00: 2d2d 636c 6173 7327 206f 7074 696f 6e20 --class' option │ │ │ │ -00025a10: 6d61 7920 6265 2075 7365 6420 616e 7920 may be used any │ │ │ │ -00025a20: 6e75 6d62 6572 206f 6620 7469 6d65 7320 number of times │ │ │ │ -00025a30: 746f 2067 726f 7570 206d 656e 750a 2020 to group menu. │ │ │ │ -00025a40: 2020 2065 6e74 7269 6573 2069 6e74 6f20 entries into │ │ │ │ -00025a50: 636c 6173 7365 732e 2020 4d65 6e75 2074 classes. Menu t │ │ │ │ -00025a60: 6865 6d65 7320 6d61 7920 6469 7370 6c61 hemes may displa │ │ │ │ -00025a70: 7920 6469 6666 6572 656e 7420 636c 6173 y different clas │ │ │ │ -00025a80: 7365 730a 2020 2020 2075 7369 6e67 2064 ses. using d │ │ │ │ -00025a90: 6966 6665 7265 6e74 2073 7479 6c65 732e ifferent styles. │ │ │ │ -00025aa0: 0a0a 2020 2020 2054 6865 2027 2d2d 7573 .. The '--us │ │ │ │ -00025ab0: 6572 7327 206f 7074 696f 6e20 6772 616e ers' option gran │ │ │ │ -00025ac0: 7473 2073 7065 6369 6669 6320 7573 6572 ts specific user │ │ │ │ -00025ad0: 7320 6163 6365 7373 2074 6f20 7370 6563 s access to spec │ │ │ │ -00025ae0: 6966 6963 206d 656e 750a 2020 2020 2065 ific menu. e │ │ │ │ -00025af0: 6e74 7269 6573 2e20 202a 4e6f 7465 2053 ntries. *Note S │ │ │ │ -00025b00: 6563 7572 6974 793a 3a2e 0a0a 2020 2020 ecurity::... │ │ │ │ -00025b10: 2054 6865 2027 2d2d 756e 7265 7374 7269 The '--unrestri │ │ │ │ -00025b20: 6374 6564 2720 6f70 7469 6f6e 2067 7261 cted' option gra │ │ │ │ -00025b30: 6e74 7320 616c 6c20 7573 6572 7320 6163 nts all users ac │ │ │ │ -00025b40: 6365 7373 2074 6f20 7370 6563 6966 6963 cess to specific │ │ │ │ -00025b50: 0a20 2020 2020 6d65 6e75 2065 6e74 7269 . menu entri │ │ │ │ -00025b60: 6573 2e20 202a 4e6f 7465 2053 6563 7572 es. *Note Secur │ │ │ │ -00025b70: 6974 793a 3a2e 0a0a 2020 2020 2054 6865 ity::... The │ │ │ │ -00025b80: 2027 2d2d 686f 746b 6579 2720 6f70 7469 '--hotkey' opti │ │ │ │ -00025b90: 6f6e 2061 7373 6f63 6961 7465 7320 6120 on associates a │ │ │ │ -00025ba0: 686f 746b 6579 2077 6974 6820 6120 6d65 hotkey with a me │ │ │ │ -00025bb0: 6e75 2065 6e74 7279 2e20 204b 4559 0a20 nu entry. KEY. │ │ │ │ -00025bc0: 2020 2020 6d61 7920 6265 2061 2073 696e may be a sin │ │ │ │ -00025bd0: 676c 6520 6c65 7474 6572 2c20 6f72 206f gle letter, or o │ │ │ │ -00025be0: 6e65 206f 6620 7468 6520 616c 6961 7365 ne of the aliase │ │ │ │ -00025bf0: 7320 2762 6163 6b73 7061 6365 272c 2027 s 'backspace', ' │ │ │ │ -00025c00: 7461 6227 2c0a 2020 2020 206f 7220 2764 tab',. or 'd │ │ │ │ -00025c10: 656c 6574 6527 2e0a 0a20 2020 2020 5468 elete'... Th │ │ │ │ -00025c20: 6520 272d 2d69 6427 206d 6179 2062 6520 e '--id' may be │ │ │ │ -00025c30: 7573 6564 2074 6f20 6173 736f 6369 6174 used to associat │ │ │ │ -00025c40: 6520 756e 6971 7565 2069 6465 6e74 6966 e unique identif │ │ │ │ -00025c50: 6965 7220 7769 7468 2061 206d 656e 750a ier with a menu. │ │ │ │ -00025c60: 2020 2020 2065 6e74 7279 2e20 2049 4420 entry. ID │ │ │ │ -00025c70: 6973 2073 7472 696e 6720 6f66 2041 5343 is string of ASC │ │ │ │ -00025c80: 4949 2061 7068 616e 756d 6572 6963 2063 II aphanumeric c │ │ │ │ -00025c90: 6861 7261 6374 6572 732c 2075 6e64 6572 haracters, under │ │ │ │ -00025ca0: 7363 6f72 650a 2020 2020 2061 6e64 2068 score. and h │ │ │ │ -00025cb0: 7970 6865 6e20 616e 6420 7368 6f75 6c64 yphen and should │ │ │ │ -00025cc0: 206e 6f74 2073 7461 7274 2077 6974 6820 not start with │ │ │ │ -00025cd0: 6120 6469 6769 742e 0a0a 2020 2020 2041 a digit... A │ │ │ │ -00025ce0: 6c6c 206f 7468 6572 2061 7267 756d 656e ll other argumen │ │ │ │ -00025cf0: 7473 2069 6e63 6c75 6469 6e67 2054 4954 ts including TIT │ │ │ │ -00025d00: 4c45 2061 7265 2070 6173 7365 6420 6173 LE are passed as │ │ │ │ -00025d10: 2070 6f73 6974 696f 6e61 6c0a 2020 2020 positional. │ │ │ │ -00025d20: 2070 6172 616d 6574 6572 7320 7768 656e parameters when │ │ │ │ -00025d30: 206c 6973 7420 6f66 2063 6f6d 6d61 6e64 list of command │ │ │ │ -00025d40: 7320 6973 2065 7865 6375 7465 6420 7769 s is executed wi │ │ │ │ -00025d50: 7468 2054 4954 4c45 2061 6c77 6179 730a th TITLE always. │ │ │ │ -00025d60: 2020 2020 2061 7373 6967 6e65 6420 746f assigned to │ │ │ │ -00025d70: 2027 2431 272e 0a0a 1f0a 4669 6c65 3a20 '$1'.....File: │ │ │ │ -00025d80: 6772 7562 2e69 6e66 6f2c 2020 4e6f 6465 grub.info, Node │ │ │ │ -00025d90: 3a20 7375 626d 656e 752c 2020 5072 6576 : submenu, Prev │ │ │ │ -00025da0: 3a20 6d65 6e75 656e 7472 792c 2020 5570 : menuentry, Up │ │ │ │ -00025db0: 3a20 4d65 6e75 2d73 7065 6369 6669 6320 : Menu-specific │ │ │ │ -00025dc0: 636f 6d6d 616e 6473 0a0a 3136 2e31 2e32 commands..16.1.2 │ │ │ │ -00025dd0: 2073 7562 6d65 6e75 0a2d 2d2d 2d2d 2d2d submenu.------- │ │ │ │ -00025de0: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2043 6f6d -------.. -- Com │ │ │ │ -00025df0: 6d61 6e64 3a20 7375 626d 656e 7520 5449 mand: submenu TI │ │ │ │ -00025e00: 544c 4520 5b27 2d2d 636c 6173 733d 636c TLE ['--class=cl │ │ │ │ -00025e10: 6173 7327 202e 2e2e 5d20 5b27 2d2d 7573 ass' ...] ['--us │ │ │ │ -00025e20: 6572 733d 7573 6572 7327 5d0a 2020 2020 ers=users']. │ │ │ │ -00025e30: 2020 2020 2020 5b27 2d2d 756e 7265 7374 ['--unrest │ │ │ │ -00025e40: 7269 6374 6564 275d 205b 272d 2d68 6f74 ricted'] ['--hot │ │ │ │ -00025e50: 6b65 793d 6b65 7927 5d20 5b27 2d2d 6964 key=key'] ['--id │ │ │ │ -00025e60: 3d69 6427 5d20 7b20 4d45 4e55 2045 4e54 =id'] { MENU ENT │ │ │ │ -00025e70: 5249 4553 0a20 2020 2020 2020 2020 202e RIES. . │ │ │ │ -00025e80: 2e2e 207d 0a20 2020 2020 5468 6973 2064 .. }. This d │ │ │ │ -00025e90: 6566 696e 6573 2061 2073 7562 6d65 6e75 efines a submenu │ │ │ │ -00025ea0: 2e20 2041 6e20 656e 7472 7920 6361 6c6c . An entry call │ │ │ │ -00025eb0: 6564 2054 4954 4c45 2077 696c 6c20 6265 ed TITLE will be │ │ │ │ -00025ec0: 2061 6464 6564 2074 6f20 7468 650a 2020 added to the. │ │ │ │ -00025ed0: 2020 206d 656e 753b 2077 6865 6e20 7468 menu; when th │ │ │ │ -00025ee0: 6174 2065 6e74 7279 2069 7320 7365 6c65 at entry is sele │ │ │ │ -00025ef0: 6374 6564 2c20 6120 6e65 7720 6d65 6e75 cted, a new menu │ │ │ │ -00025f00: 2077 696c 6c20 6265 2064 6973 706c 6179 will be display │ │ │ │ -00025f10: 6564 0a20 2020 2020 7368 6f77 696e 6720 ed. showing │ │ │ │ -00025f20: 616c 6c20 7468 6520 656e 7472 6965 7320 all the entries │ │ │ │ -00025f30: 7769 7468 696e 2074 6869 7320 7375 626d within this subm │ │ │ │ -00025f40: 656e 752e 0a0a 2020 2020 2041 6c6c 206f enu... All o │ │ │ │ -00025f50: 7074 696f 6e73 2061 7265 2074 6865 2073 ptions are the s │ │ │ │ -00025f60: 616d 6520 6173 2069 6e20 7468 6520 276d ame as in the 'm │ │ │ │ -00025f70: 656e 7565 6e74 7279 2720 636f 6d6d 616e enuentry' comman │ │ │ │ -00025f80: 6420 282a 6e6f 7465 0a20 2020 2020 6d65 d (*note. me │ │ │ │ -00025f90: 6e75 656e 7472 793a 3a29 2e0a 0a1f 0a46 nuentry::).....F │ │ │ │ -00025fa0: 696c 653a 2067 7275 622e 696e 666f 2c20 ile: grub.info, │ │ │ │ -00025fb0: 204e 6f64 653a 2047 656e 6572 616c 2063 Node: General c │ │ │ │ -00025fc0: 6f6d 6d61 6e64 732c 2020 4e65 7874 3a20 ommands, Next: │ │ │ │ -00025fd0: 436f 6d6d 616e 642d 6c69 6e65 2061 6e64 Command-line and │ │ │ │ -00025fe0: 206d 656e 7520 656e 7472 7920 636f 6d6d menu entry comm │ │ │ │ -00025ff0: 616e 6473 2c20 2050 7265 763a 204d 656e ands, Prev: Men │ │ │ │ -00026000: 752d 7370 6563 6966 6963 2063 6f6d 6d61 u-specific comma │ │ │ │ -00026010: 6e64 732c 2020 5570 3a20 436f 6d6d 616e nds, Up: Comman │ │ │ │ -00026020: 6473 0a0a 3136 2e32 2054 6865 206c 6973 ds..16.2 The lis │ │ │ │ -00026030: 7420 6f66 2067 656e 6572 616c 2063 6f6d t of general com │ │ │ │ -00026040: 6d61 6e64 730a 3d3d 3d3d 3d3d 3d3d 3d3d mands.========== │ │ │ │ +00025540: 3d3d 3d3d 3d3d 0a0a 5468 6520 7365 6d61 ======..The sema │ │ │ │ +00025550: 6e74 6963 7320 7573 6564 2069 6e20 7061 ntics used in pa │ │ │ │ +00025560: 7273 696e 6720 7468 6520 636f 6e66 6967 rsing the config │ │ │ │ +00025570: 7572 6174 696f 6e20 6669 6c65 2061 7265 uration file are │ │ │ │ +00025580: 2074 6865 2066 6f6c 6c6f 7769 6e67 3a0a the following:. │ │ │ │ +00025590: 0a20 2020 2a20 5468 6520 6669 6c65 7320 . * The files │ │ │ │ +000255a0: 5f6d 7573 745f 2062 6520 696e 2070 6c61 _must_ be in pla │ │ │ │ +000255b0: 696e 2d74 6578 7420 666f 726d 6174 2e0a in-text format.. │ │ │ │ +000255c0: 0a20 2020 2a20 2723 2720 6174 2074 6865 . * '#' at the │ │ │ │ +000255d0: 2062 6567 696e 6e69 6e67 206f 6620 6120 beginning of a │ │ │ │ +000255e0: 6c69 6e65 2069 6e20 6120 636f 6e66 6967 line in a config │ │ │ │ +000255f0: 7572 6174 696f 6e20 6669 6c65 206d 6561 uration file mea │ │ │ │ +00025600: 6e73 2069 7420 6973 0a20 2020 2020 6f6e ns it is. on │ │ │ │ +00025610: 6c79 2061 2063 6f6d 6d65 6e74 2e0a 0a20 ly a comment... │ │ │ │ +00025620: 2020 2a20 4f70 7469 6f6e 7320 6172 6520 * Options are │ │ │ │ +00025630: 7365 7061 7261 7465 6420 6279 2073 7061 separated by spa │ │ │ │ +00025640: 6365 732e 0a0a 2020 202a 2041 6c6c 206e ces... * All n │ │ │ │ +00025650: 756d 6265 7273 2063 616e 2062 6520 6569 umbers can be ei │ │ │ │ +00025660: 7468 6572 2064 6563 696d 616c 206f 7220 ther decimal or │ │ │ │ +00025670: 6865 7861 6465 6369 6d61 6c2e 2020 4120 hexadecimal. A │ │ │ │ +00025680: 6865 7861 6465 6369 6d61 6c0a 2020 2020 hexadecimal. │ │ │ │ +00025690: 206e 756d 6265 7220 6d75 7374 2062 6520 number must be │ │ │ │ +000256a0: 7072 6563 6564 6564 2062 7920 2730 7827 preceded by '0x' │ │ │ │ +000256b0: 2c20 616e 6420 6973 2063 6173 652d 696e , and is case-in │ │ │ │ +000256c0: 7365 6e73 6974 6976 652e 0a0a 2020 2054 sensitive... T │ │ │ │ +000256d0: 6865 7365 2063 6f6d 6d61 6e64 7320 6361 hese commands ca │ │ │ │ +000256e0: 6e20 6f6e 6c79 2062 6520 7573 6564 2069 n only be used i │ │ │ │ +000256f0: 6e20 7468 6520 6d65 6e75 3a0a 0a2a 204d n the menu:..* M │ │ │ │ +00025700: 656e 753a 0a0a 2a20 6d65 6e75 656e 7472 enu:..* menuentr │ │ │ │ +00025710: 793a 3a20 2020 2020 2020 2020 2020 2020 y:: │ │ │ │ +00025720: 2020 2020 2020 5374 6172 7420 6120 6d65 Start a me │ │ │ │ +00025730: 6e75 2065 6e74 7279 0a2a 2073 7562 6d65 nu entry.* subme │ │ │ │ +00025740: 6e75 3a3a 2020 2020 2020 2020 2020 2020 nu:: │ │ │ │ +00025750: 2020 2020 2020 2020 2047 726f 7570 206d Group m │ │ │ │ +00025760: 656e 7520 656e 7472 6965 730a 0a1f 0a46 enu entries....F │ │ │ │ +00025770: 696c 653a 2067 7275 622e 696e 666f 2c20 ile: grub.info, │ │ │ │ +00025780: 204e 6f64 653a 206d 656e 7565 6e74 7279 Node: menuentry │ │ │ │ +00025790: 2c20 204e 6578 743a 2073 7562 6d65 6e75 , Next: submenu │ │ │ │ +000257a0: 2c20 2055 703a 204d 656e 752d 7370 6563 , Up: Menu-spec │ │ │ │ +000257b0: 6966 6963 2063 6f6d 6d61 6e64 730a 0a31 ific commands..1 │ │ │ │ +000257c0: 362e 312e 3120 6d65 6e75 656e 7472 790a 6.1.1 menuentry. │ │ │ │ +000257d0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ +000257e0: 0a0a 202d 2d20 436f 6d6d 616e 643a 206d .. -- Command: m │ │ │ │ +000257f0: 656e 7565 6e74 7279 2054 4954 4c45 205b enuentry TITLE [ │ │ │ │ +00025800: 272d 2d63 6c61 7373 3d63 6c61 7373 2720 '--class=class' │ │ │ │ +00025810: 2e2e 2e5d 205b 272d 2d75 7365 7273 3d75 ...] ['--users=u │ │ │ │ +00025820: 7365 7273 275d 0a20 2020 2020 2020 2020 sers']. │ │ │ │ +00025830: 205b 272d 2d75 6e72 6573 7472 6963 7465 ['--unrestricte │ │ │ │ +00025840: 6427 5d20 5b27 2d2d 686f 746b 6579 3d6b d'] ['--hotkey=k │ │ │ │ +00025850: 6579 275d 205b 272d 2d69 643d 6964 275d ey'] ['--id=id'] │ │ │ │ +00025860: 205b 4152 4720 2e2e 2e5d 207b 0a20 2020 [ARG ...] {. │ │ │ │ +00025870: 2020 2020 2020 2043 4f4d 4d41 4e44 3b20 COMMAND; │ │ │ │ +00025880: 2e2e 2e20 7d0a 2020 2020 2054 6869 7320 ... }. This │ │ │ │ +00025890: 6465 6669 6e65 7320 6120 4752 5542 206d defines a GRUB m │ │ │ │ +000258a0: 656e 7520 656e 7472 7920 6e61 6d65 6420 enu entry named │ │ │ │ +000258b0: 5449 544c 452e 2020 5768 656e 2074 6869 TITLE. When thi │ │ │ │ +000258c0: 7320 656e 7472 7920 6973 0a20 2020 2020 s entry is. │ │ │ │ +000258d0: 7365 6c65 6374 6564 2066 726f 6d20 7468 selected from th │ │ │ │ +000258e0: 6520 6d65 6e75 2c20 4752 5542 2077 696c e menu, GRUB wil │ │ │ │ +000258f0: 6c20 7365 7420 7468 6520 4348 4f53 454e l set the CHOSEN │ │ │ │ +00025900: 2065 6e76 6972 6f6e 6d65 6e74 0a20 2020 environment. │ │ │ │ +00025910: 2020 7661 7269 6162 6c65 2074 6f20 7661 variable to va │ │ │ │ +00025920: 6c75 6520 6f66 2027 2d2d 6964 2720 6966 lue of '--id' if │ │ │ │ +00025930: 2027 2d2d 6964 2720 6973 2067 6976 656e '--id' is given │ │ │ │ +00025940: 2c20 6578 6563 7574 6520 7468 6520 6c69 , execute the li │ │ │ │ +00025950: 7374 206f 660a 2020 2020 2063 6f6d 6d61 st of. comma │ │ │ │ +00025960: 6e64 7320 6769 7665 6e20 7769 7468 696e nds given within │ │ │ │ +00025970: 2062 7261 6365 732c 2061 6e64 2069 6620 braces, and if │ │ │ │ +00025980: 7468 6520 6c61 7374 2063 6f6d 6d61 6e64 the last command │ │ │ │ +00025990: 2069 6e20 7468 6520 6c69 7374 0a20 2020 in the list. │ │ │ │ +000259a0: 2020 7265 7475 726e 6564 2073 7563 6365 returned succe │ │ │ │ +000259b0: 7373 6675 6c6c 7920 616e 6420 6120 6b65 ssfully and a ke │ │ │ │ +000259c0: 726e 656c 2077 6173 206c 6f61 6465 6420 rnel was loaded │ │ │ │ +000259d0: 6974 2077 696c 6c20 6578 6563 7574 6520 it will execute │ │ │ │ +000259e0: 7468 650a 2020 2020 2027 626f 6f74 2720 the. 'boot' │ │ │ │ +000259f0: 636f 6d6d 616e 642e 0a0a 2020 2020 2054 command... T │ │ │ │ +00025a00: 6865 2027 2d2d 636c 6173 7327 206f 7074 he '--class' opt │ │ │ │ +00025a10: 696f 6e20 6d61 7920 6265 2075 7365 6420 ion may be used │ │ │ │ +00025a20: 616e 7920 6e75 6d62 6572 206f 6620 7469 any number of ti │ │ │ │ +00025a30: 6d65 7320 746f 2067 726f 7570 206d 656e mes to group men │ │ │ │ +00025a40: 750a 2020 2020 2065 6e74 7269 6573 2069 u. entries i │ │ │ │ +00025a50: 6e74 6f20 636c 6173 7365 732e 2020 4d65 nto classes. Me │ │ │ │ +00025a60: 6e75 2074 6865 6d65 7320 6d61 7920 6469 nu themes may di │ │ │ │ +00025a70: 7370 6c61 7920 6469 6666 6572 656e 7420 splay different │ │ │ │ +00025a80: 636c 6173 7365 730a 2020 2020 2075 7369 classes. usi │ │ │ │ +00025a90: 6e67 2064 6966 6665 7265 6e74 2073 7479 ng different sty │ │ │ │ +00025aa0: 6c65 732e 0a0a 2020 2020 2054 6865 2027 les... The ' │ │ │ │ +00025ab0: 2d2d 7573 6572 7327 206f 7074 696f 6e20 --users' option │ │ │ │ +00025ac0: 6772 616e 7473 2073 7065 6369 6669 6320 grants specific │ │ │ │ +00025ad0: 7573 6572 7320 6163 6365 7373 2074 6f20 users access to │ │ │ │ +00025ae0: 7370 6563 6966 6963 206d 656e 750a 2020 specific menu. │ │ │ │ +00025af0: 2020 2065 6e74 7269 6573 2e20 202a 4e6f entries. *No │ │ │ │ +00025b00: 7465 2053 6563 7572 6974 793a 3a2e 0a0a te Security::... │ │ │ │ +00025b10: 2020 2020 2054 6865 2027 2d2d 756e 7265 The '--unre │ │ │ │ +00025b20: 7374 7269 6374 6564 2720 6f70 7469 6f6e stricted' option │ │ │ │ +00025b30: 2067 7261 6e74 7320 616c 6c20 7573 6572 grants all user │ │ │ │ +00025b40: 7320 6163 6365 7373 2074 6f20 7370 6563 s access to spec │ │ │ │ +00025b50: 6966 6963 0a20 2020 2020 6d65 6e75 2065 ific. menu e │ │ │ │ +00025b60: 6e74 7269 6573 2e20 202a 4e6f 7465 2053 ntries. *Note S │ │ │ │ +00025b70: 6563 7572 6974 793a 3a2e 0a0a 2020 2020 ecurity::... │ │ │ │ +00025b80: 2054 6865 2027 2d2d 686f 746b 6579 2720 The '--hotkey' │ │ │ │ +00025b90: 6f70 7469 6f6e 2061 7373 6f63 6961 7465 option associate │ │ │ │ +00025ba0: 7320 6120 686f 746b 6579 2077 6974 6820 s a hotkey with │ │ │ │ +00025bb0: 6120 6d65 6e75 2065 6e74 7279 2e20 204b a menu entry. K │ │ │ │ +00025bc0: 4559 0a20 2020 2020 6d61 7920 6265 2061 EY. may be a │ │ │ │ +00025bd0: 2073 696e 676c 6520 6c65 7474 6572 2c20 single letter, │ │ │ │ +00025be0: 6f72 206f 6e65 206f 6620 7468 6520 616c or one of the al │ │ │ │ +00025bf0: 6961 7365 7320 2762 6163 6b73 7061 6365 iases 'backspace │ │ │ │ +00025c00: 272c 2027 7461 6227 2c0a 2020 2020 206f ', 'tab',. o │ │ │ │ +00025c10: 7220 2764 656c 6574 6527 2e0a 0a20 2020 r 'delete'... │ │ │ │ +00025c20: 2020 5468 6520 272d 2d69 6427 206d 6179 The '--id' may │ │ │ │ +00025c30: 2062 6520 7573 6564 2074 6f20 6173 736f be used to asso │ │ │ │ +00025c40: 6369 6174 6520 756e 6971 7565 2069 6465 ciate unique ide │ │ │ │ +00025c50: 6e74 6966 6965 7220 7769 7468 2061 206d ntifier with a m │ │ │ │ +00025c60: 656e 750a 2020 2020 2065 6e74 7279 2e20 enu. entry. │ │ │ │ +00025c70: 2049 4420 6973 2073 7472 696e 6720 6f66 ID is string of │ │ │ │ +00025c80: 2041 5343 4949 2061 7068 616e 756d 6572 ASCII aphanumer │ │ │ │ +00025c90: 6963 2063 6861 7261 6374 6572 732c 2075 ic characters, u │ │ │ │ +00025ca0: 6e64 6572 7363 6f72 650a 2020 2020 2061 nderscore. a │ │ │ │ +00025cb0: 6e64 2068 7970 6865 6e20 616e 6420 7368 nd hyphen and sh │ │ │ │ +00025cc0: 6f75 6c64 206e 6f74 2073 7461 7274 2077 ould not start w │ │ │ │ +00025cd0: 6974 6820 6120 6469 6769 742e 0a0a 2020 ith a digit... │ │ │ │ +00025ce0: 2020 2041 6c6c 206f 7468 6572 2061 7267 All other arg │ │ │ │ +00025cf0: 756d 656e 7473 2069 6e63 6c75 6469 6e67 uments including │ │ │ │ +00025d00: 2054 4954 4c45 2061 7265 2070 6173 7365 TITLE are passe │ │ │ │ +00025d10: 6420 6173 2070 6f73 6974 696f 6e61 6c0a d as positional. │ │ │ │ +00025d20: 2020 2020 2070 6172 616d 6574 6572 7320 parameters │ │ │ │ +00025d30: 7768 656e 206c 6973 7420 6f66 2063 6f6d when list of com │ │ │ │ +00025d40: 6d61 6e64 7320 6973 2065 7865 6375 7465 mands is execute │ │ │ │ +00025d50: 6420 7769 7468 2054 4954 4c45 2061 6c77 d with TITLE alw │ │ │ │ +00025d60: 6179 730a 2020 2020 2061 7373 6967 6e65 ays. assigne │ │ │ │ +00025d70: 6420 746f 2027 2431 272e 0a0a 1f0a 4669 d to '$1'.....Fi │ │ │ │ +00025d80: 6c65 3a20 6772 7562 2e69 6e66 6f2c 2020 le: grub.info, │ │ │ │ +00025d90: 4e6f 6465 3a20 7375 626d 656e 752c 2020 Node: submenu, │ │ │ │ +00025da0: 5072 6576 3a20 6d65 6e75 656e 7472 792c Prev: menuentry, │ │ │ │ +00025db0: 2020 5570 3a20 4d65 6e75 2d73 7065 6369 Up: Menu-speci │ │ │ │ +00025dc0: 6669 6320 636f 6d6d 616e 6473 0a0a 3136 fic commands..16 │ │ │ │ +00025dd0: 2e31 2e32 2073 7562 6d65 6e75 0a2d 2d2d .1.2 submenu.--- │ │ │ │ +00025de0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d -----------.. -- │ │ │ │ +00025df0: 2043 6f6d 6d61 6e64 3a20 7375 626d 656e Command: submen │ │ │ │ +00025e00: 7520 5449 544c 4520 5b27 2d2d 636c 6173 u TITLE ['--clas │ │ │ │ +00025e10: 733d 636c 6173 7327 202e 2e2e 5d20 5b27 s=class' ...] [' │ │ │ │ +00025e20: 2d2d 7573 6572 733d 7573 6572 7327 5d0a --users=users']. │ │ │ │ +00025e30: 2020 2020 2020 2020 2020 5b27 2d2d 756e ['--un │ │ │ │ +00025e40: 7265 7374 7269 6374 6564 275d 205b 272d restricted'] ['- │ │ │ │ +00025e50: 2d68 6f74 6b65 793d 6b65 7927 5d20 5b27 -hotkey=key'] [' │ │ │ │ +00025e60: 2d2d 6964 3d69 6427 5d20 7b20 4d45 4e55 --id=id'] { MENU │ │ │ │ +00025e70: 2045 4e54 5249 4553 0a20 2020 2020 2020 ENTRIES. │ │ │ │ +00025e80: 2020 202e 2e2e 207d 0a20 2020 2020 5468 ... }. Th │ │ │ │ +00025e90: 6973 2064 6566 696e 6573 2061 2073 7562 is defines a sub │ │ │ │ +00025ea0: 6d65 6e75 2e20 2041 6e20 656e 7472 7920 menu. An entry │ │ │ │ +00025eb0: 6361 6c6c 6564 2054 4954 4c45 2077 696c called TITLE wil │ │ │ │ +00025ec0: 6c20 6265 2061 6464 6564 2074 6f20 7468 l be added to th │ │ │ │ +00025ed0: 650a 2020 2020 206d 656e 753b 2077 6865 e. menu; whe │ │ │ │ +00025ee0: 6e20 7468 6174 2065 6e74 7279 2069 7320 n that entry is │ │ │ │ +00025ef0: 7365 6c65 6374 6564 2c20 6120 6e65 7720 selected, a new │ │ │ │ +00025f00: 6d65 6e75 2077 696c 6c20 6265 2064 6973 menu will be dis │ │ │ │ +00025f10: 706c 6179 6564 0a20 2020 2020 7368 6f77 played. show │ │ │ │ +00025f20: 696e 6720 616c 6c20 7468 6520 656e 7472 ing all the entr │ │ │ │ +00025f30: 6965 7320 7769 7468 696e 2074 6869 7320 ies within this │ │ │ │ +00025f40: 7375 626d 656e 752e 0a0a 2020 2020 2041 submenu... A │ │ │ │ +00025f50: 6c6c 206f 7074 696f 6e73 2061 7265 2074 ll options are t │ │ │ │ +00025f60: 6865 2073 616d 6520 6173 2069 6e20 7468 he same as in th │ │ │ │ +00025f70: 6520 276d 656e 7565 6e74 7279 2720 636f e 'menuentry' co │ │ │ │ +00025f80: 6d6d 616e 6420 282a 6e6f 7465 0a20 2020 mmand (*note. │ │ │ │ +00025f90: 2020 6d65 6e75 656e 7472 793a 3a29 2e0a menuentry::).. │ │ │ │ +00025fa0: 0a1f 0a46 696c 653a 2067 7275 622e 696e ...File: grub.in │ │ │ │ +00025fb0: 666f 2c20 204e 6f64 653a 2047 656e 6572 fo, Node: Gener │ │ │ │ +00025fc0: 616c 2063 6f6d 6d61 6e64 732c 2020 4e65 al commands, Ne │ │ │ │ +00025fd0: 7874 3a20 436f 6d6d 616e 642d 6c69 6e65 xt: Command-line │ │ │ │ +00025fe0: 2061 6e64 206d 656e 7520 656e 7472 7920 and menu entry │ │ │ │ +00025ff0: 636f 6d6d 616e 6473 2c20 2050 7265 763a commands, Prev: │ │ │ │ +00026000: 204d 656e 752d 7370 6563 6966 6963 2063 Menu-specific c │ │ │ │ +00026010: 6f6d 6d61 6e64 732c 2020 5570 3a20 436f ommands, Up: Co │ │ │ │ +00026020: 6d6d 616e 6473 0a0a 3136 2e32 2054 6865 mmands..16.2 The │ │ │ │ +00026030: 206c 6973 7420 6f66 2067 656e 6572 616c list of general │ │ │ │ +00026040: 2063 6f6d 6d61 6e64 730a 3d3d 3d3d 3d3d commands.====== │ │ │ │ 00026050: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ -00026060: 3d3d 3d3d 3d3d 3d0a 0a43 6f6d 6d61 6e64 =======..Command │ │ │ │ -00026070: 7320 7573 6162 6c65 2061 6e79 7768 6572 s usable anywher │ │ │ │ -00026080: 6520 696e 2074 6865 206d 656e 7520 616e e in the menu an │ │ │ │ -00026090: 6420 696e 2074 6865 2063 6f6d 6d61 6e64 d in the command │ │ │ │ -000260a0: 2d6c 696e 652e 0a0a 2a20 4d65 6e75 3a0a -line...* Menu:. │ │ │ │ -000260b0: 0a2a 2073 6572 6961 6c3a 3a20 2020 2020 .* serial:: │ │ │ │ +00026060: 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a43 6f6d ===========..Com │ │ │ │ +00026070: 6d61 6e64 7320 7573 6162 6c65 2061 6e79 mands usable any │ │ │ │ +00026080: 7768 6572 6520 696e 2074 6865 206d 656e where in the men │ │ │ │ +00026090: 7520 616e 6420 696e 2074 6865 2063 6f6d u and in the com │ │ │ │ +000260a0: 6d61 6e64 2d6c 696e 652e 0a0a 2a20 4d65 mand-line...* Me │ │ │ │ +000260b0: 6e75 3a0a 0a2a 2073 6572 6961 6c3a 3a20 nu:..* serial:: │ │ │ │ 000260c0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -000260d0: 2053 6574 2075 7020 6120 7365 7269 616c Set up a serial │ │ │ │ -000260e0: 2064 6576 6963 650a 2a20 7465 726d 696e device.* termin │ │ │ │ -000260f0: 616c 5f69 6e70 7574 3a3a 2020 2020 2020 al_input:: │ │ │ │ -00026100: 2020 2020 2020 2020 4d61 6e61 6765 2069 Manage i │ │ │ │ -00026110: 6e70 7574 2074 6572 6d69 6e61 6c73 0a2a nput terminals.* │ │ │ │ -00026120: 2074 6572 6d69 6e61 6c5f 6f75 7470 7574 terminal_output │ │ │ │ -00026130: 3a3a 2020 2020 2020 2020 2020 2020 204d :: M │ │ │ │ -00026140: 616e 6167 6520 6f75 7470 7574 2074 6572 anage output ter │ │ │ │ -00026150: 6d69 6e61 6c73 0a2a 2074 6572 6d69 6e66 minals.* terminf │ │ │ │ -00026160: 6f3a 3a20 2020 2020 2020 2020 2020 2020 o:: │ │ │ │ -00026170: 2020 2020 2020 2044 6566 696e 6520 7465 Define te │ │ │ │ -00026180: 726d 696e 616c 2074 7970 650a 0a1f 0a46 rminal type....F │ │ │ │ -00026190: 696c 653a 2067 7275 622e 696e 666f 2c20 ile: grub.info, │ │ │ │ -000261a0: 204e 6f64 653a 2073 6572 6961 6c2c 2020 Node: serial, │ │ │ │ -000261b0: 4e65 7874 3a20 7465 726d 696e 616c 5f69 Next: terminal_i │ │ │ │ -000261c0: 6e70 7574 2c20 2055 703a 2047 656e 6572 nput, Up: Gener │ │ │ │ -000261d0: 616c 2063 6f6d 6d61 6e64 730a 0a31 362e al commands..16. │ │ │ │ -000261e0: 322e 3120 7365 7269 616c 0a2d 2d2d 2d2d 2.1 serial.----- │ │ │ │ -000261f0: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 436f --------.. -- Co │ │ │ │ -00026200: 6d6d 616e 643a 2073 6572 6961 6c20 5b27 mmand: serial [' │ │ │ │ -00026210: 2d2d 756e 6974 3d75 6e69 7427 5d20 5b27 --unit=unit'] [' │ │ │ │ -00026220: 2d2d 706f 7274 3d70 6f72 7427 5d20 5b27 --port=port'] [' │ │ │ │ -00026230: 2d2d 7370 6565 643d 7370 6565 6427 5d0a --speed=speed']. │ │ │ │ -00026240: 2020 2020 2020 2020 2020 5b27 2d2d 776f ['--wo │ │ │ │ -00026250: 7264 3d77 6f72 6427 5d20 5b27 2d2d 7061 rd=word'] ['--pa │ │ │ │ -00026260: 7269 7479 3d70 6172 6974 7927 5d20 5b27 rity=parity'] [' │ │ │ │ -00026270: 2d2d 7374 6f70 3d73 746f 7027 5d0a 2020 --stop=stop']. │ │ │ │ -00026280: 2020 2049 6e69 7469 616c 697a 6520 6120 Initialize a │ │ │ │ -00026290: 7365 7269 616c 2064 6576 6963 652e 2020 serial device. │ │ │ │ -000262a0: 554e 4954 2069 7320 6120 6e75 6d62 6572 UNIT is a number │ │ │ │ -000262b0: 2069 6e20 7468 6520 7261 6e67 6520 302d in the range 0- │ │ │ │ -000262c0: 330a 2020 2020 2073 7065 6369 6679 696e 3. specifyin │ │ │ │ -000262d0: 6720 7768 6963 6820 7365 7269 616c 2070 g which serial p │ │ │ │ -000262e0: 6f72 7420 746f 2075 7365 3b20 6465 6661 ort to use; defa │ │ │ │ -000262f0: 756c 7420 6973 2030 2c20 7768 6963 680a ult is 0, which. │ │ │ │ -00026300: 2020 2020 2063 6f72 7265 7370 6f6e 6473 corresponds │ │ │ │ -00026310: 2074 6f20 7468 6520 706f 7274 206f 6674 to the port oft │ │ │ │ -00026320: 656e 2063 616c 6c65 6420 434f 4d31 2e20 en called COM1. │ │ │ │ -00026330: 2050 4f52 5420 6973 2074 6865 2049 2f4f PORT is the I/O │ │ │ │ -00026340: 2070 6f72 740a 2020 2020 2077 6865 7265 port. where │ │ │ │ -00026350: 2074 6865 2055 4152 5420 6973 2074 6f20 the UART is to │ │ │ │ -00026360: 6265 2066 6f75 6e64 3b20 6966 2073 7065 be found; if spe │ │ │ │ -00026370: 6369 6669 6564 2069 7420 7461 6b65 7320 cified it takes │ │ │ │ -00026380: 7072 6563 6564 656e 6365 0a20 2020 2020 precedence. │ │ │ │ -00026390: 6f76 6572 2055 4e49 542e 2020 5350 4545 over UNIT. SPEE │ │ │ │ -000263a0: 4420 6973 2074 6865 2074 7261 6e73 6d69 D is the transmi │ │ │ │ -000263b0: 7373 696f 6e20 7370 6565 643b 2064 6566 ssion speed; def │ │ │ │ -000263c0: 6175 6c74 2069 7320 3936 3030 2e20 2057 ault is 9600. W │ │ │ │ -000263d0: 4f52 440a 2020 2020 2061 6e64 2053 544f ORD. and STO │ │ │ │ -000263e0: 5020 6172 6520 7468 6520 6e75 6d62 6572 P are the number │ │ │ │ -000263f0: 206f 6620 6461 7461 2062 6974 7320 616e of data bits an │ │ │ │ -00026400: 6420 7374 6f70 2062 6974 732e 2020 4461 d stop bits. Da │ │ │ │ -00026410: 7461 2062 6974 7320 6d75 7374 0a20 2020 ta bits must. │ │ │ │ -00026420: 2020 6265 2069 6e20 7468 6520 7261 6e67 be in the rang │ │ │ │ -00026430: 6520 352d 3820 616e 6420 7374 6f70 2062 e 5-8 and stop b │ │ │ │ -00026440: 6974 7320 6d75 7374 2062 6520 3120 6f72 its must be 1 or │ │ │ │ -00026450: 2032 2e20 2044 6566 6175 6c74 2069 7320 2. Default is │ │ │ │ -00026460: 380a 2020 2020 2064 6174 6120 6269 7473 8. data bits │ │ │ │ -00026470: 2061 6e64 206f 6e65 2073 746f 7020 6269 and one stop bi │ │ │ │ -00026480: 742e 2020 5041 5249 5459 2069 7320 6f6e t. PARITY is on │ │ │ │ -00026490: 6520 6f66 2027 6e6f 272c 2027 6f64 6427 e of 'no', 'odd' │ │ │ │ -000264a0: 2c20 2765 7665 6e27 0a20 2020 2020 616e , 'even'. an │ │ │ │ -000264b0: 6420 6465 6661 756c 7473 2074 6f20 276e d defaults to 'n │ │ │ │ -000264c0: 6f27 2e0a 0a20 2020 2020 5468 6520 7365 o'... The se │ │ │ │ -000264d0: 7269 616c 2070 6f72 7420 6973 206e 6f74 rial port is not │ │ │ │ -000264e0: 2075 7365 6420 6173 2061 2063 6f6d 6d75 used as a commu │ │ │ │ -000264f0: 6e69 6361 7469 6f6e 2063 6861 6e6e 656c nication channel │ │ │ │ -00026500: 2075 6e6c 6573 7320 7468 650a 2020 2020 unless the. │ │ │ │ -00026510: 2027 7465 726d 696e 616c 5f69 6e70 7574 'terminal_input │ │ │ │ -00026520: 2720 6f72 2027 7465 726d 696e 616c 5f6f ' or 'terminal_o │ │ │ │ -00026530: 7574 7075 7427 2063 6f6d 6d61 6e64 2069 utput' command i │ │ │ │ -00026540: 7320 7573 6564 2028 2a6e 6f74 650a 2020 s used (*note. │ │ │ │ -00026550: 2020 2074 6572 6d69 6e61 6c5f 696e 7075 terminal_inpu │ │ │ │ -00026560: 743a 3a2c 202a 6e6f 7465 2074 6572 6d69 t::, *note termi │ │ │ │ -00026570: 6e61 6c5f 6f75 7470 7574 3a3a 292e 0a0a nal_output::)... │ │ │ │ -00026580: 2020 2020 2053 6565 2061 6c73 6f20 2a6e See also *n │ │ │ │ -00026590: 6f74 6520 5365 7269 616c 2074 6572 6d69 ote Serial termi │ │ │ │ -000265a0: 6e61 6c3a 3a2e 0a0a 1f0a 4669 6c65 3a20 nal::.....File: │ │ │ │ -000265b0: 6772 7562 2e69 6e66 6f2c 2020 4e6f 6465 grub.info, Node │ │ │ │ -000265c0: 3a20 7465 726d 696e 616c 5f69 6e70 7574 : terminal_input │ │ │ │ -000265d0: 2c20 204e 6578 743a 2074 6572 6d69 6e61 , Next: termina │ │ │ │ -000265e0: 6c5f 6f75 7470 7574 2c20 2050 7265 763a l_output, Prev: │ │ │ │ -000265f0: 2073 6572 6961 6c2c 2020 5570 3a20 4765 serial, Up: Ge │ │ │ │ -00026600: 6e65 7261 6c20 636f 6d6d 616e 6473 0a0a neral commands.. │ │ │ │ -00026610: 3136 2e32 2e32 2074 6572 6d69 6e61 6c5f 16.2.2 terminal_ │ │ │ │ -00026620: 696e 7075 740a 2d2d 2d2d 2d2d 2d2d 2d2d input.---------- │ │ │ │ -00026630: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d -----------.. -- │ │ │ │ -00026640: 2043 6f6d 6d61 6e64 3a20 7465 726d 696e Command: termin │ │ │ │ -00026650: 616c 5f69 6e70 7574 205b 272d 2d61 7070 al_input ['--app │ │ │ │ -00026660: 656e 6427 7c27 2d2d 7265 6d6f 7665 275d end'|'--remove'] │ │ │ │ -00026670: 205b 7465 726d 696e 616c 315d 0a20 2020 [terminal1]. │ │ │ │ -00026680: 2020 2020 2020 205b 7465 726d 696e 616c [terminal │ │ │ │ -00026690: 325d 202e 2e2e 0a20 2020 2020 4c69 7374 2] .... List │ │ │ │ -000266a0: 206f 7220 7365 6c65 6374 2061 6e20 696e or select an in │ │ │ │ -000266b0: 7075 7420 7465 726d 696e 616c 2e0a 0a20 put terminal... │ │ │ │ -000266c0: 2020 2020 5769 7468 206e 6f20 6172 6775 With no argu │ │ │ │ -000266d0: 6d65 6e74 732c 206c 6973 7420 7468 6520 ments, list the │ │ │ │ -000266e0: 6163 7469 7665 2061 6e64 2061 7661 696c active and avail │ │ │ │ -000266f0: 6162 6c65 2069 6e70 7574 2074 6572 6d69 able input termi │ │ │ │ -00026700: 6e61 6c73 2e0a 0a20 2020 2020 5769 7468 nals... With │ │ │ │ -00026710: 2027 2d2d 6170 7065 6e64 272c 2061 6464 '--append', add │ │ │ │ -00026720: 2074 6865 206e 616d 6564 2074 6572 6d69 the named termi │ │ │ │ -00026730: 6e61 6c73 2074 6f20 7468 6520 6c69 7374 nals to the list │ │ │ │ -00026740: 206f 6620 6163 7469 7665 0a20 2020 2020 of active. │ │ │ │ -00026750: 696e 7075 7420 7465 726d 696e 616c 733b input terminals; │ │ │ │ -00026760: 2061 6e79 206f 6620 7468 6573 6520 6d61 any of these ma │ │ │ │ -00026770: 7920 6265 2075 7365 6420 746f 2070 726f y be used to pro │ │ │ │ -00026780: 7669 6465 2069 6e70 7574 2074 6f20 4752 vide input to GR │ │ │ │ -00026790: 5542 2e0a 0a20 2020 2020 5769 7468 2027 UB... With ' │ │ │ │ -000267a0: 2d2d 7265 6d6f 7665 272c 2072 656d 6f76 --remove', remov │ │ │ │ -000267b0: 6520 7468 6520 6e61 6d65 6420 7465 726d e the named term │ │ │ │ -000267c0: 696e 616c 7320 6672 6f6d 2074 6865 2061 inals from the a │ │ │ │ -000267d0: 6374 6976 6520 6c69 7374 2e0a 0a20 2020 ctive list... │ │ │ │ -000267e0: 2020 5769 7468 206e 6f20 6f70 7469 6f6e With no option │ │ │ │ -000267f0: 7320 6275 7420 6120 6c69 7374 206f 6620 s but a list of │ │ │ │ -00026800: 7465 726d 696e 616c 206e 616d 6573 2c20 terminal names, │ │ │ │ -00026810: 6d61 6b65 206f 6e6c 7920 7468 6520 6c69 make only the li │ │ │ │ -00026820: 7374 6564 0a20 2020 2020 7465 726d 696e sted. termin │ │ │ │ -00026830: 616c 206e 616d 6573 2061 6374 6976 652e al names active. │ │ │ │ -00026840: 0a0a 1f0a 4669 6c65 3a20 6772 7562 2e69 ....File: grub.i │ │ │ │ -00026850: 6e66 6f2c 2020 4e6f 6465 3a20 7465 726d nfo, Node: term │ │ │ │ -00026860: 696e 616c 5f6f 7574 7075 742c 2020 4e65 inal_output, Ne │ │ │ │ -00026870: 7874 3a20 7465 726d 696e 666f 2c20 2050 xt: terminfo, P │ │ │ │ -00026880: 7265 763a 2074 6572 6d69 6e61 6c5f 696e rev: terminal_in │ │ │ │ -00026890: 7075 742c 2020 5570 3a20 4765 6e65 7261 put, Up: Genera │ │ │ │ -000268a0: 6c20 636f 6d6d 616e 6473 0a0a 3136 2e32 l commands..16.2 │ │ │ │ -000268b0: 2e33 2074 6572 6d69 6e61 6c5f 6f75 7470 .3 terminal_outp │ │ │ │ -000268c0: 7574 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ut.------------- │ │ │ │ -000268d0: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2043 ---------.. -- C │ │ │ │ -000268e0: 6f6d 6d61 6e64 3a20 7465 726d 696e 616c ommand: terminal │ │ │ │ -000268f0: 5f6f 7574 7075 7420 5b27 2d2d 6170 7065 _output ['--appe │ │ │ │ -00026900: 6e64 277c 272d 2d72 656d 6f76 6527 5d20 nd'|'--remove'] │ │ │ │ -00026910: 5b74 6572 6d69 6e61 6c31 5d0a 2020 2020 [terminal1]. │ │ │ │ -00026920: 2020 2020 2020 5b74 6572 6d69 6e61 6c32 [terminal2 │ │ │ │ -00026930: 5d20 2e2e 2e0a 2020 2020 204c 6973 7420 ] .... List │ │ │ │ -00026940: 6f72 2073 656c 6563 7420 616e 206f 7574 or select an out │ │ │ │ -00026950: 7075 7420 7465 726d 696e 616c 2e0a 0a20 put terminal... │ │ │ │ -00026960: 2020 2020 5769 7468 206e 6f20 6172 6775 With no argu │ │ │ │ -00026970: 6d65 6e74 732c 206c 6973 7420 7468 6520 ments, list the │ │ │ │ -00026980: 6163 7469 7665 2061 6e64 2061 7661 696c active and avail │ │ │ │ -00026990: 6162 6c65 206f 7574 7075 7420 7465 726d able output term │ │ │ │ -000269a0: 696e 616c 732e 0a0a 2020 2020 2057 6974 inals... Wit │ │ │ │ -000269b0: 6820 272d 2d61 7070 656e 6427 2c20 6164 h '--append', ad │ │ │ │ -000269c0: 6420 7468 6520 6e61 6d65 6420 7465 726d d the named term │ │ │ │ -000269d0: 696e 616c 7320 746f 2074 6865 206c 6973 inals to the lis │ │ │ │ -000269e0: 7420 6f66 2061 6374 6976 650a 2020 2020 t of active. │ │ │ │ -000269f0: 206f 7574 7075 7420 7465 726d 696e 616c output terminal │ │ │ │ -00026a00: 733b 2061 6c6c 206f 6620 7468 6573 6520 s; all of these │ │ │ │ -00026a10: 7769 6c6c 2072 6563 6569 7665 206f 7574 will receive out │ │ │ │ -00026a20: 7075 7420 6672 6f6d 2047 5255 422e 0a0a put from GRUB... │ │ │ │ -00026a30: 2020 2020 2057 6974 6820 272d 2d72 656d With '--rem │ │ │ │ -00026a40: 6f76 6527 2c20 7265 6d6f 7665 2074 6865 ove', remove the │ │ │ │ -00026a50: 206e 616d 6564 2074 6572 6d69 6e61 6c73 named terminals │ │ │ │ -00026a60: 2066 726f 6d20 7468 6520 6163 7469 7665 from the active │ │ │ │ -00026a70: 206c 6973 742e 0a0a 2020 2020 2057 6974 list... Wit │ │ │ │ -00026a80: 6820 6e6f 206f 7074 696f 6e73 2062 7574 h no options but │ │ │ │ -00026a90: 2061 206c 6973 7420 6f66 2074 6572 6d69 a list of termi │ │ │ │ -00026aa0: 6e61 6c20 6e61 6d65 732c 206d 616b 6520 nal names, make │ │ │ │ -00026ab0: 6f6e 6c79 2074 6865 206c 6973 7465 640a only the listed. │ │ │ │ -00026ac0: 2020 2020 2074 6572 6d69 6e61 6c20 6e61 terminal na │ │ │ │ -00026ad0: 6d65 7320 6163 7469 7665 2e0a 0a1f 0a46 mes active.....F │ │ │ │ -00026ae0: 696c 653a 2067 7275 622e 696e 666f 2c20 ile: grub.info, │ │ │ │ -00026af0: 204e 6f64 653a 2074 6572 6d69 6e66 6f2c Node: terminfo, │ │ │ │ -00026b00: 2020 5072 6576 3a20 7465 726d 696e 616c Prev: terminal │ │ │ │ -00026b10: 5f6f 7574 7075 742c 2020 5570 3a20 4765 _output, Up: Ge │ │ │ │ -00026b20: 6e65 7261 6c20 636f 6d6d 616e 6473 0a0a neral commands.. │ │ │ │ -00026b30: 3136 2e32 2e34 2074 6572 6d69 6e66 6f0a 16.2.4 terminfo. │ │ │ │ -00026b40: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a ---------------. │ │ │ │ -00026b50: 0a20 2d2d 2043 6f6d 6d61 6e64 3a20 7465 . -- Command: te │ │ │ │ -00026b60: 726d 696e 666f 205b 2d61 7c2d 757c 2d76 rminfo [-a|-u|-v │ │ │ │ -00026b70: 5d20 5b74 6572 6d5d 0a20 2020 2020 4465 ] [term]. De │ │ │ │ -00026b80: 6669 6e65 2074 6865 2063 6170 6162 696c fine the capabil │ │ │ │ -00026b90: 6974 6965 7320 6f66 2079 6f75 7220 7465 ities of your te │ │ │ │ -00026ba0: 726d 696e 616c 2062 7920 6769 7669 6e67 rminal by giving │ │ │ │ -00026bb0: 2074 6865 206e 616d 6520 6f66 2061 6e0a the name of an. │ │ │ │ -00026bc0: 2020 2020 2065 6e74 7279 2069 6e20 7468 entry in th │ │ │ │ -00026bd0: 6520 7465 726d 696e 666f 2064 6174 6162 e terminfo datab │ │ │ │ -00026be0: 6173 652c 2077 6869 6368 2073 686f 756c ase, which shoul │ │ │ │ -00026bf0: 6420 636f 7272 6573 706f 6e64 2072 6f75 d correspond rou │ │ │ │ -00026c00: 6768 6c79 2074 6f0a 2020 2020 2061 2027 ghly to. a ' │ │ │ │ -00026c10: 5445 524d 2720 656e 7669 726f 6e6d 656e TERM' environmen │ │ │ │ -00026c20: 7420 7661 7269 6162 6c65 2069 6e20 556e t variable in Un │ │ │ │ -00026c30: 6978 2e0a 0a20 2020 2020 5468 6520 6375 ix... The cu │ │ │ │ -00026c40: 7272 656e 746c 7920 6176 6169 6c61 626c rrently availabl │ │ │ │ -00026c50: 6520 7465 726d 696e 616c 2074 7970 6573 e terminal types │ │ │ │ -00026c60: 2061 7265 2027 7674 3130 3027 2c20 2776 are 'vt100', 'v │ │ │ │ -00026c70: 7431 3030 2d63 6f6c 6f72 272c 0a20 2020 t100-color',. │ │ │ │ -00026c80: 2020 2769 6565 6531 3237 3527 2c20 616e 'ieee1275', an │ │ │ │ -00026c90: 6420 2764 756d 6227 2e20 2049 6620 796f d 'dumb'. If yo │ │ │ │ -00026ca0: 7520 6e65 6564 206f 7468 6572 2074 6572 u need other ter │ │ │ │ -00026cb0: 6d69 6e61 6c20 7479 7065 732c 2070 6c65 minal types, ple │ │ │ │ -00026cc0: 6173 650a 2020 2020 2063 6f6e 7461 6374 ase. contact │ │ │ │ -00026cd0: 2075 7320 746f 2064 6973 6375 7373 2074 us to discuss t │ │ │ │ -00026ce0: 6865 2062 6573 7420 7761 7920 746f 2069 he best way to i │ │ │ │ -00026cf0: 6e63 6c75 6465 2073 7570 706f 7274 2066 nclude support f │ │ │ │ -00026d00: 6f72 2074 6865 7365 2069 6e0a 2020 2020 or these in. │ │ │ │ -00026d10: 2047 5255 422e 0a0a 2020 2020 2054 6865 GRUB... The │ │ │ │ -00026d20: 2027 2d61 2720 2827 2d2d 6173 6369 6927 '-a' ('--ascii' │ │ │ │ -00026d30: 292c 2027 2d75 2720 2827 2d2d 7574 6638 ), '-u' ('--utf8 │ │ │ │ -00026d40: 2729 2c20 616e 6420 272d 7627 2028 272d '), and '-v' ('- │ │ │ │ -00026d50: 2d76 6973 7561 6c2d 7574 6638 2729 0a20 -visual-utf8'). │ │ │ │ -00026d60: 2020 2020 6f70 7469 6f6e 7320 636f 6e74 options cont │ │ │ │ -00026d70: 726f 6c20 686f 7720 6e6f 6e2d 4153 4349 rol how non-ASCI │ │ │ │ -00026d80: 4920 7465 7874 2069 7320 6469 7370 6c61 I text is displa │ │ │ │ -00026d90: 7965 642e 2020 272d 6127 2073 7065 6369 yed. '-a' speci │ │ │ │ -00026da0: 6669 6573 2061 6e0a 2020 2020 2041 5343 fies an. ASC │ │ │ │ -00026db0: 4949 2d6f 6e6c 7920 7465 726d 696e 616c II-only terminal │ │ │ │ -00026dc0: 3b20 272d 7527 2073 7065 6369 6669 6573 ; '-u' specifies │ │ │ │ -00026dd0: 206c 6f67 6963 616c 6c79 2d6f 7264 6572 logically-order │ │ │ │ -00026de0: 6564 2055 5446 2d38 3b20 616e 640a 2020 ed UTF-8; and. │ │ │ │ -00026df0: 2020 2027 2d76 2720 7370 6563 6966 6965 '-v' specifie │ │ │ │ -00026e00: 7320 2276 6973 7561 6c6c 792d 6f72 6465 s "visually-orde │ │ │ │ -00026e10: 7265 6420 5554 462d 3822 2028 696e 206f red UTF-8" (in o │ │ │ │ -00026e20: 7468 6572 2077 6f72 6473 2c20 6172 7261 ther words, arra │ │ │ │ -00026e30: 6e67 6564 0a20 2020 2020 7375 6368 2074 nged. such t │ │ │ │ -00026e40: 6861 7420 6120 7465 726d 696e 616c 2065 hat a terminal e │ │ │ │ -00026e50: 6d75 6c61 746f 7220 7769 7468 6f75 7420 mulator without │ │ │ │ -00026e60: 6269 6469 7265 6374 696f 6e61 6c20 7465 bidirectional te │ │ │ │ -00026e70: 7874 2073 7570 706f 7274 0a20 2020 2020 xt support. │ │ │ │ -00026e80: 7769 6c6c 2064 6973 706c 6179 2072 6967 will display rig │ │ │ │ -00026e90: 6874 2d74 6f2d 6c65 6674 2074 6578 7420 ht-to-left text │ │ │ │ -00026ea0: 696e 2074 6865 2070 726f 7065 7220 6f72 in the proper or │ │ │ │ -00026eb0: 6465 723b 2074 6869 7320 6973 206e 6f74 der; this is not │ │ │ │ -00026ec0: 0a20 2020 2020 7265 616c 6c79 2070 726f . really pro │ │ │ │ -00026ed0: 7065 7220 5554 462d 382c 2062 7574 2061 per UTF-8, but a │ │ │ │ -00026ee0: 2077 6f72 6b61 726f 756e 6429 2e0a 0a20 workaround)... │ │ │ │ -00026ef0: 2020 2020 4966 206e 6f20 6f70 7469 6f6e If no option │ │ │ │ -00026f00: 206f 7220 7465 726d 696e 616c 2074 7970 or terminal typ │ │ │ │ -00026f10: 6520 6973 2073 7065 6369 6669 6564 2c20 e is specified, │ │ │ │ -00026f20: 7468 6520 6375 7272 656e 7420 7465 726d the current term │ │ │ │ -00026f30: 696e 616c 0a20 2020 2020 7479 7065 2069 inal. type i │ │ │ │ -00026f40: 7320 7072 696e 7465 642e 0a0a 1f0a 4669 s printed.....Fi │ │ │ │ -00026f50: 6c65 3a20 6772 7562 2e69 6e66 6f2c 2020 le: grub.info, │ │ │ │ -00026f60: 4e6f 6465 3a20 436f 6d6d 616e 642d 6c69 Node: Command-li │ │ │ │ -00026f70: 6e65 2061 6e64 206d 656e 7520 656e 7472 ne and menu entr │ │ │ │ -00026f80: 7920 636f 6d6d 616e 6473 2c20 204e 6578 y commands, Nex │ │ │ │ -00026f90: 743a 204e 6574 776f 726b 696e 6720 636f t: Networking co │ │ │ │ -00026fa0: 6d6d 616e 6473 2c20 2050 7265 763a 2047 mmands, Prev: G │ │ │ │ -00026fb0: 656e 6572 616c 2063 6f6d 6d61 6e64 732c eneral commands, │ │ │ │ -00026fc0: 2020 5570 3a20 436f 6d6d 616e 6473 0a0a Up: Commands.. │ │ │ │ -00026fd0: 3136 2e33 2054 6865 206c 6973 7420 6f66 16.3 The list of │ │ │ │ -00026fe0: 2063 6f6d 6d61 6e64 2d6c 696e 6520 616e command-line an │ │ │ │ -00026ff0: 6420 6d65 6e75 2065 6e74 7279 2063 6f6d d menu entry com │ │ │ │ -00027000: 6d61 6e64 730a 3d3d 3d3d 3d3d 3d3d 3d3d mands.========== │ │ │ │ +000260d0: 2020 2020 2053 6574 2075 7020 6120 7365 Set up a se │ │ │ │ +000260e0: 7269 616c 2064 6576 6963 650a 2a20 7465 rial device.* te │ │ │ │ +000260f0: 726d 696e 616c 5f69 6e70 7574 3a3a 2020 rminal_input:: │ │ │ │ +00026100: 2020 2020 2020 2020 2020 2020 4d61 6e61 Mana │ │ │ │ +00026110: 6765 2069 6e70 7574 2074 6572 6d69 6e61 ge input termina │ │ │ │ +00026120: 6c73 0a2a 2074 6572 6d69 6e61 6c5f 6f75 ls.* terminal_ou │ │ │ │ +00026130: 7470 7574 3a3a 2020 2020 2020 2020 2020 tput:: │ │ │ │ +00026140: 2020 204d 616e 6167 6520 6f75 7470 7574 Manage output │ │ │ │ +00026150: 2074 6572 6d69 6e61 6c73 0a2a 2074 6572 terminals.* ter │ │ │ │ +00026160: 6d69 6e66 6f3a 3a20 2020 2020 2020 2020 minfo:: │ │ │ │ +00026170: 2020 2020 2020 2020 2020 2044 6566 696e Defin │ │ │ │ +00026180: 6520 7465 726d 696e 616c 2074 7970 650a e terminal type. │ │ │ │ +00026190: 0a1f 0a46 696c 653a 2067 7275 622e 696e ...File: grub.in │ │ │ │ +000261a0: 666f 2c20 204e 6f64 653a 2073 6572 6961 fo, Node: seria │ │ │ │ +000261b0: 6c2c 2020 4e65 7874 3a20 7465 726d 696e l, Next: termin │ │ │ │ +000261c0: 616c 5f69 6e70 7574 2c20 2055 703a 2047 al_input, Up: G │ │ │ │ +000261d0: 656e 6572 616c 2063 6f6d 6d61 6e64 730a eneral commands. │ │ │ │ +000261e0: 0a31 362e 322e 3120 7365 7269 616c 0a2d .16.2.1 serial.- │ │ │ │ +000261f0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d ------------.. - │ │ │ │ +00026200: 2d20 436f 6d6d 616e 643a 2073 6572 6961 - Command: seria │ │ │ │ +00026210: 6c20 5b27 2d2d 756e 6974 3d75 6e69 7427 l ['--unit=unit' │ │ │ │ +00026220: 5d20 5b27 2d2d 706f 7274 3d70 6f72 7427 ] ['--port=port' │ │ │ │ +00026230: 5d20 5b27 2d2d 7370 6565 643d 7370 6565 ] ['--speed=spee │ │ │ │ +00026240: 6427 5d0a 2020 2020 2020 2020 2020 5b27 d']. [' │ │ │ │ +00026250: 2d2d 776f 7264 3d77 6f72 6427 5d20 5b27 --word=word'] [' │ │ │ │ +00026260: 2d2d 7061 7269 7479 3d70 6172 6974 7927 --parity=parity' │ │ │ │ +00026270: 5d20 5b27 2d2d 7374 6f70 3d73 746f 7027 ] ['--stop=stop' │ │ │ │ +00026280: 5d0a 2020 2020 2049 6e69 7469 616c 697a ]. Initializ │ │ │ │ +00026290: 6520 6120 7365 7269 616c 2064 6576 6963 e a serial devic │ │ │ │ +000262a0: 652e 2020 554e 4954 2069 7320 6120 6e75 e. UNIT is a nu │ │ │ │ +000262b0: 6d62 6572 2069 6e20 7468 6520 7261 6e67 mber in the rang │ │ │ │ +000262c0: 6520 302d 330a 2020 2020 2073 7065 6369 e 0-3. speci │ │ │ │ +000262d0: 6679 696e 6720 7768 6963 6820 7365 7269 fying which seri │ │ │ │ +000262e0: 616c 2070 6f72 7420 746f 2075 7365 3b20 al port to use; │ │ │ │ +000262f0: 6465 6661 756c 7420 6973 2030 2c20 7768 default is 0, wh │ │ │ │ +00026300: 6963 680a 2020 2020 2063 6f72 7265 7370 ich. corresp │ │ │ │ +00026310: 6f6e 6473 2074 6f20 7468 6520 706f 7274 onds to the port │ │ │ │ +00026320: 206f 6674 656e 2063 616c 6c65 6420 434f often called CO │ │ │ │ +00026330: 4d31 2e20 2050 4f52 5420 6973 2074 6865 M1. PORT is the │ │ │ │ +00026340: 2049 2f4f 2070 6f72 740a 2020 2020 2077 I/O port. w │ │ │ │ +00026350: 6865 7265 2074 6865 2055 4152 5420 6973 here the UART is │ │ │ │ +00026360: 2074 6f20 6265 2066 6f75 6e64 3b20 6966 to be found; if │ │ │ │ +00026370: 2073 7065 6369 6669 6564 2069 7420 7461 specified it ta │ │ │ │ +00026380: 6b65 7320 7072 6563 6564 656e 6365 0a20 kes precedence. │ │ │ │ +00026390: 2020 2020 6f76 6572 2055 4e49 542e 2020 over UNIT. │ │ │ │ +000263a0: 5350 4545 4420 6973 2074 6865 2074 7261 SPEED is the tra │ │ │ │ +000263b0: 6e73 6d69 7373 696f 6e20 7370 6565 643b nsmission speed; │ │ │ │ +000263c0: 2064 6566 6175 6c74 2069 7320 3936 3030 default is 9600 │ │ │ │ +000263d0: 2e20 2057 4f52 440a 2020 2020 2061 6e64 . WORD. and │ │ │ │ +000263e0: 2053 544f 5020 6172 6520 7468 6520 6e75 STOP are the nu │ │ │ │ +000263f0: 6d62 6572 206f 6620 6461 7461 2062 6974 mber of data bit │ │ │ │ +00026400: 7320 616e 6420 7374 6f70 2062 6974 732e s and stop bits. │ │ │ │ +00026410: 2020 4461 7461 2062 6974 7320 6d75 7374 Data bits must │ │ │ │ +00026420: 0a20 2020 2020 6265 2069 6e20 7468 6520 . be in the │ │ │ │ +00026430: 7261 6e67 6520 352d 3820 616e 6420 7374 range 5-8 and st │ │ │ │ +00026440: 6f70 2062 6974 7320 6d75 7374 2062 6520 op bits must be │ │ │ │ +00026450: 3120 6f72 2032 2e20 2044 6566 6175 6c74 1 or 2. Default │ │ │ │ +00026460: 2069 7320 380a 2020 2020 2064 6174 6120 is 8. data │ │ │ │ +00026470: 6269 7473 2061 6e64 206f 6e65 2073 746f bits and one sto │ │ │ │ +00026480: 7020 6269 742e 2020 5041 5249 5459 2069 p bit. PARITY i │ │ │ │ +00026490: 7320 6f6e 6520 6f66 2027 6e6f 272c 2027 s one of 'no', ' │ │ │ │ +000264a0: 6f64 6427 2c20 2765 7665 6e27 0a20 2020 odd', 'even'. │ │ │ │ +000264b0: 2020 616e 6420 6465 6661 756c 7473 2074 and defaults t │ │ │ │ +000264c0: 6f20 276e 6f27 2e0a 0a20 2020 2020 5468 o 'no'... Th │ │ │ │ +000264d0: 6520 7365 7269 616c 2070 6f72 7420 6973 e serial port is │ │ │ │ +000264e0: 206e 6f74 2075 7365 6420 6173 2061 2063 not used as a c │ │ │ │ +000264f0: 6f6d 6d75 6e69 6361 7469 6f6e 2063 6861 ommunication cha │ │ │ │ +00026500: 6e6e 656c 2075 6e6c 6573 7320 7468 650a nnel unless the. │ │ │ │ +00026510: 2020 2020 2027 7465 726d 696e 616c 5f69 'terminal_i │ │ │ │ +00026520: 6e70 7574 2720 6f72 2027 7465 726d 696e nput' or 'termin │ │ │ │ +00026530: 616c 5f6f 7574 7075 7427 2063 6f6d 6d61 al_output' comma │ │ │ │ +00026540: 6e64 2069 7320 7573 6564 2028 2a6e 6f74 nd is used (*not │ │ │ │ +00026550: 650a 2020 2020 2074 6572 6d69 6e61 6c5f e. terminal_ │ │ │ │ +00026560: 696e 7075 743a 3a2c 202a 6e6f 7465 2074 input::, *note t │ │ │ │ +00026570: 6572 6d69 6e61 6c5f 6f75 7470 7574 3a3a erminal_output:: │ │ │ │ +00026580: 292e 0a0a 2020 2020 2053 6565 2061 6c73 )... See als │ │ │ │ +00026590: 6f20 2a6e 6f74 6520 5365 7269 616c 2074 o *note Serial t │ │ │ │ +000265a0: 6572 6d69 6e61 6c3a 3a2e 0a0a 1f0a 4669 erminal::.....Fi │ │ │ │ +000265b0: 6c65 3a20 6772 7562 2e69 6e66 6f2c 2020 le: grub.info, │ │ │ │ +000265c0: 4e6f 6465 3a20 7465 726d 696e 616c 5f69 Node: terminal_i │ │ │ │ +000265d0: 6e70 7574 2c20 204e 6578 743a 2074 6572 nput, Next: ter │ │ │ │ +000265e0: 6d69 6e61 6c5f 6f75 7470 7574 2c20 2050 minal_output, P │ │ │ │ +000265f0: 7265 763a 2073 6572 6961 6c2c 2020 5570 rev: serial, Up │ │ │ │ +00026600: 3a20 4765 6e65 7261 6c20 636f 6d6d 616e : General comman │ │ │ │ +00026610: 6473 0a0a 3136 2e32 2e32 2074 6572 6d69 ds..16.2.2 termi │ │ │ │ +00026620: 6e61 6c5f 696e 7075 740a 2d2d 2d2d 2d2d nal_input.------ │ │ │ │ +00026630: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a ---------------. │ │ │ │ +00026640: 0a20 2d2d 2043 6f6d 6d61 6e64 3a20 7465 . -- Command: te │ │ │ │ +00026650: 726d 696e 616c 5f69 6e70 7574 205b 272d rminal_input ['- │ │ │ │ +00026660: 2d61 7070 656e 6427 7c27 2d2d 7265 6d6f -append'|'--remo │ │ │ │ +00026670: 7665 275d 205b 7465 726d 696e 616c 315d ve'] [terminal1] │ │ │ │ +00026680: 0a20 2020 2020 2020 2020 205b 7465 726d . [term │ │ │ │ +00026690: 696e 616c 325d 202e 2e2e 0a20 2020 2020 inal2] .... │ │ │ │ +000266a0: 4c69 7374 206f 7220 7365 6c65 6374 2061 List or select a │ │ │ │ +000266b0: 6e20 696e 7075 7420 7465 726d 696e 616c n input terminal │ │ │ │ +000266c0: 2e0a 0a20 2020 2020 5769 7468 206e 6f20 ... With no │ │ │ │ +000266d0: 6172 6775 6d65 6e74 732c 206c 6973 7420 arguments, list │ │ │ │ +000266e0: 7468 6520 6163 7469 7665 2061 6e64 2061 the active and a │ │ │ │ +000266f0: 7661 696c 6162 6c65 2069 6e70 7574 2074 vailable input t │ │ │ │ +00026700: 6572 6d69 6e61 6c73 2e0a 0a20 2020 2020 erminals... │ │ │ │ +00026710: 5769 7468 2027 2d2d 6170 7065 6e64 272c With '--append', │ │ │ │ +00026720: 2061 6464 2074 6865 206e 616d 6564 2074 add the named t │ │ │ │ +00026730: 6572 6d69 6e61 6c73 2074 6f20 7468 6520 erminals to the │ │ │ │ +00026740: 6c69 7374 206f 6620 6163 7469 7665 0a20 list of active. │ │ │ │ +00026750: 2020 2020 696e 7075 7420 7465 726d 696e input termin │ │ │ │ +00026760: 616c 733b 2061 6e79 206f 6620 7468 6573 als; any of thes │ │ │ │ +00026770: 6520 6d61 7920 6265 2075 7365 6420 746f e may be used to │ │ │ │ +00026780: 2070 726f 7669 6465 2069 6e70 7574 2074 provide input t │ │ │ │ +00026790: 6f20 4752 5542 2e0a 0a20 2020 2020 5769 o GRUB... Wi │ │ │ │ +000267a0: 7468 2027 2d2d 7265 6d6f 7665 272c 2072 th '--remove', r │ │ │ │ +000267b0: 656d 6f76 6520 7468 6520 6e61 6d65 6420 emove the named │ │ │ │ +000267c0: 7465 726d 696e 616c 7320 6672 6f6d 2074 terminals from t │ │ │ │ +000267d0: 6865 2061 6374 6976 6520 6c69 7374 2e0a he active list.. │ │ │ │ +000267e0: 0a20 2020 2020 5769 7468 206e 6f20 6f70 . With no op │ │ │ │ +000267f0: 7469 6f6e 7320 6275 7420 6120 6c69 7374 tions but a list │ │ │ │ +00026800: 206f 6620 7465 726d 696e 616c 206e 616d of terminal nam │ │ │ │ +00026810: 6573 2c20 6d61 6b65 206f 6e6c 7920 7468 es, make only th │ │ │ │ +00026820: 6520 6c69 7374 6564 0a20 2020 2020 7465 e listed. te │ │ │ │ +00026830: 726d 696e 616c 206e 616d 6573 2061 6374 rminal names act │ │ │ │ +00026840: 6976 652e 0a0a 1f0a 4669 6c65 3a20 6772 ive.....File: gr │ │ │ │ +00026850: 7562 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ub.info, Node: │ │ │ │ +00026860: 7465 726d 696e 616c 5f6f 7574 7075 742c terminal_output, │ │ │ │ +00026870: 2020 4e65 7874 3a20 7465 726d 696e 666f Next: terminfo │ │ │ │ +00026880: 2c20 2050 7265 763a 2074 6572 6d69 6e61 , Prev: termina │ │ │ │ +00026890: 6c5f 696e 7075 742c 2020 5570 3a20 4765 l_input, Up: Ge │ │ │ │ +000268a0: 6e65 7261 6c20 636f 6d6d 616e 6473 0a0a neral commands.. │ │ │ │ +000268b0: 3136 2e32 2e33 2074 6572 6d69 6e61 6c5f 16.2.3 terminal_ │ │ │ │ +000268c0: 6f75 7470 7574 0a2d 2d2d 2d2d 2d2d 2d2d output.--------- │ │ │ │ +000268d0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 -------------.. │ │ │ │ +000268e0: 2d2d 2043 6f6d 6d61 6e64 3a20 7465 726d -- Command: term │ │ │ │ +000268f0: 696e 616c 5f6f 7574 7075 7420 5b27 2d2d inal_output ['-- │ │ │ │ +00026900: 6170 7065 6e64 277c 272d 2d72 656d 6f76 append'|'--remov │ │ │ │ +00026910: 6527 5d20 5b74 6572 6d69 6e61 6c31 5d0a e'] [terminal1]. │ │ │ │ +00026920: 2020 2020 2020 2020 2020 5b74 6572 6d69 [termi │ │ │ │ +00026930: 6e61 6c32 5d20 2e2e 2e0a 2020 2020 204c nal2] .... L │ │ │ │ +00026940: 6973 7420 6f72 2073 656c 6563 7420 616e ist or select an │ │ │ │ +00026950: 206f 7574 7075 7420 7465 726d 696e 616c output terminal │ │ │ │ +00026960: 2e0a 0a20 2020 2020 5769 7468 206e 6f20 ... With no │ │ │ │ +00026970: 6172 6775 6d65 6e74 732c 206c 6973 7420 arguments, list │ │ │ │ +00026980: 7468 6520 6163 7469 7665 2061 6e64 2061 the active and a │ │ │ │ +00026990: 7661 696c 6162 6c65 206f 7574 7075 7420 vailable output │ │ │ │ +000269a0: 7465 726d 696e 616c 732e 0a0a 2020 2020 terminals... │ │ │ │ +000269b0: 2057 6974 6820 272d 2d61 7070 656e 6427 With '--append' │ │ │ │ +000269c0: 2c20 6164 6420 7468 6520 6e61 6d65 6420 , add the named │ │ │ │ +000269d0: 7465 726d 696e 616c 7320 746f 2074 6865 terminals to the │ │ │ │ +000269e0: 206c 6973 7420 6f66 2061 6374 6976 650a list of active. │ │ │ │ +000269f0: 2020 2020 206f 7574 7075 7420 7465 726d output term │ │ │ │ +00026a00: 696e 616c 733b 2061 6c6c 206f 6620 7468 inals; all of th │ │ │ │ +00026a10: 6573 6520 7769 6c6c 2072 6563 6569 7665 ese will receive │ │ │ │ +00026a20: 206f 7574 7075 7420 6672 6f6d 2047 5255 output from GRU │ │ │ │ +00026a30: 422e 0a0a 2020 2020 2057 6974 6820 272d B... With '- │ │ │ │ +00026a40: 2d72 656d 6f76 6527 2c20 7265 6d6f 7665 -remove', remove │ │ │ │ +00026a50: 2074 6865 206e 616d 6564 2074 6572 6d69 the named termi │ │ │ │ +00026a60: 6e61 6c73 2066 726f 6d20 7468 6520 6163 nals from the ac │ │ │ │ +00026a70: 7469 7665 206c 6973 742e 0a0a 2020 2020 tive list... │ │ │ │ +00026a80: 2057 6974 6820 6e6f 206f 7074 696f 6e73 With no options │ │ │ │ +00026a90: 2062 7574 2061 206c 6973 7420 6f66 2074 but a list of t │ │ │ │ +00026aa0: 6572 6d69 6e61 6c20 6e61 6d65 732c 206d erminal names, m │ │ │ │ +00026ab0: 616b 6520 6f6e 6c79 2074 6865 206c 6973 ake only the lis │ │ │ │ +00026ac0: 7465 640a 2020 2020 2074 6572 6d69 6e61 ted. termina │ │ │ │ +00026ad0: 6c20 6e61 6d65 7320 6163 7469 7665 2e0a l names active.. │ │ │ │ +00026ae0: 0a1f 0a46 696c 653a 2067 7275 622e 696e ...File: grub.in │ │ │ │ +00026af0: 666f 2c20 204e 6f64 653a 2074 6572 6d69 fo, Node: termi │ │ │ │ +00026b00: 6e66 6f2c 2020 5072 6576 3a20 7465 726d nfo, Prev: term │ │ │ │ +00026b10: 696e 616c 5f6f 7574 7075 742c 2020 5570 inal_output, Up │ │ │ │ +00026b20: 3a20 4765 6e65 7261 6c20 636f 6d6d 616e : General comman │ │ │ │ +00026b30: 6473 0a0a 3136 2e32 2e34 2074 6572 6d69 ds..16.2.4 termi │ │ │ │ +00026b40: 6e66 6f0a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d nfo.------------ │ │ │ │ +00026b50: 2d2d 2d0a 0a20 2d2d 2043 6f6d 6d61 6e64 ---.. -- Command │ │ │ │ +00026b60: 3a20 7465 726d 696e 666f 205b 2d61 7c2d : terminfo [-a|- │ │ │ │ +00026b70: 757c 2d76 5d20 5b74 6572 6d5d 0a20 2020 u|-v] [term]. │ │ │ │ +00026b80: 2020 4465 6669 6e65 2074 6865 2063 6170 Define the cap │ │ │ │ +00026b90: 6162 696c 6974 6965 7320 6f66 2079 6f75 abilities of you │ │ │ │ +00026ba0: 7220 7465 726d 696e 616c 2062 7920 6769 r terminal by gi │ │ │ │ +00026bb0: 7669 6e67 2074 6865 206e 616d 6520 6f66 ving the name of │ │ │ │ +00026bc0: 2061 6e0a 2020 2020 2065 6e74 7279 2069 an. entry i │ │ │ │ +00026bd0: 6e20 7468 6520 7465 726d 696e 666f 2064 n the terminfo d │ │ │ │ +00026be0: 6174 6162 6173 652c 2077 6869 6368 2073 atabase, which s │ │ │ │ +00026bf0: 686f 756c 6420 636f 7272 6573 706f 6e64 hould correspond │ │ │ │ +00026c00: 2072 6f75 6768 6c79 2074 6f0a 2020 2020 roughly to. │ │ │ │ +00026c10: 2061 2027 5445 524d 2720 656e 7669 726f a 'TERM' enviro │ │ │ │ +00026c20: 6e6d 656e 7420 7661 7269 6162 6c65 2069 nment variable i │ │ │ │ +00026c30: 6e20 556e 6978 2e0a 0a20 2020 2020 5468 n Unix... Th │ │ │ │ +00026c40: 6520 6375 7272 656e 746c 7920 6176 6169 e currently avai │ │ │ │ +00026c50: 6c61 626c 6520 7465 726d 696e 616c 2074 lable terminal t │ │ │ │ +00026c60: 7970 6573 2061 7265 2027 7674 3130 3027 ypes are 'vt100' │ │ │ │ +00026c70: 2c20 2776 7431 3030 2d63 6f6c 6f72 272c , 'vt100-color', │ │ │ │ +00026c80: 0a20 2020 2020 2769 6565 6531 3237 3527 . 'ieee1275' │ │ │ │ +00026c90: 2c20 616e 6420 2764 756d 6227 2e20 2049 , and 'dumb'. I │ │ │ │ +00026ca0: 6620 796f 7520 6e65 6564 206f 7468 6572 f you need other │ │ │ │ +00026cb0: 2074 6572 6d69 6e61 6c20 7479 7065 732c terminal types, │ │ │ │ +00026cc0: 2070 6c65 6173 650a 2020 2020 2063 6f6e please. con │ │ │ │ +00026cd0: 7461 6374 2075 7320 746f 2064 6973 6375 tact us to discu │ │ │ │ +00026ce0: 7373 2074 6865 2062 6573 7420 7761 7920 ss the best way │ │ │ │ +00026cf0: 746f 2069 6e63 6c75 6465 2073 7570 706f to include suppo │ │ │ │ +00026d00: 7274 2066 6f72 2074 6865 7365 2069 6e0a rt for these in. │ │ │ │ +00026d10: 2020 2020 2047 5255 422e 0a0a 2020 2020 GRUB... │ │ │ │ +00026d20: 2054 6865 2027 2d61 2720 2827 2d2d 6173 The '-a' ('--as │ │ │ │ +00026d30: 6369 6927 292c 2027 2d75 2720 2827 2d2d cii'), '-u' ('-- │ │ │ │ +00026d40: 7574 6638 2729 2c20 616e 6420 272d 7627 utf8'), and '-v' │ │ │ │ +00026d50: 2028 272d 2d76 6973 7561 6c2d 7574 6638 ('--visual-utf8 │ │ │ │ +00026d60: 2729 0a20 2020 2020 6f70 7469 6f6e 7320 '). options │ │ │ │ +00026d70: 636f 6e74 726f 6c20 686f 7720 6e6f 6e2d control how non- │ │ │ │ +00026d80: 4153 4349 4920 7465 7874 2069 7320 6469 ASCII text is di │ │ │ │ +00026d90: 7370 6c61 7965 642e 2020 272d 6127 2073 splayed. '-a' s │ │ │ │ +00026da0: 7065 6369 6669 6573 2061 6e0a 2020 2020 pecifies an. │ │ │ │ +00026db0: 2041 5343 4949 2d6f 6e6c 7920 7465 726d ASCII-only term │ │ │ │ +00026dc0: 696e 616c 3b20 272d 7527 2073 7065 6369 inal; '-u' speci │ │ │ │ +00026dd0: 6669 6573 206c 6f67 6963 616c 6c79 2d6f fies logically-o │ │ │ │ +00026de0: 7264 6572 6564 2055 5446 2d38 3b20 616e rdered UTF-8; an │ │ │ │ +00026df0: 640a 2020 2020 2027 2d76 2720 7370 6563 d. '-v' spec │ │ │ │ +00026e00: 6966 6965 7320 2276 6973 7561 6c6c 792d ifies "visually- │ │ │ │ +00026e10: 6f72 6465 7265 6420 5554 462d 3822 2028 ordered UTF-8" ( │ │ │ │ +00026e20: 696e 206f 7468 6572 2077 6f72 6473 2c20 in other words, │ │ │ │ +00026e30: 6172 7261 6e67 6564 0a20 2020 2020 7375 arranged. su │ │ │ │ +00026e40: 6368 2074 6861 7420 6120 7465 726d 696e ch that a termin │ │ │ │ +00026e50: 616c 2065 6d75 6c61 746f 7220 7769 7468 al emulator with │ │ │ │ +00026e60: 6f75 7420 6269 6469 7265 6374 696f 6e61 out bidirectiona │ │ │ │ +00026e70: 6c20 7465 7874 2073 7570 706f 7274 0a20 l text support. │ │ │ │ +00026e80: 2020 2020 7769 6c6c 2064 6973 706c 6179 will display │ │ │ │ +00026e90: 2072 6967 6874 2d74 6f2d 6c65 6674 2074 right-to-left t │ │ │ │ +00026ea0: 6578 7420 696e 2074 6865 2070 726f 7065 ext in the prope │ │ │ │ +00026eb0: 7220 6f72 6465 723b 2074 6869 7320 6973 r order; this is │ │ │ │ +00026ec0: 206e 6f74 0a20 2020 2020 7265 616c 6c79 not. really │ │ │ │ +00026ed0: 2070 726f 7065 7220 5554 462d 382c 2062 proper UTF-8, b │ │ │ │ +00026ee0: 7574 2061 2077 6f72 6b61 726f 756e 6429 ut a workaround) │ │ │ │ +00026ef0: 2e0a 0a20 2020 2020 4966 206e 6f20 6f70 ... If no op │ │ │ │ +00026f00: 7469 6f6e 206f 7220 7465 726d 696e 616c tion or terminal │ │ │ │ +00026f10: 2074 7970 6520 6973 2073 7065 6369 6669 type is specifi │ │ │ │ +00026f20: 6564 2c20 7468 6520 6375 7272 656e 7420 ed, the current │ │ │ │ +00026f30: 7465 726d 696e 616c 0a20 2020 2020 7479 terminal. ty │ │ │ │ +00026f40: 7065 2069 7320 7072 696e 7465 642e 0a0a pe is printed... │ │ │ │ +00026f50: 1f0a 4669 6c65 3a20 6772 7562 2e69 6e66 ..File: grub.inf │ │ │ │ +00026f60: 6f2c 2020 4e6f 6465 3a20 436f 6d6d 616e o, Node: Comman │ │ │ │ +00026f70: 642d 6c69 6e65 2061 6e64 206d 656e 7520 d-line and menu │ │ │ │ +00026f80: 656e 7472 7920 636f 6d6d 616e 6473 2c20 entry commands, │ │ │ │ +00026f90: 204e 6578 743a 204e 6574 776f 726b 696e Next: Networkin │ │ │ │ +00026fa0: 6720 636f 6d6d 616e 6473 2c20 2050 7265 g commands, Pre │ │ │ │ +00026fb0: 763a 2047 656e 6572 616c 2063 6f6d 6d61 v: General comma │ │ │ │ +00026fc0: 6e64 732c 2020 5570 3a20 436f 6d6d 616e nds, Up: Comman │ │ │ │ +00026fd0: 6473 0a0a 3136 2e33 2054 6865 206c 6973 ds..16.3 The lis │ │ │ │ +00026fe0: 7420 6f66 2063 6f6d 6d61 6e64 2d6c 696e t of command-lin │ │ │ │ +00026ff0: 6520 616e 6420 6d65 6e75 2065 6e74 7279 e and menu entry │ │ │ │ +00027000: 2063 6f6d 6d61 6e64 730a 3d3d 3d3d 3d3d commands.====== │ │ │ │ 00027010: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ 00027020: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ -00027030: 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a54 6865 ===========..The │ │ │ │ -00027040: 7365 2063 6f6d 6d61 6e64 7320 6172 6520 se commands are │ │ │ │ -00027050: 7573 6162 6c65 2069 6e20 7468 6520 636f usable in the co │ │ │ │ -00027060: 6d6d 616e 642d 6c69 6e65 2061 6e64 2069 mmand-line and i │ │ │ │ -00027070: 6e20 6d65 6e75 2065 6e74 7269 6573 2e20 n menu entries. │ │ │ │ -00027080: 2049 660a 796f 7520 666f 7267 6574 2061 If.you forget a │ │ │ │ -00027090: 2063 6f6d 6d61 6e64 2c20 796f 7520 6361 command, you ca │ │ │ │ -000270a0: 6e20 7275 6e20 7468 6520 636f 6d6d 616e n run the comman │ │ │ │ -000270b0: 6420 2768 656c 7027 2028 2a6e 6f74 6520 d 'help' (*note │ │ │ │ -000270c0: 6865 6c70 3a3a 292e 0a0a 2a20 4d65 6e75 help::)...* Menu │ │ │ │ -000270d0: 3a0a 0a2a 205b 3a3a 2020 2020 2020 2020 :..* [:: │ │ │ │ +00027030: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a ===============. │ │ │ │ +00027040: 0a54 6865 7365 2063 6f6d 6d61 6e64 7320 .These commands │ │ │ │ +00027050: 6172 6520 7573 6162 6c65 2069 6e20 7468 are usable in th │ │ │ │ +00027060: 6520 636f 6d6d 616e 642d 6c69 6e65 2061 e command-line a │ │ │ │ +00027070: 6e64 2069 6e20 6d65 6e75 2065 6e74 7269 nd in menu entri │ │ │ │ +00027080: 6573 2e20 2049 660a 796f 7520 666f 7267 es. If.you forg │ │ │ │ +00027090: 6574 2061 2063 6f6d 6d61 6e64 2c20 796f et a command, yo │ │ │ │ +000270a0: 7520 6361 6e20 7275 6e20 7468 6520 636f u can run the co │ │ │ │ +000270b0: 6d6d 616e 6420 2768 656c 7027 2028 2a6e mmand 'help' (*n │ │ │ │ +000270c0: 6f74 6520 6865 6c70 3a3a 292e 0a0a 2a20 ote help::)...* │ │ │ │ +000270d0: 4d65 6e75 3a0a 0a2a 205b 3a3a 2020 2020 Menu:..* [:: │ │ │ │ 000270e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -000270f0: 2020 2043 6865 636b 2066 696c 6520 7479 Check file ty │ │ │ │ -00027100: 7065 7320 616e 6420 636f 6d70 6172 6520 pes and compare │ │ │ │ -00027110: 7661 6c75 6573 0a2a 2061 6370 693a 3a20 values.* acpi:: │ │ │ │ -00027120: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00027130: 2020 2020 2020 204c 6f61 6420 4143 5049 Load ACPI │ │ │ │ -00027140: 2074 6162 6c65 730a 2a20 6175 7468 656e tables.* authen │ │ │ │ -00027150: 7469 6361 7465 3a3a 2020 2020 2020 2020 ticate:: │ │ │ │ -00027160: 2020 2020 2020 2020 4368 6563 6b20 7768 Check wh │ │ │ │ -00027170: 6574 6865 7220 7573 6572 2069 7320 696e ether user is in │ │ │ │ -00027180: 2075 7365 7220 6c69 7374 0a2a 2062 6163 user list.* bac │ │ │ │ -00027190: 6b67 726f 756e 645f 636f 6c6f 723a 3a20 kground_color:: │ │ │ │ -000271a0: 2020 2020 2020 2020 2020 2053 6574 2062 Set b │ │ │ │ -000271b0: 6163 6b67 726f 756e 6420 636f 6c6f 7220 ackground color │ │ │ │ -000271c0: 666f 7220 6163 7469 7665 2074 6572 6d69 for active termi │ │ │ │ -000271d0: 6e61 6c0a 2a20 6261 636b 6772 6f75 6e64 nal.* background │ │ │ │ -000271e0: 5f69 6d61 6765 3a3a 2020 2020 2020 2020 _image:: │ │ │ │ -000271f0: 2020 2020 4c6f 6164 2062 6163 6b67 726f Load backgro │ │ │ │ -00027200: 756e 6420 696d 6167 6520 666f 7220 6163 und image for ac │ │ │ │ -00027210: 7469 7665 2074 6572 6d69 6e61 6c0a 2a20 tive terminal.* │ │ │ │ -00027220: 6261 6472 616d 3a3a 2020 2020 2020 2020 badram:: │ │ │ │ -00027230: 2020 2020 2020 2020 2020 2020 2020 4669 Fi │ │ │ │ -00027240: 6c74 6572 206f 7574 2062 6164 2072 6567 lter out bad reg │ │ │ │ -00027250: 696f 6e73 206f 6620 5241 4d0a 2a20 626c ions of RAM.* bl │ │ │ │ -00027260: 6f63 6b6c 6973 743a 3a20 2020 2020 2020 ocklist:: │ │ │ │ -00027270: 2020 2020 2020 2020 2020 2020 5072 696e Prin │ │ │ │ -00027280: 7420 6120 626c 6f63 6b20 6c69 7374 0a2a t a block list.* │ │ │ │ -00027290: 2062 6f6f 743a 3a20 2020 2020 2020 2020 boot:: │ │ │ │ -000272a0: 2020 2020 2020 2020 2020 2020 2020 2053 S │ │ │ │ -000272b0: 7461 7274 2075 7020 796f 7572 206f 7065 tart up your ope │ │ │ │ -000272c0: 7261 7469 6e67 2073 7973 7465 6d0a 2a20 rating system.* │ │ │ │ -000272d0: 6361 743a 3a20 2020 2020 2020 2020 2020 cat:: │ │ │ │ -000272e0: 2020 2020 2020 2020 2020 2020 2020 5368 Sh │ │ │ │ -000272f0: 6f77 2074 6865 2063 6f6e 7465 6e74 7320 ow the contents │ │ │ │ -00027300: 6f66 2061 2066 696c 650a 2a20 6368 6169 of a file.* chai │ │ │ │ -00027310: 6e6c 6f61 6465 723a 3a20 2020 2020 2020 nloader:: │ │ │ │ -00027320: 2020 2020 2020 2020 2020 4368 6169 6e2d Chain- │ │ │ │ -00027330: 6c6f 6164 2061 6e6f 7468 6572 2062 6f6f load another boo │ │ │ │ -00027340: 7420 6c6f 6164 6572 0a2a 2063 6c65 6172 t loader.* clear │ │ │ │ -00027350: 3a3a 2020 2020 2020 2020 2020 2020 2020 :: │ │ │ │ -00027360: 2020 2020 2020 2020 2043 6c65 6172 2074 Clear t │ │ │ │ -00027370: 6865 2073 6372 6565 6e0a 2a20 636d 6f73 he screen.* cmos │ │ │ │ -00027380: 636c 6561 6e3a 3a20 2020 2020 2020 2020 clean:: │ │ │ │ -00027390: 2020 2020 2020 2020 2020 436c 6561 7220 Clear │ │ │ │ -000273a0: 6269 7420 696e 2043 4d4f 530a 2a20 636d bit in CMOS.* cm │ │ │ │ -000273b0: 6f73 6475 6d70 3a3a 2020 2020 2020 2020 osdump:: │ │ │ │ -000273c0: 2020 2020 2020 2020 2020 2020 4475 6d70 Dump │ │ │ │ -000273d0: 2043 4d4f 5320 636f 6e74 656e 7473 0a2a CMOS contents.* │ │ │ │ -000273e0: 2063 6d6f 7374 6573 743a 3a20 2020 2020 cmostest:: │ │ │ │ -000273f0: 2020 2020 2020 2020 2020 2020 2020 2054 T │ │ │ │ -00027400: 6573 7420 6269 7420 696e 2043 4d4f 530a est bit in CMOS. │ │ │ │ -00027410: 2a20 636d 703a 3a20 2020 2020 2020 2020 * cmp:: │ │ │ │ +000270f0: 2020 2020 2020 2043 6865 636b 2066 696c Check fil │ │ │ │ +00027100: 6520 7479 7065 7320 616e 6420 636f 6d70 e types and comp │ │ │ │ +00027110: 6172 6520 7661 6c75 6573 0a2a 2061 6370 are values.* acp │ │ │ │ +00027120: 693a 3a20 2020 2020 2020 2020 2020 2020 i:: │ │ │ │ +00027130: 2020 2020 2020 2020 2020 204c 6f61 6420 Load │ │ │ │ +00027140: 4143 5049 2074 6162 6c65 730a 2a20 6175 ACPI tables.* au │ │ │ │ +00027150: 7468 656e 7469 6361 7465 3a3a 2020 2020 thenticate:: │ │ │ │ +00027160: 2020 2020 2020 2020 2020 2020 4368 6563 Chec │ │ │ │ +00027170: 6b20 7768 6574 6865 7220 7573 6572 2069 k whether user i │ │ │ │ +00027180: 7320 696e 2075 7365 7220 6c69 7374 0a2a s in user list.* │ │ │ │ +00027190: 2062 6163 6b67 726f 756e 645f 636f 6c6f background_colo │ │ │ │ +000271a0: 723a 3a20 2020 2020 2020 2020 2020 2053 r:: S │ │ │ │ +000271b0: 6574 2062 6163 6b67 726f 756e 6420 636f et background co │ │ │ │ +000271c0: 6c6f 7220 666f 7220 6163 7469 7665 2074 lor for active t │ │ │ │ +000271d0: 6572 6d69 6e61 6c0a 2a20 6261 636b 6772 erminal.* backgr │ │ │ │ +000271e0: 6f75 6e64 5f69 6d61 6765 3a3a 2020 2020 ound_image:: │ │ │ │ +000271f0: 2020 2020 2020 2020 4c6f 6164 2062 6163 Load bac │ │ │ │ +00027200: 6b67 726f 756e 6420 696d 6167 6520 666f kground image fo │ │ │ │ +00027210: 7220 6163 7469 7665 2074 6572 6d69 6e61 r active termina │ │ │ │ +00027220: 6c0a 2a20 6261 6472 616d 3a3a 2020 2020 l.* badram:: │ │ │ │ +00027230: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00027240: 2020 4669 6c74 6572 206f 7574 2062 6164 Filter out bad │ │ │ │ +00027250: 2072 6567 696f 6e73 206f 6620 5241 4d0a regions of RAM. │ │ │ │ +00027260: 2a20 626c 6f63 6b6c 6973 743a 3a20 2020 * blocklist:: │ │ │ │ +00027270: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00027280: 5072 696e 7420 6120 626c 6f63 6b20 6c69 Print a block li │ │ │ │ +00027290: 7374 0a2a 2062 6f6f 743a 3a20 2020 2020 st.* boot:: │ │ │ │ +000272a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +000272b0: 2020 2053 7461 7274 2075 7020 796f 7572 Start up your │ │ │ │ +000272c0: 206f 7065 7261 7469 6e67 2073 7973 7465 operating syste │ │ │ │ +000272d0: 6d0a 2a20 6361 743a 3a20 2020 2020 2020 m.* cat:: │ │ │ │ +000272e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +000272f0: 2020 5368 6f77 2074 6865 2063 6f6e 7465 Show the conte │ │ │ │ +00027300: 6e74 7320 6f66 2061 2066 696c 650a 2a20 nts of a file.* │ │ │ │ +00027310: 6368 6169 6e6c 6f61 6465 723a 3a20 2020 chainloader:: │ │ │ │ +00027320: 2020 2020 2020 2020 2020 2020 2020 4368 Ch │ │ │ │ +00027330: 6169 6e2d 6c6f 6164 2061 6e6f 7468 6572 ain-load another │ │ │ │ +00027340: 2062 6f6f 7420 6c6f 6164 6572 0a2a 2063 boot loader.* c │ │ │ │ +00027350: 6c65 6172 3a3a 2020 2020 2020 2020 2020 lear:: │ │ │ │ +00027360: 2020 2020 2020 2020 2020 2020 2043 6c65 Cle │ │ │ │ +00027370: 6172 2074 6865 2073 6372 6565 6e0a 2a20 ar the screen.* │ │ │ │ +00027380: 636d 6f73 636c 6561 6e3a 3a20 2020 2020 cmosclean:: │ │ │ │ +00027390: 2020 2020 2020 2020 2020 2020 2020 436c Cl │ │ │ │ +000273a0: 6561 7220 6269 7420 696e 2043 4d4f 530a ear bit in CMOS. │ │ │ │ +000273b0: 2a20 636d 6f73 6475 6d70 3a3a 2020 2020 * cmosdump:: │ │ │ │ +000273c0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +000273d0: 4475 6d70 2043 4d4f 5320 636f 6e74 656e Dump CMOS conten │ │ │ │ +000273e0: 7473 0a2a 2063 6d6f 7374 6573 743a 3a20 ts.* cmostest:: │ │ │ │ +000273f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00027400: 2020 2054 6573 7420 6269 7420 696e 2043 Test bit in C │ │ │ │ +00027410: 4d4f 530a 2a20 636d 703a 3a20 2020 2020 MOS.* cmp:: │ │ │ │ 00027420: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00027430: 436f 6d70 6172 6520 7477 6f20 6669 6c65 Compare two file │ │ │ │ -00027440: 730a 2a20 636f 6e66 6967 6669 6c65 3a3a s.* configfile:: │ │ │ │ -00027450: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00027460: 2020 4c6f 6164 2061 2063 6f6e 6669 6775 Load a configu │ │ │ │ -00027470: 7261 7469 6f6e 2066 696c 650a 2a20 6370 ration file.* cp │ │ │ │ -00027480: 7569 643a 3a20 2020 2020 2020 2020 2020 uid:: │ │ │ │ -00027490: 2020 2020 2020 2020 2020 2020 4368 6563 Chec │ │ │ │ -000274a0: 6b20 666f 7220 4350 5520 6665 6174 7572 k for CPU featur │ │ │ │ -000274b0: 6573 0a2a 2063 7263 3a3a 2020 2020 2020 es.* crc:: │ │ │ │ +00027430: 2020 2020 436f 6d70 6172 6520 7477 6f20 Compare two │ │ │ │ +00027440: 6669 6c65 730a 2a20 636f 6e66 6967 6669 files.* configfi │ │ │ │ +00027450: 6c65 3a3a 2020 2020 2020 2020 2020 2020 le:: │ │ │ │ +00027460: 2020 2020 2020 4c6f 6164 2061 2063 6f6e Load a con │ │ │ │ +00027470: 6669 6775 7261 7469 6f6e 2066 696c 650a figuration file. │ │ │ │ +00027480: 2a20 6370 7569 643a 3a20 2020 2020 2020 * cpuid:: │ │ │ │ +00027490: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +000274a0: 4368 6563 6b20 666f 7220 4350 5520 6665 Check for CPU fe │ │ │ │ +000274b0: 6174 7572 6573 0a2a 2063 7263 3a3a 2020 atures.* crc:: │ │ │ │ 000274c0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -000274d0: 2020 2043 6f6d 7075 7465 206f 7220 6368 Compute or ch │ │ │ │ -000274e0: 6563 6b20 4352 4333 3220 6368 6563 6b73 eck CRC32 checks │ │ │ │ -000274f0: 756d 730a 2a20 6372 7970 746f 6d6f 756e ums.* cryptomoun │ │ │ │ -00027500: 743a 3a20 2020 2020 2020 2020 2020 2020 t:: │ │ │ │ -00027510: 2020 2020 4d6f 756e 7420 6120 6372 7970 Mount a cryp │ │ │ │ -00027520: 746f 2064 6576 6963 650a 2a20 6375 746d to device.* cutm │ │ │ │ -00027530: 656d 3a3a 2020 2020 2020 2020 2020 2020 em:: │ │ │ │ -00027540: 2020 2020 2020 2020 2020 5265 6d6f 7665 Remove │ │ │ │ -00027550: 206d 656d 6f72 7920 7265 6769 6f6e 730a memory regions. │ │ │ │ -00027560: 2a20 6461 7465 3a3a 2020 2020 2020 2020 * date:: │ │ │ │ +000274d0: 2020 2020 2020 2043 6f6d 7075 7465 206f Compute o │ │ │ │ +000274e0: 7220 6368 6563 6b20 4352 4333 3220 6368 r check CRC32 ch │ │ │ │ +000274f0: 6563 6b73 756d 730a 2a20 6372 7970 746f ecksums.* crypto │ │ │ │ +00027500: 6d6f 756e 743a 3a20 2020 2020 2020 2020 mount:: │ │ │ │ +00027510: 2020 2020 2020 2020 4d6f 756e 7420 6120 Mount a │ │ │ │ +00027520: 6372 7970 746f 2064 6576 6963 650a 2a20 crypto device.* │ │ │ │ +00027530: 6375 746d 656d 3a3a 2020 2020 2020 2020 cutmem:: │ │ │ │ +00027540: 2020 2020 2020 2020 2020 2020 2020 5265 Re │ │ │ │ +00027550: 6d6f 7665 206d 656d 6f72 7920 7265 6769 move memory regi │ │ │ │ +00027560: 6f6e 730a 2a20 6461 7465 3a3a 2020 2020 ons.* date:: │ │ │ │ 00027570: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00027580: 4469 7370 6c61 7920 6f72 2073 6574 2063 Display or set c │ │ │ │ -00027590: 7572 7265 6e74 2064 6174 6520 616e 6420 urrent date and │ │ │ │ -000275a0: 7469 6d65 0a2a 2064 6576 6963 6574 7265 time.* devicetre │ │ │ │ -000275b0: 653a 3a20 2020 2020 2020 2020 2020 2020 e:: │ │ │ │ -000275c0: 2020 2020 204c 6f61 6420 6120 6465 7669 Load a devi │ │ │ │ -000275d0: 6365 2074 7265 6520 626c 6f62 0a2a 2064 ce tree blob.* d │ │ │ │ -000275e0: 6973 7472 7573 743a 3a20 2020 2020 2020 istrust:: │ │ │ │ -000275f0: 2020 2020 2020 2020 2020 2020 2052 656d Rem │ │ │ │ -00027600: 6f76 6520 6120 7075 626b 6579 2066 726f ove a pubkey fro │ │ │ │ -00027610: 6d20 7472 7573 7465 6420 6b65 7973 0a2a m trusted keys.* │ │ │ │ -00027620: 2064 7269 7665 6d61 703a 3a20 2020 2020 drivemap:: │ │ │ │ -00027630: 2020 2020 2020 2020 2020 2020 2020 204d M │ │ │ │ -00027640: 6170 2061 2064 7269 7665 2074 6f20 616e ap a drive to an │ │ │ │ -00027650: 6f74 6865 720a 2a20 6563 686f 3a3a 2020 other.* echo:: │ │ │ │ -00027660: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00027670: 2020 2020 2020 4469 7370 6c61 7920 6120 Display a │ │ │ │ -00027680: 6c69 6e65 206f 6620 7465 7874 0a2a 2065 line of text.* e │ │ │ │ -00027690: 7661 6c3a 3a20 2020 2020 2020 2020 2020 val:: │ │ │ │ -000276a0: 2020 2020 2020 2020 2020 2020 2045 7661 Eva │ │ │ │ -000276b0: 6c75 6174 6520 6167 7275 6d65 6e74 7320 luate agruments │ │ │ │ -000276c0: 6173 2047 5255 4220 636f 6d6d 616e 6473 as GRUB commands │ │ │ │ -000276d0: 0a2a 2065 7870 6f72 743a 3a20 2020 2020 .* export:: │ │ │ │ +00027580: 2020 2020 4469 7370 6c61 7920 6f72 2073 Display or s │ │ │ │ +00027590: 6574 2063 7572 7265 6e74 2064 6174 6520 et current date │ │ │ │ +000275a0: 616e 6420 7469 6d65 0a2a 2064 6576 6963 and time.* devic │ │ │ │ +000275b0: 6574 7265 653a 3a20 2020 2020 2020 2020 etree:: │ │ │ │ +000275c0: 2020 2020 2020 2020 204c 6f61 6420 6120 Load a │ │ │ │ +000275d0: 6465 7669 6365 2074 7265 6520 626c 6f62 device tree blob │ │ │ │ +000275e0: 0a2a 2064 6973 7472 7573 743a 3a20 2020 .* distrust:: │ │ │ │ +000275f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00027600: 2052 656d 6f76 6520 6120 7075 626b 6579 Remove a pubkey │ │ │ │ +00027610: 2066 726f 6d20 7472 7573 7465 6420 6b65 from trusted ke │ │ │ │ +00027620: 7973 0a2a 2064 7269 7665 6d61 703a 3a20 ys.* drivemap:: │ │ │ │ +00027630: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00027640: 2020 204d 6170 2061 2064 7269 7665 2074 Map a drive t │ │ │ │ +00027650: 6f20 616e 6f74 6865 720a 2a20 6563 686f o another.* echo │ │ │ │ +00027660: 3a3a 2020 2020 2020 2020 2020 2020 2020 :: │ │ │ │ +00027670: 2020 2020 2020 2020 2020 4469 7370 6c61 Displa │ │ │ │ +00027680: 7920 6120 6c69 6e65 206f 6620 7465 7874 y a line of text │ │ │ │ +00027690: 0a2a 2065 7661 6c3a 3a20 2020 2020 2020 .* eval:: │ │ │ │ +000276a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +000276b0: 2045 7661 6c75 6174 6520 6167 7275 6d65 Evaluate agrume │ │ │ │ +000276c0: 6e74 7320 6173 2047 5255 4220 636f 6d6d nts as GRUB comm │ │ │ │ +000276d0: 616e 6473 0a2a 2065 7870 6f72 743a 3a20 ands.* export:: │ │ │ │ 000276e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -000276f0: 2045 7870 6f72 7420 616e 2065 6e76 6972 Export an envir │ │ │ │ -00027700: 6f6e 6d65 6e74 2076 6172 6961 626c 650a onment variable. │ │ │ │ -00027710: 2a20 6661 6c73 653a 3a20 2020 2020 2020 * false:: │ │ │ │ +000276f0: 2020 2020 2045 7870 6f72 7420 616e 2065 Export an e │ │ │ │ +00027700: 6e76 6972 6f6e 6d65 6e74 2076 6172 6961 nvironment varia │ │ │ │ +00027710: 626c 650a 2a20 6661 6c73 653a 3a20 2020 ble.* false:: │ │ │ │ 00027720: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00027730: 446f 206e 6f74 6869 6e67 2c20 756e 7375 Do nothing, unsu │ │ │ │ -00027740: 6363 6573 7366 756c 6c79 0a2a 2067 6574 ccessfully.* get │ │ │ │ -00027750: 7465 7874 3a3a 2020 2020 2020 2020 2020 text:: │ │ │ │ -00027760: 2020 2020 2020 2020 2020 2054 7261 6e73 Trans │ │ │ │ -00027770: 6c61 7465 2061 2073 7472 696e 670a 2a20 late a string.* │ │ │ │ -00027780: 6770 7473 796e 633a 3a20 2020 2020 2020 gptsync:: │ │ │ │ -00027790: 2020 2020 2020 2020 2020 2020 2020 4669 Fi │ │ │ │ -000277a0: 6c6c 2061 6e20 4d42 5220 6261 7365 6420 ll an MBR based │ │ │ │ -000277b0: 6f6e 2047 5054 2065 6e74 7269 6573 0a2a on GPT entries.* │ │ │ │ -000277c0: 2068 616c 743a 3a20 2020 2020 2020 2020 halt:: │ │ │ │ -000277d0: 2020 2020 2020 2020 2020 2020 2020 2053 S │ │ │ │ -000277e0: 6875 7420 646f 776e 2079 6f75 7220 636f hut down your co │ │ │ │ -000277f0: 6d70 7574 6572 0a2a 2068 6173 6873 756d mputer.* hashsum │ │ │ │ -00027800: 3a3a 2020 2020 2020 2020 2020 2020 2020 :: │ │ │ │ -00027810: 2020 2020 2020 2043 6f6d 7075 7465 206f Compute o │ │ │ │ -00027820: 7220 6368 6563 6b20 6861 7368 2063 6865 r check hash che │ │ │ │ -00027830: 636b 7375 6d0a 2a20 6865 6c70 3a3a 2020 cksum.* help:: │ │ │ │ -00027840: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00027850: 2020 2020 2020 5368 6f77 2068 656c 7020 Show help │ │ │ │ -00027860: 6d65 7373 6167 6573 0a2a 2069 6e69 7472 messages.* initr │ │ │ │ -00027870: 643a 3a20 2020 2020 2020 2020 2020 2020 d:: │ │ │ │ -00027880: 2020 2020 2020 2020 204c 6f61 6420 6120 Load a │ │ │ │ -00027890: 4c69 6e75 7820 696e 6974 7264 0a2a 2069 Linux initrd.* i │ │ │ │ -000278a0: 6e69 7472 6431 363a 3a20 2020 2020 2020 nitrd16:: │ │ │ │ -000278b0: 2020 2020 2020 2020 2020 2020 204c 6f61 Loa │ │ │ │ -000278c0: 6420 6120 4c69 6e75 7820 696e 6974 7264 d a Linux initrd │ │ │ │ -000278d0: 2028 3136 2d62 6974 206d 6f64 6529 0a2a (16-bit mode).* │ │ │ │ -000278e0: 2069 6e73 6d6f 643a 3a20 2020 2020 2020 insmod:: │ │ │ │ -000278f0: 2020 2020 2020 2020 2020 2020 2020 2049 I │ │ │ │ -00027900: 6e73 6572 7420 6120 6d6f 6475 6c65 0a2a nsert a module.* │ │ │ │ -00027910: 206b 6579 7374 6174 7573 3a3a 2020 2020 keystatus:: │ │ │ │ -00027920: 2020 2020 2020 2020 2020 2020 2020 2043 C │ │ │ │ -00027930: 6865 636b 206b 6579 206d 6f64 6966 6965 heck key modifie │ │ │ │ -00027940: 7220 7374 6174 7573 0a2a 206c 696e 7578 r status.* linux │ │ │ │ -00027950: 3a3a 2020 2020 2020 2020 2020 2020 2020 :: │ │ │ │ -00027960: 2020 2020 2020 2020 204c 6f61 6420 6120 Load a │ │ │ │ -00027970: 4c69 6e75 7820 6b65 726e 656c 0a2a 206c Linux kernel.* l │ │ │ │ -00027980: 696e 7578 3136 3a3a 2020 2020 2020 2020 inux16:: │ │ │ │ -00027990: 2020 2020 2020 2020 2020 2020 204c 6f61 Loa │ │ │ │ -000279a0: 6420 6120 4c69 6e75 7820 6b65 726e 656c d a Linux kernel │ │ │ │ -000279b0: 2028 3136 2d62 6974 206d 6f64 6529 0a2a (16-bit mode).* │ │ │ │ -000279c0: 206c 6973 745f 656e 763a 3a20 2020 2020 list_env:: │ │ │ │ -000279d0: 2020 2020 2020 2020 2020 2020 2020 204c L │ │ │ │ -000279e0: 6973 7420 7661 7269 6162 6c65 7320 696e ist variables in │ │ │ │ -000279f0: 2065 6e76 6972 6f6e 6d65 6e74 2062 6c6f environment blo │ │ │ │ -00027a00: 636b 0a2a 206c 6973 745f 7472 7573 7465 ck.* list_truste │ │ │ │ -00027a10: 643a 3a20 2020 2020 2020 2020 2020 2020 d:: │ │ │ │ -00027a20: 2020 204c 6973 7420 7472 7573 7465 6420 List trusted │ │ │ │ -00027a30: 7075 626c 6963 206b 6579 730a 2a20 6c6f public keys.* lo │ │ │ │ -00027a40: 6164 5f65 6e76 3a3a 2020 2020 2020 2020 ad_env:: │ │ │ │ -00027a50: 2020 2020 2020 2020 2020 2020 4c6f 6164 Load │ │ │ │ -00027a60: 2076 6172 6961 626c 6573 2066 726f 6d20 variables from │ │ │ │ -00027a70: 656e 7669 726f 6e6d 656e 7420 626c 6f63 environment bloc │ │ │ │ -00027a80: 6b0a 2a20 6c6f 6164 666f 6e74 3a3a 2020 k.* loadfont:: │ │ │ │ -00027a90: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00027aa0: 2020 4c6f 6164 2066 6f6e 7420 6669 6c65 Load font file │ │ │ │ -00027ab0: 730a 2a20 6c6f 6f70 6261 636b 3a3a 2020 s.* loopback:: │ │ │ │ -00027ac0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00027ad0: 2020 4d61 6b65 2061 2064 6576 6963 6520 Make a device │ │ │ │ -00027ae0: 6672 6f6d 2061 2066 696c 6573 7973 7465 from a filesyste │ │ │ │ -00027af0: 6d20 696d 6167 650a 2a20 6c73 3a3a 2020 m image.* ls:: │ │ │ │ -00027b00: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00027b10: 2020 2020 2020 2020 4c69 7374 2064 6576 List dev │ │ │ │ -00027b20: 6963 6573 206f 7220 6669 6c65 730a 2a20 ices or files.* │ │ │ │ -00027b30: 6c73 666f 6e74 733a 3a20 2020 2020 2020 lsfonts:: │ │ │ │ -00027b40: 2020 2020 2020 2020 2020 2020 2020 4c69 Li │ │ │ │ -00027b50: 7374 206c 6f61 6465 6420 666f 6e74 730a st loaded fonts. │ │ │ │ -00027b60: 2a20 6c73 6d6f 643a 3a20 2020 2020 2020 * lsmod:: │ │ │ │ +00027730: 2020 2020 446f 206e 6f74 6869 6e67 2c20 Do nothing, │ │ │ │ +00027740: 756e 7375 6363 6573 7366 756c 6c79 0a2a unsuccessfully.* │ │ │ │ +00027750: 2067 6574 7465 7874 3a3a 2020 2020 2020 gettext:: │ │ │ │ +00027760: 2020 2020 2020 2020 2020 2020 2020 2054 T │ │ │ │ +00027770: 7261 6e73 6c61 7465 2061 2073 7472 696e ranslate a strin │ │ │ │ +00027780: 670a 2a20 6770 7473 796e 633a 3a20 2020 g.* gptsync:: │ │ │ │ +00027790: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +000277a0: 2020 4669 6c6c 2061 6e20 4d42 5220 6261 Fill an MBR ba │ │ │ │ +000277b0: 7365 6420 6f6e 2047 5054 2065 6e74 7269 sed on GPT entri │ │ │ │ +000277c0: 6573 0a2a 2068 616c 743a 3a20 2020 2020 es.* halt:: │ │ │ │ +000277d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +000277e0: 2020 2053 6875 7420 646f 776e 2079 6f75 Shut down you │ │ │ │ +000277f0: 7220 636f 6d70 7574 6572 0a2a 2068 6173 r computer.* has │ │ │ │ +00027800: 6873 756d 3a3a 2020 2020 2020 2020 2020 hsum:: │ │ │ │ +00027810: 2020 2020 2020 2020 2020 2043 6f6d 7075 Compu │ │ │ │ +00027820: 7465 206f 7220 6368 6563 6b20 6861 7368 te or check hash │ │ │ │ +00027830: 2063 6865 636b 7375 6d0a 2a20 6865 6c70 checksum.* help │ │ │ │ +00027840: 3a3a 2020 2020 2020 2020 2020 2020 2020 :: │ │ │ │ +00027850: 2020 2020 2020 2020 2020 5368 6f77 2068 Show h │ │ │ │ +00027860: 656c 7020 6d65 7373 6167 6573 0a2a 2069 elp messages.* i │ │ │ │ +00027870: 6e69 7472 643a 3a20 2020 2020 2020 2020 nitrd:: │ │ │ │ +00027880: 2020 2020 2020 2020 2020 2020 204c 6f61 Loa │ │ │ │ +00027890: 6420 6120 4c69 6e75 7820 696e 6974 7264 d a Linux initrd │ │ │ │ +000278a0: 0a2a 2069 6e69 7472 6431 363a 3a20 2020 .* initrd16:: │ │ │ │ +000278b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +000278c0: 204c 6f61 6420 6120 4c69 6e75 7820 696e Load a Linux in │ │ │ │ +000278d0: 6974 7264 2028 3136 2d62 6974 206d 6f64 itrd (16-bit mod │ │ │ │ +000278e0: 6529 0a2a 2069 6e73 6d6f 643a 3a20 2020 e).* insmod:: │ │ │ │ +000278f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00027900: 2020 2049 6e73 6572 7420 6120 6d6f 6475 Insert a modu │ │ │ │ +00027910: 6c65 0a2a 206b 6579 7374 6174 7573 3a3a le.* keystatus:: │ │ │ │ +00027920: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00027930: 2020 2043 6865 636b 206b 6579 206d 6f64 Check key mod │ │ │ │ +00027940: 6966 6965 7220 7374 6174 7573 0a2a 206c ifier status.* l │ │ │ │ +00027950: 696e 7578 3a3a 2020 2020 2020 2020 2020 inux:: │ │ │ │ +00027960: 2020 2020 2020 2020 2020 2020 204c 6f61 Loa │ │ │ │ +00027970: 6420 6120 4c69 6e75 7820 6b65 726e 656c d a Linux kernel │ │ │ │ +00027980: 0a2a 206c 696e 7578 3136 3a3a 2020 2020 .* linux16:: │ │ │ │ +00027990: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +000279a0: 204c 6f61 6420 6120 4c69 6e75 7820 6b65 Load a Linux ke │ │ │ │ +000279b0: 726e 656c 2028 3136 2d62 6974 206d 6f64 rnel (16-bit mod │ │ │ │ +000279c0: 6529 0a2a 206c 6973 745f 656e 763a 3a20 e).* list_env:: │ │ │ │ +000279d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +000279e0: 2020 204c 6973 7420 7661 7269 6162 6c65 List variable │ │ │ │ +000279f0: 7320 696e 2065 6e76 6972 6f6e 6d65 6e74 s in environment │ │ │ │ +00027a00: 2062 6c6f 636b 0a2a 206c 6973 745f 7472 block.* list_tr │ │ │ │ +00027a10: 7573 7465 643a 3a20 2020 2020 2020 2020 usted:: │ │ │ │ +00027a20: 2020 2020 2020 204c 6973 7420 7472 7573 List trus │ │ │ │ +00027a30: 7465 6420 7075 626c 6963 206b 6579 730a ted public keys. │ │ │ │ +00027a40: 2a20 6c6f 6164 5f65 6e76 3a3a 2020 2020 * load_env:: │ │ │ │ +00027a50: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00027a60: 4c6f 6164 2076 6172 6961 626c 6573 2066 Load variables f │ │ │ │ +00027a70: 726f 6d20 656e 7669 726f 6e6d 656e 7420 rom environment │ │ │ │ +00027a80: 626c 6f63 6b0a 2a20 6c6f 6164 666f 6e74 block.* loadfont │ │ │ │ +00027a90: 3a3a 2020 2020 2020 2020 2020 2020 2020 :: │ │ │ │ +00027aa0: 2020 2020 2020 4c6f 6164 2066 6f6e 7420 Load font │ │ │ │ +00027ab0: 6669 6c65 730a 2a20 6c6f 6f70 6261 636b files.* loopback │ │ │ │ +00027ac0: 3a3a 2020 2020 2020 2020 2020 2020 2020 :: │ │ │ │ +00027ad0: 2020 2020 2020 4d61 6b65 2061 2064 6576 Make a dev │ │ │ │ +00027ae0: 6963 6520 6672 6f6d 2061 2066 696c 6573 ice from a files │ │ │ │ +00027af0: 7973 7465 6d20 696d 6167 650a 2a20 6c73 ystem image.* ls │ │ │ │ +00027b00: 3a3a 2020 2020 2020 2020 2020 2020 2020 :: │ │ │ │ +00027b10: 2020 2020 2020 2020 2020 2020 4c69 7374 List │ │ │ │ +00027b20: 2064 6576 6963 6573 206f 7220 6669 6c65 devices or file │ │ │ │ +00027b30: 730a 2a20 6c73 666f 6e74 733a 3a20 2020 s.* lsfonts:: │ │ │ │ +00027b40: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00027b50: 2020 4c69 7374 206c 6f61 6465 6420 666f List loaded fo │ │ │ │ +00027b60: 6e74 730a 2a20 6c73 6d6f 643a 3a20 2020 nts.* lsmod:: │ │ │ │ 00027b70: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00027b80: 5368 6f77 206c 6f61 6465 6420 6d6f 6475 Show loaded modu │ │ │ │ -00027b90: 6c65 730a 2a20 6d64 3573 756d 3a3a 2020 les.* md5sum:: │ │ │ │ -00027ba0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00027bb0: 2020 2020 436f 6d70 7574 6520 6f72 2063 Compute or c │ │ │ │ -00027bc0: 6865 636b 204d 4435 2068 6173 680a 2a20 heck MD5 hash.* │ │ │ │ -00027bd0: 6d6f 6475 6c65 3a3a 2020 2020 2020 2020 module:: │ │ │ │ -00027be0: 2020 2020 2020 2020 2020 2020 2020 4c6f Lo │ │ │ │ -00027bf0: 6164 206d 6f64 756c 6520 666f 7220 6d75 ad module for mu │ │ │ │ -00027c00: 6c74 6962 6f6f 7420 6b65 726e 656c 0a2a ltiboot kernel.* │ │ │ │ -00027c10: 206d 756c 7469 626f 6f74 3a3a 2020 2020 multiboot:: │ │ │ │ -00027c20: 2020 2020 2020 2020 2020 2020 2020 204c L │ │ │ │ -00027c30: 6f61 6420 6d75 6c74 6962 6f6f 7420 636f oad multiboot co │ │ │ │ -00027c40: 6d70 6c69 616e 7420 6b65 726e 656c 0a2a mpliant kernel.* │ │ │ │ -00027c50: 206e 6174 6976 6564 6973 6b3a 3a20 2020 nativedisk:: │ │ │ │ -00027c60: 2020 2020 2020 2020 2020 2020 2020 2053 S │ │ │ │ -00027c70: 7769 7463 6820 746f 206e 6174 6976 6520 witch to native │ │ │ │ -00027c80: 6469 736b 2064 7269 7665 7273 0a2a 206e disk drivers.* n │ │ │ │ -00027c90: 6f72 6d61 6c3a 3a20 2020 2020 2020 2020 ormal:: │ │ │ │ -00027ca0: 2020 2020 2020 2020 2020 2020 2045 6e74 Ent │ │ │ │ -00027cb0: 6572 206e 6f72 6d61 6c20 6d6f 6465 0a2a er normal mode.* │ │ │ │ -00027cc0: 206e 6f72 6d61 6c5f 6578 6974 3a3a 2020 normal_exit:: │ │ │ │ -00027cd0: 2020 2020 2020 2020 2020 2020 2020 2045 E │ │ │ │ -00027ce0: 7869 7420 6672 6f6d 206e 6f72 6d61 6c20 xit from normal │ │ │ │ -00027cf0: 6d6f 6465 0a2a 2070 6172 7474 6f6f 6c3a mode.* parttool: │ │ │ │ -00027d00: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ -00027d10: 2020 2020 204d 6f64 6966 7920 7061 7274 Modify part │ │ │ │ -00027d20: 6974 696f 6e20 7461 626c 6520 656e 7472 ition table entr │ │ │ │ -00027d30: 6965 730a 2a20 7061 7373 776f 7264 3a3a ies.* password:: │ │ │ │ -00027d40: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00027d50: 2020 2020 5365 7420 6120 636c 6561 722d Set a clear- │ │ │ │ -00027d60: 7465 7874 2070 6173 7377 6f72 640a 2a20 text password.* │ │ │ │ -00027d70: 7061 7373 776f 7264 5f70 626b 6466 323a password_pbkdf2: │ │ │ │ -00027d80: 3a20 2020 2020 2020 2020 2020 2020 5365 : Se │ │ │ │ -00027d90: 7420 6120 6861 7368 6564 2070 6173 7377 t a hashed passw │ │ │ │ -00027da0: 6f72 640a 2a20 706c 6179 3a3a 2020 2020 ord.* play:: │ │ │ │ +00027b80: 2020 2020 5368 6f77 206c 6f61 6465 6420 Show loaded │ │ │ │ +00027b90: 6d6f 6475 6c65 730a 2a20 6d64 3573 756d modules.* md5sum │ │ │ │ +00027ba0: 3a3a 2020 2020 2020 2020 2020 2020 2020 :: │ │ │ │ +00027bb0: 2020 2020 2020 2020 436f 6d70 7574 6520 Compute │ │ │ │ +00027bc0: 6f72 2063 6865 636b 204d 4435 2068 6173 or check MD5 has │ │ │ │ +00027bd0: 680a 2a20 6d6f 6475 6c65 3a3a 2020 2020 h.* module:: │ │ │ │ +00027be0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00027bf0: 2020 4c6f 6164 206d 6f64 756c 6520 666f Load module fo │ │ │ │ +00027c00: 7220 6d75 6c74 6962 6f6f 7420 6b65 726e r multiboot kern │ │ │ │ +00027c10: 656c 0a2a 206d 756c 7469 626f 6f74 3a3a el.* multiboot:: │ │ │ │ +00027c20: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00027c30: 2020 204c 6f61 6420 6d75 6c74 6962 6f6f Load multiboo │ │ │ │ +00027c40: 7420 636f 6d70 6c69 616e 7420 6b65 726e t compliant kern │ │ │ │ +00027c50: 656c 0a2a 206e 6174 6976 6564 6973 6b3a el.* nativedisk: │ │ │ │ +00027c60: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ +00027c70: 2020 2053 7769 7463 6820 746f 206e 6174 Switch to nat │ │ │ │ +00027c80: 6976 6520 6469 736b 2064 7269 7665 7273 ive disk drivers │ │ │ │ +00027c90: 0a2a 206e 6f72 6d61 6c3a 3a20 2020 2020 .* normal:: │ │ │ │ +00027ca0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00027cb0: 2045 6e74 6572 206e 6f72 6d61 6c20 6d6f Enter normal mo │ │ │ │ +00027cc0: 6465 0a2a 206e 6f72 6d61 6c5f 6578 6974 de.* normal_exit │ │ │ │ +00027cd0: 3a3a 2020 2020 2020 2020 2020 2020 2020 :: │ │ │ │ +00027ce0: 2020 2045 7869 7420 6672 6f6d 206e 6f72 Exit from nor │ │ │ │ +00027cf0: 6d61 6c20 6d6f 6465 0a2a 2070 6172 7474 mal mode.* partt │ │ │ │ +00027d00: 6f6f 6c3a 3a20 2020 2020 2020 2020 2020 ool:: │ │ │ │ +00027d10: 2020 2020 2020 2020 204d 6f64 6966 7920 Modify │ │ │ │ +00027d20: 7061 7274 6974 696f 6e20 7461 626c 6520 partition table │ │ │ │ +00027d30: 656e 7472 6965 730a 2a20 7061 7373 776f entries.* passwo │ │ │ │ +00027d40: 7264 3a3a 2020 2020 2020 2020 2020 2020 rd:: │ │ │ │ +00027d50: 2020 2020 2020 2020 5365 7420 6120 636c Set a cl │ │ │ │ +00027d60: 6561 722d 7465 7874 2070 6173 7377 6f72 ear-text passwor │ │ │ │ +00027d70: 640a 2a20 7061 7373 776f 7264 5f70 626b d.* password_pbk │ │ │ │ +00027d80: 6466 323a 3a20 2020 2020 2020 2020 2020 df2:: │ │ │ │ +00027d90: 2020 5365 7420 6120 6861 7368 6564 2070 Set a hashed p │ │ │ │ +00027da0: 6173 7377 6f72 640a 2a20 706c 6179 3a3a assword.* play:: │ │ │ │ 00027db0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00027dc0: 2020 2020 506c 6179 2061 2074 756e 650a Play a tune. │ │ │ │ -00027dd0: 2a20 7072 6f62 653a 3a20 2020 2020 2020 * probe:: │ │ │ │ +00027dc0: 2020 2020 2020 2020 506c 6179 2061 2074 Play a t │ │ │ │ +00027dd0: 756e 650a 2a20 7072 6f62 653a 3a20 2020 une.* probe:: │ │ │ │ 00027de0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00027df0: 5265 7472 6965 7665 2064 6576 6963 6520 Retrieve device │ │ │ │ -00027e00: 696e 666f 0a2a 2070 7865 5f75 6e6c 6f61 info.* pxe_unloa │ │ │ │ -00027e10: 643a 3a20 2020 2020 2020 2020 2020 2020 d:: │ │ │ │ -00027e20: 2020 2020 2055 6e6c 6f61 6420 7468 6520 Unload the │ │ │ │ -00027e30: 5058 4520 656e 7669 726f 6e6d 656e 740a PXE environment. │ │ │ │ -00027e40: 2a20 7264 6d73 723a 3a20 2020 2020 2020 * rdmsr:: │ │ │ │ +00027df0: 2020 2020 5265 7472 6965 7665 2064 6576 Retrieve dev │ │ │ │ +00027e00: 6963 6520 696e 666f 0a2a 2070 7865 5f75 ice info.* pxe_u │ │ │ │ +00027e10: 6e6c 6f61 643a 3a20 2020 2020 2020 2020 nload:: │ │ │ │ +00027e20: 2020 2020 2020 2020 2055 6e6c 6f61 6420 Unload │ │ │ │ +00027e30: 7468 6520 5058 4520 656e 7669 726f 6e6d the PXE environm │ │ │ │ +00027e40: 656e 740a 2a20 7264 6d73 723a 3a20 2020 ent.* rdmsr:: │ │ │ │ 00027e50: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00027e60: 5265 6164 2076 616c 7565 7320 6672 6f6d Read values from │ │ │ │ -00027e70: 206d 6f64 656c 2d73 7065 6369 6669 6320 model-specific │ │ │ │ -00027e80: 7265 6769 7374 6572 730a 2a20 7265 6164 registers.* read │ │ │ │ -00027e90: 3a3a 2020 2020 2020 2020 2020 2020 2020 :: │ │ │ │ -00027ea0: 2020 2020 2020 2020 2020 5265 6164 2075 Read u │ │ │ │ -00027eb0: 7365 7220 696e 7075 740a 2a20 7265 626f ser input.* rebo │ │ │ │ -00027ec0: 6f74 3a3a 2020 2020 2020 2020 2020 2020 ot:: │ │ │ │ -00027ed0: 2020 2020 2020 2020 2020 5265 626f 6f74 Reboot │ │ │ │ -00027ee0: 2079 6f75 7220 636f 6d70 7574 6572 0a2a your computer.* │ │ │ │ -00027ef0: 2072 6567 6578 703a 3a20 2020 2020 2020 regexp:: │ │ │ │ -00027f00: 2020 2020 2020 2020 2020 2020 2020 2054 T │ │ │ │ -00027f10: 6573 7420 6966 2072 6567 756c 6172 2065 est if regular e │ │ │ │ -00027f20: 7870 7265 7373 696f 6e20 6d61 7463 6865 xpression matche │ │ │ │ -00027f30: 7320 7374 7269 6e67 0a2a 2072 6d6d 6f64 s string.* rmmod │ │ │ │ -00027f40: 3a3a 2020 2020 2020 2020 2020 2020 2020 :: │ │ │ │ -00027f50: 2020 2020 2020 2020 2052 656d 6f76 6520 Remove │ │ │ │ -00027f60: 6120 6d6f 6475 6c65 0a2a 2073 6176 655f a module.* save_ │ │ │ │ -00027f70: 656e 763a 3a20 2020 2020 2020 2020 2020 env:: │ │ │ │ -00027f80: 2020 2020 2020 2020 2053 6176 6520 7661 Save va │ │ │ │ -00027f90: 7269 6162 6c65 7320 746f 2065 6e76 6972 riables to envir │ │ │ │ -00027fa0: 6f6e 6d65 6e74 2062 6c6f 636b 0a2a 2073 onment block.* s │ │ │ │ -00027fb0: 6561 7263 683a 3a20 2020 2020 2020 2020 earch:: │ │ │ │ -00027fc0: 2020 2020 2020 2020 2020 2020 2053 6561 Sea │ │ │ │ -00027fd0: 7263 6820 6465 7669 6365 7320 6279 2066 rch devices by f │ │ │ │ -00027fe0: 696c 652c 206c 6162 656c 2c20 6f72 2055 ile, label, or U │ │ │ │ -00027ff0: 5549 440a 2a20 7365 6e64 6b65 793a 3a20 UID.* sendkey:: │ │ │ │ -00028000: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00028010: 2020 2020 456d 756c 6174 6520 6b65 7973 Emulate keys │ │ │ │ -00028020: 7472 6f6b 6573 0a2a 2073 6574 3a3a 2020 trokes.* set:: │ │ │ │ -00028030: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00028040: 2020 2020 2020 2053 6574 2061 6e20 656e Set an en │ │ │ │ -00028050: 7669 726f 6e6d 656e 7420 7661 7269 6162 vironment variab │ │ │ │ -00028060: 6c65 0a2a 2073 6861 3173 756d 3a3a 2020 le.* sha1sum:: │ │ │ │ -00028070: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00028080: 2020 2043 6f6d 7075 7465 206f 7220 6368 Compute or ch │ │ │ │ -00028090: 6563 6b20 5348 4131 2068 6173 680a 2a20 eck SHA1 hash.* │ │ │ │ -000280a0: 7368 6132 3536 7375 6d3a 3a20 2020 2020 sha256sum:: │ │ │ │ -000280b0: 2020 2020 2020 2020 2020 2020 2020 436f Co │ │ │ │ -000280c0: 6d70 7574 6520 6f72 2063 6865 636b 2053 mpute or check S │ │ │ │ -000280d0: 4841 3235 3620 6861 7368 0a2a 2073 6861 HA256 hash.* sha │ │ │ │ -000280e0: 3531 3273 756d 3a3a 2020 2020 2020 2020 512sum:: │ │ │ │ -000280f0: 2020 2020 2020 2020 2020 2043 6f6d 7075 Compu │ │ │ │ -00028100: 7465 206f 7220 6368 6563 6b20 5348 4135 te or check SHA5 │ │ │ │ -00028110: 3132 2068 6173 680a 2a20 736c 6565 703a 12 hash.* sleep: │ │ │ │ -00028120: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ -00028130: 2020 2020 2020 2020 5761 6974 2066 6f72 Wait for │ │ │ │ -00028140: 2061 2073 7065 6369 6669 6564 206e 756d a specified num │ │ │ │ -00028150: 6265 7220 6f66 2073 6563 6f6e 6473 0a2a ber of seconds.* │ │ │ │ -00028160: 2073 6f75 7263 653a 3a20 2020 2020 2020 source:: │ │ │ │ -00028170: 2020 2020 2020 2020 2020 2020 2020 2052 R │ │ │ │ -00028180: 6561 6420 6120 636f 6e66 6967 7572 6174 ead a configurat │ │ │ │ -00028190: 696f 6e20 6669 6c65 2069 6e20 7361 6d65 ion file in same │ │ │ │ -000281a0: 2063 6f6e 7465 7874 0a2a 2074 6573 743a context.* test: │ │ │ │ -000281b0: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ -000281c0: 2020 2020 2020 2020 2043 6865 636b 2066 Check f │ │ │ │ -000281d0: 696c 6520 7479 7065 7320 616e 6420 636f ile types and co │ │ │ │ -000281e0: 6d70 6172 6520 7661 6c75 6573 0a2a 2074 mpare values.* t │ │ │ │ -000281f0: 7275 653a 3a20 2020 2020 2020 2020 2020 rue:: │ │ │ │ -00028200: 2020 2020 2020 2020 2020 2020 2044 6f20 Do │ │ │ │ -00028210: 6e6f 7468 696e 672c 2073 7563 6365 7373 nothing, success │ │ │ │ -00028220: 6675 6c6c 790a 2a20 7472 7573 743a 3a20 fully.* trust:: │ │ │ │ -00028230: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00028240: 2020 2020 2020 4164 6420 7075 626c 6963 Add public │ │ │ │ -00028250: 206b 6579 2074 6f20 6c69 7374 206f 6620 key to list of │ │ │ │ -00028260: 7472 7573 7465 6420 6b65 7973 0a2a 2075 trusted keys.* u │ │ │ │ -00028270: 6e73 6574 3a3a 2020 2020 2020 2020 2020 nset:: │ │ │ │ -00028280: 2020 2020 2020 2020 2020 2020 2055 6e73 Uns │ │ │ │ -00028290: 6574 2061 6e20 656e 7669 726f 6e6d 656e et an environmen │ │ │ │ -000282a0: 7420 7661 7269 6162 6c65 0a2a 2075 7070 t variable.* upp │ │ │ │ -000282b0: 6572 6d65 6d3a 3a20 2020 2020 2020 2020 ermem:: │ │ │ │ -000282c0: 2020 2020 2020 2020 2020 2053 6574 2074 Set t │ │ │ │ -000282d0: 6865 2075 7070 6572 206d 656d 6f72 7920 he upper memory │ │ │ │ -000282e0: 7369 7a65 0a2a 2076 6572 6966 795f 6465 size.* verify_de │ │ │ │ -000282f0: 7461 6368 6564 3a3a 2020 2020 2020 2020 tached:: │ │ │ │ -00028300: 2020 2020 2056 6572 6966 7920 6465 7461 Verify deta │ │ │ │ -00028310: 6368 6564 2064 6967 6974 616c 2073 6967 ched digital sig │ │ │ │ -00028320: 6e61 7475 7265 0a2a 2076 6964 656f 696e nature.* videoin │ │ │ │ -00028330: 666f 3a3a 2020 2020 2020 2020 2020 2020 fo:: │ │ │ │ -00028340: 2020 2020 2020 204c 6973 7420 6176 6169 List avai │ │ │ │ -00028350: 6c61 626c 6520 7669 6465 6f20 6d6f 6465 lable video mode │ │ │ │ -00028360: 730a 2a20 7772 6d73 723a 3a20 2020 2020 s.* wrmsr:: │ │ │ │ +00027e60: 2020 2020 5265 6164 2076 616c 7565 7320 Read values │ │ │ │ +00027e70: 6672 6f6d 206d 6f64 656c 2d73 7065 6369 from model-speci │ │ │ │ +00027e80: 6669 6320 7265 6769 7374 6572 730a 2a20 fic registers.* │ │ │ │ +00027e90: 7265 6164 3a3a 2020 2020 2020 2020 2020 read:: │ │ │ │ +00027ea0: 2020 2020 2020 2020 2020 2020 2020 5265 Re │ │ │ │ +00027eb0: 6164 2075 7365 7220 696e 7075 740a 2a20 ad user input.* │ │ │ │ +00027ec0: 7265 626f 6f74 3a3a 2020 2020 2020 2020 reboot:: │ │ │ │ +00027ed0: 2020 2020 2020 2020 2020 2020 2020 5265 Re │ │ │ │ +00027ee0: 626f 6f74 2079 6f75 7220 636f 6d70 7574 boot your comput │ │ │ │ +00027ef0: 6572 0a2a 2072 6567 6578 703a 3a20 2020 er.* regexp:: │ │ │ │ +00027f00: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00027f10: 2020 2054 6573 7420 6966 2072 6567 756c Test if regul │ │ │ │ +00027f20: 6172 2065 7870 7265 7373 696f 6e20 6d61 ar expression ma │ │ │ │ +00027f30: 7463 6865 7320 7374 7269 6e67 0a2a 2072 tches string.* r │ │ │ │ +00027f40: 6d6d 6f64 3a3a 2020 2020 2020 2020 2020 mmod:: │ │ │ │ +00027f50: 2020 2020 2020 2020 2020 2020 2052 656d Rem │ │ │ │ +00027f60: 6f76 6520 6120 6d6f 6475 6c65 0a2a 2073 ove a module.* s │ │ │ │ +00027f70: 6176 655f 656e 763a 3a20 2020 2020 2020 ave_env:: │ │ │ │ +00027f80: 2020 2020 2020 2020 2020 2020 2053 6176 Sav │ │ │ │ +00027f90: 6520 7661 7269 6162 6c65 7320 746f 2065 e variables to e │ │ │ │ +00027fa0: 6e76 6972 6f6e 6d65 6e74 2062 6c6f 636b nvironment block │ │ │ │ +00027fb0: 0a2a 2073 6561 7263 683a 3a20 2020 2020 .* search:: │ │ │ │ +00027fc0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00027fd0: 2053 6561 7263 6820 6465 7669 6365 7320 Search devices │ │ │ │ +00027fe0: 6279 2066 696c 652c 206c 6162 656c 2c20 by file, label, │ │ │ │ +00027ff0: 6f72 2055 5549 440a 2a20 7365 6e64 6b65 or UUID.* sendke │ │ │ │ +00028000: 793a 3a20 2020 2020 2020 2020 2020 2020 y:: │ │ │ │ +00028010: 2020 2020 2020 2020 456d 756c 6174 6520 Emulate │ │ │ │ +00028020: 6b65 7973 7472 6f6b 6573 0a2a 2073 6574 keystrokes.* set │ │ │ │ +00028030: 3a3a 2020 2020 2020 2020 2020 2020 2020 :: │ │ │ │ +00028040: 2020 2020 2020 2020 2020 2053 6574 2061 Set a │ │ │ │ +00028050: 6e20 656e 7669 726f 6e6d 656e 7420 7661 n environment va │ │ │ │ +00028060: 7269 6162 6c65 0a2a 2073 6861 3173 756d riable.* sha1sum │ │ │ │ +00028070: 3a3a 2020 2020 2020 2020 2020 2020 2020 :: │ │ │ │ +00028080: 2020 2020 2020 2043 6f6d 7075 7465 206f Compute o │ │ │ │ +00028090: 7220 6368 6563 6b20 5348 4131 2068 6173 r check SHA1 has │ │ │ │ +000280a0: 680a 2a20 7368 6132 3536 7375 6d3a 3a20 h.* sha256sum:: │ │ │ │ +000280b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +000280c0: 2020 436f 6d70 7574 6520 6f72 2063 6865 Compute or che │ │ │ │ +000280d0: 636b 2053 4841 3235 3620 6861 7368 0a2a ck SHA256 hash.* │ │ │ │ +000280e0: 2073 6861 3531 3273 756d 3a3a 2020 2020 sha512sum:: │ │ │ │ +000280f0: 2020 2020 2020 2020 2020 2020 2020 2043 C │ │ │ │ +00028100: 6f6d 7075 7465 206f 7220 6368 6563 6b20 ompute or check │ │ │ │ +00028110: 5348 4135 3132 2068 6173 680a 2a20 736c SHA512 hash.* sl │ │ │ │ +00028120: 6565 703a 3a20 2020 2020 2020 2020 2020 eep:: │ │ │ │ +00028130: 2020 2020 2020 2020 2020 2020 5761 6974 Wait │ │ │ │ +00028140: 2066 6f72 2061 2073 7065 6369 6669 6564 for a specified │ │ │ │ +00028150: 206e 756d 6265 7220 6f66 2073 6563 6f6e number of secon │ │ │ │ +00028160: 6473 0a2a 2073 6f75 7263 653a 3a20 2020 ds.* source:: │ │ │ │ +00028170: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00028180: 2020 2052 6561 6420 6120 636f 6e66 6967 Read a config │ │ │ │ +00028190: 7572 6174 696f 6e20 6669 6c65 2069 6e20 uration file in │ │ │ │ +000281a0: 7361 6d65 2063 6f6e 7465 7874 0a2a 2074 same context.* t │ │ │ │ +000281b0: 6573 743a 3a20 2020 2020 2020 2020 2020 est:: │ │ │ │ +000281c0: 2020 2020 2020 2020 2020 2020 2043 6865 Che │ │ │ │ +000281d0: 636b 2066 696c 6520 7479 7065 7320 616e ck file types an │ │ │ │ +000281e0: 6420 636f 6d70 6172 6520 7661 6c75 6573 d compare values │ │ │ │ +000281f0: 0a2a 2074 7275 653a 3a20 2020 2020 2020 .* true:: │ │ │ │ +00028200: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00028210: 2044 6f20 6e6f 7468 696e 672c 2073 7563 Do nothing, suc │ │ │ │ +00028220: 6365 7373 6675 6c6c 790a 2a20 7472 7573 cessfully.* trus │ │ │ │ +00028230: 743a 3a20 2020 2020 2020 2020 2020 2020 t:: │ │ │ │ +00028240: 2020 2020 2020 2020 2020 4164 6420 7075 Add pu │ │ │ │ +00028250: 626c 6963 206b 6579 2074 6f20 6c69 7374 blic key to list │ │ │ │ +00028260: 206f 6620 7472 7573 7465 6420 6b65 7973 of trusted keys │ │ │ │ +00028270: 0a2a 2075 6e73 6574 3a3a 2020 2020 2020 .* unset:: │ │ │ │ +00028280: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00028290: 2055 6e73 6574 2061 6e20 656e 7669 726f Unset an enviro │ │ │ │ +000282a0: 6e6d 656e 7420 7661 7269 6162 6c65 0a2a nment variable.* │ │ │ │ +000282b0: 2075 7070 6572 6d65 6d3a 3a20 2020 2020 uppermem:: │ │ │ │ +000282c0: 2020 2020 2020 2020 2020 2020 2020 2053 S │ │ │ │ +000282d0: 6574 2074 6865 2075 7070 6572 206d 656d et the upper mem │ │ │ │ +000282e0: 6f72 7920 7369 7a65 0a2a 2076 6572 6966 ory size.* verif │ │ │ │ +000282f0: 795f 6465 7461 6368 6564 3a3a 2020 2020 y_detached:: │ │ │ │ +00028300: 2020 2020 2020 2020 2056 6572 6966 7920 Verify │ │ │ │ +00028310: 6465 7461 6368 6564 2064 6967 6974 616c detached digital │ │ │ │ +00028320: 2073 6967 6e61 7475 7265 0a2a 2076 6964 signature.* vid │ │ │ │ +00028330: 656f 696e 666f 3a3a 2020 2020 2020 2020 eoinfo:: │ │ │ │ +00028340: 2020 2020 2020 2020 2020 204c 6973 7420 List │ │ │ │ +00028350: 6176 6169 6c61 626c 6520 7669 6465 6f20 available video │ │ │ │ +00028360: 6d6f 6465 730a 2a20 7772 6d73 723a 3a20 modes.* wrmsr:: │ │ │ │ 00028370: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00028380: 2020 5772 6974 6520 7661 6c75 6573 2074 Write values t │ │ │ │ -00028390: 6f20 6d6f 6465 6c2d 7370 6563 6966 6963 o model-specific │ │ │ │ -000283a0: 2072 6567 6973 7465 7273 0a2a 2078 656e registers.* xen │ │ │ │ -000283b0: 5f68 7970 6572 7669 736f 723a 3a20 2020 _hypervisor:: │ │ │ │ -000283c0: 2020 2020 2020 2020 2020 204c 6f61 6420 Load │ │ │ │ -000283d0: 7865 6e20 6879 7065 7276 6973 6f72 2062 xen hypervisor b │ │ │ │ -000283e0: 696e 6172 7920 286f 6e6c 7920 6f6e 2041 inary (only on A │ │ │ │ -000283f0: 4172 6368 3634 290a 2a20 7865 6e5f 6d6f Arch64).* xen_mo │ │ │ │ -00028400: 6475 6c65 3a3a 2020 2020 2020 2020 2020 dule:: │ │ │ │ -00028410: 2020 2020 2020 2020 4c6f 6164 2078 656e Load xen │ │ │ │ -00028420: 206d 6f64 756c 6573 2066 6f72 2078 656e modules for xen │ │ │ │ -00028430: 2068 7970 6572 7669 736f 7220 286f 6e6c hypervisor (onl │ │ │ │ -00028440: 7920 6f6e 2041 4172 6368 3634 290a 0a1f y on AArch64)... │ │ │ │ -00028450: 0a46 696c 653a 2067 7275 622e 696e 666f .File: grub.info │ │ │ │ -00028460: 2c20 204e 6f64 653a 205b 2c20 204e 6578 , Node: [, Nex │ │ │ │ -00028470: 743a 2061 6370 692c 2020 5570 3a20 436f t: acpi, Up: Co │ │ │ │ -00028480: 6d6d 616e 642d 6c69 6e65 2061 6e64 206d mmand-line and m │ │ │ │ -00028490: 656e 7520 656e 7472 7920 636f 6d6d 616e enu entry comman │ │ │ │ -000284a0: 6473 0a0a 3136 2e33 2e31 205b 0a2d 2d2d ds..16.3.1 [.--- │ │ │ │ -000284b0: 2d2d 2d2d 2d0a 0a20 2d2d 2043 6f6d 6d61 -----.. -- Comma │ │ │ │ -000284c0: 6e64 3a20 275b 2720 6578 7072 6573 7369 nd: '[' expressi │ │ │ │ -000284d0: 6f6e 2027 5d27 0a20 2020 2020 416c 6961 on ']'. Alia │ │ │ │ -000284e0: 7320 666f 7220 2774 6573 7420 4558 5052 s for 'test EXPR │ │ │ │ -000284f0: 4553 5349 4f4e 2720 282a 6e6f 7465 2074 ESSION' (*note t │ │ │ │ -00028500: 6573 743a 3a29 2e0a 0a1f 0a46 696c 653a est::).....File: │ │ │ │ -00028510: 2067 7275 622e 696e 666f 2c20 204e 6f64 grub.info, Nod │ │ │ │ -00028520: 653a 2061 6370 692c 2020 4e65 7874 3a20 e: acpi, Next: │ │ │ │ -00028530: 6175 7468 656e 7469 6361 7465 2c20 2050 authenticate, P │ │ │ │ -00028540: 7265 763a 205b 2c20 2055 703a 2043 6f6d rev: [, Up: Com │ │ │ │ -00028550: 6d61 6e64 2d6c 696e 6520 616e 6420 6d65 mand-line and me │ │ │ │ -00028560: 6e75 2065 6e74 7279 2063 6f6d 6d61 6e64 nu entry command │ │ │ │ -00028570: 730a 0a31 362e 332e 3220 6163 7069 0a2d s..16.3.2 acpi.- │ │ │ │ -00028580: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 ----------.. -- │ │ │ │ -00028590: 436f 6d6d 616e 643a 2061 6370 6920 5b27 Command: acpi [' │ │ │ │ -000285a0: 2d31 277c 272d 3227 5d0a 2020 2020 2020 -1'|'-2']. │ │ │ │ -000285b0: 2020 2020 5b27 2d2d 6578 636c 7564 653d ['--exclude= │ │ │ │ -000285c0: 7461 626c 6531 2c2e 2e2e 277c 272d 2d6c table1,...'|'--l │ │ │ │ -000285d0: 6f61 642d 6f6e 6c79 3d74 6162 6c65 312c oad-only=table1, │ │ │ │ -000285e0: 2e2e 2e27 5d0a 2020 2020 2020 2020 2020 ...']. │ │ │ │ -000285f0: 5b27 2d2d 6f65 6d69 643d 6964 275d 205b ['--oemid=id'] [ │ │ │ │ -00028600: 272d 2d6f 656d 7461 626c 653d 7461 626c '--oemtable=tabl │ │ │ │ -00028610: 6527 5d20 5b27 2d2d 6f65 6d74 6162 6c65 e'] ['--oemtable │ │ │ │ -00028620: 7265 763d 7265 7627 5d0a 2020 2020 2020 rev=rev']. │ │ │ │ -00028630: 2020 2020 5b27 2d2d 6f65 6d74 6162 6c65 ['--oemtable │ │ │ │ -00028640: 6372 6561 746f 723d 6372 6561 746f 7227 creator=creator' │ │ │ │ -00028650: 5d20 5b27 2d2d 6f65 6d74 6162 6c65 6372 ] ['--oemtablecr │ │ │ │ -00028660: 6561 746f 7272 6576 3d72 6576 275d 0a20 eatorrev=rev']. │ │ │ │ -00028670: 2020 2020 2020 2020 205b 272d 2d6e 6f2d ['--no- │ │ │ │ -00028680: 6562 6461 275d 2066 696c 656e 616d 6520 ebda'] filename │ │ │ │ -00028690: 2e2e 2e0a 2020 2020 204d 6f64 6572 6e20 .... Modern │ │ │ │ -000286a0: 4249 4f53 2073 7973 7465 6d73 206e 6f72 BIOS systems nor │ │ │ │ -000286b0: 6d61 6c6c 7920 696d 706c 656d 656e 7420 mally implement │ │ │ │ -000286c0: 7468 6520 4164 7661 6e63 6564 2043 6f6e the Advanced Con │ │ │ │ -000286d0: 6669 6775 7261 7469 6f6e 0a20 2020 2020 figuration. │ │ │ │ -000286e0: 616e 6420 506f 7765 7220 496e 7465 7266 and Power Interf │ │ │ │ -000286f0: 6163 6520 2841 4350 4929 2c20 616e 6420 ace (ACPI), and │ │ │ │ -00028700: 6465 6669 6e65 2076 6172 696f 7573 2074 define various t │ │ │ │ -00028710: 6162 6c65 7320 7468 6174 2064 6573 6372 ables that descr │ │ │ │ -00028720: 6962 650a 2020 2020 2074 6865 2069 6e74 ibe. the int │ │ │ │ -00028730: 6572 6661 6365 2062 6574 7765 656e 2061 erface between a │ │ │ │ -00028740: 6e20 4143 5049 2d63 6f6d 706c 6961 6e74 n ACPI-compliant │ │ │ │ -00028750: 206f 7065 7261 7469 6e67 2073 7973 7465 operating syste │ │ │ │ -00028760: 6d20 616e 6420 7468 650a 2020 2020 2066 m and the. f │ │ │ │ -00028770: 6972 6d77 6172 652e 2020 496e 2073 6f6d irmware. In som │ │ │ │ -00028780: 6520 6361 7365 732c 2074 6865 2074 6162 e cases, the tab │ │ │ │ -00028790: 6c65 7320 7072 6f76 6964 6564 2062 7920 les provided by │ │ │ │ -000287a0: 6465 6661 756c 7420 6f6e 6c79 2077 6f72 default only wor │ │ │ │ -000287b0: 6b0a 2020 2020 2077 656c 6c20 7769 7468 k. well with │ │ │ │ -000287c0: 2063 6572 7461 696e 206f 7065 7261 7469 certain operati │ │ │ │ -000287d0: 6e67 2073 7973 7465 6d73 2c20 616e 6420 ng systems, and │ │ │ │ -000287e0: 6974 206d 6179 2062 6520 6e65 6365 7373 it may be necess │ │ │ │ -000287f0: 6172 7920 746f 0a20 2020 2020 7265 706c ary to. repl │ │ │ │ -00028800: 6163 6520 736f 6d65 206f 6620 7468 656d ace some of them │ │ │ │ -00028810: 2e0a 0a20 2020 2020 4e6f 726d 616c 6c79 ... Normally │ │ │ │ -00028820: 2c20 7468 6973 2063 6f6d 6d61 6e64 2077 , this command w │ │ │ │ -00028830: 696c 6c20 7265 706c 6163 6520 7468 6520 ill replace the │ │ │ │ -00028840: 526f 6f74 2053 7973 7465 6d20 4465 7363 Root System Desc │ │ │ │ -00028850: 7269 7074 696f 6e0a 2020 2020 2050 6f69 ription. Poi │ │ │ │ -00028860: 6e74 6572 2028 5253 4450 2920 696e 2074 nter (RSDP) in t │ │ │ │ -00028870: 6865 2045 7874 656e 6465 6420 4249 4f53 he Extended BIOS │ │ │ │ -00028880: 2044 6174 6120 4172 6561 2074 6f20 706f Data Area to po │ │ │ │ -00028890: 696e 7420 746f 2074 6865 206e 6577 0a20 int to the new. │ │ │ │ -000288a0: 2020 2020 7461 626c 6573 2e20 2049 6620 tables. If │ │ │ │ -000288b0: 7468 6520 272d 2d6e 6f2d 6562 6461 2720 the '--no-ebda' │ │ │ │ -000288c0: 6f70 7469 6f6e 2069 7320 7573 6564 2c20 option is used, │ │ │ │ -000288d0: 7468 6520 6e65 7720 7461 626c 6573 2077 the new tables w │ │ │ │ -000288e0: 696c 6c20 6265 0a20 2020 2020 6b6e 6f77 ill be. know │ │ │ │ -000288f0: 6e20 6f6e 6c79 2074 6f20 4752 5542 2c20 n only to GRUB, │ │ │ │ -00028900: 6275 7420 6d61 7920 6265 2075 7365 6420 but may be used │ │ │ │ -00028910: 6279 2047 5255 4227 7320 4546 4920 656d by GRUB's EFI em │ │ │ │ -00028920: 756c 6174 696f 6e2e 0a0a 2020 2020 204e ulation... N │ │ │ │ -00028930: 6f74 653a 2054 6865 2063 6f6d 6d61 6e64 ote: The command │ │ │ │ -00028940: 2069 7320 6e6f 7420 616c 6c6f 7765 6420 is not allowed │ │ │ │ -00028950: 7768 656e 206c 6f63 6b64 6f77 6e20 6973 when lockdown is │ │ │ │ -00028960: 2065 6e66 6f72 6365 6420 282a 6e6f 7465 enforced (*note │ │ │ │ -00028970: 0a20 2020 2020 4c6f 636b 646f 776e 3a3a . Lockdown:: │ │ │ │ -00028980: 292e 2020 4f74 6865 7277 6973 6520 616e ). Otherwise an │ │ │ │ -00028990: 2061 7474 6163 6b65 7220 6361 6e20 696e attacker can in │ │ │ │ -000289a0: 7374 7275 6374 2074 6865 2047 5255 4220 struct the GRUB │ │ │ │ -000289b0: 746f 206c 6f61 640a 2020 2020 2061 6e20 to load. an │ │ │ │ -000289c0: 5353 4454 2074 6162 6c65 2074 6f20 6f76 SSDT table to ov │ │ │ │ -000289d0: 6572 7772 6974 6520 7468 6520 6b65 726e erwrite the kern │ │ │ │ -000289e0: 656c 206c 6f63 6b64 6f77 6e20 636f 6e66 el lockdown conf │ │ │ │ -000289f0: 6967 7572 6174 696f 6e20 616e 640a 2020 iguration and. │ │ │ │ -00028a00: 2020 206c 6174 6572 206c 6f61 6420 616e later load an │ │ │ │ -00028a10: 6420 6578 6563 7574 6520 756e 7369 676e d execute unsign │ │ │ │ -00028a20: 6564 2063 6f64 652e 0a0a 1f0a 4669 6c65 ed code.....File │ │ │ │ -00028a30: 3a20 6772 7562 2e69 6e66 6f2c 2020 4e6f : grub.info, No │ │ │ │ -00028a40: 6465 3a20 6175 7468 656e 7469 6361 7465 de: authenticate │ │ │ │ -00028a50: 2c20 204e 6578 743a 2062 6163 6b67 726f , Next: backgro │ │ │ │ -00028a60: 756e 645f 636f 6c6f 722c 2020 5072 6576 und_color, Prev │ │ │ │ -00028a70: 3a20 6163 7069 2c20 2055 703a 2043 6f6d : acpi, Up: Com │ │ │ │ -00028a80: 6d61 6e64 2d6c 696e 6520 616e 6420 6d65 mand-line and me │ │ │ │ -00028a90: 6e75 2065 6e74 7279 2063 6f6d 6d61 6e64 nu entry command │ │ │ │ -00028aa0: 730a 0a31 362e 332e 3320 6175 7468 656e s..16.3.3 authen │ │ │ │ -00028ab0: 7469 6361 7465 0a2d 2d2d 2d2d 2d2d 2d2d ticate.--------- │ │ │ │ -00028ac0: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 ----------.. -- │ │ │ │ -00028ad0: 436f 6d6d 616e 643a 2061 7574 6865 6e74 Command: authent │ │ │ │ -00028ae0: 6963 6174 6520 5b75 7365 726c 6973 745d icate [userlist] │ │ │ │ -00028af0: 0a20 2020 2020 4368 6563 6b20 7768 6574 . Check whet │ │ │ │ -00028b00: 6865 7220 7573 6572 2069 7320 696e 2055 her user is in U │ │ │ │ -00028b10: 5345 524c 4953 5420 6f72 206c 6973 7465 SERLIST or liste │ │ │ │ -00028b20: 6420 696e 2074 6865 2076 616c 7565 206f d in the value o │ │ │ │ -00028b30: 660a 2020 2020 2076 6172 6961 626c 6520 f. variable │ │ │ │ -00028b40: 2773 7570 6572 7573 6572 7327 2e20 2053 'superusers'. S │ │ │ │ -00028b50: 6565 202a 6e6f 7465 2073 7570 6572 7573 ee *note superus │ │ │ │ -00028b60: 6572 733a 3a20 666f 7220 7661 6c69 6420 ers:: for valid │ │ │ │ -00028b70: 7573 6572 206c 6973 740a 2020 2020 2066 user list. f │ │ │ │ -00028b80: 6f72 6d61 742e 2020 4966 2027 7375 7065 ormat. If 'supe │ │ │ │ -00028b90: 7275 7365 7273 2720 6973 2065 6d70 7479 rusers' is empty │ │ │ │ -00028ba0: 2c20 7468 6973 2063 6f6d 6d61 6e64 2072 , this command r │ │ │ │ -00028bb0: 6574 7572 6e73 2074 7275 652e 0a20 2020 eturns true.. │ │ │ │ -00028bc0: 2020 2a4e 6f74 6520 5365 6375 7269 7479 *Note Security │ │ │ │ -00028bd0: 3a3a 2e0a 0a1f 0a46 696c 653a 2067 7275 ::.....File: gru │ │ │ │ -00028be0: 622e 696e 666f 2c20 204e 6f64 653a 2062 b.info, Node: b │ │ │ │ -00028bf0: 6163 6b67 726f 756e 645f 636f 6c6f 722c ackground_color, │ │ │ │ -00028c00: 2020 4e65 7874 3a20 6261 636b 6772 6f75 Next: backgrou │ │ │ │ -00028c10: 6e64 5f69 6d61 6765 2c20 2050 7265 763a nd_image, Prev: │ │ │ │ -00028c20: 2061 7574 6865 6e74 6963 6174 652c 2020 authenticate, │ │ │ │ -00028c30: 5570 3a20 436f 6d6d 616e 642d 6c69 6e65 Up: Command-line │ │ │ │ -00028c40: 2061 6e64 206d 656e 7520 656e 7472 7920 and menu entry │ │ │ │ -00028c50: 636f 6d6d 616e 6473 0a0a 3136 2e33 2e34 commands..16.3.4 │ │ │ │ -00028c60: 2062 6163 6b67 726f 756e 645f 636f 6c6f background_colo │ │ │ │ -00028c70: 720a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d r.-------------- │ │ │ │ -00028c80: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2043 ---------.. -- C │ │ │ │ -00028c90: 6f6d 6d61 6e64 3a20 6261 636b 6772 6f75 ommand: backgrou │ │ │ │ -00028ca0: 6e64 5f63 6f6c 6f72 2063 6f6c 6f72 0a20 nd_color color. │ │ │ │ -00028cb0: 2020 2020 5365 7420 6261 636b 6772 6f75 Set backgrou │ │ │ │ -00028cc0: 6e64 2063 6f6c 6f72 2066 6f72 2061 6374 nd color for act │ │ │ │ -00028cd0: 6976 6520 7465 726d 696e 616c 2e20 2046 ive terminal. F │ │ │ │ -00028ce0: 6f72 2076 616c 6964 2063 6f6c 6f72 0a20 or valid color. │ │ │ │ -00028cf0: 2020 2020 7370 6563 6966 6963 6174 696f specificatio │ │ │ │ -00028d00: 6e73 2073 6565 202a 6e6f 7465 2043 6f6c ns see *note Col │ │ │ │ -00028d10: 6f72 733a 2054 6865 6d65 2066 696c 6520 ors: Theme file │ │ │ │ -00028d20: 666f 726d 6174 2e20 2042 6163 6b67 726f format. Backgro │ │ │ │ -00028d30: 756e 640a 2020 2020 2063 6f6c 6f72 2063 und. color c │ │ │ │ -00028d40: 616e 2062 6520 6368 616e 6765 6420 6f6e an be changed on │ │ │ │ -00028d50: 6c79 2077 6865 6e20 7573 696e 6720 2767 ly when using 'g │ │ │ │ -00028d60: 6678 7465 726d 2720 666f 7220 7465 726d fxterm' for term │ │ │ │ -00028d70: 696e 616c 206f 7574 7075 742e 0a0a 2020 inal output... │ │ │ │ -00028d80: 2020 2054 6869 7320 636f 6d6d 616e 6420 This command │ │ │ │ -00028d90: 7365 7473 2063 6f6c 6f72 206f 6620 656d sets color of em │ │ │ │ -00028da0: 7074 7920 6172 6561 7320 7769 7468 6f75 pty areas withou │ │ │ │ -00028db0: 7420 7465 7874 2e20 2054 6578 740a 2020 t text. Text. │ │ │ │ -00028dc0: 2020 2062 6163 6b67 726f 756e 6420 636f background co │ │ │ │ -00028dd0: 6c6f 7220 6973 2063 6f6e 7472 6f6c 6c65 lor is controlle │ │ │ │ -00028de0: 6420 6279 2065 6e76 6972 6f6e 6d65 6e74 d by environment │ │ │ │ -00028df0: 2076 6172 6961 626c 6573 0a20 2020 2020 variables. │ │ │ │ -00028e00: 434f 4c4f 525f 4e4f 524d 414c 2c20 434f COLOR_NORMAL, CO │ │ │ │ -00028e10: 4c4f 525f 4849 4748 4c49 4748 542c 204d LOR_HIGHLIGHT, M │ │ │ │ -00028e20: 454e 555f 434f 4c4f 525f 4e4f 524d 414c ENU_COLOR_NORMAL │ │ │ │ -00028e30: 2c0a 2020 2020 204d 454e 555f 434f 4c4f ,. MENU_COLO │ │ │ │ -00028e40: 525f 4849 4748 4c49 4748 542e 2020 2a4e R_HIGHLIGHT. *N │ │ │ │ -00028e50: 6f74 6520 5370 6563 6961 6c20 656e 7669 ote Special envi │ │ │ │ -00028e60: 726f 6e6d 656e 7420 7661 7269 6162 6c65 ronment variable │ │ │ │ -00028e70: 733a 3a2e 0a0a 1f0a 4669 6c65 3a20 6772 s::.....File: gr │ │ │ │ -00028e80: 7562 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ub.info, Node: │ │ │ │ -00028e90: 6261 636b 6772 6f75 6e64 5f69 6d61 6765 background_image │ │ │ │ -00028ea0: 2c20 204e 6578 743a 2062 6164 7261 6d2c , Next: badram, │ │ │ │ -00028eb0: 2020 5072 6576 3a20 6261 636b 6772 6f75 Prev: backgrou │ │ │ │ -00028ec0: 6e64 5f63 6f6c 6f72 2c20 2055 703a 2043 nd_color, Up: C │ │ │ │ -00028ed0: 6f6d 6d61 6e64 2d6c 696e 6520 616e 6420 ommand-line and │ │ │ │ -00028ee0: 6d65 6e75 2065 6e74 7279 2063 6f6d 6d61 menu entry comma │ │ │ │ -00028ef0: 6e64 730a 0a31 362e 332e 3520 6261 636b nds..16.3.5 back │ │ │ │ -00028f00: 6772 6f75 6e64 5f69 6d61 6765 0a2d 2d2d ground_image.--- │ │ │ │ -00028f10: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ -00028f20: 2d2d 2d2d 0a0a 202d 2d20 436f 6d6d 616e ----.. -- Comman │ │ │ │ -00028f30: 643a 2062 6163 6b67 726f 756e 645f 696d d: background_im │ │ │ │ -00028f40: 6167 6520 5b5b 272d 2d6d 6f64 6527 2027 age [['--mode' ' │ │ │ │ -00028f50: 7374 7265 7463 6827 7c27 6e6f 726d 616c stretch'|'normal │ │ │ │ -00028f60: 275d 2066 696c 655d 0a20 2020 2020 4c6f '] file]. Lo │ │ │ │ -00028f70: 6164 2062 6163 6b67 726f 756e 6420 696d ad background im │ │ │ │ -00028f80: 6167 6520 666f 7220 6163 7469 7665 2074 age for active t │ │ │ │ -00028f90: 6572 6d69 6e61 6c20 6672 6f6d 2046 494c erminal from FIL │ │ │ │ -00028fa0: 452e 2020 496d 6167 6520 6973 0a20 2020 E. Image is. │ │ │ │ -00028fb0: 2020 7374 7265 7463 6865 6420 746f 2066 stretched to f │ │ │ │ -00028fc0: 696c 6c20 7570 2065 6e74 6972 6520 7363 ill up entire sc │ │ │ │ -00028fd0: 7265 656e 2075 6e6c 6573 7320 6f70 7469 reen unless opti │ │ │ │ -00028fe0: 6f6e 2027 2d2d 6d6f 6465 2720 276e 6f72 on '--mode' 'nor │ │ │ │ -00028ff0: 6d61 6c27 0a20 2020 2020 6973 2067 6976 mal'. is giv │ │ │ │ -00029000: 656e 2e20 2057 6974 686f 7574 2061 7267 en. Without arg │ │ │ │ -00029010: 756d 656e 7473 2072 656d 6f76 6520 6375 uments remove cu │ │ │ │ -00029020: 7272 656e 746c 7920 6c6f 6164 6564 2062 rrently loaded b │ │ │ │ -00029030: 6163 6b67 726f 756e 640a 2020 2020 2069 ackground. i │ │ │ │ -00029040: 6d61 6765 2e20 2042 6163 6b67 726f 756e mage. Backgroun │ │ │ │ -00029050: 6420 696d 6167 6520 6361 6e20 6265 2063 d image can be c │ │ │ │ -00029060: 6861 6e67 6564 206f 6e6c 7920 7768 656e hanged only when │ │ │ │ -00029070: 2075 7369 6e67 2027 6766 7874 6572 6d27 using 'gfxterm' │ │ │ │ -00029080: 0a20 2020 2020 666f 7220 7465 726d 696e . for termin │ │ │ │ -00029090: 616c 206f 7574 7075 742e 0a0a 1f0a 4669 al output.....Fi │ │ │ │ -000290a0: 6c65 3a20 6772 7562 2e69 6e66 6f2c 2020 le: grub.info, │ │ │ │ -000290b0: 4e6f 6465 3a20 6261 6472 616d 2c20 204e Node: badram, N │ │ │ │ -000290c0: 6578 743a 2062 6c6f 636b 6c69 7374 2c20 ext: blocklist, │ │ │ │ -000290d0: 2050 7265 763a 2062 6163 6b67 726f 756e Prev: backgroun │ │ │ │ -000290e0: 645f 696d 6167 652c 2020 5570 3a20 436f d_image, Up: Co │ │ │ │ -000290f0: 6d6d 616e 642d 6c69 6e65 2061 6e64 206d mmand-line and m │ │ │ │ -00029100: 656e 7520 656e 7472 7920 636f 6d6d 616e enu entry comman │ │ │ │ -00029110: 6473 0a0a 3136 2e33 2e36 2062 6164 7261 ds..16.3.6 badra │ │ │ │ -00029120: 6d0a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a m.-------------. │ │ │ │ -00029130: 0a20 2d2d 2043 6f6d 6d61 6e64 3a20 6261 . -- Command: ba │ │ │ │ -00029140: 6472 616d 2061 6464 722c 6d61 736b 5b2c dram addr,mask[, │ │ │ │ -00029150: 6164 6472 2c6d 6173 6b2e 2e2e 5d0a 2020 addr,mask...]. │ │ │ │ -00029160: 2020 2046 696c 7465 7220 6f75 7420 6261 Filter out ba │ │ │ │ -00029170: 6420 5241 4d2e 0a0a 2020 2054 6869 7320 d RAM... This │ │ │ │ -00029180: 636f 6d6d 616e 6420 6e6f 7469 6669 6573 command notifies │ │ │ │ -00029190: 2074 6865 206d 656d 6f72 7920 6d61 6e61 the memory mana │ │ │ │ -000291a0: 6765 7220 7468 6174 2073 7065 6369 6669 ger that specifi │ │ │ │ -000291b0: 6564 2072 6567 696f 6e73 206f 660a 5241 ed regions of.RA │ │ │ │ -000291c0: 4d20 6f75 6768 7420 746f 2062 6520 6669 M ought to be fi │ │ │ │ -000291d0: 6c74 6572 6564 206f 7574 2028 7573 7561 ltered out (usua │ │ │ │ -000291e0: 6c6c 792c 2062 6563 6175 7365 2074 6865 lly, because the │ │ │ │ -000291f0: 7927 7265 2064 616d 6167 6564 292e 2020 y're damaged). │ │ │ │ -00029200: 5468 6973 0a72 656d 6169 6e73 2069 6e20 This.remains in │ │ │ │ -00029210: 6566 6665 6374 2061 6674 6572 2061 2070 effect after a p │ │ │ │ -00029220: 6179 6c6f 6164 206b 6572 6e65 6c20 6861 ayload kernel ha │ │ │ │ -00029230: 7320 6265 656e 206c 6f61 6465 6420 6279 s been loaded by │ │ │ │ -00029240: 2047 5255 422c 2061 730a 6c6f 6e67 2061 GRUB, as.long a │ │ │ │ -00029250: 7320 7468 6520 6c6f 6164 6564 206b 6572 s the loaded ker │ │ │ │ -00029260: 6e65 6c20 6f62 7461 696e 7320 6974 7320 nel obtains its │ │ │ │ -00029270: 6d65 6d6f 7279 206d 6170 2066 726f 6d20 memory map from │ │ │ │ -00029280: 4752 5542 2e20 4b65 726e 656c 7320 7468 GRUB. Kernels th │ │ │ │ -00029290: 6174 0a73 7570 706f 7274 2074 6869 7320 at.support this │ │ │ │ -000292a0: 696e 636c 7564 6520 4c69 6e75 782c 2047 include Linux, G │ │ │ │ -000292b0: 4e55 204d 6163 682c 2074 6865 206b 6572 NU Mach, the ker │ │ │ │ -000292c0: 6e65 6c20 6f66 2046 7265 6542 5344 2061 nel of FreeBSD a │ │ │ │ -000292d0: 6e64 0a4d 756c 7469 626f 6f74 206b 6572 nd.Multiboot ker │ │ │ │ -000292e0: 6e65 6c73 2069 6e20 6765 6e65 7261 6c2e nels in general. │ │ │ │ -000292f0: 0a0a 2020 2053 796e 7461 7820 6973 2074 .. Syntax is t │ │ │ │ -00029300: 6865 2073 616d 6520 6173 2070 726f 7669 he same as provi │ │ │ │ -00029310: 6465 6420 6279 2074 6865 204d 656d 7465 ded by the Memte │ │ │ │ -00029320: 7374 3836 2b20 7574 696c 6974 790a 2868 st86+ utility.(h │ │ │ │ -00029330: 7474 703a 2f2f 7777 772e 6d65 6d74 6573 ttp://www.memtes │ │ │ │ -00029340: 742e 6f72 672f 293a 2061 206c 6973 7420 t.org/): a list │ │ │ │ -00029350: 6f66 2061 6464 7265 7373 2f6d 6173 6b20 of address/mask │ │ │ │ -00029360: 7061 6972 732e 2020 4769 7665 6e20 610a pairs. Given a. │ │ │ │ -00029370: 7061 6765 2d61 6c69 676e 6564 2061 6464 page-aligned add │ │ │ │ -00029380: 7265 7373 2061 6e64 2061 2062 6173 6520 ress and a base │ │ │ │ -00029390: 6164 6472 6573 7320 2f20 6d61 736b 2070 address / mask p │ │ │ │ -000293a0: 6169 722c 2069 6620 616c 6c20 7468 6520 air, if all the │ │ │ │ -000293b0: 6269 7473 206f 660a 7468 6520 7061 6765 bits of.the page │ │ │ │ -000293c0: 2d61 6c69 676e 6564 2061 6464 7265 7373 -aligned address │ │ │ │ -000293d0: 2074 6861 7420 6172 6520 656e 6162 6c65 that are enable │ │ │ │ -000293e0: 6420 6279 2074 6865 206d 6173 6b20 6d61 d by the mask ma │ │ │ │ -000293f0: 7463 6820 7769 7468 2074 6865 0a62 6173 tch with the.bas │ │ │ │ -00029400: 6520 6164 6472 6573 732c 2069 7420 6d65 e address, it me │ │ │ │ -00029410: 616e 7320 7468 6973 2070 6167 6520 6973 ans this page is │ │ │ │ -00029420: 2074 6f20 6265 2066 696c 7465 7265 642e to be filtered. │ │ │ │ -00029430: 2020 5468 6973 2073 796e 7461 7820 6d61 This syntax ma │ │ │ │ -00029440: 6b65 730a 6974 2065 6173 7920 746f 2072 kes.it easy to r │ │ │ │ -00029450: 6570 7265 7365 6e74 2070 6174 7465 726e epresent pattern │ │ │ │ -00029460: 7320 7468 6174 2061 7265 206f 6674 656e s that are often │ │ │ │ -00029470: 2072 6573 756c 7420 6f66 206d 656d 6f72 result of memor │ │ │ │ -00029480: 7920 6461 6d61 6765 2c0a 6475 6520 746f y damage,.due to │ │ │ │ -00029490: 2070 6879 7369 6361 6c20 6469 7374 7269 physical distri │ │ │ │ -000294a0: 6275 7469 6f6e 206f 6620 6d65 6d6f 7279 bution of memory │ │ │ │ -000294b0: 2063 656c 6c73 2e0a 0a20 2020 5468 6520 cells... The │ │ │ │ -000294c0: 636f 6d6d 616e 6420 6973 2073 696d 696c command is simil │ │ │ │ -000294d0: 6172 2074 6f20 2763 7574 6d65 6d27 2063 ar to 'cutmem' c │ │ │ │ -000294e0: 6f6d 6d61 6e64 2e0a 0a20 2020 4e6f 7465 ommand... Note │ │ │ │ -000294f0: 3a20 5468 6520 636f 6d6d 616e 6420 6973 : The command is │ │ │ │ -00029500: 206e 6f74 2061 6c6c 6f77 6564 2077 6865 not allowed whe │ │ │ │ -00029510: 6e20 6c6f 636b 646f 776e 2069 7320 656e n lockdown is en │ │ │ │ -00029520: 666f 7263 6564 2028 2a6e 6f74 650a 4c6f forced (*note.Lo │ │ │ │ -00029530: 636b 646f 776e 3a3a 292e 2020 5468 6973 ckdown::). This │ │ │ │ -00029540: 2070 7265 7665 6e74 7320 7265 6d6f 7669 prevents removi │ │ │ │ -00029550: 6e67 2045 4649 206d 656d 6f72 7920 7265 ng EFI memory re │ │ │ │ -00029560: 6769 6f6e 7320 746f 2070 6f74 656e 7469 gions to potenti │ │ │ │ -00029570: 616c 6c79 0a73 7562 7665 7274 2074 6865 ally.subvert the │ │ │ │ -00029580: 2073 6563 7572 6974 7920 6d65 6368 616e security mechan │ │ │ │ -00029590: 6973 6d73 2070 726f 7669 6465 6420 6279 isms provided by │ │ │ │ -000295a0: 2074 6865 2055 4546 4920 7365 6375 7265 the UEFI secure │ │ │ │ -000295b0: 2062 6f6f 742e 0a0a 1f0a 4669 6c65 3a20 boot.....File: │ │ │ │ -000295c0: 6772 7562 2e69 6e66 6f2c 2020 4e6f 6465 grub.info, Node │ │ │ │ -000295d0: 3a20 626c 6f63 6b6c 6973 742c 2020 4e65 : blocklist, Ne │ │ │ │ -000295e0: 7874 3a20 626f 6f74 2c20 2050 7265 763a xt: boot, Prev: │ │ │ │ -000295f0: 2062 6164 7261 6d2c 2020 5570 3a20 436f badram, Up: Co │ │ │ │ -00029600: 6d6d 616e 642d 6c69 6e65 2061 6e64 206d mmand-line and m │ │ │ │ -00029610: 656e 7520 656e 7472 7920 636f 6d6d 616e enu entry comman │ │ │ │ -00029620: 6473 0a0a 3136 2e33 2e37 2062 6c6f 636b ds..16.3.7 block │ │ │ │ -00029630: 6c69 7374 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d list.----------- │ │ │ │ -00029640: 2d2d 2d2d 2d0a 0a20 2d2d 2043 6f6d 6d61 -----.. -- Comma │ │ │ │ -00029650: 6e64 3a20 626c 6f63 6b6c 6973 7420 6669 nd: blocklist fi │ │ │ │ -00029660: 6c65 0a20 2020 2020 5072 696e 7420 6120 le. Print a │ │ │ │ -00029670: 626c 6f63 6b20 6c69 7374 2028 2a6e 6f74 block list (*not │ │ │ │ -00029680: 6520 426c 6f63 6b20 6c69 7374 2073 796e e Block list syn │ │ │ │ -00029690: 7461 783a 3a29 2066 6f72 2046 494c 452e tax::) for FILE. │ │ │ │ -000296a0: 0a0a 1f0a 4669 6c65 3a20 6772 7562 2e69 ....File: grub.i │ │ │ │ -000296b0: 6e66 6f2c 2020 4e6f 6465 3a20 626f 6f74 nfo, Node: boot │ │ │ │ -000296c0: 2c20 204e 6578 743a 2063 6174 2c20 2050 , Next: cat, P │ │ │ │ -000296d0: 7265 763a 2062 6c6f 636b 6c69 7374 2c20 rev: blocklist, │ │ │ │ -000296e0: 2055 703a 2043 6f6d 6d61 6e64 2d6c 696e Up: Command-lin │ │ │ │ -000296f0: 6520 616e 6420 6d65 6e75 2065 6e74 7279 e and menu entry │ │ │ │ -00029700: 2063 6f6d 6d61 6e64 730a 0a31 362e 332e commands..16.3. │ │ │ │ -00029710: 3820 626f 6f74 0a2d 2d2d 2d2d 2d2d 2d2d 8 boot.--------- │ │ │ │ -00029720: 2d2d 0a0a 202d 2d20 436f 6d6d 616e 643a --.. -- Command: │ │ │ │ -00029730: 2062 6f6f 740a 2020 2020 2042 6f6f 7420 boot. Boot │ │ │ │ -00029740: 7468 6520 4f53 206f 7220 6368 6169 6e2d the OS or chain- │ │ │ │ -00029750: 6c6f 6164 6572 2077 6869 6368 2068 6173 loader which has │ │ │ │ -00029760: 2062 6565 6e20 6c6f 6164 6564 2e20 204f been loaded. O │ │ │ │ -00029770: 6e6c 7920 6e65 6365 7373 6172 790a 2020 nly necessary. │ │ │ │ -00029780: 2020 2069 6620 7275 6e6e 696e 6720 7468 if running th │ │ │ │ -00029790: 6520 6675 6c6c 7920 696e 7465 7261 6374 e fully interact │ │ │ │ -000297a0: 6976 6520 636f 6d6d 616e 642d 6c69 6e65 ive command-line │ │ │ │ -000297b0: 2028 6974 2069 7320 696d 706c 6963 6974 (it is implicit │ │ │ │ -000297c0: 2061 740a 2020 2020 2074 6865 2065 6e64 at. the end │ │ │ │ -000297d0: 206f 6620 6120 6d65 6e75 2065 6e74 7279 of a menu entry │ │ │ │ -000297e0: 292e 0a0a 1f0a 4669 6c65 3a20 6772 7562 ).....File: grub │ │ │ │ -000297f0: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 6361 .info, Node: ca │ │ │ │ -00029800: 742c 2020 4e65 7874 3a20 6368 6169 6e6c t, Next: chainl │ │ │ │ -00029810: 6f61 6465 722c 2020 5072 6576 3a20 626f oader, Prev: bo │ │ │ │ -00029820: 6f74 2c20 2055 703a 2043 6f6d 6d61 6e64 ot, Up: Command │ │ │ │ -00029830: 2d6c 696e 6520 616e 6420 6d65 6e75 2065 -line and menu e │ │ │ │ -00029840: 6e74 7279 2063 6f6d 6d61 6e64 730a 0a31 ntry commands..1 │ │ │ │ -00029850: 362e 332e 3920 6361 740a 2d2d 2d2d 2d2d 6.3.9 cat.------ │ │ │ │ -00029860: 2d2d 2d2d 0a0a 202d 2d20 436f 6d6d 616e ----.. -- Comman │ │ │ │ -00029870: 643a 2063 6174 205b 272d 2d64 6f73 275d d: cat ['--dos'] │ │ │ │ -00029880: 2066 696c 650a 2020 2020 2044 6973 706c file. Displ │ │ │ │ -00029890: 6179 2074 6865 2063 6f6e 7465 6e74 7320 ay the contents │ │ │ │ -000298a0: 6f66 2074 6865 2066 696c 6520 4649 4c45 of the file FILE │ │ │ │ -000298b0: 2e20 2054 6869 7320 636f 6d6d 616e 6420 . This command │ │ │ │ -000298c0: 6d61 7920 6265 2075 7365 6675 6c0a 2020 may be useful. │ │ │ │ -000298d0: 2020 2074 6f20 7265 6d69 6e64 2079 6f75 to remind you │ │ │ │ -000298e0: 206f 6620 796f 7572 204f 5327 7320 726f of your OS's ro │ │ │ │ -000298f0: 6f74 2070 6172 7469 7469 6f6e 3a0a 0a20 ot partition:.. │ │ │ │ -00029900: 2020 2020 2020 2020 2067 7275 623e 2063 grub> c │ │ │ │ -00029910: 6174 202f 6574 632f 6673 7461 620a 0a20 at /etc/fstab.. │ │ │ │ -00029920: 2020 2020 4966 2074 6865 2027 2d2d 646f If the '--do │ │ │ │ -00029930: 7327 206f 7074 696f 6e20 6973 2075 7365 s' option is use │ │ │ │ -00029940: 642c 2074 6865 6e20 6361 7272 6961 6765 d, then carriage │ │ │ │ -00029950: 2072 6574 7572 6e20 2f20 6e65 7720 6c69 return / new li │ │ │ │ -00029960: 6e65 0a20 2020 2020 7061 6972 7320 7769 ne. pairs wi │ │ │ │ -00029970: 6c6c 2062 6520 6469 7370 6c61 7965 6420 ll be displayed │ │ │ │ -00029980: 6173 2061 2073 696d 706c 6520 6e65 7720 as a simple new │ │ │ │ -00029990: 6c69 6e65 2e20 204f 7468 6572 7769 7365 line. Otherwise │ │ │ │ -000299a0: 2c20 7468 650a 2020 2020 2063 6172 7269 , the. carri │ │ │ │ -000299b0: 6167 6520 7265 7475 726e 2077 696c 6c20 age return will │ │ │ │ -000299c0: 6265 2064 6973 706c 6179 6564 2061 7320 be displayed as │ │ │ │ -000299d0: 6120 636f 6e74 726f 6c20 6368 6172 6163 a control charac │ │ │ │ -000299e0: 7465 7220 2827 3c64 3e27 2920 746f 0a20 ter ('') to. │ │ │ │ -000299f0: 2020 2020 6d61 6b65 2069 7420 6561 7369 make it easi │ │ │ │ -00029a00: 6572 2074 6f20 7365 6520 7768 656e 2062 er to see when b │ │ │ │ -00029a10: 6f6f 7420 7072 6f62 6c65 6d73 2061 7265 oot problems are │ │ │ │ -00029a20: 2063 6175 7365 6420 6279 2061 2066 696c caused by a fil │ │ │ │ -00029a30: 650a 2020 2020 2066 6f72 6d61 7474 6564 e. formatted │ │ │ │ -00029a40: 2075 7369 6e67 2044 4f53 2d73 7479 6c65 using DOS-style │ │ │ │ -00029a50: 206c 696e 6520 656e 6469 6e67 732e 0a0a line endings... │ │ │ │ -00029a60: 1f0a 4669 6c65 3a20 6772 7562 2e69 6e66 ..File: grub.inf │ │ │ │ -00029a70: 6f2c 2020 4e6f 6465 3a20 6368 6169 6e6c o, Node: chainl │ │ │ │ -00029a80: 6f61 6465 722c 2020 4e65 7874 3a20 636c oader, Next: cl │ │ │ │ -00029a90: 6561 722c 2020 5072 6576 3a20 6361 742c ear, Prev: cat, │ │ │ │ -00029aa0: 2020 5570 3a20 436f 6d6d 616e 642d 6c69 Up: Command-li │ │ │ │ -00029ab0: 6e65 2061 6e64 206d 656e 7520 656e 7472 ne and menu entr │ │ │ │ -00029ac0: 7920 636f 6d6d 616e 6473 0a0a 3136 2e33 y commands..16.3 │ │ │ │ -00029ad0: 2e31 3020 6368 6169 6e6c 6f61 6465 720a .10 chainloader. │ │ │ │ -00029ae0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ -00029af0: 2d2d 2d0a 0a20 2d2d 2043 6f6d 6d61 6e64 ---.. -- Command │ │ │ │ -00029b00: 3a20 6368 6169 6e6c 6f61 6465 7220 5b27 : chainloader [' │ │ │ │ -00029b10: 2d2d 666f 7263 6527 5d20 6669 6c65 0a20 --force'] file. │ │ │ │ -00029b20: 2020 2020 4c6f 6164 2046 494c 4520 6173 Load FILE as │ │ │ │ -00029b30: 2061 2063 6861 696e 2d6c 6f61 6465 722e a chain-loader. │ │ │ │ -00029b40: 2020 4c69 6b65 2061 6e79 206f 7468 6572 Like any other │ │ │ │ -00029b50: 2066 696c 6520 6c6f 6164 6564 2062 7920 file loaded by │ │ │ │ -00029b60: 7468 650a 2020 2020 2066 696c 6573 7973 the. filesys │ │ │ │ -00029b70: 7465 6d20 636f 6465 2c20 6974 2063 616e tem code, it can │ │ │ │ -00029b80: 2075 7365 2074 6865 2062 6c6f 636b 6c69 use the blockli │ │ │ │ -00029b90: 7374 206e 6f74 6174 696f 6e20 282a 6e6f st notation (*no │ │ │ │ -00029ba0: 7465 2042 6c6f 636b 0a20 2020 2020 6c69 te Block. li │ │ │ │ -00029bb0: 7374 2073 796e 7461 783a 3a29 2074 6f20 st syntax::) to │ │ │ │ -00029bc0: 6772 6162 2074 6865 2066 6972 7374 2073 grab the first s │ │ │ │ -00029bd0: 6563 746f 7220 6f66 2074 6865 2063 7572 ector of the cur │ │ │ │ -00029be0: 7265 6e74 2070 6172 7469 7469 6f6e 0a20 rent partition. │ │ │ │ -00029bf0: 2020 2020 7769 7468 2027 2b31 272e 2020 with '+1'. │ │ │ │ -00029c00: 4966 2079 6f75 2073 7065 6369 6679 2074 If you specify t │ │ │ │ -00029c10: 6865 206f 7074 696f 6e20 272d 2d66 6f72 he option '--for │ │ │ │ -00029c20: 6365 272c 2074 6865 6e20 6c6f 6164 2046 ce', then load F │ │ │ │ -00029c30: 494c 450a 2020 2020 2066 6f72 6369 626c ILE. forcibl │ │ │ │ -00029c40: 792c 2077 6865 7468 6572 2069 7420 6861 y, whether it ha │ │ │ │ -00029c50: 7320 6120 636f 7272 6563 7420 7369 676e s a correct sign │ │ │ │ -00029c60: 6174 7572 6520 6f72 206e 6f74 2e20 2054 ature or not. T │ │ │ │ -00029c70: 6869 7320 6973 0a20 2020 2020 7265 7175 his is. requ │ │ │ │ -00029c80: 6972 6564 2077 6865 6e20 796f 7520 7761 ired when you wa │ │ │ │ -00029c90: 6e74 2074 6f20 6c6f 6164 2061 2064 6566 nt to load a def │ │ │ │ -00029ca0: 6563 7469 7665 2062 6f6f 7420 6c6f 6164 ective boot load │ │ │ │ -00029cb0: 6572 2c20 7375 6368 2061 7320 5343 4f0a er, such as SCO. │ │ │ │ -00029cc0: 2020 2020 2055 6e69 7857 6172 6520 372e UnixWare 7. │ │ │ │ -00029cd0: 312e 0a0a 1f0a 4669 6c65 3a20 6772 7562 1.....File: grub │ │ │ │ -00029ce0: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 636c .info, Node: cl │ │ │ │ -00029cf0: 6561 722c 2020 4e65 7874 3a20 636d 6f73 ear, Next: cmos │ │ │ │ -00029d00: 636c 6561 6e2c 2020 5072 6576 3a20 6368 clean, Prev: ch │ │ │ │ -00029d10: 6169 6e6c 6f61 6465 722c 2020 5570 3a20 ainloader, Up: │ │ │ │ -00029d20: 436f 6d6d 616e 642d 6c69 6e65 2061 6e64 Command-line and │ │ │ │ -00029d30: 206d 656e 7520 656e 7472 7920 636f 6d6d menu entry comm │ │ │ │ -00029d40: 616e 6473 0a0a 3136 2e33 2e31 3120 636c ands..16.3.11 cl │ │ │ │ -00029d50: 6561 720a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ear.------------ │ │ │ │ -00029d60: 2d0a 0a20 2d2d 2043 6f6d 6d61 6e64 3a20 -.. -- Command: │ │ │ │ -00029d70: 636c 6561 720a 2020 2020 2043 6c65 6172 clear. Clear │ │ │ │ -00029d80: 2074 6865 2073 6372 6565 6e2e 0a0a 1f0a the screen..... │ │ │ │ -00029d90: 4669 6c65 3a20 6772 7562 2e69 6e66 6f2c File: grub.info, │ │ │ │ -00029da0: 2020 4e6f 6465 3a20 636d 6f73 636c 6561 Node: cmosclea │ │ │ │ -00029db0: 6e2c 2020 4e65 7874 3a20 636d 6f73 6475 n, Next: cmosdu │ │ │ │ -00029dc0: 6d70 2c20 2050 7265 763a 2063 6c65 6172 mp, Prev: clear │ │ │ │ -00029dd0: 2c20 2055 703a 2043 6f6d 6d61 6e64 2d6c , Up: Command-l │ │ │ │ -00029de0: 696e 6520 616e 6420 6d65 6e75 2065 6e74 ine and menu ent │ │ │ │ -00029df0: 7279 2063 6f6d 6d61 6e64 730a 0a31 362e ry commands..16. │ │ │ │ -00029e00: 332e 3132 2063 6d6f 7363 6c65 616e 0a2d 3.12 cmosclean.- │ │ │ │ -00029e10: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ -00029e20: 0a0a 202d 2d20 436f 6d6d 616e 643a 2063 .. -- Command: c │ │ │ │ -00029e30: 6d6f 7363 6c65 616e 2062 7974 653a 6269 mosclean byte:bi │ │ │ │ -00029e40: 740a 2020 2020 2043 6c65 6172 2076 616c t. Clear val │ │ │ │ -00029e50: 7565 206f 6620 6269 7420 696e 2043 4d4f ue of bit in CMO │ │ │ │ -00029e60: 5320 6174 206c 6f63 6174 696f 6e20 4259 S at location BY │ │ │ │ -00029e70: 5445 3a42 4954 2e20 2054 6869 7320 636f TE:BIT. This co │ │ │ │ -00029e80: 6d6d 616e 6420 6973 0a20 2020 2020 6176 mmand is. av │ │ │ │ -00029e90: 6169 6c61 626c 6520 6f6e 6c79 206f 6e20 ailable only on │ │ │ │ -00029ea0: 706c 6174 666f 726d 7320 7468 6174 2073 platforms that s │ │ │ │ -00029eb0: 7570 706f 7274 2043 4d4f 532e 0a0a 1f0a upport CMOS..... │ │ │ │ -00029ec0: 4669 6c65 3a20 6772 7562 2e69 6e66 6f2c File: grub.info, │ │ │ │ -00029ed0: 2020 4e6f 6465 3a20 636d 6f73 6475 6d70 Node: cmosdump │ │ │ │ -00029ee0: 2c20 204e 6578 743a 2063 6d6f 7374 6573 , Next: cmostes │ │ │ │ -00029ef0: 742c 2020 5072 6576 3a20 636d 6f73 636c t, Prev: cmoscl │ │ │ │ -00029f00: 6561 6e2c 2020 5570 3a20 436f 6d6d 616e ean, Up: Comman │ │ │ │ -00029f10: 642d 6c69 6e65 2061 6e64 206d 656e 7520 d-line and menu │ │ │ │ -00029f20: 656e 7472 7920 636f 6d6d 616e 6473 0a0a entry commands.. │ │ │ │ -00029f30: 3136 2e33 2e31 3320 636d 6f73 6475 6d70 16.3.13 cmosdump │ │ │ │ -00029f40: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d .--------------- │ │ │ │ -00029f50: 2d0a 0a20 2d2d 2044 756d 703a 2043 4d4f -.. -- Dump: CMO │ │ │ │ -00029f60: 5320 636f 6e74 656e 7473 0a20 2020 2020 S contents. │ │ │ │ -00029f70: 4475 6d70 2066 756c 6c20 434d 4f53 2063 Dump full CMOS c │ │ │ │ -00029f80: 6f6e 7465 6e74 7320 6173 2068 6578 6164 ontents as hexad │ │ │ │ -00029f90: 6563 696d 616c 2076 616c 7565 732e 2020 ecimal values. │ │ │ │ -00029fa0: 5468 6973 2063 6f6d 6d61 6e64 2069 730a This command is. │ │ │ │ -00029fb0: 2020 2020 2061 7661 696c 6162 6c65 206f available o │ │ │ │ -00029fc0: 6e6c 7920 6f6e 2070 6c61 7466 6f72 6d73 nly on platforms │ │ │ │ -00029fd0: 2074 6861 7420 7375 7070 6f72 7420 434d that support CM │ │ │ │ -00029fe0: 4f53 2e0a 0a1f 0a46 696c 653a 2067 7275 OS.....File: gru │ │ │ │ -00029ff0: 622e 696e 666f 2c20 204e 6f64 653a 2063 b.info, Node: c │ │ │ │ -0002a000: 6d6f 7374 6573 742c 2020 4e65 7874 3a20 mostest, Next: │ │ │ │ -0002a010: 636d 702c 2020 5072 6576 3a20 636d 6f73 cmp, Prev: cmos │ │ │ │ -0002a020: 6475 6d70 2c20 2055 703a 2043 6f6d 6d61 dump, Up: Comma │ │ │ │ -0002a030: 6e64 2d6c 696e 6520 616e 6420 6d65 6e75 nd-line and menu │ │ │ │ -0002a040: 2065 6e74 7279 2063 6f6d 6d61 6e64 730a entry commands. │ │ │ │ -0002a050: 0a31 362e 332e 3134 2063 6d6f 7374 6573 .16.3.14 cmostes │ │ │ │ -0002a060: 740a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d t.-------------- │ │ │ │ -0002a070: 2d2d 0a0a 202d 2d20 436f 6d6d 616e 643a --.. -- Command: │ │ │ │ -0002a080: 2063 6d6f 7374 6573 7420 6279 7465 3a62 cmostest byte:b │ │ │ │ -0002a090: 6974 0a20 2020 2020 5465 7374 2076 616c it. Test val │ │ │ │ -0002a0a0: 7565 206f 6620 6269 7420 696e 2043 4d4f ue of bit in CMO │ │ │ │ -0002a0b0: 5320 6174 206c 6f63 6174 696f 6e20 4259 S at location BY │ │ │ │ -0002a0c0: 5445 3a42 4954 2e20 2045 7869 7420 7374 TE:BIT. Exit st │ │ │ │ -0002a0d0: 6174 7573 2069 730a 2020 2020 207a 6572 atus is. zer │ │ │ │ -0002a0e0: 6f20 6966 2062 6974 2069 7320 7365 742c o if bit is set, │ │ │ │ -0002a0f0: 206e 6f6e 207a 6572 6f20 6f74 6865 7277 non zero otherw │ │ │ │ -0002a100: 6973 652e 2020 5468 6973 2063 6f6d 6d61 ise. This comma │ │ │ │ -0002a110: 6e64 2069 7320 6176 6169 6c61 626c 650a nd is available. │ │ │ │ -0002a120: 2020 2020 206f 6e6c 7920 6f6e 2070 6c61 only on pla │ │ │ │ -0002a130: 7466 6f72 6d73 2074 6861 7420 7375 7070 tforms that supp │ │ │ │ -0002a140: 6f72 7420 434d 4f53 2e0a 0a1f 0a46 696c ort CMOS.....Fil │ │ │ │ -0002a150: 653a 2067 7275 622e 696e 666f 2c20 204e e: grub.info, N │ │ │ │ -0002a160: 6f64 653a 2063 6d70 2c20 204e 6578 743a ode: cmp, Next: │ │ │ │ -0002a170: 2063 6f6e 6669 6766 696c 652c 2020 5072 configfile, Pr │ │ │ │ -0002a180: 6576 3a20 636d 6f73 7465 7374 2c20 2055 ev: cmostest, U │ │ │ │ -0002a190: 703a 2043 6f6d 6d61 6e64 2d6c 696e 6520 p: Command-line │ │ │ │ -0002a1a0: 616e 6420 6d65 6e75 2065 6e74 7279 2063 and menu entry c │ │ │ │ -0002a1b0: 6f6d 6d61 6e64 730a 0a31 362e 332e 3135 ommands..16.3.15 │ │ │ │ -0002a1c0: 2063 6d70 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d cmp.----------- │ │ │ │ -0002a1d0: 0a0a 202d 2d20 436f 6d6d 616e 643a 2063 .. -- Command: c │ │ │ │ -0002a1e0: 6d70 2066 696c 6531 2066 696c 6532 0a20 mp file1 file2. │ │ │ │ -0002a1f0: 2020 2020 436f 6d70 6172 6520 7468 6520 Compare the │ │ │ │ -0002a200: 6669 6c65 2046 494c 4531 2077 6974 6820 file FILE1 with │ │ │ │ -0002a210: 7468 6520 6669 6c65 2046 494c 4532 2e20 the file FILE2. │ │ │ │ -0002a220: 2049 6620 7468 6579 2064 6966 6665 7220 If they differ │ │ │ │ -0002a230: 696e 0a20 2020 2020 7369 7a65 2c20 7072 in. size, pr │ │ │ │ -0002a240: 696e 7420 7468 6520 7369 7a65 7320 6c69 int the sizes li │ │ │ │ -0002a250: 6b65 2074 6869 733a 0a0a 2020 2020 2020 ke this:.. │ │ │ │ -0002a260: 2020 2020 4469 6666 6572 2069 6e20 7369 Differ in si │ │ │ │ -0002a270: 7a65 3a20 3078 3132 3334 205b 666f 6f5d ze: 0x1234 [foo] │ │ │ │ -0002a280: 2c20 3078 3433 3231 205b 6261 725d 0a0a , 0x4321 [bar].. │ │ │ │ -0002a290: 2020 2020 2049 6620 7468 6520 7369 7a65 If the size │ │ │ │ -0002a2a0: 7320 6172 6520 6571 7561 6c20 6275 7420 s are equal but │ │ │ │ -0002a2b0: 7468 6520 6279 7465 7320 6174 2061 6e20 the bytes at an │ │ │ │ -0002a2c0: 6f66 6673 6574 2064 6966 6665 722c 2074 offset differ, t │ │ │ │ -0002a2d0: 6865 6e0a 2020 2020 2070 7269 6e74 2074 hen. print t │ │ │ │ -0002a2e0: 6865 2062 7974 6573 206c 696b 6520 7468 he bytes like th │ │ │ │ -0002a2f0: 6973 3a0a 0a20 2020 2020 2020 2020 2044 is:.. D │ │ │ │ -0002a300: 6966 6665 7220 6174 2074 6865 206f 6666 iffer at the off │ │ │ │ -0002a310: 7365 7420 3737 373a 2030 7862 6520 5b66 set 777: 0xbe [f │ │ │ │ -0002a320: 6f6f 5d2c 2030 7865 6620 5b62 6172 5d0a oo], 0xef [bar]. │ │ │ │ -0002a330: 0a20 2020 2020 4966 2074 6865 7920 6172 . If they ar │ │ │ │ -0002a340: 6520 636f 6d70 6c65 7465 6c79 2069 6465 e completely ide │ │ │ │ -0002a350: 6e74 6963 616c 2c20 6e6f 7468 696e 6720 ntical, nothing │ │ │ │ -0002a360: 7769 6c6c 2062 6520 7072 696e 7465 642e will be printed. │ │ │ │ -0002a370: 0a0a 1f0a 4669 6c65 3a20 6772 7562 2e69 ....File: grub.i │ │ │ │ -0002a380: 6e66 6f2c 2020 4e6f 6465 3a20 636f 6e66 nfo, Node: conf │ │ │ │ -0002a390: 6967 6669 6c65 2c20 204e 6578 743a 2063 igfile, Next: c │ │ │ │ -0002a3a0: 7075 6964 2c20 2050 7265 763a 2063 6d70 puid, Prev: cmp │ │ │ │ -0002a3b0: 2c20 2055 703a 2043 6f6d 6d61 6e64 2d6c , Up: Command-l │ │ │ │ -0002a3c0: 696e 6520 616e 6420 6d65 6e75 2065 6e74 ine and menu ent │ │ │ │ -0002a3d0: 7279 2063 6f6d 6d61 6e64 730a 0a31 362e ry commands..16. │ │ │ │ -0002a3e0: 332e 3136 2063 6f6e 6669 6766 696c 650a 3.16 configfile. │ │ │ │ -0002a3f0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ -0002a400: 2d2d 0a0a 202d 2d20 436f 6d6d 616e 643a --.. -- Command: │ │ │ │ -0002a410: 2063 6f6e 6669 6766 696c 6520 6669 6c65 configfile file │ │ │ │ -0002a420: 0a20 2020 2020 4c6f 6164 2046 494c 4520 . Load FILE │ │ │ │ -0002a430: 6173 2061 2063 6f6e 6669 6775 7261 7469 as a configurati │ │ │ │ -0002a440: 6f6e 2066 696c 652e 2020 4966 2046 494c on file. If FIL │ │ │ │ -0002a450: 4520 6465 6669 6e65 7320 616e 7920 6d65 E defines any me │ │ │ │ -0002a460: 6e75 0a20 2020 2020 656e 7472 6965 732c nu. entries, │ │ │ │ -0002a470: 2074 6865 6e20 7368 6f77 2061 206d 656e then show a men │ │ │ │ -0002a480: 7520 636f 6e74 6169 6e69 6e67 2074 6865 u containing the │ │ │ │ -0002a490: 6d20 696d 6d65 6469 6174 656c 792e 2020 m immediately. │ │ │ │ -0002a4a0: 416e 790a 2020 2020 2065 6e76 6972 6f6e Any. environ │ │ │ │ -0002a4b0: 6d65 6e74 2076 6172 6961 626c 6520 6368 ment variable ch │ │ │ │ -0002a4c0: 616e 6765 7320 6d61 6465 2062 7920 7468 anges made by th │ │ │ │ -0002a4d0: 6520 636f 6d6d 616e 6473 2069 6e20 4649 e commands in FI │ │ │ │ -0002a4e0: 4c45 2077 696c 6c20 6e6f 740a 2020 2020 LE will not. │ │ │ │ -0002a4f0: 2062 6520 7072 6573 6572 7665 6420 6166 be preserved af │ │ │ │ -0002a500: 7465 7220 2763 6f6e 6669 6766 696c 6527 ter 'configfile' │ │ │ │ -0002a510: 2072 6574 7572 6e73 2e0a 0a1f 0a46 696c returns.....Fil │ │ │ │ -0002a520: 653a 2067 7275 622e 696e 666f 2c20 204e e: grub.info, N │ │ │ │ -0002a530: 6f64 653a 2063 7075 6964 2c20 204e 6578 ode: cpuid, Nex │ │ │ │ -0002a540: 743a 2063 7263 2c20 2050 7265 763a 2063 t: crc, Prev: c │ │ │ │ -0002a550: 6f6e 6669 6766 696c 652c 2020 5570 3a20 onfigfile, Up: │ │ │ │ -0002a560: 436f 6d6d 616e 642d 6c69 6e65 2061 6e64 Command-line and │ │ │ │ -0002a570: 206d 656e 7520 656e 7472 7920 636f 6d6d menu entry comm │ │ │ │ -0002a580: 616e 6473 0a0a 3136 2e33 2e31 3720 6370 ands..16.3.17 cp │ │ │ │ -0002a590: 7569 640a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d uid.------------ │ │ │ │ -0002a5a0: 2d0a 0a20 2d2d 2043 6f6d 6d61 6e64 3a20 -.. -- Command: │ │ │ │ -0002a5b0: 6370 7569 6420 5b2d 6c5d 205b 2d70 5d0a cpuid [-l] [-p]. │ │ │ │ -0002a5c0: 2020 2020 2043 6865 636b 2066 6f72 2043 Check for C │ │ │ │ -0002a5d0: 5055 2066 6561 7475 7265 732e 2020 5468 PU features. Th │ │ │ │ -0002a5e0: 6973 2063 6f6d 6d61 6e64 2069 7320 6f6e is command is on │ │ │ │ -0002a5f0: 6c79 2061 7661 696c 6162 6c65 206f 6e20 ly available on │ │ │ │ -0002a600: 7838 360a 2020 2020 2073 7973 7465 6d73 x86. systems │ │ │ │ -0002a610: 2e0a 0a20 2020 2020 5769 7468 2074 6865 ... With the │ │ │ │ -0002a620: 2027 2d6c 2720 6f70 7469 6f6e 2c20 7265 '-l' option, re │ │ │ │ -0002a630: 7475 726e 2074 7275 6520 6966 2074 6865 turn true if the │ │ │ │ -0002a640: 2043 5055 2073 7570 706f 7274 7320 6c6f CPU supports lo │ │ │ │ -0002a650: 6e67 206d 6f64 650a 2020 2020 2028 3634 ng mode. (64 │ │ │ │ -0002a660: 2d62 6974 292e 0a0a 2020 2020 2057 6974 -bit)... Wit │ │ │ │ -0002a670: 6820 7468 6520 272d 7027 206f 7074 696f h the '-p' optio │ │ │ │ -0002a680: 6e2c 2072 6574 7572 6e20 7472 7565 2069 n, return true i │ │ │ │ -0002a690: 6620 7468 6520 4350 5520 7375 7070 6f72 f the CPU suppor │ │ │ │ -0002a6a0: 7473 2050 6879 7369 6361 6c0a 2020 2020 ts Physical. │ │ │ │ -0002a6b0: 2041 6464 7265 7373 2045 7874 656e 7369 Address Extensi │ │ │ │ -0002a6c0: 6f6e 2028 5041 4529 2e0a 0a20 2020 2020 on (PAE)... │ │ │ │ -0002a6d0: 4966 2069 6e76 6f6b 6564 2077 6974 686f If invoked witho │ │ │ │ -0002a6e0: 7574 206f 7074 696f 6e73 2c20 7468 6973 ut options, this │ │ │ │ -0002a6f0: 2063 6f6d 6d61 6e64 2063 7572 7265 6e74 command current │ │ │ │ -0002a700: 6c79 2062 6568 6176 6573 2061 7320 6966 ly behaves as if │ │ │ │ -0002a710: 2069 740a 2020 2020 2068 6164 2062 6565 it. had bee │ │ │ │ -0002a720: 6e20 696e 766f 6b65 6420 7769 7468 2027 n invoked with ' │ │ │ │ -0002a730: 2d6c 272e 2020 5468 6973 206d 6179 2063 -l'. This may c │ │ │ │ -0002a740: 6861 6e67 6520 696e 2074 6865 2066 7574 hange in the fut │ │ │ │ -0002a750: 7572 652e 0a0a 1f0a 4669 6c65 3a20 6772 ure.....File: gr │ │ │ │ -0002a760: 7562 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ub.info, Node: │ │ │ │ -0002a770: 6372 632c 2020 4e65 7874 3a20 6372 7970 crc, Next: cryp │ │ │ │ -0002a780: 746f 6d6f 756e 742c 2020 5072 6576 3a20 tomount, Prev: │ │ │ │ -0002a790: 6370 7569 642c 2020 5570 3a20 436f 6d6d cpuid, Up: Comm │ │ │ │ -0002a7a0: 616e 642d 6c69 6e65 2061 6e64 206d 656e and-line and men │ │ │ │ -0002a7b0: 7520 656e 7472 7920 636f 6d6d 616e 6473 u entry commands │ │ │ │ -0002a7c0: 0a0a 3136 2e33 2e31 3820 6372 630a 2d2d ..16.3.18 crc.-- │ │ │ │ -0002a7d0: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2043 ---------.. -- C │ │ │ │ -0002a7e0: 6f6d 6d61 6e64 3a20 6372 6320 6172 6720 ommand: crc arg │ │ │ │ -0002a7f0: 2e2e 2e0a 2020 2020 2041 6c69 6173 2066 .... Alias f │ │ │ │ -0002a800: 6f72 2027 6861 7368 7375 6d20 2d2d 6861 or 'hashsum --ha │ │ │ │ -0002a810: 7368 2063 7263 3332 2061 7267 202e 2e2e sh crc32 arg ... │ │ │ │ -0002a820: 272e 2020 5365 6520 636f 6d6d 616e 6420 '. See command │ │ │ │ -0002a830: 2768 6173 6873 756d 270a 2020 2020 2028 'hashsum'. ( │ │ │ │ -0002a840: 2a6e 6f74 6520 6861 7368 7375 6d3a 3a29 *note hashsum::) │ │ │ │ -0002a850: 2066 6f72 2066 756c 6c20 6465 7363 7269 for full descri │ │ │ │ -0002a860: 7074 696f 6e2e 0a0a 1f0a 4669 6c65 3a20 ption.....File: │ │ │ │ -0002a870: 6772 7562 2e69 6e66 6f2c 2020 4e6f 6465 grub.info, Node │ │ │ │ -0002a880: 3a20 6372 7970 746f 6d6f 756e 742c 2020 : cryptomount, │ │ │ │ -0002a890: 4e65 7874 3a20 6375 746d 656d 2c20 2050 Next: cutmem, P │ │ │ │ -0002a8a0: 7265 763a 2063 7263 2c20 2055 703a 2043 rev: crc, Up: C │ │ │ │ -0002a8b0: 6f6d 6d61 6e64 2d6c 696e 6520 616e 6420 ommand-line and │ │ │ │ -0002a8c0: 6d65 6e75 2065 6e74 7279 2063 6f6d 6d61 menu entry comma │ │ │ │ -0002a8d0: 6e64 730a 0a31 362e 332e 3139 2063 7279 nds..16.3.19 cry │ │ │ │ -0002a8e0: 7074 6f6d 6f75 6e74 0a2d 2d2d 2d2d 2d2d ptomount.------- │ │ │ │ -0002a8f0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d ------------.. - │ │ │ │ -0002a900: 2d20 436f 6d6d 616e 643a 2063 7279 7074 - Command: crypt │ │ │ │ -0002a910: 6f6d 6f75 6e74 2064 6576 6963 657c 272d omount device|'- │ │ │ │ -0002a920: 7527 2075 7569 647c 272d 6127 7c27 2d62 u' uuid|'-a'|'-b │ │ │ │ -0002a930: 270a 2020 2020 2053 6574 7570 2061 6363 '. Setup acc │ │ │ │ -0002a940: 6573 7320 746f 2065 6e63 7279 7074 6564 ess to encrypted │ │ │ │ -0002a950: 2064 6576 6963 652e 2020 4966 206e 6563 device. If nec │ │ │ │ -0002a960: 6573 7361 7279 2c20 7061 7373 7068 7261 essary, passphra │ │ │ │ -0002a970: 7365 2069 730a 2020 2020 2072 6571 7565 se is. reque │ │ │ │ -0002a980: 7374 6564 2069 6e74 6572 6163 7469 7665 sted interactive │ │ │ │ -0002a990: 6c79 2e20 204f 7074 696f 6e20 4445 5649 ly. Option DEVI │ │ │ │ -0002a9a0: 4345 2063 6f6e 6669 6775 7265 7320 7370 CE configures sp │ │ │ │ -0002a9b0: 6563 6966 6963 2067 7275 620a 2020 2020 ecific grub. │ │ │ │ -0002a9c0: 2064 6576 6963 6520 282a 6e6f 7465 204e device (*note N │ │ │ │ -0002a9d0: 616d 696e 6720 636f 6e76 656e 7469 6f6e aming convention │ │ │ │ -0002a9e0: 3a3a 293b 206f 7074 696f 6e20 272d 7527 ::); option '-u' │ │ │ │ -0002a9f0: 2055 5549 4420 636f 6e66 6967 7572 6573 UUID configures │ │ │ │ -0002aa00: 0a20 2020 2020 6465 7669 6365 2077 6974 . device wit │ │ │ │ -0002aa10: 6820 7370 6563 6966 6965 6420 5555 4944 h specified UUID │ │ │ │ -0002aa20: 3b20 6f70 7469 6f6e 2027 2d61 2720 636f ; option '-a' co │ │ │ │ -0002aa30: 6e66 6967 7572 6573 2061 6c6c 2064 6574 nfigures all det │ │ │ │ -0002aa40: 6563 7465 640a 2020 2020 2065 6e63 7279 ected. encry │ │ │ │ -0002aa50: 7074 6564 2064 6576 6963 6573 3b20 6f70 pted devices; op │ │ │ │ -0002aa60: 7469 6f6e 2027 2d62 2720 636f 6e66 6967 tion '-b' config │ │ │ │ -0002aa70: 7572 6573 2061 6c6c 2067 656c 6920 636f ures all geli co │ │ │ │ -0002aa80: 6e74 6169 6e65 7273 2074 6861 740a 2020 ntainers that. │ │ │ │ -0002aa90: 2020 2068 6176 6520 626f 6f74 2066 6c61 have boot fla │ │ │ │ -0002aaa0: 6720 7365 742e 0a0a 2020 2020 2047 5255 g set... GRU │ │ │ │ -0002aab0: 4220 7375 706f 7274 7320 6465 7669 6365 B suports device │ │ │ │ -0002aac0: 7320 656e 6372 7970 7465 6420 7573 696e s encrypted usin │ │ │ │ -0002aad0: 6720 4c55 4b53 2061 6e64 2067 656c 692e g LUKS and geli. │ │ │ │ -0002aae0: 2020 4e6f 7465 2074 6861 740a 2020 2020 Note that. │ │ │ │ -0002aaf0: 206e 6563 6573 7361 7279 206d 6f64 756c necessary modul │ │ │ │ -0002ab00: 6573 2028 4c55 4b53 2061 6e64 2047 454c es (LUKS and GEL │ │ │ │ -0002ab10: 4929 2068 6176 6520 746f 2062 6520 6c6f I) have to be lo │ │ │ │ -0002ab20: 6164 6564 206d 616e 7561 6c6c 7920 6265 aded manually be │ │ │ │ -0002ab30: 666f 7265 0a20 2020 2020 7468 6973 2063 fore. this c │ │ │ │ -0002ab40: 6f6d 6d61 6e64 2063 616e 2062 6520 7573 ommand can be us │ │ │ │ -0002ab50: 6564 2e0a 0a1f 0a46 696c 653a 2067 7275 ed.....File: gru │ │ │ │ -0002ab60: 622e 696e 666f 2c20 204e 6f64 653a 2063 b.info, Node: c │ │ │ │ -0002ab70: 7574 6d65 6d2c 2020 4e65 7874 3a20 6461 utmem, Next: da │ │ │ │ -0002ab80: 7465 2c20 2050 7265 763a 2063 7279 7074 te, Prev: crypt │ │ │ │ -0002ab90: 6f6d 6f75 6e74 2c20 2055 703a 2043 6f6d omount, Up: Com │ │ │ │ -0002aba0: 6d61 6e64 2d6c 696e 6520 616e 6420 6d65 mand-line and me │ │ │ │ -0002abb0: 6e75 2065 6e74 7279 2063 6f6d 6d61 6e64 nu entry command │ │ │ │ -0002abc0: 730a 0a31 362e 332e 3230 2063 7574 6d65 s..16.3.20 cutme │ │ │ │ -0002abd0: 6d0a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d m.-------------- │ │ │ │ -0002abe0: 0a0a 202d 2d20 436f 6d6d 616e 643a 2063 .. -- Command: c │ │ │ │ -0002abf0: 7574 6d65 6d20 6672 6f6d 5b4b 7c4d 7c47 utmem from[K|M|G │ │ │ │ -0002ac00: 5d20 746f 5b4b 7c4d 7c47 5d0a 2020 2020 ] to[K|M|G]. │ │ │ │ -0002ac10: 2052 656d 6f76 6520 616e 7920 6d65 6d6f Remove any memo │ │ │ │ -0002ac20: 7279 2072 6567 696f 6e73 2069 6e20 7370 ry regions in sp │ │ │ │ -0002ac30: 6563 6966 6965 6420 7261 6e67 652e 0a0a ecified range... │ │ │ │ -0002ac40: 2020 2054 6869 7320 636f 6d6d 616e 6420 This command │ │ │ │ -0002ac50: 6e6f 7469 6669 6573 2074 6865 206d 656d notifies the mem │ │ │ │ -0002ac60: 6f72 7920 6d61 6e61 6765 7220 7468 6174 ory manager that │ │ │ │ -0002ac70: 2073 7065 6369 6669 6564 2072 6567 696f specified regio │ │ │ │ -0002ac80: 6e73 206f 660a 5241 4d20 6f75 6768 7420 ns of.RAM ought │ │ │ │ -0002ac90: 746f 2062 6520 6669 6c74 6572 6564 206f to be filtered o │ │ │ │ -0002aca0: 7574 2e20 2054 6869 7320 7265 6d61 696e ut. This remain │ │ │ │ -0002acb0: 7320 696e 2065 6666 6563 7420 6166 7465 s in effect afte │ │ │ │ -0002acc0: 7220 6120 7061 796c 6f61 640a 6b65 726e r a payload.kern │ │ │ │ -0002acd0: 656c 2068 6173 2062 6565 6e20 6c6f 6164 el has been load │ │ │ │ -0002ace0: 6564 2062 7920 4752 5542 2c20 6173 206c ed by GRUB, as l │ │ │ │ -0002acf0: 6f6e 6720 6173 2074 6865 206c 6f61 6465 ong as the loade │ │ │ │ -0002ad00: 6420 6b65 726e 656c 206f 6274 6169 6e73 d kernel obtains │ │ │ │ -0002ad10: 2069 7473 0a6d 656d 6f72 7920 6d61 7020 its.memory map │ │ │ │ -0002ad20: 6672 6f6d 2047 5255 422e 204b 6572 6e65 from GRUB. Kerne │ │ │ │ -0002ad30: 6c73 2074 6861 7420 7375 7070 6f72 7420 ls that support │ │ │ │ -0002ad40: 7468 6973 2069 6e63 6c75 6465 204c 696e this include Lin │ │ │ │ -0002ad50: 7578 2c20 474e 5520 4d61 6368 2c0a 7468 ux, GNU Mach,.th │ │ │ │ -0002ad60: 6520 6b65 726e 656c 206f 6620 4672 6565 e kernel of Free │ │ │ │ -0002ad70: 4253 4420 616e 6420 4d75 6c74 6962 6f6f BSD and Multiboo │ │ │ │ -0002ad80: 7420 6b65 726e 656c 7320 696e 2067 656e t kernels in gen │ │ │ │ -0002ad90: 6572 616c 2e0a 0a20 2020 5468 6520 636f eral... The co │ │ │ │ -0002ada0: 6d6d 616e 6420 6973 2073 696d 696c 6172 mmand is similar │ │ │ │ -0002adb0: 2074 6f20 2762 6164 7261 6d27 2063 6f6d to 'badram' com │ │ │ │ -0002adc0: 6d61 6e64 2e0a 0a20 2020 4e6f 7465 3a20 mand... Note: │ │ │ │ -0002add0: 5468 6520 636f 6d6d 616e 6420 6973 206e The command is n │ │ │ │ -0002ade0: 6f74 2061 6c6c 6f77 6564 2077 6865 6e20 ot allowed when │ │ │ │ -0002adf0: 6c6f 636b 646f 776e 2069 7320 656e 666f lockdown is enfo │ │ │ │ -0002ae00: 7263 6564 2028 2a6e 6f74 650a 4c6f 636b rced (*note.Lock │ │ │ │ -0002ae10: 646f 776e 3a3a 292e 2020 5468 6973 2070 down::). This p │ │ │ │ -0002ae20: 7265 7665 6e74 7320 7265 6d6f 7669 6e67 revents removing │ │ │ │ -0002ae30: 2045 4649 206d 656d 6f72 7920 7265 6769 EFI memory regi │ │ │ │ -0002ae40: 6f6e 7320 746f 2070 6f74 656e 7469 616c ons to potential │ │ │ │ -0002ae50: 6c79 0a73 7562 7665 7274 2074 6865 2073 ly.subvert the s │ │ │ │ -0002ae60: 6563 7572 6974 7920 6d65 6368 616e 6973 ecurity mechanis │ │ │ │ -0002ae70: 6d73 2070 726f 7669 6465 6420 6279 2074 ms provided by t │ │ │ │ -0002ae80: 6865 2055 4546 4920 7365 6375 7265 2062 he UEFI secure b │ │ │ │ -0002ae90: 6f6f 742e 0a0a 1f0a 4669 6c65 3a20 6772 oot.....File: gr │ │ │ │ -0002aea0: 7562 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ub.info, Node: │ │ │ │ -0002aeb0: 6461 7465 2c20 204e 6578 743a 2064 6576 date, Next: dev │ │ │ │ -0002aec0: 6963 6574 7265 652c 2020 5072 6576 3a20 icetree, Prev: │ │ │ │ -0002aed0: 6375 746d 656d 2c20 2055 703a 2043 6f6d cutmem, Up: Com │ │ │ │ -0002aee0: 6d61 6e64 2d6c 696e 6520 616e 6420 6d65 mand-line and me │ │ │ │ -0002aef0: 6e75 2065 6e74 7279 2063 6f6d 6d61 6e64 nu entry command │ │ │ │ -0002af00: 730a 0a31 362e 332e 3231 2064 6174 650a s..16.3.21 date. │ │ │ │ -0002af10: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d ------------.. - │ │ │ │ -0002af20: 2d20 436f 6d6d 616e 643a 2064 6174 6520 - Command: date │ │ │ │ -0002af30: 5b5b 7965 6172 2d5d 6d6f 6e74 682d 6461 [[year-]month-da │ │ │ │ -0002af40: 795d 205b 686f 7572 3a6d 696e 7574 655b y] [hour:minute[ │ │ │ │ -0002af50: 3a73 6563 6f6e 645d 5d0a 2020 2020 2057 :second]]. W │ │ │ │ -0002af60: 6974 6820 6e6f 2061 7267 756d 656e 7473 ith no arguments │ │ │ │ -0002af70: 2c20 7072 696e 7420 7468 6520 6375 7272 , print the curr │ │ │ │ -0002af80: 656e 7420 6461 7465 2061 6e64 2074 696d ent date and tim │ │ │ │ -0002af90: 652e 0a0a 2020 2020 204f 7468 6572 7769 e... Otherwi │ │ │ │ -0002afa0: 7365 2c20 7461 6b65 2074 6865 2063 7572 se, take the cur │ │ │ │ -0002afb0: 7265 6e74 2064 6174 6520 616e 6420 7469 rent date and ti │ │ │ │ -0002afc0: 6d65 2c20 6368 616e 6765 2061 6e79 2065 me, change any e │ │ │ │ -0002afd0: 6c65 6d65 6e74 730a 2020 2020 2073 7065 lements. spe │ │ │ │ -0002afe0: 6369 6669 6564 2061 7320 6172 6775 6d65 cified as argume │ │ │ │ -0002aff0: 6e74 732c 2061 6e64 2073 6574 2074 6865 nts, and set the │ │ │ │ -0002b000: 2072 6573 756c 7420 6173 2074 6865 206e result as the n │ │ │ │ -0002b010: 6577 2064 6174 6520 616e 640a 2020 2020 ew date and. │ │ │ │ -0002b020: 2074 696d 652e 2020 466f 7220 6578 616d time. For exam │ │ │ │ -0002b030: 706c 652c 2027 6461 7465 2030 312d 3031 ple, 'date 01-01 │ │ │ │ -0002b040: 2720 7769 6c6c 2073 6574 2074 6865 2063 ' will set the c │ │ │ │ -0002b050: 7572 7265 6e74 206d 6f6e 7468 2061 6e64 urrent month and │ │ │ │ -0002b060: 2064 6179 0a20 2020 2020 746f 204a 616e day. to Jan │ │ │ │ -0002b070: 7561 7279 2031 2c20 6275 7420 6c65 6176 uary 1, but leav │ │ │ │ -0002b080: 6520 7468 6520 7965 6172 2c20 686f 7572 e the year, hour │ │ │ │ -0002b090: 2c20 6d69 6e75 7465 2c20 616e 6420 7365 , minute, and se │ │ │ │ -0002b0a0: 636f 6e64 0a20 2020 2020 756e 6368 616e cond. unchan │ │ │ │ -0002b0b0: 6765 642e 0a0a 1f0a 4669 6c65 3a20 6772 ged.....File: gr │ │ │ │ -0002b0c0: 7562 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ub.info, Node: │ │ │ │ -0002b0d0: 6465 7669 6365 7472 6565 2c20 204e 6578 devicetree, Nex │ │ │ │ -0002b0e0: 743a 2064 6973 7472 7573 742c 2020 5072 t: distrust, Pr │ │ │ │ -0002b0f0: 6576 3a20 6461 7465 2c20 2055 703a 2043 ev: date, Up: C │ │ │ │ -0002b100: 6f6d 6d61 6e64 2d6c 696e 6520 616e 6420 ommand-line and │ │ │ │ -0002b110: 6d65 6e75 2065 6e74 7279 2063 6f6d 6d61 menu entry comma │ │ │ │ -0002b120: 6e64 730a 0a31 362e 332e 3232 206c 696e nds..16.3.22 lin │ │ │ │ -0002b130: 7578 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ux.------------- │ │ │ │ -0002b140: 0a0a 202d 2d20 436f 6d6d 616e 643a 2064 .. -- Command: d │ │ │ │ -0002b150: 6576 6963 6574 7265 6520 6669 6c65 0a20 evicetree file. │ │ │ │ -0002b160: 2020 2020 4c6f 6164 2061 2064 6576 6963 Load a devic │ │ │ │ -0002b170: 6520 7472 6565 2062 6c6f 6220 282e 6474 e tree blob (.dt │ │ │ │ -0002b180: 6229 2066 726f 6d20 6120 6669 6c65 7379 b) from a filesy │ │ │ │ -0002b190: 7374 656d 2c20 666f 7220 6c61 7465 7220 stem, for later │ │ │ │ -0002b1a0: 7573 6520 6279 0a20 2020 2020 6120 4c69 use by. a Li │ │ │ │ -0002b1b0: 6e75 7820 6b65 726e 656c 2e20 2044 6f65 nux kernel. Doe │ │ │ │ -0002b1c0: 7320 6e6f 7420 7065 7266 6f72 6d20 6d65 s not perform me │ │ │ │ -0002b1d0: 7267 696e 6720 7769 7468 2061 6e79 2064 rging with any d │ │ │ │ -0002b1e0: 6576 6963 6520 7472 6565 0a20 2020 2020 evice tree. │ │ │ │ -0002b1f0: 7375 7070 6c69 6564 2062 7920 6669 726d supplied by firm │ │ │ │ -0002b200: 7761 7265 2c20 6275 7420 7261 7468 6572 ware, but rather │ │ │ │ -0002b210: 2072 6570 6c61 6365 7320 6974 2063 6f6d replaces it com │ │ │ │ -0002b220: 706c 6574 656c 792e 2020 2a6e 6f74 650a pletely. *note. │ │ │ │ -0002b230: 2020 2020 2047 4e55 2f4c 696e 7578 3a3a GNU/Linux:: │ │ │ │ -0002b240: 2e0a 0a20 2020 2020 4e6f 7465 3a20 5468 ... Note: Th │ │ │ │ -0002b250: 6520 636f 6d6d 616e 6420 6973 206e 6f74 e command is not │ │ │ │ -0002b260: 2061 6c6c 6f77 6564 2077 6865 6e20 6c6f allowed when lo │ │ │ │ -0002b270: 636b 646f 776e 2069 7320 656e 666f 7263 ckdown is enforc │ │ │ │ -0002b280: 6564 2028 2a6e 6f74 650a 2020 2020 204c ed (*note. L │ │ │ │ -0002b290: 6f63 6b64 6f77 6e3a 3a29 2e20 2054 6869 ockdown::). Thi │ │ │ │ -0002b2a0: 7320 6973 2064 6f6e 6520 746f 2070 7265 s is done to pre │ │ │ │ -0002b2b0: 7665 6e74 2073 7562 7665 7274 696e 6720 vent subverting │ │ │ │ -0002b2c0: 7661 7269 6f75 7320 7365 6375 7269 7479 various security │ │ │ │ -0002b2d0: 0a20 2020 2020 6d65 6368 616e 6973 6d73 . mechanisms │ │ │ │ -0002b2e0: 2e0a 0a1f 0a46 696c 653a 2067 7275 622e .....File: grub. │ │ │ │ -0002b2f0: 696e 666f 2c20 204e 6f64 653a 2064 6973 info, Node: dis │ │ │ │ -0002b300: 7472 7573 742c 2020 4e65 7874 3a20 6472 trust, Next: dr │ │ │ │ -0002b310: 6976 656d 6170 2c20 2050 7265 763a 2064 ivemap, Prev: d │ │ │ │ -0002b320: 6576 6963 6574 7265 652c 2020 5570 3a20 evicetree, Up: │ │ │ │ -0002b330: 436f 6d6d 616e 642d 6c69 6e65 2061 6e64 Command-line and │ │ │ │ -0002b340: 206d 656e 7520 656e 7472 7920 636f 6d6d menu entry comm │ │ │ │ -0002b350: 616e 6473 0a0a 3136 2e33 2e32 3320 6469 ands..16.3.23 di │ │ │ │ -0002b360: 7374 7275 7374 0a2d 2d2d 2d2d 2d2d 2d2d strust.--------- │ │ │ │ -0002b370: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2043 6f6d -------.. -- Com │ │ │ │ -0002b380: 6d61 6e64 3a20 6469 7374 7275 7374 2070 mand: distrust p │ │ │ │ -0002b390: 7562 6b65 795f 6964 0a20 2020 2020 5265 ubkey_id. Re │ │ │ │ -0002b3a0: 6d6f 7665 2070 7562 6c69 6320 6b65 7920 move public key │ │ │ │ -0002b3b0: 5055 424b 4559 5f49 4420 6672 6f6d 2047 PUBKEY_ID from G │ │ │ │ -0002b3c0: 5255 4227 7320 6b65 7972 696e 6720 6f66 RUB's keyring of │ │ │ │ -0002b3d0: 2074 7275 7374 6564 206b 6579 732e 0a20 trusted keys.. │ │ │ │ -0002b3e0: 2020 2020 5055 424b 4559 5f49 4420 6973 PUBKEY_ID is │ │ │ │ -0002b3f0: 2074 6865 206c 6173 7420 666f 7572 2062 the last four b │ │ │ │ -0002b400: 7974 6573 2028 6569 6768 7420 6865 7861 ytes (eight hexa │ │ │ │ -0002b410: 6465 6369 6d61 6c20 6469 6769 7473 2920 decimal digits) │ │ │ │ -0002b420: 6f66 2074 6865 0a20 2020 2020 4750 4720 of the. GPG │ │ │ │ -0002b430: 7634 206b 6579 2069 642c 2077 6869 6368 v4 key id, which │ │ │ │ -0002b440: 2069 7320 616c 736f 2074 6865 206f 7574 is also the out │ │ │ │ -0002b450: 7075 7420 6f66 2027 6c69 7374 5f74 7275 put of 'list_tru │ │ │ │ -0002b460: 7374 6564 2720 282a 6e6f 7465 0a20 2020 sted' (*note. │ │ │ │ -0002b470: 2020 6c69 7374 5f74 7275 7374 6564 3a3a list_trusted:: │ │ │ │ -0002b480: 292e 2020 4f75 7473 6964 6520 6f66 2047 ). Outside of G │ │ │ │ -0002b490: 5255 422c 2074 6865 206b 6579 2069 6420 RUB, the key id │ │ │ │ -0002b4a0: 6361 6e20 6265 206f 6274 6169 6e65 6420 can be obtained │ │ │ │ -0002b4b0: 7573 696e 670a 2020 2020 2027 6770 6720 using. 'gpg │ │ │ │ -0002b4c0: 2d2d 6669 6e67 6572 7072 696e 7427 292e --fingerprint'). │ │ │ │ -0002b4d0: 2020 5468 6573 6520 6b65 7973 2061 7265 These keys are │ │ │ │ -0002b4e0: 2075 7365 6420 746f 2076 616c 6964 6174 used to validat │ │ │ │ -0002b4f0: 6520 7369 676e 6174 7572 6573 0a20 2020 e signatures. │ │ │ │ -0002b500: 2020 7768 656e 2065 6e76 6972 6f6e 6d65 when environme │ │ │ │ -0002b510: 6e74 2076 6172 6961 626c 6520 2763 6865 nt variable 'che │ │ │ │ -0002b520: 636b 5f73 6967 6e61 7475 7265 7327 2069 ck_signatures' i │ │ │ │ -0002b530: 7320 7365 7420 746f 2027 656e 666f 7263 s set to 'enforc │ │ │ │ -0002b540: 6527 0a20 2020 2020 282a 6e6f 7465 2063 e'. (*note c │ │ │ │ -0002b550: 6865 636b 5f73 6967 6e61 7475 7265 733a heck_signatures: │ │ │ │ -0002b560: 3a29 2c20 616e 6420 6279 2073 6f6d 6520 :), and by some │ │ │ │ -0002b570: 696e 766f 6361 7469 6f6e 7320 6f66 0a20 invocations of. │ │ │ │ -0002b580: 2020 2020 2776 6572 6966 795f 6465 7461 'verify_deta │ │ │ │ -0002b590: 6368 6564 2720 282a 6e6f 7465 2076 6572 ched' (*note ver │ │ │ │ -0002b5a0: 6966 795f 6465 7461 6368 6564 3a3a 292e ify_detached::). │ │ │ │ -0002b5b0: 2020 2a4e 6f74 6520 5573 696e 6720 6469 *Note Using di │ │ │ │ -0002b5c0: 6769 7461 6c0a 2020 2020 2073 6967 6e61 gital. signa │ │ │ │ -0002b5d0: 7475 7265 733a 3a2c 2066 6f72 206d 6f72 tures::, for mor │ │ │ │ -0002b5e0: 6520 696e 666f 726d 6174 696f 6e2e 0a0a e information... │ │ │ │ -0002b5f0: 1f0a 4669 6c65 3a20 6772 7562 2e69 6e66 ..File: grub.inf │ │ │ │ -0002b600: 6f2c 2020 4e6f 6465 3a20 6472 6976 656d o, Node: drivem │ │ │ │ -0002b610: 6170 2c20 204e 6578 743a 2065 6368 6f2c ap, Next: echo, │ │ │ │ -0002b620: 2020 5072 6576 3a20 6469 7374 7275 7374 Prev: distrust │ │ │ │ -0002b630: 2c20 2055 703a 2043 6f6d 6d61 6e64 2d6c , Up: Command-l │ │ │ │ -0002b640: 696e 6520 616e 6420 6d65 6e75 2065 6e74 ine and menu ent │ │ │ │ -0002b650: 7279 2063 6f6d 6d61 6e64 730a 0a31 362e ry commands..16. │ │ │ │ -0002b660: 332e 3234 2064 7269 7665 6d61 700a 2d2d 3.24 drivemap.-- │ │ │ │ -0002b670: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a --------------.. │ │ │ │ -0002b680: 202d 2d20 436f 6d6d 616e 643a 2064 7269 -- Command: dri │ │ │ │ -0002b690: 7665 6d61 7020 272d 6c27 7c27 2d72 277c vemap '-l'|'-r'| │ │ │ │ -0002b6a0: 5b27 2d73 275d 2066 726f 6d5f 6472 6976 ['-s'] from_driv │ │ │ │ -0002b6b0: 6520 746f 5f64 7269 7665 0a20 2020 2020 e to_drive. │ │ │ │ -0002b6c0: 5769 7468 6f75 7420 6f70 7469 6f6e 732c Without options, │ │ │ │ -0002b6d0: 206d 6170 2074 6865 2064 7269 7665 2046 map the drive F │ │ │ │ -0002b6e0: 524f 4d5f 4452 4956 4520 746f 2074 6865 ROM_DRIVE to the │ │ │ │ -0002b6f0: 2064 7269 7665 2054 4f5f 4452 4956 452e drive TO_DRIVE. │ │ │ │ -0002b700: 0a20 2020 2020 5468 6973 2069 7320 6e65 . This is ne │ │ │ │ -0002b710: 6365 7373 6172 7920 7768 656e 2079 6f75 cessary when you │ │ │ │ -0002b720: 2063 6861 696e 2d6c 6f61 6420 736f 6d65 chain-load some │ │ │ │ -0002b730: 206f 7065 7261 7469 6e67 2073 7973 7465 operating syste │ │ │ │ -0002b740: 6d73 2c20 7375 6368 0a20 2020 2020 6173 ms, such. as │ │ │ │ -0002b750: 2044 4f53 2c20 6966 2073 7563 6820 616e DOS, if such an │ │ │ │ -0002b760: 204f 5320 7265 7369 6465 7320 6174 2061 OS resides at a │ │ │ │ -0002b770: 206e 6f6e 2d66 6972 7374 2064 7269 7665 non-first drive │ │ │ │ -0002b780: 2e20 2046 6f72 0a20 2020 2020 636f 6e76 . For. conv │ │ │ │ -0002b790: 656e 6965 6e63 652c 2061 6e79 2070 6172 enience, any par │ │ │ │ -0002b7a0: 7469 7469 6f6e 2073 7566 6669 7820 6f6e tition suffix on │ │ │ │ -0002b7b0: 2074 6865 2064 7269 7665 2069 7320 6967 the drive is ig │ │ │ │ -0002b7c0: 6e6f 7265 642c 2073 6f20 796f 750a 2020 nored, so you. │ │ │ │ -0002b7d0: 2020 2063 616e 2073 6166 656c 7920 7573 can safely us │ │ │ │ -0002b7e0: 6520 247b 726f 6f74 7d20 6173 2061 2064 e ${root} as a d │ │ │ │ -0002b7f0: 7269 7665 2073 7065 6369 6669 6361 7469 rive specificati │ │ │ │ -0002b800: 6f6e 2e0a 0a20 2020 2020 5769 7468 2074 on... With t │ │ │ │ -0002b810: 6865 2027 2d73 2720 6f70 7469 6f6e 2c20 he '-s' option, │ │ │ │ -0002b820: 7065 7266 6f72 6d20 7468 6520 7265 7665 perform the reve │ │ │ │ -0002b830: 7273 6520 6d61 7070 696e 6720 6173 2077 rse mapping as w │ │ │ │ -0002b840: 656c 6c2c 2073 7761 7070 696e 670a 2020 ell, swapping. │ │ │ │ -0002b850: 2020 2074 6865 2074 776f 2064 7269 7665 the two drive │ │ │ │ -0002b860: 732e 0a0a 2020 2020 2057 6974 6820 7468 s... With th │ │ │ │ -0002b870: 6520 272d 6c27 206f 7074 696f 6e2c 206c e '-l' option, l │ │ │ │ -0002b880: 6973 7420 7468 6520 6375 7272 656e 7420 ist the current │ │ │ │ -0002b890: 6d61 7070 696e 6773 2e0a 0a20 2020 2020 mappings... │ │ │ │ -0002b8a0: 5769 7468 2074 6865 2027 2d72 2720 6f70 With the '-r' op │ │ │ │ -0002b8b0: 7469 6f6e 2c20 7265 7365 7420 616c 6c20 tion, reset all │ │ │ │ -0002b8c0: 6d61 7070 696e 6773 2074 6f20 7468 6520 mappings to the │ │ │ │ -0002b8d0: 6465 6661 756c 7420 7661 6c75 6573 2e0a default values.. │ │ │ │ -0002b8e0: 0a20 2020 2020 466f 7220 6578 616d 706c . For exampl │ │ │ │ -0002b8f0: 653a 0a0a 2020 2020 2020 2020 2020 6472 e:.. dr │ │ │ │ -0002b900: 6976 656d 6170 202d 7320 2868 6430 2920 ivemap -s (hd0) │ │ │ │ -0002b910: 2868 6431 290a 0a1f 0a46 696c 653a 2067 (hd1)....File: g │ │ │ │ -0002b920: 7275 622e 696e 666f 2c20 204e 6f64 653a rub.info, Node: │ │ │ │ -0002b930: 2065 6368 6f2c 2020 4e65 7874 3a20 6576 echo, Next: ev │ │ │ │ -0002b940: 616c 2c20 2050 7265 763a 2064 7269 7665 al, Prev: drive │ │ │ │ -0002b950: 6d61 702c 2020 5570 3a20 436f 6d6d 616e map, Up: Comman │ │ │ │ -0002b960: 642d 6c69 6e65 2061 6e64 206d 656e 7520 d-line and menu │ │ │ │ -0002b970: 656e 7472 7920 636f 6d6d 616e 6473 0a0a entry commands.. │ │ │ │ -0002b980: 3136 2e33 2e32 3520 6563 686f 0a2d 2d2d 16.3.25 echo.--- │ │ │ │ -0002b990: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2043 ---------.. -- C │ │ │ │ -0002b9a0: 6f6d 6d61 6e64 3a20 6563 686f 205b 272d ommand: echo ['- │ │ │ │ -0002b9b0: 6e27 5d20 5b27 2d65 275d 2073 7472 696e n'] ['-e'] strin │ │ │ │ -0002b9c0: 6720 2e2e 2e0a 2020 2020 2044 6973 706c g .... Displ │ │ │ │ -0002b9d0: 6179 2074 6865 2072 6571 7565 7374 6564 ay the requested │ │ │ │ -0002b9e0: 2074 6578 7420 616e 642c 2075 6e6c 6573 text and, unles │ │ │ │ -0002b9f0: 7320 7468 6520 272d 6e27 206f 7074 696f s the '-n' optio │ │ │ │ -0002ba00: 6e20 6973 2075 7365 642c 2061 0a20 2020 n is used, a. │ │ │ │ -0002ba10: 2020 7472 6169 6c69 6e67 206e 6577 206c trailing new l │ │ │ │ -0002ba20: 696e 652e 2020 4966 2074 6865 7265 2069 ine. If there i │ │ │ │ -0002ba30: 7320 6d6f 7265 2074 6861 6e20 6f6e 6520 s more than one │ │ │ │ -0002ba40: 7374 7269 6e67 2c20 7468 6579 2061 7265 string, they are │ │ │ │ -0002ba50: 0a20 2020 2020 7365 7061 7261 7465 6420 . separated │ │ │ │ -0002ba60: 6279 2073 7061 6365 7320 696e 2074 6865 by spaces in the │ │ │ │ -0002ba70: 206f 7574 7075 742e 2020 4173 2075 7375 output. As usu │ │ │ │ -0002ba80: 616c 2069 6e20 4752 5542 2063 6f6d 6d61 al in GRUB comma │ │ │ │ -0002ba90: 6e64 732c 0a20 2020 2020 7661 7269 6162 nds,. variab │ │ │ │ -0002baa0: 6c65 7320 6d61 7920 6265 2073 7562 7374 les may be subst │ │ │ │ -0002bab0: 6974 7574 6564 2075 7369 6e67 2027 247b ituted using '${ │ │ │ │ -0002bac0: 7661 727d 272e 0a0a 2020 2020 2054 6865 var}'... The │ │ │ │ -0002bad0: 2027 2d65 2720 6f70 7469 6f6e 2065 6e61 '-e' option ena │ │ │ │ -0002bae0: 626c 6573 2069 6e74 6572 7072 6574 6174 bles interpretat │ │ │ │ -0002baf0: 696f 6e20 6f66 2062 6163 6b73 6c61 7368 ion of backslash │ │ │ │ -0002bb00: 2065 7363 6170 6573 2e20 2054 6865 0a20 escapes. The. │ │ │ │ -0002bb10: 2020 2020 666f 6c6c 6f77 696e 6720 7365 following se │ │ │ │ -0002bb20: 7175 656e 6365 7320 6172 6520 7265 636f quences are reco │ │ │ │ -0002bb30: 676e 6973 6564 3a0a 0a20 2020 2020 275c gnised:.. '\ │ │ │ │ -0002bb40: 5c27 0a20 2020 2020 2020 2020 2062 6163 \'. bac │ │ │ │ -0002bb50: 6b73 6c61 7368 0a0a 2020 2020 2027 5c61 kslash.. '\a │ │ │ │ -0002bb60: 270a 2020 2020 2020 2020 2020 616c 6572 '. aler │ │ │ │ -0002bb70: 7420 2842 454c 290a 0a20 2020 2020 275c t (BEL).. '\ │ │ │ │ -0002bb80: 6327 0a20 2020 2020 2020 2020 2073 7570 c'. sup │ │ │ │ -0002bb90: 7072 6573 7320 7472 6169 6c69 6e67 206e press trailing n │ │ │ │ -0002bba0: 6577 206c 696e 650a 0a20 2020 2020 275c ew line.. '\ │ │ │ │ -0002bbb0: 6627 0a20 2020 2020 2020 2020 2066 6f72 f'. for │ │ │ │ -0002bbc0: 6d20 6665 6564 0a0a 2020 2020 2027 5c6e m feed.. '\n │ │ │ │ -0002bbd0: 270a 2020 2020 2020 2020 2020 6e65 7720 '. new │ │ │ │ -0002bbe0: 6c69 6e65 0a0a 2020 2020 2027 5c72 270a line.. '\r'. │ │ │ │ -0002bbf0: 2020 2020 2020 2020 2020 6361 7272 6961 carria │ │ │ │ -0002bc00: 6765 2072 6574 7572 6e0a 0a20 2020 2020 ge return.. │ │ │ │ -0002bc10: 275c 7427 0a20 2020 2020 2020 2020 2068 '\t'. h │ │ │ │ -0002bc20: 6f72 697a 6f6e 7461 6c20 7461 620a 0a20 orizontal tab.. │ │ │ │ -0002bc30: 2020 2020 275c 7627 0a20 2020 2020 2020 '\v'. │ │ │ │ -0002bc40: 2020 2076 6572 7469 6361 6c20 7461 620a vertical tab. │ │ │ │ -0002bc50: 0a20 2020 2020 5768 656e 2069 6e74 6572 . When inter │ │ │ │ -0002bc60: 7072 6574 696e 6720 6261 636b 736c 6173 preting backslas │ │ │ │ -0002bc70: 6820 6573 6361 7065 732c 2062 6163 6b73 h escapes, backs │ │ │ │ -0002bc80: 6c61 7368 2066 6f6c 6c6f 7765 6420 6279 lash followed by │ │ │ │ -0002bc90: 2061 6e79 0a20 2020 2020 6f74 6865 7220 any. other │ │ │ │ -0002bca0: 6368 6172 6163 7465 7220 7769 6c6c 2070 character will p │ │ │ │ -0002bcb0: 7269 6e74 2074 6861 7420 6368 6172 6163 rint that charac │ │ │ │ -0002bcc0: 7465 722e 0a0a 1f0a 4669 6c65 3a20 6772 ter.....File: gr │ │ │ │ -0002bcd0: 7562 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ub.info, Node: │ │ │ │ -0002bce0: 6576 616c 2c20 204e 6578 743a 2065 7870 eval, Next: exp │ │ │ │ -0002bcf0: 6f72 742c 2020 5072 6576 3a20 6563 686f ort, Prev: echo │ │ │ │ -0002bd00: 2c20 2055 703a 2043 6f6d 6d61 6e64 2d6c , Up: Command-l │ │ │ │ -0002bd10: 696e 6520 616e 6420 6d65 6e75 2065 6e74 ine and menu ent │ │ │ │ -0002bd20: 7279 2063 6f6d 6d61 6e64 730a 0a31 362e ry commands..16. │ │ │ │ -0002bd30: 332e 3236 2065 7661 6c0a 2d2d 2d2d 2d2d 3.26 eval.------ │ │ │ │ -0002bd40: 2d2d 2d2d 2d2d 0a0a 202d 2d20 436f 6d6d ------.. -- Comm │ │ │ │ -0002bd50: 616e 643a 2065 7661 6c20 7374 7269 6e67 and: eval string │ │ │ │ -0002bd60: 202e 2e2e 0a20 2020 2020 436f 6e63 6174 .... Concat │ │ │ │ -0002bd70: 656e 6174 6520 6172 6775 6d65 6e74 7320 enate arguments │ │ │ │ -0002bd80: 746f 6765 7468 6572 2075 7369 6e67 2073 together using s │ │ │ │ -0002bd90: 696e 676c 6520 7370 6163 6520 6173 2073 ingle space as s │ │ │ │ -0002bda0: 6570 6172 6174 6f72 2061 6e64 0a20 2020 eparator and. │ │ │ │ -0002bdb0: 2020 6576 616c 7561 7465 2072 6573 756c evaluate resul │ │ │ │ -0002bdc0: 7420 6173 2073 6571 7565 6e63 6520 6f66 t as sequence of │ │ │ │ -0002bdd0: 2047 5255 4220 636f 6d6d 616e 6473 2e0a GRUB commands.. │ │ │ │ -0002bde0: 0a1f 0a46 696c 653a 2067 7275 622e 696e ...File: grub.in │ │ │ │ -0002bdf0: 666f 2c20 204e 6f64 653a 2065 7870 6f72 fo, Node: expor │ │ │ │ -0002be00: 742c 2020 4e65 7874 3a20 6661 6c73 652c t, Next: false, │ │ │ │ -0002be10: 2020 5072 6576 3a20 6576 616c 2c20 2055 Prev: eval, U │ │ │ │ -0002be20: 703a 2043 6f6d 6d61 6e64 2d6c 696e 6520 p: Command-line │ │ │ │ -0002be30: 616e 6420 6d65 6e75 2065 6e74 7279 2063 and menu entry c │ │ │ │ -0002be40: 6f6d 6d61 6e64 730a 0a31 362e 332e 3237 ommands..16.3.27 │ │ │ │ -0002be50: 2065 7870 6f72 740a 2d2d 2d2d 2d2d 2d2d export.-------- │ │ │ │ -0002be60: 2d2d 2d2d 2d2d 0a0a 202d 2d20 436f 6d6d ------.. -- Comm │ │ │ │ -0002be70: 616e 643a 2065 7870 6f72 7420 656e 7676 and: export envv │ │ │ │ -0002be80: 6172 0a20 2020 2020 4578 706f 7274 2074 ar. Export t │ │ │ │ -0002be90: 6865 2065 6e76 6972 6f6e 6d65 6e74 2076 he environment v │ │ │ │ -0002bea0: 6172 6961 626c 6520 454e 5656 4152 2e20 ariable ENVVAR. │ │ │ │ -0002beb0: 2045 7870 6f72 7465 6420 7661 7269 6162 Exported variab │ │ │ │ -0002bec0: 6c65 7320 6172 650a 2020 2020 2076 6973 les are. vis │ │ │ │ -0002bed0: 6962 6c65 2074 6f20 7375 6273 6964 6961 ible to subsidia │ │ │ │ -0002bee0: 7279 2063 6f6e 6669 6775 7261 7469 6f6e ry configuration │ │ │ │ -0002bef0: 2066 696c 6573 206c 6f61 6465 6420 7573 files loaded us │ │ │ │ -0002bf00: 696e 670a 2020 2020 2027 636f 6e66 6967 ing. 'config │ │ │ │ -0002bf10: 6669 6c65 272e 0a0a 1f0a 4669 6c65 3a20 file'.....File: │ │ │ │ -0002bf20: 6772 7562 2e69 6e66 6f2c 2020 4e6f 6465 grub.info, Node │ │ │ │ -0002bf30: 3a20 6661 6c73 652c 2020 4e65 7874 3a20 : false, Next: │ │ │ │ -0002bf40: 6765 7474 6578 742c 2020 5072 6576 3a20 gettext, Prev: │ │ │ │ -0002bf50: 6578 706f 7274 2c20 2055 703a 2043 6f6d export, Up: Com │ │ │ │ -0002bf60: 6d61 6e64 2d6c 696e 6520 616e 6420 6d65 mand-line and me │ │ │ │ -0002bf70: 6e75 2065 6e74 7279 2063 6f6d 6d61 6e64 nu entry command │ │ │ │ -0002bf80: 730a 0a31 362e 332e 3238 2066 616c 7365 s..16.3.28 false │ │ │ │ -0002bf90: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a .-------------.. │ │ │ │ -0002bfa0: 202d 2d20 436f 6d6d 616e 643a 2066 616c -- Command: fal │ │ │ │ -0002bfb0: 7365 0a20 2020 2020 446f 206e 6f74 6869 se. Do nothi │ │ │ │ -0002bfc0: 6e67 2c20 756e 7375 6363 6573 7366 756c ng, unsuccessful │ │ │ │ -0002bfd0: 6c79 2e20 2054 6869 7320 6973 206d 6169 ly. This is mai │ │ │ │ -0002bfe0: 6e6c 7920 7573 6566 756c 2069 6e20 636f nly useful in co │ │ │ │ -0002bff0: 6e74 726f 6c0a 2020 2020 2063 6f6e 7374 ntrol. const │ │ │ │ -0002c000: 7275 6374 7320 7375 6368 2061 7320 2769 ructs such as 'i │ │ │ │ -0002c010: 6627 2061 6e64 2027 7768 696c 6527 2028 f' and 'while' ( │ │ │ │ -0002c020: 2a6e 6f74 6520 5368 656c 6c2d 6c69 6b65 *note Shell-like │ │ │ │ -0002c030: 2073 6372 6970 7469 6e67 3a3a 292e 0a0a scripting::)... │ │ │ │ -0002c040: 1f0a 4669 6c65 3a20 6772 7562 2e69 6e66 ..File: grub.inf │ │ │ │ -0002c050: 6f2c 2020 4e6f 6465 3a20 6765 7474 6578 o, Node: gettex │ │ │ │ -0002c060: 742c 2020 4e65 7874 3a20 6770 7473 796e t, Next: gptsyn │ │ │ │ -0002c070: 632c 2020 5072 6576 3a20 6661 6c73 652c c, Prev: false, │ │ │ │ -0002c080: 2020 5570 3a20 436f 6d6d 616e 642d 6c69 Up: Command-li │ │ │ │ -0002c090: 6e65 2061 6e64 206d 656e 7520 656e 7472 ne and menu entr │ │ │ │ -0002c0a0: 7920 636f 6d6d 616e 6473 0a0a 3136 2e33 y commands..16.3 │ │ │ │ -0002c0b0: 2e32 3920 6765 7474 6578 740a 2d2d 2d2d .29 gettext.---- │ │ │ │ -0002c0c0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d -----------.. -- │ │ │ │ -0002c0d0: 2043 6f6d 6d61 6e64 3a20 6765 7474 6578 Command: gettex │ │ │ │ -0002c0e0: 7420 7374 7269 6e67 0a20 2020 2020 5472 t string. Tr │ │ │ │ -0002c0f0: 616e 736c 6174 6520 5354 5249 4e47 2069 anslate STRING i │ │ │ │ -0002c100: 6e74 6f20 7468 6520 6375 7272 656e 7420 nto the current │ │ │ │ -0002c110: 6c61 6e67 7561 6765 2e0a 0a20 2020 2020 language... │ │ │ │ -0002c120: 5468 6520 6375 7272 656e 7420 6c61 6e67 The current lang │ │ │ │ -0002c130: 7561 6765 2063 6f64 6520 6973 2073 746f uage code is sto │ │ │ │ -0002c140: 7265 6420 696e 2074 6865 2027 6c61 6e67 red in the 'lang │ │ │ │ -0002c150: 2720 7661 7269 6162 6c65 2069 6e0a 2020 ' variable in. │ │ │ │ -0002c160: 2020 2047 5255 4227 7320 656e 7669 726f GRUB's enviro │ │ │ │ -0002c170: 6e6d 656e 7420 282a 6e6f 7465 206c 616e nment (*note lan │ │ │ │ -0002c180: 673a 3a29 2e20 2054 7261 6e73 6c61 7469 g::). Translati │ │ │ │ -0002c190: 6f6e 2066 696c 6573 2069 6e20 4d4f 2066 on files in MO f │ │ │ │ -0002c1a0: 6f72 6d61 740a 2020 2020 2061 7265 2072 ormat. are r │ │ │ │ -0002c1b0: 6561 6420 6672 6f6d 2027 6c6f 6361 6c65 ead from 'locale │ │ │ │ -0002c1c0: 5f64 6972 2720 282a 6e6f 7465 206c 6f63 _dir' (*note loc │ │ │ │ -0002c1d0: 616c 655f 6469 723a 3a29 2c20 7573 7561 ale_dir::), usua │ │ │ │ -0002c1e0: 6c6c 790a 2020 2020 2027 2f62 6f6f 742f lly. '/boot/ │ │ │ │ -0002c1f0: 6772 7562 2f6c 6f63 616c 6527 2e0a 0a1f grub/locale'.... │ │ │ │ -0002c200: 0a46 696c 653a 2067 7275 622e 696e 666f .File: grub.info │ │ │ │ -0002c210: 2c20 204e 6f64 653a 2067 7074 7379 6e63 , Node: gptsync │ │ │ │ -0002c220: 2c20 204e 6578 743a 2068 616c 742c 2020 , Next: halt, │ │ │ │ -0002c230: 5072 6576 3a20 6765 7474 6578 742c 2020 Prev: gettext, │ │ │ │ -0002c240: 5570 3a20 436f 6d6d 616e 642d 6c69 6e65 Up: Command-line │ │ │ │ -0002c250: 2061 6e64 206d 656e 7520 656e 7472 7920 and menu entry │ │ │ │ -0002c260: 636f 6d6d 616e 6473 0a0a 3136 2e33 2e33 commands..16.3.3 │ │ │ │ -0002c270: 3020 6770 7473 796e 630a 2d2d 2d2d 2d2d 0 gptsync.------ │ │ │ │ -0002c280: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2043 ---------.. -- C │ │ │ │ -0002c290: 6f6d 6d61 6e64 3a20 6770 7473 796e 6320 ommand: gptsync │ │ │ │ -0002c2a0: 6465 7669 6365 205b 7061 7274 6974 696f device [partitio │ │ │ │ -0002c2b0: 6e5b 2b2f 2d5b 7479 7065 5d5d 5d20 2e2e n[+/-[type]]] .. │ │ │ │ -0002c2c0: 2e0a 2020 2020 2044 6973 6b73 2075 7369 .. Disks usi │ │ │ │ -0002c2d0: 6e67 2074 6865 2047 5549 4420 5061 7274 ng the GUID Part │ │ │ │ -0002c2e0: 6974 696f 6e20 5461 626c 6520 2847 5054 ition Table (GPT │ │ │ │ -0002c2f0: 2920 616c 736f 2068 6176 6520 6120 6c65 ) also have a le │ │ │ │ -0002c300: 6761 6379 0a20 2020 2020 4d61 7374 6572 gacy. Master │ │ │ │ -0002c310: 2042 6f6f 7420 5265 636f 7264 2028 4d42 Boot Record (MB │ │ │ │ -0002c320: 5229 2070 6172 7469 7469 6f6e 2074 6162 R) partition tab │ │ │ │ -0002c330: 6c65 2066 6f72 2063 6f6d 7061 7469 6269 le for compatibi │ │ │ │ -0002c340: 6c69 7479 2077 6974 6820 7468 650a 2020 lity with the. │ │ │ │ -0002c350: 2020 2042 494f 5320 616e 6420 7769 7468 BIOS and with │ │ │ │ -0002c360: 206f 6c64 6572 206f 7065 7261 7469 6e67 older operating │ │ │ │ -0002c370: 2073 7973 7465 6d73 2e20 2054 6865 206c systems. The l │ │ │ │ -0002c380: 6567 6163 7920 4d42 5220 6361 6e20 6f6e egacy MBR can on │ │ │ │ -0002c390: 6c79 0a20 2020 2020 7265 7072 6573 656e ly. represen │ │ │ │ -0002c3a0: 7420 6120 6c69 6d69 7465 6420 7375 6273 t a limited subs │ │ │ │ -0002c3b0: 6574 206f 6620 4750 5420 7061 7274 6974 et of GPT partit │ │ │ │ -0002c3c0: 696f 6e20 656e 7472 6965 732e 0a0a 2020 ion entries... │ │ │ │ -0002c3d0: 2020 2054 6869 7320 636f 6d6d 616e 6420 This command │ │ │ │ -0002c3e0: 706f 7075 6c61 7465 7320 7468 6520 6c65 populates the le │ │ │ │ -0002c3f0: 6761 6379 204d 4252 2077 6974 6820 7468 gacy MBR with th │ │ │ │ -0002c400: 6520 7370 6563 6966 6965 6420 5041 5254 e specified PART │ │ │ │ -0002c410: 4954 494f 4e0a 2020 2020 2065 6e74 7269 ITION. entri │ │ │ │ -0002c420: 6573 206f 6e20 4445 5649 4345 2e20 2055 es on DEVICE. U │ │ │ │ -0002c430: 7020 746f 2074 6872 6565 2070 6172 7469 p to three parti │ │ │ │ -0002c440: 7469 6f6e 7320 6d61 7920 6265 2075 7365 tions may be use │ │ │ │ -0002c450: 642e 0a0a 2020 2020 2054 5950 4520 6973 d... TYPE is │ │ │ │ -0002c460: 2061 6e20 4d42 5220 7061 7274 6974 696f an MBR partitio │ │ │ │ -0002c470: 6e20 7479 7065 2063 6f64 653b 2070 7265 n type code; pre │ │ │ │ -0002c480: 6669 7820 7769 7468 2027 3078 2720 6966 fix with '0x' if │ │ │ │ -0002c490: 2079 6f75 2077 616e 7420 746f 0a20 2020 you want to. │ │ │ │ -0002c4a0: 2020 656e 7465 7220 7468 6973 2069 6e20 enter this in │ │ │ │ -0002c4b0: 6865 7861 6465 6369 6d61 6c2e 2020 5468 hexadecimal. Th │ │ │ │ -0002c4c0: 6520 7365 7061 7261 746f 7220 6265 7477 e separator betw │ │ │ │ -0002c4d0: 6565 6e20 5041 5254 4954 494f 4e20 616e een PARTITION an │ │ │ │ -0002c4e0: 640a 2020 2020 2054 5950 4520 6d61 7920 d. TYPE may │ │ │ │ -0002c4f0: 6265 2027 2b27 2074 6f20 6d61 6b65 2074 be '+' to make t │ │ │ │ -0002c500: 6865 2070 6172 7469 7469 6f6e 2061 6374 he partition act │ │ │ │ -0002c510: 6976 652c 206f 7220 272d 2720 746f 206d ive, or '-' to m │ │ │ │ -0002c520: 616b 6520 6974 0a20 2020 2020 696e 6163 ake it. inac │ │ │ │ -0002c530: 7469 7665 3b20 6f6e 6c79 206f 6e65 2070 tive; only one p │ │ │ │ -0002c540: 6172 7469 7469 6f6e 206d 6179 2062 6520 artition may be │ │ │ │ -0002c550: 6163 7469 7665 2e20 2049 6620 626f 7468 active. If both │ │ │ │ -0002c560: 2074 6865 2073 6570 6172 6174 6f72 0a20 the separator. │ │ │ │ -0002c570: 2020 2020 616e 6420 7479 7065 2061 7265 and type are │ │ │ │ -0002c580: 206f 6d69 7474 6564 2c20 7468 656e 2074 omitted, then t │ │ │ │ -0002c590: 6865 2070 6172 7469 7469 6f6e 2077 696c he partition wil │ │ │ │ -0002c5a0: 6c20 6265 2069 6e61 6374 6976 652e 0a0a l be inactive... │ │ │ │ -0002c5b0: 1f0a 4669 6c65 3a20 6772 7562 2e69 6e66 ..File: grub.inf │ │ │ │ -0002c5c0: 6f2c 2020 4e6f 6465 3a20 6861 6c74 2c20 o, Node: halt, │ │ │ │ -0002c5d0: 204e 6578 743a 2068 6173 6873 756d 2c20 Next: hashsum, │ │ │ │ -0002c5e0: 2050 7265 763a 2067 7074 7379 6e63 2c20 Prev: gptsync, │ │ │ │ -0002c5f0: 2055 703a 2043 6f6d 6d61 6e64 2d6c 696e Up: Command-lin │ │ │ │ -0002c600: 6520 616e 6420 6d65 6e75 2065 6e74 7279 e and menu entry │ │ │ │ -0002c610: 2063 6f6d 6d61 6e64 730a 0a31 362e 332e commands..16.3. │ │ │ │ -0002c620: 3331 2068 616c 740a 2d2d 2d2d 2d2d 2d2d 31 halt.-------- │ │ │ │ -0002c630: 2d2d 2d2d 0a0a 202d 2d20 436f 6d6d 616e ----.. -- Comman │ │ │ │ -0002c640: 643a 2068 616c 7420 272d 2d6e 6f2d 6170 d: halt '--no-ap │ │ │ │ -0002c650: 6d27 0a20 2020 2020 5468 6520 636f 6d6d m'. The comm │ │ │ │ -0002c660: 616e 6420 6861 6c74 7320 7468 6520 636f and halts the co │ │ │ │ -0002c670: 6d70 7574 6572 2e20 2049 6620 7468 6520 mputer. If the │ │ │ │ -0002c680: 272d 2d6e 6f2d 6170 6d27 206f 7074 696f '--no-apm' optio │ │ │ │ -0002c690: 6e20 6973 0a20 2020 2020 7370 6563 6966 n is. specif │ │ │ │ -0002c6a0: 6965 642c 206e 6f20 4150 4d20 4249 4f53 ied, no APM BIOS │ │ │ │ -0002c6b0: 2063 616c 6c20 6973 2070 6572 666f 726d call is perform │ │ │ │ -0002c6c0: 6564 2e20 204f 7468 6572 7769 7365 2c20 ed. Otherwise, │ │ │ │ -0002c6d0: 7468 6520 636f 6d70 7574 6572 0a20 2020 the computer. │ │ │ │ -0002c6e0: 2020 6973 2073 6875 7420 646f 776e 2075 is shut down u │ │ │ │ -0002c6f0: 7369 6e67 2041 504d 2e0a 0a1f 0a46 696c sing APM.....Fil │ │ │ │ -0002c700: 653a 2067 7275 622e 696e 666f 2c20 204e e: grub.info, N │ │ │ │ -0002c710: 6f64 653a 2068 6173 6873 756d 2c20 204e ode: hashsum, N │ │ │ │ -0002c720: 6578 743a 2068 656c 702c 2020 5072 6576 ext: help, Prev │ │ │ │ -0002c730: 3a20 6861 6c74 2c20 2055 703a 2043 6f6d : halt, Up: Com │ │ │ │ -0002c740: 6d61 6e64 2d6c 696e 6520 616e 6420 6d65 mand-line and me │ │ │ │ -0002c750: 6e75 2065 6e74 7279 2063 6f6d 6d61 6e64 nu entry command │ │ │ │ -0002c760: 730a 0a31 362e 332e 3332 2068 6173 6873 s..16.3.32 hashs │ │ │ │ -0002c770: 756d 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d um.------------- │ │ │ │ -0002c780: 2d2d 0a0a 202d 2d20 436f 6d6d 616e 643a --.. -- Command: │ │ │ │ -0002c790: 2068 6173 6873 756d 2027 2d2d 6861 7368 hashsum '--hash │ │ │ │ -0002c7a0: 2720 6861 7368 2027 2d2d 6b65 6570 2d67 ' hash '--keep-g │ │ │ │ -0002c7b0: 6f69 6e67 2720 272d 2d75 6e63 6f6d 7072 oing' '--uncompr │ │ │ │ -0002c7c0: 6573 7327 0a20 2020 2020 2020 2020 2027 ess'. ' │ │ │ │ -0002c7d0: 2d2d 6368 6563 6b27 2066 696c 6520 5b27 --check' file [' │ │ │ │ -0002c7e0: 2d2d 7072 6566 6978 2720 6469 725d 7c66 --prefix' dir]|f │ │ │ │ -0002c7f0: 696c 6520 2e2e 2e0a 2020 2020 2043 6f6d ile .... Com │ │ │ │ -0002c800: 7075 7465 206f 7220 7665 7269 6679 2066 pute or verify f │ │ │ │ -0002c810: 696c 6520 6861 7368 6573 2e20 2048 6173 ile hashes. Has │ │ │ │ -0002c820: 6820 7479 7065 2069 7320 7365 6c65 6374 h type is select │ │ │ │ -0002c830: 6564 2077 6974 6820 6f70 7469 6f6e 0a20 ed with option. │ │ │ │ -0002c840: 2020 2020 272d 2d68 6173 6827 2e20 2053 '--hash'. S │ │ │ │ -0002c850: 7570 706f 7274 6564 2068 6173 6865 7320 upported hashes │ │ │ │ -0002c860: 6172 653a 2027 6164 6c65 7233 3227 2c20 are: 'adler32', │ │ │ │ -0002c870: 2763 7263 3634 272c 2027 6372 6333 3227 'crc64', 'crc32' │ │ │ │ -0002c880: 2c0a 2020 2020 2027 6372 6333 3272 6663 ,. 'crc32rfc │ │ │ │ -0002c890: 3135 3130 272c 2027 6372 6332 3472 6663 1510', 'crc24rfc │ │ │ │ -0002c8a0: 3234 3430 272c 2027 6d64 3427 2c20 276d 2440', 'md4', 'm │ │ │ │ -0002c8b0: 6435 272c 2027 7269 7065 6d64 3136 3027 d5', 'ripemd160' │ │ │ │ -0002c8c0: 2c20 2773 6861 3127 2c0a 2020 2020 2027 , 'sha1',. ' │ │ │ │ -0002c8d0: 7368 6132 3234 272c 2027 7368 6132 3536 sha224', 'sha256 │ │ │ │ -0002c8e0: 272c 2027 7368 6135 3132 272c 2027 7368 ', 'sha512', 'sh │ │ │ │ -0002c8f0: 6133 3834 272c 2027 7469 6765 7231 3932 a384', 'tiger192 │ │ │ │ -0002c900: 272c 2027 7469 6765 7227 2c0a 2020 2020 ', 'tiger',. │ │ │ │ -0002c910: 2027 7469 6765 7232 272c 2027 7768 6972 'tiger2', 'whir │ │ │ │ -0002c920: 6c70 6f6f 6c27 2e20 204f 7074 696f 6e20 lpool'. Option │ │ │ │ -0002c930: 272d 2d75 6e63 6f6d 7072 6573 7327 2075 '--uncompress' u │ │ │ │ -0002c940: 6e63 6f6d 7072 6573 7365 7320 6669 6c65 ncompresses file │ │ │ │ -0002c950: 730a 2020 2020 2062 6566 6f72 6520 636f s. before co │ │ │ │ -0002c960: 6d70 7574 696e 6720 6861 7368 2e0a 0a20 mputing hash... │ │ │ │ -0002c970: 2020 2020 5768 656e 206c 6973 7420 6f66 When list of │ │ │ │ -0002c980: 2066 696c 6573 2069 7320 6769 7665 6e2c files is given, │ │ │ │ -0002c990: 2068 6173 6820 6f66 2065 6163 6820 6669 hash of each fi │ │ │ │ -0002c9a0: 6c65 2069 7320 636f 6d70 7574 6564 2061 le is computed a │ │ │ │ -0002c9b0: 6e64 0a20 2020 2020 7072 696e 7465 642c nd. printed, │ │ │ │ -0002c9c0: 2066 6f6c 6c6f 7765 6420 6279 2066 696c followed by fil │ │ │ │ -0002c9d0: 6520 6e61 6d65 2c20 6561 6368 2066 696c e name, each fil │ │ │ │ -0002c9e0: 6520 6f6e 2061 206e 6577 206c 696e 652e e on a new line. │ │ │ │ -0002c9f0: 0a0a 2020 2020 2057 6865 6e20 6f70 7469 .. When opti │ │ │ │ -0002ca00: 6f6e 2027 2d2d 6368 6563 6b27 2069 7320 on '--check' is │ │ │ │ -0002ca10: 6769 7665 6e2c 2069 7420 706f 696e 7473 given, it points │ │ │ │ -0002ca20: 2074 6f20 6120 6669 6c65 2074 6861 7420 to a file that │ │ │ │ -0002ca30: 636f 6e74 6169 6e73 0a20 2020 2020 6c69 contains. li │ │ │ │ -0002ca40: 7374 206f 6620 4841 5348 204e 414d 4520 st of HASH NAME │ │ │ │ -0002ca50: 7061 6972 7320 696e 2074 6865 2073 616d pairs in the sam │ │ │ │ -0002ca60: 6520 666f 726d 6174 2061 7320 7573 6564 e format as used │ │ │ │ -0002ca70: 2062 7920 554e 4958 2027 6d64 3573 756d by UNIX 'md5sum │ │ │ │ -0002ca80: 270a 2020 2020 2063 6f6d 6d61 6e64 2e20 '. command. │ │ │ │ -0002ca90: 204f 7074 696f 6e20 272d 2d70 7265 6669 Option '--prefi │ │ │ │ -0002caa0: 7827 206d 6179 2062 6520 7573 6564 2074 x' may be used t │ │ │ │ -0002cab0: 6f20 6769 7665 2064 6972 6563 746f 7279 o give directory │ │ │ │ -0002cac0: 2077 6865 7265 0a20 2020 2020 6669 6c65 where. file │ │ │ │ -0002cad0: 7320 6172 6520 6c6f 6361 7465 642e 2020 s are located. │ │ │ │ -0002cae0: 4861 7368 2076 6572 6966 6963 6174 696f Hash verificatio │ │ │ │ -0002caf0: 6e20 7374 6f70 7320 6166 7465 7220 7468 n stops after th │ │ │ │ -0002cb00: 6520 6669 7273 740a 2020 2020 206d 6973 e first. mis │ │ │ │ -0002cb10: 6d61 7463 6820 7761 7320 666f 756e 6420 match was found │ │ │ │ -0002cb20: 756e 6c65 7373 206f 7074 696f 6e20 272d unless option '- │ │ │ │ -0002cb30: 2d6b 6565 702d 676f 696e 6727 2077 6173 -keep-going' was │ │ │ │ -0002cb40: 2067 6976 656e 2e20 2054 6865 0a20 2020 given. The. │ │ │ │ -0002cb50: 2020 6578 6974 2063 6f64 6520 2724 3f27 exit code '$?' │ │ │ │ -0002cb60: 2069 7320 7365 7420 746f 2030 2069 6620 is set to 0 if │ │ │ │ -0002cb70: 6861 7368 2076 6572 6966 6963 6174 696f hash verificatio │ │ │ │ -0002cb80: 6e20 6973 2073 7563 6365 7373 6675 6c2e n is successful. │ │ │ │ -0002cb90: 2020 4966 0a20 2020 2020 6974 2066 6169 If. it fai │ │ │ │ -0002cba0: 6c73 2c20 2724 3f27 2069 7320 7365 7420 ls, '$?' is set │ │ │ │ -0002cbb0: 746f 2061 206e 6f6e 7a65 726f 2076 616c to a nonzero val │ │ │ │ -0002cbc0: 7565 2e0a 0a1f 0a46 696c 653a 2067 7275 ue.....File: gru │ │ │ │ -0002cbd0: 622e 696e 666f 2c20 204e 6f64 653a 2068 b.info, Node: h │ │ │ │ -0002cbe0: 656c 702c 2020 4e65 7874 3a20 696e 6974 elp, Next: init │ │ │ │ -0002cbf0: 7264 2c20 2050 7265 763a 2068 6173 6873 rd, Prev: hashs │ │ │ │ -0002cc00: 756d 2c20 2055 703a 2043 6f6d 6d61 6e64 um, Up: Command │ │ │ │ -0002cc10: 2d6c 696e 6520 616e 6420 6d65 6e75 2065 -line and menu e │ │ │ │ -0002cc20: 6e74 7279 2063 6f6d 6d61 6e64 730a 0a31 ntry commands..1 │ │ │ │ -0002cc30: 362e 332e 3333 2068 656c 700a 2d2d 2d2d 6.3.33 help.---- │ │ │ │ -0002cc40: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 436f --------.. -- Co │ │ │ │ -0002cc50: 6d6d 616e 643a 2068 656c 7020 5b70 6174 mmand: help [pat │ │ │ │ -0002cc60: 7465 726e 202e 2e2e 5d0a 2020 2020 2044 tern ...]. D │ │ │ │ -0002cc70: 6973 706c 6179 2068 656c 7066 756c 2069 isplay helpful i │ │ │ │ -0002cc80: 6e66 6f72 6d61 7469 6f6e 2061 626f 7574 nformation about │ │ │ │ -0002cc90: 2062 7569 6c74 696e 2063 6f6d 6d61 6e64 builtin command │ │ │ │ -0002cca0: 732e 2020 4966 2079 6f75 2064 6f20 6e6f s. If you do no │ │ │ │ -0002ccb0: 740a 2020 2020 2073 7065 6369 6679 2050 t. specify P │ │ │ │ -0002ccc0: 4154 5445 524e 2c20 7468 6973 2063 6f6d ATTERN, this com │ │ │ │ -0002ccd0: 6d61 6e64 2073 686f 7773 2073 686f 7274 mand shows short │ │ │ │ -0002cce0: 2064 6573 6372 6970 7469 6f6e 7320 6f66 descriptions of │ │ │ │ -0002ccf0: 2061 6c6c 0a20 2020 2020 6176 6169 6c61 all. availa │ │ │ │ -0002cd00: 626c 6520 636f 6d6d 616e 6473 2e0a 0a20 ble commands... │ │ │ │ -0002cd10: 2020 2020 4966 2079 6f75 2073 7065 6369 If you speci │ │ │ │ -0002cd20: 6679 2061 6e79 2050 4154 5445 524e 532c fy any PATTERNS, │ │ │ │ -0002cd30: 2069 7420 6469 7370 6c61 7973 206c 6f6e it displays lon │ │ │ │ -0002cd40: 6765 7220 696e 666f 726d 6174 696f 6e20 ger information │ │ │ │ -0002cd50: 6162 6f75 740a 2020 2020 2065 6163 6820 about. each │ │ │ │ -0002cd60: 6f66 2074 6865 2063 6f6d 6d61 6e64 7320 of the commands │ │ │ │ -0002cd70: 7768 6f73 6520 6e61 6d65 7320 6265 6769 whose names begi │ │ │ │ -0002cd80: 6e20 7769 7468 2074 686f 7365 2050 4154 n with those PAT │ │ │ │ -0002cd90: 5445 524e 532e 0a0a 1f0a 4669 6c65 3a20 TERNS.....File: │ │ │ │ -0002cda0: 6772 7562 2e69 6e66 6f2c 2020 4e6f 6465 grub.info, Node │ │ │ │ -0002cdb0: 3a20 696e 6974 7264 2c20 204e 6578 743a : initrd, Next: │ │ │ │ -0002cdc0: 2069 6e69 7472 6431 362c 2020 5072 6576 initrd16, Prev │ │ │ │ -0002cdd0: 3a20 6865 6c70 2c20 2055 703a 2043 6f6d : help, Up: Com │ │ │ │ -0002cde0: 6d61 6e64 2d6c 696e 6520 616e 6420 6d65 mand-line and me │ │ │ │ -0002cdf0: 6e75 2065 6e74 7279 2063 6f6d 6d61 6e64 nu entry command │ │ │ │ -0002ce00: 730a 0a31 362e 332e 3334 2069 6e69 7472 s..16.3.34 initr │ │ │ │ -0002ce10: 640a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d d.-------------- │ │ │ │ -0002ce20: 0a0a 202d 2d20 436f 6d6d 616e 643a 2069 .. -- Command: i │ │ │ │ -0002ce30: 6e69 7472 6420 6669 6c65 0a20 2020 2020 nitrd file. │ │ │ │ -0002ce40: 4c6f 6164 2061 6e20 696e 6974 6961 6c20 Load an initial │ │ │ │ -0002ce50: 7261 6d64 6973 6b20 666f 7220 6120 4c69 ramdisk for a Li │ │ │ │ -0002ce60: 6e75 7820 6b65 726e 656c 2069 6d61 6765 nux kernel image │ │ │ │ -0002ce70: 2c20 616e 6420 7365 7420 7468 650a 2020 , and set the. │ │ │ │ -0002ce80: 2020 2061 7070 726f 7072 6961 7465 2070 appropriate p │ │ │ │ -0002ce90: 6172 616d 6574 6572 7320 696e 2074 6865 arameters in the │ │ │ │ -0002cea0: 204c 696e 7578 2073 6574 7570 2061 7265 Linux setup are │ │ │ │ -0002ceb0: 6120 696e 206d 656d 6f72 792e 2020 5468 a in memory. Th │ │ │ │ -0002cec0: 6973 206d 6179 0a20 2020 2020 6f6e 6c79 is may. only │ │ │ │ -0002ced0: 2062 6520 7573 6564 2061 6674 6572 2074 be used after t │ │ │ │ -0002cee0: 6865 2027 6c69 6e75 7827 2063 6f6d 6d61 he 'linux' comma │ │ │ │ -0002cef0: 6e64 2028 2a6e 6f74 6520 6c69 6e75 783a nd (*note linux: │ │ │ │ -0002cf00: 3a29 2068 6173 2062 6565 6e0a 2020 2020 :) has been. │ │ │ │ -0002cf10: 2072 756e 2e20 2053 6565 2061 6c73 6f20 run. See also │ │ │ │ -0002cf20: 2a6e 6f74 6520 474e 552f 4c69 6e75 783a *note GNU/Linux: │ │ │ │ -0002cf30: 3a2e 0a0a 1f0a 4669 6c65 3a20 6772 7562 :.....File: grub │ │ │ │ -0002cf40: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 696e .info, Node: in │ │ │ │ -0002cf50: 6974 7264 3136 2c20 204e 6578 743a 2069 itrd16, Next: i │ │ │ │ -0002cf60: 6e73 6d6f 642c 2020 5072 6576 3a20 696e nsmod, Prev: in │ │ │ │ -0002cf70: 6974 7264 2c20 2055 703a 2043 6f6d 6d61 itrd, Up: Comma │ │ │ │ -0002cf80: 6e64 2d6c 696e 6520 616e 6420 6d65 6e75 nd-line and menu │ │ │ │ -0002cf90: 2065 6e74 7279 2063 6f6d 6d61 6e64 730a entry commands. │ │ │ │ -0002cfa0: 0a31 362e 332e 3335 2069 6e69 7472 6431 .16.3.35 initrd1 │ │ │ │ -0002cfb0: 360a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 6.-------------- │ │ │ │ -0002cfc0: 2d2d 0a0a 202d 2d20 436f 6d6d 616e 643a --.. -- Command: │ │ │ │ -0002cfd0: 2069 6e69 7472 6431 3620 6669 6c65 0a20 initrd16 file. │ │ │ │ -0002cfe0: 2020 2020 4c6f 6164 2061 6e20 696e 6974 Load an init │ │ │ │ -0002cff0: 6961 6c20 7261 6d64 6973 6b20 666f 7220 ial ramdisk for │ │ │ │ -0002d000: 6120 4c69 6e75 7820 6b65 726e 656c 2069 a Linux kernel i │ │ │ │ -0002d010: 6d61 6765 2074 6f20 6265 2062 6f6f 7465 mage to be boote │ │ │ │ -0002d020: 6420 696e 0a20 2020 2020 3136 2d62 6974 d in. 16-bit │ │ │ │ -0002d030: 206d 6f64 652c 2061 6e64 2073 6574 2074 mode, and set t │ │ │ │ -0002d040: 6865 2061 7070 726f 7072 6961 7465 2070 he appropriate p │ │ │ │ -0002d050: 6172 616d 6574 6572 7320 696e 2074 6865 arameters in the │ │ │ │ -0002d060: 204c 696e 7578 2073 6574 7570 0a20 2020 Linux setup. │ │ │ │ -0002d070: 2020 6172 6561 2069 6e20 6d65 6d6f 7279 area in memory │ │ │ │ -0002d080: 2e20 2054 6869 7320 6d61 7920 6f6e 6c79 . This may only │ │ │ │ -0002d090: 2062 6520 7573 6564 2061 6674 6572 2074 be used after t │ │ │ │ -0002d0a0: 6865 2027 6c69 6e75 7831 3627 2063 6f6d he 'linux16' com │ │ │ │ -0002d0b0: 6d61 6e64 0a20 2020 2020 282a 6e6f 7465 mand. (*note │ │ │ │ -0002d0c0: 206c 696e 7578 3136 3a3a 2920 6861 7320 linux16::) has │ │ │ │ -0002d0d0: 6265 656e 2072 756e 2e20 2053 6565 2061 been run. See a │ │ │ │ -0002d0e0: 6c73 6f20 2a6e 6f74 6520 474e 552f 4c69 lso *note GNU/Li │ │ │ │ -0002d0f0: 6e75 783a 3a2e 0a0a 2020 2020 2054 6869 nux::... Thi │ │ │ │ -0002d100: 7320 636f 6d6d 616e 6420 6973 206f 6e6c s command is onl │ │ │ │ -0002d110: 7920 6176 6169 6c61 626c 6520 6f6e 2078 y available on x │ │ │ │ -0002d120: 3836 2073 7973 7465 6d73 2e0a 0a1f 0a46 86 systems.....F │ │ │ │ -0002d130: 696c 653a 2067 7275 622e 696e 666f 2c20 ile: grub.info, │ │ │ │ -0002d140: 204e 6f64 653a 2069 6e73 6d6f 642c 2020 Node: insmod, │ │ │ │ -0002d150: 4e65 7874 3a20 6b65 7973 7461 7475 732c Next: keystatus, │ │ │ │ -0002d160: 2020 5072 6576 3a20 696e 6974 7264 3136 Prev: initrd16 │ │ │ │ -0002d170: 2c20 2055 703a 2043 6f6d 6d61 6e64 2d6c , Up: Command-l │ │ │ │ -0002d180: 696e 6520 616e 6420 6d65 6e75 2065 6e74 ine and menu ent │ │ │ │ -0002d190: 7279 2063 6f6d 6d61 6e64 730a 0a31 362e ry commands..16. │ │ │ │ -0002d1a0: 332e 3336 2069 6e73 6d6f 640a 2d2d 2d2d 3.36 insmod.---- │ │ │ │ -0002d1b0: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 ----------.. -- │ │ │ │ -0002d1c0: 436f 6d6d 616e 643a 2069 6e73 6d6f 6420 Command: insmod │ │ │ │ -0002d1d0: 6d6f 6475 6c65 0a20 2020 2020 496e 7365 module. Inse │ │ │ │ -0002d1e0: 7274 2074 6865 2064 796e 616d 6963 2047 rt the dynamic G │ │ │ │ -0002d1f0: 5255 4220 6d6f 6475 6c65 2063 616c 6c65 RUB module calle │ │ │ │ -0002d200: 6420 4d4f 4455 4c45 2e0a 0a1f 0a46 696c d MODULE.....Fil │ │ │ │ -0002d210: 653a 2067 7275 622e 696e 666f 2c20 204e e: grub.info, N │ │ │ │ -0002d220: 6f64 653a 206b 6579 7374 6174 7573 2c20 ode: keystatus, │ │ │ │ -0002d230: 204e 6578 743a 206c 696e 7578 2c20 2050 Next: linux, P │ │ │ │ -0002d240: 7265 763a 2069 6e73 6d6f 642c 2020 5570 rev: insmod, Up │ │ │ │ -0002d250: 3a20 436f 6d6d 616e 642d 6c69 6e65 2061 : Command-line a │ │ │ │ -0002d260: 6e64 206d 656e 7520 656e 7472 7920 636f nd menu entry co │ │ │ │ -0002d270: 6d6d 616e 6473 0a0a 3136 2e33 2e33 3720 mmands..16.3.37 │ │ │ │ -0002d280: 6b65 7973 7461 7475 730a 2d2d 2d2d 2d2d keystatus.------ │ │ │ │ -0002d290: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d -----------.. -- │ │ │ │ -0002d2a0: 2043 6f6d 6d61 6e64 3a20 6b65 7973 7461 Command: keysta │ │ │ │ -0002d2b0: 7475 7320 5b27 2d2d 7368 6966 7427 5d20 tus ['--shift'] │ │ │ │ -0002d2c0: 5b27 2d2d 6374 726c 275d 205b 272d 2d61 ['--ctrl'] ['--a │ │ │ │ -0002d2d0: 6c74 275d 0a20 2020 2020 5265 7475 726e lt']. Return │ │ │ │ -0002d2e0: 2074 7275 6520 6966 2074 6865 2053 6869 true if the Shi │ │ │ │ -0002d2f0: 6674 2c20 436f 6e74 726f 6c2c 206f 7220 ft, Control, or │ │ │ │ -0002d300: 416c 7420 6d6f 6469 6669 6572 206b 6579 Alt modifier key │ │ │ │ -0002d310: 7320 6172 6520 6865 6c64 0a20 2020 2020 s are held. │ │ │ │ -0002d320: 646f 776e 2c20 6173 2072 6571 7565 7374 down, as request │ │ │ │ -0002d330: 6564 2062 7920 6f70 7469 6f6e 732e 2020 ed by options. │ │ │ │ -0002d340: 5468 6973 2069 7320 7573 6566 756c 2069 This is useful i │ │ │ │ -0002d350: 6e20 7363 7269 7074 696e 672c 2074 6f0a n scripting, to. │ │ │ │ -0002d360: 2020 2020 2061 6c6c 6f77 2073 6f6d 6520 allow some │ │ │ │ -0002d370: 7573 6572 2063 6f6e 7472 6f6c 206f 7665 user control ove │ │ │ │ -0002d380: 7220 6265 6861 7669 6f75 7220 7769 7468 r behaviour with │ │ │ │ -0002d390: 6f75 7420 6861 7669 6e67 2074 6f20 7761 out having to wa │ │ │ │ -0002d3a0: 6974 2066 6f72 2061 0a20 2020 2020 6b65 it for a. ke │ │ │ │ -0002d3b0: 7970 7265 7373 2e0a 0a20 2020 2020 4368 ypress... Ch │ │ │ │ -0002d3c0: 6563 6b69 6e67 206b 6579 206d 6f64 6966 ecking key modif │ │ │ │ -0002d3d0: 6965 7220 7374 6174 7573 2069 7320 6f6e ier status is on │ │ │ │ -0002d3e0: 6c79 2073 7570 706f 7274 6564 206f 6e20 ly supported on │ │ │ │ -0002d3f0: 736f 6d65 2070 6c61 7466 6f72 6d73 2e0a some platforms.. │ │ │ │ -0002d400: 2020 2020 2049 6620 696e 766f 6b65 6420 If invoked │ │ │ │ -0002d410: 7769 7468 6f75 7420 616e 7920 6f70 7469 without any opti │ │ │ │ -0002d420: 6f6e 732c 2074 6865 2027 6b65 7973 7461 ons, the 'keysta │ │ │ │ -0002d430: 7475 7327 2063 6f6d 6d61 6e64 2072 6574 tus' command ret │ │ │ │ -0002d440: 7572 6e73 0a20 2020 2020 7472 7565 2069 urns. true i │ │ │ │ -0002d450: 6620 616e 6420 6f6e 6c79 2069 6620 6368 f and only if ch │ │ │ │ -0002d460: 6563 6b69 6e67 206b 6579 206d 6f64 6966 ecking key modif │ │ │ │ -0002d470: 6965 7220 7374 6174 7573 2069 7320 7375 ier status is su │ │ │ │ -0002d480: 7070 6f72 7465 642e 0a0a 1f0a 4669 6c65 pported.....File │ │ │ │ -0002d490: 3a20 6772 7562 2e69 6e66 6f2c 2020 4e6f : grub.info, No │ │ │ │ -0002d4a0: 6465 3a20 6c69 6e75 782c 2020 4e65 7874 de: linux, Next │ │ │ │ -0002d4b0: 3a20 6c69 6e75 7831 362c 2020 5072 6576 : linux16, Prev │ │ │ │ -0002d4c0: 3a20 6b65 7973 7461 7475 732c 2020 5570 : keystatus, Up │ │ │ │ -0002d4d0: 3a20 436f 6d6d 616e 642d 6c69 6e65 2061 : Command-line a │ │ │ │ -0002d4e0: 6e64 206d 656e 7520 656e 7472 7920 636f nd menu entry co │ │ │ │ -0002d4f0: 6d6d 616e 6473 0a0a 3136 2e33 2e33 3820 mmands..16.3.38 │ │ │ │ -0002d500: 6c69 6e75 780a 2d2d 2d2d 2d2d 2d2d 2d2d linux.---------- │ │ │ │ -0002d510: 2d2d 2d0a 0a20 2d2d 2043 6f6d 6d61 6e64 ---.. -- Command │ │ │ │ -0002d520: 3a20 6c69 6e75 7820 6669 6c65 202e 2e2e : linux file ... │ │ │ │ -0002d530: 0a20 2020 2020 4c6f 6164 2061 204c 696e . Load a Lin │ │ │ │ -0002d540: 7578 206b 6572 6e65 6c20 696d 6167 6520 ux kernel image │ │ │ │ -0002d550: 6672 6f6d 2046 494c 452e 2020 5468 6520 from FILE. The │ │ │ │ -0002d560: 7265 7374 206f 6620 7468 6520 6c69 6e65 rest of the line │ │ │ │ -0002d570: 2069 730a 2020 2020 2070 6173 7365 6420 is. passed │ │ │ │ -0002d580: 7665 7262 6174 696d 2061 7320 7468 6520 verbatim as the │ │ │ │ -0002d590: 226b 6572 6e65 6c20 636f 6d6d 616e 642d "kernel command- │ │ │ │ -0002d5a0: 6c69 6e65 222e 2020 416e 7920 696e 6974 line". Any init │ │ │ │ -0002d5b0: 7264 206d 7573 7420 6265 0a20 2020 2020 rd must be. │ │ │ │ -0002d5c0: 7265 6c6f 6164 6564 2061 6674 6572 2075 reloaded after u │ │ │ │ -0002d5d0: 7369 6e67 2074 6869 7320 636f 6d6d 616e sing this comman │ │ │ │ -0002d5e0: 6420 282a 6e6f 7465 2069 6e69 7472 643a d (*note initrd: │ │ │ │ -0002d5f0: 3a29 2e0a 0a20 2020 2020 4f6e 2078 3836 :)... On x86 │ │ │ │ -0002d600: 2073 7973 7465 6d73 2c20 7468 6520 6b65 systems, the ke │ │ │ │ -0002d610: 726e 656c 2077 696c 6c20 6265 2062 6f6f rnel will be boo │ │ │ │ -0002d620: 7465 6420 7573 696e 6720 7468 6520 3332 ted using the 32 │ │ │ │ -0002d630: 2d62 6974 2062 6f6f 740a 2020 2020 2070 -bit boot. p │ │ │ │ -0002d640: 726f 746f 636f 6c2e 2020 4e6f 7465 2074 rotocol. Note t │ │ │ │ -0002d650: 6861 7420 7468 6973 206d 6561 6e73 2074 hat this means t │ │ │ │ -0002d660: 6861 7420 7468 6520 2776 6761 3d27 2062 hat the 'vga=' b │ │ │ │ -0002d670: 6f6f 7420 6f70 7469 6f6e 2077 696c 6c0a oot option will. │ │ │ │ -0002d680: 2020 2020 206e 6f74 2077 6f72 6b3b 2069 not work; i │ │ │ │ -0002d690: 6620 796f 7520 7761 6e74 2074 6f20 7365 f you want to se │ │ │ │ -0002d6a0: 7420 6120 7370 6563 6961 6c20 7669 6465 t a special vide │ │ │ │ -0002d6b0: 6f20 6d6f 6465 2c20 796f 7520 7769 6c6c o mode, you will │ │ │ │ -0002d6c0: 206e 6565 6420 746f 0a20 2020 2020 7573 need to. us │ │ │ │ -0002d6d0: 6520 4752 5542 2063 6f6d 6d61 6e64 7320 e GRUB commands │ │ │ │ -0002d6e0: 7375 6368 2061 7320 2773 6574 2067 6678 such as 'set gfx │ │ │ │ -0002d6f0: 7061 796c 6f61 643d 3130 3234 7837 3638 payload=1024x768 │ │ │ │ -0002d700: 2720 6f72 2027 7365 740a 2020 2020 2067 ' or 'set. g │ │ │ │ -0002d710: 6678 7061 796c 6f61 643d 6b65 6570 2720 fxpayload=keep' │ │ │ │ -0002d720: 2874 6f20 6b65 6570 2074 6865 2073 616d (to keep the sam │ │ │ │ -0002d730: 6520 6d6f 6465 2061 7320 7573 6564 2069 e mode as used i │ │ │ │ -0002d740: 6e20 4752 5542 2920 696e 7374 6561 642e n GRUB) instead. │ │ │ │ -0002d750: 0a20 2020 2020 4752 5542 2063 616e 2061 . GRUB can a │ │ │ │ -0002d760: 7574 6f6d 6174 6963 616c 6c79 2064 6574 utomatically det │ │ │ │ -0002d770: 6563 7420 736f 6d65 2075 7365 7320 6f66 ect some uses of │ │ │ │ -0002d780: 2027 7667 613d 2720 616e 6420 7472 616e 'vga=' and tran │ │ │ │ -0002d790: 736c 6174 650a 2020 2020 2074 6865 6d20 slate. them │ │ │ │ -0002d7a0: 746f 2061 7070 726f 7072 6961 7465 2073 to appropriate s │ │ │ │ -0002d7b0: 6574 7469 6e67 7320 6f66 2027 6766 7870 ettings of 'gfxp │ │ │ │ -0002d7c0: 6179 6c6f 6164 272e 2020 5468 6520 276c ayload'. The 'l │ │ │ │ -0002d7d0: 696e 7578 3136 270a 2020 2020 2063 6f6d inux16'. com │ │ │ │ -0002d7e0: 6d61 6e64 2028 2a6e 6f74 6520 6c69 6e75 mand (*note linu │ │ │ │ -0002d7f0: 7831 363a 3a29 2061 766f 6964 7320 7468 x16::) avoids th │ │ │ │ -0002d800: 6973 2072 6573 7472 6963 7469 6f6e 2e0a is restriction.. │ │ │ │ -0002d810: 0a1f 0a46 696c 653a 2067 7275 622e 696e ...File: grub.in │ │ │ │ -0002d820: 666f 2c20 204e 6f64 653a 206c 696e 7578 fo, Node: linux │ │ │ │ -0002d830: 3136 2c20 204e 6578 743a 206c 6973 745f 16, Next: list_ │ │ │ │ -0002d840: 656e 762c 2020 5072 6576 3a20 6c69 6e75 env, Prev: linu │ │ │ │ -0002d850: 782c 2020 5570 3a20 436f 6d6d 616e 642d x, Up: Command- │ │ │ │ -0002d860: 6c69 6e65 2061 6e64 206d 656e 7520 656e line and menu en │ │ │ │ -0002d870: 7472 7920 636f 6d6d 616e 6473 0a0a 3136 try commands..16 │ │ │ │ -0002d880: 2e33 2e33 3920 6c69 6e75 7831 360a 2d2d .3.39 linux16.-- │ │ │ │ -0002d890: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 -------------.. │ │ │ │ -0002d8a0: 2d2d 2043 6f6d 6d61 6e64 3a20 6c69 6e75 -- Command: linu │ │ │ │ -0002d8b0: 7831 3620 6669 6c65 202e 2e2e 0a20 2020 x16 file .... │ │ │ │ -0002d8c0: 2020 4c6f 6164 2061 204c 696e 7578 206b Load a Linux k │ │ │ │ -0002d8d0: 6572 6e65 6c20 696d 6167 6520 6672 6f6d ernel image from │ │ │ │ -0002d8e0: 2046 494c 4520 696e 2031 362d 6269 7420 FILE in 16-bit │ │ │ │ -0002d8f0: 6d6f 6465 2e20 2054 6865 2072 6573 7420 mode. The rest │ │ │ │ -0002d900: 6f66 0a20 2020 2020 7468 6520 6c69 6e65 of. the line │ │ │ │ -0002d910: 2069 7320 7061 7373 6564 2076 6572 6261 is passed verba │ │ │ │ -0002d920: 7469 6d20 6173 2074 6865 2022 6b65 726e tim as the "kern │ │ │ │ -0002d930: 656c 2063 6f6d 6d61 6e64 2d6c 696e 6522 el command-line" │ │ │ │ -0002d940: 2e20 2041 6e79 0a20 2020 2020 696e 6974 . Any. init │ │ │ │ -0002d950: 7264 206d 7573 7420 6265 2072 656c 6f61 rd must be reloa │ │ │ │ -0002d960: 6465 6420 6166 7465 7220 7573 696e 6720 ded after using │ │ │ │ -0002d970: 7468 6973 2063 6f6d 6d61 6e64 2028 2a6e this command (*n │ │ │ │ -0002d980: 6f74 650a 2020 2020 2069 6e69 7472 6431 ote. initrd1 │ │ │ │ -0002d990: 363a 3a29 2e0a 0a20 2020 2020 5468 6520 6::)... The │ │ │ │ -0002d9a0: 6b65 726e 656c 2077 696c 6c20 6265 2062 kernel will be b │ │ │ │ -0002d9b0: 6f6f 7465 6420 7573 696e 6720 7468 6520 ooted using the │ │ │ │ -0002d9c0: 7472 6164 6974 696f 6e61 6c20 3136 2d62 traditional 16-b │ │ │ │ -0002d9d0: 6974 2062 6f6f 740a 2020 2020 2070 726f it boot. pro │ │ │ │ -0002d9e0: 746f 636f 6c2e 2020 4173 2077 656c 6c20 tocol. As well │ │ │ │ -0002d9f0: 6173 2062 7970 6173 7369 6e67 2070 726f as bypassing pro │ │ │ │ -0002da00: 626c 656d 7320 7769 7468 2027 7667 613d blems with 'vga= │ │ │ │ -0002da10: 2720 6465 7363 7269 6265 6420 696e 0a20 ' described in. │ │ │ │ -0002da20: 2020 2020 2a6e 6f74 6520 6c69 6e75 783a *note linux: │ │ │ │ -0002da30: 3a2c 2074 6869 7320 7065 726d 6974 7320 :, this permits │ │ │ │ -0002da40: 626f 6f74 696e 6720 736f 6d65 206f 7468 booting some oth │ │ │ │ -0002da50: 6572 2070 726f 6772 616d 7320 7468 6174 er programs that │ │ │ │ -0002da60: 0a20 2020 2020 696d 706c 656d 656e 7420 . implement │ │ │ │ -0002da70: 7468 6520 4c69 6e75 7820 626f 6f74 2070 the Linux boot p │ │ │ │ -0002da80: 726f 746f 636f 6c20 666f 7220 7468 6520 rotocol for the │ │ │ │ -0002da90: 7361 6b65 206f 6620 636f 6e76 656e 6965 sake of convenie │ │ │ │ -0002daa0: 6e63 652e 0a0a 2020 2020 2054 6869 7320 nce... This │ │ │ │ -0002dab0: 636f 6d6d 616e 6420 6973 206f 6e6c 7920 command is only │ │ │ │ -0002dac0: 6176 6169 6c61 626c 6520 6f6e 2078 3836 available on x86 │ │ │ │ -0002dad0: 2073 7973 7465 6d73 2e0a 0a1f 0a46 696c systems.....Fil │ │ │ │ -0002dae0: 653a 2067 7275 622e 696e 666f 2c20 204e e: grub.info, N │ │ │ │ -0002daf0: 6f64 653a 206c 6973 745f 656e 762c 2020 ode: list_env, │ │ │ │ -0002db00: 4e65 7874 3a20 6c69 7374 5f74 7275 7374 Next: list_trust │ │ │ │ -0002db10: 6564 2c20 2050 7265 763a 206c 696e 7578 ed, Prev: linux │ │ │ │ -0002db20: 3136 2c20 2055 703a 2043 6f6d 6d61 6e64 16, Up: Command │ │ │ │ -0002db30: 2d6c 696e 6520 616e 6420 6d65 6e75 2065 -line and menu e │ │ │ │ -0002db40: 6e74 7279 2063 6f6d 6d61 6e64 730a 0a31 ntry commands..1 │ │ │ │ -0002db50: 362e 332e 3430 206c 6973 745f 656e 760a 6.3.40 list_env. │ │ │ │ -0002db60: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ -0002db70: 0a0a 202d 2d20 436f 6d6d 616e 643a 206c .. -- Command: l │ │ │ │ -0002db80: 6973 745f 656e 7620 5b27 2d2d 6669 6c65 ist_env ['--file │ │ │ │ -0002db90: 2720 6669 6c65 5d0a 2020 2020 204c 6973 ' file]. Lis │ │ │ │ -0002dba0: 7420 616c 6c20 7661 7269 6162 6c65 7320 t all variables │ │ │ │ -0002dbb0: 696e 2074 6865 2065 6e76 6972 6f6e 6d65 in the environme │ │ │ │ -0002dbc0: 6e74 2062 6c6f 636b 2066 696c 652e 2020 nt block file. │ │ │ │ -0002dbd0: 2a4e 6f74 650a 2020 2020 2045 6e76 6972 *Note. Envir │ │ │ │ -0002dbe0: 6f6e 6d65 6e74 2062 6c6f 636b 3a3a 2e0a onment block::.. │ │ │ │ -0002dbf0: 0a20 2020 2020 5468 6520 272d 2d66 696c . The '--fil │ │ │ │ -0002dc00: 6527 206f 7074 696f 6e20 6f76 6572 7269 e' option overri │ │ │ │ -0002dc10: 6465 7320 7468 6520 6465 6661 756c 7420 des the default │ │ │ │ -0002dc20: 6c6f 6361 7469 6f6e 206f 6620 7468 650a location of the. │ │ │ │ -0002dc30: 2020 2020 2065 6e76 6972 6f6e 6d65 6e74 environment │ │ │ │ -0002dc40: 2062 6c6f 636b 2e0a 0a1f 0a46 696c 653a block.....File: │ │ │ │ -0002dc50: 2067 7275 622e 696e 666f 2c20 204e 6f64 grub.info, Nod │ │ │ │ -0002dc60: 653a 206c 6973 745f 7472 7573 7465 642c e: list_trusted, │ │ │ │ -0002dc70: 2020 4e65 7874 3a20 6c6f 6164 5f65 6e76 Next: load_env │ │ │ │ -0002dc80: 2c20 2050 7265 763a 206c 6973 745f 656e , Prev: list_en │ │ │ │ -0002dc90: 762c 2020 5570 3a20 436f 6d6d 616e 642d v, Up: Command- │ │ │ │ -0002dca0: 6c69 6e65 2061 6e64 206d 656e 7520 656e line and menu en │ │ │ │ -0002dcb0: 7472 7920 636f 6d6d 616e 6473 0a0a 3136 try commands..16 │ │ │ │ -0002dcc0: 2e33 2e34 3120 6c69 7374 5f74 7275 7374 .3.41 list_trust │ │ │ │ -0002dcd0: 6564 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ed.------------- │ │ │ │ -0002dce0: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2043 6f6d -------.. -- Com │ │ │ │ -0002dcf0: 6d61 6e64 3a20 6c69 7374 5f74 7275 7374 mand: list_trust │ │ │ │ -0002dd00: 6564 0a20 2020 2020 4c69 7374 2061 6c6c ed. List all │ │ │ │ -0002dd10: 2070 7562 6c69 6320 6b65 7973 2074 7275 public keys tru │ │ │ │ -0002dd20: 7374 6564 2062 7920 4752 5542 2066 6f72 sted by GRUB for │ │ │ │ -0002dd30: 2076 616c 6964 6174 696e 6720 7369 676e validating sign │ │ │ │ -0002dd40: 6174 7572 6573 2e0a 2020 2020 2054 6865 atures.. The │ │ │ │ -0002dd50: 206f 7574 7075 7420 6973 2069 6e20 4750 output is in GP │ │ │ │ -0002dd60: 4727 7320 7634 206b 6579 2066 696e 6765 G's v4 key finge │ │ │ │ -0002dd70: 7270 7269 6e74 2066 6f72 6d61 7420 2869 rprint format (i │ │ │ │ -0002dd80: 2e65 2e2c 2074 6865 206f 7574 7075 740a .e., the output. │ │ │ │ -0002dd90: 2020 2020 206f 6620 2767 7067 202d 2d66 of 'gpg --f │ │ │ │ -0002dda0: 696e 6765 7270 7269 6e74 2729 2e20 2054 ingerprint'). T │ │ │ │ -0002ddb0: 6865 206c 6561 7374 2073 6967 6e69 6669 he least signifi │ │ │ │ -0002ddc0: 6361 6e74 2066 6f75 7220 6279 7465 7320 cant four bytes │ │ │ │ -0002ddd0: 286c 6173 740a 2020 2020 2065 6967 6874 (last. eight │ │ │ │ -0002dde0: 2068 6578 6164 6563 696d 616c 2064 6967 hexadecimal dig │ │ │ │ -0002ddf0: 6974 7329 2063 616e 2062 6520 7573 6564 its) can be used │ │ │ │ -0002de00: 2061 7320 616e 2061 7267 756d 656e 7420 as an argument │ │ │ │ -0002de10: 746f 2027 6469 7374 7275 7374 270a 2020 to 'distrust'. │ │ │ │ -0002de20: 2020 2028 2a6e 6f74 6520 6469 7374 7275 (*note distru │ │ │ │ -0002de30: 7374 3a3a 292e 2020 2a4e 6f74 6520 5573 st::). *Note Us │ │ │ │ -0002de40: 696e 6720 6469 6769 7461 6c20 7369 676e ing digital sign │ │ │ │ -0002de50: 6174 7572 6573 3a3a 2c20 666f 7220 6d6f atures::, for mo │ │ │ │ -0002de60: 7265 0a20 2020 2020 696e 666f 726d 6174 re. informat │ │ │ │ -0002de70: 696f 6e20 6162 6f75 7420 7573 6573 2066 ion about uses f │ │ │ │ -0002de80: 6f72 2074 6865 7365 206b 6579 732e 0a0a or these keys... │ │ │ │ -0002de90: 1f0a 4669 6c65 3a20 6772 7562 2e69 6e66 ..File: grub.inf │ │ │ │ -0002dea0: 6f2c 2020 4e6f 6465 3a20 6c6f 6164 5f65 o, Node: load_e │ │ │ │ -0002deb0: 6e76 2c20 204e 6578 743a 206c 6f61 6466 nv, Next: loadf │ │ │ │ -0002dec0: 6f6e 742c 2020 5072 6576 3a20 6c69 7374 ont, Prev: list │ │ │ │ -0002ded0: 5f74 7275 7374 6564 2c20 2055 703a 2043 _trusted, Up: C │ │ │ │ -0002dee0: 6f6d 6d61 6e64 2d6c 696e 6520 616e 6420 ommand-line and │ │ │ │ -0002def0: 6d65 6e75 2065 6e74 7279 2063 6f6d 6d61 menu entry comma │ │ │ │ -0002df00: 6e64 730a 0a31 362e 332e 3432 206c 6f61 nds..16.3.42 loa │ │ │ │ -0002df10: 645f 656e 760a 2d2d 2d2d 2d2d 2d2d 2d2d d_env.---------- │ │ │ │ -0002df20: 2d2d 2d2d 2d2d 0a0a 202d 2d20 436f 6d6d ------.. -- Comm │ │ │ │ -0002df30: 616e 643a 206c 6f61 645f 656e 7620 5b27 and: load_env [' │ │ │ │ -0002df40: 2d2d 6669 6c65 2720 6669 6c65 5d20 5b27 --file' file] [' │ │ │ │ -0002df50: 2d2d 736b 6970 2d73 6967 275d 0a20 2020 --skip-sig']. │ │ │ │ -0002df60: 2020 2020 2020 205b 7768 6974 656c 6973 [whitelis │ │ │ │ -0002df70: 7465 645f 7661 7269 6162 6c65 5f6e 616d ted_variable_nam │ │ │ │ -0002df80: 655d 202e 2e2e 0a20 2020 2020 4c6f 6164 e] .... Load │ │ │ │ -0002df90: 2061 6c6c 2076 6172 6961 626c 6573 2066 all variables f │ │ │ │ -0002dfa0: 726f 6d20 7468 6520 656e 7669 726f 6e6d rom the environm │ │ │ │ -0002dfb0: 656e 7420 626c 6f63 6b20 6669 6c65 2069 ent block file i │ │ │ │ -0002dfc0: 6e74 6f20 7468 650a 2020 2020 2065 6e76 nto the. env │ │ │ │ -0002dfd0: 6972 6f6e 6d65 6e74 2e20 202a 4e6f 7465 ironment. *Note │ │ │ │ -0002dfe0: 2045 6e76 6972 6f6e 6d65 6e74 2062 6c6f Environment blo │ │ │ │ -0002dff0: 636b 3a3a 2e0a 0a20 2020 2020 5468 6520 ck::... The │ │ │ │ -0002e000: 272d 2d66 696c 6527 206f 7074 696f 6e20 '--file' option │ │ │ │ -0002e010: 6f76 6572 7269 6465 7320 7468 6520 6465 overrides the de │ │ │ │ -0002e020: 6661 756c 7420 6c6f 6361 7469 6f6e 206f fault location o │ │ │ │ -0002e030: 6620 7468 650a 2020 2020 2065 6e76 6972 f the. envir │ │ │ │ -0002e040: 6f6e 6d65 6e74 2062 6c6f 636b 2e0a 0a20 onment block... │ │ │ │ -0002e050: 2020 2020 5468 6520 272d 2d73 6b69 702d The '--skip- │ │ │ │ -0002e060: 7369 6727 206f 7074 696f 6e20 736b 6970 sig' option skip │ │ │ │ -0002e070: 7320 7369 676e 6174 7572 6520 6368 6563 s signature chec │ │ │ │ -0002e080: 6b69 6e67 2065 7665 6e20 7768 656e 2074 king even when t │ │ │ │ -0002e090: 6865 0a20 2020 2020 7661 6c75 6520 6f66 he. value of │ │ │ │ -0002e0a0: 2065 6e76 6972 6f6e 6d65 6e74 2076 6172 environment var │ │ │ │ -0002e0b0: 6961 626c 6520 2763 6865 636b 5f73 6967 iable 'check_sig │ │ │ │ -0002e0c0: 6e61 7475 7265 7327 2069 7320 7365 7420 natures' is set │ │ │ │ -0002e0d0: 746f 0a20 2020 2020 2765 6e66 6f72 6365 to. 'enforce │ │ │ │ -0002e0e0: 2720 282a 6e6f 7465 2063 6865 636b 5f73 ' (*note check_s │ │ │ │ -0002e0f0: 6967 6e61 7475 7265 733a 3a29 2e0a 0a20 ignatures::)... │ │ │ │ -0002e100: 2020 2020 4966 206f 6e65 206f 7220 6d6f If one or mo │ │ │ │ -0002e110: 7265 2076 6172 6961 626c 6520 6e61 6d65 re variable name │ │ │ │ -0002e120: 7320 6172 6520 7072 6f76 6964 6564 2061 s are provided a │ │ │ │ -0002e130: 7320 6172 6775 6d65 6e74 732c 2074 6865 s arguments, the │ │ │ │ -0002e140: 7920 6172 650a 2020 2020 2069 6e74 6572 y are. inter │ │ │ │ -0002e150: 7072 6574 6564 2061 7320 6120 7768 6974 preted as a whit │ │ │ │ -0002e160: 656c 6973 7420 6f66 2076 6172 6961 626c elist of variabl │ │ │ │ -0002e170: 6573 2074 6f20 6c6f 6164 2066 726f 6d20 es to load from │ │ │ │ -0002e180: 7468 650a 2020 2020 2065 6e76 6972 6f6e the. environ │ │ │ │ -0002e190: 6d65 6e74 2062 6c6f 636b 2066 696c 652e ment block file. │ │ │ │ -0002e1a0: 2020 5661 7269 6162 6c65 7320 7365 7420 Variables set │ │ │ │ -0002e1b0: 696e 2074 6865 2066 696c 6520 6275 7420 in the file but │ │ │ │ -0002e1c0: 6e6f 7420 7072 6573 656e 740a 2020 2020 not present. │ │ │ │ -0002e1d0: 2069 6e20 7468 6520 7768 6974 656c 6973 in the whitelis │ │ │ │ -0002e1e0: 7420 6172 6520 6967 6e6f 7265 642e 0a0a t are ignored... │ │ │ │ -0002e1f0: 2020 2020 2054 6865 2027 2d2d 736b 6970 The '--skip │ │ │ │ -0002e200: 2d73 6967 2720 6f70 7469 6f6e 2073 686f -sig' option sho │ │ │ │ -0002e210: 756c 6420 6265 2075 7365 6420 7769 7468 uld be used with │ │ │ │ -0002e220: 2063 6172 652c 2061 6e64 2073 686f 756c care, and shoul │ │ │ │ -0002e230: 6420 616c 7761 7973 0a20 2020 2020 6265 d always. be │ │ │ │ -0002e240: 2075 7365 6420 696e 2063 6f6e 6365 7274 used in concert │ │ │ │ -0002e250: 2077 6974 6820 6120 7768 6974 656c 6973 with a whitelis │ │ │ │ -0002e260: 7420 6f66 2061 6363 6570 7461 626c 6520 t of acceptable │ │ │ │ -0002e270: 7661 7269 6162 6c65 7320 7768 6f73 650a variables whose. │ │ │ │ -0002e280: 2020 2020 2076 616c 7565 7320 7368 6f75 values shou │ │ │ │ -0002e290: 6c64 2062 6520 7365 742e 2020 4661 696c ld be set. Fail │ │ │ │ -0002e2a0: 7572 6520 746f 2065 6d70 6c6f 7920 6120 ure to employ a │ │ │ │ -0002e2b0: 6361 7265 6675 6c6c 7920 636f 6e73 7472 carefully constr │ │ │ │ -0002e2c0: 7563 7465 640a 2020 2020 2077 6869 7465 ucted. white │ │ │ │ -0002e2d0: 6c69 7374 2063 6f75 6c64 2072 6573 756c list could resul │ │ │ │ -0002e2e0: 7420 696e 2072 6561 6469 6e67 2061 206d t in reading a m │ │ │ │ -0002e2f0: 616c 6963 696f 7573 2076 616c 7565 2069 alicious value i │ │ │ │ -0002e300: 6e74 6f20 6372 6974 6963 616c 0a20 2020 nto critical. │ │ │ │ -0002e310: 2020 656e 7669 726f 6e6d 656e 7420 7661 environment va │ │ │ │ -0002e320: 7269 6162 6c65 7320 6672 6f6d 2074 6865 riables from the │ │ │ │ -0002e330: 2066 696c 652c 2073 7563 6820 6173 2073 file, such as s │ │ │ │ -0002e340: 6574 7469 6e67 0a20 2020 2020 2763 6865 etting. 'che │ │ │ │ -0002e350: 636b 5f73 6967 6e61 7475 7265 733d 6e6f ck_signatures=no │ │ │ │ -0002e360: 272c 206d 6f64 6966 7969 6e67 2027 7072 ', modifying 'pr │ │ │ │ -0002e370: 6566 6978 2720 746f 2062 6f6f 7420 6672 efix' to boot fr │ │ │ │ -0002e380: 6f6d 2061 6e0a 2020 2020 2075 6e65 7870 om an. unexp │ │ │ │ -0002e390: 6563 7465 6420 6c6f 6361 7469 6f6e 206f ected location o │ │ │ │ -0002e3a0: 7220 6e6f 7420 6174 2061 6c6c 2c20 6574 r not at all, et │ │ │ │ -0002e3b0: 632e 0a0a 2020 2020 2057 6865 6e20 7573 c... When us │ │ │ │ -0002e3c0: 6564 2077 6974 6820 6361 7265 2c20 272d ed with care, '- │ │ │ │ -0002e3d0: 2d73 6b69 702d 7369 6727 2061 6e64 2074 -skip-sig' and t │ │ │ │ -0002e3e0: 6865 2077 6869 7465 6c69 7374 2065 6e61 he whitelist ena │ │ │ │ -0002e3f0: 626c 6520 616e 0a20 2020 2020 6164 6d69 ble an. admi │ │ │ │ -0002e400: 6e69 7374 7261 746f 7220 746f 2063 6f6e nistrator to con │ │ │ │ -0002e410: 6669 6775 7265 2061 2073 7973 7465 6d20 figure a system │ │ │ │ -0002e420: 746f 2062 6f6f 7420 6f6e 6c79 2073 6967 to boot only sig │ │ │ │ -0002e430: 6e65 640a 2020 2020 2063 6f6e 6669 6775 ned. configu │ │ │ │ -0002e440: 7261 7469 6f6e 732c 2062 7574 2074 6f20 rations, but to │ │ │ │ -0002e450: 616c 6c6f 7720 7468 6520 7573 6572 2074 allow the user t │ │ │ │ -0002e460: 6f20 7365 6c65 6374 2066 726f 6d20 616d o select from am │ │ │ │ -0002e470: 6f6e 6720 6d75 6c74 6970 6c65 0a20 2020 ong multiple. │ │ │ │ -0002e480: 2020 636f 6e66 6967 7572 6174 696f 6e73 configurations │ │ │ │ -0002e490: 2c20 616e 6420 746f 2065 6e61 626c 6520 , and to enable │ │ │ │ -0002e4a0: 226f 6e65 2d73 686f 7422 2062 6f6f 7420 "one-shot" boot │ │ │ │ -0002e4b0: 6174 7465 6d70 7473 2061 6e64 0a20 2020 attempts and. │ │ │ │ -0002e4c0: 2020 2273 6176 6564 6566 6175 6c74 2220 "savedefault" │ │ │ │ -0002e4d0: 6265 6861 7669 6f72 2e20 202a 4e6f 7465 behavior. *Note │ │ │ │ -0002e4e0: 2055 7369 6e67 2064 6967 6974 616c 2073 Using digital s │ │ │ │ -0002e4f0: 6967 6e61 7475 7265 733a 3a2c 2066 6f72 ignatures::, for │ │ │ │ -0002e500: 206d 6f72 650a 2020 2020 2069 6e66 6f72 more. infor │ │ │ │ -0002e510: 6d61 7469 6f6e 2e0a 0a1f 0a46 696c 653a mation.....File: │ │ │ │ -0002e520: 2067 7275 622e 696e 666f 2c20 204e 6f64 grub.info, Nod │ │ │ │ -0002e530: 653a 206c 6f61 6466 6f6e 742c 2020 4e65 e: loadfont, Ne │ │ │ │ -0002e540: 7874 3a20 6c6f 6f70 6261 636b 2c20 2050 xt: loopback, P │ │ │ │ -0002e550: 7265 763a 206c 6f61 645f 656e 762c 2020 rev: load_env, │ │ │ │ -0002e560: 5570 3a20 436f 6d6d 616e 642d 6c69 6e65 Up: Command-line │ │ │ │ -0002e570: 2061 6e64 206d 656e 7520 656e 7472 7920 and menu entry │ │ │ │ -0002e580: 636f 6d6d 616e 6473 0a0a 3136 2e33 2e34 commands..16.3.4 │ │ │ │ -0002e590: 3320 6c6f 6164 666f 6e74 0a2d 2d2d 2d2d 3 loadfont.----- │ │ │ │ -0002e5a0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d -----------.. -- │ │ │ │ -0002e5b0: 2043 6f6d 6d61 6e64 3a20 6c6f 6164 666f Command: loadfo │ │ │ │ -0002e5c0: 6e74 2066 696c 6520 2e2e 2e0a 2020 2020 nt file .... │ │ │ │ -0002e5d0: 204c 6f61 6420 7370 6563 6966 6965 6420 Load specified │ │ │ │ -0002e5e0: 666f 6e74 2066 696c 6573 2e20 2055 6e6c font files. Unl │ │ │ │ -0002e5f0: 6573 7320 6162 736f 6c75 7465 2070 6174 ess absolute pat │ │ │ │ -0002e600: 686e 616d 6520 6973 2067 6976 656e 2c20 hname is given, │ │ │ │ -0002e610: 4649 4c45 0a20 2020 2020 6973 2061 7373 FILE. is ass │ │ │ │ -0002e620: 756d 6564 2074 6f20 6265 2069 6e20 6469 umed to be in di │ │ │ │ -0002e630: 7265 6374 6f72 7920 2724 7072 6566 6978 rectory '$prefix │ │ │ │ -0002e640: 2f66 6f6e 7473 2720 7769 7468 2073 7566 /fonts' with suf │ │ │ │ -0002e650: 6669 7820 272e 7066 3227 0a20 2020 2020 fix '.pf2'. │ │ │ │ -0002e660: 6170 7065 6e64 6564 2e20 202a 4e6f 7465 appended. *Note │ │ │ │ -0002e670: 2046 6f6e 7473 3a20 5468 656d 6520 6669 Fonts: Theme fi │ │ │ │ -0002e680: 6c65 2066 6f72 6d61 742e 0a0a 1f0a 4669 le format.....Fi │ │ │ │ -0002e690: 6c65 3a20 6772 7562 2e69 6e66 6f2c 2020 le: grub.info, │ │ │ │ -0002e6a0: 4e6f 6465 3a20 6c6f 6f70 6261 636b 2c20 Node: loopback, │ │ │ │ -0002e6b0: 204e 6578 743a 206c 732c 2020 5072 6576 Next: ls, Prev │ │ │ │ -0002e6c0: 3a20 6c6f 6164 666f 6e74 2c20 2055 703a : loadfont, Up: │ │ │ │ -0002e6d0: 2043 6f6d 6d61 6e64 2d6c 696e 6520 616e Command-line an │ │ │ │ -0002e6e0: 6420 6d65 6e75 2065 6e74 7279 2063 6f6d d menu entry com │ │ │ │ -0002e6f0: 6d61 6e64 730a 0a31 362e 332e 3434 206c mands..16.3.44 l │ │ │ │ -0002e700: 6f6f 7062 6163 6b0a 2d2d 2d2d 2d2d 2d2d oopback.-------- │ │ │ │ -0002e710: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 436f --------.. -- Co │ │ │ │ -0002e720: 6d6d 616e 643a 206c 6f6f 7062 6163 6b20 mmand: loopback │ │ │ │ -0002e730: 5b27 2d64 275d 2064 6576 6963 6520 6669 ['-d'] device fi │ │ │ │ -0002e740: 6c65 0a20 2020 2020 4d61 6b65 2074 6865 le. Make the │ │ │ │ -0002e750: 2064 6576 6963 6520 6e61 6d65 6420 4445 device named DE │ │ │ │ -0002e760: 5649 4345 2063 6f72 7265 7370 6f6e 6420 VICE correspond │ │ │ │ -0002e770: 746f 2074 6865 2063 6f6e 7465 6e74 7320 to the contents │ │ │ │ -0002e780: 6f66 2074 6865 0a20 2020 2020 6669 6c65 of the. file │ │ │ │ -0002e790: 7379 7374 656d 2069 6d61 6765 2069 6e20 system image in │ │ │ │ -0002e7a0: 4649 4c45 2e20 2046 6f72 2065 7861 6d70 FILE. For examp │ │ │ │ -0002e7b0: 6c65 3a0a 0a20 2020 2020 2020 2020 206c le:.. l │ │ │ │ -0002e7c0: 6f6f 7062 6163 6b20 6c6f 6f70 3020 2f70 oopback loop0 /p │ │ │ │ -0002e7d0: 6174 682f 746f 2f69 6d61 6765 0a20 2020 ath/to/image. │ │ │ │ -0002e7e0: 2020 2020 2020 206c 7320 286c 6f6f 7030 ls (loop0 │ │ │ │ -0002e7f0: 292f 0a0a 2020 2020 2057 6974 6820 7468 )/.. With th │ │ │ │ -0002e800: 6520 272d 6427 206f 7074 696f 6e2c 2064 e '-d' option, d │ │ │ │ -0002e810: 656c 6574 6520 6120 6465 7669 6365 2070 elete a device p │ │ │ │ -0002e820: 7265 7669 6f75 736c 7920 6372 6561 7465 reviously create │ │ │ │ -0002e830: 6420 7573 696e 6720 7468 6973 0a20 2020 d using this. │ │ │ │ -0002e840: 2020 636f 6d6d 616e 642e 0a0a 1f0a 4669 command.....Fi │ │ │ │ -0002e850: 6c65 3a20 6772 7562 2e69 6e66 6f2c 2020 le: grub.info, │ │ │ │ -0002e860: 4e6f 6465 3a20 6c73 2c20 204e 6578 743a Node: ls, Next: │ │ │ │ -0002e870: 206c 7366 6f6e 7473 2c20 2050 7265 763a lsfonts, Prev: │ │ │ │ -0002e880: 206c 6f6f 7062 6163 6b2c 2020 5570 3a20 loopback, Up: │ │ │ │ -0002e890: 436f 6d6d 616e 642d 6c69 6e65 2061 6e64 Command-line and │ │ │ │ -0002e8a0: 206d 656e 7520 656e 7472 7920 636f 6d6d menu entry comm │ │ │ │ -0002e8b0: 616e 6473 0a0a 3136 2e33 2e34 3520 6c73 ands..16.3.45 ls │ │ │ │ -0002e8c0: 0a2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d .----------.. -- │ │ │ │ -0002e8d0: 2043 6f6d 6d61 6e64 3a20 6c73 205b 6172 Command: ls [ar │ │ │ │ -0002e8e0: 6720 2e2e 2e5d 0a20 2020 2020 4c69 7374 g ...]. List │ │ │ │ -0002e8f0: 2064 6576 6963 6573 206f 7220 6669 6c65 devices or file │ │ │ │ -0002e900: 732e 0a0a 2020 2020 2057 6974 6820 6e6f s... With no │ │ │ │ -0002e910: 2061 7267 756d 656e 7473 2c20 7072 696e arguments, prin │ │ │ │ -0002e920: 7420 616c 6c20 6465 7669 6365 7320 6b6e t all devices kn │ │ │ │ -0002e930: 6f77 6e20 746f 2047 5255 422e 0a0a 2020 own to GRUB... │ │ │ │ -0002e940: 2020 2049 6620 7468 6520 6172 6775 6d65 If the argume │ │ │ │ -0002e950: 6e74 2069 7320 6120 6465 7669 6365 206e nt is a device n │ │ │ │ -0002e960: 616d 6520 656e 636c 6f73 6564 2069 6e20 ame enclosed in │ │ │ │ -0002e970: 7061 7265 6e74 6865 7365 7320 282a 6e6f parentheses (*no │ │ │ │ -0002e980: 7465 0a20 2020 2020 4465 7669 6365 2073 te. Device s │ │ │ │ -0002e990: 796e 7461 783a 3a29 2c20 7468 656e 2070 yntax::), then p │ │ │ │ -0002e9a0: 7269 6e74 2074 6865 206e 616d 6520 6f66 rint the name of │ │ │ │ -0002e9b0: 2074 6865 2066 696c 6573 7973 7465 6d20 the filesystem │ │ │ │ -0002e9c0: 6f66 2074 6861 740a 2020 2020 2064 6576 of that. dev │ │ │ │ -0002e9d0: 6963 652e 0a0a 2020 2020 2049 6620 7468 ice... If th │ │ │ │ -0002e9e0: 6520 6172 6775 6d65 6e74 2069 7320 6120 e argument is a │ │ │ │ -0002e9f0: 6469 7265 6374 6f72 7920 6769 7665 6e20 directory given │ │ │ │ -0002ea00: 6173 2061 6e20 6162 736f 6c75 7465 2066 as an absolute f │ │ │ │ -0002ea10: 696c 6520 6e61 6d65 0a20 2020 2020 282a ile name. (* │ │ │ │ -0002ea20: 6e6f 7465 2046 696c 6520 6e61 6d65 2073 note File name s │ │ │ │ -0002ea30: 796e 7461 783a 3a29 2c20 7468 656e 206c yntax::), then l │ │ │ │ -0002ea40: 6973 7420 7468 6520 636f 6e74 656e 7473 ist the contents │ │ │ │ -0002ea50: 206f 6620 7468 6174 0a20 2020 2020 6469 of that. di │ │ │ │ -0002ea60: 7265 6374 6f72 792e 0a0a 1f0a 4669 6c65 rectory.....File │ │ │ │ -0002ea70: 3a20 6772 7562 2e69 6e66 6f2c 2020 4e6f : grub.info, No │ │ │ │ -0002ea80: 6465 3a20 6c73 666f 6e74 732c 2020 4e65 de: lsfonts, Ne │ │ │ │ -0002ea90: 7874 3a20 6c73 6d6f 642c 2020 5072 6576 xt: lsmod, Prev │ │ │ │ -0002eaa0: 3a20 6c73 2c20 2055 703a 2043 6f6d 6d61 : ls, Up: Comma │ │ │ │ -0002eab0: 6e64 2d6c 696e 6520 616e 6420 6d65 6e75 nd-line and menu │ │ │ │ -0002eac0: 2065 6e74 7279 2063 6f6d 6d61 6e64 730a entry commands. │ │ │ │ -0002ead0: 0a31 362e 332e 3436 206c 7366 6f6e 7473 .16.3.46 lsfonts │ │ │ │ -0002eae0: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d .--------------- │ │ │ │ -0002eaf0: 0a0a 202d 2d20 436f 6d6d 616e 643a 206c .. -- Command: l │ │ │ │ -0002eb00: 7366 6f6e 7473 0a20 2020 2020 4c69 7374 sfonts. List │ │ │ │ -0002eb10: 206c 6f61 6465 6420 666f 6e74 732e 0a0a loaded fonts... │ │ │ │ -0002eb20: 1f0a 4669 6c65 3a20 6772 7562 2e69 6e66 ..File: grub.inf │ │ │ │ -0002eb30: 6f2c 2020 4e6f 6465 3a20 6c73 6d6f 642c o, Node: lsmod, │ │ │ │ -0002eb40: 2020 4e65 7874 3a20 6d64 3573 756d 2c20 Next: md5sum, │ │ │ │ -0002eb50: 2050 7265 763a 206c 7366 6f6e 7473 2c20 Prev: lsfonts, │ │ │ │ -0002eb60: 2055 703a 2043 6f6d 6d61 6e64 2d6c 696e Up: Command-lin │ │ │ │ -0002eb70: 6520 616e 6420 6d65 6e75 2065 6e74 7279 e and menu entry │ │ │ │ -0002eb80: 2063 6f6d 6d61 6e64 730a 0a31 362e 332e commands..16.3. │ │ │ │ -0002eb90: 3437 206c 736d 6f64 0a2d 2d2d 2d2d 2d2d 47 lsmod.------- │ │ │ │ -0002eba0: 2d2d 2d2d 2d2d 0a0a 202d 2d20 436f 6d6d ------.. -- Comm │ │ │ │ -0002ebb0: 616e 643a 206c 736d 6f64 0a20 2020 2020 and: lsmod. │ │ │ │ -0002ebc0: 5368 6f77 206c 6973 7420 6f66 206c 6f61 Show list of loa │ │ │ │ -0002ebd0: 6465 6420 6d6f 6475 6c65 732e 0a0a 1f0a ded modules..... │ │ │ │ -0002ebe0: 4669 6c65 3a20 6772 7562 2e69 6e66 6f2c File: grub.info, │ │ │ │ -0002ebf0: 2020 4e6f 6465 3a20 6d64 3573 756d 2c20 Node: md5sum, │ │ │ │ -0002ec00: 204e 6578 743a 206d 6f64 756c 652c 2020 Next: module, │ │ │ │ -0002ec10: 5072 6576 3a20 6c73 6d6f 642c 2020 5570 Prev: lsmod, Up │ │ │ │ -0002ec20: 3a20 436f 6d6d 616e 642d 6c69 6e65 2061 : Command-line a │ │ │ │ -0002ec30: 6e64 206d 656e 7520 656e 7472 7920 636f nd menu entry co │ │ │ │ -0002ec40: 6d6d 616e 6473 0a0a 3136 2e33 2e34 3820 mmands..16.3.48 │ │ │ │ -0002ec50: 6d64 3573 756d 0a2d 2d2d 2d2d 2d2d 2d2d md5sum.--------- │ │ │ │ -0002ec60: 2d2d 2d2d 2d0a 0a20 2d2d 2043 6f6d 6d61 -----.. -- Comma │ │ │ │ -0002ec70: 6e64 3a20 6d64 3573 756d 2061 7267 202e nd: md5sum arg . │ │ │ │ -0002ec80: 2e2e 0a20 2020 2020 416c 6961 7320 666f ... Alias fo │ │ │ │ -0002ec90: 7220 2768 6173 6873 756d 202d 2d68 6173 r 'hashsum --has │ │ │ │ -0002eca0: 6820 6d64 3520 6172 6720 2e2e 2e27 2e20 h md5 arg ...'. │ │ │ │ -0002ecb0: 2053 6565 2063 6f6d 6d61 6e64 2027 6861 See command 'ha │ │ │ │ -0002ecc0: 7368 7375 6d27 0a20 2020 2020 282a 6e6f shsum'. (*no │ │ │ │ -0002ecd0: 7465 2068 6173 6873 756d 3a3a 2920 666f te hashsum::) fo │ │ │ │ -0002ece0: 7220 6675 6c6c 2064 6573 6372 6970 7469 r full descripti │ │ │ │ -0002ecf0: 6f6e 2e0a 0a1f 0a46 696c 653a 2067 7275 on.....File: gru │ │ │ │ -0002ed00: 622e 696e 666f 2c20 204e 6f64 653a 206d b.info, Node: m │ │ │ │ -0002ed10: 6f64 756c 652c 2020 4e65 7874 3a20 6d75 odule, Next: mu │ │ │ │ -0002ed20: 6c74 6962 6f6f 742c 2020 5072 6576 3a20 ltiboot, Prev: │ │ │ │ -0002ed30: 6d64 3573 756d 2c20 2055 703a 2043 6f6d md5sum, Up: Com │ │ │ │ -0002ed40: 6d61 6e64 2d6c 696e 6520 616e 6420 6d65 mand-line and me │ │ │ │ -0002ed50: 6e75 2065 6e74 7279 2063 6f6d 6d61 6e64 nu entry command │ │ │ │ -0002ed60: 730a 0a31 362e 332e 3439 206d 6f64 756c s..16.3.49 modul │ │ │ │ -0002ed70: 650a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d e.-------------- │ │ │ │ -0002ed80: 0a0a 202d 2d20 436f 6d6d 616e 643a 206d .. -- Command: m │ │ │ │ -0002ed90: 6f64 756c 6520 5b2d 2d6e 6f75 6e7a 6970 odule [--nounzip │ │ │ │ -0002eda0: 5d20 6669 6c65 205b 6172 6775 6d65 6e74 ] file [argument │ │ │ │ -0002edb0: 735d 0a20 2020 2020 4c6f 6164 2061 206d s]. Load a m │ │ │ │ -0002edc0: 6f64 756c 6520 666f 7220 6d75 6c74 6962 odule for multib │ │ │ │ -0002edd0: 6f6f 7420 6b65 726e 656c 2069 6d61 6765 oot kernel image │ │ │ │ -0002ede0: 2e20 2054 6865 2072 6573 7420 6f66 2074 . The rest of t │ │ │ │ -0002edf0: 6865 206c 696e 6520 6973 0a20 2020 2020 he line is. │ │ │ │ -0002ee00: 7061 7373 6564 2076 6572 6261 7469 6d20 passed verbatim │ │ │ │ -0002ee10: 6173 2074 6865 206d 6f64 756c 6520 636f as the module co │ │ │ │ -0002ee20: 6d6d 616e 6420 6c69 6e65 2e0a 0a1f 0a46 mmand line.....F │ │ │ │ -0002ee30: 696c 653a 2067 7275 622e 696e 666f 2c20 ile: grub.info, │ │ │ │ -0002ee40: 204e 6f64 653a 206d 756c 7469 626f 6f74 Node: multiboot │ │ │ │ -0002ee50: 2c20 204e 6578 743a 206e 6174 6976 6564 , Next: natived │ │ │ │ -0002ee60: 6973 6b2c 2020 5072 6576 3a20 6d6f 6475 isk, Prev: modu │ │ │ │ -0002ee70: 6c65 2c20 2055 703a 2043 6f6d 6d61 6e64 le, Up: Command │ │ │ │ -0002ee80: 2d6c 696e 6520 616e 6420 6d65 6e75 2065 -line and menu e │ │ │ │ -0002ee90: 6e74 7279 2063 6f6d 6d61 6e64 730a 0a31 ntry commands..1 │ │ │ │ -0002eea0: 362e 332e 3530 206d 756c 7469 626f 6f74 6.3.50 multiboot │ │ │ │ -0002eeb0: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d .--------------- │ │ │ │ -0002eec0: 2d2d 0a0a 202d 2d20 436f 6d6d 616e 643a --.. -- Command: │ │ │ │ -0002eed0: 206d 756c 7469 626f 6f74 205b 2d2d 7175 multiboot [--qu │ │ │ │ -0002eee0: 6972 6b2d 6261 642d 6b6c 7564 6765 5d0a irk-bad-kludge]. │ │ │ │ -0002eef0: 2020 2020 2020 2020 2020 5b2d 2d71 7569 [--qui │ │ │ │ -0002ef00: 726b 2d6d 6f64 756c 6573 2d61 6674 6572 rk-modules-after │ │ │ │ -0002ef10: 2d6b 6572 6e65 6c5d 2066 696c 6520 2e2e -kernel] file .. │ │ │ │ -0002ef20: 2e0a 2020 2020 204c 6f61 6420 6120 6d75 .. Load a mu │ │ │ │ -0002ef30: 6c74 6962 6f6f 7420 6b65 726e 656c 2069 ltiboot kernel i │ │ │ │ -0002ef40: 6d61 6765 2066 726f 6d20 4649 4c45 2e20 mage from FILE. │ │ │ │ -0002ef50: 2054 6865 2072 6573 7420 6f66 2074 6865 The rest of the │ │ │ │ -0002ef60: 206c 696e 6520 6973 0a20 2020 2020 7061 line is. pa │ │ │ │ -0002ef70: 7373 6564 2076 6572 6261 7469 6d20 6173 ssed verbatim as │ │ │ │ -0002ef80: 2074 6865 2022 6b65 726e 656c 2063 6f6d the "kernel com │ │ │ │ -0002ef90: 6d61 6e64 2d6c 696e 6522 2e20 2041 6e79 mand-line". Any │ │ │ │ -0002efa0: 206d 6f64 756c 6520 6d75 7374 2062 650a module must be. │ │ │ │ -0002efb0: 2020 2020 2072 656c 6f61 6465 6420 6166 reloaded af │ │ │ │ -0002efc0: 7465 7220 7573 696e 6720 7468 6973 2063 ter using this c │ │ │ │ -0002efd0: 6f6d 6d61 6e64 2028 2a6e 6f74 6520 6d6f ommand (*note mo │ │ │ │ -0002efe0: 6475 6c65 3a3a 292e 0a0a 2020 2020 2053 dule::)... S │ │ │ │ -0002eff0: 6f6d 6520 6b65 726e 656c 7320 6861 7665 ome kernels have │ │ │ │ -0002f000: 206b 6e6f 776e 2070 726f 626c 656d 732e known problems. │ │ │ │ -0002f010: 2020 596f 7520 6e65 6564 2074 6f20 7370 You need to sp │ │ │ │ -0002f020: 6563 6966 7920 2d71 7569 726b 2d2a 2066 ecify -quirk-* f │ │ │ │ -0002f030: 6f72 0a20 2020 2020 7468 6f73 652e 2020 or. those. │ │ │ │ -0002f040: 2d71 7569 726b 2d62 6164 2d6b 6c75 6467 -quirk-bad-kludg │ │ │ │ -0002f050: 6520 6973 2061 2070 726f 626c 656d 2073 e is a problem s │ │ │ │ -0002f060: 6565 6e20 696e 2073 6576 6572 616c 2070 een in several p │ │ │ │ -0002f070: 726f 6475 6374 730a 2020 2020 2074 6861 roducts. tha │ │ │ │ -0002f080: 7420 7468 6579 2069 6e63 6c75 6465 206c t they include l │ │ │ │ -0002f090: 6f61 6469 6e67 206b 6c75 6467 6520 696e oading kludge in │ │ │ │ -0002f0a0: 666f 726d 6174 696f 6e20 7769 7468 2069 formation with i │ │ │ │ -0002f0b0: 6e76 616c 6964 2064 6174 6120 696e 0a20 nvalid data in. │ │ │ │ -0002f0c0: 2020 2020 454c 4620 6669 6c65 2e20 2047 ELF file. G │ │ │ │ -0002f0d0: 5255 4220 7072 696f 7220 746f 2030 2e39 RUB prior to 0.9 │ │ │ │ -0002f0e0: 3720 616e 6420 736f 6d65 2063 7573 746f 7 and some custo │ │ │ │ -0002f0f0: 6d20 6275 696c 6473 2070 7265 6665 7265 m builds prefere │ │ │ │ -0002f100: 6420 454c 460a 2020 2020 2069 6e66 6f72 d ELF. infor │ │ │ │ -0002f110: 6d61 7469 6f6e 2077 6869 6c65 2030 2e39 mation while 0.9 │ │ │ │ -0002f120: 3720 616e 6420 4752 5542 2032 2075 7365 7 and GRUB 2 use │ │ │ │ -0002f130: 206b 6c75 6467 652e 2020 5573 6520 7468 kludge. Use th │ │ │ │ -0002f140: 6973 206f 7074 696f 6e20 746f 0a20 2020 is option to. │ │ │ │ -0002f150: 2020 6967 6e6f 7265 206b 6c75 6467 652e ignore kludge. │ │ │ │ -0002f160: 2020 4b6e 6f77 6e20 6166 6665 6374 6564 Known affected │ │ │ │ -0002f170: 2073 7973 7465 6d73 3a20 6f6c 6420 536f systems: old So │ │ │ │ -0002f180: 6c61 7269 732c 2053 6b79 4f53 2e0a 0a20 laris, SkyOS... │ │ │ │ -0002f190: 2020 2020 2d71 7569 726b 2d6d 6f64 756c -quirk-modul │ │ │ │ -0002f1a0: 6573 2d61 6674 6572 2d6b 6572 6e65 6c20 es-after-kernel │ │ │ │ -0002f1b0: 6973 206e 6565 6465 6420 666f 7220 6b65 is needed for ke │ │ │ │ -0002f1c0: 726e 656c 7320 7768 6963 6820 6c6f 6164 rnels which load │ │ │ │ -0002f1d0: 2061 740a 2020 2020 2072 656c 6174 6976 at. relativ │ │ │ │ -0002f1e0: 656c 7920 6869 6768 2061 6464 7265 7373 ely high address │ │ │ │ -0002f1f0: 2065 2e67 2e20 2031 364d 6942 206d 6172 e.g. 16MiB mar │ │ │ │ -0002f200: 6b20 616e 6420 6361 6e27 7420 636f 7065 k and can't cope │ │ │ │ -0002f210: 2077 6974 680a 2020 2020 206d 6f64 756c with. modul │ │ │ │ -0002f220: 6573 2073 7475 6666 6564 2062 6574 7765 es stuffed betwe │ │ │ │ -0002f230: 656e 2031 4d69 4220 6d61 726b 2061 6e64 en 1MiB mark and │ │ │ │ -0002f240: 2062 6567 696e 6e69 6e67 206f 6620 7468 beginning of th │ │ │ │ -0002f250: 6520 6b65 726e 656c 2e0a 2020 2020 204b e kernel.. K │ │ │ │ -0002f260: 6e6f 776e 2061 6666 7465 6374 6564 2073 nown afftected s │ │ │ │ -0002f270: 7973 7465 6d73 3a20 564d 5761 7265 2e0a ystems: VMWare.. │ │ │ │ -0002f280: 0a1f 0a46 696c 653a 2067 7275 622e 696e ...File: grub.in │ │ │ │ -0002f290: 666f 2c20 204e 6f64 653a 206e 6174 6976 fo, Node: nativ │ │ │ │ -0002f2a0: 6564 6973 6b2c 2020 4e65 7874 3a20 6e6f edisk, Next: no │ │ │ │ -0002f2b0: 726d 616c 2c20 2050 7265 763a 206d 756c rmal, Prev: mul │ │ │ │ -0002f2c0: 7469 626f 6f74 2c20 2055 703a 2043 6f6d tiboot, Up: Com │ │ │ │ -0002f2d0: 6d61 6e64 2d6c 696e 6520 616e 6420 6d65 mand-line and me │ │ │ │ -0002f2e0: 6e75 2065 6e74 7279 2063 6f6d 6d61 6e64 nu entry command │ │ │ │ -0002f2f0: 730a 0a31 362e 332e 3531 206e 6174 6976 s..16.3.51 nativ │ │ │ │ -0002f300: 6564 6973 6b0a 2d2d 2d2d 2d2d 2d2d 2d2d edisk.---------- │ │ │ │ -0002f310: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 436f --------.. -- Co │ │ │ │ -0002f320: 6d6d 616e 643a 206e 6174 6976 6564 6973 mmand: nativedis │ │ │ │ -0002f330: 6b0a 2020 2020 2053 7769 7463 6820 6672 k. Switch fr │ │ │ │ -0002f340: 6f6d 2066 6972 6d77 6172 6520 6469 736b om firmware disk │ │ │ │ -0002f350: 2064 7269 7665 7273 2074 6f20 6e61 7469 drivers to nati │ │ │ │ -0002f360: 7665 206f 6e65 732e 2020 5265 616c 6c79 ve ones. Really │ │ │ │ -0002f370: 2075 7365 6675 6c0a 2020 2020 206f 6e6c useful. onl │ │ │ │ -0002f380: 7920 6f6e 2070 6c61 7466 6f72 6d73 2077 y on platforms w │ │ │ │ -0002f390: 6865 7265 2062 6f74 6820 6669 726d 7761 here both firmwa │ │ │ │ -0002f3a0: 7265 2061 6e64 206e 6174 6976 6520 6469 re and native di │ │ │ │ -0002f3b0: 736b 2064 7269 7665 7320 6172 650a 2020 sk drives are. │ │ │ │ -0002f3c0: 2020 2061 7661 696c 6162 6c65 2e20 2043 available. C │ │ │ │ -0002f3d0: 7572 7265 6e74 6c79 2069 3338 362d 7063 urrently i386-pc │ │ │ │ -0002f3e0: 2c20 6933 3836 2d65 6669 2c20 6933 3836 , i386-efi, i386 │ │ │ │ -0002f3f0: 2d69 6565 6531 3237 3520 616e 640a 2020 -ieee1275 and. │ │ │ │ -0002f400: 2020 2078 3836 5f36 342d 6566 692e 0a0a x86_64-efi... │ │ │ │ -0002f410: 1f0a 4669 6c65 3a20 6772 7562 2e69 6e66 ..File: grub.inf │ │ │ │ -0002f420: 6f2c 2020 4e6f 6465 3a20 6e6f 726d 616c o, Node: normal │ │ │ │ -0002f430: 2c20 204e 6578 743a 206e 6f72 6d61 6c5f , Next: normal_ │ │ │ │ -0002f440: 6578 6974 2c20 2050 7265 763a 206e 6174 exit, Prev: nat │ │ │ │ -0002f450: 6976 6564 6973 6b2c 2020 5570 3a20 436f ivedisk, Up: Co │ │ │ │ -0002f460: 6d6d 616e 642d 6c69 6e65 2061 6e64 206d mmand-line and m │ │ │ │ -0002f470: 656e 7520 656e 7472 7920 636f 6d6d 616e enu entry comman │ │ │ │ -0002f480: 6473 0a0a 3136 2e33 2e35 3220 6e6f 726d ds..16.3.52 norm │ │ │ │ -0002f490: 616c 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d al.------------- │ │ │ │ -0002f4a0: 2d0a 0a20 2d2d 2043 6f6d 6d61 6e64 3a20 -.. -- Command: │ │ │ │ -0002f4b0: 6e6f 726d 616c 205b 6669 6c65 5d0a 2020 normal [file]. │ │ │ │ -0002f4c0: 2020 2045 6e74 6572 206e 6f72 6d61 6c20 Enter normal │ │ │ │ -0002f4d0: 6d6f 6465 2061 6e64 2064 6973 706c 6179 mode and display │ │ │ │ -0002f4e0: 2074 6865 2047 5255 4220 6d65 6e75 2e0a the GRUB menu.. │ │ │ │ -0002f4f0: 0a20 2020 2020 496e 206e 6f72 6d61 6c20 . In normal │ │ │ │ -0002f500: 6d6f 6465 2c20 636f 6d6d 616e 6473 2c20 mode, commands, │ │ │ │ -0002f510: 6669 6c65 7379 7374 656d 206d 6f64 756c filesystem modul │ │ │ │ -0002f520: 6573 2c20 616e 6420 6372 7970 746f 6772 es, and cryptogr │ │ │ │ -0002f530: 6170 6879 0a20 2020 2020 6d6f 6475 6c65 aphy. module │ │ │ │ -0002f540: 7320 6172 6520 6175 746f 6d61 7469 6361 s are automatica │ │ │ │ -0002f550: 6c6c 7920 6c6f 6164 6564 2c20 616e 6420 lly loaded, and │ │ │ │ -0002f560: 7468 6520 6675 6c6c 2047 5255 4220 7363 the full GRUB sc │ │ │ │ -0002f570: 7269 7074 2070 6172 7365 720a 2020 2020 ript parser. │ │ │ │ -0002f580: 2069 7320 6176 6169 6c61 626c 652e 2020 is available. │ │ │ │ -0002f590: 4f74 6865 7220 6d6f 6475 6c65 7320 6d61 Other modules ma │ │ │ │ -0002f5a0: 7920 6265 2065 7870 6c69 6369 746c 7920 y be explicitly │ │ │ │ -0002f5b0: 6c6f 6164 6564 2075 7369 6e67 0a20 2020 loaded using. │ │ │ │ -0002f5c0: 2020 2769 6e73 6d6f 6427 2028 2a6e 6f74 'insmod' (*not │ │ │ │ -0002f5d0: 6520 696e 736d 6f64 3a3a 292e 0a0a 2020 e insmod::)... │ │ │ │ -0002f5e0: 2020 2049 6620 6120 4649 4c45 2069 7320 If a FILE is │ │ │ │ -0002f5f0: 6769 7665 6e2c 2074 6865 6e20 636f 6d6d given, then comm │ │ │ │ -0002f600: 616e 6473 2077 696c 6c20 6265 2072 6561 ands will be rea │ │ │ │ -0002f610: 6420 6672 6f6d 2074 6861 7420 6669 6c65 d from that file │ │ │ │ -0002f620: 2e0a 2020 2020 204f 7468 6572 7769 7365 .. Otherwise │ │ │ │ -0002f630: 2c20 7468 6579 2077 696c 6c20 6265 2072 , they will be r │ │ │ │ -0002f640: 6561 6420 6672 6f6d 2027 2470 7265 6669 ead from '$prefi │ │ │ │ -0002f650: 782f 6772 7562 2e63 6667 2720 6966 2069 x/grub.cfg' if i │ │ │ │ -0002f660: 7420 6578 6973 7473 2e0a 0a20 2020 2020 t exists... │ │ │ │ -0002f670: 276e 6f72 6d61 6c27 206d 6179 2062 6520 'normal' may be │ │ │ │ -0002f680: 6361 6c6c 6564 2066 726f 6d20 7769 7468 called from with │ │ │ │ -0002f690: 696e 206e 6f72 6d61 6c20 6d6f 6465 2c20 in normal mode, │ │ │ │ -0002f6a0: 6372 6561 7469 6e67 2061 206e 6573 7465 creating a neste │ │ │ │ -0002f6b0: 640a 2020 2020 2065 6e76 6972 6f6e 6d65 d. environme │ │ │ │ -0002f6c0: 6e74 2e20 2049 7420 6973 206d 6f72 6520 nt. It is more │ │ │ │ -0002f6d0: 7573 7561 6c20 746f 2075 7365 2027 636f usual to use 'co │ │ │ │ -0002f6e0: 6e66 6967 6669 6c65 2720 282a 6e6f 7465 nfigfile' (*note │ │ │ │ -0002f6f0: 0a20 2020 2020 636f 6e66 6967 6669 6c65 . configfile │ │ │ │ -0002f700: 3a3a 2920 666f 7220 7468 6973 2e0a 0a1f ::) for this.... │ │ │ │ -0002f710: 0a46 696c 653a 2067 7275 622e 696e 666f .File: grub.info │ │ │ │ -0002f720: 2c20 204e 6f64 653a 206e 6f72 6d61 6c5f , Node: normal_ │ │ │ │ -0002f730: 6578 6974 2c20 204e 6578 743a 2070 6172 exit, Next: par │ │ │ │ -0002f740: 7474 6f6f 6c2c 2020 5072 6576 3a20 6e6f ttool, Prev: no │ │ │ │ -0002f750: 726d 616c 2c20 2055 703a 2043 6f6d 6d61 rmal, Up: Comma │ │ │ │ -0002f760: 6e64 2d6c 696e 6520 616e 6420 6d65 6e75 nd-line and menu │ │ │ │ -0002f770: 2065 6e74 7279 2063 6f6d 6d61 6e64 730a entry commands. │ │ │ │ -0002f780: 0a31 362e 332e 3533 206e 6f72 6d61 6c5f .16.3.53 normal_ │ │ │ │ -0002f790: 6578 6974 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d exit.----------- │ │ │ │ -0002f7a0: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 436f --------.. -- Co │ │ │ │ -0002f7b0: 6d6d 616e 643a 206e 6f72 6d61 6c5f 6578 mmand: normal_ex │ │ │ │ -0002f7c0: 6974 0a20 2020 2020 4578 6974 206e 6f72 it. Exit nor │ │ │ │ -0002f7d0: 6d61 6c20 6d6f 6465 2028 2a6e 6f74 6520 mal mode (*note │ │ │ │ -0002f7e0: 6e6f 726d 616c 3a3a 292e 2020 4966 2074 normal::). If t │ │ │ │ -0002f7f0: 6869 7320 696e 7374 616e 6365 206f 6620 his instance of │ │ │ │ -0002f800: 6e6f 726d 616c 206d 6f64 650a 2020 2020 normal mode. │ │ │ │ -0002f810: 2077 6173 206e 6f74 206e 6573 7465 6420 was not nested │ │ │ │ -0002f820: 7769 7468 696e 2061 6e6f 7468 6572 206f within another o │ │ │ │ -0002f830: 6e65 2c20 7468 656e 2072 6574 7572 6e20 ne, then return │ │ │ │ -0002f840: 746f 2072 6573 6375 6520 6d6f 6465 2e0a to rescue mode.. │ │ │ │ -0002f850: 0a1f 0a46 696c 653a 2067 7275 622e 696e ...File: grub.in │ │ │ │ -0002f860: 666f 2c20 204e 6f64 653a 2070 6172 7474 fo, Node: partt │ │ │ │ -0002f870: 6f6f 6c2c 2020 4e65 7874 3a20 7061 7373 ool, Next: pass │ │ │ │ -0002f880: 776f 7264 2c20 2050 7265 763a 206e 6f72 word, Prev: nor │ │ │ │ -0002f890: 6d61 6c5f 6578 6974 2c20 2055 703a 2043 mal_exit, Up: C │ │ │ │ -0002f8a0: 6f6d 6d61 6e64 2d6c 696e 6520 616e 6420 ommand-line and │ │ │ │ -0002f8b0: 6d65 6e75 2065 6e74 7279 2063 6f6d 6d61 menu entry comma │ │ │ │ -0002f8c0: 6e64 730a 0a31 362e 332e 3534 2070 6172 nds..16.3.54 par │ │ │ │ -0002f8d0: 7474 6f6f 6c0a 2d2d 2d2d 2d2d 2d2d 2d2d ttool.---------- │ │ │ │ -0002f8e0: 2d2d 2d2d 2d2d 0a0a 202d 2d20 436f 6d6d ------.. -- Comm │ │ │ │ -0002f8f0: 616e 643a 2070 6172 7474 6f6f 6c20 7061 and: parttool pa │ │ │ │ -0002f900: 7274 6974 696f 6e20 636f 6d6d 616e 6473 rtition commands │ │ │ │ -0002f910: 0a20 2020 2020 4d61 6b65 2076 6172 696f . Make vario │ │ │ │ -0002f920: 7573 206d 6f64 6966 6963 6174 696f 6e73 us modifications │ │ │ │ -0002f930: 2074 6f20 7061 7274 6974 696f 6e20 7461 to partition ta │ │ │ │ -0002f940: 626c 6520 656e 7472 6965 732e 0a0a 2020 ble entries... │ │ │ │ -0002f950: 2020 2045 6163 6820 434f 4d4d 414e 4420 Each COMMAND │ │ │ │ -0002f960: 6973 2065 6974 6865 7220 6120 626f 6f6c is either a bool │ │ │ │ -0002f970: 6561 6e20 6f70 7469 6f6e 2c20 696e 2077 ean option, in w │ │ │ │ -0002f980: 6869 6368 2063 6173 6520 6974 206d 7573 hich case it mus │ │ │ │ -0002f990: 7420 6265 0a20 2020 2020 666f 6c6c 6f77 t be. follow │ │ │ │ -0002f9a0: 6564 2077 6974 6820 272b 2720 6f72 2027 ed with '+' or ' │ │ │ │ -0002f9b0: 2d27 2028 7769 7468 206e 6f20 696e 7465 -' (with no inte │ │ │ │ -0002f9c0: 7276 656e 696e 6720 7370 6163 6529 2074 rvening space) t │ │ │ │ -0002f9d0: 6f20 656e 6162 6c65 206f 720a 2020 2020 o enable or. │ │ │ │ -0002f9e0: 2064 6973 6162 6c65 2074 6861 7420 6f70 disable that op │ │ │ │ -0002f9f0: 7469 6f6e 2c20 6f72 2065 6c73 6520 6974 tion, or else it │ │ │ │ -0002fa00: 2074 616b 6573 2061 2076 616c 7565 2069 takes a value i │ │ │ │ -0002fa10: 6e20 7468 6520 666f 726d 0a20 2020 2020 n the form. │ │ │ │ -0002fa20: 2743 4f4d 4d41 4e44 3d56 414c 5545 272e 'COMMAND=VALUE'. │ │ │ │ -0002fa30: 0a0a 2020 2020 2043 7572 7265 6e74 6c79 .. Currently │ │ │ │ -0002fa40: 2c20 2770 6172 7474 6f6f 6c27 2069 7320 , 'parttool' is │ │ │ │ -0002fa50: 6f6e 6c79 2075 7365 6675 6c20 6f6e 2044 only useful on D │ │ │ │ -0002fa60: 4f53 2070 6172 7469 7469 6f6e 2074 6162 OS partition tab │ │ │ │ -0002fa70: 6c65 7320 2861 6c73 6f0a 2020 2020 206b les (also. k │ │ │ │ -0002fa80: 6e6f 776e 2061 7320 4d61 7374 6572 2042 nown as Master B │ │ │ │ -0002fa90: 6f6f 7420 5265 636f 7264 2c20 6f72 204d oot Record, or M │ │ │ │ -0002faa0: 4252 292e 204f 6e20 7468 6573 6520 7061 BR). On these pa │ │ │ │ -0002fab0: 7274 6974 696f 6e20 7461 626c 6573 2c0a rtition tables,. │ │ │ │ -0002fac0: 2020 2020 2074 6865 2066 6f6c 6c6f 7769 the followi │ │ │ │ -0002fad0: 6e67 2063 6f6d 6d61 6e64 7320 6172 6520 ng commands are │ │ │ │ -0002fae0: 6176 6169 6c61 626c 653a 0a0a 2020 2020 available:.. │ │ │ │ -0002faf0: 2027 626f 6f74 2720 2862 6f6f 6c65 616e 'boot' (boolean │ │ │ │ -0002fb00: 290a 2020 2020 2020 2020 2020 5768 656e ). When │ │ │ │ -0002fb10: 2065 6e61 626c 6564 2c20 7468 6973 206d enabled, this m │ │ │ │ -0002fb20: 616b 6573 2074 6865 2073 656c 6563 7465 akes the selecte │ │ │ │ -0002fb30: 6420 7061 7274 6974 696f 6e20 6265 2074 d partition be t │ │ │ │ -0002fb40: 6865 2061 6374 6976 650a 2020 2020 2020 he active. │ │ │ │ -0002fb50: 2020 2020 2862 6f6f 7461 626c 6529 2070 (bootable) p │ │ │ │ -0002fb60: 6172 7469 7469 6f6e 206f 6e20 6974 7320 artition on its │ │ │ │ -0002fb70: 6469 736b 2c20 636c 6561 7269 6e67 2074 disk, clearing t │ │ │ │ -0002fb80: 6865 2061 6374 6976 6520 666c 6167 206f he active flag o │ │ │ │ -0002fb90: 6e0a 2020 2020 2020 2020 2020 616c 6c20 n. all │ │ │ │ -0002fba0: 6f74 6865 7220 7061 7274 6974 696f 6e73 other partitions │ │ │ │ -0002fbb0: 2e20 2054 6869 7320 636f 6d6d 616e 6420 . This command │ │ │ │ -0002fbc0: 6973 206c 696d 6974 6564 2074 6f20 5f70 is limited to _p │ │ │ │ -0002fbd0: 7269 6d61 7279 5f0a 2020 2020 2020 2020 rimary_. │ │ │ │ -0002fbe0: 2020 7061 7274 6974 696f 6e73 2e0a 0a20 partitions... │ │ │ │ -0002fbf0: 2020 2020 2774 7970 6527 2028 7661 6c75 'type' (valu │ │ │ │ -0002fc00: 6529 0a20 2020 2020 2020 2020 2043 6861 e). Cha │ │ │ │ -0002fc10: 6e67 6520 7468 6520 7479 7065 206f 6620 nge the type of │ │ │ │ -0002fc20: 616e 2065 7869 7374 696e 6720 7061 7274 an existing part │ │ │ │ -0002fc30: 6974 696f 6e2e 2020 5468 6520 7661 6c75 ition. The valu │ │ │ │ -0002fc40: 6520 6d75 7374 2062 6520 610a 2020 2020 e must be a. │ │ │ │ -0002fc50: 2020 2020 2020 6e75 6d62 6572 2069 6e20 number in │ │ │ │ -0002fc60: 7468 6520 7261 6e67 6520 302d 3078 4646 the range 0-0xFF │ │ │ │ -0002fc70: 2028 7072 6566 6978 2077 6974 6820 2730 (prefix with '0 │ │ │ │ -0002fc80: 7827 2074 6f20 656e 7465 7220 6974 2069 x' to enter it i │ │ │ │ -0002fc90: 6e0a 2020 2020 2020 2020 2020 6865 7861 n. hexa │ │ │ │ -0002fca0: 6465 6369 6d61 6c29 2e0a 0a20 2020 2020 decimal)... │ │ │ │ -0002fcb0: 2768 6964 6465 6e27 2028 626f 6f6c 6561 'hidden' (boolea │ │ │ │ -0002fcc0: 6e29 0a20 2020 2020 2020 2020 2057 6865 n). Whe │ │ │ │ -0002fcd0: 6e20 656e 6162 6c65 642c 2074 6869 7320 n enabled, this │ │ │ │ -0002fce0: 6869 6465 7320 7468 6520 7365 6c65 6374 hides the select │ │ │ │ -0002fcf0: 6564 2070 6172 7469 7469 6f6e 2062 7920 ed partition by │ │ │ │ -0002fd00: 7365 7474 696e 6720 7468 650a 2020 2020 setting the. │ │ │ │ -0002fd10: 2020 2020 2020 2268 6964 6465 6e22 2062 "hidden" b │ │ │ │ -0002fd20: 6974 2069 6e20 6974 7320 7061 7274 6974 it in its partit │ │ │ │ -0002fd30: 696f 6e20 7479 7065 2063 6f64 653b 2077 ion type code; w │ │ │ │ -0002fd40: 6865 6e20 6469 7361 626c 6564 2c0a 2020 hen disabled,. │ │ │ │ -0002fd50: 2020 2020 2020 2020 756e 6869 6465 7320 unhides │ │ │ │ -0002fd60: 7468 6520 7365 6c65 6374 6564 2070 6172 the selected par │ │ │ │ -0002fd70: 7469 7469 6f6e 2062 7920 636c 6561 7269 tition by cleari │ │ │ │ -0002fd80: 6e67 2074 6869 7320 6269 742e 2020 5468 ng this bit. Th │ │ │ │ -0002fd90: 6973 2069 730a 2020 2020 2020 2020 2020 is is. │ │ │ │ -0002fda0: 7573 6566 756c 206f 6e6c 7920 7768 656e useful only when │ │ │ │ -0002fdb0: 2062 6f6f 7469 6e67 2044 4f53 206f 7220 booting DOS or │ │ │ │ -0002fdc0: 5769 6e64 6f77 7320 616e 6420 6d75 6c74 Windows and mult │ │ │ │ -0002fdd0: 6970 6c65 2070 7269 6d61 7279 0a20 2020 iple primary. │ │ │ │ -0002fde0: 2020 2020 2020 2046 4154 2070 6172 7469 FAT parti │ │ │ │ -0002fdf0: 7469 6f6e 7320 6578 6973 7420 696e 206f tions exist in o │ │ │ │ -0002fe00: 6e65 2064 6973 6b2e 2020 5365 6520 616c ne disk. See al │ │ │ │ -0002fe10: 736f 202a 6e6f 7465 0a20 2020 2020 2020 so *note. │ │ │ │ -0002fe20: 2020 2044 4f53 2f57 696e 646f 7773 3a3a DOS/Windows:: │ │ │ │ -0002fe30: 2e0a 0a1f 0a46 696c 653a 2067 7275 622e .....File: grub. │ │ │ │ -0002fe40: 696e 666f 2c20 204e 6f64 653a 2070 6173 info, Node: pas │ │ │ │ -0002fe50: 7377 6f72 642c 2020 4e65 7874 3a20 7061 sword, Next: pa │ │ │ │ -0002fe60: 7373 776f 7264 5f70 626b 6466 322c 2020 ssword_pbkdf2, │ │ │ │ -0002fe70: 5072 6576 3a20 7061 7274 746f 6f6c 2c20 Prev: parttool, │ │ │ │ -0002fe80: 2055 703a 2043 6f6d 6d61 6e64 2d6c 696e Up: Command-lin │ │ │ │ -0002fe90: 6520 616e 6420 6d65 6e75 2065 6e74 7279 e and menu entry │ │ │ │ -0002fea0: 2063 6f6d 6d61 6e64 730a 0a31 362e 332e commands..16.3. │ │ │ │ -0002feb0: 3535 2070 6173 7377 6f72 640a 2d2d 2d2d 55 password.---- │ │ │ │ -0002fec0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d ------------.. - │ │ │ │ -0002fed0: 2d20 436f 6d6d 616e 643a 2070 6173 7377 - Command: passw │ │ │ │ -0002fee0: 6f72 6420 7573 6572 2063 6c65 6172 2d70 ord user clear-p │ │ │ │ -0002fef0: 6173 7377 6f72 640a 2020 2020 2044 6566 assword. Def │ │ │ │ -0002ff00: 696e 6520 6120 7573 6572 206e 616d 6564 ine a user named │ │ │ │ -0002ff10: 2055 5345 5220 7769 7468 2070 6173 7377 USER with passw │ │ │ │ -0002ff20: 6f72 6420 434c 4541 522d 5041 5353 574f ord CLEAR-PASSWO │ │ │ │ -0002ff30: 5244 2e20 202a 4e6f 7465 0a20 2020 2020 RD. *Note. │ │ │ │ -0002ff40: 5365 6375 7269 7479 3a3a 2e0a 0a1f 0a46 Security::.....F │ │ │ │ -0002ff50: 696c 653a 2067 7275 622e 696e 666f 2c20 ile: grub.info, │ │ │ │ -0002ff60: 204e 6f64 653a 2070 6173 7377 6f72 645f Node: password_ │ │ │ │ -0002ff70: 7062 6b64 6632 2c20 204e 6578 743a 2070 pbkdf2, Next: p │ │ │ │ -0002ff80: 6c61 792c 2020 5072 6576 3a20 7061 7373 lay, Prev: pass │ │ │ │ -0002ff90: 776f 7264 2c20 2055 703a 2043 6f6d 6d61 word, Up: Comma │ │ │ │ -0002ffa0: 6e64 2d6c 696e 6520 616e 6420 6d65 6e75 nd-line and menu │ │ │ │ -0002ffb0: 2065 6e74 7279 2063 6f6d 6d61 6e64 730a entry commands. │ │ │ │ -0002ffc0: 0a31 362e 332e 3536 2070 6173 7377 6f72 .16.3.56 passwor │ │ │ │ -0002ffd0: 645f 7062 6b64 6632 0a2d 2d2d 2d2d 2d2d d_pbkdf2.------- │ │ │ │ +00028380: 2020 2020 2020 5772 6974 6520 7661 6c75 Write valu │ │ │ │ +00028390: 6573 2074 6f20 6d6f 6465 6c2d 7370 6563 es to model-spec │ │ │ │ +000283a0: 6966 6963 2072 6567 6973 7465 7273 0a2a ific registers.* │ │ │ │ +000283b0: 2078 656e 5f68 7970 6572 7669 736f 723a xen_hypervisor: │ │ │ │ +000283c0: 3a20 2020 2020 2020 2020 2020 2020 204c : L │ │ │ │ +000283d0: 6f61 6420 7865 6e20 6879 7065 7276 6973 oad xen hypervis │ │ │ │ +000283e0: 6f72 2062 696e 6172 7920 286f 6e6c 7920 or binary (only │ │ │ │ +000283f0: 6f6e 2041 4172 6368 3634 290a 2a20 7865 on AArch64).* xe │ │ │ │ +00028400: 6e5f 6d6f 6475 6c65 3a3a 2020 2020 2020 n_module:: │ │ │ │ +00028410: 2020 2020 2020 2020 2020 2020 4c6f 6164 Load │ │ │ │ +00028420: 2078 656e 206d 6f64 756c 6573 2066 6f72 xen modules for │ │ │ │ +00028430: 2078 656e 2068 7970 6572 7669 736f 7220 xen hypervisor │ │ │ │ +00028440: 286f 6e6c 7920 6f6e 2041 4172 6368 3634 (only on AArch64 │ │ │ │ +00028450: 290a 0a1f 0a46 696c 653a 2067 7275 622e )....File: grub. │ │ │ │ +00028460: 696e 666f 2c20 204e 6f64 653a 205b 2c20 info, Node: [, │ │ │ │ +00028470: 204e 6578 743a 2061 6370 692c 2020 5570 Next: acpi, Up │ │ │ │ +00028480: 3a20 436f 6d6d 616e 642d 6c69 6e65 2061 : Command-line a │ │ │ │ +00028490: 6e64 206d 656e 7520 656e 7472 7920 636f nd menu entry co │ │ │ │ +000284a0: 6d6d 616e 6473 0a0a 3136 2e33 2e31 205b mmands..16.3.1 [ │ │ │ │ +000284b0: 0a2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2043 .--------.. -- C │ │ │ │ +000284c0: 6f6d 6d61 6e64 3a20 275b 2720 6578 7072 ommand: '[' expr │ │ │ │ +000284d0: 6573 7369 6f6e 2027 5d27 0a20 2020 2020 ession ']'. │ │ │ │ +000284e0: 416c 6961 7320 666f 7220 2774 6573 7420 Alias for 'test │ │ │ │ +000284f0: 4558 5052 4553 5349 4f4e 2720 282a 6e6f EXPRESSION' (*no │ │ │ │ +00028500: 7465 2074 6573 743a 3a29 2e0a 0a1f 0a46 te test::).....F │ │ │ │ +00028510: 696c 653a 2067 7275 622e 696e 666f 2c20 ile: grub.info, │ │ │ │ +00028520: 204e 6f64 653a 2061 6370 692c 2020 4e65 Node: acpi, Ne │ │ │ │ +00028530: 7874 3a20 6175 7468 656e 7469 6361 7465 xt: authenticate │ │ │ │ +00028540: 2c20 2050 7265 763a 205b 2c20 2055 703a , Prev: [, Up: │ │ │ │ +00028550: 2043 6f6d 6d61 6e64 2d6c 696e 6520 616e Command-line an │ │ │ │ +00028560: 6420 6d65 6e75 2065 6e74 7279 2063 6f6d d menu entry com │ │ │ │ +00028570: 6d61 6e64 730a 0a31 362e 332e 3220 6163 mands..16.3.2 ac │ │ │ │ +00028580: 7069 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a pi.-----------.. │ │ │ │ +00028590: 202d 2d20 436f 6d6d 616e 643a 2061 6370 -- Command: acp │ │ │ │ +000285a0: 6920 5b27 2d31 277c 272d 3227 5d0a 2020 i ['-1'|'-2']. │ │ │ │ +000285b0: 2020 2020 2020 2020 5b27 2d2d 6578 636c ['--excl │ │ │ │ +000285c0: 7564 653d 7461 626c 6531 2c2e 2e2e 277c ude=table1,...'| │ │ │ │ +000285d0: 272d 2d6c 6f61 642d 6f6e 6c79 3d74 6162 '--load-only=tab │ │ │ │ +000285e0: 6c65 312c 2e2e 2e27 5d0a 2020 2020 2020 le1,...']. │ │ │ │ +000285f0: 2020 2020 5b27 2d2d 6f65 6d69 643d 6964 ['--oemid=id │ │ │ │ +00028600: 275d 205b 272d 2d6f 656d 7461 626c 653d '] ['--oemtable= │ │ │ │ +00028610: 7461 626c 6527 5d20 5b27 2d2d 6f65 6d74 table'] ['--oemt │ │ │ │ +00028620: 6162 6c65 7265 763d 7265 7627 5d0a 2020 ablerev=rev']. │ │ │ │ +00028630: 2020 2020 2020 2020 5b27 2d2d 6f65 6d74 ['--oemt │ │ │ │ +00028640: 6162 6c65 6372 6561 746f 723d 6372 6561 ablecreator=crea │ │ │ │ +00028650: 746f 7227 5d20 5b27 2d2d 6f65 6d74 6162 tor'] ['--oemtab │ │ │ │ +00028660: 6c65 6372 6561 746f 7272 6576 3d72 6576 lecreatorrev=rev │ │ │ │ +00028670: 275d 0a20 2020 2020 2020 2020 205b 272d ']. ['- │ │ │ │ +00028680: 2d6e 6f2d 6562 6461 275d 2066 696c 656e -no-ebda'] filen │ │ │ │ +00028690: 616d 6520 2e2e 2e0a 2020 2020 204d 6f64 ame .... Mod │ │ │ │ +000286a0: 6572 6e20 4249 4f53 2073 7973 7465 6d73 ern BIOS systems │ │ │ │ +000286b0: 206e 6f72 6d61 6c6c 7920 696d 706c 656d normally implem │ │ │ │ +000286c0: 656e 7420 7468 6520 4164 7661 6e63 6564 ent the Advanced │ │ │ │ +000286d0: 2043 6f6e 6669 6775 7261 7469 6f6e 0a20 Configuration. │ │ │ │ +000286e0: 2020 2020 616e 6420 506f 7765 7220 496e and Power In │ │ │ │ +000286f0: 7465 7266 6163 6520 2841 4350 4929 2c20 terface (ACPI), │ │ │ │ +00028700: 616e 6420 6465 6669 6e65 2076 6172 696f and define vario │ │ │ │ +00028710: 7573 2074 6162 6c65 7320 7468 6174 2064 us tables that d │ │ │ │ +00028720: 6573 6372 6962 650a 2020 2020 2074 6865 escribe. the │ │ │ │ +00028730: 2069 6e74 6572 6661 6365 2062 6574 7765 interface betwe │ │ │ │ +00028740: 656e 2061 6e20 4143 5049 2d63 6f6d 706c en an ACPI-compl │ │ │ │ +00028750: 6961 6e74 206f 7065 7261 7469 6e67 2073 iant operating s │ │ │ │ +00028760: 7973 7465 6d20 616e 6420 7468 650a 2020 ystem and the. │ │ │ │ +00028770: 2020 2066 6972 6d77 6172 652e 2020 496e firmware. In │ │ │ │ +00028780: 2073 6f6d 6520 6361 7365 732c 2074 6865 some cases, the │ │ │ │ +00028790: 2074 6162 6c65 7320 7072 6f76 6964 6564 tables provided │ │ │ │ +000287a0: 2062 7920 6465 6661 756c 7420 6f6e 6c79 by default only │ │ │ │ +000287b0: 2077 6f72 6b0a 2020 2020 2077 656c 6c20 work. well │ │ │ │ +000287c0: 7769 7468 2063 6572 7461 696e 206f 7065 with certain ope │ │ │ │ +000287d0: 7261 7469 6e67 2073 7973 7465 6d73 2c20 rating systems, │ │ │ │ +000287e0: 616e 6420 6974 206d 6179 2062 6520 6e65 and it may be ne │ │ │ │ +000287f0: 6365 7373 6172 7920 746f 0a20 2020 2020 cessary to. │ │ │ │ +00028800: 7265 706c 6163 6520 736f 6d65 206f 6620 replace some of │ │ │ │ +00028810: 7468 656d 2e0a 0a20 2020 2020 4e6f 726d them... Norm │ │ │ │ +00028820: 616c 6c79 2c20 7468 6973 2063 6f6d 6d61 ally, this comma │ │ │ │ +00028830: 6e64 2077 696c 6c20 7265 706c 6163 6520 nd will replace │ │ │ │ +00028840: 7468 6520 526f 6f74 2053 7973 7465 6d20 the Root System │ │ │ │ +00028850: 4465 7363 7269 7074 696f 6e0a 2020 2020 Description. │ │ │ │ +00028860: 2050 6f69 6e74 6572 2028 5253 4450 2920 Pointer (RSDP) │ │ │ │ +00028870: 696e 2074 6865 2045 7874 656e 6465 6420 in the Extended │ │ │ │ +00028880: 4249 4f53 2044 6174 6120 4172 6561 2074 BIOS Data Area t │ │ │ │ +00028890: 6f20 706f 696e 7420 746f 2074 6865 206e o point to the n │ │ │ │ +000288a0: 6577 0a20 2020 2020 7461 626c 6573 2e20 ew. tables. │ │ │ │ +000288b0: 2049 6620 7468 6520 272d 2d6e 6f2d 6562 If the '--no-eb │ │ │ │ +000288c0: 6461 2720 6f70 7469 6f6e 2069 7320 7573 da' option is us │ │ │ │ +000288d0: 6564 2c20 7468 6520 6e65 7720 7461 626c ed, the new tabl │ │ │ │ +000288e0: 6573 2077 696c 6c20 6265 0a20 2020 2020 es will be. │ │ │ │ +000288f0: 6b6e 6f77 6e20 6f6e 6c79 2074 6f20 4752 known only to GR │ │ │ │ +00028900: 5542 2c20 6275 7420 6d61 7920 6265 2075 UB, but may be u │ │ │ │ +00028910: 7365 6420 6279 2047 5255 4227 7320 4546 sed by GRUB's EF │ │ │ │ +00028920: 4920 656d 756c 6174 696f 6e2e 0a0a 2020 I emulation... │ │ │ │ +00028930: 2020 204e 6f74 653a 2054 6865 2063 6f6d Note: The com │ │ │ │ +00028940: 6d61 6e64 2069 7320 6e6f 7420 616c 6c6f mand is not allo │ │ │ │ +00028950: 7765 6420 7768 656e 206c 6f63 6b64 6f77 wed when lockdow │ │ │ │ +00028960: 6e20 6973 2065 6e66 6f72 6365 6420 282a n is enforced (* │ │ │ │ +00028970: 6e6f 7465 0a20 2020 2020 4c6f 636b 646f note. Lockdo │ │ │ │ +00028980: 776e 3a3a 292e 2020 4f74 6865 7277 6973 wn::). Otherwis │ │ │ │ +00028990: 6520 616e 2061 7474 6163 6b65 7220 6361 e an attacker ca │ │ │ │ +000289a0: 6e20 696e 7374 7275 6374 2074 6865 2047 n instruct the G │ │ │ │ +000289b0: 5255 4220 746f 206c 6f61 640a 2020 2020 RUB to load. │ │ │ │ +000289c0: 2061 6e20 5353 4454 2074 6162 6c65 2074 an SSDT table t │ │ │ │ +000289d0: 6f20 6f76 6572 7772 6974 6520 7468 6520 o overwrite the │ │ │ │ +000289e0: 6b65 726e 656c 206c 6f63 6b64 6f77 6e20 kernel lockdown │ │ │ │ +000289f0: 636f 6e66 6967 7572 6174 696f 6e20 616e configuration an │ │ │ │ +00028a00: 640a 2020 2020 206c 6174 6572 206c 6f61 d. later loa │ │ │ │ +00028a10: 6420 616e 6420 6578 6563 7574 6520 756e d and execute un │ │ │ │ +00028a20: 7369 676e 6564 2063 6f64 652e 0a0a 1f0a signed code..... │ │ │ │ +00028a30: 4669 6c65 3a20 6772 7562 2e69 6e66 6f2c File: grub.info, │ │ │ │ +00028a40: 2020 4e6f 6465 3a20 6175 7468 656e 7469 Node: authenti │ │ │ │ +00028a50: 6361 7465 2c20 204e 6578 743a 2062 6163 cate, Next: bac │ │ │ │ +00028a60: 6b67 726f 756e 645f 636f 6c6f 722c 2020 kground_color, │ │ │ │ +00028a70: 5072 6576 3a20 6163 7069 2c20 2055 703a Prev: acpi, Up: │ │ │ │ +00028a80: 2043 6f6d 6d61 6e64 2d6c 696e 6520 616e Command-line an │ │ │ │ +00028a90: 6420 6d65 6e75 2065 6e74 7279 2063 6f6d d menu entry com │ │ │ │ +00028aa0: 6d61 6e64 730a 0a31 362e 332e 3320 6175 mands..16.3.3 au │ │ │ │ +00028ab0: 7468 656e 7469 6361 7465 0a2d 2d2d 2d2d thenticate.----- │ │ │ │ +00028ac0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a --------------.. │ │ │ │ +00028ad0: 202d 2d20 436f 6d6d 616e 643a 2061 7574 -- Command: aut │ │ │ │ +00028ae0: 6865 6e74 6963 6174 6520 5b75 7365 726c henticate [userl │ │ │ │ +00028af0: 6973 745d 0a20 2020 2020 4368 6563 6b20 ist]. Check │ │ │ │ +00028b00: 7768 6574 6865 7220 7573 6572 2069 7320 whether user is │ │ │ │ +00028b10: 696e 2055 5345 524c 4953 5420 6f72 206c in USERLIST or l │ │ │ │ +00028b20: 6973 7465 6420 696e 2074 6865 2076 616c isted in the val │ │ │ │ +00028b30: 7565 206f 660a 2020 2020 2076 6172 6961 ue of. varia │ │ │ │ +00028b40: 626c 6520 2773 7570 6572 7573 6572 7327 ble 'superusers' │ │ │ │ +00028b50: 2e20 2053 6565 202a 6e6f 7465 2073 7570 . See *note sup │ │ │ │ +00028b60: 6572 7573 6572 733a 3a20 666f 7220 7661 erusers:: for va │ │ │ │ +00028b70: 6c69 6420 7573 6572 206c 6973 740a 2020 lid user list. │ │ │ │ +00028b80: 2020 2066 6f72 6d61 742e 2020 4966 2027 format. If ' │ │ │ │ +00028b90: 7375 7065 7275 7365 7273 2720 6973 2065 superusers' is e │ │ │ │ +00028ba0: 6d70 7479 2c20 7468 6973 2063 6f6d 6d61 mpty, this comma │ │ │ │ +00028bb0: 6e64 2072 6574 7572 6e73 2074 7275 652e nd returns true. │ │ │ │ +00028bc0: 0a20 2020 2020 2a4e 6f74 6520 5365 6375 . *Note Secu │ │ │ │ +00028bd0: 7269 7479 3a3a 2e0a 0a1f 0a46 696c 653a rity::.....File: │ │ │ │ +00028be0: 2067 7275 622e 696e 666f 2c20 204e 6f64 grub.info, Nod │ │ │ │ +00028bf0: 653a 2062 6163 6b67 726f 756e 645f 636f e: background_co │ │ │ │ +00028c00: 6c6f 722c 2020 4e65 7874 3a20 6261 636b lor, Next: back │ │ │ │ +00028c10: 6772 6f75 6e64 5f69 6d61 6765 2c20 2050 ground_image, P │ │ │ │ +00028c20: 7265 763a 2061 7574 6865 6e74 6963 6174 rev: authenticat │ │ │ │ +00028c30: 652c 2020 5570 3a20 436f 6d6d 616e 642d e, Up: Command- │ │ │ │ +00028c40: 6c69 6e65 2061 6e64 206d 656e 7520 656e line and menu en │ │ │ │ +00028c50: 7472 7920 636f 6d6d 616e 6473 0a0a 3136 try commands..16 │ │ │ │ +00028c60: 2e33 2e34 2062 6163 6b67 726f 756e 645f .3.4 background_ │ │ │ │ +00028c70: 636f 6c6f 720a 2d2d 2d2d 2d2d 2d2d 2d2d color.---------- │ │ │ │ +00028c80: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 -------------.. │ │ │ │ +00028c90: 2d2d 2043 6f6d 6d61 6e64 3a20 6261 636b -- Command: back │ │ │ │ +00028ca0: 6772 6f75 6e64 5f63 6f6c 6f72 2063 6f6c ground_color col │ │ │ │ +00028cb0: 6f72 0a20 2020 2020 5365 7420 6261 636b or. Set back │ │ │ │ +00028cc0: 6772 6f75 6e64 2063 6f6c 6f72 2066 6f72 ground color for │ │ │ │ +00028cd0: 2061 6374 6976 6520 7465 726d 696e 616c active terminal │ │ │ │ +00028ce0: 2e20 2046 6f72 2076 616c 6964 2063 6f6c . For valid col │ │ │ │ +00028cf0: 6f72 0a20 2020 2020 7370 6563 6966 6963 or. specific │ │ │ │ +00028d00: 6174 696f 6e73 2073 6565 202a 6e6f 7465 ations see *note │ │ │ │ +00028d10: 2043 6f6c 6f72 733a 2054 6865 6d65 2066 Colors: Theme f │ │ │ │ +00028d20: 696c 6520 666f 726d 6174 2e20 2042 6163 ile format. Bac │ │ │ │ +00028d30: 6b67 726f 756e 640a 2020 2020 2063 6f6c kground. col │ │ │ │ +00028d40: 6f72 2063 616e 2062 6520 6368 616e 6765 or can be change │ │ │ │ +00028d50: 6420 6f6e 6c79 2077 6865 6e20 7573 696e d only when usin │ │ │ │ +00028d60: 6720 2767 6678 7465 726d 2720 666f 7220 g 'gfxterm' for │ │ │ │ +00028d70: 7465 726d 696e 616c 206f 7574 7075 742e terminal output. │ │ │ │ +00028d80: 0a0a 2020 2020 2054 6869 7320 636f 6d6d .. This comm │ │ │ │ +00028d90: 616e 6420 7365 7473 2063 6f6c 6f72 206f and sets color o │ │ │ │ +00028da0: 6620 656d 7074 7920 6172 6561 7320 7769 f empty areas wi │ │ │ │ +00028db0: 7468 6f75 7420 7465 7874 2e20 2054 6578 thout text. Tex │ │ │ │ +00028dc0: 740a 2020 2020 2062 6163 6b67 726f 756e t. backgroun │ │ │ │ +00028dd0: 6420 636f 6c6f 7220 6973 2063 6f6e 7472 d color is contr │ │ │ │ +00028de0: 6f6c 6c65 6420 6279 2065 6e76 6972 6f6e olled by environ │ │ │ │ +00028df0: 6d65 6e74 2076 6172 6961 626c 6573 0a20 ment variables. │ │ │ │ +00028e00: 2020 2020 434f 4c4f 525f 4e4f 524d 414c COLOR_NORMAL │ │ │ │ +00028e10: 2c20 434f 4c4f 525f 4849 4748 4c49 4748 , COLOR_HIGHLIGH │ │ │ │ +00028e20: 542c 204d 454e 555f 434f 4c4f 525f 4e4f T, MENU_COLOR_NO │ │ │ │ +00028e30: 524d 414c 2c0a 2020 2020 204d 454e 555f RMAL,. MENU_ │ │ │ │ +00028e40: 434f 4c4f 525f 4849 4748 4c49 4748 542e COLOR_HIGHLIGHT. │ │ │ │ +00028e50: 2020 2a4e 6f74 6520 5370 6563 6961 6c20 *Note Special │ │ │ │ +00028e60: 656e 7669 726f 6e6d 656e 7420 7661 7269 environment vari │ │ │ │ +00028e70: 6162 6c65 733a 3a2e 0a0a 1f0a 4669 6c65 ables::.....File │ │ │ │ +00028e80: 3a20 6772 7562 2e69 6e66 6f2c 2020 4e6f : grub.info, No │ │ │ │ +00028e90: 6465 3a20 6261 636b 6772 6f75 6e64 5f69 de: background_i │ │ │ │ +00028ea0: 6d61 6765 2c20 204e 6578 743a 2062 6164 mage, Next: bad │ │ │ │ +00028eb0: 7261 6d2c 2020 5072 6576 3a20 6261 636b ram, Prev: back │ │ │ │ +00028ec0: 6772 6f75 6e64 5f63 6f6c 6f72 2c20 2055 ground_color, U │ │ │ │ +00028ed0: 703a 2043 6f6d 6d61 6e64 2d6c 696e 6520 p: Command-line │ │ │ │ +00028ee0: 616e 6420 6d65 6e75 2065 6e74 7279 2063 and menu entry c │ │ │ │ +00028ef0: 6f6d 6d61 6e64 730a 0a31 362e 332e 3520 ommands..16.3.5 │ │ │ │ +00028f00: 6261 636b 6772 6f75 6e64 5f69 6d61 6765 background_image │ │ │ │ +00028f10: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d .--------------- │ │ │ │ +00028f20: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 436f --------.. -- Co │ │ │ │ +00028f30: 6d6d 616e 643a 2062 6163 6b67 726f 756e mmand: backgroun │ │ │ │ +00028f40: 645f 696d 6167 6520 5b5b 272d 2d6d 6f64 d_image [['--mod │ │ │ │ +00028f50: 6527 2027 7374 7265 7463 6827 7c27 6e6f e' 'stretch'|'no │ │ │ │ +00028f60: 726d 616c 275d 2066 696c 655d 0a20 2020 rmal'] file]. │ │ │ │ +00028f70: 2020 4c6f 6164 2062 6163 6b67 726f 756e Load backgroun │ │ │ │ +00028f80: 6420 696d 6167 6520 666f 7220 6163 7469 d image for acti │ │ │ │ +00028f90: 7665 2074 6572 6d69 6e61 6c20 6672 6f6d ve terminal from │ │ │ │ +00028fa0: 2046 494c 452e 2020 496d 6167 6520 6973 FILE. Image is │ │ │ │ +00028fb0: 0a20 2020 2020 7374 7265 7463 6865 6420 . stretched │ │ │ │ +00028fc0: 746f 2066 696c 6c20 7570 2065 6e74 6972 to fill up entir │ │ │ │ +00028fd0: 6520 7363 7265 656e 2075 6e6c 6573 7320 e screen unless │ │ │ │ +00028fe0: 6f70 7469 6f6e 2027 2d2d 6d6f 6465 2720 option '--mode' │ │ │ │ +00028ff0: 276e 6f72 6d61 6c27 0a20 2020 2020 6973 'normal'. is │ │ │ │ +00029000: 2067 6976 656e 2e20 2057 6974 686f 7574 given. Without │ │ │ │ +00029010: 2061 7267 756d 656e 7473 2072 656d 6f76 arguments remov │ │ │ │ +00029020: 6520 6375 7272 656e 746c 7920 6c6f 6164 e currently load │ │ │ │ +00029030: 6564 2062 6163 6b67 726f 756e 640a 2020 ed background. │ │ │ │ +00029040: 2020 2069 6d61 6765 2e20 2042 6163 6b67 image. Backg │ │ │ │ +00029050: 726f 756e 6420 696d 6167 6520 6361 6e20 round image can │ │ │ │ +00029060: 6265 2063 6861 6e67 6564 206f 6e6c 7920 be changed only │ │ │ │ +00029070: 7768 656e 2075 7369 6e67 2027 6766 7874 when using 'gfxt │ │ │ │ +00029080: 6572 6d27 0a20 2020 2020 666f 7220 7465 erm'. for te │ │ │ │ +00029090: 726d 696e 616c 206f 7574 7075 742e 0a0a rminal output... │ │ │ │ +000290a0: 1f0a 4669 6c65 3a20 6772 7562 2e69 6e66 ..File: grub.inf │ │ │ │ +000290b0: 6f2c 2020 4e6f 6465 3a20 6261 6472 616d o, Node: badram │ │ │ │ +000290c0: 2c20 204e 6578 743a 2062 6c6f 636b 6c69 , Next: blockli │ │ │ │ +000290d0: 7374 2c20 2050 7265 763a 2062 6163 6b67 st, Prev: backg │ │ │ │ +000290e0: 726f 756e 645f 696d 6167 652c 2020 5570 round_image, Up │ │ │ │ +000290f0: 3a20 436f 6d6d 616e 642d 6c69 6e65 2061 : Command-line a │ │ │ │ +00029100: 6e64 206d 656e 7520 656e 7472 7920 636f nd menu entry co │ │ │ │ +00029110: 6d6d 616e 6473 0a0a 3136 2e33 2e36 2062 mmands..16.3.6 b │ │ │ │ +00029120: 6164 7261 6d0a 2d2d 2d2d 2d2d 2d2d 2d2d adram.---------- │ │ │ │ +00029130: 2d2d 2d0a 0a20 2d2d 2043 6f6d 6d61 6e64 ---.. -- Command │ │ │ │ +00029140: 3a20 6261 6472 616d 2061 6464 722c 6d61 : badram addr,ma │ │ │ │ +00029150: 736b 5b2c 6164 6472 2c6d 6173 6b2e 2e2e sk[,addr,mask... │ │ │ │ +00029160: 5d0a 2020 2020 2046 696c 7465 7220 6f75 ]. Filter ou │ │ │ │ +00029170: 7420 6261 6420 5241 4d2e 0a0a 2020 2054 t bad RAM... T │ │ │ │ +00029180: 6869 7320 636f 6d6d 616e 6420 6e6f 7469 his command noti │ │ │ │ +00029190: 6669 6573 2074 6865 206d 656d 6f72 7920 fies the memory │ │ │ │ +000291a0: 6d61 6e61 6765 7220 7468 6174 2073 7065 manager that spe │ │ │ │ +000291b0: 6369 6669 6564 2072 6567 696f 6e73 206f cified regions o │ │ │ │ +000291c0: 660a 5241 4d20 6f75 6768 7420 746f 2062 f.RAM ought to b │ │ │ │ +000291d0: 6520 6669 6c74 6572 6564 206f 7574 2028 e filtered out ( │ │ │ │ +000291e0: 7573 7561 6c6c 792c 2062 6563 6175 7365 usually, because │ │ │ │ +000291f0: 2074 6865 7927 7265 2064 616d 6167 6564 they're damaged │ │ │ │ +00029200: 292e 2020 5468 6973 0a72 656d 6169 6e73 ). This.remains │ │ │ │ +00029210: 2069 6e20 6566 6665 6374 2061 6674 6572 in effect after │ │ │ │ +00029220: 2061 2070 6179 6c6f 6164 206b 6572 6e65 a payload kerne │ │ │ │ +00029230: 6c20 6861 7320 6265 656e 206c 6f61 6465 l has been loade │ │ │ │ +00029240: 6420 6279 2047 5255 422c 2061 730a 6c6f d by GRUB, as.lo │ │ │ │ +00029250: 6e67 2061 7320 7468 6520 6c6f 6164 6564 ng as the loaded │ │ │ │ +00029260: 206b 6572 6e65 6c20 6f62 7461 696e 7320 kernel obtains │ │ │ │ +00029270: 6974 7320 6d65 6d6f 7279 206d 6170 2066 its memory map f │ │ │ │ +00029280: 726f 6d20 4752 5542 2e20 4b65 726e 656c rom GRUB. Kernel │ │ │ │ +00029290: 7320 7468 6174 0a73 7570 706f 7274 2074 s that.support t │ │ │ │ +000292a0: 6869 7320 696e 636c 7564 6520 4c69 6e75 his include Linu │ │ │ │ +000292b0: 782c 2047 4e55 204d 6163 682c 2074 6865 x, GNU Mach, the │ │ │ │ +000292c0: 206b 6572 6e65 6c20 6f66 2046 7265 6542 kernel of FreeB │ │ │ │ +000292d0: 5344 2061 6e64 0a4d 756c 7469 626f 6f74 SD and.Multiboot │ │ │ │ +000292e0: 206b 6572 6e65 6c73 2069 6e20 6765 6e65 kernels in gene │ │ │ │ +000292f0: 7261 6c2e 0a0a 2020 2053 796e 7461 7820 ral... Syntax │ │ │ │ +00029300: 6973 2074 6865 2073 616d 6520 6173 2070 is the same as p │ │ │ │ +00029310: 726f 7669 6465 6420 6279 2074 6865 204d rovided by the M │ │ │ │ +00029320: 656d 7465 7374 3836 2b20 7574 696c 6974 emtest86+ utilit │ │ │ │ +00029330: 790a 2868 7474 703a 2f2f 7777 772e 6d65 y.(http://www.me │ │ │ │ +00029340: 6d74 6573 742e 6f72 672f 293a 2061 206c mtest.org/): a l │ │ │ │ +00029350: 6973 7420 6f66 2061 6464 7265 7373 2f6d ist of address/m │ │ │ │ +00029360: 6173 6b20 7061 6972 732e 2020 4769 7665 ask pairs. Give │ │ │ │ +00029370: 6e20 610a 7061 6765 2d61 6c69 676e 6564 n a.page-aligned │ │ │ │ +00029380: 2061 6464 7265 7373 2061 6e64 2061 2062 address and a b │ │ │ │ +00029390: 6173 6520 6164 6472 6573 7320 2f20 6d61 ase address / ma │ │ │ │ +000293a0: 736b 2070 6169 722c 2069 6620 616c 6c20 sk pair, if all │ │ │ │ +000293b0: 7468 6520 6269 7473 206f 660a 7468 6520 the bits of.the │ │ │ │ +000293c0: 7061 6765 2d61 6c69 676e 6564 2061 6464 page-aligned add │ │ │ │ +000293d0: 7265 7373 2074 6861 7420 6172 6520 656e ress that are en │ │ │ │ +000293e0: 6162 6c65 6420 6279 2074 6865 206d 6173 abled by the mas │ │ │ │ +000293f0: 6b20 6d61 7463 6820 7769 7468 2074 6865 k match with the │ │ │ │ +00029400: 0a62 6173 6520 6164 6472 6573 732c 2069 .base address, i │ │ │ │ +00029410: 7420 6d65 616e 7320 7468 6973 2070 6167 t means this pag │ │ │ │ +00029420: 6520 6973 2074 6f20 6265 2066 696c 7465 e is to be filte │ │ │ │ +00029430: 7265 642e 2020 5468 6973 2073 796e 7461 red. This synta │ │ │ │ +00029440: 7820 6d61 6b65 730a 6974 2065 6173 7920 x makes.it easy │ │ │ │ +00029450: 746f 2072 6570 7265 7365 6e74 2070 6174 to represent pat │ │ │ │ +00029460: 7465 726e 7320 7468 6174 2061 7265 206f terns that are o │ │ │ │ +00029470: 6674 656e 2072 6573 756c 7420 6f66 206d ften result of m │ │ │ │ +00029480: 656d 6f72 7920 6461 6d61 6765 2c0a 6475 emory damage,.du │ │ │ │ +00029490: 6520 746f 2070 6879 7369 6361 6c20 6469 e to physical di │ │ │ │ +000294a0: 7374 7269 6275 7469 6f6e 206f 6620 6d65 stribution of me │ │ │ │ +000294b0: 6d6f 7279 2063 656c 6c73 2e0a 0a20 2020 mory cells... │ │ │ │ +000294c0: 5468 6520 636f 6d6d 616e 6420 6973 2073 The command is s │ │ │ │ +000294d0: 696d 696c 6172 2074 6f20 2763 7574 6d65 imilar to 'cutme │ │ │ │ +000294e0: 6d27 2063 6f6d 6d61 6e64 2e0a 0a20 2020 m' command... │ │ │ │ +000294f0: 4e6f 7465 3a20 5468 6520 636f 6d6d 616e Note: The comman │ │ │ │ +00029500: 6420 6973 206e 6f74 2061 6c6c 6f77 6564 d is not allowed │ │ │ │ +00029510: 2077 6865 6e20 6c6f 636b 646f 776e 2069 when lockdown i │ │ │ │ +00029520: 7320 656e 666f 7263 6564 2028 2a6e 6f74 s enforced (*not │ │ │ │ +00029530: 650a 4c6f 636b 646f 776e 3a3a 292e 2020 e.Lockdown::). │ │ │ │ +00029540: 5468 6973 2070 7265 7665 6e74 7320 7265 This prevents re │ │ │ │ +00029550: 6d6f 7669 6e67 2045 4649 206d 656d 6f72 moving EFI memor │ │ │ │ +00029560: 7920 7265 6769 6f6e 7320 746f 2070 6f74 y regions to pot │ │ │ │ +00029570: 656e 7469 616c 6c79 0a73 7562 7665 7274 entially.subvert │ │ │ │ +00029580: 2074 6865 2073 6563 7572 6974 7920 6d65 the security me │ │ │ │ +00029590: 6368 616e 6973 6d73 2070 726f 7669 6465 chanisms provide │ │ │ │ +000295a0: 6420 6279 2074 6865 2055 4546 4920 7365 d by the UEFI se │ │ │ │ +000295b0: 6375 7265 2062 6f6f 742e 0a0a 1f0a 4669 cure boot.....Fi │ │ │ │ +000295c0: 6c65 3a20 6772 7562 2e69 6e66 6f2c 2020 le: grub.info, │ │ │ │ +000295d0: 4e6f 6465 3a20 626c 6f63 6b6c 6973 742c Node: blocklist, │ │ │ │ +000295e0: 2020 4e65 7874 3a20 626f 6f74 2c20 2050 Next: boot, P │ │ │ │ +000295f0: 7265 763a 2062 6164 7261 6d2c 2020 5570 rev: badram, Up │ │ │ │ +00029600: 3a20 436f 6d6d 616e 642d 6c69 6e65 2061 : Command-line a │ │ │ │ +00029610: 6e64 206d 656e 7520 656e 7472 7920 636f nd menu entry co │ │ │ │ +00029620: 6d6d 616e 6473 0a0a 3136 2e33 2e37 2062 mmands..16.3.7 b │ │ │ │ +00029630: 6c6f 636b 6c69 7374 0a2d 2d2d 2d2d 2d2d locklist.------- │ │ │ │ +00029640: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2043 ---------.. -- C │ │ │ │ +00029650: 6f6d 6d61 6e64 3a20 626c 6f63 6b6c 6973 ommand: blocklis │ │ │ │ +00029660: 7420 6669 6c65 0a20 2020 2020 5072 696e t file. Prin │ │ │ │ +00029670: 7420 6120 626c 6f63 6b20 6c69 7374 2028 t a block list ( │ │ │ │ +00029680: 2a6e 6f74 6520 426c 6f63 6b20 6c69 7374 *note Block list │ │ │ │ +00029690: 2073 796e 7461 783a 3a29 2066 6f72 2046 syntax::) for F │ │ │ │ +000296a0: 494c 452e 0a0a 1f0a 4669 6c65 3a20 6772 ILE.....File: gr │ │ │ │ +000296b0: 7562 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ub.info, Node: │ │ │ │ +000296c0: 626f 6f74 2c20 204e 6578 743a 2063 6174 boot, Next: cat │ │ │ │ +000296d0: 2c20 2050 7265 763a 2062 6c6f 636b 6c69 , Prev: blockli │ │ │ │ +000296e0: 7374 2c20 2055 703a 2043 6f6d 6d61 6e64 st, Up: Command │ │ │ │ +000296f0: 2d6c 696e 6520 616e 6420 6d65 6e75 2065 -line and menu e │ │ │ │ +00029700: 6e74 7279 2063 6f6d 6d61 6e64 730a 0a31 ntry commands..1 │ │ │ │ +00029710: 362e 332e 3820 626f 6f74 0a2d 2d2d 2d2d 6.3.8 boot.----- │ │ │ │ +00029720: 2d2d 2d2d 2d2d 0a0a 202d 2d20 436f 6d6d ------.. -- Comm │ │ │ │ +00029730: 616e 643a 2062 6f6f 740a 2020 2020 2042 and: boot. B │ │ │ │ +00029740: 6f6f 7420 7468 6520 4f53 206f 7220 6368 oot the OS or ch │ │ │ │ +00029750: 6169 6e2d 6c6f 6164 6572 2077 6869 6368 ain-loader which │ │ │ │ +00029760: 2068 6173 2062 6565 6e20 6c6f 6164 6564 has been loaded │ │ │ │ +00029770: 2e20 204f 6e6c 7920 6e65 6365 7373 6172 . Only necessar │ │ │ │ +00029780: 790a 2020 2020 2069 6620 7275 6e6e 696e y. if runnin │ │ │ │ +00029790: 6720 7468 6520 6675 6c6c 7920 696e 7465 g the fully inte │ │ │ │ +000297a0: 7261 6374 6976 6520 636f 6d6d 616e 642d ractive command- │ │ │ │ +000297b0: 6c69 6e65 2028 6974 2069 7320 696d 706c line (it is impl │ │ │ │ +000297c0: 6963 6974 2061 740a 2020 2020 2074 6865 icit at. the │ │ │ │ +000297d0: 2065 6e64 206f 6620 6120 6d65 6e75 2065 end of a menu e │ │ │ │ +000297e0: 6e74 7279 292e 0a0a 1f0a 4669 6c65 3a20 ntry).....File: │ │ │ │ +000297f0: 6772 7562 2e69 6e66 6f2c 2020 4e6f 6465 grub.info, Node │ │ │ │ +00029800: 3a20 6361 742c 2020 4e65 7874 3a20 6368 : cat, Next: ch │ │ │ │ +00029810: 6169 6e6c 6f61 6465 722c 2020 5072 6576 ainloader, Prev │ │ │ │ +00029820: 3a20 626f 6f74 2c20 2055 703a 2043 6f6d : boot, Up: Com │ │ │ │ +00029830: 6d61 6e64 2d6c 696e 6520 616e 6420 6d65 mand-line and me │ │ │ │ +00029840: 6e75 2065 6e74 7279 2063 6f6d 6d61 6e64 nu entry command │ │ │ │ +00029850: 730a 0a31 362e 332e 3920 6361 740a 2d2d s..16.3.9 cat.-- │ │ │ │ +00029860: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 436f --------.. -- Co │ │ │ │ +00029870: 6d6d 616e 643a 2063 6174 205b 272d 2d64 mmand: cat ['--d │ │ │ │ +00029880: 6f73 275d 2066 696c 650a 2020 2020 2044 os'] file. D │ │ │ │ +00029890: 6973 706c 6179 2074 6865 2063 6f6e 7465 isplay the conte │ │ │ │ +000298a0: 6e74 7320 6f66 2074 6865 2066 696c 6520 nts of the file │ │ │ │ +000298b0: 4649 4c45 2e20 2054 6869 7320 636f 6d6d FILE. This comm │ │ │ │ +000298c0: 616e 6420 6d61 7920 6265 2075 7365 6675 and may be usefu │ │ │ │ +000298d0: 6c0a 2020 2020 2074 6f20 7265 6d69 6e64 l. to remind │ │ │ │ +000298e0: 2079 6f75 206f 6620 796f 7572 204f 5327 you of your OS' │ │ │ │ +000298f0: 7320 726f 6f74 2070 6172 7469 7469 6f6e s root partition │ │ │ │ +00029900: 3a0a 0a20 2020 2020 2020 2020 2067 7275 :.. gru │ │ │ │ +00029910: 623e 2063 6174 202f 6574 632f 6673 7461 b> cat /etc/fsta │ │ │ │ +00029920: 620a 0a20 2020 2020 4966 2074 6865 2027 b.. If the ' │ │ │ │ +00029930: 2d2d 646f 7327 206f 7074 696f 6e20 6973 --dos' option is │ │ │ │ +00029940: 2075 7365 642c 2074 6865 6e20 6361 7272 used, then carr │ │ │ │ +00029950: 6961 6765 2072 6574 7572 6e20 2f20 6e65 iage return / ne │ │ │ │ +00029960: 7720 6c69 6e65 0a20 2020 2020 7061 6972 w line. pair │ │ │ │ +00029970: 7320 7769 6c6c 2062 6520 6469 7370 6c61 s will be displa │ │ │ │ +00029980: 7965 6420 6173 2061 2073 696d 706c 6520 yed as a simple │ │ │ │ +00029990: 6e65 7720 6c69 6e65 2e20 204f 7468 6572 new line. Other │ │ │ │ +000299a0: 7769 7365 2c20 7468 650a 2020 2020 2063 wise, the. c │ │ │ │ +000299b0: 6172 7269 6167 6520 7265 7475 726e 2077 arriage return w │ │ │ │ +000299c0: 696c 6c20 6265 2064 6973 706c 6179 6564 ill be displayed │ │ │ │ +000299d0: 2061 7320 6120 636f 6e74 726f 6c20 6368 as a control ch │ │ │ │ +000299e0: 6172 6163 7465 7220 2827 3c64 3e27 2920 aracter ('') │ │ │ │ +000299f0: 746f 0a20 2020 2020 6d61 6b65 2069 7420 to. make it │ │ │ │ +00029a00: 6561 7369 6572 2074 6f20 7365 6520 7768 easier to see wh │ │ │ │ +00029a10: 656e 2062 6f6f 7420 7072 6f62 6c65 6d73 en boot problems │ │ │ │ +00029a20: 2061 7265 2063 6175 7365 6420 6279 2061 are caused by a │ │ │ │ +00029a30: 2066 696c 650a 2020 2020 2066 6f72 6d61 file. forma │ │ │ │ +00029a40: 7474 6564 2075 7369 6e67 2044 4f53 2d73 tted using DOS-s │ │ │ │ +00029a50: 7479 6c65 206c 696e 6520 656e 6469 6e67 tyle line ending │ │ │ │ +00029a60: 732e 0a0a 1f0a 4669 6c65 3a20 6772 7562 s.....File: grub │ │ │ │ +00029a70: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 6368 .info, Node: ch │ │ │ │ +00029a80: 6169 6e6c 6f61 6465 722c 2020 4e65 7874 ainloader, Next │ │ │ │ +00029a90: 3a20 636c 6561 722c 2020 5072 6576 3a20 : clear, Prev: │ │ │ │ +00029aa0: 6361 742c 2020 5570 3a20 436f 6d6d 616e cat, Up: Comman │ │ │ │ +00029ab0: 642d 6c69 6e65 2061 6e64 206d 656e 7520 d-line and menu │ │ │ │ +00029ac0: 656e 7472 7920 636f 6d6d 616e 6473 0a0a entry commands.. │ │ │ │ +00029ad0: 3136 2e33 2e31 3020 6368 6169 6e6c 6f61 16.3.10 chainloa │ │ │ │ +00029ae0: 6465 720a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d der.------------ │ │ │ │ +00029af0: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2043 6f6d -------.. -- Com │ │ │ │ +00029b00: 6d61 6e64 3a20 6368 6169 6e6c 6f61 6465 mand: chainloade │ │ │ │ +00029b10: 7220 5b27 2d2d 666f 7263 6527 5d20 6669 r ['--force'] fi │ │ │ │ +00029b20: 6c65 0a20 2020 2020 4c6f 6164 2046 494c le. Load FIL │ │ │ │ +00029b30: 4520 6173 2061 2063 6861 696e 2d6c 6f61 E as a chain-loa │ │ │ │ +00029b40: 6465 722e 2020 4c69 6b65 2061 6e79 206f der. Like any o │ │ │ │ +00029b50: 7468 6572 2066 696c 6520 6c6f 6164 6564 ther file loaded │ │ │ │ +00029b60: 2062 7920 7468 650a 2020 2020 2066 696c by the. fil │ │ │ │ +00029b70: 6573 7973 7465 6d20 636f 6465 2c20 6974 esystem code, it │ │ │ │ +00029b80: 2063 616e 2075 7365 2074 6865 2062 6c6f can use the blo │ │ │ │ +00029b90: 636b 6c69 7374 206e 6f74 6174 696f 6e20 cklist notation │ │ │ │ +00029ba0: 282a 6e6f 7465 2042 6c6f 636b 0a20 2020 (*note Block. │ │ │ │ +00029bb0: 2020 6c69 7374 2073 796e 7461 783a 3a29 list syntax::) │ │ │ │ +00029bc0: 2074 6f20 6772 6162 2074 6865 2066 6972 to grab the fir │ │ │ │ +00029bd0: 7374 2073 6563 746f 7220 6f66 2074 6865 st sector of the │ │ │ │ +00029be0: 2063 7572 7265 6e74 2070 6172 7469 7469 current partiti │ │ │ │ +00029bf0: 6f6e 0a20 2020 2020 7769 7468 2027 2b31 on. with '+1 │ │ │ │ +00029c00: 272e 2020 4966 2079 6f75 2073 7065 6369 '. If you speci │ │ │ │ +00029c10: 6679 2074 6865 206f 7074 696f 6e20 272d fy the option '- │ │ │ │ +00029c20: 2d66 6f72 6365 272c 2074 6865 6e20 6c6f -force', then lo │ │ │ │ +00029c30: 6164 2046 494c 450a 2020 2020 2066 6f72 ad FILE. for │ │ │ │ +00029c40: 6369 626c 792c 2077 6865 7468 6572 2069 cibly, whether i │ │ │ │ +00029c50: 7420 6861 7320 6120 636f 7272 6563 7420 t has a correct │ │ │ │ +00029c60: 7369 676e 6174 7572 6520 6f72 206e 6f74 signature or not │ │ │ │ +00029c70: 2e20 2054 6869 7320 6973 0a20 2020 2020 . This is. │ │ │ │ +00029c80: 7265 7175 6972 6564 2077 6865 6e20 796f required when yo │ │ │ │ +00029c90: 7520 7761 6e74 2074 6f20 6c6f 6164 2061 u want to load a │ │ │ │ +00029ca0: 2064 6566 6563 7469 7665 2062 6f6f 7420 defective boot │ │ │ │ +00029cb0: 6c6f 6164 6572 2c20 7375 6368 2061 7320 loader, such as │ │ │ │ +00029cc0: 5343 4f0a 2020 2020 2055 6e69 7857 6172 SCO. UnixWar │ │ │ │ +00029cd0: 6520 372e 312e 0a0a 1f0a 4669 6c65 3a20 e 7.1.....File: │ │ │ │ +00029ce0: 6772 7562 2e69 6e66 6f2c 2020 4e6f 6465 grub.info, Node │ │ │ │ +00029cf0: 3a20 636c 6561 722c 2020 4e65 7874 3a20 : clear, Next: │ │ │ │ +00029d00: 636d 6f73 636c 6561 6e2c 2020 5072 6576 cmosclean, Prev │ │ │ │ +00029d10: 3a20 6368 6169 6e6c 6f61 6465 722c 2020 : chainloader, │ │ │ │ +00029d20: 5570 3a20 436f 6d6d 616e 642d 6c69 6e65 Up: Command-line │ │ │ │ +00029d30: 2061 6e64 206d 656e 7520 656e 7472 7920 and menu entry │ │ │ │ +00029d40: 636f 6d6d 616e 6473 0a0a 3136 2e33 2e31 commands..16.3.1 │ │ │ │ +00029d50: 3120 636c 6561 720a 2d2d 2d2d 2d2d 2d2d 1 clear.-------- │ │ │ │ +00029d60: 2d2d 2d2d 2d0a 0a20 2d2d 2043 6f6d 6d61 -----.. -- Comma │ │ │ │ +00029d70: 6e64 3a20 636c 6561 720a 2020 2020 2043 nd: clear. C │ │ │ │ +00029d80: 6c65 6172 2074 6865 2073 6372 6565 6e2e lear the screen. │ │ │ │ +00029d90: 0a0a 1f0a 4669 6c65 3a20 6772 7562 2e69 ....File: grub.i │ │ │ │ +00029da0: 6e66 6f2c 2020 4e6f 6465 3a20 636d 6f73 nfo, Node: cmos │ │ │ │ +00029db0: 636c 6561 6e2c 2020 4e65 7874 3a20 636d clean, Next: cm │ │ │ │ +00029dc0: 6f73 6475 6d70 2c20 2050 7265 763a 2063 osdump, Prev: c │ │ │ │ +00029dd0: 6c65 6172 2c20 2055 703a 2043 6f6d 6d61 lear, Up: Comma │ │ │ │ +00029de0: 6e64 2d6c 696e 6520 616e 6420 6d65 6e75 nd-line and menu │ │ │ │ +00029df0: 2065 6e74 7279 2063 6f6d 6d61 6e64 730a entry commands. │ │ │ │ +00029e00: 0a31 362e 332e 3132 2063 6d6f 7363 6c65 .16.3.12 cmoscle │ │ │ │ +00029e10: 616e 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d an.------------- │ │ │ │ +00029e20: 2d2d 2d2d 0a0a 202d 2d20 436f 6d6d 616e ----.. -- Comman │ │ │ │ +00029e30: 643a 2063 6d6f 7363 6c65 616e 2062 7974 d: cmosclean byt │ │ │ │ +00029e40: 653a 6269 740a 2020 2020 2043 6c65 6172 e:bit. Clear │ │ │ │ +00029e50: 2076 616c 7565 206f 6620 6269 7420 696e value of bit in │ │ │ │ +00029e60: 2043 4d4f 5320 6174 206c 6f63 6174 696f CMOS at locatio │ │ │ │ +00029e70: 6e20 4259 5445 3a42 4954 2e20 2054 6869 n BYTE:BIT. Thi │ │ │ │ +00029e80: 7320 636f 6d6d 616e 6420 6973 0a20 2020 s command is. │ │ │ │ +00029e90: 2020 6176 6169 6c61 626c 6520 6f6e 6c79 available only │ │ │ │ +00029ea0: 206f 6e20 706c 6174 666f 726d 7320 7468 on platforms th │ │ │ │ +00029eb0: 6174 2073 7570 706f 7274 2043 4d4f 532e at support CMOS. │ │ │ │ +00029ec0: 0a0a 1f0a 4669 6c65 3a20 6772 7562 2e69 ....File: grub.i │ │ │ │ +00029ed0: 6e66 6f2c 2020 4e6f 6465 3a20 636d 6f73 nfo, Node: cmos │ │ │ │ +00029ee0: 6475 6d70 2c20 204e 6578 743a 2063 6d6f dump, Next: cmo │ │ │ │ +00029ef0: 7374 6573 742c 2020 5072 6576 3a20 636d stest, Prev: cm │ │ │ │ +00029f00: 6f73 636c 6561 6e2c 2020 5570 3a20 436f osclean, Up: Co │ │ │ │ +00029f10: 6d6d 616e 642d 6c69 6e65 2061 6e64 206d mmand-line and m │ │ │ │ +00029f20: 656e 7520 656e 7472 7920 636f 6d6d 616e enu entry comman │ │ │ │ +00029f30: 6473 0a0a 3136 2e33 2e31 3320 636d 6f73 ds..16.3.13 cmos │ │ │ │ +00029f40: 6475 6d70 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d dump.----------- │ │ │ │ +00029f50: 2d2d 2d2d 2d0a 0a20 2d2d 2044 756d 703a -----.. -- Dump: │ │ │ │ +00029f60: 2043 4d4f 5320 636f 6e74 656e 7473 0a20 CMOS contents. │ │ │ │ +00029f70: 2020 2020 4475 6d70 2066 756c 6c20 434d Dump full CM │ │ │ │ +00029f80: 4f53 2063 6f6e 7465 6e74 7320 6173 2068 OS contents as h │ │ │ │ +00029f90: 6578 6164 6563 696d 616c 2076 616c 7565 exadecimal value │ │ │ │ +00029fa0: 732e 2020 5468 6973 2063 6f6d 6d61 6e64 s. This command │ │ │ │ +00029fb0: 2069 730a 2020 2020 2061 7661 696c 6162 is. availab │ │ │ │ +00029fc0: 6c65 206f 6e6c 7920 6f6e 2070 6c61 7466 le only on platf │ │ │ │ +00029fd0: 6f72 6d73 2074 6861 7420 7375 7070 6f72 orms that suppor │ │ │ │ +00029fe0: 7420 434d 4f53 2e0a 0a1f 0a46 696c 653a t CMOS.....File: │ │ │ │ +00029ff0: 2067 7275 622e 696e 666f 2c20 204e 6f64 grub.info, Nod │ │ │ │ +0002a000: 653a 2063 6d6f 7374 6573 742c 2020 4e65 e: cmostest, Ne │ │ │ │ +0002a010: 7874 3a20 636d 702c 2020 5072 6576 3a20 xt: cmp, Prev: │ │ │ │ +0002a020: 636d 6f73 6475 6d70 2c20 2055 703a 2043 cmosdump, Up: C │ │ │ │ +0002a030: 6f6d 6d61 6e64 2d6c 696e 6520 616e 6420 ommand-line and │ │ │ │ +0002a040: 6d65 6e75 2065 6e74 7279 2063 6f6d 6d61 menu entry comma │ │ │ │ +0002a050: 6e64 730a 0a31 362e 332e 3134 2063 6d6f nds..16.3.14 cmo │ │ │ │ +0002a060: 7374 6573 740a 2d2d 2d2d 2d2d 2d2d 2d2d stest.---------- │ │ │ │ +0002a070: 2d2d 2d2d 2d2d 0a0a 202d 2d20 436f 6d6d ------.. -- Comm │ │ │ │ +0002a080: 616e 643a 2063 6d6f 7374 6573 7420 6279 and: cmostest by │ │ │ │ +0002a090: 7465 3a62 6974 0a20 2020 2020 5465 7374 te:bit. Test │ │ │ │ +0002a0a0: 2076 616c 7565 206f 6620 6269 7420 696e value of bit in │ │ │ │ +0002a0b0: 2043 4d4f 5320 6174 206c 6f63 6174 696f CMOS at locatio │ │ │ │ +0002a0c0: 6e20 4259 5445 3a42 4954 2e20 2045 7869 n BYTE:BIT. Exi │ │ │ │ +0002a0d0: 7420 7374 6174 7573 2069 730a 2020 2020 t status is. │ │ │ │ +0002a0e0: 207a 6572 6f20 6966 2062 6974 2069 7320 zero if bit is │ │ │ │ +0002a0f0: 7365 742c 206e 6f6e 207a 6572 6f20 6f74 set, non zero ot │ │ │ │ +0002a100: 6865 7277 6973 652e 2020 5468 6973 2063 herwise. This c │ │ │ │ +0002a110: 6f6d 6d61 6e64 2069 7320 6176 6169 6c61 ommand is availa │ │ │ │ +0002a120: 626c 650a 2020 2020 206f 6e6c 7920 6f6e ble. only on │ │ │ │ +0002a130: 2070 6c61 7466 6f72 6d73 2074 6861 7420 platforms that │ │ │ │ +0002a140: 7375 7070 6f72 7420 434d 4f53 2e0a 0a1f support CMOS.... │ │ │ │ +0002a150: 0a46 696c 653a 2067 7275 622e 696e 666f .File: grub.info │ │ │ │ +0002a160: 2c20 204e 6f64 653a 2063 6d70 2c20 204e , Node: cmp, N │ │ │ │ +0002a170: 6578 743a 2063 6f6e 6669 6766 696c 652c ext: configfile, │ │ │ │ +0002a180: 2020 5072 6576 3a20 636d 6f73 7465 7374 Prev: cmostest │ │ │ │ +0002a190: 2c20 2055 703a 2043 6f6d 6d61 6e64 2d6c , Up: Command-l │ │ │ │ +0002a1a0: 696e 6520 616e 6420 6d65 6e75 2065 6e74 ine and menu ent │ │ │ │ +0002a1b0: 7279 2063 6f6d 6d61 6e64 730a 0a31 362e ry commands..16. │ │ │ │ +0002a1c0: 332e 3135 2063 6d70 0a2d 2d2d 2d2d 2d2d 3.15 cmp.------- │ │ │ │ +0002a1d0: 2d2d 2d2d 0a0a 202d 2d20 436f 6d6d 616e ----.. -- Comman │ │ │ │ +0002a1e0: 643a 2063 6d70 2066 696c 6531 2066 696c d: cmp file1 fil │ │ │ │ +0002a1f0: 6532 0a20 2020 2020 436f 6d70 6172 6520 e2. Compare │ │ │ │ +0002a200: 7468 6520 6669 6c65 2046 494c 4531 2077 the file FILE1 w │ │ │ │ +0002a210: 6974 6820 7468 6520 6669 6c65 2046 494c ith the file FIL │ │ │ │ +0002a220: 4532 2e20 2049 6620 7468 6579 2064 6966 E2. If they dif │ │ │ │ +0002a230: 6665 7220 696e 0a20 2020 2020 7369 7a65 fer in. size │ │ │ │ +0002a240: 2c20 7072 696e 7420 7468 6520 7369 7a65 , print the size │ │ │ │ +0002a250: 7320 6c69 6b65 2074 6869 733a 0a0a 2020 s like this:.. │ │ │ │ +0002a260: 2020 2020 2020 2020 4469 6666 6572 2069 Differ i │ │ │ │ +0002a270: 6e20 7369 7a65 3a20 3078 3132 3334 205b n size: 0x1234 [ │ │ │ │ +0002a280: 666f 6f5d 2c20 3078 3433 3231 205b 6261 foo], 0x4321 [ba │ │ │ │ +0002a290: 725d 0a0a 2020 2020 2049 6620 7468 6520 r].. If the │ │ │ │ +0002a2a0: 7369 7a65 7320 6172 6520 6571 7561 6c20 sizes are equal │ │ │ │ +0002a2b0: 6275 7420 7468 6520 6279 7465 7320 6174 but the bytes at │ │ │ │ +0002a2c0: 2061 6e20 6f66 6673 6574 2064 6966 6665 an offset diffe │ │ │ │ +0002a2d0: 722c 2074 6865 6e0a 2020 2020 2070 7269 r, then. pri │ │ │ │ +0002a2e0: 6e74 2074 6865 2062 7974 6573 206c 696b nt the bytes lik │ │ │ │ +0002a2f0: 6520 7468 6973 3a0a 0a20 2020 2020 2020 e this:.. │ │ │ │ +0002a300: 2020 2044 6966 6665 7220 6174 2074 6865 Differ at the │ │ │ │ +0002a310: 206f 6666 7365 7420 3737 373a 2030 7862 offset 777: 0xb │ │ │ │ +0002a320: 6520 5b66 6f6f 5d2c 2030 7865 6620 5b62 e [foo], 0xef [b │ │ │ │ +0002a330: 6172 5d0a 0a20 2020 2020 4966 2074 6865 ar].. If the │ │ │ │ +0002a340: 7920 6172 6520 636f 6d70 6c65 7465 6c79 y are completely │ │ │ │ +0002a350: 2069 6465 6e74 6963 616c 2c20 6e6f 7468 identical, noth │ │ │ │ +0002a360: 696e 6720 7769 6c6c 2062 6520 7072 696e ing will be prin │ │ │ │ +0002a370: 7465 642e 0a0a 1f0a 4669 6c65 3a20 6772 ted.....File: gr │ │ │ │ +0002a380: 7562 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ub.info, Node: │ │ │ │ +0002a390: 636f 6e66 6967 6669 6c65 2c20 204e 6578 configfile, Nex │ │ │ │ +0002a3a0: 743a 2063 7075 6964 2c20 2050 7265 763a t: cpuid, Prev: │ │ │ │ +0002a3b0: 2063 6d70 2c20 2055 703a 2043 6f6d 6d61 cmp, Up: Comma │ │ │ │ +0002a3c0: 6e64 2d6c 696e 6520 616e 6420 6d65 6e75 nd-line and menu │ │ │ │ +0002a3d0: 2065 6e74 7279 2063 6f6d 6d61 6e64 730a entry commands. │ │ │ │ +0002a3e0: 0a31 362e 332e 3136 2063 6f6e 6669 6766 .16.3.16 configf │ │ │ │ +0002a3f0: 696c 650a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ile.------------ │ │ │ │ +0002a400: 2d2d 2d2d 2d2d 0a0a 202d 2d20 436f 6d6d ------.. -- Comm │ │ │ │ +0002a410: 616e 643a 2063 6f6e 6669 6766 696c 6520 and: configfile │ │ │ │ +0002a420: 6669 6c65 0a20 2020 2020 4c6f 6164 2046 file. Load F │ │ │ │ +0002a430: 494c 4520 6173 2061 2063 6f6e 6669 6775 ILE as a configu │ │ │ │ +0002a440: 7261 7469 6f6e 2066 696c 652e 2020 4966 ration file. If │ │ │ │ +0002a450: 2046 494c 4520 6465 6669 6e65 7320 616e FILE defines an │ │ │ │ +0002a460: 7920 6d65 6e75 0a20 2020 2020 656e 7472 y menu. entr │ │ │ │ +0002a470: 6965 732c 2074 6865 6e20 7368 6f77 2061 ies, then show a │ │ │ │ +0002a480: 206d 656e 7520 636f 6e74 6169 6e69 6e67 menu containing │ │ │ │ +0002a490: 2074 6865 6d20 696d 6d65 6469 6174 656c them immediatel │ │ │ │ +0002a4a0: 792e 2020 416e 790a 2020 2020 2065 6e76 y. Any. env │ │ │ │ +0002a4b0: 6972 6f6e 6d65 6e74 2076 6172 6961 626c ironment variabl │ │ │ │ +0002a4c0: 6520 6368 616e 6765 7320 6d61 6465 2062 e changes made b │ │ │ │ +0002a4d0: 7920 7468 6520 636f 6d6d 616e 6473 2069 y the commands i │ │ │ │ +0002a4e0: 6e20 4649 4c45 2077 696c 6c20 6e6f 740a n FILE will not. │ │ │ │ +0002a4f0: 2020 2020 2062 6520 7072 6573 6572 7665 be preserve │ │ │ │ +0002a500: 6420 6166 7465 7220 2763 6f6e 6669 6766 d after 'configf │ │ │ │ +0002a510: 696c 6527 2072 6574 7572 6e73 2e0a 0a1f ile' returns.... │ │ │ │ +0002a520: 0a46 696c 653a 2067 7275 622e 696e 666f .File: grub.info │ │ │ │ +0002a530: 2c20 204e 6f64 653a 2063 7075 6964 2c20 , Node: cpuid, │ │ │ │ +0002a540: 204e 6578 743a 2063 7263 2c20 2050 7265 Next: crc, Pre │ │ │ │ +0002a550: 763a 2063 6f6e 6669 6766 696c 652c 2020 v: configfile, │ │ │ │ +0002a560: 5570 3a20 436f 6d6d 616e 642d 6c69 6e65 Up: Command-line │ │ │ │ +0002a570: 2061 6e64 206d 656e 7520 656e 7472 7920 and menu entry │ │ │ │ +0002a580: 636f 6d6d 616e 6473 0a0a 3136 2e33 2e31 commands..16.3.1 │ │ │ │ +0002a590: 3720 6370 7569 640a 2d2d 2d2d 2d2d 2d2d 7 cpuid.-------- │ │ │ │ +0002a5a0: 2d2d 2d2d 2d0a 0a20 2d2d 2043 6f6d 6d61 -----.. -- Comma │ │ │ │ +0002a5b0: 6e64 3a20 6370 7569 6420 5b2d 6c5d 205b nd: cpuid [-l] [ │ │ │ │ +0002a5c0: 2d70 5d0a 2020 2020 2043 6865 636b 2066 -p]. Check f │ │ │ │ +0002a5d0: 6f72 2043 5055 2066 6561 7475 7265 732e or CPU features. │ │ │ │ +0002a5e0: 2020 5468 6973 2063 6f6d 6d61 6e64 2069 This command i │ │ │ │ +0002a5f0: 7320 6f6e 6c79 2061 7661 696c 6162 6c65 s only available │ │ │ │ +0002a600: 206f 6e20 7838 360a 2020 2020 2073 7973 on x86. sys │ │ │ │ +0002a610: 7465 6d73 2e0a 0a20 2020 2020 5769 7468 tems... With │ │ │ │ +0002a620: 2074 6865 2027 2d6c 2720 6f70 7469 6f6e the '-l' option │ │ │ │ +0002a630: 2c20 7265 7475 726e 2074 7275 6520 6966 , return true if │ │ │ │ +0002a640: 2074 6865 2043 5055 2073 7570 706f 7274 the CPU support │ │ │ │ +0002a650: 7320 6c6f 6e67 206d 6f64 650a 2020 2020 s long mode. │ │ │ │ +0002a660: 2028 3634 2d62 6974 292e 0a0a 2020 2020 (64-bit)... │ │ │ │ +0002a670: 2057 6974 6820 7468 6520 272d 7027 206f With the '-p' o │ │ │ │ +0002a680: 7074 696f 6e2c 2072 6574 7572 6e20 7472 ption, return tr │ │ │ │ +0002a690: 7565 2069 6620 7468 6520 4350 5520 7375 ue if the CPU su │ │ │ │ +0002a6a0: 7070 6f72 7473 2050 6879 7369 6361 6c0a pports Physical. │ │ │ │ +0002a6b0: 2020 2020 2041 6464 7265 7373 2045 7874 Address Ext │ │ │ │ +0002a6c0: 656e 7369 6f6e 2028 5041 4529 2e0a 0a20 ension (PAE)... │ │ │ │ +0002a6d0: 2020 2020 4966 2069 6e76 6f6b 6564 2077 If invoked w │ │ │ │ +0002a6e0: 6974 686f 7574 206f 7074 696f 6e73 2c20 ithout options, │ │ │ │ +0002a6f0: 7468 6973 2063 6f6d 6d61 6e64 2063 7572 this command cur │ │ │ │ +0002a700: 7265 6e74 6c79 2062 6568 6176 6573 2061 rently behaves a │ │ │ │ +0002a710: 7320 6966 2069 740a 2020 2020 2068 6164 s if it. had │ │ │ │ +0002a720: 2062 6565 6e20 696e 766f 6b65 6420 7769 been invoked wi │ │ │ │ +0002a730: 7468 2027 2d6c 272e 2020 5468 6973 206d th '-l'. This m │ │ │ │ +0002a740: 6179 2063 6861 6e67 6520 696e 2074 6865 ay change in the │ │ │ │ +0002a750: 2066 7574 7572 652e 0a0a 1f0a 4669 6c65 future.....File │ │ │ │ +0002a760: 3a20 6772 7562 2e69 6e66 6f2c 2020 4e6f : grub.info, No │ │ │ │ +0002a770: 6465 3a20 6372 632c 2020 4e65 7874 3a20 de: crc, Next: │ │ │ │ +0002a780: 6372 7970 746f 6d6f 756e 742c 2020 5072 cryptomount, Pr │ │ │ │ +0002a790: 6576 3a20 6370 7569 642c 2020 5570 3a20 ev: cpuid, Up: │ │ │ │ +0002a7a0: 436f 6d6d 616e 642d 6c69 6e65 2061 6e64 Command-line and │ │ │ │ +0002a7b0: 206d 656e 7520 656e 7472 7920 636f 6d6d menu entry comm │ │ │ │ +0002a7c0: 616e 6473 0a0a 3136 2e33 2e31 3820 6372 ands..16.3.18 cr │ │ │ │ +0002a7d0: 630a 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 c.-----------.. │ │ │ │ +0002a7e0: 2d2d 2043 6f6d 6d61 6e64 3a20 6372 6320 -- Command: crc │ │ │ │ +0002a7f0: 6172 6720 2e2e 2e0a 2020 2020 2041 6c69 arg .... Ali │ │ │ │ +0002a800: 6173 2066 6f72 2027 6861 7368 7375 6d20 as for 'hashsum │ │ │ │ +0002a810: 2d2d 6861 7368 2063 7263 3332 2061 7267 --hash crc32 arg │ │ │ │ +0002a820: 202e 2e2e 272e 2020 5365 6520 636f 6d6d ...'. See comm │ │ │ │ +0002a830: 616e 6420 2768 6173 6873 756d 270a 2020 and 'hashsum'. │ │ │ │ +0002a840: 2020 2028 2a6e 6f74 6520 6861 7368 7375 (*note hashsu │ │ │ │ +0002a850: 6d3a 3a29 2066 6f72 2066 756c 6c20 6465 m::) for full de │ │ │ │ +0002a860: 7363 7269 7074 696f 6e2e 0a0a 1f0a 4669 scription.....Fi │ │ │ │ +0002a870: 6c65 3a20 6772 7562 2e69 6e66 6f2c 2020 le: grub.info, │ │ │ │ +0002a880: 4e6f 6465 3a20 6372 7970 746f 6d6f 756e Node: cryptomoun │ │ │ │ +0002a890: 742c 2020 4e65 7874 3a20 6375 746d 656d t, Next: cutmem │ │ │ │ +0002a8a0: 2c20 2050 7265 763a 2063 7263 2c20 2055 , Prev: crc, U │ │ │ │ +0002a8b0: 703a 2043 6f6d 6d61 6e64 2d6c 696e 6520 p: Command-line │ │ │ │ +0002a8c0: 616e 6420 6d65 6e75 2065 6e74 7279 2063 and menu entry c │ │ │ │ +0002a8d0: 6f6d 6d61 6e64 730a 0a31 362e 332e 3139 ommands..16.3.19 │ │ │ │ +0002a8e0: 2063 7279 7074 6f6d 6f75 6e74 0a2d 2d2d cryptomount.--- │ │ │ │ +0002a8f0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ +0002a900: 0a0a 202d 2d20 436f 6d6d 616e 643a 2063 .. -- Command: c │ │ │ │ +0002a910: 7279 7074 6f6d 6f75 6e74 2064 6576 6963 ryptomount devic │ │ │ │ +0002a920: 657c 272d 7527 2075 7569 647c 272d 6127 e|'-u' uuid|'-a' │ │ │ │ +0002a930: 7c27 2d62 270a 2020 2020 2053 6574 7570 |'-b'. Setup │ │ │ │ +0002a940: 2061 6363 6573 7320 746f 2065 6e63 7279 access to encry │ │ │ │ +0002a950: 7074 6564 2064 6576 6963 652e 2020 4966 pted device. If │ │ │ │ +0002a960: 206e 6563 6573 7361 7279 2c20 7061 7373 necessary, pass │ │ │ │ +0002a970: 7068 7261 7365 2069 730a 2020 2020 2072 phrase is. r │ │ │ │ +0002a980: 6571 7565 7374 6564 2069 6e74 6572 6163 equested interac │ │ │ │ +0002a990: 7469 7665 6c79 2e20 204f 7074 696f 6e20 tively. Option │ │ │ │ +0002a9a0: 4445 5649 4345 2063 6f6e 6669 6775 7265 DEVICE configure │ │ │ │ +0002a9b0: 7320 7370 6563 6966 6963 2067 7275 620a s specific grub. │ │ │ │ +0002a9c0: 2020 2020 2064 6576 6963 6520 282a 6e6f device (*no │ │ │ │ +0002a9d0: 7465 204e 616d 696e 6720 636f 6e76 656e te Naming conven │ │ │ │ +0002a9e0: 7469 6f6e 3a3a 293b 206f 7074 696f 6e20 tion::); option │ │ │ │ +0002a9f0: 272d 7527 2055 5549 4420 636f 6e66 6967 '-u' UUID config │ │ │ │ +0002aa00: 7572 6573 0a20 2020 2020 6465 7669 6365 ures. device │ │ │ │ +0002aa10: 2077 6974 6820 7370 6563 6966 6965 6420 with specified │ │ │ │ +0002aa20: 5555 4944 3b20 6f70 7469 6f6e 2027 2d61 UUID; option '-a │ │ │ │ +0002aa30: 2720 636f 6e66 6967 7572 6573 2061 6c6c ' configures all │ │ │ │ +0002aa40: 2064 6574 6563 7465 640a 2020 2020 2065 detected. e │ │ │ │ +0002aa50: 6e63 7279 7074 6564 2064 6576 6963 6573 ncrypted devices │ │ │ │ +0002aa60: 3b20 6f70 7469 6f6e 2027 2d62 2720 636f ; option '-b' co │ │ │ │ +0002aa70: 6e66 6967 7572 6573 2061 6c6c 2067 656c nfigures all gel │ │ │ │ +0002aa80: 6920 636f 6e74 6169 6e65 7273 2074 6861 i containers tha │ │ │ │ +0002aa90: 740a 2020 2020 2068 6176 6520 626f 6f74 t. have boot │ │ │ │ +0002aaa0: 2066 6c61 6720 7365 742e 0a0a 2020 2020 flag set... │ │ │ │ +0002aab0: 2047 5255 4220 7375 706f 7274 7320 6465 GRUB suports de │ │ │ │ +0002aac0: 7669 6365 7320 656e 6372 7970 7465 6420 vices encrypted │ │ │ │ +0002aad0: 7573 696e 6720 4c55 4b53 2061 6e64 2067 using LUKS and g │ │ │ │ +0002aae0: 656c 692e 2020 4e6f 7465 2074 6861 740a eli. Note that. │ │ │ │ +0002aaf0: 2020 2020 206e 6563 6573 7361 7279 206d necessary m │ │ │ │ +0002ab00: 6f64 756c 6573 2028 4c55 4b53 2061 6e64 odules (LUKS and │ │ │ │ +0002ab10: 2047 454c 4929 2068 6176 6520 746f 2062 GELI) have to b │ │ │ │ +0002ab20: 6520 6c6f 6164 6564 206d 616e 7561 6c6c e loaded manuall │ │ │ │ +0002ab30: 7920 6265 666f 7265 0a20 2020 2020 7468 y before. th │ │ │ │ +0002ab40: 6973 2063 6f6d 6d61 6e64 2063 616e 2062 is command can b │ │ │ │ +0002ab50: 6520 7573 6564 2e0a 0a1f 0a46 696c 653a e used.....File: │ │ │ │ +0002ab60: 2067 7275 622e 696e 666f 2c20 204e 6f64 grub.info, Nod │ │ │ │ +0002ab70: 653a 2063 7574 6d65 6d2c 2020 4e65 7874 e: cutmem, Next │ │ │ │ +0002ab80: 3a20 6461 7465 2c20 2050 7265 763a 2063 : date, Prev: c │ │ │ │ +0002ab90: 7279 7074 6f6d 6f75 6e74 2c20 2055 703a ryptomount, Up: │ │ │ │ +0002aba0: 2043 6f6d 6d61 6e64 2d6c 696e 6520 616e Command-line an │ │ │ │ +0002abb0: 6420 6d65 6e75 2065 6e74 7279 2063 6f6d d menu entry com │ │ │ │ +0002abc0: 6d61 6e64 730a 0a31 362e 332e 3230 2063 mands..16.3.20 c │ │ │ │ +0002abd0: 7574 6d65 6d0a 2d2d 2d2d 2d2d 2d2d 2d2d utmem.---------- │ │ │ │ +0002abe0: 2d2d 2d2d 0a0a 202d 2d20 436f 6d6d 616e ----.. -- Comman │ │ │ │ +0002abf0: 643a 2063 7574 6d65 6d20 6672 6f6d 5b4b d: cutmem from[K │ │ │ │ +0002ac00: 7c4d 7c47 5d20 746f 5b4b 7c4d 7c47 5d0a |M|G] to[K|M|G]. │ │ │ │ +0002ac10: 2020 2020 2052 656d 6f76 6520 616e 7920 Remove any │ │ │ │ +0002ac20: 6d65 6d6f 7279 2072 6567 696f 6e73 2069 memory regions i │ │ │ │ +0002ac30: 6e20 7370 6563 6966 6965 6420 7261 6e67 n specified rang │ │ │ │ +0002ac40: 652e 0a0a 2020 2054 6869 7320 636f 6d6d e... This comm │ │ │ │ +0002ac50: 616e 6420 6e6f 7469 6669 6573 2074 6865 and notifies the │ │ │ │ +0002ac60: 206d 656d 6f72 7920 6d61 6e61 6765 7220 memory manager │ │ │ │ +0002ac70: 7468 6174 2073 7065 6369 6669 6564 2072 that specified r │ │ │ │ +0002ac80: 6567 696f 6e73 206f 660a 5241 4d20 6f75 egions of.RAM ou │ │ │ │ +0002ac90: 6768 7420 746f 2062 6520 6669 6c74 6572 ght to be filter │ │ │ │ +0002aca0: 6564 206f 7574 2e20 2054 6869 7320 7265 ed out. This re │ │ │ │ +0002acb0: 6d61 696e 7320 696e 2065 6666 6563 7420 mains in effect │ │ │ │ +0002acc0: 6166 7465 7220 6120 7061 796c 6f61 640a after a payload. │ │ │ │ +0002acd0: 6b65 726e 656c 2068 6173 2062 6565 6e20 kernel has been │ │ │ │ +0002ace0: 6c6f 6164 6564 2062 7920 4752 5542 2c20 loaded by GRUB, │ │ │ │ +0002acf0: 6173 206c 6f6e 6720 6173 2074 6865 206c as long as the l │ │ │ │ +0002ad00: 6f61 6465 6420 6b65 726e 656c 206f 6274 oaded kernel obt │ │ │ │ +0002ad10: 6169 6e73 2069 7473 0a6d 656d 6f72 7920 ains its.memory │ │ │ │ +0002ad20: 6d61 7020 6672 6f6d 2047 5255 422e 204b map from GRUB. K │ │ │ │ +0002ad30: 6572 6e65 6c73 2074 6861 7420 7375 7070 ernels that supp │ │ │ │ +0002ad40: 6f72 7420 7468 6973 2069 6e63 6c75 6465 ort this include │ │ │ │ +0002ad50: 204c 696e 7578 2c20 474e 5520 4d61 6368 Linux, GNU Mach │ │ │ │ +0002ad60: 2c0a 7468 6520 6b65 726e 656c 206f 6620 ,.the kernel of │ │ │ │ +0002ad70: 4672 6565 4253 4420 616e 6420 4d75 6c74 FreeBSD and Mult │ │ │ │ +0002ad80: 6962 6f6f 7420 6b65 726e 656c 7320 696e iboot kernels in │ │ │ │ +0002ad90: 2067 656e 6572 616c 2e0a 0a20 2020 5468 general... Th │ │ │ │ +0002ada0: 6520 636f 6d6d 616e 6420 6973 2073 696d e command is sim │ │ │ │ +0002adb0: 696c 6172 2074 6f20 2762 6164 7261 6d27 ilar to 'badram' │ │ │ │ +0002adc0: 2063 6f6d 6d61 6e64 2e0a 0a20 2020 4e6f command... No │ │ │ │ +0002add0: 7465 3a20 5468 6520 636f 6d6d 616e 6420 te: The command │ │ │ │ +0002ade0: 6973 206e 6f74 2061 6c6c 6f77 6564 2077 is not allowed w │ │ │ │ +0002adf0: 6865 6e20 6c6f 636b 646f 776e 2069 7320 hen lockdown is │ │ │ │ +0002ae00: 656e 666f 7263 6564 2028 2a6e 6f74 650a enforced (*note. │ │ │ │ +0002ae10: 4c6f 636b 646f 776e 3a3a 292e 2020 5468 Lockdown::). Th │ │ │ │ +0002ae20: 6973 2070 7265 7665 6e74 7320 7265 6d6f is prevents remo │ │ │ │ +0002ae30: 7669 6e67 2045 4649 206d 656d 6f72 7920 ving EFI memory │ │ │ │ +0002ae40: 7265 6769 6f6e 7320 746f 2070 6f74 656e regions to poten │ │ │ │ +0002ae50: 7469 616c 6c79 0a73 7562 7665 7274 2074 tially.subvert t │ │ │ │ +0002ae60: 6865 2073 6563 7572 6974 7920 6d65 6368 he security mech │ │ │ │ +0002ae70: 616e 6973 6d73 2070 726f 7669 6465 6420 anisms provided │ │ │ │ +0002ae80: 6279 2074 6865 2055 4546 4920 7365 6375 by the UEFI secu │ │ │ │ +0002ae90: 7265 2062 6f6f 742e 0a0a 1f0a 4669 6c65 re boot.....File │ │ │ │ +0002aea0: 3a20 6772 7562 2e69 6e66 6f2c 2020 4e6f : grub.info, No │ │ │ │ +0002aeb0: 6465 3a20 6461 7465 2c20 204e 6578 743a de: date, Next: │ │ │ │ +0002aec0: 2064 6576 6963 6574 7265 652c 2020 5072 devicetree, Pr │ │ │ │ +0002aed0: 6576 3a20 6375 746d 656d 2c20 2055 703a ev: cutmem, Up: │ │ │ │ +0002aee0: 2043 6f6d 6d61 6e64 2d6c 696e 6520 616e Command-line an │ │ │ │ +0002aef0: 6420 6d65 6e75 2065 6e74 7279 2063 6f6d d menu entry com │ │ │ │ +0002af00: 6d61 6e64 730a 0a31 362e 332e 3231 2064 mands..16.3.21 d │ │ │ │ +0002af10: 6174 650a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ate.------------ │ │ │ │ +0002af20: 0a0a 202d 2d20 436f 6d6d 616e 643a 2064 .. -- Command: d │ │ │ │ +0002af30: 6174 6520 5b5b 7965 6172 2d5d 6d6f 6e74 ate [[year-]mont │ │ │ │ +0002af40: 682d 6461 795d 205b 686f 7572 3a6d 696e h-day] [hour:min │ │ │ │ +0002af50: 7574 655b 3a73 6563 6f6e 645d 5d0a 2020 ute[:second]]. │ │ │ │ +0002af60: 2020 2057 6974 6820 6e6f 2061 7267 756d With no argum │ │ │ │ +0002af70: 656e 7473 2c20 7072 696e 7420 7468 6520 ents, print the │ │ │ │ +0002af80: 6375 7272 656e 7420 6461 7465 2061 6e64 current date and │ │ │ │ +0002af90: 2074 696d 652e 0a0a 2020 2020 204f 7468 time... Oth │ │ │ │ +0002afa0: 6572 7769 7365 2c20 7461 6b65 2074 6865 erwise, take the │ │ │ │ +0002afb0: 2063 7572 7265 6e74 2064 6174 6520 616e current date an │ │ │ │ +0002afc0: 6420 7469 6d65 2c20 6368 616e 6765 2061 d time, change a │ │ │ │ +0002afd0: 6e79 2065 6c65 6d65 6e74 730a 2020 2020 ny elements. │ │ │ │ +0002afe0: 2073 7065 6369 6669 6564 2061 7320 6172 specified as ar │ │ │ │ +0002aff0: 6775 6d65 6e74 732c 2061 6e64 2073 6574 guments, and set │ │ │ │ +0002b000: 2074 6865 2072 6573 756c 7420 6173 2074 the result as t │ │ │ │ +0002b010: 6865 206e 6577 2064 6174 6520 616e 640a he new date and. │ │ │ │ +0002b020: 2020 2020 2074 696d 652e 2020 466f 7220 time. For │ │ │ │ +0002b030: 6578 616d 706c 652c 2027 6461 7465 2030 example, 'date 0 │ │ │ │ +0002b040: 312d 3031 2720 7769 6c6c 2073 6574 2074 1-01' will set t │ │ │ │ +0002b050: 6865 2063 7572 7265 6e74 206d 6f6e 7468 he current month │ │ │ │ +0002b060: 2061 6e64 2064 6179 0a20 2020 2020 746f and day. to │ │ │ │ +0002b070: 204a 616e 7561 7279 2031 2c20 6275 7420 January 1, but │ │ │ │ +0002b080: 6c65 6176 6520 7468 6520 7965 6172 2c20 leave the year, │ │ │ │ +0002b090: 686f 7572 2c20 6d69 6e75 7465 2c20 616e hour, minute, an │ │ │ │ +0002b0a0: 6420 7365 636f 6e64 0a20 2020 2020 756e d second. un │ │ │ │ +0002b0b0: 6368 616e 6765 642e 0a0a 1f0a 4669 6c65 changed.....File │ │ │ │ +0002b0c0: 3a20 6772 7562 2e69 6e66 6f2c 2020 4e6f : grub.info, No │ │ │ │ +0002b0d0: 6465 3a20 6465 7669 6365 7472 6565 2c20 de: devicetree, │ │ │ │ +0002b0e0: 204e 6578 743a 2064 6973 7472 7573 742c Next: distrust, │ │ │ │ +0002b0f0: 2020 5072 6576 3a20 6461 7465 2c20 2055 Prev: date, U │ │ │ │ +0002b100: 703a 2043 6f6d 6d61 6e64 2d6c 696e 6520 p: Command-line │ │ │ │ +0002b110: 616e 6420 6d65 6e75 2065 6e74 7279 2063 and menu entry c │ │ │ │ +0002b120: 6f6d 6d61 6e64 730a 0a31 362e 332e 3232 ommands..16.3.22 │ │ │ │ +0002b130: 206c 696e 7578 0a2d 2d2d 2d2d 2d2d 2d2d linux.--------- │ │ │ │ +0002b140: 2d2d 2d2d 0a0a 202d 2d20 436f 6d6d 616e ----.. -- Comman │ │ │ │ +0002b150: 643a 2064 6576 6963 6574 7265 6520 6669 d: devicetree fi │ │ │ │ +0002b160: 6c65 0a20 2020 2020 4c6f 6164 2061 2064 le. Load a d │ │ │ │ +0002b170: 6576 6963 6520 7472 6565 2062 6c6f 6220 evice tree blob │ │ │ │ +0002b180: 282e 6474 6229 2066 726f 6d20 6120 6669 (.dtb) from a fi │ │ │ │ +0002b190: 6c65 7379 7374 656d 2c20 666f 7220 6c61 lesystem, for la │ │ │ │ +0002b1a0: 7465 7220 7573 6520 6279 0a20 2020 2020 ter use by. │ │ │ │ +0002b1b0: 6120 4c69 6e75 7820 6b65 726e 656c 2e20 a Linux kernel. │ │ │ │ +0002b1c0: 2044 6f65 7320 6e6f 7420 7065 7266 6f72 Does not perfor │ │ │ │ +0002b1d0: 6d20 6d65 7267 696e 6720 7769 7468 2061 m merging with a │ │ │ │ +0002b1e0: 6e79 2064 6576 6963 6520 7472 6565 0a20 ny device tree. │ │ │ │ +0002b1f0: 2020 2020 7375 7070 6c69 6564 2062 7920 supplied by │ │ │ │ +0002b200: 6669 726d 7761 7265 2c20 6275 7420 7261 firmware, but ra │ │ │ │ +0002b210: 7468 6572 2072 6570 6c61 6365 7320 6974 ther replaces it │ │ │ │ +0002b220: 2063 6f6d 706c 6574 656c 792e 2020 2a6e completely. *n │ │ │ │ +0002b230: 6f74 650a 2020 2020 2047 4e55 2f4c 696e ote. GNU/Lin │ │ │ │ +0002b240: 7578 3a3a 2e0a 0a20 2020 2020 4e6f 7465 ux::... Note │ │ │ │ +0002b250: 3a20 5468 6520 636f 6d6d 616e 6420 6973 : The command is │ │ │ │ +0002b260: 206e 6f74 2061 6c6c 6f77 6564 2077 6865 not allowed whe │ │ │ │ +0002b270: 6e20 6c6f 636b 646f 776e 2069 7320 656e n lockdown is en │ │ │ │ +0002b280: 666f 7263 6564 2028 2a6e 6f74 650a 2020 forced (*note. │ │ │ │ +0002b290: 2020 204c 6f63 6b64 6f77 6e3a 3a29 2e20 Lockdown::). │ │ │ │ +0002b2a0: 2054 6869 7320 6973 2064 6f6e 6520 746f This is done to │ │ │ │ +0002b2b0: 2070 7265 7665 6e74 2073 7562 7665 7274 prevent subvert │ │ │ │ +0002b2c0: 696e 6720 7661 7269 6f75 7320 7365 6375 ing various secu │ │ │ │ +0002b2d0: 7269 7479 0a20 2020 2020 6d65 6368 616e rity. mechan │ │ │ │ +0002b2e0: 6973 6d73 2e0a 0a1f 0a46 696c 653a 2067 isms.....File: g │ │ │ │ +0002b2f0: 7275 622e 696e 666f 2c20 204e 6f64 653a rub.info, Node: │ │ │ │ +0002b300: 2064 6973 7472 7573 742c 2020 4e65 7874 distrust, Next │ │ │ │ +0002b310: 3a20 6472 6976 656d 6170 2c20 2050 7265 : drivemap, Pre │ │ │ │ +0002b320: 763a 2064 6576 6963 6574 7265 652c 2020 v: devicetree, │ │ │ │ +0002b330: 5570 3a20 436f 6d6d 616e 642d 6c69 6e65 Up: Command-line │ │ │ │ +0002b340: 2061 6e64 206d 656e 7520 656e 7472 7920 and menu entry │ │ │ │ +0002b350: 636f 6d6d 616e 6473 0a0a 3136 2e33 2e32 commands..16.3.2 │ │ │ │ +0002b360: 3320 6469 7374 7275 7374 0a2d 2d2d 2d2d 3 distrust.----- │ │ │ │ +0002b370: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d -----------.. -- │ │ │ │ +0002b380: 2043 6f6d 6d61 6e64 3a20 6469 7374 7275 Command: distru │ │ │ │ +0002b390: 7374 2070 7562 6b65 795f 6964 0a20 2020 st pubkey_id. │ │ │ │ +0002b3a0: 2020 5265 6d6f 7665 2070 7562 6c69 6320 Remove public │ │ │ │ +0002b3b0: 6b65 7920 5055 424b 4559 5f49 4420 6672 key PUBKEY_ID fr │ │ │ │ +0002b3c0: 6f6d 2047 5255 4227 7320 6b65 7972 696e om GRUB's keyrin │ │ │ │ +0002b3d0: 6720 6f66 2074 7275 7374 6564 206b 6579 g of trusted key │ │ │ │ +0002b3e0: 732e 0a20 2020 2020 5055 424b 4559 5f49 s.. PUBKEY_I │ │ │ │ +0002b3f0: 4420 6973 2074 6865 206c 6173 7420 666f D is the last fo │ │ │ │ +0002b400: 7572 2062 7974 6573 2028 6569 6768 7420 ur bytes (eight │ │ │ │ +0002b410: 6865 7861 6465 6369 6d61 6c20 6469 6769 hexadecimal digi │ │ │ │ +0002b420: 7473 2920 6f66 2074 6865 0a20 2020 2020 ts) of the. │ │ │ │ +0002b430: 4750 4720 7634 206b 6579 2069 642c 2077 GPG v4 key id, w │ │ │ │ +0002b440: 6869 6368 2069 7320 616c 736f 2074 6865 hich is also the │ │ │ │ +0002b450: 206f 7574 7075 7420 6f66 2027 6c69 7374 output of 'list │ │ │ │ +0002b460: 5f74 7275 7374 6564 2720 282a 6e6f 7465 _trusted' (*note │ │ │ │ +0002b470: 0a20 2020 2020 6c69 7374 5f74 7275 7374 . list_trust │ │ │ │ +0002b480: 6564 3a3a 292e 2020 4f75 7473 6964 6520 ed::). Outside │ │ │ │ +0002b490: 6f66 2047 5255 422c 2074 6865 206b 6579 of GRUB, the key │ │ │ │ +0002b4a0: 2069 6420 6361 6e20 6265 206f 6274 6169 id can be obtai │ │ │ │ +0002b4b0: 6e65 6420 7573 696e 670a 2020 2020 2027 ned using. ' │ │ │ │ +0002b4c0: 6770 6720 2d2d 6669 6e67 6572 7072 696e gpg --fingerprin │ │ │ │ +0002b4d0: 7427 292e 2020 5468 6573 6520 6b65 7973 t'). These keys │ │ │ │ +0002b4e0: 2061 7265 2075 7365 6420 746f 2076 616c are used to val │ │ │ │ +0002b4f0: 6964 6174 6520 7369 676e 6174 7572 6573 idate signatures │ │ │ │ +0002b500: 0a20 2020 2020 7768 656e 2065 6e76 6972 . when envir │ │ │ │ +0002b510: 6f6e 6d65 6e74 2076 6172 6961 626c 6520 onment variable │ │ │ │ +0002b520: 2763 6865 636b 5f73 6967 6e61 7475 7265 'check_signature │ │ │ │ +0002b530: 7327 2069 7320 7365 7420 746f 2027 656e s' is set to 'en │ │ │ │ +0002b540: 666f 7263 6527 0a20 2020 2020 282a 6e6f force'. (*no │ │ │ │ +0002b550: 7465 2063 6865 636b 5f73 6967 6e61 7475 te check_signatu │ │ │ │ +0002b560: 7265 733a 3a29 2c20 616e 6420 6279 2073 res::), and by s │ │ │ │ +0002b570: 6f6d 6520 696e 766f 6361 7469 6f6e 7320 ome invocations │ │ │ │ +0002b580: 6f66 0a20 2020 2020 2776 6572 6966 795f of. 'verify_ │ │ │ │ +0002b590: 6465 7461 6368 6564 2720 282a 6e6f 7465 detached' (*note │ │ │ │ +0002b5a0: 2076 6572 6966 795f 6465 7461 6368 6564 verify_detached │ │ │ │ +0002b5b0: 3a3a 292e 2020 2a4e 6f74 6520 5573 696e ::). *Note Usin │ │ │ │ +0002b5c0: 6720 6469 6769 7461 6c0a 2020 2020 2073 g digital. s │ │ │ │ +0002b5d0: 6967 6e61 7475 7265 733a 3a2c 2066 6f72 ignatures::, for │ │ │ │ +0002b5e0: 206d 6f72 6520 696e 666f 726d 6174 696f more informatio │ │ │ │ +0002b5f0: 6e2e 0a0a 1f0a 4669 6c65 3a20 6772 7562 n.....File: grub │ │ │ │ +0002b600: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 6472 .info, Node: dr │ │ │ │ +0002b610: 6976 656d 6170 2c20 204e 6578 743a 2065 ivemap, Next: e │ │ │ │ +0002b620: 6368 6f2c 2020 5072 6576 3a20 6469 7374 cho, Prev: dist │ │ │ │ +0002b630: 7275 7374 2c20 2055 703a 2043 6f6d 6d61 rust, Up: Comma │ │ │ │ +0002b640: 6e64 2d6c 696e 6520 616e 6420 6d65 6e75 nd-line and menu │ │ │ │ +0002b650: 2065 6e74 7279 2063 6f6d 6d61 6e64 730a entry commands. │ │ │ │ +0002b660: 0a31 362e 332e 3234 2064 7269 7665 6d61 .16.3.24 drivema │ │ │ │ +0002b670: 700a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d p.-------------- │ │ │ │ +0002b680: 2d2d 0a0a 202d 2d20 436f 6d6d 616e 643a --.. -- Command: │ │ │ │ +0002b690: 2064 7269 7665 6d61 7020 272d 6c27 7c27 drivemap '-l'|' │ │ │ │ +0002b6a0: 2d72 277c 5b27 2d73 275d 2066 726f 6d5f -r'|['-s'] from_ │ │ │ │ +0002b6b0: 6472 6976 6520 746f 5f64 7269 7665 0a20 drive to_drive. │ │ │ │ +0002b6c0: 2020 2020 5769 7468 6f75 7420 6f70 7469 Without opti │ │ │ │ +0002b6d0: 6f6e 732c 206d 6170 2074 6865 2064 7269 ons, map the dri │ │ │ │ +0002b6e0: 7665 2046 524f 4d5f 4452 4956 4520 746f ve FROM_DRIVE to │ │ │ │ +0002b6f0: 2074 6865 2064 7269 7665 2054 4f5f 4452 the drive TO_DR │ │ │ │ +0002b700: 4956 452e 0a20 2020 2020 5468 6973 2069 IVE.. This i │ │ │ │ +0002b710: 7320 6e65 6365 7373 6172 7920 7768 656e s necessary when │ │ │ │ +0002b720: 2079 6f75 2063 6861 696e 2d6c 6f61 6420 you chain-load │ │ │ │ +0002b730: 736f 6d65 206f 7065 7261 7469 6e67 2073 some operating s │ │ │ │ +0002b740: 7973 7465 6d73 2c20 7375 6368 0a20 2020 ystems, such. │ │ │ │ +0002b750: 2020 6173 2044 4f53 2c20 6966 2073 7563 as DOS, if suc │ │ │ │ +0002b760: 6820 616e 204f 5320 7265 7369 6465 7320 h an OS resides │ │ │ │ +0002b770: 6174 2061 206e 6f6e 2d66 6972 7374 2064 at a non-first d │ │ │ │ +0002b780: 7269 7665 2e20 2046 6f72 0a20 2020 2020 rive. For. │ │ │ │ +0002b790: 636f 6e76 656e 6965 6e63 652c 2061 6e79 convenience, any │ │ │ │ +0002b7a0: 2070 6172 7469 7469 6f6e 2073 7566 6669 partition suffi │ │ │ │ +0002b7b0: 7820 6f6e 2074 6865 2064 7269 7665 2069 x on the drive i │ │ │ │ +0002b7c0: 7320 6967 6e6f 7265 642c 2073 6f20 796f s ignored, so yo │ │ │ │ +0002b7d0: 750a 2020 2020 2063 616e 2073 6166 656c u. can safel │ │ │ │ +0002b7e0: 7920 7573 6520 247b 726f 6f74 7d20 6173 y use ${root} as │ │ │ │ +0002b7f0: 2061 2064 7269 7665 2073 7065 6369 6669 a drive specifi │ │ │ │ +0002b800: 6361 7469 6f6e 2e0a 0a20 2020 2020 5769 cation... Wi │ │ │ │ +0002b810: 7468 2074 6865 2027 2d73 2720 6f70 7469 th the '-s' opti │ │ │ │ +0002b820: 6f6e 2c20 7065 7266 6f72 6d20 7468 6520 on, perform the │ │ │ │ +0002b830: 7265 7665 7273 6520 6d61 7070 696e 6720 reverse mapping │ │ │ │ +0002b840: 6173 2077 656c 6c2c 2073 7761 7070 696e as well, swappin │ │ │ │ +0002b850: 670a 2020 2020 2074 6865 2074 776f 2064 g. the two d │ │ │ │ +0002b860: 7269 7665 732e 0a0a 2020 2020 2057 6974 rives... Wit │ │ │ │ +0002b870: 6820 7468 6520 272d 6c27 206f 7074 696f h the '-l' optio │ │ │ │ +0002b880: 6e2c 206c 6973 7420 7468 6520 6375 7272 n, list the curr │ │ │ │ +0002b890: 656e 7420 6d61 7070 696e 6773 2e0a 0a20 ent mappings... │ │ │ │ +0002b8a0: 2020 2020 5769 7468 2074 6865 2027 2d72 With the '-r │ │ │ │ +0002b8b0: 2720 6f70 7469 6f6e 2c20 7265 7365 7420 ' option, reset │ │ │ │ +0002b8c0: 616c 6c20 6d61 7070 696e 6773 2074 6f20 all mappings to │ │ │ │ +0002b8d0: 7468 6520 6465 6661 756c 7420 7661 6c75 the default valu │ │ │ │ +0002b8e0: 6573 2e0a 0a20 2020 2020 466f 7220 6578 es... For ex │ │ │ │ +0002b8f0: 616d 706c 653a 0a0a 2020 2020 2020 2020 ample:.. │ │ │ │ +0002b900: 2020 6472 6976 656d 6170 202d 7320 2868 drivemap -s (h │ │ │ │ +0002b910: 6430 2920 2868 6431 290a 0a1f 0a46 696c d0) (hd1)....Fil │ │ │ │ +0002b920: 653a 2067 7275 622e 696e 666f 2c20 204e e: grub.info, N │ │ │ │ +0002b930: 6f64 653a 2065 6368 6f2c 2020 4e65 7874 ode: echo, Next │ │ │ │ +0002b940: 3a20 6576 616c 2c20 2050 7265 763a 2064 : eval, Prev: d │ │ │ │ +0002b950: 7269 7665 6d61 702c 2020 5570 3a20 436f rivemap, Up: Co │ │ │ │ +0002b960: 6d6d 616e 642d 6c69 6e65 2061 6e64 206d mmand-line and m │ │ │ │ +0002b970: 656e 7520 656e 7472 7920 636f 6d6d 616e enu entry comman │ │ │ │ +0002b980: 6473 0a0a 3136 2e33 2e32 3520 6563 686f ds..16.3.25 echo │ │ │ │ +0002b990: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 .------------.. │ │ │ │ +0002b9a0: 2d2d 2043 6f6d 6d61 6e64 3a20 6563 686f -- Command: echo │ │ │ │ +0002b9b0: 205b 272d 6e27 5d20 5b27 2d65 275d 2073 ['-n'] ['-e'] s │ │ │ │ +0002b9c0: 7472 696e 6720 2e2e 2e0a 2020 2020 2044 tring .... D │ │ │ │ +0002b9d0: 6973 706c 6179 2074 6865 2072 6571 7565 isplay the reque │ │ │ │ +0002b9e0: 7374 6564 2074 6578 7420 616e 642c 2075 sted text and, u │ │ │ │ +0002b9f0: 6e6c 6573 7320 7468 6520 272d 6e27 206f nless the '-n' o │ │ │ │ +0002ba00: 7074 696f 6e20 6973 2075 7365 642c 2061 ption is used, a │ │ │ │ +0002ba10: 0a20 2020 2020 7472 6169 6c69 6e67 206e . trailing n │ │ │ │ +0002ba20: 6577 206c 696e 652e 2020 4966 2074 6865 ew line. If the │ │ │ │ +0002ba30: 7265 2069 7320 6d6f 7265 2074 6861 6e20 re is more than │ │ │ │ +0002ba40: 6f6e 6520 7374 7269 6e67 2c20 7468 6579 one string, they │ │ │ │ +0002ba50: 2061 7265 0a20 2020 2020 7365 7061 7261 are. separa │ │ │ │ +0002ba60: 7465 6420 6279 2073 7061 6365 7320 696e ted by spaces in │ │ │ │ +0002ba70: 2074 6865 206f 7574 7075 742e 2020 4173 the output. As │ │ │ │ +0002ba80: 2075 7375 616c 2069 6e20 4752 5542 2063 usual in GRUB c │ │ │ │ +0002ba90: 6f6d 6d61 6e64 732c 0a20 2020 2020 7661 ommands,. va │ │ │ │ +0002baa0: 7269 6162 6c65 7320 6d61 7920 6265 2073 riables may be s │ │ │ │ +0002bab0: 7562 7374 6974 7574 6564 2075 7369 6e67 ubstituted using │ │ │ │ +0002bac0: 2027 247b 7661 727d 272e 0a0a 2020 2020 '${var}'... │ │ │ │ +0002bad0: 2054 6865 2027 2d65 2720 6f70 7469 6f6e The '-e' option │ │ │ │ +0002bae0: 2065 6e61 626c 6573 2069 6e74 6572 7072 enables interpr │ │ │ │ +0002baf0: 6574 6174 696f 6e20 6f66 2062 6163 6b73 etation of backs │ │ │ │ +0002bb00: 6c61 7368 2065 7363 6170 6573 2e20 2054 lash escapes. T │ │ │ │ +0002bb10: 6865 0a20 2020 2020 666f 6c6c 6f77 696e he. followin │ │ │ │ +0002bb20: 6720 7365 7175 656e 6365 7320 6172 6520 g sequences are │ │ │ │ +0002bb30: 7265 636f 676e 6973 6564 3a0a 0a20 2020 recognised:.. │ │ │ │ +0002bb40: 2020 275c 5c27 0a20 2020 2020 2020 2020 '\\'. │ │ │ │ +0002bb50: 2062 6163 6b73 6c61 7368 0a0a 2020 2020 backslash.. │ │ │ │ +0002bb60: 2027 5c61 270a 2020 2020 2020 2020 2020 '\a'. │ │ │ │ +0002bb70: 616c 6572 7420 2842 454c 290a 0a20 2020 alert (BEL).. │ │ │ │ +0002bb80: 2020 275c 6327 0a20 2020 2020 2020 2020 '\c'. │ │ │ │ +0002bb90: 2073 7570 7072 6573 7320 7472 6169 6c69 suppress traili │ │ │ │ +0002bba0: 6e67 206e 6577 206c 696e 650a 0a20 2020 ng new line.. │ │ │ │ +0002bbb0: 2020 275c 6627 0a20 2020 2020 2020 2020 '\f'. │ │ │ │ +0002bbc0: 2066 6f72 6d20 6665 6564 0a0a 2020 2020 form feed.. │ │ │ │ +0002bbd0: 2027 5c6e 270a 2020 2020 2020 2020 2020 '\n'. │ │ │ │ +0002bbe0: 6e65 7720 6c69 6e65 0a0a 2020 2020 2027 new line.. ' │ │ │ │ +0002bbf0: 5c72 270a 2020 2020 2020 2020 2020 6361 \r'. ca │ │ │ │ +0002bc00: 7272 6961 6765 2072 6574 7572 6e0a 0a20 rriage return.. │ │ │ │ +0002bc10: 2020 2020 275c 7427 0a20 2020 2020 2020 '\t'. │ │ │ │ +0002bc20: 2020 2068 6f72 697a 6f6e 7461 6c20 7461 horizontal ta │ │ │ │ +0002bc30: 620a 0a20 2020 2020 275c 7627 0a20 2020 b.. '\v'. │ │ │ │ +0002bc40: 2020 2020 2020 2076 6572 7469 6361 6c20 vertical │ │ │ │ +0002bc50: 7461 620a 0a20 2020 2020 5768 656e 2069 tab.. When i │ │ │ │ +0002bc60: 6e74 6572 7072 6574 696e 6720 6261 636b nterpreting back │ │ │ │ +0002bc70: 736c 6173 6820 6573 6361 7065 732c 2062 slash escapes, b │ │ │ │ +0002bc80: 6163 6b73 6c61 7368 2066 6f6c 6c6f 7765 ackslash followe │ │ │ │ +0002bc90: 6420 6279 2061 6e79 0a20 2020 2020 6f74 d by any. ot │ │ │ │ +0002bca0: 6865 7220 6368 6172 6163 7465 7220 7769 her character wi │ │ │ │ +0002bcb0: 6c6c 2070 7269 6e74 2074 6861 7420 6368 ll print that ch │ │ │ │ +0002bcc0: 6172 6163 7465 722e 0a0a 1f0a 4669 6c65 aracter.....File │ │ │ │ +0002bcd0: 3a20 6772 7562 2e69 6e66 6f2c 2020 4e6f : grub.info, No │ │ │ │ +0002bce0: 6465 3a20 6576 616c 2c20 204e 6578 743a de: eval, Next: │ │ │ │ +0002bcf0: 2065 7870 6f72 742c 2020 5072 6576 3a20 export, Prev: │ │ │ │ +0002bd00: 6563 686f 2c20 2055 703a 2043 6f6d 6d61 echo, Up: Comma │ │ │ │ +0002bd10: 6e64 2d6c 696e 6520 616e 6420 6d65 6e75 nd-line and menu │ │ │ │ +0002bd20: 2065 6e74 7279 2063 6f6d 6d61 6e64 730a entry commands. │ │ │ │ +0002bd30: 0a31 362e 332e 3236 2065 7661 6c0a 2d2d .16.3.26 eval.-- │ │ │ │ +0002bd40: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 ----------.. -- │ │ │ │ +0002bd50: 436f 6d6d 616e 643a 2065 7661 6c20 7374 Command: eval st │ │ │ │ +0002bd60: 7269 6e67 202e 2e2e 0a20 2020 2020 436f ring .... Co │ │ │ │ +0002bd70: 6e63 6174 656e 6174 6520 6172 6775 6d65 ncatenate argume │ │ │ │ +0002bd80: 6e74 7320 746f 6765 7468 6572 2075 7369 nts together usi │ │ │ │ +0002bd90: 6e67 2073 696e 676c 6520 7370 6163 6520 ng single space │ │ │ │ +0002bda0: 6173 2073 6570 6172 6174 6f72 2061 6e64 as separator and │ │ │ │ +0002bdb0: 0a20 2020 2020 6576 616c 7561 7465 2072 . evaluate r │ │ │ │ +0002bdc0: 6573 756c 7420 6173 2073 6571 7565 6e63 esult as sequenc │ │ │ │ +0002bdd0: 6520 6f66 2047 5255 4220 636f 6d6d 616e e of GRUB comman │ │ │ │ +0002bde0: 6473 2e0a 0a1f 0a46 696c 653a 2067 7275 ds.....File: gru │ │ │ │ +0002bdf0: 622e 696e 666f 2c20 204e 6f64 653a 2065 b.info, Node: e │ │ │ │ +0002be00: 7870 6f72 742c 2020 4e65 7874 3a20 6661 xport, Next: fa │ │ │ │ +0002be10: 6c73 652c 2020 5072 6576 3a20 6576 616c lse, Prev: eval │ │ │ │ +0002be20: 2c20 2055 703a 2043 6f6d 6d61 6e64 2d6c , Up: Command-l │ │ │ │ +0002be30: 696e 6520 616e 6420 6d65 6e75 2065 6e74 ine and menu ent │ │ │ │ +0002be40: 7279 2063 6f6d 6d61 6e64 730a 0a31 362e ry commands..16. │ │ │ │ +0002be50: 332e 3237 2065 7870 6f72 740a 2d2d 2d2d 3.27 export.---- │ │ │ │ +0002be60: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 ----------.. -- │ │ │ │ +0002be70: 436f 6d6d 616e 643a 2065 7870 6f72 7420 Command: export │ │ │ │ +0002be80: 656e 7676 6172 0a20 2020 2020 4578 706f envvar. Expo │ │ │ │ +0002be90: 7274 2074 6865 2065 6e76 6972 6f6e 6d65 rt the environme │ │ │ │ +0002bea0: 6e74 2076 6172 6961 626c 6520 454e 5656 nt variable ENVV │ │ │ │ +0002beb0: 4152 2e20 2045 7870 6f72 7465 6420 7661 AR. Exported va │ │ │ │ +0002bec0: 7269 6162 6c65 7320 6172 650a 2020 2020 riables are. │ │ │ │ +0002bed0: 2076 6973 6962 6c65 2074 6f20 7375 6273 visible to subs │ │ │ │ +0002bee0: 6964 6961 7279 2063 6f6e 6669 6775 7261 idiary configura │ │ │ │ +0002bef0: 7469 6f6e 2066 696c 6573 206c 6f61 6465 tion files loade │ │ │ │ +0002bf00: 6420 7573 696e 670a 2020 2020 2027 636f d using. 'co │ │ │ │ +0002bf10: 6e66 6967 6669 6c65 272e 0a0a 1f0a 4669 nfigfile'.....Fi │ │ │ │ +0002bf20: 6c65 3a20 6772 7562 2e69 6e66 6f2c 2020 le: grub.info, │ │ │ │ +0002bf30: 4e6f 6465 3a20 6661 6c73 652c 2020 4e65 Node: false, Ne │ │ │ │ +0002bf40: 7874 3a20 6765 7474 6578 742c 2020 5072 xt: gettext, Pr │ │ │ │ +0002bf50: 6576 3a20 6578 706f 7274 2c20 2055 703a ev: export, Up: │ │ │ │ +0002bf60: 2043 6f6d 6d61 6e64 2d6c 696e 6520 616e Command-line an │ │ │ │ +0002bf70: 6420 6d65 6e75 2065 6e74 7279 2063 6f6d d menu entry com │ │ │ │ +0002bf80: 6d61 6e64 730a 0a31 362e 332e 3238 2066 mands..16.3.28 f │ │ │ │ +0002bf90: 616c 7365 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d alse.----------- │ │ │ │ +0002bfa0: 2d2d 0a0a 202d 2d20 436f 6d6d 616e 643a --.. -- Command: │ │ │ │ +0002bfb0: 2066 616c 7365 0a20 2020 2020 446f 206e false. Do n │ │ │ │ +0002bfc0: 6f74 6869 6e67 2c20 756e 7375 6363 6573 othing, unsucces │ │ │ │ +0002bfd0: 7366 756c 6c79 2e20 2054 6869 7320 6973 sfully. This is │ │ │ │ +0002bfe0: 206d 6169 6e6c 7920 7573 6566 756c 2069 mainly useful i │ │ │ │ +0002bff0: 6e20 636f 6e74 726f 6c0a 2020 2020 2063 n control. c │ │ │ │ +0002c000: 6f6e 7374 7275 6374 7320 7375 6368 2061 onstructs such a │ │ │ │ +0002c010: 7320 2769 6627 2061 6e64 2027 7768 696c s 'if' and 'whil │ │ │ │ +0002c020: 6527 2028 2a6e 6f74 6520 5368 656c 6c2d e' (*note Shell- │ │ │ │ +0002c030: 6c69 6b65 2073 6372 6970 7469 6e67 3a3a like scripting:: │ │ │ │ +0002c040: 292e 0a0a 1f0a 4669 6c65 3a20 6772 7562 ).....File: grub │ │ │ │ +0002c050: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 6765 .info, Node: ge │ │ │ │ +0002c060: 7474 6578 742c 2020 4e65 7874 3a20 6770 ttext, Next: gp │ │ │ │ +0002c070: 7473 796e 632c 2020 5072 6576 3a20 6661 tsync, Prev: fa │ │ │ │ +0002c080: 6c73 652c 2020 5570 3a20 436f 6d6d 616e lse, Up: Comman │ │ │ │ +0002c090: 642d 6c69 6e65 2061 6e64 206d 656e 7520 d-line and menu │ │ │ │ +0002c0a0: 656e 7472 7920 636f 6d6d 616e 6473 0a0a entry commands.. │ │ │ │ +0002c0b0: 3136 2e33 2e32 3920 6765 7474 6578 740a 16.3.29 gettext. │ │ │ │ +0002c0c0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a ---------------. │ │ │ │ +0002c0d0: 0a20 2d2d 2043 6f6d 6d61 6e64 3a20 6765 . -- Command: ge │ │ │ │ +0002c0e0: 7474 6578 7420 7374 7269 6e67 0a20 2020 ttext string. │ │ │ │ +0002c0f0: 2020 5472 616e 736c 6174 6520 5354 5249 Translate STRI │ │ │ │ +0002c100: 4e47 2069 6e74 6f20 7468 6520 6375 7272 NG into the curr │ │ │ │ +0002c110: 656e 7420 6c61 6e67 7561 6765 2e0a 0a20 ent language... │ │ │ │ +0002c120: 2020 2020 5468 6520 6375 7272 656e 7420 The current │ │ │ │ +0002c130: 6c61 6e67 7561 6765 2063 6f64 6520 6973 language code is │ │ │ │ +0002c140: 2073 746f 7265 6420 696e 2074 6865 2027 stored in the ' │ │ │ │ +0002c150: 6c61 6e67 2720 7661 7269 6162 6c65 2069 lang' variable i │ │ │ │ +0002c160: 6e0a 2020 2020 2047 5255 4227 7320 656e n. GRUB's en │ │ │ │ +0002c170: 7669 726f 6e6d 656e 7420 282a 6e6f 7465 vironment (*note │ │ │ │ +0002c180: 206c 616e 673a 3a29 2e20 2054 7261 6e73 lang::). Trans │ │ │ │ +0002c190: 6c61 7469 6f6e 2066 696c 6573 2069 6e20 lation files in │ │ │ │ +0002c1a0: 4d4f 2066 6f72 6d61 740a 2020 2020 2061 MO format. a │ │ │ │ +0002c1b0: 7265 2072 6561 6420 6672 6f6d 2027 6c6f re read from 'lo │ │ │ │ +0002c1c0: 6361 6c65 5f64 6972 2720 282a 6e6f 7465 cale_dir' (*note │ │ │ │ +0002c1d0: 206c 6f63 616c 655f 6469 723a 3a29 2c20 locale_dir::), │ │ │ │ +0002c1e0: 7573 7561 6c6c 790a 2020 2020 2027 2f62 usually. '/b │ │ │ │ +0002c1f0: 6f6f 742f 6772 7562 2f6c 6f63 616c 6527 oot/grub/locale' │ │ │ │ +0002c200: 2e0a 0a1f 0a46 696c 653a 2067 7275 622e .....File: grub. │ │ │ │ +0002c210: 696e 666f 2c20 204e 6f64 653a 2067 7074 info, Node: gpt │ │ │ │ +0002c220: 7379 6e63 2c20 204e 6578 743a 2068 616c sync, Next: hal │ │ │ │ +0002c230: 742c 2020 5072 6576 3a20 6765 7474 6578 t, Prev: gettex │ │ │ │ +0002c240: 742c 2020 5570 3a20 436f 6d6d 616e 642d t, Up: Command- │ │ │ │ +0002c250: 6c69 6e65 2061 6e64 206d 656e 7520 656e line and menu en │ │ │ │ +0002c260: 7472 7920 636f 6d6d 616e 6473 0a0a 3136 try commands..16 │ │ │ │ +0002c270: 2e33 2e33 3020 6770 7473 796e 630a 2d2d .3.30 gptsync.-- │ │ │ │ +0002c280: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 -------------.. │ │ │ │ +0002c290: 2d2d 2043 6f6d 6d61 6e64 3a20 6770 7473 -- Command: gpts │ │ │ │ +0002c2a0: 796e 6320 6465 7669 6365 205b 7061 7274 ync device [part │ │ │ │ +0002c2b0: 6974 696f 6e5b 2b2f 2d5b 7479 7065 5d5d ition[+/-[type]] │ │ │ │ +0002c2c0: 5d20 2e2e 2e0a 2020 2020 2044 6973 6b73 ] .... Disks │ │ │ │ +0002c2d0: 2075 7369 6e67 2074 6865 2047 5549 4420 using the GUID │ │ │ │ +0002c2e0: 5061 7274 6974 696f 6e20 5461 626c 6520 Partition Table │ │ │ │ +0002c2f0: 2847 5054 2920 616c 736f 2068 6176 6520 (GPT) also have │ │ │ │ +0002c300: 6120 6c65 6761 6379 0a20 2020 2020 4d61 a legacy. Ma │ │ │ │ +0002c310: 7374 6572 2042 6f6f 7420 5265 636f 7264 ster Boot Record │ │ │ │ +0002c320: 2028 4d42 5229 2070 6172 7469 7469 6f6e (MBR) partition │ │ │ │ +0002c330: 2074 6162 6c65 2066 6f72 2063 6f6d 7061 table for compa │ │ │ │ +0002c340: 7469 6269 6c69 7479 2077 6974 6820 7468 tibility with th │ │ │ │ +0002c350: 650a 2020 2020 2042 494f 5320 616e 6420 e. BIOS and │ │ │ │ +0002c360: 7769 7468 206f 6c64 6572 206f 7065 7261 with older opera │ │ │ │ +0002c370: 7469 6e67 2073 7973 7465 6d73 2e20 2054 ting systems. T │ │ │ │ +0002c380: 6865 206c 6567 6163 7920 4d42 5220 6361 he legacy MBR ca │ │ │ │ +0002c390: 6e20 6f6e 6c79 0a20 2020 2020 7265 7072 n only. repr │ │ │ │ +0002c3a0: 6573 656e 7420 6120 6c69 6d69 7465 6420 esent a limited │ │ │ │ +0002c3b0: 7375 6273 6574 206f 6620 4750 5420 7061 subset of GPT pa │ │ │ │ +0002c3c0: 7274 6974 696f 6e20 656e 7472 6965 732e rtition entries. │ │ │ │ +0002c3d0: 0a0a 2020 2020 2054 6869 7320 636f 6d6d .. This comm │ │ │ │ +0002c3e0: 616e 6420 706f 7075 6c61 7465 7320 7468 and populates th │ │ │ │ +0002c3f0: 6520 6c65 6761 6379 204d 4252 2077 6974 e legacy MBR wit │ │ │ │ +0002c400: 6820 7468 6520 7370 6563 6966 6965 6420 h the specified │ │ │ │ +0002c410: 5041 5254 4954 494f 4e0a 2020 2020 2065 PARTITION. e │ │ │ │ +0002c420: 6e74 7269 6573 206f 6e20 4445 5649 4345 ntries on DEVICE │ │ │ │ +0002c430: 2e20 2055 7020 746f 2074 6872 6565 2070 . Up to three p │ │ │ │ +0002c440: 6172 7469 7469 6f6e 7320 6d61 7920 6265 artitions may be │ │ │ │ +0002c450: 2075 7365 642e 0a0a 2020 2020 2054 5950 used... TYP │ │ │ │ +0002c460: 4520 6973 2061 6e20 4d42 5220 7061 7274 E is an MBR part │ │ │ │ +0002c470: 6974 696f 6e20 7479 7065 2063 6f64 653b ition type code; │ │ │ │ +0002c480: 2070 7265 6669 7820 7769 7468 2027 3078 prefix with '0x │ │ │ │ +0002c490: 2720 6966 2079 6f75 2077 616e 7420 746f ' if you want to │ │ │ │ +0002c4a0: 0a20 2020 2020 656e 7465 7220 7468 6973 . enter this │ │ │ │ +0002c4b0: 2069 6e20 6865 7861 6465 6369 6d61 6c2e in hexadecimal. │ │ │ │ +0002c4c0: 2020 5468 6520 7365 7061 7261 746f 7220 The separator │ │ │ │ +0002c4d0: 6265 7477 6565 6e20 5041 5254 4954 494f between PARTITIO │ │ │ │ +0002c4e0: 4e20 616e 640a 2020 2020 2054 5950 4520 N and. TYPE │ │ │ │ +0002c4f0: 6d61 7920 6265 2027 2b27 2074 6f20 6d61 may be '+' to ma │ │ │ │ +0002c500: 6b65 2074 6865 2070 6172 7469 7469 6f6e ke the partition │ │ │ │ +0002c510: 2061 6374 6976 652c 206f 7220 272d 2720 active, or '-' │ │ │ │ +0002c520: 746f 206d 616b 6520 6974 0a20 2020 2020 to make it. │ │ │ │ +0002c530: 696e 6163 7469 7665 3b20 6f6e 6c79 206f inactive; only o │ │ │ │ +0002c540: 6e65 2070 6172 7469 7469 6f6e 206d 6179 ne partition may │ │ │ │ +0002c550: 2062 6520 6163 7469 7665 2e20 2049 6620 be active. If │ │ │ │ +0002c560: 626f 7468 2074 6865 2073 6570 6172 6174 both the separat │ │ │ │ +0002c570: 6f72 0a20 2020 2020 616e 6420 7479 7065 or. and type │ │ │ │ +0002c580: 2061 7265 206f 6d69 7474 6564 2c20 7468 are omitted, th │ │ │ │ +0002c590: 656e 2074 6865 2070 6172 7469 7469 6f6e en the partition │ │ │ │ +0002c5a0: 2077 696c 6c20 6265 2069 6e61 6374 6976 will be inactiv │ │ │ │ +0002c5b0: 652e 0a0a 1f0a 4669 6c65 3a20 6772 7562 e.....File: grub │ │ │ │ +0002c5c0: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 6861 .info, Node: ha │ │ │ │ +0002c5d0: 6c74 2c20 204e 6578 743a 2068 6173 6873 lt, Next: hashs │ │ │ │ +0002c5e0: 756d 2c20 2050 7265 763a 2067 7074 7379 um, Prev: gptsy │ │ │ │ +0002c5f0: 6e63 2c20 2055 703a 2043 6f6d 6d61 6e64 nc, Up: Command │ │ │ │ +0002c600: 2d6c 696e 6520 616e 6420 6d65 6e75 2065 -line and menu e │ │ │ │ +0002c610: 6e74 7279 2063 6f6d 6d61 6e64 730a 0a31 ntry commands..1 │ │ │ │ +0002c620: 362e 332e 3331 2068 616c 740a 2d2d 2d2d 6.3.31 halt.---- │ │ │ │ +0002c630: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 436f --------.. -- Co │ │ │ │ +0002c640: 6d6d 616e 643a 2068 616c 7420 272d 2d6e mmand: halt '--n │ │ │ │ +0002c650: 6f2d 6170 6d27 0a20 2020 2020 5468 6520 o-apm'. The │ │ │ │ +0002c660: 636f 6d6d 616e 6420 6861 6c74 7320 7468 command halts th │ │ │ │ +0002c670: 6520 636f 6d70 7574 6572 2e20 2049 6620 e computer. If │ │ │ │ +0002c680: 7468 6520 272d 2d6e 6f2d 6170 6d27 206f the '--no-apm' o │ │ │ │ +0002c690: 7074 696f 6e20 6973 0a20 2020 2020 7370 ption is. sp │ │ │ │ +0002c6a0: 6563 6966 6965 642c 206e 6f20 4150 4d20 ecified, no APM │ │ │ │ +0002c6b0: 4249 4f53 2063 616c 6c20 6973 2070 6572 BIOS call is per │ │ │ │ +0002c6c0: 666f 726d 6564 2e20 204f 7468 6572 7769 formed. Otherwi │ │ │ │ +0002c6d0: 7365 2c20 7468 6520 636f 6d70 7574 6572 se, the computer │ │ │ │ +0002c6e0: 0a20 2020 2020 6973 2073 6875 7420 646f . is shut do │ │ │ │ +0002c6f0: 776e 2075 7369 6e67 2041 504d 2e0a 0a1f wn using APM.... │ │ │ │ +0002c700: 0a46 696c 653a 2067 7275 622e 696e 666f .File: grub.info │ │ │ │ +0002c710: 2c20 204e 6f64 653a 2068 6173 6873 756d , Node: hashsum │ │ │ │ +0002c720: 2c20 204e 6578 743a 2068 656c 702c 2020 , Next: help, │ │ │ │ +0002c730: 5072 6576 3a20 6861 6c74 2c20 2055 703a Prev: halt, Up: │ │ │ │ +0002c740: 2043 6f6d 6d61 6e64 2d6c 696e 6520 616e Command-line an │ │ │ │ +0002c750: 6420 6d65 6e75 2065 6e74 7279 2063 6f6d d menu entry com │ │ │ │ +0002c760: 6d61 6e64 730a 0a31 362e 332e 3332 2068 mands..16.3.32 h │ │ │ │ +0002c770: 6173 6873 756d 0a2d 2d2d 2d2d 2d2d 2d2d ashsum.--------- │ │ │ │ +0002c780: 2d2d 2d2d 2d2d 0a0a 202d 2d20 436f 6d6d ------.. -- Comm │ │ │ │ +0002c790: 616e 643a 2068 6173 6873 756d 2027 2d2d and: hashsum '-- │ │ │ │ +0002c7a0: 6861 7368 2720 6861 7368 2027 2d2d 6b65 hash' hash '--ke │ │ │ │ +0002c7b0: 6570 2d67 6f69 6e67 2720 272d 2d75 6e63 ep-going' '--unc │ │ │ │ +0002c7c0: 6f6d 7072 6573 7327 0a20 2020 2020 2020 ompress'. │ │ │ │ +0002c7d0: 2020 2027 2d2d 6368 6563 6b27 2066 696c '--check' fil │ │ │ │ +0002c7e0: 6520 5b27 2d2d 7072 6566 6978 2720 6469 e ['--prefix' di │ │ │ │ +0002c7f0: 725d 7c66 696c 6520 2e2e 2e0a 2020 2020 r]|file .... │ │ │ │ +0002c800: 2043 6f6d 7075 7465 206f 7220 7665 7269 Compute or veri │ │ │ │ +0002c810: 6679 2066 696c 6520 6861 7368 6573 2e20 fy file hashes. │ │ │ │ +0002c820: 2048 6173 6820 7479 7065 2069 7320 7365 Hash type is se │ │ │ │ +0002c830: 6c65 6374 6564 2077 6974 6820 6f70 7469 lected with opti │ │ │ │ +0002c840: 6f6e 0a20 2020 2020 272d 2d68 6173 6827 on. '--hash' │ │ │ │ +0002c850: 2e20 2053 7570 706f 7274 6564 2068 6173 . Supported has │ │ │ │ +0002c860: 6865 7320 6172 653a 2027 6164 6c65 7233 hes are: 'adler3 │ │ │ │ +0002c870: 3227 2c20 2763 7263 3634 272c 2027 6372 2', 'crc64', 'cr │ │ │ │ +0002c880: 6333 3227 2c0a 2020 2020 2027 6372 6333 c32',. 'crc3 │ │ │ │ +0002c890: 3272 6663 3135 3130 272c 2027 6372 6332 2rfc1510', 'crc2 │ │ │ │ +0002c8a0: 3472 6663 3234 3430 272c 2027 6d64 3427 4rfc2440', 'md4' │ │ │ │ +0002c8b0: 2c20 276d 6435 272c 2027 7269 7065 6d64 , 'md5', 'ripemd │ │ │ │ +0002c8c0: 3136 3027 2c20 2773 6861 3127 2c0a 2020 160', 'sha1',. │ │ │ │ +0002c8d0: 2020 2027 7368 6132 3234 272c 2027 7368 'sha224', 'sh │ │ │ │ +0002c8e0: 6132 3536 272c 2027 7368 6135 3132 272c a256', 'sha512', │ │ │ │ +0002c8f0: 2027 7368 6133 3834 272c 2027 7469 6765 'sha384', 'tige │ │ │ │ +0002c900: 7231 3932 272c 2027 7469 6765 7227 2c0a r192', 'tiger',. │ │ │ │ +0002c910: 2020 2020 2027 7469 6765 7232 272c 2027 'tiger2', ' │ │ │ │ +0002c920: 7768 6972 6c70 6f6f 6c27 2e20 204f 7074 whirlpool'. Opt │ │ │ │ +0002c930: 696f 6e20 272d 2d75 6e63 6f6d 7072 6573 ion '--uncompres │ │ │ │ +0002c940: 7327 2075 6e63 6f6d 7072 6573 7365 7320 s' uncompresses │ │ │ │ +0002c950: 6669 6c65 730a 2020 2020 2062 6566 6f72 files. befor │ │ │ │ +0002c960: 6520 636f 6d70 7574 696e 6720 6861 7368 e computing hash │ │ │ │ +0002c970: 2e0a 0a20 2020 2020 5768 656e 206c 6973 ... When lis │ │ │ │ +0002c980: 7420 6f66 2066 696c 6573 2069 7320 6769 t of files is gi │ │ │ │ +0002c990: 7665 6e2c 2068 6173 6820 6f66 2065 6163 ven, hash of eac │ │ │ │ +0002c9a0: 6820 6669 6c65 2069 7320 636f 6d70 7574 h file is comput │ │ │ │ +0002c9b0: 6564 2061 6e64 0a20 2020 2020 7072 696e ed and. prin │ │ │ │ +0002c9c0: 7465 642c 2066 6f6c 6c6f 7765 6420 6279 ted, followed by │ │ │ │ +0002c9d0: 2066 696c 6520 6e61 6d65 2c20 6561 6368 file name, each │ │ │ │ +0002c9e0: 2066 696c 6520 6f6e 2061 206e 6577 206c file on a new l │ │ │ │ +0002c9f0: 696e 652e 0a0a 2020 2020 2057 6865 6e20 ine... When │ │ │ │ +0002ca00: 6f70 7469 6f6e 2027 2d2d 6368 6563 6b27 option '--check' │ │ │ │ +0002ca10: 2069 7320 6769 7665 6e2c 2069 7420 706f is given, it po │ │ │ │ +0002ca20: 696e 7473 2074 6f20 6120 6669 6c65 2074 ints to a file t │ │ │ │ +0002ca30: 6861 7420 636f 6e74 6169 6e73 0a20 2020 hat contains. │ │ │ │ +0002ca40: 2020 6c69 7374 206f 6620 4841 5348 204e list of HASH N │ │ │ │ +0002ca50: 414d 4520 7061 6972 7320 696e 2074 6865 AME pairs in the │ │ │ │ +0002ca60: 2073 616d 6520 666f 726d 6174 2061 7320 same format as │ │ │ │ +0002ca70: 7573 6564 2062 7920 554e 4958 2027 6d64 used by UNIX 'md │ │ │ │ +0002ca80: 3573 756d 270a 2020 2020 2063 6f6d 6d61 5sum'. comma │ │ │ │ +0002ca90: 6e64 2e20 204f 7074 696f 6e20 272d 2d70 nd. Option '--p │ │ │ │ +0002caa0: 7265 6669 7827 206d 6179 2062 6520 7573 refix' may be us │ │ │ │ +0002cab0: 6564 2074 6f20 6769 7665 2064 6972 6563 ed to give direc │ │ │ │ +0002cac0: 746f 7279 2077 6865 7265 0a20 2020 2020 tory where. │ │ │ │ +0002cad0: 6669 6c65 7320 6172 6520 6c6f 6361 7465 files are locate │ │ │ │ +0002cae0: 642e 2020 4861 7368 2076 6572 6966 6963 d. Hash verific │ │ │ │ +0002caf0: 6174 696f 6e20 7374 6f70 7320 6166 7465 ation stops afte │ │ │ │ +0002cb00: 7220 7468 6520 6669 7273 740a 2020 2020 r the first. │ │ │ │ +0002cb10: 206d 6973 6d61 7463 6820 7761 7320 666f mismatch was fo │ │ │ │ +0002cb20: 756e 6420 756e 6c65 7373 206f 7074 696f und unless optio │ │ │ │ +0002cb30: 6e20 272d 2d6b 6565 702d 676f 696e 6727 n '--keep-going' │ │ │ │ +0002cb40: 2077 6173 2067 6976 656e 2e20 2054 6865 was given. The │ │ │ │ +0002cb50: 0a20 2020 2020 6578 6974 2063 6f64 6520 . exit code │ │ │ │ +0002cb60: 2724 3f27 2069 7320 7365 7420 746f 2030 '$?' is set to 0 │ │ │ │ +0002cb70: 2069 6620 6861 7368 2076 6572 6966 6963 if hash verific │ │ │ │ +0002cb80: 6174 696f 6e20 6973 2073 7563 6365 7373 ation is success │ │ │ │ +0002cb90: 6675 6c2e 2020 4966 0a20 2020 2020 6974 ful. If. it │ │ │ │ +0002cba0: 2066 6169 6c73 2c20 2724 3f27 2069 7320 fails, '$?' is │ │ │ │ +0002cbb0: 7365 7420 746f 2061 206e 6f6e 7a65 726f set to a nonzero │ │ │ │ +0002cbc0: 2076 616c 7565 2e0a 0a1f 0a46 696c 653a value.....File: │ │ │ │ +0002cbd0: 2067 7275 622e 696e 666f 2c20 204e 6f64 grub.info, Nod │ │ │ │ +0002cbe0: 653a 2068 656c 702c 2020 4e65 7874 3a20 e: help, Next: │ │ │ │ +0002cbf0: 696e 6974 7264 2c20 2050 7265 763a 2068 initrd, Prev: h │ │ │ │ +0002cc00: 6173 6873 756d 2c20 2055 703a 2043 6f6d ashsum, Up: Com │ │ │ │ +0002cc10: 6d61 6e64 2d6c 696e 6520 616e 6420 6d65 mand-line and me │ │ │ │ +0002cc20: 6e75 2065 6e74 7279 2063 6f6d 6d61 6e64 nu entry command │ │ │ │ +0002cc30: 730a 0a31 362e 332e 3333 2068 656c 700a s..16.3.33 help. │ │ │ │ +0002cc40: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d ------------.. - │ │ │ │ +0002cc50: 2d20 436f 6d6d 616e 643a 2068 656c 7020 - Command: help │ │ │ │ +0002cc60: 5b70 6174 7465 726e 202e 2e2e 5d0a 2020 [pattern ...]. │ │ │ │ +0002cc70: 2020 2044 6973 706c 6179 2068 656c 7066 Display helpf │ │ │ │ +0002cc80: 756c 2069 6e66 6f72 6d61 7469 6f6e 2061 ul information a │ │ │ │ +0002cc90: 626f 7574 2062 7569 6c74 696e 2063 6f6d bout builtin com │ │ │ │ +0002cca0: 6d61 6e64 732e 2020 4966 2079 6f75 2064 mands. If you d │ │ │ │ +0002ccb0: 6f20 6e6f 740a 2020 2020 2073 7065 6369 o not. speci │ │ │ │ +0002ccc0: 6679 2050 4154 5445 524e 2c20 7468 6973 fy PATTERN, this │ │ │ │ +0002ccd0: 2063 6f6d 6d61 6e64 2073 686f 7773 2073 command shows s │ │ │ │ +0002cce0: 686f 7274 2064 6573 6372 6970 7469 6f6e hort description │ │ │ │ +0002ccf0: 7320 6f66 2061 6c6c 0a20 2020 2020 6176 s of all. av │ │ │ │ +0002cd00: 6169 6c61 626c 6520 636f 6d6d 616e 6473 ailable commands │ │ │ │ +0002cd10: 2e0a 0a20 2020 2020 4966 2079 6f75 2073 ... If you s │ │ │ │ +0002cd20: 7065 6369 6679 2061 6e79 2050 4154 5445 pecify any PATTE │ │ │ │ +0002cd30: 524e 532c 2069 7420 6469 7370 6c61 7973 RNS, it displays │ │ │ │ +0002cd40: 206c 6f6e 6765 7220 696e 666f 726d 6174 longer informat │ │ │ │ +0002cd50: 696f 6e20 6162 6f75 740a 2020 2020 2065 ion about. e │ │ │ │ +0002cd60: 6163 6820 6f66 2074 6865 2063 6f6d 6d61 ach of the comma │ │ │ │ +0002cd70: 6e64 7320 7768 6f73 6520 6e61 6d65 7320 nds whose names │ │ │ │ +0002cd80: 6265 6769 6e20 7769 7468 2074 686f 7365 begin with those │ │ │ │ +0002cd90: 2050 4154 5445 524e 532e 0a0a 1f0a 4669 PATTERNS.....Fi │ │ │ │ +0002cda0: 6c65 3a20 6772 7562 2e69 6e66 6f2c 2020 le: grub.info, │ │ │ │ +0002cdb0: 4e6f 6465 3a20 696e 6974 7264 2c20 204e Node: initrd, N │ │ │ │ +0002cdc0: 6578 743a 2069 6e69 7472 6431 362c 2020 ext: initrd16, │ │ │ │ +0002cdd0: 5072 6576 3a20 6865 6c70 2c20 2055 703a Prev: help, Up: │ │ │ │ +0002cde0: 2043 6f6d 6d61 6e64 2d6c 696e 6520 616e Command-line an │ │ │ │ +0002cdf0: 6420 6d65 6e75 2065 6e74 7279 2063 6f6d d menu entry com │ │ │ │ +0002ce00: 6d61 6e64 730a 0a31 362e 332e 3334 2069 mands..16.3.34 i │ │ │ │ +0002ce10: 6e69 7472 640a 2d2d 2d2d 2d2d 2d2d 2d2d nitrd.---------- │ │ │ │ +0002ce20: 2d2d 2d2d 0a0a 202d 2d20 436f 6d6d 616e ----.. -- Comman │ │ │ │ +0002ce30: 643a 2069 6e69 7472 6420 6669 6c65 0a20 d: initrd file. │ │ │ │ +0002ce40: 2020 2020 4c6f 6164 2061 6e20 696e 6974 Load an init │ │ │ │ +0002ce50: 6961 6c20 7261 6d64 6973 6b20 666f 7220 ial ramdisk for │ │ │ │ +0002ce60: 6120 4c69 6e75 7820 6b65 726e 656c 2069 a Linux kernel i │ │ │ │ +0002ce70: 6d61 6765 2c20 616e 6420 7365 7420 7468 mage, and set th │ │ │ │ +0002ce80: 650a 2020 2020 2061 7070 726f 7072 6961 e. appropria │ │ │ │ +0002ce90: 7465 2070 6172 616d 6574 6572 7320 696e te parameters in │ │ │ │ +0002cea0: 2074 6865 204c 696e 7578 2073 6574 7570 the Linux setup │ │ │ │ +0002ceb0: 2061 7265 6120 696e 206d 656d 6f72 792e area in memory. │ │ │ │ +0002cec0: 2020 5468 6973 206d 6179 0a20 2020 2020 This may. │ │ │ │ +0002ced0: 6f6e 6c79 2062 6520 7573 6564 2061 6674 only be used aft │ │ │ │ +0002cee0: 6572 2074 6865 2027 6c69 6e75 7827 2063 er the 'linux' c │ │ │ │ +0002cef0: 6f6d 6d61 6e64 2028 2a6e 6f74 6520 6c69 ommand (*note li │ │ │ │ +0002cf00: 6e75 783a 3a29 2068 6173 2062 6565 6e0a nux::) has been. │ │ │ │ +0002cf10: 2020 2020 2072 756e 2e20 2053 6565 2061 run. See a │ │ │ │ +0002cf20: 6c73 6f20 2a6e 6f74 6520 474e 552f 4c69 lso *note GNU/Li │ │ │ │ +0002cf30: 6e75 783a 3a2e 0a0a 1f0a 4669 6c65 3a20 nux::.....File: │ │ │ │ +0002cf40: 6772 7562 2e69 6e66 6f2c 2020 4e6f 6465 grub.info, Node │ │ │ │ +0002cf50: 3a20 696e 6974 7264 3136 2c20 204e 6578 : initrd16, Nex │ │ │ │ +0002cf60: 743a 2069 6e73 6d6f 642c 2020 5072 6576 t: insmod, Prev │ │ │ │ +0002cf70: 3a20 696e 6974 7264 2c20 2055 703a 2043 : initrd, Up: C │ │ │ │ +0002cf80: 6f6d 6d61 6e64 2d6c 696e 6520 616e 6420 ommand-line and │ │ │ │ +0002cf90: 6d65 6e75 2065 6e74 7279 2063 6f6d 6d61 menu entry comma │ │ │ │ +0002cfa0: 6e64 730a 0a31 362e 332e 3335 2069 6e69 nds..16.3.35 ini │ │ │ │ +0002cfb0: 7472 6431 360a 2d2d 2d2d 2d2d 2d2d 2d2d trd16.---------- │ │ │ │ +0002cfc0: 2d2d 2d2d 2d2d 0a0a 202d 2d20 436f 6d6d ------.. -- Comm │ │ │ │ +0002cfd0: 616e 643a 2069 6e69 7472 6431 3620 6669 and: initrd16 fi │ │ │ │ +0002cfe0: 6c65 0a20 2020 2020 4c6f 6164 2061 6e20 le. Load an │ │ │ │ +0002cff0: 696e 6974 6961 6c20 7261 6d64 6973 6b20 initial ramdisk │ │ │ │ +0002d000: 666f 7220 6120 4c69 6e75 7820 6b65 726e for a Linux kern │ │ │ │ +0002d010: 656c 2069 6d61 6765 2074 6f20 6265 2062 el image to be b │ │ │ │ +0002d020: 6f6f 7465 6420 696e 0a20 2020 2020 3136 ooted in. 16 │ │ │ │ +0002d030: 2d62 6974 206d 6f64 652c 2061 6e64 2073 -bit mode, and s │ │ │ │ +0002d040: 6574 2074 6865 2061 7070 726f 7072 6961 et the appropria │ │ │ │ +0002d050: 7465 2070 6172 616d 6574 6572 7320 696e te parameters in │ │ │ │ +0002d060: 2074 6865 204c 696e 7578 2073 6574 7570 the Linux setup │ │ │ │ +0002d070: 0a20 2020 2020 6172 6561 2069 6e20 6d65 . area in me │ │ │ │ +0002d080: 6d6f 7279 2e20 2054 6869 7320 6d61 7920 mory. This may │ │ │ │ +0002d090: 6f6e 6c79 2062 6520 7573 6564 2061 6674 only be used aft │ │ │ │ +0002d0a0: 6572 2074 6865 2027 6c69 6e75 7831 3627 er the 'linux16' │ │ │ │ +0002d0b0: 2063 6f6d 6d61 6e64 0a20 2020 2020 282a command. (* │ │ │ │ +0002d0c0: 6e6f 7465 206c 696e 7578 3136 3a3a 2920 note linux16::) │ │ │ │ +0002d0d0: 6861 7320 6265 656e 2072 756e 2e20 2053 has been run. S │ │ │ │ +0002d0e0: 6565 2061 6c73 6f20 2a6e 6f74 6520 474e ee also *note GN │ │ │ │ +0002d0f0: 552f 4c69 6e75 783a 3a2e 0a0a 2020 2020 U/Linux::... │ │ │ │ +0002d100: 2054 6869 7320 636f 6d6d 616e 6420 6973 This command is │ │ │ │ +0002d110: 206f 6e6c 7920 6176 6169 6c61 626c 6520 only available │ │ │ │ +0002d120: 6f6e 2078 3836 2073 7973 7465 6d73 2e0a on x86 systems.. │ │ │ │ +0002d130: 0a1f 0a46 696c 653a 2067 7275 622e 696e ...File: grub.in │ │ │ │ +0002d140: 666f 2c20 204e 6f64 653a 2069 6e73 6d6f fo, Node: insmo │ │ │ │ +0002d150: 642c 2020 4e65 7874 3a20 6b65 7973 7461 d, Next: keysta │ │ │ │ +0002d160: 7475 732c 2020 5072 6576 3a20 696e 6974 tus, Prev: init │ │ │ │ +0002d170: 7264 3136 2c20 2055 703a 2043 6f6d 6d61 rd16, Up: Comma │ │ │ │ +0002d180: 6e64 2d6c 696e 6520 616e 6420 6d65 6e75 nd-line and menu │ │ │ │ +0002d190: 2065 6e74 7279 2063 6f6d 6d61 6e64 730a entry commands. │ │ │ │ +0002d1a0: 0a31 362e 332e 3336 2069 6e73 6d6f 640a .16.3.36 insmod. │ │ │ │ +0002d1b0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a --------------.. │ │ │ │ +0002d1c0: 202d 2d20 436f 6d6d 616e 643a 2069 6e73 -- Command: ins │ │ │ │ +0002d1d0: 6d6f 6420 6d6f 6475 6c65 0a20 2020 2020 mod module. │ │ │ │ +0002d1e0: 496e 7365 7274 2074 6865 2064 796e 616d Insert the dynam │ │ │ │ +0002d1f0: 6963 2047 5255 4220 6d6f 6475 6c65 2063 ic GRUB module c │ │ │ │ +0002d200: 616c 6c65 6420 4d4f 4455 4c45 2e0a 0a1f alled MODULE.... │ │ │ │ +0002d210: 0a46 696c 653a 2067 7275 622e 696e 666f .File: grub.info │ │ │ │ +0002d220: 2c20 204e 6f64 653a 206b 6579 7374 6174 , Node: keystat │ │ │ │ +0002d230: 7573 2c20 204e 6578 743a 206c 696e 7578 us, Next: linux │ │ │ │ +0002d240: 2c20 2050 7265 763a 2069 6e73 6d6f 642c , Prev: insmod, │ │ │ │ +0002d250: 2020 5570 3a20 436f 6d6d 616e 642d 6c69 Up: Command-li │ │ │ │ +0002d260: 6e65 2061 6e64 206d 656e 7520 656e 7472 ne and menu entr │ │ │ │ +0002d270: 7920 636f 6d6d 616e 6473 0a0a 3136 2e33 y commands..16.3 │ │ │ │ +0002d280: 2e33 3720 6b65 7973 7461 7475 730a 2d2d .37 keystatus.-- │ │ │ │ +0002d290: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a ---------------. │ │ │ │ +0002d2a0: 0a20 2d2d 2043 6f6d 6d61 6e64 3a20 6b65 . -- Command: ke │ │ │ │ +0002d2b0: 7973 7461 7475 7320 5b27 2d2d 7368 6966 ystatus ['--shif │ │ │ │ +0002d2c0: 7427 5d20 5b27 2d2d 6374 726c 275d 205b t'] ['--ctrl'] [ │ │ │ │ +0002d2d0: 272d 2d61 6c74 275d 0a20 2020 2020 5265 '--alt']. Re │ │ │ │ +0002d2e0: 7475 726e 2074 7275 6520 6966 2074 6865 turn true if the │ │ │ │ +0002d2f0: 2053 6869 6674 2c20 436f 6e74 726f 6c2c Shift, Control, │ │ │ │ +0002d300: 206f 7220 416c 7420 6d6f 6469 6669 6572 or Alt modifier │ │ │ │ +0002d310: 206b 6579 7320 6172 6520 6865 6c64 0a20 keys are held. │ │ │ │ +0002d320: 2020 2020 646f 776e 2c20 6173 2072 6571 down, as req │ │ │ │ +0002d330: 7565 7374 6564 2062 7920 6f70 7469 6f6e uested by option │ │ │ │ +0002d340: 732e 2020 5468 6973 2069 7320 7573 6566 s. This is usef │ │ │ │ +0002d350: 756c 2069 6e20 7363 7269 7074 696e 672c ul in scripting, │ │ │ │ +0002d360: 2074 6f0a 2020 2020 2061 6c6c 6f77 2073 to. allow s │ │ │ │ +0002d370: 6f6d 6520 7573 6572 2063 6f6e 7472 6f6c ome user control │ │ │ │ +0002d380: 206f 7665 7220 6265 6861 7669 6f75 7220 over behaviour │ │ │ │ +0002d390: 7769 7468 6f75 7420 6861 7669 6e67 2074 without having t │ │ │ │ +0002d3a0: 6f20 7761 6974 2066 6f72 2061 0a20 2020 o wait for a. │ │ │ │ +0002d3b0: 2020 6b65 7970 7265 7373 2e0a 0a20 2020 keypress... │ │ │ │ +0002d3c0: 2020 4368 6563 6b69 6e67 206b 6579 206d Checking key m │ │ │ │ +0002d3d0: 6f64 6966 6965 7220 7374 6174 7573 2069 odifier status i │ │ │ │ +0002d3e0: 7320 6f6e 6c79 2073 7570 706f 7274 6564 s only supported │ │ │ │ +0002d3f0: 206f 6e20 736f 6d65 2070 6c61 7466 6f72 on some platfor │ │ │ │ +0002d400: 6d73 2e0a 2020 2020 2049 6620 696e 766f ms.. If invo │ │ │ │ +0002d410: 6b65 6420 7769 7468 6f75 7420 616e 7920 ked without any │ │ │ │ +0002d420: 6f70 7469 6f6e 732c 2074 6865 2027 6b65 options, the 'ke │ │ │ │ +0002d430: 7973 7461 7475 7327 2063 6f6d 6d61 6e64 ystatus' command │ │ │ │ +0002d440: 2072 6574 7572 6e73 0a20 2020 2020 7472 returns. tr │ │ │ │ +0002d450: 7565 2069 6620 616e 6420 6f6e 6c79 2069 ue if and only i │ │ │ │ +0002d460: 6620 6368 6563 6b69 6e67 206b 6579 206d f checking key m │ │ │ │ +0002d470: 6f64 6966 6965 7220 7374 6174 7573 2069 odifier status i │ │ │ │ +0002d480: 7320 7375 7070 6f72 7465 642e 0a0a 1f0a s supported..... │ │ │ │ +0002d490: 4669 6c65 3a20 6772 7562 2e69 6e66 6f2c File: grub.info, │ │ │ │ +0002d4a0: 2020 4e6f 6465 3a20 6c69 6e75 782c 2020 Node: linux, │ │ │ │ +0002d4b0: 4e65 7874 3a20 6c69 6e75 7831 362c 2020 Next: linux16, │ │ │ │ +0002d4c0: 5072 6576 3a20 6b65 7973 7461 7475 732c Prev: keystatus, │ │ │ │ +0002d4d0: 2020 5570 3a20 436f 6d6d 616e 642d 6c69 Up: Command-li │ │ │ │ +0002d4e0: 6e65 2061 6e64 206d 656e 7520 656e 7472 ne and menu entr │ │ │ │ +0002d4f0: 7920 636f 6d6d 616e 6473 0a0a 3136 2e33 y commands..16.3 │ │ │ │ +0002d500: 2e33 3820 6c69 6e75 780a 2d2d 2d2d 2d2d .38 linux.------ │ │ │ │ +0002d510: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2043 6f6d -------.. -- Com │ │ │ │ +0002d520: 6d61 6e64 3a20 6c69 6e75 7820 6669 6c65 mand: linux file │ │ │ │ +0002d530: 202e 2e2e 0a20 2020 2020 4c6f 6164 2061 .... Load a │ │ │ │ +0002d540: 204c 696e 7578 206b 6572 6e65 6c20 696d Linux kernel im │ │ │ │ +0002d550: 6167 6520 6672 6f6d 2046 494c 452e 2020 age from FILE. │ │ │ │ +0002d560: 5468 6520 7265 7374 206f 6620 7468 6520 The rest of the │ │ │ │ +0002d570: 6c69 6e65 2069 730a 2020 2020 2070 6173 line is. pas │ │ │ │ +0002d580: 7365 6420 7665 7262 6174 696d 2061 7320 sed verbatim as │ │ │ │ +0002d590: 7468 6520 226b 6572 6e65 6c20 636f 6d6d the "kernel comm │ │ │ │ +0002d5a0: 616e 642d 6c69 6e65 222e 2020 416e 7920 and-line". Any │ │ │ │ +0002d5b0: 696e 6974 7264 206d 7573 7420 6265 0a20 initrd must be. │ │ │ │ +0002d5c0: 2020 2020 7265 6c6f 6164 6564 2061 6674 reloaded aft │ │ │ │ +0002d5d0: 6572 2075 7369 6e67 2074 6869 7320 636f er using this co │ │ │ │ +0002d5e0: 6d6d 616e 6420 282a 6e6f 7465 2069 6e69 mmand (*note ini │ │ │ │ +0002d5f0: 7472 643a 3a29 2e0a 0a20 2020 2020 4f6e trd::)... On │ │ │ │ +0002d600: 2078 3836 2073 7973 7465 6d73 2c20 7468 x86 systems, th │ │ │ │ +0002d610: 6520 6b65 726e 656c 2077 696c 6c20 6265 e kernel will be │ │ │ │ +0002d620: 2062 6f6f 7465 6420 7573 696e 6720 7468 booted using th │ │ │ │ +0002d630: 6520 3332 2d62 6974 2062 6f6f 740a 2020 e 32-bit boot. │ │ │ │ +0002d640: 2020 2070 726f 746f 636f 6c2e 2020 4e6f protocol. No │ │ │ │ +0002d650: 7465 2074 6861 7420 7468 6973 206d 6561 te that this mea │ │ │ │ +0002d660: 6e73 2074 6861 7420 7468 6520 2776 6761 ns that the 'vga │ │ │ │ +0002d670: 3d27 2062 6f6f 7420 6f70 7469 6f6e 2077 =' boot option w │ │ │ │ +0002d680: 696c 6c0a 2020 2020 206e 6f74 2077 6f72 ill. not wor │ │ │ │ +0002d690: 6b3b 2069 6620 796f 7520 7761 6e74 2074 k; if you want t │ │ │ │ +0002d6a0: 6f20 7365 7420 6120 7370 6563 6961 6c20 o set a special │ │ │ │ +0002d6b0: 7669 6465 6f20 6d6f 6465 2c20 796f 7520 video mode, you │ │ │ │ +0002d6c0: 7769 6c6c 206e 6565 6420 746f 0a20 2020 will need to. │ │ │ │ +0002d6d0: 2020 7573 6520 4752 5542 2063 6f6d 6d61 use GRUB comma │ │ │ │ +0002d6e0: 6e64 7320 7375 6368 2061 7320 2773 6574 nds such as 'set │ │ │ │ +0002d6f0: 2067 6678 7061 796c 6f61 643d 3130 3234 gfxpayload=1024 │ │ │ │ +0002d700: 7837 3638 2720 6f72 2027 7365 740a 2020 x768' or 'set. │ │ │ │ +0002d710: 2020 2067 6678 7061 796c 6f61 643d 6b65 gfxpayload=ke │ │ │ │ +0002d720: 6570 2720 2874 6f20 6b65 6570 2074 6865 ep' (to keep the │ │ │ │ +0002d730: 2073 616d 6520 6d6f 6465 2061 7320 7573 same mode as us │ │ │ │ +0002d740: 6564 2069 6e20 4752 5542 2920 696e 7374 ed in GRUB) inst │ │ │ │ +0002d750: 6561 642e 0a20 2020 2020 4752 5542 2063 ead.. GRUB c │ │ │ │ +0002d760: 616e 2061 7574 6f6d 6174 6963 616c 6c79 an automatically │ │ │ │ +0002d770: 2064 6574 6563 7420 736f 6d65 2075 7365 detect some use │ │ │ │ +0002d780: 7320 6f66 2027 7667 613d 2720 616e 6420 s of 'vga=' and │ │ │ │ +0002d790: 7472 616e 736c 6174 650a 2020 2020 2074 translate. t │ │ │ │ +0002d7a0: 6865 6d20 746f 2061 7070 726f 7072 6961 hem to appropria │ │ │ │ +0002d7b0: 7465 2073 6574 7469 6e67 7320 6f66 2027 te settings of ' │ │ │ │ +0002d7c0: 6766 7870 6179 6c6f 6164 272e 2020 5468 gfxpayload'. Th │ │ │ │ +0002d7d0: 6520 276c 696e 7578 3136 270a 2020 2020 e 'linux16'. │ │ │ │ +0002d7e0: 2063 6f6d 6d61 6e64 2028 2a6e 6f74 6520 command (*note │ │ │ │ +0002d7f0: 6c69 6e75 7831 363a 3a29 2061 766f 6964 linux16::) avoid │ │ │ │ +0002d800: 7320 7468 6973 2072 6573 7472 6963 7469 s this restricti │ │ │ │ +0002d810: 6f6e 2e0a 0a1f 0a46 696c 653a 2067 7275 on.....File: gru │ │ │ │ +0002d820: 622e 696e 666f 2c20 204e 6f64 653a 206c b.info, Node: l │ │ │ │ +0002d830: 696e 7578 3136 2c20 204e 6578 743a 206c inux16, Next: l │ │ │ │ +0002d840: 6973 745f 656e 762c 2020 5072 6576 3a20 ist_env, Prev: │ │ │ │ +0002d850: 6c69 6e75 782c 2020 5570 3a20 436f 6d6d linux, Up: Comm │ │ │ │ +0002d860: 616e 642d 6c69 6e65 2061 6e64 206d 656e and-line and men │ │ │ │ +0002d870: 7520 656e 7472 7920 636f 6d6d 616e 6473 u entry commands │ │ │ │ +0002d880: 0a0a 3136 2e33 2e33 3920 6c69 6e75 7831 ..16.3.39 linux1 │ │ │ │ +0002d890: 360a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 6.-------------- │ │ │ │ +0002d8a0: 2d0a 0a20 2d2d 2043 6f6d 6d61 6e64 3a20 -.. -- Command: │ │ │ │ +0002d8b0: 6c69 6e75 7831 3620 6669 6c65 202e 2e2e linux16 file ... │ │ │ │ +0002d8c0: 0a20 2020 2020 4c6f 6164 2061 204c 696e . Load a Lin │ │ │ │ +0002d8d0: 7578 206b 6572 6e65 6c20 696d 6167 6520 ux kernel image │ │ │ │ +0002d8e0: 6672 6f6d 2046 494c 4520 696e 2031 362d from FILE in 16- │ │ │ │ +0002d8f0: 6269 7420 6d6f 6465 2e20 2054 6865 2072 bit mode. The r │ │ │ │ +0002d900: 6573 7420 6f66 0a20 2020 2020 7468 6520 est of. the │ │ │ │ +0002d910: 6c69 6e65 2069 7320 7061 7373 6564 2076 line is passed v │ │ │ │ +0002d920: 6572 6261 7469 6d20 6173 2074 6865 2022 erbatim as the " │ │ │ │ +0002d930: 6b65 726e 656c 2063 6f6d 6d61 6e64 2d6c kernel command-l │ │ │ │ +0002d940: 696e 6522 2e20 2041 6e79 0a20 2020 2020 ine". Any. │ │ │ │ +0002d950: 696e 6974 7264 206d 7573 7420 6265 2072 initrd must be r │ │ │ │ +0002d960: 656c 6f61 6465 6420 6166 7465 7220 7573 eloaded after us │ │ │ │ +0002d970: 696e 6720 7468 6973 2063 6f6d 6d61 6e64 ing this command │ │ │ │ +0002d980: 2028 2a6e 6f74 650a 2020 2020 2069 6e69 (*note. ini │ │ │ │ +0002d990: 7472 6431 363a 3a29 2e0a 0a20 2020 2020 trd16::)... │ │ │ │ +0002d9a0: 5468 6520 6b65 726e 656c 2077 696c 6c20 The kernel will │ │ │ │ +0002d9b0: 6265 2062 6f6f 7465 6420 7573 696e 6720 be booted using │ │ │ │ +0002d9c0: 7468 6520 7472 6164 6974 696f 6e61 6c20 the traditional │ │ │ │ +0002d9d0: 3136 2d62 6974 2062 6f6f 740a 2020 2020 16-bit boot. │ │ │ │ +0002d9e0: 2070 726f 746f 636f 6c2e 2020 4173 2077 protocol. As w │ │ │ │ +0002d9f0: 656c 6c20 6173 2062 7970 6173 7369 6e67 ell as bypassing │ │ │ │ +0002da00: 2070 726f 626c 656d 7320 7769 7468 2027 problems with ' │ │ │ │ +0002da10: 7667 613d 2720 6465 7363 7269 6265 6420 vga=' described │ │ │ │ +0002da20: 696e 0a20 2020 2020 2a6e 6f74 6520 6c69 in. *note li │ │ │ │ +0002da30: 6e75 783a 3a2c 2074 6869 7320 7065 726d nux::, this perm │ │ │ │ +0002da40: 6974 7320 626f 6f74 696e 6720 736f 6d65 its booting some │ │ │ │ +0002da50: 206f 7468 6572 2070 726f 6772 616d 7320 other programs │ │ │ │ +0002da60: 7468 6174 0a20 2020 2020 696d 706c 656d that. implem │ │ │ │ +0002da70: 656e 7420 7468 6520 4c69 6e75 7820 626f ent the Linux bo │ │ │ │ +0002da80: 6f74 2070 726f 746f 636f 6c20 666f 7220 ot protocol for │ │ │ │ +0002da90: 7468 6520 7361 6b65 206f 6620 636f 6e76 the sake of conv │ │ │ │ +0002daa0: 656e 6965 6e63 652e 0a0a 2020 2020 2054 enience... T │ │ │ │ +0002dab0: 6869 7320 636f 6d6d 616e 6420 6973 206f his command is o │ │ │ │ +0002dac0: 6e6c 7920 6176 6169 6c61 626c 6520 6f6e nly available on │ │ │ │ +0002dad0: 2078 3836 2073 7973 7465 6d73 2e0a 0a1f x86 systems.... │ │ │ │ +0002dae0: 0a46 696c 653a 2067 7275 622e 696e 666f .File: grub.info │ │ │ │ +0002daf0: 2c20 204e 6f64 653a 206c 6973 745f 656e , Node: list_en │ │ │ │ +0002db00: 762c 2020 4e65 7874 3a20 6c69 7374 5f74 v, Next: list_t │ │ │ │ +0002db10: 7275 7374 6564 2c20 2050 7265 763a 206c rusted, Prev: l │ │ │ │ +0002db20: 696e 7578 3136 2c20 2055 703a 2043 6f6d inux16, Up: Com │ │ │ │ +0002db30: 6d61 6e64 2d6c 696e 6520 616e 6420 6d65 mand-line and me │ │ │ │ +0002db40: 6e75 2065 6e74 7279 2063 6f6d 6d61 6e64 nu entry command │ │ │ │ +0002db50: 730a 0a31 362e 332e 3430 206c 6973 745f s..16.3.40 list_ │ │ │ │ +0002db60: 656e 760a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d env.------------ │ │ │ │ +0002db70: 2d2d 2d2d 0a0a 202d 2d20 436f 6d6d 616e ----.. -- Comman │ │ │ │ +0002db80: 643a 206c 6973 745f 656e 7620 5b27 2d2d d: list_env ['-- │ │ │ │ +0002db90: 6669 6c65 2720 6669 6c65 5d0a 2020 2020 file' file]. │ │ │ │ +0002dba0: 204c 6973 7420 616c 6c20 7661 7269 6162 List all variab │ │ │ │ +0002dbb0: 6c65 7320 696e 2074 6865 2065 6e76 6972 les in the envir │ │ │ │ +0002dbc0: 6f6e 6d65 6e74 2062 6c6f 636b 2066 696c onment block fil │ │ │ │ +0002dbd0: 652e 2020 2a4e 6f74 650a 2020 2020 2045 e. *Note. E │ │ │ │ +0002dbe0: 6e76 6972 6f6e 6d65 6e74 2062 6c6f 636b nvironment block │ │ │ │ +0002dbf0: 3a3a 2e0a 0a20 2020 2020 5468 6520 272d ::... The '- │ │ │ │ +0002dc00: 2d66 696c 6527 206f 7074 696f 6e20 6f76 -file' option ov │ │ │ │ +0002dc10: 6572 7269 6465 7320 7468 6520 6465 6661 errides the defa │ │ │ │ +0002dc20: 756c 7420 6c6f 6361 7469 6f6e 206f 6620 ult location of │ │ │ │ +0002dc30: 7468 650a 2020 2020 2065 6e76 6972 6f6e the. environ │ │ │ │ +0002dc40: 6d65 6e74 2062 6c6f 636b 2e0a 0a1f 0a46 ment block.....F │ │ │ │ +0002dc50: 696c 653a 2067 7275 622e 696e 666f 2c20 ile: grub.info, │ │ │ │ +0002dc60: 204e 6f64 653a 206c 6973 745f 7472 7573 Node: list_trus │ │ │ │ +0002dc70: 7465 642c 2020 4e65 7874 3a20 6c6f 6164 ted, Next: load │ │ │ │ +0002dc80: 5f65 6e76 2c20 2050 7265 763a 206c 6973 _env, Prev: lis │ │ │ │ +0002dc90: 745f 656e 762c 2020 5570 3a20 436f 6d6d t_env, Up: Comm │ │ │ │ +0002dca0: 616e 642d 6c69 6e65 2061 6e64 206d 656e and-line and men │ │ │ │ +0002dcb0: 7520 656e 7472 7920 636f 6d6d 616e 6473 u entry commands │ │ │ │ +0002dcc0: 0a0a 3136 2e33 2e34 3120 6c69 7374 5f74 ..16.3.41 list_t │ │ │ │ +0002dcd0: 7275 7374 6564 0a2d 2d2d 2d2d 2d2d 2d2d rusted.--------- │ │ │ │ +0002dce0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d -----------.. -- │ │ │ │ +0002dcf0: 2043 6f6d 6d61 6e64 3a20 6c69 7374 5f74 Command: list_t │ │ │ │ +0002dd00: 7275 7374 6564 0a20 2020 2020 4c69 7374 rusted. List │ │ │ │ +0002dd10: 2061 6c6c 2070 7562 6c69 6320 6b65 7973 all public keys │ │ │ │ +0002dd20: 2074 7275 7374 6564 2062 7920 4752 5542 trusted by GRUB │ │ │ │ +0002dd30: 2066 6f72 2076 616c 6964 6174 696e 6720 for validating │ │ │ │ +0002dd40: 7369 676e 6174 7572 6573 2e0a 2020 2020 signatures.. │ │ │ │ +0002dd50: 2054 6865 206f 7574 7075 7420 6973 2069 The output is i │ │ │ │ +0002dd60: 6e20 4750 4727 7320 7634 206b 6579 2066 n GPG's v4 key f │ │ │ │ +0002dd70: 696e 6765 7270 7269 6e74 2066 6f72 6d61 ingerprint forma │ │ │ │ +0002dd80: 7420 2869 2e65 2e2c 2074 6865 206f 7574 t (i.e., the out │ │ │ │ +0002dd90: 7075 740a 2020 2020 206f 6620 2767 7067 put. of 'gpg │ │ │ │ +0002dda0: 202d 2d66 696e 6765 7270 7269 6e74 2729 --fingerprint') │ │ │ │ +0002ddb0: 2e20 2054 6865 206c 6561 7374 2073 6967 . The least sig │ │ │ │ +0002ddc0: 6e69 6669 6361 6e74 2066 6f75 7220 6279 nificant four by │ │ │ │ +0002ddd0: 7465 7320 286c 6173 740a 2020 2020 2065 tes (last. e │ │ │ │ +0002dde0: 6967 6874 2068 6578 6164 6563 696d 616c ight hexadecimal │ │ │ │ +0002ddf0: 2064 6967 6974 7329 2063 616e 2062 6520 digits) can be │ │ │ │ +0002de00: 7573 6564 2061 7320 616e 2061 7267 756d used as an argum │ │ │ │ +0002de10: 656e 7420 746f 2027 6469 7374 7275 7374 ent to 'distrust │ │ │ │ +0002de20: 270a 2020 2020 2028 2a6e 6f74 6520 6469 '. (*note di │ │ │ │ +0002de30: 7374 7275 7374 3a3a 292e 2020 2a4e 6f74 strust::). *Not │ │ │ │ +0002de40: 6520 5573 696e 6720 6469 6769 7461 6c20 e Using digital │ │ │ │ +0002de50: 7369 676e 6174 7572 6573 3a3a 2c20 666f signatures::, fo │ │ │ │ +0002de60: 7220 6d6f 7265 0a20 2020 2020 696e 666f r more. info │ │ │ │ +0002de70: 726d 6174 696f 6e20 6162 6f75 7420 7573 rmation about us │ │ │ │ +0002de80: 6573 2066 6f72 2074 6865 7365 206b 6579 es for these key │ │ │ │ +0002de90: 732e 0a0a 1f0a 4669 6c65 3a20 6772 7562 s.....File: grub │ │ │ │ +0002dea0: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 6c6f .info, Node: lo │ │ │ │ +0002deb0: 6164 5f65 6e76 2c20 204e 6578 743a 206c ad_env, Next: l │ │ │ │ +0002dec0: 6f61 6466 6f6e 742c 2020 5072 6576 3a20 oadfont, Prev: │ │ │ │ +0002ded0: 6c69 7374 5f74 7275 7374 6564 2c20 2055 list_trusted, U │ │ │ │ +0002dee0: 703a 2043 6f6d 6d61 6e64 2d6c 696e 6520 p: Command-line │ │ │ │ +0002def0: 616e 6420 6d65 6e75 2065 6e74 7279 2063 and menu entry c │ │ │ │ +0002df00: 6f6d 6d61 6e64 730a 0a31 362e 332e 3432 ommands..16.3.42 │ │ │ │ +0002df10: 206c 6f61 645f 656e 760a 2d2d 2d2d 2d2d load_env.------ │ │ │ │ +0002df20: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 ----------.. -- │ │ │ │ +0002df30: 436f 6d6d 616e 643a 206c 6f61 645f 656e Command: load_en │ │ │ │ +0002df40: 7620 5b27 2d2d 6669 6c65 2720 6669 6c65 v ['--file' file │ │ │ │ +0002df50: 5d20 5b27 2d2d 736b 6970 2d73 6967 275d ] ['--skip-sig'] │ │ │ │ +0002df60: 0a20 2020 2020 2020 2020 205b 7768 6974 . [whit │ │ │ │ +0002df70: 656c 6973 7465 645f 7661 7269 6162 6c65 elisted_variable │ │ │ │ +0002df80: 5f6e 616d 655d 202e 2e2e 0a20 2020 2020 _name] .... │ │ │ │ +0002df90: 4c6f 6164 2061 6c6c 2076 6172 6961 626c Load all variabl │ │ │ │ +0002dfa0: 6573 2066 726f 6d20 7468 6520 656e 7669 es from the envi │ │ │ │ +0002dfb0: 726f 6e6d 656e 7420 626c 6f63 6b20 6669 ronment block fi │ │ │ │ +0002dfc0: 6c65 2069 6e74 6f20 7468 650a 2020 2020 le into the. │ │ │ │ +0002dfd0: 2065 6e76 6972 6f6e 6d65 6e74 2e20 202a environment. * │ │ │ │ +0002dfe0: 4e6f 7465 2045 6e76 6972 6f6e 6d65 6e74 Note Environment │ │ │ │ +0002dff0: 2062 6c6f 636b 3a3a 2e0a 0a20 2020 2020 block::... │ │ │ │ +0002e000: 5468 6520 272d 2d66 696c 6527 206f 7074 The '--file' opt │ │ │ │ +0002e010: 696f 6e20 6f76 6572 7269 6465 7320 7468 ion overrides th │ │ │ │ +0002e020: 6520 6465 6661 756c 7420 6c6f 6361 7469 e default locati │ │ │ │ +0002e030: 6f6e 206f 6620 7468 650a 2020 2020 2065 on of the. e │ │ │ │ +0002e040: 6e76 6972 6f6e 6d65 6e74 2062 6c6f 636b nvironment block │ │ │ │ +0002e050: 2e0a 0a20 2020 2020 5468 6520 272d 2d73 ... The '--s │ │ │ │ +0002e060: 6b69 702d 7369 6727 206f 7074 696f 6e20 kip-sig' option │ │ │ │ +0002e070: 736b 6970 7320 7369 676e 6174 7572 6520 skips signature │ │ │ │ +0002e080: 6368 6563 6b69 6e67 2065 7665 6e20 7768 checking even wh │ │ │ │ +0002e090: 656e 2074 6865 0a20 2020 2020 7661 6c75 en the. valu │ │ │ │ +0002e0a0: 6520 6f66 2065 6e76 6972 6f6e 6d65 6e74 e of environment │ │ │ │ +0002e0b0: 2076 6172 6961 626c 6520 2763 6865 636b variable 'check │ │ │ │ +0002e0c0: 5f73 6967 6e61 7475 7265 7327 2069 7320 _signatures' is │ │ │ │ +0002e0d0: 7365 7420 746f 0a20 2020 2020 2765 6e66 set to. 'enf │ │ │ │ +0002e0e0: 6f72 6365 2720 282a 6e6f 7465 2063 6865 orce' (*note che │ │ │ │ +0002e0f0: 636b 5f73 6967 6e61 7475 7265 733a 3a29 ck_signatures::) │ │ │ │ +0002e100: 2e0a 0a20 2020 2020 4966 206f 6e65 206f ... If one o │ │ │ │ +0002e110: 7220 6d6f 7265 2076 6172 6961 626c 6520 r more variable │ │ │ │ +0002e120: 6e61 6d65 7320 6172 6520 7072 6f76 6964 names are provid │ │ │ │ +0002e130: 6564 2061 7320 6172 6775 6d65 6e74 732c ed as arguments, │ │ │ │ +0002e140: 2074 6865 7920 6172 650a 2020 2020 2069 they are. i │ │ │ │ +0002e150: 6e74 6572 7072 6574 6564 2061 7320 6120 nterpreted as a │ │ │ │ +0002e160: 7768 6974 656c 6973 7420 6f66 2076 6172 whitelist of var │ │ │ │ +0002e170: 6961 626c 6573 2074 6f20 6c6f 6164 2066 iables to load f │ │ │ │ +0002e180: 726f 6d20 7468 650a 2020 2020 2065 6e76 rom the. env │ │ │ │ +0002e190: 6972 6f6e 6d65 6e74 2062 6c6f 636b 2066 ironment block f │ │ │ │ +0002e1a0: 696c 652e 2020 5661 7269 6162 6c65 7320 ile. Variables │ │ │ │ +0002e1b0: 7365 7420 696e 2074 6865 2066 696c 6520 set in the file │ │ │ │ +0002e1c0: 6275 7420 6e6f 7420 7072 6573 656e 740a but not present. │ │ │ │ +0002e1d0: 2020 2020 2069 6e20 7468 6520 7768 6974 in the whit │ │ │ │ +0002e1e0: 656c 6973 7420 6172 6520 6967 6e6f 7265 elist are ignore │ │ │ │ +0002e1f0: 642e 0a0a 2020 2020 2054 6865 2027 2d2d d... The '-- │ │ │ │ +0002e200: 736b 6970 2d73 6967 2720 6f70 7469 6f6e skip-sig' option │ │ │ │ +0002e210: 2073 686f 756c 6420 6265 2075 7365 6420 should be used │ │ │ │ +0002e220: 7769 7468 2063 6172 652c 2061 6e64 2073 with care, and s │ │ │ │ +0002e230: 686f 756c 6420 616c 7761 7973 0a20 2020 hould always. │ │ │ │ +0002e240: 2020 6265 2075 7365 6420 696e 2063 6f6e be used in con │ │ │ │ +0002e250: 6365 7274 2077 6974 6820 6120 7768 6974 cert with a whit │ │ │ │ +0002e260: 656c 6973 7420 6f66 2061 6363 6570 7461 elist of accepta │ │ │ │ +0002e270: 626c 6520 7661 7269 6162 6c65 7320 7768 ble variables wh │ │ │ │ +0002e280: 6f73 650a 2020 2020 2076 616c 7565 7320 ose. values │ │ │ │ +0002e290: 7368 6f75 6c64 2062 6520 7365 742e 2020 should be set. │ │ │ │ +0002e2a0: 4661 696c 7572 6520 746f 2065 6d70 6c6f Failure to emplo │ │ │ │ +0002e2b0: 7920 6120 6361 7265 6675 6c6c 7920 636f y a carefully co │ │ │ │ +0002e2c0: 6e73 7472 7563 7465 640a 2020 2020 2077 nstructed. w │ │ │ │ +0002e2d0: 6869 7465 6c69 7374 2063 6f75 6c64 2072 hitelist could r │ │ │ │ +0002e2e0: 6573 756c 7420 696e 2072 6561 6469 6e67 esult in reading │ │ │ │ +0002e2f0: 2061 206d 616c 6963 696f 7573 2076 616c a malicious val │ │ │ │ +0002e300: 7565 2069 6e74 6f20 6372 6974 6963 616c ue into critical │ │ │ │ +0002e310: 0a20 2020 2020 656e 7669 726f 6e6d 656e . environmen │ │ │ │ +0002e320: 7420 7661 7269 6162 6c65 7320 6672 6f6d t variables from │ │ │ │ +0002e330: 2074 6865 2066 696c 652c 2073 7563 6820 the file, such │ │ │ │ +0002e340: 6173 2073 6574 7469 6e67 0a20 2020 2020 as setting. │ │ │ │ +0002e350: 2763 6865 636b 5f73 6967 6e61 7475 7265 'check_signature │ │ │ │ +0002e360: 733d 6e6f 272c 206d 6f64 6966 7969 6e67 s=no', modifying │ │ │ │ +0002e370: 2027 7072 6566 6978 2720 746f 2062 6f6f 'prefix' to boo │ │ │ │ +0002e380: 7420 6672 6f6d 2061 6e0a 2020 2020 2075 t from an. u │ │ │ │ +0002e390: 6e65 7870 6563 7465 6420 6c6f 6361 7469 nexpected locati │ │ │ │ +0002e3a0: 6f6e 206f 7220 6e6f 7420 6174 2061 6c6c on or not at all │ │ │ │ +0002e3b0: 2c20 6574 632e 0a0a 2020 2020 2057 6865 , etc... Whe │ │ │ │ +0002e3c0: 6e20 7573 6564 2077 6974 6820 6361 7265 n used with care │ │ │ │ +0002e3d0: 2c20 272d 2d73 6b69 702d 7369 6727 2061 , '--skip-sig' a │ │ │ │ +0002e3e0: 6e64 2074 6865 2077 6869 7465 6c69 7374 nd the whitelist │ │ │ │ +0002e3f0: 2065 6e61 626c 6520 616e 0a20 2020 2020 enable an. │ │ │ │ +0002e400: 6164 6d69 6e69 7374 7261 746f 7220 746f administrator to │ │ │ │ +0002e410: 2063 6f6e 6669 6775 7265 2061 2073 7973 configure a sys │ │ │ │ +0002e420: 7465 6d20 746f 2062 6f6f 7420 6f6e 6c79 tem to boot only │ │ │ │ +0002e430: 2073 6967 6e65 640a 2020 2020 2063 6f6e signed. con │ │ │ │ +0002e440: 6669 6775 7261 7469 6f6e 732c 2062 7574 figurations, but │ │ │ │ +0002e450: 2074 6f20 616c 6c6f 7720 7468 6520 7573 to allow the us │ │ │ │ +0002e460: 6572 2074 6f20 7365 6c65 6374 2066 726f er to select fro │ │ │ │ +0002e470: 6d20 616d 6f6e 6720 6d75 6c74 6970 6c65 m among multiple │ │ │ │ +0002e480: 0a20 2020 2020 636f 6e66 6967 7572 6174 . configurat │ │ │ │ +0002e490: 696f 6e73 2c20 616e 6420 746f 2065 6e61 ions, and to ena │ │ │ │ +0002e4a0: 626c 6520 226f 6e65 2d73 686f 7422 2062 ble "one-shot" b │ │ │ │ +0002e4b0: 6f6f 7420 6174 7465 6d70 7473 2061 6e64 oot attempts and │ │ │ │ +0002e4c0: 0a20 2020 2020 2273 6176 6564 6566 6175 . "savedefau │ │ │ │ +0002e4d0: 6c74 2220 6265 6861 7669 6f72 2e20 202a lt" behavior. * │ │ │ │ +0002e4e0: 4e6f 7465 2055 7369 6e67 2064 6967 6974 Note Using digit │ │ │ │ +0002e4f0: 616c 2073 6967 6e61 7475 7265 733a 3a2c al signatures::, │ │ │ │ +0002e500: 2066 6f72 206d 6f72 650a 2020 2020 2069 for more. i │ │ │ │ +0002e510: 6e66 6f72 6d61 7469 6f6e 2e0a 0a1f 0a46 nformation.....F │ │ │ │ +0002e520: 696c 653a 2067 7275 622e 696e 666f 2c20 ile: grub.info, │ │ │ │ +0002e530: 204e 6f64 653a 206c 6f61 6466 6f6e 742c Node: loadfont, │ │ │ │ +0002e540: 2020 4e65 7874 3a20 6c6f 6f70 6261 636b Next: loopback │ │ │ │ +0002e550: 2c20 2050 7265 763a 206c 6f61 645f 656e , Prev: load_en │ │ │ │ +0002e560: 762c 2020 5570 3a20 436f 6d6d 616e 642d v, Up: Command- │ │ │ │ +0002e570: 6c69 6e65 2061 6e64 206d 656e 7520 656e line and menu en │ │ │ │ +0002e580: 7472 7920 636f 6d6d 616e 6473 0a0a 3136 try commands..16 │ │ │ │ +0002e590: 2e33 2e34 3320 6c6f 6164 666f 6e74 0a2d .3.43 loadfont.- │ │ │ │ +0002e5a0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a ---------------. │ │ │ │ +0002e5b0: 0a20 2d2d 2043 6f6d 6d61 6e64 3a20 6c6f . -- Command: lo │ │ │ │ +0002e5c0: 6164 666f 6e74 2066 696c 6520 2e2e 2e0a adfont file .... │ │ │ │ +0002e5d0: 2020 2020 204c 6f61 6420 7370 6563 6966 Load specif │ │ │ │ +0002e5e0: 6965 6420 666f 6e74 2066 696c 6573 2e20 ied font files. │ │ │ │ +0002e5f0: 2055 6e6c 6573 7320 6162 736f 6c75 7465 Unless absolute │ │ │ │ +0002e600: 2070 6174 686e 616d 6520 6973 2067 6976 pathname is giv │ │ │ │ +0002e610: 656e 2c20 4649 4c45 0a20 2020 2020 6973 en, FILE. is │ │ │ │ +0002e620: 2061 7373 756d 6564 2074 6f20 6265 2069 assumed to be i │ │ │ │ +0002e630: 6e20 6469 7265 6374 6f72 7920 2724 7072 n directory '$pr │ │ │ │ +0002e640: 6566 6978 2f66 6f6e 7473 2720 7769 7468 efix/fonts' with │ │ │ │ +0002e650: 2073 7566 6669 7820 272e 7066 3227 0a20 suffix '.pf2'. │ │ │ │ +0002e660: 2020 2020 6170 7065 6e64 6564 2e20 202a appended. * │ │ │ │ +0002e670: 4e6f 7465 2046 6f6e 7473 3a20 5468 656d Note Fonts: Them │ │ │ │ +0002e680: 6520 6669 6c65 2066 6f72 6d61 742e 0a0a e file format... │ │ │ │ +0002e690: 1f0a 4669 6c65 3a20 6772 7562 2e69 6e66 ..File: grub.inf │ │ │ │ +0002e6a0: 6f2c 2020 4e6f 6465 3a20 6c6f 6f70 6261 o, Node: loopba │ │ │ │ +0002e6b0: 636b 2c20 204e 6578 743a 206c 732c 2020 ck, Next: ls, │ │ │ │ +0002e6c0: 5072 6576 3a20 6c6f 6164 666f 6e74 2c20 Prev: loadfont, │ │ │ │ +0002e6d0: 2055 703a 2043 6f6d 6d61 6e64 2d6c 696e Up: Command-lin │ │ │ │ +0002e6e0: 6520 616e 6420 6d65 6e75 2065 6e74 7279 e and menu entry │ │ │ │ +0002e6f0: 2063 6f6d 6d61 6e64 730a 0a31 362e 332e commands..16.3. │ │ │ │ +0002e700: 3434 206c 6f6f 7062 6163 6b0a 2d2d 2d2d 44 loopback.---- │ │ │ │ +0002e710: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d ------------.. - │ │ │ │ +0002e720: 2d20 436f 6d6d 616e 643a 206c 6f6f 7062 - Command: loopb │ │ │ │ +0002e730: 6163 6b20 5b27 2d64 275d 2064 6576 6963 ack ['-d'] devic │ │ │ │ +0002e740: 6520 6669 6c65 0a20 2020 2020 4d61 6b65 e file. Make │ │ │ │ +0002e750: 2074 6865 2064 6576 6963 6520 6e61 6d65 the device name │ │ │ │ +0002e760: 6420 4445 5649 4345 2063 6f72 7265 7370 d DEVICE corresp │ │ │ │ +0002e770: 6f6e 6420 746f 2074 6865 2063 6f6e 7465 ond to the conte │ │ │ │ +0002e780: 6e74 7320 6f66 2074 6865 0a20 2020 2020 nts of the. │ │ │ │ +0002e790: 6669 6c65 7379 7374 656d 2069 6d61 6765 filesystem image │ │ │ │ +0002e7a0: 2069 6e20 4649 4c45 2e20 2046 6f72 2065 in FILE. For e │ │ │ │ +0002e7b0: 7861 6d70 6c65 3a0a 0a20 2020 2020 2020 xample:.. │ │ │ │ +0002e7c0: 2020 206c 6f6f 7062 6163 6b20 6c6f 6f70 loopback loop │ │ │ │ +0002e7d0: 3020 2f70 6174 682f 746f 2f69 6d61 6765 0 /path/to/image │ │ │ │ +0002e7e0: 0a20 2020 2020 2020 2020 206c 7320 286c . ls (l │ │ │ │ +0002e7f0: 6f6f 7030 292f 0a0a 2020 2020 2057 6974 oop0)/.. Wit │ │ │ │ +0002e800: 6820 7468 6520 272d 6427 206f 7074 696f h the '-d' optio │ │ │ │ +0002e810: 6e2c 2064 656c 6574 6520 6120 6465 7669 n, delete a devi │ │ │ │ +0002e820: 6365 2070 7265 7669 6f75 736c 7920 6372 ce previously cr │ │ │ │ +0002e830: 6561 7465 6420 7573 696e 6720 7468 6973 eated using this │ │ │ │ +0002e840: 0a20 2020 2020 636f 6d6d 616e 642e 0a0a . command... │ │ │ │ +0002e850: 1f0a 4669 6c65 3a20 6772 7562 2e69 6e66 ..File: grub.inf │ │ │ │ +0002e860: 6f2c 2020 4e6f 6465 3a20 6c73 2c20 204e o, Node: ls, N │ │ │ │ +0002e870: 6578 743a 206c 7366 6f6e 7473 2c20 2050 ext: lsfonts, P │ │ │ │ +0002e880: 7265 763a 206c 6f6f 7062 6163 6b2c 2020 rev: loopback, │ │ │ │ +0002e890: 5570 3a20 436f 6d6d 616e 642d 6c69 6e65 Up: Command-line │ │ │ │ +0002e8a0: 2061 6e64 206d 656e 7520 656e 7472 7920 and menu entry │ │ │ │ +0002e8b0: 636f 6d6d 616e 6473 0a0a 3136 2e33 2e34 commands..16.3.4 │ │ │ │ +0002e8c0: 3520 6c73 0a2d 2d2d 2d2d 2d2d 2d2d 2d0a 5 ls.----------. │ │ │ │ +0002e8d0: 0a20 2d2d 2043 6f6d 6d61 6e64 3a20 6c73 . -- Command: ls │ │ │ │ +0002e8e0: 205b 6172 6720 2e2e 2e5d 0a20 2020 2020 [arg ...]. │ │ │ │ +0002e8f0: 4c69 7374 2064 6576 6963 6573 206f 7220 List devices or │ │ │ │ +0002e900: 6669 6c65 732e 0a0a 2020 2020 2057 6974 files... Wit │ │ │ │ +0002e910: 6820 6e6f 2061 7267 756d 656e 7473 2c20 h no arguments, │ │ │ │ +0002e920: 7072 696e 7420 616c 6c20 6465 7669 6365 print all device │ │ │ │ +0002e930: 7320 6b6e 6f77 6e20 746f 2047 5255 422e s known to GRUB. │ │ │ │ +0002e940: 0a0a 2020 2020 2049 6620 7468 6520 6172 .. If the ar │ │ │ │ +0002e950: 6775 6d65 6e74 2069 7320 6120 6465 7669 gument is a devi │ │ │ │ +0002e960: 6365 206e 616d 6520 656e 636c 6f73 6564 ce name enclosed │ │ │ │ +0002e970: 2069 6e20 7061 7265 6e74 6865 7365 7320 in parentheses │ │ │ │ +0002e980: 282a 6e6f 7465 0a20 2020 2020 4465 7669 (*note. Devi │ │ │ │ +0002e990: 6365 2073 796e 7461 783a 3a29 2c20 7468 ce syntax::), th │ │ │ │ +0002e9a0: 656e 2070 7269 6e74 2074 6865 206e 616d en print the nam │ │ │ │ +0002e9b0: 6520 6f66 2074 6865 2066 696c 6573 7973 e of the filesys │ │ │ │ +0002e9c0: 7465 6d20 6f66 2074 6861 740a 2020 2020 tem of that. │ │ │ │ +0002e9d0: 2064 6576 6963 652e 0a0a 2020 2020 2049 device... I │ │ │ │ +0002e9e0: 6620 7468 6520 6172 6775 6d65 6e74 2069 f the argument i │ │ │ │ +0002e9f0: 7320 6120 6469 7265 6374 6f72 7920 6769 s a directory gi │ │ │ │ +0002ea00: 7665 6e20 6173 2061 6e20 6162 736f 6c75 ven as an absolu │ │ │ │ +0002ea10: 7465 2066 696c 6520 6e61 6d65 0a20 2020 te file name. │ │ │ │ +0002ea20: 2020 282a 6e6f 7465 2046 696c 6520 6e61 (*note File na │ │ │ │ +0002ea30: 6d65 2073 796e 7461 783a 3a29 2c20 7468 me syntax::), th │ │ │ │ +0002ea40: 656e 206c 6973 7420 7468 6520 636f 6e74 en list the cont │ │ │ │ +0002ea50: 656e 7473 206f 6620 7468 6174 0a20 2020 ents of that. │ │ │ │ +0002ea60: 2020 6469 7265 6374 6f72 792e 0a0a 1f0a directory..... │ │ │ │ +0002ea70: 4669 6c65 3a20 6772 7562 2e69 6e66 6f2c File: grub.info, │ │ │ │ +0002ea80: 2020 4e6f 6465 3a20 6c73 666f 6e74 732c Node: lsfonts, │ │ │ │ +0002ea90: 2020 4e65 7874 3a20 6c73 6d6f 642c 2020 Next: lsmod, │ │ │ │ +0002eaa0: 5072 6576 3a20 6c73 2c20 2055 703a 2043 Prev: ls, Up: C │ │ │ │ +0002eab0: 6f6d 6d61 6e64 2d6c 696e 6520 616e 6420 ommand-line and │ │ │ │ +0002eac0: 6d65 6e75 2065 6e74 7279 2063 6f6d 6d61 menu entry comma │ │ │ │ +0002ead0: 6e64 730a 0a31 362e 332e 3436 206c 7366 nds..16.3.46 lsf │ │ │ │ +0002eae0: 6f6e 7473 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d onts.----------- │ │ │ │ +0002eaf0: 2d2d 2d2d 0a0a 202d 2d20 436f 6d6d 616e ----.. -- Comman │ │ │ │ +0002eb00: 643a 206c 7366 6f6e 7473 0a20 2020 2020 d: lsfonts. │ │ │ │ +0002eb10: 4c69 7374 206c 6f61 6465 6420 666f 6e74 List loaded font │ │ │ │ +0002eb20: 732e 0a0a 1f0a 4669 6c65 3a20 6772 7562 s.....File: grub │ │ │ │ +0002eb30: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 6c73 .info, Node: ls │ │ │ │ +0002eb40: 6d6f 642c 2020 4e65 7874 3a20 6d64 3573 mod, Next: md5s │ │ │ │ +0002eb50: 756d 2c20 2050 7265 763a 206c 7366 6f6e um, Prev: lsfon │ │ │ │ +0002eb60: 7473 2c20 2055 703a 2043 6f6d 6d61 6e64 ts, Up: Command │ │ │ │ +0002eb70: 2d6c 696e 6520 616e 6420 6d65 6e75 2065 -line and menu e │ │ │ │ +0002eb80: 6e74 7279 2063 6f6d 6d61 6e64 730a 0a31 ntry commands..1 │ │ │ │ +0002eb90: 362e 332e 3437 206c 736d 6f64 0a2d 2d2d 6.3.47 lsmod.--- │ │ │ │ +0002eba0: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 ----------.. -- │ │ │ │ +0002ebb0: 436f 6d6d 616e 643a 206c 736d 6f64 0a20 Command: lsmod. │ │ │ │ +0002ebc0: 2020 2020 5368 6f77 206c 6973 7420 6f66 Show list of │ │ │ │ +0002ebd0: 206c 6f61 6465 6420 6d6f 6475 6c65 732e loaded modules. │ │ │ │ +0002ebe0: 0a0a 1f0a 4669 6c65 3a20 6772 7562 2e69 ....File: grub.i │ │ │ │ +0002ebf0: 6e66 6f2c 2020 4e6f 6465 3a20 6d64 3573 nfo, Node: md5s │ │ │ │ +0002ec00: 756d 2c20 204e 6578 743a 206d 6f64 756c um, Next: modul │ │ │ │ +0002ec10: 652c 2020 5072 6576 3a20 6c73 6d6f 642c e, Prev: lsmod, │ │ │ │ +0002ec20: 2020 5570 3a20 436f 6d6d 616e 642d 6c69 Up: Command-li │ │ │ │ +0002ec30: 6e65 2061 6e64 206d 656e 7520 656e 7472 ne and menu entr │ │ │ │ +0002ec40: 7920 636f 6d6d 616e 6473 0a0a 3136 2e33 y commands..16.3 │ │ │ │ +0002ec50: 2e34 3820 6d64 3573 756d 0a2d 2d2d 2d2d .48 md5sum.----- │ │ │ │ +0002ec60: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2043 ---------.. -- C │ │ │ │ +0002ec70: 6f6d 6d61 6e64 3a20 6d64 3573 756d 2061 ommand: md5sum a │ │ │ │ +0002ec80: 7267 202e 2e2e 0a20 2020 2020 416c 6961 rg .... Alia │ │ │ │ +0002ec90: 7320 666f 7220 2768 6173 6873 756d 202d s for 'hashsum - │ │ │ │ +0002eca0: 2d68 6173 6820 6d64 3520 6172 6720 2e2e -hash md5 arg .. │ │ │ │ +0002ecb0: 2e27 2e20 2053 6565 2063 6f6d 6d61 6e64 .'. See command │ │ │ │ +0002ecc0: 2027 6861 7368 7375 6d27 0a20 2020 2020 'hashsum'. │ │ │ │ +0002ecd0: 282a 6e6f 7465 2068 6173 6873 756d 3a3a (*note hashsum:: │ │ │ │ +0002ece0: 2920 666f 7220 6675 6c6c 2064 6573 6372 ) for full descr │ │ │ │ +0002ecf0: 6970 7469 6f6e 2e0a 0a1f 0a46 696c 653a iption.....File: │ │ │ │ +0002ed00: 2067 7275 622e 696e 666f 2c20 204e 6f64 grub.info, Nod │ │ │ │ +0002ed10: 653a 206d 6f64 756c 652c 2020 4e65 7874 e: module, Next │ │ │ │ +0002ed20: 3a20 6d75 6c74 6962 6f6f 742c 2020 5072 : multiboot, Pr │ │ │ │ +0002ed30: 6576 3a20 6d64 3573 756d 2c20 2055 703a ev: md5sum, Up: │ │ │ │ +0002ed40: 2043 6f6d 6d61 6e64 2d6c 696e 6520 616e Command-line an │ │ │ │ +0002ed50: 6420 6d65 6e75 2065 6e74 7279 2063 6f6d d menu entry com │ │ │ │ +0002ed60: 6d61 6e64 730a 0a31 362e 332e 3439 206d mands..16.3.49 m │ │ │ │ +0002ed70: 6f64 756c 650a 2d2d 2d2d 2d2d 2d2d 2d2d odule.---------- │ │ │ │ +0002ed80: 2d2d 2d2d 0a0a 202d 2d20 436f 6d6d 616e ----.. -- Comman │ │ │ │ +0002ed90: 643a 206d 6f64 756c 6520 5b2d 2d6e 6f75 d: module [--nou │ │ │ │ +0002eda0: 6e7a 6970 5d20 6669 6c65 205b 6172 6775 nzip] file [argu │ │ │ │ +0002edb0: 6d65 6e74 735d 0a20 2020 2020 4c6f 6164 ments]. Load │ │ │ │ +0002edc0: 2061 206d 6f64 756c 6520 666f 7220 6d75 a module for mu │ │ │ │ +0002edd0: 6c74 6962 6f6f 7420 6b65 726e 656c 2069 ltiboot kernel i │ │ │ │ +0002ede0: 6d61 6765 2e20 2054 6865 2072 6573 7420 mage. The rest │ │ │ │ +0002edf0: 6f66 2074 6865 206c 696e 6520 6973 0a20 of the line is. │ │ │ │ +0002ee00: 2020 2020 7061 7373 6564 2076 6572 6261 passed verba │ │ │ │ +0002ee10: 7469 6d20 6173 2074 6865 206d 6f64 756c tim as the modul │ │ │ │ +0002ee20: 6520 636f 6d6d 616e 6420 6c69 6e65 2e0a e command line.. │ │ │ │ +0002ee30: 0a1f 0a46 696c 653a 2067 7275 622e 696e ...File: grub.in │ │ │ │ +0002ee40: 666f 2c20 204e 6f64 653a 206d 756c 7469 fo, Node: multi │ │ │ │ +0002ee50: 626f 6f74 2c20 204e 6578 743a 206e 6174 boot, Next: nat │ │ │ │ +0002ee60: 6976 6564 6973 6b2c 2020 5072 6576 3a20 ivedisk, Prev: │ │ │ │ +0002ee70: 6d6f 6475 6c65 2c20 2055 703a 2043 6f6d module, Up: Com │ │ │ │ +0002ee80: 6d61 6e64 2d6c 696e 6520 616e 6420 6d65 mand-line and me │ │ │ │ +0002ee90: 6e75 2065 6e74 7279 2063 6f6d 6d61 6e64 nu entry command │ │ │ │ +0002eea0: 730a 0a31 362e 332e 3530 206d 756c 7469 s..16.3.50 multi │ │ │ │ +0002eeb0: 626f 6f74 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d boot.----------- │ │ │ │ +0002eec0: 2d2d 2d2d 2d2d 0a0a 202d 2d20 436f 6d6d ------.. -- Comm │ │ │ │ +0002eed0: 616e 643a 206d 756c 7469 626f 6f74 205b and: multiboot [ │ │ │ │ +0002eee0: 2d2d 7175 6972 6b2d 6261 642d 6b6c 7564 --quirk-bad-klud │ │ │ │ +0002eef0: 6765 5d0a 2020 2020 2020 2020 2020 5b2d ge]. [- │ │ │ │ +0002ef00: 2d71 7569 726b 2d6d 6f64 756c 6573 2d61 -quirk-modules-a │ │ │ │ +0002ef10: 6674 6572 2d6b 6572 6e65 6c5d 2066 696c fter-kernel] fil │ │ │ │ +0002ef20: 6520 2e2e 2e0a 2020 2020 204c 6f61 6420 e .... Load │ │ │ │ +0002ef30: 6120 6d75 6c74 6962 6f6f 7420 6b65 726e a multiboot kern │ │ │ │ +0002ef40: 656c 2069 6d61 6765 2066 726f 6d20 4649 el image from FI │ │ │ │ +0002ef50: 4c45 2e20 2054 6865 2072 6573 7420 6f66 LE. The rest of │ │ │ │ +0002ef60: 2074 6865 206c 696e 6520 6973 0a20 2020 the line is. │ │ │ │ +0002ef70: 2020 7061 7373 6564 2076 6572 6261 7469 passed verbati │ │ │ │ +0002ef80: 6d20 6173 2074 6865 2022 6b65 726e 656c m as the "kernel │ │ │ │ +0002ef90: 2063 6f6d 6d61 6e64 2d6c 696e 6522 2e20 command-line". │ │ │ │ +0002efa0: 2041 6e79 206d 6f64 756c 6520 6d75 7374 Any module must │ │ │ │ +0002efb0: 2062 650a 2020 2020 2072 656c 6f61 6465 be. reloade │ │ │ │ +0002efc0: 6420 6166 7465 7220 7573 696e 6720 7468 d after using th │ │ │ │ +0002efd0: 6973 2063 6f6d 6d61 6e64 2028 2a6e 6f74 is command (*not │ │ │ │ +0002efe0: 6520 6d6f 6475 6c65 3a3a 292e 0a0a 2020 e module::)... │ │ │ │ +0002eff0: 2020 2053 6f6d 6520 6b65 726e 656c 7320 Some kernels │ │ │ │ +0002f000: 6861 7665 206b 6e6f 776e 2070 726f 626c have known probl │ │ │ │ +0002f010: 656d 732e 2020 596f 7520 6e65 6564 2074 ems. You need t │ │ │ │ +0002f020: 6f20 7370 6563 6966 7920 2d71 7569 726b o specify -quirk │ │ │ │ +0002f030: 2d2a 2066 6f72 0a20 2020 2020 7468 6f73 -* for. thos │ │ │ │ +0002f040: 652e 2020 2d71 7569 726b 2d62 6164 2d6b e. -quirk-bad-k │ │ │ │ +0002f050: 6c75 6467 6520 6973 2061 2070 726f 626c ludge is a probl │ │ │ │ +0002f060: 656d 2073 6565 6e20 696e 2073 6576 6572 em seen in sever │ │ │ │ +0002f070: 616c 2070 726f 6475 6374 730a 2020 2020 al products. │ │ │ │ +0002f080: 2074 6861 7420 7468 6579 2069 6e63 6c75 that they inclu │ │ │ │ +0002f090: 6465 206c 6f61 6469 6e67 206b 6c75 6467 de loading kludg │ │ │ │ +0002f0a0: 6520 696e 666f 726d 6174 696f 6e20 7769 e information wi │ │ │ │ +0002f0b0: 7468 2069 6e76 616c 6964 2064 6174 6120 th invalid data │ │ │ │ +0002f0c0: 696e 0a20 2020 2020 454c 4620 6669 6c65 in. ELF file │ │ │ │ +0002f0d0: 2e20 2047 5255 4220 7072 696f 7220 746f . GRUB prior to │ │ │ │ +0002f0e0: 2030 2e39 3720 616e 6420 736f 6d65 2063 0.97 and some c │ │ │ │ +0002f0f0: 7573 746f 6d20 6275 696c 6473 2070 7265 ustom builds pre │ │ │ │ +0002f100: 6665 7265 6420 454c 460a 2020 2020 2069 fered ELF. i │ │ │ │ +0002f110: 6e66 6f72 6d61 7469 6f6e 2077 6869 6c65 nformation while │ │ │ │ +0002f120: 2030 2e39 3720 616e 6420 4752 5542 2032 0.97 and GRUB 2 │ │ │ │ +0002f130: 2075 7365 206b 6c75 6467 652e 2020 5573 use kludge. Us │ │ │ │ +0002f140: 6520 7468 6973 206f 7074 696f 6e20 746f e this option to │ │ │ │ +0002f150: 0a20 2020 2020 6967 6e6f 7265 206b 6c75 . ignore klu │ │ │ │ +0002f160: 6467 652e 2020 4b6e 6f77 6e20 6166 6665 dge. Known affe │ │ │ │ +0002f170: 6374 6564 2073 7973 7465 6d73 3a20 6f6c cted systems: ol │ │ │ │ +0002f180: 6420 536f 6c61 7269 732c 2053 6b79 4f53 d Solaris, SkyOS │ │ │ │ +0002f190: 2e0a 0a20 2020 2020 2d71 7569 726b 2d6d ... -quirk-m │ │ │ │ +0002f1a0: 6f64 756c 6573 2d61 6674 6572 2d6b 6572 odules-after-ker │ │ │ │ +0002f1b0: 6e65 6c20 6973 206e 6565 6465 6420 666f nel is needed fo │ │ │ │ +0002f1c0: 7220 6b65 726e 656c 7320 7768 6963 6820 r kernels which │ │ │ │ +0002f1d0: 6c6f 6164 2061 740a 2020 2020 2072 656c load at. rel │ │ │ │ +0002f1e0: 6174 6976 656c 7920 6869 6768 2061 6464 atively high add │ │ │ │ +0002f1f0: 7265 7373 2065 2e67 2e20 2031 364d 6942 ress e.g. 16MiB │ │ │ │ +0002f200: 206d 6172 6b20 616e 6420 6361 6e27 7420 mark and can't │ │ │ │ +0002f210: 636f 7065 2077 6974 680a 2020 2020 206d cope with. m │ │ │ │ +0002f220: 6f64 756c 6573 2073 7475 6666 6564 2062 odules stuffed b │ │ │ │ +0002f230: 6574 7765 656e 2031 4d69 4220 6d61 726b etween 1MiB mark │ │ │ │ +0002f240: 2061 6e64 2062 6567 696e 6e69 6e67 206f and beginning o │ │ │ │ +0002f250: 6620 7468 6520 6b65 726e 656c 2e0a 2020 f the kernel.. │ │ │ │ +0002f260: 2020 204b 6e6f 776e 2061 6666 7465 6374 Known afftect │ │ │ │ +0002f270: 6564 2073 7973 7465 6d73 3a20 564d 5761 ed systems: VMWa │ │ │ │ +0002f280: 7265 2e0a 0a1f 0a46 696c 653a 2067 7275 re.....File: gru │ │ │ │ +0002f290: 622e 696e 666f 2c20 204e 6f64 653a 206e b.info, Node: n │ │ │ │ +0002f2a0: 6174 6976 6564 6973 6b2c 2020 4e65 7874 ativedisk, Next │ │ │ │ +0002f2b0: 3a20 6e6f 726d 616c 2c20 2050 7265 763a : normal, Prev: │ │ │ │ +0002f2c0: 206d 756c 7469 626f 6f74 2c20 2055 703a multiboot, Up: │ │ │ │ +0002f2d0: 2043 6f6d 6d61 6e64 2d6c 696e 6520 616e Command-line an │ │ │ │ +0002f2e0: 6420 6d65 6e75 2065 6e74 7279 2063 6f6d d menu entry com │ │ │ │ +0002f2f0: 6d61 6e64 730a 0a31 362e 332e 3531 206e mands..16.3.51 n │ │ │ │ +0002f300: 6174 6976 6564 6973 6b0a 2d2d 2d2d 2d2d ativedisk.------ │ │ │ │ +0002f310: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d ------------.. - │ │ │ │ +0002f320: 2d20 436f 6d6d 616e 643a 206e 6174 6976 - Command: nativ │ │ │ │ +0002f330: 6564 6973 6b0a 2020 2020 2053 7769 7463 edisk. Switc │ │ │ │ +0002f340: 6820 6672 6f6d 2066 6972 6d77 6172 6520 h from firmware │ │ │ │ +0002f350: 6469 736b 2064 7269 7665 7273 2074 6f20 disk drivers to │ │ │ │ +0002f360: 6e61 7469 7665 206f 6e65 732e 2020 5265 native ones. Re │ │ │ │ +0002f370: 616c 6c79 2075 7365 6675 6c0a 2020 2020 ally useful. │ │ │ │ +0002f380: 206f 6e6c 7920 6f6e 2070 6c61 7466 6f72 only on platfor │ │ │ │ +0002f390: 6d73 2077 6865 7265 2062 6f74 6820 6669 ms where both fi │ │ │ │ +0002f3a0: 726d 7761 7265 2061 6e64 206e 6174 6976 rmware and nativ │ │ │ │ +0002f3b0: 6520 6469 736b 2064 7269 7665 7320 6172 e disk drives ar │ │ │ │ +0002f3c0: 650a 2020 2020 2061 7661 696c 6162 6c65 e. available │ │ │ │ +0002f3d0: 2e20 2043 7572 7265 6e74 6c79 2069 3338 . Currently i38 │ │ │ │ +0002f3e0: 362d 7063 2c20 6933 3836 2d65 6669 2c20 6-pc, i386-efi, │ │ │ │ +0002f3f0: 6933 3836 2d69 6565 6531 3237 3520 616e i386-ieee1275 an │ │ │ │ +0002f400: 640a 2020 2020 2078 3836 5f36 342d 6566 d. x86_64-ef │ │ │ │ +0002f410: 692e 0a0a 1f0a 4669 6c65 3a20 6772 7562 i.....File: grub │ │ │ │ +0002f420: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 6e6f .info, Node: no │ │ │ │ +0002f430: 726d 616c 2c20 204e 6578 743a 206e 6f72 rmal, Next: nor │ │ │ │ +0002f440: 6d61 6c5f 6578 6974 2c20 2050 7265 763a mal_exit, Prev: │ │ │ │ +0002f450: 206e 6174 6976 6564 6973 6b2c 2020 5570 nativedisk, Up │ │ │ │ +0002f460: 3a20 436f 6d6d 616e 642d 6c69 6e65 2061 : Command-line a │ │ │ │ +0002f470: 6e64 206d 656e 7520 656e 7472 7920 636f nd menu entry co │ │ │ │ +0002f480: 6d6d 616e 6473 0a0a 3136 2e33 2e35 3220 mmands..16.3.52 │ │ │ │ +0002f490: 6e6f 726d 616c 0a2d 2d2d 2d2d 2d2d 2d2d normal.--------- │ │ │ │ +0002f4a0: 2d2d 2d2d 2d0a 0a20 2d2d 2043 6f6d 6d61 -----.. -- Comma │ │ │ │ +0002f4b0: 6e64 3a20 6e6f 726d 616c 205b 6669 6c65 nd: normal [file │ │ │ │ +0002f4c0: 5d0a 2020 2020 2045 6e74 6572 206e 6f72 ]. Enter nor │ │ │ │ +0002f4d0: 6d61 6c20 6d6f 6465 2061 6e64 2064 6973 mal mode and dis │ │ │ │ +0002f4e0: 706c 6179 2074 6865 2047 5255 4220 6d65 play the GRUB me │ │ │ │ +0002f4f0: 6e75 2e0a 0a20 2020 2020 496e 206e 6f72 nu... In nor │ │ │ │ +0002f500: 6d61 6c20 6d6f 6465 2c20 636f 6d6d 616e mal mode, comman │ │ │ │ +0002f510: 6473 2c20 6669 6c65 7379 7374 656d 206d ds, filesystem m │ │ │ │ +0002f520: 6f64 756c 6573 2c20 616e 6420 6372 7970 odules, and cryp │ │ │ │ +0002f530: 746f 6772 6170 6879 0a20 2020 2020 6d6f tography. mo │ │ │ │ +0002f540: 6475 6c65 7320 6172 6520 6175 746f 6d61 dules are automa │ │ │ │ +0002f550: 7469 6361 6c6c 7920 6c6f 6164 6564 2c20 tically loaded, │ │ │ │ +0002f560: 616e 6420 7468 6520 6675 6c6c 2047 5255 and the full GRU │ │ │ │ +0002f570: 4220 7363 7269 7074 2070 6172 7365 720a B script parser. │ │ │ │ +0002f580: 2020 2020 2069 7320 6176 6169 6c61 626c is availabl │ │ │ │ +0002f590: 652e 2020 4f74 6865 7220 6d6f 6475 6c65 e. Other module │ │ │ │ +0002f5a0: 7320 6d61 7920 6265 2065 7870 6c69 6369 s may be explici │ │ │ │ +0002f5b0: 746c 7920 6c6f 6164 6564 2075 7369 6e67 tly loaded using │ │ │ │ +0002f5c0: 0a20 2020 2020 2769 6e73 6d6f 6427 2028 . 'insmod' ( │ │ │ │ +0002f5d0: 2a6e 6f74 6520 696e 736d 6f64 3a3a 292e *note insmod::). │ │ │ │ +0002f5e0: 0a0a 2020 2020 2049 6620 6120 4649 4c45 .. If a FILE │ │ │ │ +0002f5f0: 2069 7320 6769 7665 6e2c 2074 6865 6e20 is given, then │ │ │ │ +0002f600: 636f 6d6d 616e 6473 2077 696c 6c20 6265 commands will be │ │ │ │ +0002f610: 2072 6561 6420 6672 6f6d 2074 6861 7420 read from that │ │ │ │ +0002f620: 6669 6c65 2e0a 2020 2020 204f 7468 6572 file.. Other │ │ │ │ +0002f630: 7769 7365 2c20 7468 6579 2077 696c 6c20 wise, they will │ │ │ │ +0002f640: 6265 2072 6561 6420 6672 6f6d 2027 2470 be read from '$p │ │ │ │ +0002f650: 7265 6669 782f 6772 7562 2e63 6667 2720 refix/grub.cfg' │ │ │ │ +0002f660: 6966 2069 7420 6578 6973 7473 2e0a 0a20 if it exists... │ │ │ │ +0002f670: 2020 2020 276e 6f72 6d61 6c27 206d 6179 'normal' may │ │ │ │ +0002f680: 2062 6520 6361 6c6c 6564 2066 726f 6d20 be called from │ │ │ │ +0002f690: 7769 7468 696e 206e 6f72 6d61 6c20 6d6f within normal mo │ │ │ │ +0002f6a0: 6465 2c20 6372 6561 7469 6e67 2061 206e de, creating a n │ │ │ │ +0002f6b0: 6573 7465 640a 2020 2020 2065 6e76 6972 ested. envir │ │ │ │ +0002f6c0: 6f6e 6d65 6e74 2e20 2049 7420 6973 206d onment. It is m │ │ │ │ +0002f6d0: 6f72 6520 7573 7561 6c20 746f 2075 7365 ore usual to use │ │ │ │ +0002f6e0: 2027 636f 6e66 6967 6669 6c65 2720 282a 'configfile' (* │ │ │ │ +0002f6f0: 6e6f 7465 0a20 2020 2020 636f 6e66 6967 note. config │ │ │ │ +0002f700: 6669 6c65 3a3a 2920 666f 7220 7468 6973 file::) for this │ │ │ │ +0002f710: 2e0a 0a1f 0a46 696c 653a 2067 7275 622e .....File: grub. │ │ │ │ +0002f720: 696e 666f 2c20 204e 6f64 653a 206e 6f72 info, Node: nor │ │ │ │ +0002f730: 6d61 6c5f 6578 6974 2c20 204e 6578 743a mal_exit, Next: │ │ │ │ +0002f740: 2070 6172 7474 6f6f 6c2c 2020 5072 6576 parttool, Prev │ │ │ │ +0002f750: 3a20 6e6f 726d 616c 2c20 2055 703a 2043 : normal, Up: C │ │ │ │ +0002f760: 6f6d 6d61 6e64 2d6c 696e 6520 616e 6420 ommand-line and │ │ │ │ +0002f770: 6d65 6e75 2065 6e74 7279 2063 6f6d 6d61 menu entry comma │ │ │ │ +0002f780: 6e64 730a 0a31 362e 332e 3533 206e 6f72 nds..16.3.53 nor │ │ │ │ +0002f790: 6d61 6c5f 6578 6974 0a2d 2d2d 2d2d 2d2d mal_exit.------- │ │ │ │ +0002f7a0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d ------------.. - │ │ │ │ +0002f7b0: 2d20 436f 6d6d 616e 643a 206e 6f72 6d61 - Command: norma │ │ │ │ +0002f7c0: 6c5f 6578 6974 0a20 2020 2020 4578 6974 l_exit. Exit │ │ │ │ +0002f7d0: 206e 6f72 6d61 6c20 6d6f 6465 2028 2a6e normal mode (*n │ │ │ │ +0002f7e0: 6f74 6520 6e6f 726d 616c 3a3a 292e 2020 ote normal::). │ │ │ │ +0002f7f0: 4966 2074 6869 7320 696e 7374 616e 6365 If this instance │ │ │ │ +0002f800: 206f 6620 6e6f 726d 616c 206d 6f64 650a of normal mode. │ │ │ │ +0002f810: 2020 2020 2077 6173 206e 6f74 206e 6573 was not nes │ │ │ │ +0002f820: 7465 6420 7769 7468 696e 2061 6e6f 7468 ted within anoth │ │ │ │ +0002f830: 6572 206f 6e65 2c20 7468 656e 2072 6574 er one, then ret │ │ │ │ +0002f840: 7572 6e20 746f 2072 6573 6375 6520 6d6f urn to rescue mo │ │ │ │ +0002f850: 6465 2e0a 0a1f 0a46 696c 653a 2067 7275 de.....File: gru │ │ │ │ +0002f860: 622e 696e 666f 2c20 204e 6f64 653a 2070 b.info, Node: p │ │ │ │ +0002f870: 6172 7474 6f6f 6c2c 2020 4e65 7874 3a20 arttool, Next: │ │ │ │ +0002f880: 7061 7373 776f 7264 2c20 2050 7265 763a password, Prev: │ │ │ │ +0002f890: 206e 6f72 6d61 6c5f 6578 6974 2c20 2055 normal_exit, U │ │ │ │ +0002f8a0: 703a 2043 6f6d 6d61 6e64 2d6c 696e 6520 p: Command-line │ │ │ │ +0002f8b0: 616e 6420 6d65 6e75 2065 6e74 7279 2063 and menu entry c │ │ │ │ +0002f8c0: 6f6d 6d61 6e64 730a 0a31 362e 332e 3534 ommands..16.3.54 │ │ │ │ +0002f8d0: 2070 6172 7474 6f6f 6c0a 2d2d 2d2d 2d2d parttool.------ │ │ │ │ +0002f8e0: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 ----------.. -- │ │ │ │ +0002f8f0: 436f 6d6d 616e 643a 2070 6172 7474 6f6f Command: parttoo │ │ │ │ +0002f900: 6c20 7061 7274 6974 696f 6e20 636f 6d6d l partition comm │ │ │ │ +0002f910: 616e 6473 0a20 2020 2020 4d61 6b65 2076 ands. Make v │ │ │ │ +0002f920: 6172 696f 7573 206d 6f64 6966 6963 6174 arious modificat │ │ │ │ +0002f930: 696f 6e73 2074 6f20 7061 7274 6974 696f ions to partitio │ │ │ │ +0002f940: 6e20 7461 626c 6520 656e 7472 6965 732e n table entries. │ │ │ │ +0002f950: 0a0a 2020 2020 2045 6163 6820 434f 4d4d .. Each COMM │ │ │ │ +0002f960: 414e 4420 6973 2065 6974 6865 7220 6120 AND is either a │ │ │ │ +0002f970: 626f 6f6c 6561 6e20 6f70 7469 6f6e 2c20 boolean option, │ │ │ │ +0002f980: 696e 2077 6869 6368 2063 6173 6520 6974 in which case it │ │ │ │ +0002f990: 206d 7573 7420 6265 0a20 2020 2020 666f must be. fo │ │ │ │ +0002f9a0: 6c6c 6f77 6564 2077 6974 6820 272b 2720 llowed with '+' │ │ │ │ +0002f9b0: 6f72 2027 2d27 2028 7769 7468 206e 6f20 or '-' (with no │ │ │ │ +0002f9c0: 696e 7465 7276 656e 696e 6720 7370 6163 intervening spac │ │ │ │ +0002f9d0: 6529 2074 6f20 656e 6162 6c65 206f 720a e) to enable or. │ │ │ │ +0002f9e0: 2020 2020 2064 6973 6162 6c65 2074 6861 disable tha │ │ │ │ +0002f9f0: 7420 6f70 7469 6f6e 2c20 6f72 2065 6c73 t option, or els │ │ │ │ +0002fa00: 6520 6974 2074 616b 6573 2061 2076 616c e it takes a val │ │ │ │ +0002fa10: 7565 2069 6e20 7468 6520 666f 726d 0a20 ue in the form. │ │ │ │ +0002fa20: 2020 2020 2743 4f4d 4d41 4e44 3d56 414c 'COMMAND=VAL │ │ │ │ +0002fa30: 5545 272e 0a0a 2020 2020 2043 7572 7265 UE'... Curre │ │ │ │ +0002fa40: 6e74 6c79 2c20 2770 6172 7474 6f6f 6c27 ntly, 'parttool' │ │ │ │ +0002fa50: 2069 7320 6f6e 6c79 2075 7365 6675 6c20 is only useful │ │ │ │ +0002fa60: 6f6e 2044 4f53 2070 6172 7469 7469 6f6e on DOS partition │ │ │ │ +0002fa70: 2074 6162 6c65 7320 2861 6c73 6f0a 2020 tables (also. │ │ │ │ +0002fa80: 2020 206b 6e6f 776e 2061 7320 4d61 7374 known as Mast │ │ │ │ +0002fa90: 6572 2042 6f6f 7420 5265 636f 7264 2c20 er Boot Record, │ │ │ │ +0002faa0: 6f72 204d 4252 292e 204f 6e20 7468 6573 or MBR). On thes │ │ │ │ +0002fab0: 6520 7061 7274 6974 696f 6e20 7461 626c e partition tabl │ │ │ │ +0002fac0: 6573 2c0a 2020 2020 2074 6865 2066 6f6c es,. the fol │ │ │ │ +0002fad0: 6c6f 7769 6e67 2063 6f6d 6d61 6e64 7320 lowing commands │ │ │ │ +0002fae0: 6172 6520 6176 6169 6c61 626c 653a 0a0a are available:.. │ │ │ │ +0002faf0: 2020 2020 2027 626f 6f74 2720 2862 6f6f 'boot' (boo │ │ │ │ +0002fb00: 6c65 616e 290a 2020 2020 2020 2020 2020 lean). │ │ │ │ +0002fb10: 5768 656e 2065 6e61 626c 6564 2c20 7468 When enabled, th │ │ │ │ +0002fb20: 6973 206d 616b 6573 2074 6865 2073 656c is makes the sel │ │ │ │ +0002fb30: 6563 7465 6420 7061 7274 6974 696f 6e20 ected partition │ │ │ │ +0002fb40: 6265 2074 6865 2061 6374 6976 650a 2020 be the active. │ │ │ │ +0002fb50: 2020 2020 2020 2020 2862 6f6f 7461 626c (bootabl │ │ │ │ +0002fb60: 6529 2070 6172 7469 7469 6f6e 206f 6e20 e) partition on │ │ │ │ +0002fb70: 6974 7320 6469 736b 2c20 636c 6561 7269 its disk, cleari │ │ │ │ +0002fb80: 6e67 2074 6865 2061 6374 6976 6520 666c ng the active fl │ │ │ │ +0002fb90: 6167 206f 6e0a 2020 2020 2020 2020 2020 ag on. │ │ │ │ +0002fba0: 616c 6c20 6f74 6865 7220 7061 7274 6974 all other partit │ │ │ │ +0002fbb0: 696f 6e73 2e20 2054 6869 7320 636f 6d6d ions. This comm │ │ │ │ +0002fbc0: 616e 6420 6973 206c 696d 6974 6564 2074 and is limited t │ │ │ │ +0002fbd0: 6f20 5f70 7269 6d61 7279 5f0a 2020 2020 o _primary_. │ │ │ │ +0002fbe0: 2020 2020 2020 7061 7274 6974 696f 6e73 partitions │ │ │ │ +0002fbf0: 2e0a 0a20 2020 2020 2774 7970 6527 2028 ... 'type' ( │ │ │ │ +0002fc00: 7661 6c75 6529 0a20 2020 2020 2020 2020 value). │ │ │ │ +0002fc10: 2043 6861 6e67 6520 7468 6520 7479 7065 Change the type │ │ │ │ +0002fc20: 206f 6620 616e 2065 7869 7374 696e 6720 of an existing │ │ │ │ +0002fc30: 7061 7274 6974 696f 6e2e 2020 5468 6520 partition. The │ │ │ │ +0002fc40: 7661 6c75 6520 6d75 7374 2062 6520 610a value must be a. │ │ │ │ +0002fc50: 2020 2020 2020 2020 2020 6e75 6d62 6572 number │ │ │ │ +0002fc60: 2069 6e20 7468 6520 7261 6e67 6520 302d in the range 0- │ │ │ │ +0002fc70: 3078 4646 2028 7072 6566 6978 2077 6974 0xFF (prefix wit │ │ │ │ +0002fc80: 6820 2730 7827 2074 6f20 656e 7465 7220 h '0x' to enter │ │ │ │ +0002fc90: 6974 2069 6e0a 2020 2020 2020 2020 2020 it in. │ │ │ │ +0002fca0: 6865 7861 6465 6369 6d61 6c29 2e0a 0a20 hexadecimal)... │ │ │ │ +0002fcb0: 2020 2020 2768 6964 6465 6e27 2028 626f 'hidden' (bo │ │ │ │ +0002fcc0: 6f6c 6561 6e29 0a20 2020 2020 2020 2020 olean). │ │ │ │ +0002fcd0: 2057 6865 6e20 656e 6162 6c65 642c 2074 When enabled, t │ │ │ │ +0002fce0: 6869 7320 6869 6465 7320 7468 6520 7365 his hides the se │ │ │ │ +0002fcf0: 6c65 6374 6564 2070 6172 7469 7469 6f6e lected partition │ │ │ │ +0002fd00: 2062 7920 7365 7474 696e 6720 7468 650a by setting the. │ │ │ │ +0002fd10: 2020 2020 2020 2020 2020 2268 6964 6465 "hidde │ │ │ │ +0002fd20: 6e22 2062 6974 2069 6e20 6974 7320 7061 n" bit in its pa │ │ │ │ +0002fd30: 7274 6974 696f 6e20 7479 7065 2063 6f64 rtition type cod │ │ │ │ +0002fd40: 653b 2077 6865 6e20 6469 7361 626c 6564 e; when disabled │ │ │ │ +0002fd50: 2c0a 2020 2020 2020 2020 2020 756e 6869 ,. unhi │ │ │ │ +0002fd60: 6465 7320 7468 6520 7365 6c65 6374 6564 des the selected │ │ │ │ +0002fd70: 2070 6172 7469 7469 6f6e 2062 7920 636c partition by cl │ │ │ │ +0002fd80: 6561 7269 6e67 2074 6869 7320 6269 742e earing this bit. │ │ │ │ +0002fd90: 2020 5468 6973 2069 730a 2020 2020 2020 This is. │ │ │ │ +0002fda0: 2020 2020 7573 6566 756c 206f 6e6c 7920 useful only │ │ │ │ +0002fdb0: 7768 656e 2062 6f6f 7469 6e67 2044 4f53 when booting DOS │ │ │ │ +0002fdc0: 206f 7220 5769 6e64 6f77 7320 616e 6420 or Windows and │ │ │ │ +0002fdd0: 6d75 6c74 6970 6c65 2070 7269 6d61 7279 multiple primary │ │ │ │ +0002fde0: 0a20 2020 2020 2020 2020 2046 4154 2070 . FAT p │ │ │ │ +0002fdf0: 6172 7469 7469 6f6e 7320 6578 6973 7420 artitions exist │ │ │ │ +0002fe00: 696e 206f 6e65 2064 6973 6b2e 2020 5365 in one disk. Se │ │ │ │ +0002fe10: 6520 616c 736f 202a 6e6f 7465 0a20 2020 e also *note. │ │ │ │ +0002fe20: 2020 2020 2020 2044 4f53 2f57 696e 646f DOS/Windo │ │ │ │ +0002fe30: 7773 3a3a 2e0a 0a1f 0a46 696c 653a 2067 ws::.....File: g │ │ │ │ +0002fe40: 7275 622e 696e 666f 2c20 204e 6f64 653a rub.info, Node: │ │ │ │ +0002fe50: 2070 6173 7377 6f72 642c 2020 4e65 7874 password, Next │ │ │ │ +0002fe60: 3a20 7061 7373 776f 7264 5f70 626b 6466 : password_pbkdf │ │ │ │ +0002fe70: 322c 2020 5072 6576 3a20 7061 7274 746f 2, Prev: partto │ │ │ │ +0002fe80: 6f6c 2c20 2055 703a 2043 6f6d 6d61 6e64 ol, Up: Command │ │ │ │ +0002fe90: 2d6c 696e 6520 616e 6420 6d65 6e75 2065 -line and menu e │ │ │ │ +0002fea0: 6e74 7279 2063 6f6d 6d61 6e64 730a 0a31 ntry commands..1 │ │ │ │ +0002feb0: 362e 332e 3535 2070 6173 7377 6f72 640a 6.3.55 password. │ │ │ │ +0002fec0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ +0002fed0: 0a0a 202d 2d20 436f 6d6d 616e 643a 2070 .. -- Command: p │ │ │ │ +0002fee0: 6173 7377 6f72 6420 7573 6572 2063 6c65 assword user cle │ │ │ │ +0002fef0: 6172 2d70 6173 7377 6f72 640a 2020 2020 ar-password. │ │ │ │ +0002ff00: 2044 6566 696e 6520 6120 7573 6572 206e Define a user n │ │ │ │ +0002ff10: 616d 6564 2055 5345 5220 7769 7468 2070 amed USER with p │ │ │ │ +0002ff20: 6173 7377 6f72 6420 434c 4541 522d 5041 assword CLEAR-PA │ │ │ │ +0002ff30: 5353 574f 5244 2e20 202a 4e6f 7465 0a20 SSWORD. *Note. │ │ │ │ +0002ff40: 2020 2020 5365 6375 7269 7479 3a3a 2e0a Security::.. │ │ │ │ +0002ff50: 0a1f 0a46 696c 653a 2067 7275 622e 696e ...File: grub.in │ │ │ │ +0002ff60: 666f 2c20 204e 6f64 653a 2070 6173 7377 fo, Node: passw │ │ │ │ +0002ff70: 6f72 645f 7062 6b64 6632 2c20 204e 6578 ord_pbkdf2, Nex │ │ │ │ +0002ff80: 743a 2070 6c61 792c 2020 5072 6576 3a20 t: play, Prev: │ │ │ │ +0002ff90: 7061 7373 776f 7264 2c20 2055 703a 2043 password, Up: C │ │ │ │ +0002ffa0: 6f6d 6d61 6e64 2d6c 696e 6520 616e 6420 ommand-line and │ │ │ │ +0002ffb0: 6d65 6e75 2065 6e74 7279 2063 6f6d 6d61 menu entry comma │ │ │ │ +0002ffc0: 6e64 730a 0a31 362e 332e 3536 2070 6173 nds..16.3.56 pas │ │ │ │ +0002ffd0: 7377 6f72 645f 7062 6b64 6632 0a2d 2d2d sword_pbkdf2.--- │ │ │ │ 0002ffe0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ -0002fff0: 0a0a 202d 2d20 436f 6d6d 616e 643a 2070 .. -- Command: p │ │ │ │ -00030000: 6173 7377 6f72 645f 7062 6b64 6632 2075 assword_pbkdf2 u │ │ │ │ -00030010: 7365 7220 6861 7368 6564 2d70 6173 7377 ser hashed-passw │ │ │ │ -00030020: 6f72 640a 2020 2020 2044 6566 696e 6520 ord. Define │ │ │ │ -00030030: 6120 7573 6572 206e 616d 6564 2055 5345 a user named USE │ │ │ │ -00030040: 5220 7769 7468 2070 6173 7377 6f72 6420 R with password │ │ │ │ -00030050: 6861 7368 2048 4153 4845 442d 5041 5353 hash HASHED-PASS │ │ │ │ -00030060: 574f 5244 2e20 2055 7365 0a20 2020 2020 WORD. Use. │ │ │ │ -00030070: 2767 7275 622d 6d6b 7061 7373 7764 2d70 'grub-mkpasswd-p │ │ │ │ -00030080: 626b 6466 3227 2028 2a6e 6f74 6520 496e bkdf2' (*note In │ │ │ │ -00030090: 766f 6b69 6e67 2067 7275 622d 6d6b 7061 voking grub-mkpa │ │ │ │ -000300a0: 7373 7764 2d70 626b 6466 323a 3a29 2074 sswd-pbkdf2::) t │ │ │ │ -000300b0: 6f0a 2020 2020 2067 656e 6572 6174 6520 o. generate │ │ │ │ -000300c0: 7061 7373 776f 7264 2068 6173 6865 732e password hashes. │ │ │ │ -000300d0: 2020 2a4e 6f74 6520 5365 6375 7269 7479 *Note Security │ │ │ │ -000300e0: 3a3a 2e0a 0a1f 0a46 696c 653a 2067 7275 ::.....File: gru │ │ │ │ -000300f0: 622e 696e 666f 2c20 204e 6f64 653a 2070 b.info, Node: p │ │ │ │ -00030100: 6c61 792c 2020 4e65 7874 3a20 7072 6f62 lay, Next: prob │ │ │ │ -00030110: 652c 2020 5072 6576 3a20 7061 7373 776f e, Prev: passwo │ │ │ │ -00030120: 7264 5f70 626b 6466 322c 2020 5570 3a20 rd_pbkdf2, Up: │ │ │ │ -00030130: 436f 6d6d 616e 642d 6c69 6e65 2061 6e64 Command-line and │ │ │ │ -00030140: 206d 656e 7520 656e 7472 7920 636f 6d6d menu entry comm │ │ │ │ -00030150: 616e 6473 0a0a 3136 2e33 2e35 3720 706c ands..16.3.57 pl │ │ │ │ -00030160: 6179 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a ay.------------. │ │ │ │ -00030170: 0a20 2d2d 2043 6f6d 6d61 6e64 3a20 706c . -- Command: pl │ │ │ │ -00030180: 6179 2066 696c 6520 7c20 7465 6d70 6f20 ay file | tempo │ │ │ │ -00030190: 5b70 6974 6368 3120 6475 7261 7469 6f6e [pitch1 duration │ │ │ │ -000301a0: 315d 205b 7069 7463 6832 2064 7572 6174 1] [pitch2 durat │ │ │ │ -000301b0: 696f 6e32 5d20 2e2e 2e0a 2020 2020 2050 ion2] .... P │ │ │ │ -000301c0: 6c61 7973 2061 2074 756e 650a 0a20 2020 lays a tune.. │ │ │ │ -000301d0: 2020 4966 2074 6865 2061 7267 756d 656e If the argumen │ │ │ │ -000301e0: 7420 6973 2061 2066 696c 6520 6e61 6d65 t is a file name │ │ │ │ -000301f0: 2028 2a6e 6f74 6520 4669 6c65 206e 616d (*note File nam │ │ │ │ -00030200: 6520 7379 6e74 6178 3a3a 292c 2070 6c61 e syntax::), pla │ │ │ │ -00030210: 7920 7468 650a 2020 2020 2074 756e 6520 y the. tune │ │ │ │ -00030220: 7265 636f 7264 6564 2069 6e20 6974 2e20 recorded in it. │ │ │ │ -00030230: 2054 6865 2066 696c 6520 666f 726d 6174 The file format │ │ │ │ -00030240: 2069 7320 6669 7273 7420 7468 6520 7465 is first the te │ │ │ │ -00030250: 6d70 6f20 6173 2061 6e0a 2020 2020 2075 mpo as an. u │ │ │ │ -00030260: 6e73 6967 6e65 6420 3332 6269 7420 6c69 nsigned 32bit li │ │ │ │ -00030270: 7474 6c65 2d65 6e64 6961 6e20 6e75 6d62 ttle-endian numb │ │ │ │ -00030280: 6572 2c20 7468 656e 2070 6169 7273 206f er, then pairs o │ │ │ │ -00030290: 6620 756e 7369 676e 6564 2031 3662 6974 f unsigned 16bit │ │ │ │ -000302a0: 0a20 2020 2020 6c69 7474 6c65 2d65 6e64 . little-end │ │ │ │ -000302b0: 6961 6e20 6e75 6d62 6572 7320 666f 7220 ian numbers for │ │ │ │ -000302c0: 7069 7463 6820 616e 6420 6475 7261 7469 pitch and durati │ │ │ │ -000302d0: 6f6e 2070 6169 7273 2e0a 0a20 2020 2020 on pairs... │ │ │ │ -000302e0: 4966 2074 6865 2061 7267 756d 656e 7473 If the arguments │ │ │ │ -000302f0: 2061 7265 2061 2073 6572 6965 7320 6f66 are a series of │ │ │ │ -00030300: 206e 756d 6265 7273 2c20 706c 6179 2074 numbers, play t │ │ │ │ -00030310: 6865 2069 6e6c 696e 6520 7475 6e65 2e0a he inline tune.. │ │ │ │ -00030320: 0a20 2020 2020 5468 6520 7465 6d70 6f20 . The tempo │ │ │ │ -00030330: 6973 2074 6865 2062 6173 6520 666f 7220 is the base for │ │ │ │ -00030340: 616c 6c20 6e6f 7465 2064 7572 6174 696f all note duratio │ │ │ │ -00030350: 6e73 2e20 2036 3020 6769 7665 7320 6120 ns. 60 gives a │ │ │ │ -00030360: 312d 7365 636f 6e64 0a20 2020 2020 6261 1-second. ba │ │ │ │ -00030370: 7365 2c20 3132 3020 6769 7665 7320 6120 se, 120 gives a │ │ │ │ -00030380: 6861 6c66 2d73 6563 6f6e 6420 6261 7365 half-second base │ │ │ │ -00030390: 2c20 6574 632e 2020 5069 7463 6865 7320 , etc. Pitches │ │ │ │ -000303a0: 6172 6520 487a 2e20 2053 6574 0a20 2020 are Hz. Set. │ │ │ │ -000303b0: 2020 7069 7463 6820 746f 2030 2074 6f20 pitch to 0 to │ │ │ │ -000303c0: 7072 6f64 7563 6520 6120 7265 7374 2e0a produce a rest.. │ │ │ │ -000303d0: 0a1f 0a46 696c 653a 2067 7275 622e 696e ...File: grub.in │ │ │ │ -000303e0: 666f 2c20 204e 6f64 653a 2070 726f 6265 fo, Node: probe │ │ │ │ -000303f0: 2c20 204e 6578 743a 2070 7865 5f75 6e6c , Next: pxe_unl │ │ │ │ -00030400: 6f61 642c 2020 5072 6576 3a20 706c 6179 oad, Prev: play │ │ │ │ -00030410: 2c20 2055 703a 2043 6f6d 6d61 6e64 2d6c , Up: Command-l │ │ │ │ -00030420: 696e 6520 616e 6420 6d65 6e75 2065 6e74 ine and menu ent │ │ │ │ -00030430: 7279 2063 6f6d 6d61 6e64 730a 0a31 362e ry commands..16. │ │ │ │ -00030440: 332e 3538 2070 726f 6265 0a2d 2d2d 2d2d 3.58 probe.----- │ │ │ │ -00030450: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 436f --------.. -- Co │ │ │ │ -00030460: 6d6d 616e 643a 2070 726f 6265 205b 272d mmand: probe ['- │ │ │ │ -00030470: 2d73 6574 2720 7661 725d 0a20 2020 2020 -set' var]. │ │ │ │ -00030480: 2020 2020 2027 2d2d 6472 6976 6572 277c '--driver'| │ │ │ │ -00030490: 272d 2d70 6172 746d 6170 277c 272d 2d66 '--partmap'|'--f │ │ │ │ -000304a0: 7327 7c27 2d2d 6673 2d75 7569 6427 7c27 s'|'--fs-uuid'|' │ │ │ │ -000304b0: 2d2d 6c61 6265 6c27 2064 6576 6963 650a --label' device. │ │ │ │ -000304c0: 2020 2020 2052 6574 7269 6576 6520 6465 Retrieve de │ │ │ │ -000304d0: 7669 6365 2069 6e66 6f72 6d61 7469 6f6e vice information │ │ │ │ -000304e0: 2e20 2049 6620 6f70 7469 6f6e 2027 2d2d . If option '-- │ │ │ │ -000304f0: 7365 7427 2069 7320 6769 7665 6e2c 2061 set' is given, a │ │ │ │ -00030500: 7373 6967 6e0a 2020 2020 2072 6573 756c ssign. resul │ │ │ │ -00030510: 7420 746f 2076 6172 6961 626c 6520 5641 t to variable VA │ │ │ │ -00030520: 522c 206f 7468 6572 7769 7365 2070 7269 R, otherwise pri │ │ │ │ -00030530: 6e74 2069 6e66 6f72 6d61 7469 6f6e 206f nt information o │ │ │ │ -00030540: 6e20 7468 6520 7363 7265 656e 2e0a 0a1f n the screen.... │ │ │ │ -00030550: 0a46 696c 653a 2067 7275 622e 696e 666f .File: grub.info │ │ │ │ -00030560: 2c20 204e 6f64 653a 2070 7865 5f75 6e6c , Node: pxe_unl │ │ │ │ -00030570: 6f61 642c 2020 4e65 7874 3a20 7264 6d73 oad, Next: rdms │ │ │ │ -00030580: 722c 2020 5072 6576 3a20 7072 6f62 652c r, Prev: probe, │ │ │ │ -00030590: 2020 5570 3a20 436f 6d6d 616e 642d 6c69 Up: Command-li │ │ │ │ -000305a0: 6e65 2061 6e64 206d 656e 7520 656e 7472 ne and menu entr │ │ │ │ -000305b0: 7920 636f 6d6d 616e 6473 0a0a 3136 2e33 y commands..16.3 │ │ │ │ -000305c0: 2e35 3920 7078 655f 756e 6c6f 6164 0a2d .59 pxe_unload.- │ │ │ │ -000305d0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ -000305e0: 2d0a 0a20 2d2d 2043 6f6d 6d61 6e64 3a20 -.. -- Command: │ │ │ │ -000305f0: 7078 655f 756e 6c6f 6164 0a20 2020 2020 pxe_unload. │ │ │ │ -00030600: 556e 6c6f 6164 2074 6865 2050 5845 2065 Unload the PXE e │ │ │ │ -00030610: 6e76 6972 6f6e 6d65 6e74 2028 2a6e 6f74 nvironment (*not │ │ │ │ -00030620: 6520 4e65 7477 6f72 6b3a 3a29 2e0a 0a20 e Network::)... │ │ │ │ -00030630: 2020 2020 5468 6973 2063 6f6d 6d61 6e64 This command │ │ │ │ -00030640: 2069 7320 6f6e 6c79 2061 7661 696c 6162 is only availab │ │ │ │ -00030650: 6c65 206f 6e20 5043 2042 494f 5320 7379 le on PC BIOS sy │ │ │ │ -00030660: 7374 656d 732e 0a0a 1f0a 4669 6c65 3a20 stems.....File: │ │ │ │ -00030670: 6772 7562 2e69 6e66 6f2c 2020 4e6f 6465 grub.info, Node │ │ │ │ -00030680: 3a20 7264 6d73 722c 2020 4e65 7874 3a20 : rdmsr, Next: │ │ │ │ -00030690: 7265 6164 2c20 2050 7265 763a 2070 7865 read, Prev: pxe │ │ │ │ -000306a0: 5f75 6e6c 6f61 642c 2020 5570 3a20 436f _unload, Up: Co │ │ │ │ -000306b0: 6d6d 616e 642d 6c69 6e65 2061 6e64 206d mmand-line and m │ │ │ │ -000306c0: 656e 7520 656e 7472 7920 636f 6d6d 616e enu entry comman │ │ │ │ -000306d0: 6473 0a0a 3136 2e33 2e36 3020 7264 6d73 ds..16.3.60 rdms │ │ │ │ -000306e0: 720a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a r.-------------. │ │ │ │ -000306f0: 0a20 2d2d 2043 6f6d 6d61 6e64 3a3a 2072 . -- Command:: r │ │ │ │ -00030700: 646d 7372 2030 7841 4444 5220 5b2d 7620 dmsr 0xADDR [-v │ │ │ │ -00030710: 5641 524e 414d 455d 0a20 2020 2020 5265 VARNAME]. Re │ │ │ │ -00030720: 6164 2061 206d 6f64 656c 2d73 7065 6369 ad a model-speci │ │ │ │ -00030730: 6669 6320 7265 6769 7374 6572 2061 7420 fic register at │ │ │ │ -00030740: 6164 6472 6573 7320 3078 4144 4452 2e20 address 0xADDR. │ │ │ │ -00030750: 4966 2074 6865 2070 6172 616d 6574 6572 If the parameter │ │ │ │ -00030760: 0a20 2020 2020 272d 7627 2069 7320 7573 . '-v' is us │ │ │ │ -00030770: 6564 2061 6e64 2061 6e20 656e 7669 726f ed and an enviro │ │ │ │ -00030780: 6e6d 656e 7420 7661 7269 6162 6c65 2056 nment variable V │ │ │ │ -00030790: 4152 4e41 4d45 2069 7320 6769 7665 6e2c ARNAME is given, │ │ │ │ -000307a0: 2073 6574 2074 6861 740a 2020 2020 2065 set that. e │ │ │ │ -000307b0: 6e76 6972 6f6e 6d65 6e74 2076 6172 6961 nvironment varia │ │ │ │ -000307c0: 626c 6520 746f 2074 6865 2076 616c 7565 ble to the value │ │ │ │ -000307d0: 2074 6861 7420 7761 7320 7265 6164 2e0a that was read.. │ │ │ │ -000307e0: 0a20 2020 2020 506c 6561 7365 206e 6f74 . Please not │ │ │ │ -000307f0: 6520 7468 6174 206f 6e20 534d 5020 7379 e that on SMP sy │ │ │ │ -00030800: 7374 656d 732c 2072 6561 6469 6e67 2066 stems, reading f │ │ │ │ -00030810: 726f 6d20 6120 4d53 5220 7468 6174 2068 rom a MSR that h │ │ │ │ -00030820: 6173 2061 0a20 2020 2020 7363 6f70 6520 as a. scope │ │ │ │ -00030830: 7065 7220 6861 7264 7761 7265 2074 6872 per hardware thr │ │ │ │ -00030840: 6561 642c 2069 6d70 6c69 6573 2074 6861 ead, implies tha │ │ │ │ -00030850: 7420 7468 6520 7661 6c75 6520 7468 6174 t the value that │ │ │ │ -00030860: 2069 7320 7265 7475 726e 6564 0a20 2020 is returned. │ │ │ │ -00030870: 2020 6f6e 6c79 2061 7070 6c69 6573 2074 only applies t │ │ │ │ -00030880: 6f20 7468 6520 7061 7274 6963 756c 6172 o the particular │ │ │ │ -00030890: 2063 7075 2f63 6f72 652f 7468 7265 6164 cpu/core/thread │ │ │ │ -000308a0: 2074 6861 7420 7275 6e73 2074 6865 0a20 that runs the. │ │ │ │ -000308b0: 2020 2020 636f 6d6d 616e 642e 0a0a 2020 command... │ │ │ │ -000308c0: 2020 2041 6c73 6f2c 2069 6620 796f 7520 Also, if you │ │ │ │ -000308d0: 7370 6563 6966 7920 6120 7265 7365 7276 specify a reserv │ │ │ │ -000308e0: 6564 206f 7220 756e 696d 706c 656d 656e ed or unimplemen │ │ │ │ -000308f0: 7465 6420 4d53 5220 6164 6472 6573 732c ted MSR address, │ │ │ │ -00030900: 2069 740a 2020 2020 2077 696c 6c20 6361 it. will ca │ │ │ │ -00030910: 7573 6520 6120 6765 6e65 7261 6c20 7072 use a general pr │ │ │ │ -00030920: 6f74 6563 7469 6f6e 2065 7863 6570 7469 otection excepti │ │ │ │ -00030930: 6f6e 2028 7768 6963 6820 6973 206e 6f74 on (which is not │ │ │ │ -00030940: 2063 7572 7265 6e74 6c79 0a20 2020 2020 currently. │ │ │ │ -00030950: 6265 696e 6720 6861 6e64 6c65 6429 2061 being handled) a │ │ │ │ -00030960: 6e64 2074 6865 2073 7973 7465 6d20 7769 nd the system wi │ │ │ │ -00030970: 6c6c 2072 6562 6f6f 742e 0a0a 1f0a 4669 ll reboot.....Fi │ │ │ │ -00030980: 6c65 3a20 6772 7562 2e69 6e66 6f2c 2020 le: grub.info, │ │ │ │ -00030990: 4e6f 6465 3a20 7265 6164 2c20 204e 6578 Node: read, Nex │ │ │ │ -000309a0: 743a 2072 6562 6f6f 742c 2020 5072 6576 t: reboot, Prev │ │ │ │ -000309b0: 3a20 7264 6d73 722c 2020 5570 3a20 436f : rdmsr, Up: Co │ │ │ │ -000309c0: 6d6d 616e 642d 6c69 6e65 2061 6e64 206d mmand-line and m │ │ │ │ -000309d0: 656e 7520 656e 7472 7920 636f 6d6d 616e enu entry comman │ │ │ │ -000309e0: 6473 0a0a 3136 2e33 2e36 3120 7265 6164 ds..16.3.61 read │ │ │ │ -000309f0: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 .------------.. │ │ │ │ -00030a00: 2d2d 2043 6f6d 6d61 6e64 3a20 7265 6164 -- Command: read │ │ │ │ -00030a10: 205b 7661 725d 0a20 2020 2020 5265 6164 [var]. Read │ │ │ │ -00030a20: 2061 206c 696e 6520 6f66 2069 6e70 7574 a line of input │ │ │ │ -00030a30: 2066 726f 6d20 7468 6520 7573 6572 2e20 from the user. │ │ │ │ -00030a40: 2049 6620 616e 2065 6e76 6972 6f6e 6d65 If an environme │ │ │ │ -00030a50: 6e74 2076 6172 6961 626c 6520 5641 520a nt variable VAR. │ │ │ │ -00030a60: 2020 2020 2069 7320 6769 7665 6e2c 2073 is given, s │ │ │ │ -00030a70: 6574 2074 6861 7420 656e 7669 726f 6e6d et that environm │ │ │ │ -00030a80: 656e 7420 7661 7269 6162 6c65 2074 6f20 ent variable to │ │ │ │ -00030a90: 7468 6520 6c69 6e65 206f 6620 696e 7075 the line of inpu │ │ │ │ -00030aa0: 7420 7468 6174 0a20 2020 2020 7761 7320 t that. was │ │ │ │ -00030ab0: 7265 6164 2c20 7769 7468 206e 6f20 7465 read, with no te │ │ │ │ -00030ac0: 726d 696e 6174 696e 6720 6e65 776c 696e rminating newlin │ │ │ │ -00030ad0: 652e 0a0a 1f0a 4669 6c65 3a20 6772 7562 e.....File: grub │ │ │ │ -00030ae0: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 7265 .info, Node: re │ │ │ │ -00030af0: 626f 6f74 2c20 204e 6578 743a 2072 6567 boot, Next: reg │ │ │ │ -00030b00: 6578 702c 2020 5072 6576 3a20 7265 6164 exp, Prev: read │ │ │ │ -00030b10: 2c20 2055 703a 2043 6f6d 6d61 6e64 2d6c , Up: Command-l │ │ │ │ -00030b20: 696e 6520 616e 6420 6d65 6e75 2065 6e74 ine and menu ent │ │ │ │ -00030b30: 7279 2063 6f6d 6d61 6e64 730a 0a31 362e ry commands..16. │ │ │ │ -00030b40: 332e 3632 2072 6562 6f6f 740a 2d2d 2d2d 3.62 reboot.---- │ │ │ │ -00030b50: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 ----------.. -- │ │ │ │ -00030b60: 436f 6d6d 616e 643a 2072 6562 6f6f 740a Command: reboot. │ │ │ │ -00030b70: 2020 2020 2052 6562 6f6f 7420 7468 6520 Reboot the │ │ │ │ -00030b80: 636f 6d70 7574 6572 2e0a 0a1f 0a46 696c computer.....Fil │ │ │ │ -00030b90: 653a 2067 7275 622e 696e 666f 2c20 204e e: grub.info, N │ │ │ │ -00030ba0: 6f64 653a 2072 6567 6578 702c 2020 4e65 ode: regexp, Ne │ │ │ │ -00030bb0: 7874 3a20 726d 6d6f 642c 2020 5072 6576 xt: rmmod, Prev │ │ │ │ -00030bc0: 3a20 7265 626f 6f74 2c20 2055 703a 2043 : reboot, Up: C │ │ │ │ -00030bd0: 6f6d 6d61 6e64 2d6c 696e 6520 616e 6420 ommand-line and │ │ │ │ -00030be0: 6d65 6e75 2065 6e74 7279 2063 6f6d 6d61 menu entry comma │ │ │ │ -00030bf0: 6e64 730a 0a31 362e 332e 3633 2072 6567 nds..16.3.63 reg │ │ │ │ -00030c00: 6578 700a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d exp.------------ │ │ │ │ -00030c10: 2d2d 0a0a 202d 2d20 436f 6d6d 616e 643a --.. -- Command: │ │ │ │ -00030c20: 2072 6567 6578 7020 5b27 2d2d 7365 7427 regexp ['--set' │ │ │ │ -00030c30: 205b 6e75 6d62 6572 3a5d 7661 725d 2072 [number:]var] r │ │ │ │ -00030c40: 6567 6578 7020 7374 7269 6e67 0a20 2020 egexp string. │ │ │ │ -00030c50: 2020 5465 7374 2069 6620 7265 6775 6c61 Test if regula │ │ │ │ -00030c60: 7220 6578 7072 6573 7369 6f6e 2052 4547 r expression REG │ │ │ │ -00030c70: 4558 5020 6d61 7463 6865 7320 5354 5249 EXP matches STRI │ │ │ │ -00030c80: 4e47 2e20 2053 7570 706f 7274 6564 0a20 NG. Supported. │ │ │ │ -00030c90: 2020 2020 7265 6775 6c61 7220 6578 7072 regular expr │ │ │ │ -00030ca0: 6573 7369 6f6e 7320 6172 6520 504f 5349 essions are POSI │ │ │ │ -00030cb0: 582e 3220 4578 7465 6e64 6564 2052 6567 X.2 Extended Reg │ │ │ │ -00030cc0: 756c 6172 2045 7870 7265 7373 696f 6e73 ular Expressions │ │ │ │ -00030cd0: 2e20 2049 660a 2020 2020 206f 7074 696f . If. optio │ │ │ │ -00030ce0: 6e20 272d 2d73 6574 2720 6973 2067 6976 n '--set' is giv │ │ │ │ -00030cf0: 656e 2c20 7374 6f72 6520 4e55 4d42 4552 en, store NUMBER │ │ │ │ -00030d00: 7468 206d 6174 6368 6564 2073 7562 6578 th matched subex │ │ │ │ -00030d10: 7072 6573 7369 6f6e 2069 6e0a 2020 2020 pression in. │ │ │ │ -00030d20: 2076 6172 6961 626c 6520 5641 522e 2020 variable VAR. │ │ │ │ -00030d30: 5375 6265 7870 7265 7373 696f 6e73 2061 Subexpressions a │ │ │ │ -00030d40: 7265 206e 756d 6265 7265 6420 696e 206f re numbered in o │ │ │ │ -00030d50: 7264 6572 206f 6620 7468 6569 720a 2020 rder of their. │ │ │ │ -00030d60: 2020 206f 7065 6e69 6e67 2070 6172 656e opening paren │ │ │ │ -00030d70: 7468 6573 6573 2073 7461 7274 696e 6720 theses starting │ │ │ │ -00030d80: 6672 6f6d 2027 3127 2e20 204e 554d 4245 from '1'. NUMBE │ │ │ │ -00030d90: 5220 6465 6661 756c 7473 2074 6f20 2731 R defaults to '1 │ │ │ │ -00030da0: 272e 0a0a 1f0a 4669 6c65 3a20 6772 7562 '.....File: grub │ │ │ │ -00030db0: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 726d .info, Node: rm │ │ │ │ -00030dc0: 6d6f 642c 2020 4e65 7874 3a20 7361 7665 mod, Next: save │ │ │ │ -00030dd0: 5f65 6e76 2c20 2050 7265 763a 2072 6567 _env, Prev: reg │ │ │ │ -00030de0: 6578 702c 2020 5570 3a20 436f 6d6d 616e exp, Up: Comman │ │ │ │ -00030df0: 642d 6c69 6e65 2061 6e64 206d 656e 7520 d-line and menu │ │ │ │ -00030e00: 656e 7472 7920 636f 6d6d 616e 6473 0a0a entry commands.. │ │ │ │ -00030e10: 3136 2e33 2e36 3420 726d 6d6f 640a 2d2d 16.3.64 rmmod.-- │ │ │ │ -00030e20: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d -----------.. -- │ │ │ │ -00030e30: 2043 6f6d 6d61 6e64 3a20 726d 6d6f 6420 Command: rmmod │ │ │ │ -00030e40: 6d6f 6475 6c65 0a20 2020 2020 5265 6d6f module. Remo │ │ │ │ -00030e50: 7665 2061 206c 6f61 6465 6420 4d4f 4455 ve a loaded MODU │ │ │ │ -00030e60: 4c45 2e0a 0a1f 0a46 696c 653a 2067 7275 LE.....File: gru │ │ │ │ -00030e70: 622e 696e 666f 2c20 204e 6f64 653a 2073 b.info, Node: s │ │ │ │ -00030e80: 6176 655f 656e 762c 2020 4e65 7874 3a20 ave_env, Next: │ │ │ │ -00030e90: 7365 6172 6368 2c20 2050 7265 763a 2072 search, Prev: r │ │ │ │ -00030ea0: 6d6d 6f64 2c20 2055 703a 2043 6f6d 6d61 mmod, Up: Comma │ │ │ │ -00030eb0: 6e64 2d6c 696e 6520 616e 6420 6d65 6e75 nd-line and menu │ │ │ │ -00030ec0: 2065 6e74 7279 2063 6f6d 6d61 6e64 730a entry commands. │ │ │ │ -00030ed0: 0a31 362e 332e 3635 2073 6176 655f 656e .16.3.65 save_en │ │ │ │ -00030ee0: 760a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d v.-------------- │ │ │ │ -00030ef0: 2d2d 0a0a 202d 2d20 436f 6d6d 616e 643a --.. -- Command: │ │ │ │ -00030f00: 2073 6176 655f 656e 7620 5b27 2d2d 6669 save_env ['--fi │ │ │ │ -00030f10: 6c65 2720 6669 6c65 5d20 7661 7220 2e2e le' file] var .. │ │ │ │ -00030f20: 2e0a 2020 2020 2053 6176 6520 7468 6520 .. Save the │ │ │ │ -00030f30: 6e61 6d65 6420 7661 7269 6162 6c65 7320 named variables │ │ │ │ -00030f40: 6672 6f6d 2074 6865 2065 6e76 6972 6f6e from the environ │ │ │ │ -00030f50: 6d65 6e74 2074 6f20 7468 6520 656e 7669 ment to the envi │ │ │ │ -00030f60: 726f 6e6d 656e 740a 2020 2020 2062 6c6f ronment. blo │ │ │ │ -00030f70: 636b 2066 696c 652e 2020 2a4e 6f74 6520 ck file. *Note │ │ │ │ -00030f80: 456e 7669 726f 6e6d 656e 7420 626c 6f63 Environment bloc │ │ │ │ -00030f90: 6b3a 3a2e 0a0a 2020 2020 2054 6865 2027 k::... The ' │ │ │ │ -00030fa0: 2d2d 6669 6c65 2720 6f70 7469 6f6e 206f --file' option o │ │ │ │ -00030fb0: 7665 7272 6964 6573 2074 6865 2064 6566 verrides the def │ │ │ │ -00030fc0: 6175 6c74 206c 6f63 6174 696f 6e20 6f66 ault location of │ │ │ │ -00030fd0: 2074 6865 0a20 2020 2020 656e 7669 726f the. enviro │ │ │ │ -00030fe0: 6e6d 656e 7420 626c 6f63 6b2e 0a0a 2020 nment block... │ │ │ │ -00030ff0: 2020 2054 6869 7320 636f 6d6d 616e 6420 This command │ │ │ │ -00031000: 7769 6c6c 206f 7065 7261 7465 2073 7563 will operate suc │ │ │ │ -00031010: 6365 7373 6675 6c6c 7920 6576 656e 2077 cessfully even w │ │ │ │ -00031020: 6865 6e20 656e 7669 726f 6e6d 656e 740a hen environment. │ │ │ │ -00031030: 2020 2020 2076 6172 6961 626c 6520 2763 variable 'c │ │ │ │ -00031040: 6865 636b 5f73 6967 6e61 7475 7265 7327 heck_signatures' │ │ │ │ -00031050: 2069 7320 7365 7420 746f 2027 656e 666f is set to 'enfo │ │ │ │ -00031060: 7263 6527 2028 2a6e 6f74 650a 2020 2020 rce' (*note. │ │ │ │ -00031070: 2063 6865 636b 5f73 6967 6e61 7475 7265 check_signature │ │ │ │ -00031080: 733a 3a29 2c20 7369 6e63 6520 6974 2077 s::), since it w │ │ │ │ -00031090: 7269 7465 7320 746f 2064 6973 6b20 616e rites to disk an │ │ │ │ -000310a0: 6420 646f 6573 206e 6f74 2061 6c74 6572 d does not alter │ │ │ │ -000310b0: 2074 6865 0a20 2020 2020 6265 6861 7669 the. behavi │ │ │ │ -000310c0: 6f72 206f 6620 4752 5542 2062 6173 6564 or of GRUB based │ │ │ │ -000310d0: 206f 6e20 616e 7920 636f 6e74 656e 7473 on any contents │ │ │ │ -000310e0: 206f 6620 6469 736b 2074 6861 7420 6861 of disk that ha │ │ │ │ -000310f0: 7665 2062 6565 6e20 7265 6164 2e0a 2020 ve been read.. │ │ │ │ -00031100: 2020 2049 7420 6973 2070 6f73 7369 626c It is possibl │ │ │ │ -00031110: 6520 746f 206d 6f64 6966 7920 6120 6469 e to modify a di │ │ │ │ -00031120: 6769 7461 6c6c 7920 7369 676e 6564 2065 gitally signed e │ │ │ │ -00031130: 6e76 6972 6f6e 6d65 6e74 2062 6c6f 636b nvironment block │ │ │ │ -00031140: 2066 696c 650a 2020 2020 2066 726f 6d20 file. from │ │ │ │ -00031150: 7769 7468 696e 2047 5255 4220 7573 696e within GRUB usin │ │ │ │ -00031160: 6720 7468 6973 2063 6f6d 6d61 6e64 2c20 g this command, │ │ │ │ -00031170: 7375 6368 2074 6861 7420 6974 7320 7369 such that its si │ │ │ │ -00031180: 676e 6174 7572 6520 7769 6c6c 0a20 2020 gnature will. │ │ │ │ -00031190: 2020 6e6f 206c 6f6e 6765 7220 6265 2076 no longer be v │ │ │ │ -000311a0: 616c 6964 206f 6e20 7375 6273 6571 7565 alid on subseque │ │ │ │ -000311b0: 6e74 2062 6f6f 7473 2e20 2043 6172 6520 nt boots. Care │ │ │ │ -000311c0: 7368 6f75 6c64 2062 6520 7461 6b65 6e20 should be taken │ │ │ │ -000311d0: 696e 0a20 2020 2020 7375 6368 2061 6476 in. such adv │ │ │ │ -000311e0: 616e 6365 6420 636f 6e66 6967 7572 6174 anced configurat │ │ │ │ -000311f0: 696f 6e73 2074 6f20 6176 6f69 6420 7265 ions to avoid re │ │ │ │ -00031200: 6e64 6572 696e 6720 7468 6520 7379 7374 ndering the syst │ │ │ │ -00031210: 656d 0a20 2020 2020 756e 626f 6f74 6162 em. unbootab │ │ │ │ -00031220: 6c65 2e20 202a 4e6f 7465 2055 7369 6e67 le. *Note Using │ │ │ │ -00031230: 2064 6967 6974 616c 2073 6967 6e61 7475 digital signatu │ │ │ │ -00031240: 7265 733a 3a2c 2066 6f72 206d 6f72 650a res::, for more. │ │ │ │ -00031250: 2020 2020 2069 6e66 6f72 6d61 7469 6f6e information │ │ │ │ -00031260: 2e0a 0a1f 0a46 696c 653a 2067 7275 622e .....File: grub. │ │ │ │ -00031270: 696e 666f 2c20 204e 6f64 653a 2073 6561 info, Node: sea │ │ │ │ -00031280: 7263 682c 2020 4e65 7874 3a20 7365 6e64 rch, Next: send │ │ │ │ -00031290: 6b65 792c 2020 5072 6576 3a20 7361 7665 key, Prev: save │ │ │ │ -000312a0: 5f65 6e76 2c20 2055 703a 2043 6f6d 6d61 _env, Up: Comma │ │ │ │ -000312b0: 6e64 2d6c 696e 6520 616e 6420 6d65 6e75 nd-line and menu │ │ │ │ -000312c0: 2065 6e74 7279 2063 6f6d 6d61 6e64 730a entry commands. │ │ │ │ -000312d0: 0a31 362e 332e 3636 2073 6561 7263 680a .16.3.66 search. │ │ │ │ -000312e0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a --------------.. │ │ │ │ -000312f0: 202d 2d20 436f 6d6d 616e 643a 2073 6561 -- Command: sea │ │ │ │ -00031300: 7263 6820 5b27 2d2d 6669 6c65 277c 272d rch ['--file'|'- │ │ │ │ -00031310: 2d6c 6162 656c 277c 272d 2d66 732d 7575 -label'|'--fs-uu │ │ │ │ -00031320: 6964 275d 205b 272d 2d73 6574 2720 5b76 id'] ['--set' [v │ │ │ │ -00031330: 6172 5d5d 0a20 2020 2020 2020 2020 205b ar]]. [ │ │ │ │ -00031340: 272d 2d6e 6f2d 666c 6f70 7079 275d 206e '--no-floppy'] n │ │ │ │ -00031350: 616d 650a 2020 2020 2053 6561 7263 6820 ame. Search │ │ │ │ -00031360: 6465 7669 6365 7320 6279 2066 696c 6520 devices by file │ │ │ │ -00031370: 2827 2d66 272c 2027 2d2d 6669 6c65 2729 ('-f', '--file') │ │ │ │ -00031380: 2c20 6669 6c65 7379 7374 656d 206c 6162 , filesystem lab │ │ │ │ -00031390: 656c 2028 272d 6c27 2c0a 2020 2020 2027 el ('-l',. ' │ │ │ │ -000313a0: 2d2d 6c61 6265 6c27 292c 206f 7220 6669 --label'), or fi │ │ │ │ -000313b0: 6c65 7379 7374 656d 2055 5549 4420 2827 lesystem UUID (' │ │ │ │ -000313c0: 2d75 272c 2027 2d2d 6673 2d75 7569 6427 -u', '--fs-uuid' │ │ │ │ -000313d0: 292e 0a0a 2020 2020 2049 6620 7468 6520 )... If the │ │ │ │ -000313e0: 272d 2d73 6574 2720 6f70 7469 6f6e 2069 '--set' option i │ │ │ │ -000313f0: 7320 7573 6564 2c20 7468 6520 6669 7273 s used, the firs │ │ │ │ -00031400: 7420 6465 7669 6365 2066 6f75 6e64 2069 t device found i │ │ │ │ -00031410: 7320 7365 7420 6173 2074 6865 0a20 2020 s set as the. │ │ │ │ -00031420: 2020 7661 6c75 6520 6f66 2065 6e76 6972 value of envir │ │ │ │ -00031430: 6f6e 6d65 6e74 2076 6172 6961 626c 6520 onment variable │ │ │ │ -00031440: 5641 522e 2020 5468 6520 6465 6661 756c VAR. The defaul │ │ │ │ -00031450: 7420 7661 7269 6162 6c65 2069 7320 2772 t variable is 'r │ │ │ │ -00031460: 6f6f 7427 2e0a 0a20 2020 2020 5468 6520 oot'... The │ │ │ │ -00031470: 272d 2d6e 6f2d 666c 6f70 7079 2720 6f70 '--no-floppy' op │ │ │ │ -00031480: 7469 6f6e 2070 7265 7665 6e74 7320 7365 tion prevents se │ │ │ │ -00031490: 6172 6368 696e 6720 666c 6f70 7079 2064 arching floppy d │ │ │ │ -000314a0: 6576 6963 6573 2c20 7768 6963 680a 2020 evices, which. │ │ │ │ -000314b0: 2020 2063 616e 2062 6520 736c 6f77 2e0a can be slow.. │ │ │ │ -000314c0: 0a20 2020 2020 5468 6520 2773 6561 7263 . The 'searc │ │ │ │ -000314d0: 682e 6669 6c65 272c 2027 7365 6172 6368 h.file', 'search │ │ │ │ -000314e0: 2e66 735f 6c61 6265 6c27 2c20 616e 6420 .fs_label', and │ │ │ │ -000314f0: 2773 6561 7263 682e 6673 5f75 7569 6427 'search.fs_uuid' │ │ │ │ -00031500: 2063 6f6d 6d61 6e64 730a 2020 2020 2061 commands. a │ │ │ │ -00031510: 7265 2061 6c69 6173 6573 2066 6f72 2027 re aliases for ' │ │ │ │ -00031520: 7365 6172 6368 202d 2d66 696c 6527 2c20 search --file', │ │ │ │ -00031530: 2773 6561 7263 6820 2d2d 6c61 6265 6c27 'search --label' │ │ │ │ -00031540: 2c20 616e 6420 2773 6561 7263 680a 2020 , and 'search. │ │ │ │ -00031550: 2020 202d 2d66 732d 7575 6964 2720 7265 --fs-uuid' re │ │ │ │ -00031560: 7370 6563 7469 7665 6c79 2e0a 0a1f 0a46 spectively.....F │ │ │ │ -00031570: 696c 653a 2067 7275 622e 696e 666f 2c20 ile: grub.info, │ │ │ │ -00031580: 204e 6f64 653a 2073 656e 646b 6579 2c20 Node: sendkey, │ │ │ │ -00031590: 204e 6578 743a 2073 6574 2c20 2050 7265 Next: set, Pre │ │ │ │ -000315a0: 763a 2073 6561 7263 682c 2020 5570 3a20 v: search, Up: │ │ │ │ -000315b0: 436f 6d6d 616e 642d 6c69 6e65 2061 6e64 Command-line and │ │ │ │ -000315c0: 206d 656e 7520 656e 7472 7920 636f 6d6d menu entry comm │ │ │ │ -000315d0: 616e 6473 0a0a 3136 2e33 2e36 3720 7365 ands..16.3.67 se │ │ │ │ -000315e0: 6e64 6b65 790a 2d2d 2d2d 2d2d 2d2d 2d2d ndkey.---------- │ │ │ │ -000315f0: 2d2d 2d2d 2d0a 0a20 2d2d 2043 6f6d 6d61 -----.. -- Comma │ │ │ │ -00031600: 6e64 3a20 7365 6e64 6b65 790a 2020 2020 nd: sendkey. │ │ │ │ -00031610: 2020 2020 2020 5b27 2d2d 6e75 6d27 7c27 ['--num'|' │ │ │ │ -00031620: 2d2d 6361 7073 277c 272d 2d73 6372 6f6c --caps'|'--scrol │ │ │ │ -00031630: 6c27 7c27 2d2d 696e 7365 7274 277c 272d l'|'--insert'|'- │ │ │ │ -00031640: 2d70 6175 7365 277c 272d 2d6c 6566 742d -pause'|'--left- │ │ │ │ -00031650: 7368 6966 7427 7c27 2d2d 7269 6768 742d shift'|'--right- │ │ │ │ -00031660: 7368 6966 7427 7c27 2d2d 7379 7372 7127 shift'|'--sysrq' │ │ │ │ -00031670: 7c27 2d2d 6e75 6d6b 6579 277c 272d 2d63 |'--numkey'|'--c │ │ │ │ -00031680: 6170 736b 6579 277c 272d 2d73 6372 6f6c apskey'|'--scrol │ │ │ │ -00031690: 6c6b 6579 277c 272d 2d69 6e73 6572 746b lkey'|'--insertk │ │ │ │ -000316a0: 6579 277c 272d 2d6c 6566 742d 616c 7427 ey'|'--left-alt' │ │ │ │ -000316b0: 7c27 2d2d 7269 6768 742d 616c 7427 7c27 |'--right-alt'|' │ │ │ │ -000316c0: 2d2d 6c65 6674 2d63 7472 6c27 7c27 2d2d --left-ctrl'|'-- │ │ │ │ -000316d0: 7269 6768 742d 6374 726c 270a 2020 2020 right-ctrl'. │ │ │ │ -000316e0: 2020 2020 2020 276f 6e27 7c27 6f66 6627 'on'|'off' │ │ │ │ -000316f0: 5d2e 2e2e 205b 276e 6f2d 6c65 6427 5d20 ]... ['no-led'] │ │ │ │ -00031700: 6b65 7973 7472 6f6b 650a 2020 2020 2049 keystroke. I │ │ │ │ -00031710: 6e73 6572 7420 6b65 7973 7472 6f6b 6573 nsert keystrokes │ │ │ │ -00031720: 2069 6e74 6f20 7468 6520 6b65 7962 6f61 into the keyboa │ │ │ │ -00031730: 7264 2062 7566 6665 7220 7768 656e 2062 rd buffer when b │ │ │ │ -00031740: 6f6f 7469 6e67 2e20 2053 6f6d 6574 696d ooting. Sometim │ │ │ │ -00031750: 6573 0a20 2020 2020 616e 206f 7065 7261 es. an opera │ │ │ │ -00031760: 7469 6e67 2073 7973 7465 6d20 6f72 2063 ting system or c │ │ │ │ -00031770: 6861 696e 6c6f 6164 6564 2062 6f6f 7420 hainloaded boot │ │ │ │ -00031780: 6c6f 6164 6572 2072 6571 7569 7265 7320 loader requires │ │ │ │ -00031790: 7061 7274 6963 756c 6172 0a20 2020 2020 particular. │ │ │ │ -000317a0: 6b65 7973 2074 6f20 6265 2070 7265 7373 keys to be press │ │ │ │ -000317b0: 6564 3a20 666f 7220 6578 616d 706c 652c ed: for example, │ │ │ │ -000317c0: 206f 6e65 206d 6967 6874 206e 6565 6420 one might need │ │ │ │ -000317d0: 746f 2070 7265 7373 2061 0a20 2020 2020 to press a. │ │ │ │ -000317e0: 7061 7274 6963 756c 6172 206b 6579 2074 particular key t │ │ │ │ -000317f0: 6f20 656e 7465 7220 2273 6166 6520 6d6f o enter "safe mo │ │ │ │ -00031800: 6465 222c 206f 7220 7768 656e 2063 6861 de", or when cha │ │ │ │ -00031810: 696e 6c6f 6164 696e 6720 616e 6f74 6865 inloading anothe │ │ │ │ -00031820: 720a 2020 2020 2062 6f6f 7420 6c6f 6164 r. boot load │ │ │ │ -00031830: 6572 206f 6e65 206d 6967 6874 2073 656e er one might sen │ │ │ │ -00031840: 6420 6b65 7973 7472 6f6b 6573 2074 6f20 d keystrokes to │ │ │ │ -00031850: 6974 2074 6f20 6e61 7669 6761 7465 2069 it to navigate i │ │ │ │ -00031860: 7473 206d 656e 752e 0a0a 2020 2020 2059 ts menu... Y │ │ │ │ -00031870: 6f75 206d 6179 2070 726f 7669 6465 2075 ou may provide u │ │ │ │ -00031880: 7020 746f 2031 3620 6b65 7973 7472 6f6b p to 16 keystrok │ │ │ │ -00031890: 6573 2028 7468 6520 6c65 6e67 7468 206f es (the length o │ │ │ │ -000318a0: 6620 7468 6520 4249 4f53 0a20 2020 2020 f the BIOS. │ │ │ │ -000318b0: 6b65 7962 6f61 7264 2062 7566 6665 7229 keyboard buffer) │ │ │ │ -000318c0: 2e20 204b 6579 7374 726f 6b65 206e 616d . Keystroke nam │ │ │ │ -000318d0: 6573 206d 6179 2062 6520 7570 7065 722d es may be upper- │ │ │ │ -000318e0: 6361 7365 206f 7220 6c6f 7765 722d 6361 case or lower-ca │ │ │ │ -000318f0: 7365 0a20 2020 2020 6c65 7474 6572 732c se. letters, │ │ │ │ -00031900: 2064 6967 6974 732c 206f 7220 7461 6b65 digits, or take │ │ │ │ -00031910: 6e20 6672 6f6d 2074 6865 2066 6f6c 6c6f n from the follo │ │ │ │ -00031920: 7769 6e67 2074 6162 6c65 3a0a 0a20 2020 wing table:.. │ │ │ │ -00031930: 2020 4e61 6d65 2020 2020 2020 2020 2020 Name │ │ │ │ +0002fff0: 2d2d 2d2d 0a0a 202d 2d20 436f 6d6d 616e ----.. -- Comman │ │ │ │ +00030000: 643a 2070 6173 7377 6f72 645f 7062 6b64 d: password_pbkd │ │ │ │ +00030010: 6632 2075 7365 7220 6861 7368 6564 2d70 f2 user hashed-p │ │ │ │ +00030020: 6173 7377 6f72 640a 2020 2020 2044 6566 assword. Def │ │ │ │ +00030030: 696e 6520 6120 7573 6572 206e 616d 6564 ine a user named │ │ │ │ +00030040: 2055 5345 5220 7769 7468 2070 6173 7377 USER with passw │ │ │ │ +00030050: 6f72 6420 6861 7368 2048 4153 4845 442d ord hash HASHED- │ │ │ │ +00030060: 5041 5353 574f 5244 2e20 2055 7365 0a20 PASSWORD. Use. │ │ │ │ +00030070: 2020 2020 2767 7275 622d 6d6b 7061 7373 'grub-mkpass │ │ │ │ +00030080: 7764 2d70 626b 6466 3227 2028 2a6e 6f74 wd-pbkdf2' (*not │ │ │ │ +00030090: 6520 496e 766f 6b69 6e67 2067 7275 622d e Invoking grub- │ │ │ │ +000300a0: 6d6b 7061 7373 7764 2d70 626b 6466 323a mkpasswd-pbkdf2: │ │ │ │ +000300b0: 3a29 2074 6f0a 2020 2020 2067 656e 6572 :) to. gener │ │ │ │ +000300c0: 6174 6520 7061 7373 776f 7264 2068 6173 ate password has │ │ │ │ +000300d0: 6865 732e 2020 2a4e 6f74 6520 5365 6375 hes. *Note Secu │ │ │ │ +000300e0: 7269 7479 3a3a 2e0a 0a1f 0a46 696c 653a rity::.....File: │ │ │ │ +000300f0: 2067 7275 622e 696e 666f 2c20 204e 6f64 grub.info, Nod │ │ │ │ +00030100: 653a 2070 6c61 792c 2020 4e65 7874 3a20 e: play, Next: │ │ │ │ +00030110: 7072 6f62 652c 2020 5072 6576 3a20 7061 probe, Prev: pa │ │ │ │ +00030120: 7373 776f 7264 5f70 626b 6466 322c 2020 ssword_pbkdf2, │ │ │ │ +00030130: 5570 3a20 436f 6d6d 616e 642d 6c69 6e65 Up: Command-line │ │ │ │ +00030140: 2061 6e64 206d 656e 7520 656e 7472 7920 and menu entry │ │ │ │ +00030150: 636f 6d6d 616e 6473 0a0a 3136 2e33 2e35 commands..16.3.5 │ │ │ │ +00030160: 3720 706c 6179 0a2d 2d2d 2d2d 2d2d 2d2d 7 play.--------- │ │ │ │ +00030170: 2d2d 2d0a 0a20 2d2d 2043 6f6d 6d61 6e64 ---.. -- Command │ │ │ │ +00030180: 3a20 706c 6179 2066 696c 6520 7c20 7465 : play file | te │ │ │ │ +00030190: 6d70 6f20 5b70 6974 6368 3120 6475 7261 mpo [pitch1 dura │ │ │ │ +000301a0: 7469 6f6e 315d 205b 7069 7463 6832 2064 tion1] [pitch2 d │ │ │ │ +000301b0: 7572 6174 696f 6e32 5d20 2e2e 2e0a 2020 uration2] .... │ │ │ │ +000301c0: 2020 2050 6c61 7973 2061 2074 756e 650a Plays a tune. │ │ │ │ +000301d0: 0a20 2020 2020 4966 2074 6865 2061 7267 . If the arg │ │ │ │ +000301e0: 756d 656e 7420 6973 2061 2066 696c 6520 ument is a file │ │ │ │ +000301f0: 6e61 6d65 2028 2a6e 6f74 6520 4669 6c65 name (*note File │ │ │ │ +00030200: 206e 616d 6520 7379 6e74 6178 3a3a 292c name syntax::), │ │ │ │ +00030210: 2070 6c61 7920 7468 650a 2020 2020 2074 play the. t │ │ │ │ +00030220: 756e 6520 7265 636f 7264 6564 2069 6e20 une recorded in │ │ │ │ +00030230: 6974 2e20 2054 6865 2066 696c 6520 666f it. The file fo │ │ │ │ +00030240: 726d 6174 2069 7320 6669 7273 7420 7468 rmat is first th │ │ │ │ +00030250: 6520 7465 6d70 6f20 6173 2061 6e0a 2020 e tempo as an. │ │ │ │ +00030260: 2020 2075 6e73 6967 6e65 6420 3332 6269 unsigned 32bi │ │ │ │ +00030270: 7420 6c69 7474 6c65 2d65 6e64 6961 6e20 t little-endian │ │ │ │ +00030280: 6e75 6d62 6572 2c20 7468 656e 2070 6169 number, then pai │ │ │ │ +00030290: 7273 206f 6620 756e 7369 676e 6564 2031 rs of unsigned 1 │ │ │ │ +000302a0: 3662 6974 0a20 2020 2020 6c69 7474 6c65 6bit. little │ │ │ │ +000302b0: 2d65 6e64 6961 6e20 6e75 6d62 6572 7320 -endian numbers │ │ │ │ +000302c0: 666f 7220 7069 7463 6820 616e 6420 6475 for pitch and du │ │ │ │ +000302d0: 7261 7469 6f6e 2070 6169 7273 2e0a 0a20 ration pairs... │ │ │ │ +000302e0: 2020 2020 4966 2074 6865 2061 7267 756d If the argum │ │ │ │ +000302f0: 656e 7473 2061 7265 2061 2073 6572 6965 ents are a serie │ │ │ │ +00030300: 7320 6f66 206e 756d 6265 7273 2c20 706c s of numbers, pl │ │ │ │ +00030310: 6179 2074 6865 2069 6e6c 696e 6520 7475 ay the inline tu │ │ │ │ +00030320: 6e65 2e0a 0a20 2020 2020 5468 6520 7465 ne... The te │ │ │ │ +00030330: 6d70 6f20 6973 2074 6865 2062 6173 6520 mpo is the base │ │ │ │ +00030340: 666f 7220 616c 6c20 6e6f 7465 2064 7572 for all note dur │ │ │ │ +00030350: 6174 696f 6e73 2e20 2036 3020 6769 7665 ations. 60 give │ │ │ │ +00030360: 7320 6120 312d 7365 636f 6e64 0a20 2020 s a 1-second. │ │ │ │ +00030370: 2020 6261 7365 2c20 3132 3020 6769 7665 base, 120 give │ │ │ │ +00030380: 7320 6120 6861 6c66 2d73 6563 6f6e 6420 s a half-second │ │ │ │ +00030390: 6261 7365 2c20 6574 632e 2020 5069 7463 base, etc. Pitc │ │ │ │ +000303a0: 6865 7320 6172 6520 487a 2e20 2053 6574 hes are Hz. Set │ │ │ │ +000303b0: 0a20 2020 2020 7069 7463 6820 746f 2030 . pitch to 0 │ │ │ │ +000303c0: 2074 6f20 7072 6f64 7563 6520 6120 7265 to produce a re │ │ │ │ +000303d0: 7374 2e0a 0a1f 0a46 696c 653a 2067 7275 st.....File: gru │ │ │ │ +000303e0: 622e 696e 666f 2c20 204e 6f64 653a 2070 b.info, Node: p │ │ │ │ +000303f0: 726f 6265 2c20 204e 6578 743a 2070 7865 robe, Next: pxe │ │ │ │ +00030400: 5f75 6e6c 6f61 642c 2020 5072 6576 3a20 _unload, Prev: │ │ │ │ +00030410: 706c 6179 2c20 2055 703a 2043 6f6d 6d61 play, Up: Comma │ │ │ │ +00030420: 6e64 2d6c 696e 6520 616e 6420 6d65 6e75 nd-line and menu │ │ │ │ +00030430: 2065 6e74 7279 2063 6f6d 6d61 6e64 730a entry commands. │ │ │ │ +00030440: 0a31 362e 332e 3538 2070 726f 6265 0a2d .16.3.58 probe.- │ │ │ │ +00030450: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d ------------.. - │ │ │ │ +00030460: 2d20 436f 6d6d 616e 643a 2070 726f 6265 - Command: probe │ │ │ │ +00030470: 205b 272d 2d73 6574 2720 7661 725d 0a20 ['--set' var]. │ │ │ │ +00030480: 2020 2020 2020 2020 2027 2d2d 6472 6976 '--driv │ │ │ │ +00030490: 6572 277c 272d 2d70 6172 746d 6170 277c er'|'--partmap'| │ │ │ │ +000304a0: 272d 2d66 7327 7c27 2d2d 6673 2d75 7569 '--fs'|'--fs-uui │ │ │ │ +000304b0: 6427 7c27 2d2d 6c61 6265 6c27 2064 6576 d'|'--label' dev │ │ │ │ +000304c0: 6963 650a 2020 2020 2052 6574 7269 6576 ice. Retriev │ │ │ │ +000304d0: 6520 6465 7669 6365 2069 6e66 6f72 6d61 e device informa │ │ │ │ +000304e0: 7469 6f6e 2e20 2049 6620 6f70 7469 6f6e tion. If option │ │ │ │ +000304f0: 2027 2d2d 7365 7427 2069 7320 6769 7665 '--set' is give │ │ │ │ +00030500: 6e2c 2061 7373 6967 6e0a 2020 2020 2072 n, assign. r │ │ │ │ +00030510: 6573 756c 7420 746f 2076 6172 6961 626c esult to variabl │ │ │ │ +00030520: 6520 5641 522c 206f 7468 6572 7769 7365 e VAR, otherwise │ │ │ │ +00030530: 2070 7269 6e74 2069 6e66 6f72 6d61 7469 print informati │ │ │ │ +00030540: 6f6e 206f 6e20 7468 6520 7363 7265 656e on on the screen │ │ │ │ +00030550: 2e0a 0a1f 0a46 696c 653a 2067 7275 622e .....File: grub. │ │ │ │ +00030560: 696e 666f 2c20 204e 6f64 653a 2070 7865 info, Node: pxe │ │ │ │ +00030570: 5f75 6e6c 6f61 642c 2020 4e65 7874 3a20 _unload, Next: │ │ │ │ +00030580: 7264 6d73 722c 2020 5072 6576 3a20 7072 rdmsr, Prev: pr │ │ │ │ +00030590: 6f62 652c 2020 5570 3a20 436f 6d6d 616e obe, Up: Comman │ │ │ │ +000305a0: 642d 6c69 6e65 2061 6e64 206d 656e 7520 d-line and menu │ │ │ │ +000305b0: 656e 7472 7920 636f 6d6d 616e 6473 0a0a entry commands.. │ │ │ │ +000305c0: 3136 2e33 2e35 3920 7078 655f 756e 6c6f 16.3.59 pxe_unlo │ │ │ │ +000305d0: 6164 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ad.------------- │ │ │ │ +000305e0: 2d2d 2d2d 2d0a 0a20 2d2d 2043 6f6d 6d61 -----.. -- Comma │ │ │ │ +000305f0: 6e64 3a20 7078 655f 756e 6c6f 6164 0a20 nd: pxe_unload. │ │ │ │ +00030600: 2020 2020 556e 6c6f 6164 2074 6865 2050 Unload the P │ │ │ │ +00030610: 5845 2065 6e76 6972 6f6e 6d65 6e74 2028 XE environment ( │ │ │ │ +00030620: 2a6e 6f74 6520 4e65 7477 6f72 6b3a 3a29 *note Network::) │ │ │ │ +00030630: 2e0a 0a20 2020 2020 5468 6973 2063 6f6d ... This com │ │ │ │ +00030640: 6d61 6e64 2069 7320 6f6e 6c79 2061 7661 mand is only ava │ │ │ │ +00030650: 696c 6162 6c65 206f 6e20 5043 2042 494f ilable on PC BIO │ │ │ │ +00030660: 5320 7379 7374 656d 732e 0a0a 1f0a 4669 S systems.....Fi │ │ │ │ +00030670: 6c65 3a20 6772 7562 2e69 6e66 6f2c 2020 le: grub.info, │ │ │ │ +00030680: 4e6f 6465 3a20 7264 6d73 722c 2020 4e65 Node: rdmsr, Ne │ │ │ │ +00030690: 7874 3a20 7265 6164 2c20 2050 7265 763a xt: read, Prev: │ │ │ │ +000306a0: 2070 7865 5f75 6e6c 6f61 642c 2020 5570 pxe_unload, Up │ │ │ │ +000306b0: 3a20 436f 6d6d 616e 642d 6c69 6e65 2061 : Command-line a │ │ │ │ +000306c0: 6e64 206d 656e 7520 656e 7472 7920 636f nd menu entry co │ │ │ │ +000306d0: 6d6d 616e 6473 0a0a 3136 2e33 2e36 3020 mmands..16.3.60 │ │ │ │ +000306e0: 7264 6d73 720a 2d2d 2d2d 2d2d 2d2d 2d2d rdmsr.---------- │ │ │ │ +000306f0: 2d2d 2d0a 0a20 2d2d 2043 6f6d 6d61 6e64 ---.. -- Command │ │ │ │ +00030700: 3a3a 2072 646d 7372 2030 7841 4444 5220 :: rdmsr 0xADDR │ │ │ │ +00030710: 5b2d 7620 5641 524e 414d 455d 0a20 2020 [-v VARNAME]. │ │ │ │ +00030720: 2020 5265 6164 2061 206d 6f64 656c 2d73 Read a model-s │ │ │ │ +00030730: 7065 6369 6669 6320 7265 6769 7374 6572 pecific register │ │ │ │ +00030740: 2061 7420 6164 6472 6573 7320 3078 4144 at address 0xAD │ │ │ │ +00030750: 4452 2e20 4966 2074 6865 2070 6172 616d DR. If the param │ │ │ │ +00030760: 6574 6572 0a20 2020 2020 272d 7627 2069 eter. '-v' i │ │ │ │ +00030770: 7320 7573 6564 2061 6e64 2061 6e20 656e s used and an en │ │ │ │ +00030780: 7669 726f 6e6d 656e 7420 7661 7269 6162 vironment variab │ │ │ │ +00030790: 6c65 2056 4152 4e41 4d45 2069 7320 6769 le VARNAME is gi │ │ │ │ +000307a0: 7665 6e2c 2073 6574 2074 6861 740a 2020 ven, set that. │ │ │ │ +000307b0: 2020 2065 6e76 6972 6f6e 6d65 6e74 2076 environment v │ │ │ │ +000307c0: 6172 6961 626c 6520 746f 2074 6865 2076 ariable to the v │ │ │ │ +000307d0: 616c 7565 2074 6861 7420 7761 7320 7265 alue that was re │ │ │ │ +000307e0: 6164 2e0a 0a20 2020 2020 506c 6561 7365 ad... Please │ │ │ │ +000307f0: 206e 6f74 6520 7468 6174 206f 6e20 534d note that on SM │ │ │ │ +00030800: 5020 7379 7374 656d 732c 2072 6561 6469 P systems, readi │ │ │ │ +00030810: 6e67 2066 726f 6d20 6120 4d53 5220 7468 ng from a MSR th │ │ │ │ +00030820: 6174 2068 6173 2061 0a20 2020 2020 7363 at has a. sc │ │ │ │ +00030830: 6f70 6520 7065 7220 6861 7264 7761 7265 ope per hardware │ │ │ │ +00030840: 2074 6872 6561 642c 2069 6d70 6c69 6573 thread, implies │ │ │ │ +00030850: 2074 6861 7420 7468 6520 7661 6c75 6520 that the value │ │ │ │ +00030860: 7468 6174 2069 7320 7265 7475 726e 6564 that is returned │ │ │ │ +00030870: 0a20 2020 2020 6f6e 6c79 2061 7070 6c69 . only appli │ │ │ │ +00030880: 6573 2074 6f20 7468 6520 7061 7274 6963 es to the partic │ │ │ │ +00030890: 756c 6172 2063 7075 2f63 6f72 652f 7468 ular cpu/core/th │ │ │ │ +000308a0: 7265 6164 2074 6861 7420 7275 6e73 2074 read that runs t │ │ │ │ +000308b0: 6865 0a20 2020 2020 636f 6d6d 616e 642e he. command. │ │ │ │ +000308c0: 0a0a 2020 2020 2041 6c73 6f2c 2069 6620 .. Also, if │ │ │ │ +000308d0: 796f 7520 7370 6563 6966 7920 6120 7265 you specify a re │ │ │ │ +000308e0: 7365 7276 6564 206f 7220 756e 696d 706c served or unimpl │ │ │ │ +000308f0: 656d 656e 7465 6420 4d53 5220 6164 6472 emented MSR addr │ │ │ │ +00030900: 6573 732c 2069 740a 2020 2020 2077 696c ess, it. wil │ │ │ │ +00030910: 6c20 6361 7573 6520 6120 6765 6e65 7261 l cause a genera │ │ │ │ +00030920: 6c20 7072 6f74 6563 7469 6f6e 2065 7863 l protection exc │ │ │ │ +00030930: 6570 7469 6f6e 2028 7768 6963 6820 6973 eption (which is │ │ │ │ +00030940: 206e 6f74 2063 7572 7265 6e74 6c79 0a20 not currently. │ │ │ │ +00030950: 2020 2020 6265 696e 6720 6861 6e64 6c65 being handle │ │ │ │ +00030960: 6429 2061 6e64 2074 6865 2073 7973 7465 d) and the syste │ │ │ │ +00030970: 6d20 7769 6c6c 2072 6562 6f6f 742e 0a0a m will reboot... │ │ │ │ +00030980: 1f0a 4669 6c65 3a20 6772 7562 2e69 6e66 ..File: grub.inf │ │ │ │ +00030990: 6f2c 2020 4e6f 6465 3a20 7265 6164 2c20 o, Node: read, │ │ │ │ +000309a0: 204e 6578 743a 2072 6562 6f6f 742c 2020 Next: reboot, │ │ │ │ +000309b0: 5072 6576 3a20 7264 6d73 722c 2020 5570 Prev: rdmsr, Up │ │ │ │ +000309c0: 3a20 436f 6d6d 616e 642d 6c69 6e65 2061 : Command-line a │ │ │ │ +000309d0: 6e64 206d 656e 7520 656e 7472 7920 636f nd menu entry co │ │ │ │ +000309e0: 6d6d 616e 6473 0a0a 3136 2e33 2e36 3120 mmands..16.3.61 │ │ │ │ +000309f0: 7265 6164 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d read.----------- │ │ │ │ +00030a00: 2d0a 0a20 2d2d 2043 6f6d 6d61 6e64 3a20 -.. -- Command: │ │ │ │ +00030a10: 7265 6164 205b 7661 725d 0a20 2020 2020 read [var]. │ │ │ │ +00030a20: 5265 6164 2061 206c 696e 6520 6f66 2069 Read a line of i │ │ │ │ +00030a30: 6e70 7574 2066 726f 6d20 7468 6520 7573 nput from the us │ │ │ │ +00030a40: 6572 2e20 2049 6620 616e 2065 6e76 6972 er. If an envir │ │ │ │ +00030a50: 6f6e 6d65 6e74 2076 6172 6961 626c 6520 onment variable │ │ │ │ +00030a60: 5641 520a 2020 2020 2069 7320 6769 7665 VAR. is give │ │ │ │ +00030a70: 6e2c 2073 6574 2074 6861 7420 656e 7669 n, set that envi │ │ │ │ +00030a80: 726f 6e6d 656e 7420 7661 7269 6162 6c65 ronment variable │ │ │ │ +00030a90: 2074 6f20 7468 6520 6c69 6e65 206f 6620 to the line of │ │ │ │ +00030aa0: 696e 7075 7420 7468 6174 0a20 2020 2020 input that. │ │ │ │ +00030ab0: 7761 7320 7265 6164 2c20 7769 7468 206e was read, with n │ │ │ │ +00030ac0: 6f20 7465 726d 696e 6174 696e 6720 6e65 o terminating ne │ │ │ │ +00030ad0: 776c 696e 652e 0a0a 1f0a 4669 6c65 3a20 wline.....File: │ │ │ │ +00030ae0: 6772 7562 2e69 6e66 6f2c 2020 4e6f 6465 grub.info, Node │ │ │ │ +00030af0: 3a20 7265 626f 6f74 2c20 204e 6578 743a : reboot, Next: │ │ │ │ +00030b00: 2072 6567 6578 702c 2020 5072 6576 3a20 regexp, Prev: │ │ │ │ +00030b10: 7265 6164 2c20 2055 703a 2043 6f6d 6d61 read, Up: Comma │ │ │ │ +00030b20: 6e64 2d6c 696e 6520 616e 6420 6d65 6e75 nd-line and menu │ │ │ │ +00030b30: 2065 6e74 7279 2063 6f6d 6d61 6e64 730a entry commands. │ │ │ │ +00030b40: 0a31 362e 332e 3632 2072 6562 6f6f 740a .16.3.62 reboot. │ │ │ │ +00030b50: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a --------------.. │ │ │ │ +00030b60: 202d 2d20 436f 6d6d 616e 643a 2072 6562 -- Command: reb │ │ │ │ +00030b70: 6f6f 740a 2020 2020 2052 6562 6f6f 7420 oot. Reboot │ │ │ │ +00030b80: 7468 6520 636f 6d70 7574 6572 2e0a 0a1f the computer.... │ │ │ │ +00030b90: 0a46 696c 653a 2067 7275 622e 696e 666f .File: grub.info │ │ │ │ +00030ba0: 2c20 204e 6f64 653a 2072 6567 6578 702c , Node: regexp, │ │ │ │ +00030bb0: 2020 4e65 7874 3a20 726d 6d6f 642c 2020 Next: rmmod, │ │ │ │ +00030bc0: 5072 6576 3a20 7265 626f 6f74 2c20 2055 Prev: reboot, U │ │ │ │ +00030bd0: 703a 2043 6f6d 6d61 6e64 2d6c 696e 6520 p: Command-line │ │ │ │ +00030be0: 616e 6420 6d65 6e75 2065 6e74 7279 2063 and menu entry c │ │ │ │ +00030bf0: 6f6d 6d61 6e64 730a 0a31 362e 332e 3633 ommands..16.3.63 │ │ │ │ +00030c00: 2072 6567 6578 700a 2d2d 2d2d 2d2d 2d2d regexp.-------- │ │ │ │ +00030c10: 2d2d 2d2d 2d2d 0a0a 202d 2d20 436f 6d6d ------.. -- Comm │ │ │ │ +00030c20: 616e 643a 2072 6567 6578 7020 5b27 2d2d and: regexp ['-- │ │ │ │ +00030c30: 7365 7427 205b 6e75 6d62 6572 3a5d 7661 set' [number:]va │ │ │ │ +00030c40: 725d 2072 6567 6578 7020 7374 7269 6e67 r] regexp string │ │ │ │ +00030c50: 0a20 2020 2020 5465 7374 2069 6620 7265 . Test if re │ │ │ │ +00030c60: 6775 6c61 7220 6578 7072 6573 7369 6f6e gular expression │ │ │ │ +00030c70: 2052 4547 4558 5020 6d61 7463 6865 7320 REGEXP matches │ │ │ │ +00030c80: 5354 5249 4e47 2e20 2053 7570 706f 7274 STRING. Support │ │ │ │ +00030c90: 6564 0a20 2020 2020 7265 6775 6c61 7220 ed. regular │ │ │ │ +00030ca0: 6578 7072 6573 7369 6f6e 7320 6172 6520 expressions are │ │ │ │ +00030cb0: 504f 5349 582e 3220 4578 7465 6e64 6564 POSIX.2 Extended │ │ │ │ +00030cc0: 2052 6567 756c 6172 2045 7870 7265 7373 Regular Express │ │ │ │ +00030cd0: 696f 6e73 2e20 2049 660a 2020 2020 206f ions. If. o │ │ │ │ +00030ce0: 7074 696f 6e20 272d 2d73 6574 2720 6973 ption '--set' is │ │ │ │ +00030cf0: 2067 6976 656e 2c20 7374 6f72 6520 4e55 given, store NU │ │ │ │ +00030d00: 4d42 4552 7468 206d 6174 6368 6564 2073 MBERth matched s │ │ │ │ +00030d10: 7562 6578 7072 6573 7369 6f6e 2069 6e0a ubexpression in. │ │ │ │ +00030d20: 2020 2020 2076 6172 6961 626c 6520 5641 variable VA │ │ │ │ +00030d30: 522e 2020 5375 6265 7870 7265 7373 696f R. Subexpressio │ │ │ │ +00030d40: 6e73 2061 7265 206e 756d 6265 7265 6420 ns are numbered │ │ │ │ +00030d50: 696e 206f 7264 6572 206f 6620 7468 6569 in order of thei │ │ │ │ +00030d60: 720a 2020 2020 206f 7065 6e69 6e67 2070 r. opening p │ │ │ │ +00030d70: 6172 656e 7468 6573 6573 2073 7461 7274 arentheses start │ │ │ │ +00030d80: 696e 6720 6672 6f6d 2027 3127 2e20 204e ing from '1'. N │ │ │ │ +00030d90: 554d 4245 5220 6465 6661 756c 7473 2074 UMBER defaults t │ │ │ │ +00030da0: 6f20 2731 272e 0a0a 1f0a 4669 6c65 3a20 o '1'.....File: │ │ │ │ +00030db0: 6772 7562 2e69 6e66 6f2c 2020 4e6f 6465 grub.info, Node │ │ │ │ +00030dc0: 3a20 726d 6d6f 642c 2020 4e65 7874 3a20 : rmmod, Next: │ │ │ │ +00030dd0: 7361 7665 5f65 6e76 2c20 2050 7265 763a save_env, Prev: │ │ │ │ +00030de0: 2072 6567 6578 702c 2020 5570 3a20 436f regexp, Up: Co │ │ │ │ +00030df0: 6d6d 616e 642d 6c69 6e65 2061 6e64 206d mmand-line and m │ │ │ │ +00030e00: 656e 7520 656e 7472 7920 636f 6d6d 616e enu entry comman │ │ │ │ +00030e10: 6473 0a0a 3136 2e33 2e36 3420 726d 6d6f ds..16.3.64 rmmo │ │ │ │ +00030e20: 640a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a d.-------------. │ │ │ │ +00030e30: 0a20 2d2d 2043 6f6d 6d61 6e64 3a20 726d . -- Command: rm │ │ │ │ +00030e40: 6d6f 6420 6d6f 6475 6c65 0a20 2020 2020 mod module. │ │ │ │ +00030e50: 5265 6d6f 7665 2061 206c 6f61 6465 6420 Remove a loaded │ │ │ │ +00030e60: 4d4f 4455 4c45 2e0a 0a1f 0a46 696c 653a MODULE.....File: │ │ │ │ +00030e70: 2067 7275 622e 696e 666f 2c20 204e 6f64 grub.info, Nod │ │ │ │ +00030e80: 653a 2073 6176 655f 656e 762c 2020 4e65 e: save_env, Ne │ │ │ │ +00030e90: 7874 3a20 7365 6172 6368 2c20 2050 7265 xt: search, Pre │ │ │ │ +00030ea0: 763a 2072 6d6d 6f64 2c20 2055 703a 2043 v: rmmod, Up: C │ │ │ │ +00030eb0: 6f6d 6d61 6e64 2d6c 696e 6520 616e 6420 ommand-line and │ │ │ │ +00030ec0: 6d65 6e75 2065 6e74 7279 2063 6f6d 6d61 menu entry comma │ │ │ │ +00030ed0: 6e64 730a 0a31 362e 332e 3635 2073 6176 nds..16.3.65 sav │ │ │ │ +00030ee0: 655f 656e 760a 2d2d 2d2d 2d2d 2d2d 2d2d e_env.---------- │ │ │ │ +00030ef0: 2d2d 2d2d 2d2d 0a0a 202d 2d20 436f 6d6d ------.. -- Comm │ │ │ │ +00030f00: 616e 643a 2073 6176 655f 656e 7620 5b27 and: save_env [' │ │ │ │ +00030f10: 2d2d 6669 6c65 2720 6669 6c65 5d20 7661 --file' file] va │ │ │ │ +00030f20: 7220 2e2e 2e0a 2020 2020 2053 6176 6520 r .... Save │ │ │ │ +00030f30: 7468 6520 6e61 6d65 6420 7661 7269 6162 the named variab │ │ │ │ +00030f40: 6c65 7320 6672 6f6d 2074 6865 2065 6e76 les from the env │ │ │ │ +00030f50: 6972 6f6e 6d65 6e74 2074 6f20 7468 6520 ironment to the │ │ │ │ +00030f60: 656e 7669 726f 6e6d 656e 740a 2020 2020 environment. │ │ │ │ +00030f70: 2062 6c6f 636b 2066 696c 652e 2020 2a4e block file. *N │ │ │ │ +00030f80: 6f74 6520 456e 7669 726f 6e6d 656e 7420 ote Environment │ │ │ │ +00030f90: 626c 6f63 6b3a 3a2e 0a0a 2020 2020 2054 block::... T │ │ │ │ +00030fa0: 6865 2027 2d2d 6669 6c65 2720 6f70 7469 he '--file' opti │ │ │ │ +00030fb0: 6f6e 206f 7665 7272 6964 6573 2074 6865 on overrides the │ │ │ │ +00030fc0: 2064 6566 6175 6c74 206c 6f63 6174 696f default locatio │ │ │ │ +00030fd0: 6e20 6f66 2074 6865 0a20 2020 2020 656e n of the. en │ │ │ │ +00030fe0: 7669 726f 6e6d 656e 7420 626c 6f63 6b2e vironment block. │ │ │ │ +00030ff0: 0a0a 2020 2020 2054 6869 7320 636f 6d6d .. This comm │ │ │ │ +00031000: 616e 6420 7769 6c6c 206f 7065 7261 7465 and will operate │ │ │ │ +00031010: 2073 7563 6365 7373 6675 6c6c 7920 6576 successfully ev │ │ │ │ +00031020: 656e 2077 6865 6e20 656e 7669 726f 6e6d en when environm │ │ │ │ +00031030: 656e 740a 2020 2020 2076 6172 6961 626c ent. variabl │ │ │ │ +00031040: 6520 2763 6865 636b 5f73 6967 6e61 7475 e 'check_signatu │ │ │ │ +00031050: 7265 7327 2069 7320 7365 7420 746f 2027 res' is set to ' │ │ │ │ +00031060: 656e 666f 7263 6527 2028 2a6e 6f74 650a enforce' (*note. │ │ │ │ +00031070: 2020 2020 2063 6865 636b 5f73 6967 6e61 check_signa │ │ │ │ +00031080: 7475 7265 733a 3a29 2c20 7369 6e63 6520 tures::), since │ │ │ │ +00031090: 6974 2077 7269 7465 7320 746f 2064 6973 it writes to dis │ │ │ │ +000310a0: 6b20 616e 6420 646f 6573 206e 6f74 2061 k and does not a │ │ │ │ +000310b0: 6c74 6572 2074 6865 0a20 2020 2020 6265 lter the. be │ │ │ │ +000310c0: 6861 7669 6f72 206f 6620 4752 5542 2062 havior of GRUB b │ │ │ │ +000310d0: 6173 6564 206f 6e20 616e 7920 636f 6e74 ased on any cont │ │ │ │ +000310e0: 656e 7473 206f 6620 6469 736b 2074 6861 ents of disk tha │ │ │ │ +000310f0: 7420 6861 7665 2062 6565 6e20 7265 6164 t have been read │ │ │ │ +00031100: 2e0a 2020 2020 2049 7420 6973 2070 6f73 .. It is pos │ │ │ │ +00031110: 7369 626c 6520 746f 206d 6f64 6966 7920 sible to modify │ │ │ │ +00031120: 6120 6469 6769 7461 6c6c 7920 7369 676e a digitally sign │ │ │ │ +00031130: 6564 2065 6e76 6972 6f6e 6d65 6e74 2062 ed environment b │ │ │ │ +00031140: 6c6f 636b 2066 696c 650a 2020 2020 2066 lock file. f │ │ │ │ +00031150: 726f 6d20 7769 7468 696e 2047 5255 4220 rom within GRUB │ │ │ │ +00031160: 7573 696e 6720 7468 6973 2063 6f6d 6d61 using this comma │ │ │ │ +00031170: 6e64 2c20 7375 6368 2074 6861 7420 6974 nd, such that it │ │ │ │ +00031180: 7320 7369 676e 6174 7572 6520 7769 6c6c s signature will │ │ │ │ +00031190: 0a20 2020 2020 6e6f 206c 6f6e 6765 7220 . no longer │ │ │ │ +000311a0: 6265 2076 616c 6964 206f 6e20 7375 6273 be valid on subs │ │ │ │ +000311b0: 6571 7565 6e74 2062 6f6f 7473 2e20 2043 equent boots. C │ │ │ │ +000311c0: 6172 6520 7368 6f75 6c64 2062 6520 7461 are should be ta │ │ │ │ +000311d0: 6b65 6e20 696e 0a20 2020 2020 7375 6368 ken in. such │ │ │ │ +000311e0: 2061 6476 616e 6365 6420 636f 6e66 6967 advanced config │ │ │ │ +000311f0: 7572 6174 696f 6e73 2074 6f20 6176 6f69 urations to avoi │ │ │ │ +00031200: 6420 7265 6e64 6572 696e 6720 7468 6520 d rendering the │ │ │ │ +00031210: 7379 7374 656d 0a20 2020 2020 756e 626f system. unbo │ │ │ │ +00031220: 6f74 6162 6c65 2e20 202a 4e6f 7465 2055 otable. *Note U │ │ │ │ +00031230: 7369 6e67 2064 6967 6974 616c 2073 6967 sing digital sig │ │ │ │ +00031240: 6e61 7475 7265 733a 3a2c 2066 6f72 206d natures::, for m │ │ │ │ +00031250: 6f72 650a 2020 2020 2069 6e66 6f72 6d61 ore. informa │ │ │ │ +00031260: 7469 6f6e 2e0a 0a1f 0a46 696c 653a 2067 tion.....File: g │ │ │ │ +00031270: 7275 622e 696e 666f 2c20 204e 6f64 653a rub.info, Node: │ │ │ │ +00031280: 2073 6561 7263 682c 2020 4e65 7874 3a20 search, Next: │ │ │ │ +00031290: 7365 6e64 6b65 792c 2020 5072 6576 3a20 sendkey, Prev: │ │ │ │ +000312a0: 7361 7665 5f65 6e76 2c20 2055 703a 2043 save_env, Up: C │ │ │ │ +000312b0: 6f6d 6d61 6e64 2d6c 696e 6520 616e 6420 ommand-line and │ │ │ │ +000312c0: 6d65 6e75 2065 6e74 7279 2063 6f6d 6d61 menu entry comma │ │ │ │ +000312d0: 6e64 730a 0a31 362e 332e 3636 2073 6561 nds..16.3.66 sea │ │ │ │ +000312e0: 7263 680a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d rch.------------ │ │ │ │ +000312f0: 2d2d 0a0a 202d 2d20 436f 6d6d 616e 643a --.. -- Command: │ │ │ │ +00031300: 2073 6561 7263 6820 5b27 2d2d 6669 6c65 search ['--file │ │ │ │ +00031310: 277c 272d 2d6c 6162 656c 277c 272d 2d66 '|'--label'|'--f │ │ │ │ +00031320: 732d 7575 6964 275d 205b 272d 2d73 6574 s-uuid'] ['--set │ │ │ │ +00031330: 2720 5b76 6172 5d5d 0a20 2020 2020 2020 ' [var]]. │ │ │ │ +00031340: 2020 205b 272d 2d6e 6f2d 666c 6f70 7079 ['--no-floppy │ │ │ │ +00031350: 275d 206e 616d 650a 2020 2020 2053 6561 '] name. Sea │ │ │ │ +00031360: 7263 6820 6465 7669 6365 7320 6279 2066 rch devices by f │ │ │ │ +00031370: 696c 6520 2827 2d66 272c 2027 2d2d 6669 ile ('-f', '--fi │ │ │ │ +00031380: 6c65 2729 2c20 6669 6c65 7379 7374 656d le'), filesystem │ │ │ │ +00031390: 206c 6162 656c 2028 272d 6c27 2c0a 2020 label ('-l',. │ │ │ │ +000313a0: 2020 2027 2d2d 6c61 6265 6c27 292c 206f '--label'), o │ │ │ │ +000313b0: 7220 6669 6c65 7379 7374 656d 2055 5549 r filesystem UUI │ │ │ │ +000313c0: 4420 2827 2d75 272c 2027 2d2d 6673 2d75 D ('-u', '--fs-u │ │ │ │ +000313d0: 7569 6427 292e 0a0a 2020 2020 2049 6620 uid')... If │ │ │ │ +000313e0: 7468 6520 272d 2d73 6574 2720 6f70 7469 the '--set' opti │ │ │ │ +000313f0: 6f6e 2069 7320 7573 6564 2c20 7468 6520 on is used, the │ │ │ │ +00031400: 6669 7273 7420 6465 7669 6365 2066 6f75 first device fou │ │ │ │ +00031410: 6e64 2069 7320 7365 7420 6173 2074 6865 nd is set as the │ │ │ │ +00031420: 0a20 2020 2020 7661 6c75 6520 6f66 2065 . value of e │ │ │ │ +00031430: 6e76 6972 6f6e 6d65 6e74 2076 6172 6961 nvironment varia │ │ │ │ +00031440: 626c 6520 5641 522e 2020 5468 6520 6465 ble VAR. The de │ │ │ │ +00031450: 6661 756c 7420 7661 7269 6162 6c65 2069 fault variable i │ │ │ │ +00031460: 7320 2772 6f6f 7427 2e0a 0a20 2020 2020 s 'root'... │ │ │ │ +00031470: 5468 6520 272d 2d6e 6f2d 666c 6f70 7079 The '--no-floppy │ │ │ │ +00031480: 2720 6f70 7469 6f6e 2070 7265 7665 6e74 ' option prevent │ │ │ │ +00031490: 7320 7365 6172 6368 696e 6720 666c 6f70 s searching flop │ │ │ │ +000314a0: 7079 2064 6576 6963 6573 2c20 7768 6963 py devices, whic │ │ │ │ +000314b0: 680a 2020 2020 2063 616e 2062 6520 736c h. can be sl │ │ │ │ +000314c0: 6f77 2e0a 0a20 2020 2020 5468 6520 2773 ow... The 's │ │ │ │ +000314d0: 6561 7263 682e 6669 6c65 272c 2027 7365 earch.file', 'se │ │ │ │ +000314e0: 6172 6368 2e66 735f 6c61 6265 6c27 2c20 arch.fs_label', │ │ │ │ +000314f0: 616e 6420 2773 6561 7263 682e 6673 5f75 and 'search.fs_u │ │ │ │ +00031500: 7569 6427 2063 6f6d 6d61 6e64 730a 2020 uid' commands. │ │ │ │ +00031510: 2020 2061 7265 2061 6c69 6173 6573 2066 are aliases f │ │ │ │ +00031520: 6f72 2027 7365 6172 6368 202d 2d66 696c or 'search --fil │ │ │ │ +00031530: 6527 2c20 2773 6561 7263 6820 2d2d 6c61 e', 'search --la │ │ │ │ +00031540: 6265 6c27 2c20 616e 6420 2773 6561 7263 bel', and 'searc │ │ │ │ +00031550: 680a 2020 2020 202d 2d66 732d 7575 6964 h. --fs-uuid │ │ │ │ +00031560: 2720 7265 7370 6563 7469 7665 6c79 2e0a ' respectively.. │ │ │ │ +00031570: 0a1f 0a46 696c 653a 2067 7275 622e 696e ...File: grub.in │ │ │ │ +00031580: 666f 2c20 204e 6f64 653a 2073 656e 646b fo, Node: sendk │ │ │ │ +00031590: 6579 2c20 204e 6578 743a 2073 6574 2c20 ey, Next: set, │ │ │ │ +000315a0: 2050 7265 763a 2073 6561 7263 682c 2020 Prev: search, │ │ │ │ +000315b0: 5570 3a20 436f 6d6d 616e 642d 6c69 6e65 Up: Command-line │ │ │ │ +000315c0: 2061 6e64 206d 656e 7520 656e 7472 7920 and menu entry │ │ │ │ +000315d0: 636f 6d6d 616e 6473 0a0a 3136 2e33 2e36 commands..16.3.6 │ │ │ │ +000315e0: 3720 7365 6e64 6b65 790a 2d2d 2d2d 2d2d 7 sendkey.------ │ │ │ │ +000315f0: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2043 ---------.. -- C │ │ │ │ +00031600: 6f6d 6d61 6e64 3a20 7365 6e64 6b65 790a ommand: sendkey. │ │ │ │ +00031610: 2020 2020 2020 2020 2020 5b27 2d2d 6e75 ['--nu │ │ │ │ +00031620: 6d27 7c27 2d2d 6361 7073 277c 272d 2d73 m'|'--caps'|'--s │ │ │ │ +00031630: 6372 6f6c 6c27 7c27 2d2d 696e 7365 7274 croll'|'--insert │ │ │ │ +00031640: 277c 272d 2d70 6175 7365 277c 272d 2d6c '|'--pause'|'--l │ │ │ │ +00031650: 6566 742d 7368 6966 7427 7c27 2d2d 7269 eft-shift'|'--ri │ │ │ │ +00031660: 6768 742d 7368 6966 7427 7c27 2d2d 7379 ght-shift'|'--sy │ │ │ │ +00031670: 7372 7127 7c27 2d2d 6e75 6d6b 6579 277c srq'|'--numkey'| │ │ │ │ +00031680: 272d 2d63 6170 736b 6579 277c 272d 2d73 '--capskey'|'--s │ │ │ │ +00031690: 6372 6f6c 6c6b 6579 277c 272d 2d69 6e73 crollkey'|'--ins │ │ │ │ +000316a0: 6572 746b 6579 277c 272d 2d6c 6566 742d ertkey'|'--left- │ │ │ │ +000316b0: 616c 7427 7c27 2d2d 7269 6768 742d 616c alt'|'--right-al │ │ │ │ +000316c0: 7427 7c27 2d2d 6c65 6674 2d63 7472 6c27 t'|'--left-ctrl' │ │ │ │ +000316d0: 7c27 2d2d 7269 6768 742d 6374 726c 270a |'--right-ctrl'. │ │ │ │ +000316e0: 2020 2020 2020 2020 2020 276f 6e27 7c27 'on'|' │ │ │ │ +000316f0: 6f66 6627 5d2e 2e2e 205b 276e 6f2d 6c65 off']... ['no-le │ │ │ │ +00031700: 6427 5d20 6b65 7973 7472 6f6b 650a 2020 d'] keystroke. │ │ │ │ +00031710: 2020 2049 6e73 6572 7420 6b65 7973 7472 Insert keystr │ │ │ │ +00031720: 6f6b 6573 2069 6e74 6f20 7468 6520 6b65 okes into the ke │ │ │ │ +00031730: 7962 6f61 7264 2062 7566 6665 7220 7768 yboard buffer wh │ │ │ │ +00031740: 656e 2062 6f6f 7469 6e67 2e20 2053 6f6d en booting. Som │ │ │ │ +00031750: 6574 696d 6573 0a20 2020 2020 616e 206f etimes. an o │ │ │ │ +00031760: 7065 7261 7469 6e67 2073 7973 7465 6d20 perating system │ │ │ │ +00031770: 6f72 2063 6861 696e 6c6f 6164 6564 2062 or chainloaded b │ │ │ │ +00031780: 6f6f 7420 6c6f 6164 6572 2072 6571 7569 oot loader requi │ │ │ │ +00031790: 7265 7320 7061 7274 6963 756c 6172 0a20 res particular. │ │ │ │ +000317a0: 2020 2020 6b65 7973 2074 6f20 6265 2070 keys to be p │ │ │ │ +000317b0: 7265 7373 6564 3a20 666f 7220 6578 616d ressed: for exam │ │ │ │ +000317c0: 706c 652c 206f 6e65 206d 6967 6874 206e ple, one might n │ │ │ │ +000317d0: 6565 6420 746f 2070 7265 7373 2061 0a20 eed to press a. │ │ │ │ +000317e0: 2020 2020 7061 7274 6963 756c 6172 206b particular k │ │ │ │ +000317f0: 6579 2074 6f20 656e 7465 7220 2273 6166 ey to enter "saf │ │ │ │ +00031800: 6520 6d6f 6465 222c 206f 7220 7768 656e e mode", or when │ │ │ │ +00031810: 2063 6861 696e 6c6f 6164 696e 6720 616e chainloading an │ │ │ │ +00031820: 6f74 6865 720a 2020 2020 2062 6f6f 7420 other. boot │ │ │ │ +00031830: 6c6f 6164 6572 206f 6e65 206d 6967 6874 loader one might │ │ │ │ +00031840: 2073 656e 6420 6b65 7973 7472 6f6b 6573 send keystrokes │ │ │ │ +00031850: 2074 6f20 6974 2074 6f20 6e61 7669 6761 to it to naviga │ │ │ │ +00031860: 7465 2069 7473 206d 656e 752e 0a0a 2020 te its menu... │ │ │ │ +00031870: 2020 2059 6f75 206d 6179 2070 726f 7669 You may provi │ │ │ │ +00031880: 6465 2075 7020 746f 2031 3620 6b65 7973 de up to 16 keys │ │ │ │ +00031890: 7472 6f6b 6573 2028 7468 6520 6c65 6e67 trokes (the leng │ │ │ │ +000318a0: 7468 206f 6620 7468 6520 4249 4f53 0a20 th of the BIOS. │ │ │ │ +000318b0: 2020 2020 6b65 7962 6f61 7264 2062 7566 keyboard buf │ │ │ │ +000318c0: 6665 7229 2e20 204b 6579 7374 726f 6b65 fer). Keystroke │ │ │ │ +000318d0: 206e 616d 6573 206d 6179 2062 6520 7570 names may be up │ │ │ │ +000318e0: 7065 722d 6361 7365 206f 7220 6c6f 7765 per-case or lowe │ │ │ │ +000318f0: 722d 6361 7365 0a20 2020 2020 6c65 7474 r-case. lett │ │ │ │ +00031900: 6572 732c 2064 6967 6974 732c 206f 7220 ers, digits, or │ │ │ │ +00031910: 7461 6b65 6e20 6672 6f6d 2074 6865 2066 taken from the f │ │ │ │ +00031920: 6f6c 6c6f 7769 6e67 2074 6162 6c65 3a0a ollowing table:. │ │ │ │ +00031930: 0a20 2020 2020 4e61 6d65 2020 2020 2020 . Name │ │ │ │ 00031940: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00031950: 4b65 790a 2020 2020 202d 2d2d 2d2d 2d2d Key. ------- │ │ │ │ +00031950: 2020 2020 4b65 790a 2020 2020 202d 2d2d Key. --- │ │ │ │ 00031960: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ 00031970: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ 00031980: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ -00031990: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a20 2020 ------------. │ │ │ │ -000319a0: 2020 6573 6361 7065 2020 2020 2020 2020 escape │ │ │ │ +00031990: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ +000319a0: 0a20 2020 2020 6573 6361 7065 2020 2020 . escape │ │ │ │ 000319b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -000319c0: 4573 6361 7065 0a20 2020 2020 6578 636c Escape. excl │ │ │ │ -000319d0: 616d 2020 2020 2020 2020 2020 2020 2020 am │ │ │ │ -000319e0: 2020 2020 2020 2020 2020 210a 2020 2020 !. │ │ │ │ -000319f0: 2061 7420 2020 2020 2020 2020 2020 2020 at │ │ │ │ -00031a00: 2020 2020 2020 2020 2020 2020 2020 2040 @ │ │ │ │ -00031a10: 0a20 2020 2020 6e75 6d62 6572 7369 676e . numbersign │ │ │ │ -00031a20: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00031a30: 2020 2020 230a 2020 2020 2064 6f6c 6c61 #. dolla │ │ │ │ -00031a40: 7220 2020 2020 2020 2020 2020 2020 2020 r │ │ │ │ -00031a50: 2020 2020 2020 2020 2024 0a20 2020 2020 $. │ │ │ │ -00031a60: 7065 7263 656e 7420 2020 2020 2020 2020 percent │ │ │ │ -00031a70: 2020 2020 2020 2020 2020 2020 2020 250a %. │ │ │ │ -00031a80: 2020 2020 2063 6172 6574 2020 2020 2020 caret │ │ │ │ +000319c0: 2020 2020 4573 6361 7065 0a20 2020 2020 Escape. │ │ │ │ +000319d0: 6578 636c 616d 2020 2020 2020 2020 2020 exclam │ │ │ │ +000319e0: 2020 2020 2020 2020 2020 2020 2020 210a !. │ │ │ │ +000319f0: 2020 2020 2061 7420 2020 2020 2020 2020 at │ │ │ │ +00031a00: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00031a10: 2020 2040 0a20 2020 2020 6e75 6d62 6572 @. number │ │ │ │ +00031a20: 7369 676e 2020 2020 2020 2020 2020 2020 sign │ │ │ │ +00031a30: 2020 2020 2020 2020 230a 2020 2020 2064 #. d │ │ │ │ +00031a40: 6f6c 6c61 7220 2020 2020 2020 2020 2020 ollar │ │ │ │ +00031a50: 2020 2020 2020 2020 2020 2020 2024 0a20 $. │ │ │ │ +00031a60: 2020 2020 7065 7263 656e 7420 2020 2020 percent │ │ │ │ +00031a70: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00031a80: 2020 250a 2020 2020 2063 6172 6574 2020 %. caret │ │ │ │ 00031a90: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00031aa0: 2020 205e 0a20 2020 2020 616d 7065 7273 ^. ampers │ │ │ │ -00031ab0: 616e 6420 2020 2020 2020 2020 2020 2020 and │ │ │ │ -00031ac0: 2020 2020 2020 2020 260a 2020 2020 2061 &. a │ │ │ │ -00031ad0: 7374 6572 6973 6b20 2020 2020 2020 2020 sterisk │ │ │ │ -00031ae0: 2020 2020 2020 2020 2020 2020 202a 0a20 *. │ │ │ │ -00031af0: 2020 2020 7061 7265 6e6c 6566 7420 2020 parenleft │ │ │ │ -00031b00: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00031b10: 2020 280a 2020 2020 2070 6172 656e 7269 (. parenri │ │ │ │ -00031b20: 6768 7420 2020 2020 2020 2020 2020 2020 ght │ │ │ │ -00031b30: 2020 2020 2020 2029 0a20 2020 2020 6d69 ). mi │ │ │ │ -00031b40: 6e75 7320 2020 2020 2020 2020 2020 2020 nus │ │ │ │ -00031b50: 2020 2020 2020 2020 2020 2020 2d0a 2020 -. │ │ │ │ -00031b60: 2020 2075 6e64 6572 7363 6f72 6520 2020 underscore │ │ │ │ -00031b70: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00031b80: 205f 0a20 2020 2020 6571 7561 6c20 2020 _. equal │ │ │ │ -00031b90: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00031ba0: 2020 2020 2020 3d0a 2020 2020 2070 6c75 =. plu │ │ │ │ -00031bb0: 7320 2020 2020 2020 2020 2020 2020 2020 s │ │ │ │ -00031bc0: 2020 2020 2020 2020 2020 202b 0a20 2020 +. │ │ │ │ -00031bd0: 2020 6261 636b 7370 6163 6520 2020 2020 backspace │ │ │ │ +00031aa0: 2020 2020 2020 205e 0a20 2020 2020 616d ^. am │ │ │ │ +00031ab0: 7065 7273 616e 6420 2020 2020 2020 2020 persand │ │ │ │ +00031ac0: 2020 2020 2020 2020 2020 2020 260a 2020 &. │ │ │ │ +00031ad0: 2020 2061 7374 6572 6973 6b20 2020 2020 asterisk │ │ │ │ +00031ae0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00031af0: 202a 0a20 2020 2020 7061 7265 6e6c 6566 *. parenlef │ │ │ │ +00031b00: 7420 2020 2020 2020 2020 2020 2020 2020 t │ │ │ │ +00031b10: 2020 2020 2020 280a 2020 2020 2070 6172 (. par │ │ │ │ +00031b20: 656e 7269 6768 7420 2020 2020 2020 2020 enright │ │ │ │ +00031b30: 2020 2020 2020 2020 2020 2029 0a20 2020 ). │ │ │ │ +00031b40: 2020 6d69 6e75 7320 2020 2020 2020 2020 minus │ │ │ │ +00031b50: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00031b60: 2d0a 2020 2020 2075 6e64 6572 7363 6f72 -. underscor │ │ │ │ +00031b70: 6520 2020 2020 2020 2020 2020 2020 2020 e │ │ │ │ +00031b80: 2020 2020 205f 0a20 2020 2020 6571 7561 _. equa │ │ │ │ +00031b90: 6c20 2020 2020 2020 2020 2020 2020 2020 l │ │ │ │ +00031ba0: 2020 2020 2020 2020 2020 3d0a 2020 2020 =. │ │ │ │ +00031bb0: 2070 6c75 7320 2020 2020 2020 2020 2020 plus │ │ │ │ +00031bc0: 2020 2020 2020 2020 2020 2020 2020 202b + │ │ │ │ +00031bd0: 0a20 2020 2020 6261 636b 7370 6163 6520 . backspace │ │ │ │ 00031be0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00031bf0: 4261 636b 7370 6163 650a 2020 2020 2074 Backspace. t │ │ │ │ -00031c00: 6162 2020 2020 2020 2020 2020 2020 2020 ab │ │ │ │ -00031c10: 2020 2020 2020 2020 2020 2020 2054 6162 Tab │ │ │ │ -00031c20: 0a20 2020 2020 6272 6163 6b65 746c 6566 . bracketlef │ │ │ │ -00031c30: 7420 2020 2020 2020 2020 2020 2020 2020 t │ │ │ │ -00031c40: 2020 2020 5b0a 2020 2020 2062 7261 6365 [. brace │ │ │ │ -00031c50: 6c65 6674 2020 2020 2020 2020 2020 2020 left │ │ │ │ -00031c60: 2020 2020 2020 2020 207b 0a20 2020 2020 {. │ │ │ │ -00031c70: 6272 6163 6b65 7472 6967 6874 2020 2020 bracketright │ │ │ │ -00031c80: 2020 2020 2020 2020 2020 2020 2020 5d0a ]. │ │ │ │ -00031c90: 2020 2020 2062 7261 6365 7269 6768 7420 braceright │ │ │ │ -00031ca0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00031cb0: 2020 207d 0a20 2020 2020 656e 7465 7220 }. enter │ │ │ │ -00031cc0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00031cd0: 2020 2020 2020 2020 456e 7465 720a 2020 Enter. │ │ │ │ -00031ce0: 2020 2063 6f6e 7472 6f6c 2020 2020 2020 control │ │ │ │ +00031bf0: 2020 2020 4261 636b 7370 6163 650a 2020 Backspace. │ │ │ │ +00031c00: 2020 2074 6162 2020 2020 2020 2020 2020 tab │ │ │ │ +00031c10: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00031c20: 2054 6162 0a20 2020 2020 6272 6163 6b65 Tab. bracke │ │ │ │ +00031c30: 746c 6566 7420 2020 2020 2020 2020 2020 tleft │ │ │ │ +00031c40: 2020 2020 2020 2020 5b0a 2020 2020 2062 [. b │ │ │ │ +00031c50: 7261 6365 6c65 6674 2020 2020 2020 2020 raceleft │ │ │ │ +00031c60: 2020 2020 2020 2020 2020 2020 207b 0a20 {. │ │ │ │ +00031c70: 2020 2020 6272 6163 6b65 7472 6967 6874 bracketright │ │ │ │ +00031c80: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00031c90: 2020 5d0a 2020 2020 2062 7261 6365 7269 ]. braceri │ │ │ │ +00031ca0: 6768 7420 2020 2020 2020 2020 2020 2020 ght │ │ │ │ +00031cb0: 2020 2020 2020 207d 0a20 2020 2020 656e }. en │ │ │ │ +00031cc0: 7465 7220 2020 2020 2020 2020 2020 2020 ter │ │ │ │ +00031cd0: 2020 2020 2020 2020 2020 2020 456e 7465 Ente │ │ │ │ +00031ce0: 720a 2020 2020 2063 6f6e 7472 6f6c 2020 r. control │ │ │ │ 00031cf0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00031d00: 2070 7265 7373 2061 6e64 2072 656c 6561 press and relea │ │ │ │ -00031d10: 7365 2043 6f6e 7472 6f6c 0a20 2020 2020 se Control. │ │ │ │ -00031d20: 7365 6d69 636f 6c6f 6e20 2020 2020 2020 semicolon │ │ │ │ -00031d30: 2020 2020 2020 2020 2020 2020 2020 3b0a ;. │ │ │ │ -00031d40: 2020 2020 2063 6f6c 6f6e 2020 2020 2020 colon │ │ │ │ +00031d00: 2020 2020 2070 7265 7373 2061 6e64 2072 press and r │ │ │ │ +00031d10: 656c 6561 7365 2043 6f6e 7472 6f6c 0a20 elease Control. │ │ │ │ +00031d20: 2020 2020 7365 6d69 636f 6c6f 6e20 2020 semicolon │ │ │ │ +00031d30: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00031d40: 2020 3b0a 2020 2020 2063 6f6c 6f6e 2020 ;. colon │ │ │ │ 00031d50: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00031d60: 2020 203a 0a20 2020 2020 7175 6f74 6520 :. quote │ │ │ │ -00031d70: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00031d80: 2020 2020 2020 2020 270a 2020 2020 2064 '. d │ │ │ │ -00031d90: 6f75 626c 6571 756f 7465 2020 2020 2020 oublequote │ │ │ │ -00031da0: 2020 2020 2020 2020 2020 2020 2022 0a20 ". │ │ │ │ -00031db0: 2020 2020 6261 636b 7175 6f74 6520 2020 backquote │ │ │ │ -00031dc0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00031dd0: 2020 270a 2020 2020 2074 696c 6465 2020 '. tilde │ │ │ │ -00031de0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00031df0: 2020 2020 2020 207e 0a20 2020 2020 7368 ~. sh │ │ │ │ -00031e00: 6966 7420 2020 2020 2020 2020 2020 2020 ift │ │ │ │ -00031e10: 2020 2020 2020 2020 2020 2020 7072 6573 pres │ │ │ │ -00031e20: 7320 616e 6420 7265 6c65 6173 6520 6c65 s and release le │ │ │ │ -00031e30: 6674 2053 6869 6674 0a20 2020 2020 6261 ft Shift. ba │ │ │ │ -00031e40: 636b 736c 6173 6820 2020 2020 2020 2020 ckslash │ │ │ │ -00031e50: 2020 2020 2020 2020 2020 2020 5c0a 2020 \. │ │ │ │ -00031e60: 2020 2062 6172 2020 2020 2020 2020 2020 bar │ │ │ │ +00031d60: 2020 2020 2020 203a 0a20 2020 2020 7175 :. qu │ │ │ │ +00031d70: 6f74 6520 2020 2020 2020 2020 2020 2020 ote │ │ │ │ +00031d80: 2020 2020 2020 2020 2020 2020 270a 2020 '. │ │ │ │ +00031d90: 2020 2064 6f75 626c 6571 756f 7465 2020 doublequote │ │ │ │ +00031da0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00031db0: 2022 0a20 2020 2020 6261 636b 7175 6f74 ". backquot │ │ │ │ +00031dc0: 6520 2020 2020 2020 2020 2020 2020 2020 e │ │ │ │ +00031dd0: 2020 2020 2020 270a 2020 2020 2074 696c '. til │ │ │ │ +00031de0: 6465 2020 2020 2020 2020 2020 2020 2020 de │ │ │ │ +00031df0: 2020 2020 2020 2020 2020 207e 0a20 2020 ~. │ │ │ │ +00031e00: 2020 7368 6966 7420 2020 2020 2020 2020 shift │ │ │ │ +00031e10: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00031e20: 7072 6573 7320 616e 6420 7265 6c65 6173 press and releas │ │ │ │ +00031e30: 6520 6c65 6674 2053 6869 6674 0a20 2020 e left Shift. │ │ │ │ +00031e40: 2020 6261 636b 736c 6173 6820 2020 2020 backslash │ │ │ │ +00031e50: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00031e60: 5c0a 2020 2020 2062 6172 2020 2020 2020 \. bar │ │ │ │ 00031e70: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00031e80: 207c 0a20 2020 2020 636f 6d6d 6120 2020 |. comma │ │ │ │ -00031e90: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00031ea0: 2020 2020 2020 2c0a 2020 2020 206c 6573 ,. les │ │ │ │ -00031eb0: 7320 2020 2020 2020 2020 2020 2020 2020 s │ │ │ │ -00031ec0: 2020 2020 2020 2020 2020 203c 0a20 2020 <. │ │ │ │ -00031ed0: 2020 7065 7269 6f64 2020 2020 2020 2020 period │ │ │ │ +00031e80: 2020 2020 207c 0a20 2020 2020 636f 6d6d |. comm │ │ │ │ +00031e90: 6120 2020 2020 2020 2020 2020 2020 2020 a │ │ │ │ +00031ea0: 2020 2020 2020 2020 2020 2c0a 2020 2020 ,. │ │ │ │ +00031eb0: 206c 6573 7320 2020 2020 2020 2020 2020 less │ │ │ │ +00031ec0: 2020 2020 2020 2020 2020 2020 2020 203c < │ │ │ │ +00031ed0: 0a20 2020 2020 7065 7269 6f64 2020 2020 . period │ │ │ │ 00031ee0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00031ef0: 2e0a 2020 2020 2067 7265 6174 6572 2020 .. greater │ │ │ │ -00031f00: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00031f10: 2020 2020 203e 0a20 2020 2020 736c 6173 >. slas │ │ │ │ -00031f20: 6820 2020 2020 2020 2020 2020 2020 2020 h │ │ │ │ -00031f30: 2020 2020 2020 2020 2020 2f0a 2020 2020 /. │ │ │ │ -00031f40: 2071 7565 7374 696f 6e20 2020 2020 2020 question │ │ │ │ -00031f50: 2020 2020 2020 2020 2020 2020 2020 203f ? │ │ │ │ -00031f60: 0a20 2020 2020 7273 6869 6674 2020 2020 . rshift │ │ │ │ +00031ef0: 2020 2020 2e0a 2020 2020 2067 7265 6174 .. great │ │ │ │ +00031f00: 6572 2020 2020 2020 2020 2020 2020 2020 er │ │ │ │ +00031f10: 2020 2020 2020 2020 203e 0a20 2020 2020 >. │ │ │ │ +00031f20: 736c 6173 6820 2020 2020 2020 2020 2020 slash │ │ │ │ +00031f30: 2020 2020 2020 2020 2020 2020 2020 2f0a /. │ │ │ │ +00031f40: 2020 2020 2071 7565 7374 696f 6e20 2020 question │ │ │ │ +00031f50: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00031f60: 2020 203f 0a20 2020 2020 7273 6869 6674 ?. rshift │ │ │ │ 00031f70: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00031f80: 2020 2020 7072 6573 7320 616e 6420 7265 press and re │ │ │ │ -00031f90: 6c65 6173 6520 7269 6768 7420 5368 6966 lease right Shif │ │ │ │ -00031fa0: 740a 2020 2020 2061 6c74 2020 2020 2020 t. alt │ │ │ │ +00031f80: 2020 2020 2020 2020 7072 6573 7320 616e press an │ │ │ │ +00031f90: 6420 7265 6c65 6173 6520 7269 6768 7420 d release right │ │ │ │ +00031fa0: 5368 6966 740a 2020 2020 2061 6c74 2020 Shift. alt │ │ │ │ 00031fb0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00031fc0: 2020 2020 2070 7265 7373 2061 6e64 2072 press and r │ │ │ │ -00031fd0: 656c 6561 7365 2041 6c74 0a20 2020 2020 elease Alt. │ │ │ │ -00031fe0: 7370 6163 6520 2020 2020 2020 2020 2020 space │ │ │ │ -00031ff0: 2020 2020 2020 2020 2020 2020 2020 7370 sp │ │ │ │ -00032000: 6163 6520 6261 720a 2020 2020 2063 6170 ace bar. cap │ │ │ │ -00032010: 736c 6f63 6b20 2020 2020 2020 2020 2020 slock │ │ │ │ -00032020: 2020 2020 2020 2020 2020 2043 6170 7320 Caps │ │ │ │ -00032030: 4c6f 636b 0a20 2020 2020 4631 2020 2020 Lock. F1 │ │ │ │ +00031fc0: 2020 2020 2020 2020 2070 7265 7373 2061 press a │ │ │ │ +00031fd0: 6e64 2072 656c 6561 7365 2041 6c74 0a20 nd release Alt. │ │ │ │ +00031fe0: 2020 2020 7370 6163 6520 2020 2020 2020 space │ │ │ │ +00031ff0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00032000: 2020 7370 6163 6520 6261 720a 2020 2020 space bar. │ │ │ │ +00032010: 2063 6170 736c 6f63 6b20 2020 2020 2020 capslock │ │ │ │ +00032020: 2020 2020 2020 2020 2020 2020 2020 2043 C │ │ │ │ +00032030: 6170 7320 4c6f 636b 0a20 2020 2020 4631 aps Lock. F1 │ │ │ │ 00032040: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00032050: 2020 2020 2020 2020 4631 0a20 2020 2020 F1. │ │ │ │ -00032060: 4632 2020 2020 2020 2020 2020 2020 2020 F2 │ │ │ │ -00032070: 2020 2020 2020 2020 2020 2020 2020 4632 F2 │ │ │ │ -00032080: 0a20 2020 2020 4633 2020 2020 2020 2020 . F3 │ │ │ │ +00032050: 2020 2020 2020 2020 2020 2020 4631 0a20 F1. │ │ │ │ +00032060: 2020 2020 4632 2020 2020 2020 2020 2020 F2 │ │ │ │ +00032070: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00032080: 2020 4632 0a20 2020 2020 4633 2020 2020 F2. F3 │ │ │ │ 00032090: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -000320a0: 2020 2020 4633 0a20 2020 2020 4634 2020 F3. F4 │ │ │ │ -000320b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -000320c0: 2020 2020 2020 2020 2020 4634 0a20 2020 F4. │ │ │ │ -000320d0: 2020 4635 2020 2020 2020 2020 2020 2020 F5 │ │ │ │ +000320a0: 2020 2020 2020 2020 4633 0a20 2020 2020 F3. │ │ │ │ +000320b0: 4634 2020 2020 2020 2020 2020 2020 2020 F4 │ │ │ │ +000320c0: 2020 2020 2020 2020 2020 2020 2020 4634 F4 │ │ │ │ +000320d0: 0a20 2020 2020 4635 2020 2020 2020 2020 . F5 │ │ │ │ 000320e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -000320f0: 4635 0a20 2020 2020 4636 2020 2020 2020 F5. F6 │ │ │ │ +000320f0: 2020 2020 4635 0a20 2020 2020 4636 2020 F5. F6 │ │ │ │ 00032100: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00032110: 2020 2020 2020 4636 0a20 2020 2020 4637 F6. F7 │ │ │ │ -00032120: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00032130: 2020 2020 2020 2020 2020 2020 4637 0a20 F7. │ │ │ │ -00032140: 2020 2020 4638 2020 2020 2020 2020 2020 F8 │ │ │ │ +00032110: 2020 2020 2020 2020 2020 4636 0a20 2020 F6. │ │ │ │ +00032120: 2020 4637 2020 2020 2020 2020 2020 2020 F7 │ │ │ │ +00032130: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00032140: 4637 0a20 2020 2020 4638 2020 2020 2020 F7. F8 │ │ │ │ 00032150: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00032160: 2020 4638 0a20 2020 2020 4639 2020 2020 F8. F9 │ │ │ │ +00032160: 2020 2020 2020 4638 0a20 2020 2020 4639 F8. F9 │ │ │ │ 00032170: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00032180: 2020 2020 2020 2020 4639 0a20 2020 2020 F9. │ │ │ │ -00032190: 4631 3020 2020 2020 2020 2020 2020 2020 F10 │ │ │ │ -000321a0: 2020 2020 2020 2020 2020 2020 2020 4631 F1 │ │ │ │ -000321b0: 300a 2020 2020 2046 3131 2020 2020 2020 0. F11 │ │ │ │ +00032180: 2020 2020 2020 2020 2020 2020 4639 0a20 F9. │ │ │ │ +00032190: 2020 2020 4631 3020 2020 2020 2020 2020 F10 │ │ │ │ +000321a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +000321b0: 2020 4631 300a 2020 2020 2046 3131 2020 F10. F11 │ │ │ │ 000321c0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -000321d0: 2020 2020 2046 3131 0a20 2020 2020 4631 F11. F1 │ │ │ │ -000321e0: 3220 2020 2020 2020 2020 2020 2020 2020 2 │ │ │ │ -000321f0: 2020 2020 2020 2020 2020 2020 4631 320a F12. │ │ │ │ -00032200: 2020 2020 206e 756d 3120 2020 2020 2020 num1 │ │ │ │ +000321d0: 2020 2020 2020 2020 2046 3131 0a20 2020 F11. │ │ │ │ +000321e0: 2020 4631 3220 2020 2020 2020 2020 2020 F12 │ │ │ │ +000321f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00032200: 4631 320a 2020 2020 206e 756d 3120 2020 F12. num1 │ │ │ │ 00032210: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00032220: 2020 2031 2028 6e75 6d65 7269 6320 6b65 1 (numeric ke │ │ │ │ -00032230: 7970 6164 290a 2020 2020 206e 756d 3220 ypad). num2 │ │ │ │ -00032240: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00032250: 2020 2020 2020 2020 2032 2028 6e75 6d65 2 (nume │ │ │ │ -00032260: 7269 6320 6b65 7970 6164 290a 2020 2020 ric keypad). │ │ │ │ -00032270: 206e 756d 3320 2020 2020 2020 2020 2020 num3 │ │ │ │ -00032280: 2020 2020 2020 2020 2020 2020 2020 2033 3 │ │ │ │ -00032290: 2028 6e75 6d65 7269 6320 6b65 7970 6164 (numeric keypad │ │ │ │ -000322a0: 290a 2020 2020 206e 756d 3420 2020 2020 ). num4 │ │ │ │ +00032220: 2020 2020 2020 2031 2028 6e75 6d65 7269 1 (numeri │ │ │ │ +00032230: 6320 6b65 7970 6164 290a 2020 2020 206e c keypad). n │ │ │ │ +00032240: 756d 3220 2020 2020 2020 2020 2020 2020 um2 │ │ │ │ +00032250: 2020 2020 2020 2020 2020 2020 2032 2028 2 ( │ │ │ │ +00032260: 6e75 6d65 7269 6320 6b65 7970 6164 290a numeric keypad). │ │ │ │ +00032270: 2020 2020 206e 756d 3320 2020 2020 2020 num3 │ │ │ │ +00032280: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00032290: 2020 2033 2028 6e75 6d65 7269 6320 6b65 3 (numeric ke │ │ │ │ +000322a0: 7970 6164 290a 2020 2020 206e 756d 3420 ypad). num4 │ │ │ │ 000322b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -000322c0: 2020 2020 2034 2028 6e75 6d65 7269 6320 4 (numeric │ │ │ │ -000322d0: 6b65 7970 6164 290a 2020 2020 206e 756d keypad). num │ │ │ │ -000322e0: 3520 2020 2020 2020 2020 2020 2020 2020 5 │ │ │ │ -000322f0: 2020 2020 2020 2020 2020 2035 2028 6e75 5 (nu │ │ │ │ -00032300: 6d65 7269 6320 6b65 7970 6164 290a 2020 meric keypad). │ │ │ │ -00032310: 2020 206e 756d 3620 2020 2020 2020 2020 num6 │ │ │ │ +000322c0: 2020 2020 2020 2020 2034 2028 6e75 6d65 4 (nume │ │ │ │ +000322d0: 7269 6320 6b65 7970 6164 290a 2020 2020 ric keypad). │ │ │ │ +000322e0: 206e 756d 3520 2020 2020 2020 2020 2020 num5 │ │ │ │ +000322f0: 2020 2020 2020 2020 2020 2020 2020 2035 5 │ │ │ │ +00032300: 2028 6e75 6d65 7269 6320 6b65 7970 6164 (numeric keypad │ │ │ │ +00032310: 290a 2020 2020 206e 756d 3620 2020 2020 ). num6 │ │ │ │ 00032320: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00032330: 2036 2028 6e75 6d65 7269 6320 6b65 7970 6 (numeric keyp │ │ │ │ -00032340: 6164 290a 2020 2020 206e 756d 3720 2020 ad). num7 │ │ │ │ -00032350: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00032360: 2020 2020 2020 2037 2028 6e75 6d65 7269 7 (numeri │ │ │ │ -00032370: 6320 6b65 7970 6164 290a 2020 2020 206e c keypad). n │ │ │ │ -00032380: 756d 3820 2020 2020 2020 2020 2020 2020 um8 │ │ │ │ -00032390: 2020 2020 2020 2020 2020 2020 2038 2028 8 ( │ │ │ │ -000323a0: 6e75 6d65 7269 6320 6b65 7970 6164 290a numeric keypad). │ │ │ │ -000323b0: 2020 2020 206e 756d 3920 2020 2020 2020 num9 │ │ │ │ +00032330: 2020 2020 2036 2028 6e75 6d65 7269 6320 6 (numeric │ │ │ │ +00032340: 6b65 7970 6164 290a 2020 2020 206e 756d keypad). num │ │ │ │ +00032350: 3720 2020 2020 2020 2020 2020 2020 2020 7 │ │ │ │ +00032360: 2020 2020 2020 2020 2020 2037 2028 6e75 7 (nu │ │ │ │ +00032370: 6d65 7269 6320 6b65 7970 6164 290a 2020 meric keypad). │ │ │ │ +00032380: 2020 206e 756d 3820 2020 2020 2020 2020 num8 │ │ │ │ +00032390: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +000323a0: 2038 2028 6e75 6d65 7269 6320 6b65 7970 8 (numeric keyp │ │ │ │ +000323b0: 6164 290a 2020 2020 206e 756d 3920 2020 ad). num9 │ │ │ │ 000323c0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -000323d0: 2020 2039 2028 6e75 6d65 7269 6320 6b65 9 (numeric ke │ │ │ │ -000323e0: 7970 6164 290a 2020 2020 206e 756d 3020 ypad). num0 │ │ │ │ -000323f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00032400: 2020 2020 2020 2020 2030 2028 6e75 6d65 0 (nume │ │ │ │ -00032410: 7269 6320 6b65 7970 6164 290a 2020 2020 ric keypad). │ │ │ │ -00032420: 206e 756d 7065 7269 6f64 2020 2020 2020 numperiod │ │ │ │ -00032430: 2020 2020 2020 2020 2020 2020 2020 202e . │ │ │ │ -00032440: 2020 286e 756d 6572 6963 206b 6579 7061 (numeric keypa │ │ │ │ -00032450: 6429 0a20 2020 2020 6e75 6d65 6e64 2020 d). numend │ │ │ │ -00032460: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00032470: 2020 2020 2020 456e 6420 286e 756d 6572 End (numer │ │ │ │ -00032480: 6963 206b 6579 7061 6429 0a20 2020 2020 ic keypad). │ │ │ │ -00032490: 6e75 6d64 6f77 6e20 2020 2020 2020 2020 numdown │ │ │ │ -000324a0: 2020 2020 2020 2020 2020 2020 2020 446f Do │ │ │ │ -000324b0: 776e 2028 6e75 6d65 7269 6320 6b65 7970 wn (numeric keyp │ │ │ │ -000324c0: 6164 290a 2020 2020 206e 756d 7067 646f ad). numpgdo │ │ │ │ -000324d0: 776e 2020 2020 2020 2020 2020 2020 2020 wn │ │ │ │ -000324e0: 2020 2020 2020 2050 6167 6520 446f 776e Page Down │ │ │ │ -000324f0: 2028 6e75 6d65 7269 6320 6b65 7970 6164 (numeric keypad │ │ │ │ -00032500: 290a 2020 2020 206e 756d 6c65 6674 2020 ). numleft │ │ │ │ -00032510: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00032520: 2020 2020 204c 6566 7420 286e 756d 6572 Left (numer │ │ │ │ -00032530: 6963 206b 6579 7061 6429 0a20 2020 2020 ic keypad). │ │ │ │ -00032540: 6e75 6d63 656e 7465 7220 2020 2020 2020 numcenter │ │ │ │ -00032550: 2020 2020 2020 2020 2020 2020 2020 3520 5 │ │ │ │ -00032560: 7769 7468 204e 756d 204c 6f63 6b20 696e with Num Lock in │ │ │ │ -00032570: 6163 7469 7665 2028 6e75 6d65 7269 630a active (numeric. │ │ │ │ -00032580: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +000323d0: 2020 2020 2020 2039 2028 6e75 6d65 7269 9 (numeri │ │ │ │ +000323e0: 6320 6b65 7970 6164 290a 2020 2020 206e c keypad). n │ │ │ │ +000323f0: 756d 3020 2020 2020 2020 2020 2020 2020 um0 │ │ │ │ +00032400: 2020 2020 2020 2020 2020 2020 2030 2028 0 ( │ │ │ │ +00032410: 6e75 6d65 7269 6320 6b65 7970 6164 290a numeric keypad). │ │ │ │ +00032420: 2020 2020 206e 756d 7065 7269 6f64 2020 numperiod │ │ │ │ +00032430: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00032440: 2020 202e 2020 286e 756d 6572 6963 206b . (numeric k │ │ │ │ +00032450: 6579 7061 6429 0a20 2020 2020 6e75 6d65 eypad). nume │ │ │ │ +00032460: 6e64 2020 2020 2020 2020 2020 2020 2020 nd │ │ │ │ +00032470: 2020 2020 2020 2020 2020 456e 6420 286e End (n │ │ │ │ +00032480: 756d 6572 6963 206b 6579 7061 6429 0a20 umeric keypad). │ │ │ │ +00032490: 2020 2020 6e75 6d64 6f77 6e20 2020 2020 numdown │ │ │ │ +000324a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +000324b0: 2020 446f 776e 2028 6e75 6d65 7269 6320 Down (numeric │ │ │ │ +000324c0: 6b65 7970 6164 290a 2020 2020 206e 756d keypad). num │ │ │ │ +000324d0: 7067 646f 776e 2020 2020 2020 2020 2020 pgdown │ │ │ │ +000324e0: 2020 2020 2020 2020 2020 2050 6167 6520 Page │ │ │ │ +000324f0: 446f 776e 2028 6e75 6d65 7269 6320 6b65 Down (numeric ke │ │ │ │ +00032500: 7970 6164 290a 2020 2020 206e 756d 6c65 ypad). numle │ │ │ │ +00032510: 6674 2020 2020 2020 2020 2020 2020 2020 ft │ │ │ │ +00032520: 2020 2020 2020 2020 204c 6566 7420 286e Left (n │ │ │ │ +00032530: 756d 6572 6963 206b 6579 7061 6429 0a20 umeric keypad). │ │ │ │ +00032540: 2020 2020 6e75 6d63 656e 7465 7220 2020 numcenter │ │ │ │ +00032550: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00032560: 2020 3520 7769 7468 204e 756d 204c 6f63 5 with Num Loc │ │ │ │ +00032570: 6b20 696e 6163 7469 7665 2028 6e75 6d65 k inactive (nume │ │ │ │ +00032580: 7269 630a 2020 2020 2020 2020 2020 2020 ric. │ │ │ │ 00032590: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -000325a0: 2020 206b 6579 7061 6429 0a20 2020 2020 keypad). │ │ │ │ -000325b0: 6e75 6d72 6967 6874 2020 2020 2020 2020 numright │ │ │ │ -000325c0: 2020 2020 2020 2020 2020 2020 2020 5269 Ri │ │ │ │ -000325d0: 6768 7420 286e 756d 6572 6963 206b 6579 ght (numeric key │ │ │ │ -000325e0: 7061 6429 0a20 2020 2020 6e75 6d68 6f6d pad). numhom │ │ │ │ -000325f0: 6520 2020 2020 2020 2020 2020 2020 2020 e │ │ │ │ -00032600: 2020 2020 2020 2020 486f 6d65 2028 6e75 Home (nu │ │ │ │ -00032610: 6d65 7269 6320 6b65 7970 6164 290a 2020 meric keypad). │ │ │ │ -00032620: 2020 206e 756d 7570 2020 2020 2020 2020 numup │ │ │ │ +000325a0: 2020 2020 2020 206b 6579 7061 6429 0a20 keypad). │ │ │ │ +000325b0: 2020 2020 6e75 6d72 6967 6874 2020 2020 numright │ │ │ │ +000325c0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +000325d0: 2020 5269 6768 7420 286e 756d 6572 6963 Right (numeric │ │ │ │ +000325e0: 206b 6579 7061 6429 0a20 2020 2020 6e75 keypad). nu │ │ │ │ +000325f0: 6d68 6f6d 6520 2020 2020 2020 2020 2020 mhome │ │ │ │ +00032600: 2020 2020 2020 2020 2020 2020 486f 6d65 Home │ │ │ │ +00032610: 2028 6e75 6d65 7269 6320 6b65 7970 6164 (numeric keypad │ │ │ │ +00032620: 290a 2020 2020 206e 756d 7570 2020 2020 ). numup │ │ │ │ 00032630: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00032640: 2055 7020 286e 756d 6572 6963 206b 6579 Up (numeric key │ │ │ │ -00032650: 7061 6429 0a20 2020 2020 6e75 6d70 6775 pad). numpgu │ │ │ │ -00032660: 7020 2020 2020 2020 2020 2020 2020 2020 p │ │ │ │ -00032670: 2020 2020 2020 2020 5061 6765 2055 7020 Page Up │ │ │ │ -00032680: 286e 756d 6572 6963 206b 6579 7061 6429 (numeric keypad) │ │ │ │ -00032690: 0a20 2020 2020 6e75 6d69 6e73 6572 7420 . numinsert │ │ │ │ -000326a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -000326b0: 2020 2020 496e 7365 7274 2028 6e75 6d65 Insert (nume │ │ │ │ -000326c0: 7269 6320 6b65 7970 6164 290a 2020 2020 ric keypad). │ │ │ │ -000326d0: 206e 756d 6465 6c65 7465 2020 2020 2020 numdelete │ │ │ │ -000326e0: 2020 2020 2020 2020 2020 2020 2020 2044 D │ │ │ │ -000326f0: 656c 6574 6520 286e 756d 6572 6963 206b elete (numeric k │ │ │ │ -00032700: 6579 7061 6429 0a20 2020 2020 6e75 6d61 eypad). numa │ │ │ │ -00032710: 7374 6572 6973 6b20 2020 2020 2020 2020 sterisk │ │ │ │ -00032720: 2020 2020 2020 2020 2020 2a20 286e 756d * (num │ │ │ │ -00032730: 6572 6963 206b 6579 7061 6429 0a20 2020 eric keypad). │ │ │ │ -00032740: 2020 6e75 6d6d 696e 7573 2020 2020 2020 numminus │ │ │ │ +00032640: 2020 2020 2055 7020 286e 756d 6572 6963 Up (numeric │ │ │ │ +00032650: 206b 6579 7061 6429 0a20 2020 2020 6e75 keypad). nu │ │ │ │ +00032660: 6d70 6775 7020 2020 2020 2020 2020 2020 mpgup │ │ │ │ +00032670: 2020 2020 2020 2020 2020 2020 5061 6765 Page │ │ │ │ +00032680: 2055 7020 286e 756d 6572 6963 206b 6579 Up (numeric key │ │ │ │ +00032690: 7061 6429 0a20 2020 2020 6e75 6d69 6e73 pad). numins │ │ │ │ +000326a0: 6572 7420 2020 2020 2020 2020 2020 2020 ert │ │ │ │ +000326b0: 2020 2020 2020 2020 496e 7365 7274 2028 Insert ( │ │ │ │ +000326c0: 6e75 6d65 7269 6320 6b65 7970 6164 290a numeric keypad). │ │ │ │ +000326d0: 2020 2020 206e 756d 6465 6c65 7465 2020 numdelete │ │ │ │ +000326e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +000326f0: 2020 2044 656c 6574 6520 286e 756d 6572 Delete (numer │ │ │ │ +00032700: 6963 206b 6579 7061 6429 0a20 2020 2020 ic keypad). │ │ │ │ +00032710: 6e75 6d61 7374 6572 6973 6b20 2020 2020 numasterisk │ │ │ │ +00032720: 2020 2020 2020 2020 2020 2020 2020 2a20 * │ │ │ │ +00032730: 286e 756d 6572 6963 206b 6579 7061 6429 (numeric keypad) │ │ │ │ +00032740: 0a20 2020 2020 6e75 6d6d 696e 7573 2020 . numminus │ │ │ │ 00032750: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00032760: 2d20 286e 756d 6572 6963 206b 6579 7061 - (numeric keypa │ │ │ │ -00032770: 6429 0a20 2020 2020 6e75 6d70 6c75 7320 d). numplus │ │ │ │ -00032780: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00032790: 2020 2020 2020 2b20 286e 756d 6572 6963 + (numeric │ │ │ │ -000327a0: 206b 6579 7061 6429 0a20 2020 2020 6e75 keypad). nu │ │ │ │ -000327b0: 6d73 6c61 7368 2020 2020 2020 2020 2020 mslash │ │ │ │ -000327c0: 2020 2020 2020 2020 2020 2020 2f20 286e / (n │ │ │ │ -000327d0: 756d 6572 6963 206b 6579 7061 6429 0a20 umeric keypad). │ │ │ │ -000327e0: 2020 2020 6e75 6d65 6e74 6572 2020 2020 numenter │ │ │ │ +00032760: 2020 2020 2d20 286e 756d 6572 6963 206b - (numeric k │ │ │ │ +00032770: 6579 7061 6429 0a20 2020 2020 6e75 6d70 eypad). nump │ │ │ │ +00032780: 6c75 7320 2020 2020 2020 2020 2020 2020 lus │ │ │ │ +00032790: 2020 2020 2020 2020 2020 2b20 286e 756d + (num │ │ │ │ +000327a0: 6572 6963 206b 6579 7061 6429 0a20 2020 eric keypad). │ │ │ │ +000327b0: 2020 6e75 6d73 6c61 7368 2020 2020 2020 numslash │ │ │ │ +000327c0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +000327d0: 2f20 286e 756d 6572 6963 206b 6579 7061 / (numeric keypa │ │ │ │ +000327e0: 6429 0a20 2020 2020 6e75 6d65 6e74 6572 d). numenter │ │ │ │ 000327f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00032800: 2020 456e 7465 7220 286e 756d 6572 6963 Enter (numeric │ │ │ │ -00032810: 206b 6579 7061 6429 0a20 2020 2020 6465 keypad). de │ │ │ │ -00032820: 6c65 7465 2020 2020 2020 2020 2020 2020 lete │ │ │ │ -00032830: 2020 2020 2020 2020 2020 2020 4465 6c65 Dele │ │ │ │ -00032840: 7465 0a20 2020 2020 696e 7365 7274 2020 te. insert │ │ │ │ -00032850: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00032860: 2020 2020 2020 496e 7365 7274 0a20 2020 Insert. │ │ │ │ -00032870: 2020 686f 6d65 2020 2020 2020 2020 2020 home │ │ │ │ +00032800: 2020 2020 2020 456e 7465 7220 286e 756d Enter (num │ │ │ │ +00032810: 6572 6963 206b 6579 7061 6429 0a20 2020 eric keypad). │ │ │ │ +00032820: 2020 6465 6c65 7465 2020 2020 2020 2020 delete │ │ │ │ +00032830: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00032840: 4465 6c65 7465 0a20 2020 2020 696e 7365 Delete. inse │ │ │ │ +00032850: 7274 2020 2020 2020 2020 2020 2020 2020 rt │ │ │ │ +00032860: 2020 2020 2020 2020 2020 496e 7365 7274 Insert │ │ │ │ +00032870: 0a20 2020 2020 686f 6d65 2020 2020 2020 . home │ │ │ │ 00032880: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00032890: 486f 6d65 0a20 2020 2020 656e 6420 2020 Home. end │ │ │ │ -000328a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -000328b0: 2020 2020 2020 2020 456e 640a 2020 2020 End. │ │ │ │ -000328c0: 2070 6764 6f77 6e20 2020 2020 2020 2020 pgdown │ │ │ │ -000328d0: 2020 2020 2020 2020 2020 2020 2020 2050 P │ │ │ │ -000328e0: 6167 6520 446f 776e 0a20 2020 2020 7067 age Down. pg │ │ │ │ -000328f0: 7570 2020 2020 2020 2020 2020 2020 2020 up │ │ │ │ -00032900: 2020 2020 2020 2020 2020 2020 5061 6765 Page │ │ │ │ -00032910: 2055 700a 2020 2020 2064 6f77 6e20 2020 Up. down │ │ │ │ -00032920: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00032930: 2020 2020 2020 2044 6f77 6e0a 2020 2020 Down. │ │ │ │ -00032940: 2075 7020 2020 2020 2020 2020 2020 2020 up │ │ │ │ -00032950: 2020 2020 2020 2020 2020 2020 2020 2055 U │ │ │ │ -00032960: 700a 2020 2020 206c 6566 7420 2020 2020 p. left │ │ │ │ +00032890: 2020 2020 486f 6d65 0a20 2020 2020 656e Home. en │ │ │ │ +000328a0: 6420 2020 2020 2020 2020 2020 2020 2020 d │ │ │ │ +000328b0: 2020 2020 2020 2020 2020 2020 456e 640a End. │ │ │ │ +000328c0: 2020 2020 2070 6764 6f77 6e20 2020 2020 pgdown │ │ │ │ +000328d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +000328e0: 2020 2050 6167 6520 446f 776e 0a20 2020 Page Down. │ │ │ │ +000328f0: 2020 7067 7570 2020 2020 2020 2020 2020 pgup │ │ │ │ +00032900: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00032910: 5061 6765 2055 700a 2020 2020 2064 6f77 Page Up. dow │ │ │ │ +00032920: 6e20 2020 2020 2020 2020 2020 2020 2020 n │ │ │ │ +00032930: 2020 2020 2020 2020 2020 2044 6f77 6e0a Down. │ │ │ │ +00032940: 2020 2020 2075 7020 2020 2020 2020 2020 up │ │ │ │ +00032950: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00032960: 2020 2055 700a 2020 2020 206c 6566 7420 Up. left │ │ │ │ 00032970: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00032980: 2020 2020 204c 6566 740a 2020 2020 2072 Left. r │ │ │ │ -00032990: 6967 6874 2020 2020 2020 2020 2020 2020 ight │ │ │ │ -000329a0: 2020 2020 2020 2020 2020 2020 2052 6967 Rig │ │ │ │ -000329b0: 6874 0a0a 2020 2020 2041 7320 7765 6c6c ht.. As well │ │ │ │ -000329c0: 2061 7320 6b65 7973 7472 6f6b 6573 2c20 as keystrokes, │ │ │ │ -000329d0: 7468 6520 2773 656e 646b 6579 2720 636f the 'sendkey' co │ │ │ │ -000329e0: 6d6d 616e 6420 7461 6b65 7320 7661 7269 mmand takes vari │ │ │ │ -000329f0: 6f75 7320 6f70 7469 6f6e 730a 2020 2020 ous options. │ │ │ │ -00032a00: 2074 6861 7420 6166 6665 6374 2074 6865 that affect the │ │ │ │ -00032a10: 2042 494f 5320 6b65 7962 6f61 7264 2073 BIOS keyboard s │ │ │ │ -00032a20: 7461 7475 7320 666c 6167 732e 2020 5468 tatus flags. Th │ │ │ │ -00032a30: 6573 6520 6f70 7469 6f6e 7320 7461 6b65 ese options take │ │ │ │ -00032a40: 2061 6e0a 2020 2020 2027 6f6e 2720 6f72 an. 'on' or │ │ │ │ -00032a50: 2027 6f66 6627 2070 6172 616d 6574 6572 'off' parameter │ │ │ │ -00032a60: 2c20 7370 6563 6966 7969 6e67 2074 6861 , specifying tha │ │ │ │ -00032a70: 7420 7468 6520 636f 7272 6573 706f 6e64 t the correspond │ │ │ │ -00032a80: 696e 6720 7374 6174 7573 0a20 2020 2020 ing status. │ │ │ │ -00032a90: 666c 6167 2062 6520 7365 7420 6f72 2075 flag be set or u │ │ │ │ -00032aa0: 6e73 6574 3b20 6f6d 6974 7469 6e67 2074 nset; omitting t │ │ │ │ -00032ab0: 6865 206f 7074 696f 6e20 666f 7220 6120 he option for a │ │ │ │ -00032ac0: 6769 7665 6e20 7374 6174 7573 2066 6c61 given status fla │ │ │ │ -00032ad0: 670a 2020 2020 2077 696c 6c20 6c65 6176 g. will leav │ │ │ │ -00032ae0: 6520 7468 6174 2066 6c61 6720 6174 2069 e that flag at i │ │ │ │ -00032af0: 7473 2069 6e69 7469 616c 2073 7461 7465 ts initial state │ │ │ │ -00032b00: 2061 7420 626f 6f74 2e20 2054 6865 2027 at boot. The ' │ │ │ │ -00032b10: 2d2d 6e75 6d27 2c0a 2020 2020 2027 2d2d --num',. '-- │ │ │ │ -00032b20: 6361 7073 272c 2027 2d2d 7363 726f 6c6c caps', '--scroll │ │ │ │ -00032b30: 272c 2061 6e64 2027 2d2d 696e 7365 7274 ', and '--insert │ │ │ │ -00032b40: 2720 6f70 7469 6f6e 7320 656d 756c 6174 ' options emulat │ │ │ │ -00032b50: 6520 7365 7474 696e 6720 7468 650a 2020 e setting the. │ │ │ │ -00032b60: 2020 2063 6f72 7265 7370 6f6e 6469 6e67 corresponding │ │ │ │ -00032b70: 206d 6f64 652c 2077 6869 6c65 2074 6865 mode, while the │ │ │ │ -00032b80: 2027 2d2d 6e75 6d6b 6579 272c 2027 2d2d '--numkey', '-- │ │ │ │ -00032b90: 6361 7073 6b65 7927 2c0a 2020 2020 2027 capskey',. ' │ │ │ │ -00032ba0: 2d2d 7363 726f 6c6c 6b65 7927 2c20 616e --scrollkey', an │ │ │ │ -00032bb0: 6420 272d 2d69 6e73 6572 746b 6579 2720 d '--insertkey' │ │ │ │ -00032bc0: 6f70 7469 6f6e 7320 656d 756c 6174 6520 options emulate │ │ │ │ -00032bd0: 7072 6573 7369 6e67 2061 6e64 0a20 2020 pressing and. │ │ │ │ -00032be0: 2020 686f 6c64 696e 6720 7468 6520 636f holding the co │ │ │ │ -00032bf0: 7272 6573 706f 6e64 696e 6720 6b65 792e rresponding key. │ │ │ │ -00032c00: 2020 5468 6520 6f74 6865 7220 7374 6174 The other stat │ │ │ │ -00032c10: 7573 2066 6c61 6720 6f70 7469 6f6e 7320 us flag options │ │ │ │ -00032c20: 6172 650a 2020 2020 2073 656c 662d 6578 are. self-ex │ │ │ │ -00032c30: 706c 616e 6174 6f72 792e 0a0a 2020 2020 planatory... │ │ │ │ -00032c40: 2049 6620 7468 6520 272d 2d6e 6f2d 6c65 If the '--no-le │ │ │ │ -00032c50: 6427 206f 7074 696f 6e20 6973 2067 6976 d' option is giv │ │ │ │ -00032c60: 656e 2c20 7468 6520 7374 6174 7573 2066 en, the status f │ │ │ │ -00032c70: 6c61 6720 6f70 7469 6f6e 7320 7769 6c6c lag options will │ │ │ │ -00032c80: 0a20 2020 2020 6861 7665 206e 6f20 6566 . have no ef │ │ │ │ -00032c90: 6665 6374 206f 6e20 6b65 7962 6f61 7264 fect on keyboard │ │ │ │ -00032ca0: 204c 4544 732e 0a0a 2020 2020 2049 6620 LEDs... If │ │ │ │ -00032cb0: 7468 6520 2773 656e 646b 6579 2720 636f the 'sendkey' co │ │ │ │ -00032cc0: 6d6d 616e 6420 6973 2067 6976 656e 206d mmand is given m │ │ │ │ -00032cd0: 756c 7469 706c 6520 7469 6d65 732c 2074 ultiple times, t │ │ │ │ -00032ce0: 6865 6e20 6f6e 6c79 2074 6865 0a20 2020 hen only the. │ │ │ │ -00032cf0: 2020 6c61 7374 2069 6e76 6f63 6174 696f last invocatio │ │ │ │ -00032d00: 6e20 6861 7320 616e 7920 6566 6665 6374 n has any effect │ │ │ │ -00032d10: 2e0a 0a20 2020 2020 5369 6e63 6520 2773 ... Since 's │ │ │ │ -00032d20: 656e 646b 6579 2720 6d61 6e69 7075 6c61 endkey' manipula │ │ │ │ -00032d30: 7465 7320 7468 6520 4249 4f53 206b 6579 tes the BIOS key │ │ │ │ -00032d40: 626f 6172 6420 6275 6666 6572 2c20 6974 board buffer, it │ │ │ │ -00032d50: 206d 6179 2063 6175 7365 0a20 2020 2020 may cause. │ │ │ │ -00032d60: 6861 6e67 732c 2072 6562 6f6f 7473 2c20 hangs, reboots, │ │ │ │ -00032d70: 6f72 206f 7468 6572 206d 6973 6265 6861 or other misbeha │ │ │ │ -00032d80: 7669 6f75 7220 6f6e 2073 6f6d 6520 7379 viour on some sy │ │ │ │ -00032d90: 7374 656d 732e 2020 4966 2074 6865 0a20 stems. If the. │ │ │ │ -00032da0: 2020 2020 6f70 6572 6174 696e 6720 7379 operating sy │ │ │ │ -00032db0: 7374 656d 206f 7220 626f 6f74 206c 6f61 stem or boot loa │ │ │ │ -00032dc0: 6465 7220 7468 6174 2072 756e 7320 6166 der that runs af │ │ │ │ -00032dd0: 7465 7220 4752 5542 2075 7365 7320 6974 ter GRUB uses it │ │ │ │ -00032de0: 7320 6f77 6e0a 2020 2020 206b 6579 626f s own. keybo │ │ │ │ -00032df0: 6172 6420 6472 6976 6572 2072 6174 6865 ard driver rathe │ │ │ │ -00032e00: 7220 7468 616e 2074 6865 2042 494f 5320 r than the BIOS │ │ │ │ -00032e10: 6b65 7962 6f61 7264 2066 756e 6374 696f keyboard functio │ │ │ │ -00032e20: 6e73 2c20 7468 656e 0a20 2020 2020 2773 ns, then. 's │ │ │ │ -00032e30: 656e 646b 6579 2720 7769 6c6c 2068 6176 endkey' will hav │ │ │ │ -00032e40: 6520 6e6f 2065 6666 6563 742e 0a0a 2020 e no effect... │ │ │ │ -00032e50: 2020 2054 6869 7320 636f 6d6d 616e 6420 This command │ │ │ │ -00032e60: 6973 206f 6e6c 7920 6176 6169 6c61 626c is only availabl │ │ │ │ -00032e70: 6520 6f6e 2050 4320 4249 4f53 2073 7973 e on PC BIOS sys │ │ │ │ -00032e80: 7465 6d73 2e0a 0a1f 0a46 696c 653a 2067 tems.....File: g │ │ │ │ -00032e90: 7275 622e 696e 666f 2c20 204e 6f64 653a rub.info, Node: │ │ │ │ -00032ea0: 2073 6574 2c20 204e 6578 743a 2073 6861 set, Next: sha │ │ │ │ -00032eb0: 3173 756d 2c20 2050 7265 763a 2073 656e 1sum, Prev: sen │ │ │ │ -00032ec0: 646b 6579 2c20 2055 703a 2043 6f6d 6d61 dkey, Up: Comma │ │ │ │ -00032ed0: 6e64 2d6c 696e 6520 616e 6420 6d65 6e75 nd-line and menu │ │ │ │ -00032ee0: 2065 6e74 7279 2063 6f6d 6d61 6e64 730a entry commands. │ │ │ │ -00032ef0: 0a31 362e 332e 3638 2073 6574 0a2d 2d2d .16.3.68 set.--- │ │ │ │ -00032f00: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 436f --------.. -- Co │ │ │ │ -00032f10: 6d6d 616e 643a 2073 6574 205b 656e 7676 mmand: set [envv │ │ │ │ -00032f20: 6172 3d76 616c 7565 5d0a 2020 2020 2053 ar=value]. S │ │ │ │ -00032f30: 6574 2074 6865 2065 6e76 6972 6f6e 6d65 et the environme │ │ │ │ -00032f40: 6e74 2076 6172 6961 626c 6520 454e 5656 nt variable ENVV │ │ │ │ -00032f50: 4152 2074 6f20 5641 4c55 452e 2020 4966 AR to VALUE. If │ │ │ │ -00032f60: 2069 6e76 6f6b 6564 2077 6974 6820 6e6f invoked with no │ │ │ │ -00032f70: 0a20 2020 2020 6172 6775 6d65 6e74 732c . arguments, │ │ │ │ -00032f80: 2070 7269 6e74 2061 6c6c 2065 6e76 6972 print all envir │ │ │ │ -00032f90: 6f6e 6d65 6e74 2076 6172 6961 626c 6573 onment variables │ │ │ │ -00032fa0: 2077 6974 6820 7468 6569 7220 7661 6c75 with their valu │ │ │ │ -00032fb0: 6573 2e0a 0a1f 0a46 696c 653a 2067 7275 es.....File: gru │ │ │ │ -00032fc0: 622e 696e 666f 2c20 204e 6f64 653a 2073 b.info, Node: s │ │ │ │ -00032fd0: 6861 3173 756d 2c20 204e 6578 743a 2073 ha1sum, Next: s │ │ │ │ -00032fe0: 6861 3235 3673 756d 2c20 2050 7265 763a ha256sum, Prev: │ │ │ │ -00032ff0: 2073 6574 2c20 2055 703a 2043 6f6d 6d61 set, Up: Comma │ │ │ │ -00033000: 6e64 2d6c 696e 6520 616e 6420 6d65 6e75 nd-line and menu │ │ │ │ -00033010: 2065 6e74 7279 2063 6f6d 6d61 6e64 730a entry commands. │ │ │ │ -00033020: 0a31 362e 332e 3639 2073 6861 3173 756d .16.3.69 sha1sum │ │ │ │ -00033030: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d .--------------- │ │ │ │ -00033040: 0a0a 202d 2d20 436f 6d6d 616e 643a 2073 .. -- Command: s │ │ │ │ -00033050: 6861 3173 756d 2061 7267 202e 2e2e 0a20 ha1sum arg .... │ │ │ │ -00033060: 2020 2020 416c 6961 7320 666f 7220 2768 Alias for 'h │ │ │ │ -00033070: 6173 6873 756d 202d 2d68 6173 6820 7368 ashsum --hash sh │ │ │ │ -00033080: 6131 2061 7267 202e 2e2e 272e 2020 5365 a1 arg ...'. Se │ │ │ │ -00033090: 6520 636f 6d6d 616e 6420 2768 6173 6873 e command 'hashs │ │ │ │ -000330a0: 756d 270a 2020 2020 2028 2a6e 6f74 6520 um'. (*note │ │ │ │ -000330b0: 6861 7368 7375 6d3a 3a29 2066 6f72 2066 hashsum::) for f │ │ │ │ -000330c0: 756c 6c20 6465 7363 7269 7074 696f 6e2e ull description. │ │ │ │ -000330d0: 0a0a 1f0a 4669 6c65 3a20 6772 7562 2e69 ....File: grub.i │ │ │ │ -000330e0: 6e66 6f2c 2020 4e6f 6465 3a20 7368 6132 nfo, Node: sha2 │ │ │ │ -000330f0: 3536 7375 6d2c 2020 4e65 7874 3a20 7368 56sum, Next: sh │ │ │ │ -00033100: 6135 3132 7375 6d2c 2020 5072 6576 3a20 a512sum, Prev: │ │ │ │ -00033110: 7368 6131 7375 6d2c 2020 5570 3a20 436f sha1sum, Up: Co │ │ │ │ -00033120: 6d6d 616e 642d 6c69 6e65 2061 6e64 206d mmand-line and m │ │ │ │ -00033130: 656e 7520 656e 7472 7920 636f 6d6d 616e enu entry comman │ │ │ │ -00033140: 6473 0a0a 3136 2e33 2e37 3020 7368 6132 ds..16.3.70 sha2 │ │ │ │ -00033150: 3536 7375 6d0a 2d2d 2d2d 2d2d 2d2d 2d2d 56sum.---------- │ │ │ │ -00033160: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2043 6f6d -------.. -- Com │ │ │ │ -00033170: 6d61 6e64 3a20 7368 6132 3536 7375 6d20 mand: sha256sum │ │ │ │ -00033180: 6172 6720 2e2e 2e0a 2020 2020 2041 6c69 arg .... Ali │ │ │ │ -00033190: 6173 2066 6f72 2027 6861 7368 7375 6d20 as for 'hashsum │ │ │ │ -000331a0: 2d2d 6861 7368 2073 6861 3235 3620 6172 --hash sha256 ar │ │ │ │ -000331b0: 6720 2e2e 2e27 2e20 2053 6565 2063 6f6d g ...'. See com │ │ │ │ -000331c0: 6d61 6e64 2027 6861 7368 7375 6d27 0a20 mand 'hashsum'. │ │ │ │ -000331d0: 2020 2020 282a 6e6f 7465 2068 6173 6873 (*note hashs │ │ │ │ -000331e0: 756d 3a3a 2920 666f 7220 6675 6c6c 2064 um::) for full d │ │ │ │ -000331f0: 6573 6372 6970 7469 6f6e 2e0a 0a1f 0a46 escription.....F │ │ │ │ -00033200: 696c 653a 2067 7275 622e 696e 666f 2c20 ile: grub.info, │ │ │ │ -00033210: 204e 6f64 653a 2073 6861 3531 3273 756d Node: sha512sum │ │ │ │ -00033220: 2c20 204e 6578 743a 2073 6c65 6570 2c20 , Next: sleep, │ │ │ │ -00033230: 2050 7265 763a 2073 6861 3235 3673 756d Prev: sha256sum │ │ │ │ -00033240: 2c20 2055 703a 2043 6f6d 6d61 6e64 2d6c , Up: Command-l │ │ │ │ -00033250: 696e 6520 616e 6420 6d65 6e75 2065 6e74 ine and menu ent │ │ │ │ -00033260: 7279 2063 6f6d 6d61 6e64 730a 0a31 362e ry commands..16. │ │ │ │ -00033270: 332e 3731 2073 6861 3531 3273 756d 0a2d 3.71 sha512sum.- │ │ │ │ -00033280: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ -00033290: 0a0a 202d 2d20 436f 6d6d 616e 643a 2073 .. -- Command: s │ │ │ │ -000332a0: 6861 3531 3273 756d 2061 7267 202e 2e2e ha512sum arg ... │ │ │ │ -000332b0: 0a20 2020 2020 416c 6961 7320 666f 7220 . Alias for │ │ │ │ -000332c0: 2768 6173 6873 756d 202d 2d68 6173 6820 'hashsum --hash │ │ │ │ -000332d0: 7368 6135 3132 2061 7267 202e 2e2e 272e sha512 arg ...'. │ │ │ │ -000332e0: 2020 5365 6520 636f 6d6d 616e 6420 2768 See command 'h │ │ │ │ -000332f0: 6173 6873 756d 270a 2020 2020 2028 2a6e ashsum'. (*n │ │ │ │ -00033300: 6f74 6520 6861 7368 7375 6d3a 3a29 2066 ote hashsum::) f │ │ │ │ -00033310: 6f72 2066 756c 6c20 6465 7363 7269 7074 or full descript │ │ │ │ -00033320: 696f 6e2e 0a0a 1f0a 4669 6c65 3a20 6772 ion.....File: gr │ │ │ │ -00033330: 7562 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ub.info, Node: │ │ │ │ -00033340: 736c 6565 702c 2020 4e65 7874 3a20 736f sleep, Next: so │ │ │ │ -00033350: 7572 6365 2c20 2050 7265 763a 2073 6861 urce, Prev: sha │ │ │ │ -00033360: 3531 3273 756d 2c20 2055 703a 2043 6f6d 512sum, Up: Com │ │ │ │ -00033370: 6d61 6e64 2d6c 696e 6520 616e 6420 6d65 mand-line and me │ │ │ │ -00033380: 6e75 2065 6e74 7279 2063 6f6d 6d61 6e64 nu entry command │ │ │ │ -00033390: 730a 0a31 362e 332e 3732 2073 6c65 6570 s..16.3.72 sleep │ │ │ │ -000333a0: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a .-------------.. │ │ │ │ -000333b0: 202d 2d20 436f 6d6d 616e 643a 2073 6c65 -- Command: sle │ │ │ │ -000333c0: 6570 205b 272d 2d76 6572 626f 7365 275d ep ['--verbose'] │ │ │ │ -000333d0: 205b 272d 2d69 6e74 6572 7275 7074 6962 ['--interruptib │ │ │ │ -000333e0: 6c65 275d 2063 6f75 6e74 0a20 2020 2020 le'] count. │ │ │ │ -000333f0: 536c 6565 7020 666f 7220 434f 554e 5420 Sleep for COUNT │ │ │ │ -00033400: 7365 636f 6e64 732e 2020 4966 206f 7074 seconds. If opt │ │ │ │ -00033410: 696f 6e20 272d 2d69 6e74 6572 7275 7074 ion '--interrupt │ │ │ │ -00033420: 6962 6c65 2720 6973 2067 6976 656e 2c0a ible' is given,. │ │ │ │ -00033430: 2020 2020 2061 6c6c 6f77 203c 4553 433e allow │ │ │ │ -00033440: 2074 6f20 696e 7465 7272 7570 7420 736c to interrupt sl │ │ │ │ -00033450: 6565 702e 2020 5769 7468 2027 2d2d 7665 eep. With '--ve │ │ │ │ -00033460: 7262 6f73 6527 2073 686f 7720 636f 756e rbose' show coun │ │ │ │ -00033470: 7464 6f77 6e20 6f66 0a20 2020 2020 7265 tdown of. re │ │ │ │ -00033480: 6d61 696e 696e 6720 7365 636f 6e64 732e maining seconds. │ │ │ │ -00033490: 2020 4578 6974 2063 6f64 6520 6973 2073 Exit code is s │ │ │ │ -000334a0: 6574 2074 6f20 3020 6966 2074 696d 656f et to 0 if timeo │ │ │ │ -000334b0: 7574 2065 7870 6972 6564 2061 6e64 2074 ut expired and t │ │ │ │ -000334c0: 6f0a 2020 2020 2031 2069 6620 7469 6d65 o. 1 if time │ │ │ │ -000334d0: 6f75 7420 7761 7320 696e 7465 7272 7570 out was interrup │ │ │ │ -000334e0: 7465 6420 6279 203c 4553 433e 2e0a 0a1f ted by .... │ │ │ │ -000334f0: 0a46 696c 653a 2067 7275 622e 696e 666f .File: grub.info │ │ │ │ -00033500: 2c20 204e 6f64 653a 2073 6f75 7263 652c , Node: source, │ │ │ │ -00033510: 2020 4e65 7874 3a20 7465 7374 2c20 2050 Next: test, P │ │ │ │ -00033520: 7265 763a 2073 6c65 6570 2c20 2055 703a rev: sleep, Up: │ │ │ │ -00033530: 2043 6f6d 6d61 6e64 2d6c 696e 6520 616e Command-line an │ │ │ │ -00033540: 6420 6d65 6e75 2065 6e74 7279 2063 6f6d d menu entry com │ │ │ │ -00033550: 6d61 6e64 730a 0a31 362e 332e 3733 2073 mands..16.3.73 s │ │ │ │ -00033560: 6f75 7263 650a 2d2d 2d2d 2d2d 2d2d 2d2d ource.---------- │ │ │ │ -00033570: 2d2d 2d2d 0a0a 202d 2d20 436f 6d6d 616e ----.. -- Comman │ │ │ │ -00033580: 643a 2073 6f75 7263 6520 6669 6c65 0a20 d: source file. │ │ │ │ -00033590: 2020 2020 5265 6164 2046 494c 4520 6173 Read FILE as │ │ │ │ -000335a0: 2061 2063 6f6e 6669 6775 7261 7469 6f6e a configuration │ │ │ │ -000335b0: 2066 696c 652c 2061 7320 6966 2069 7473 file, as if its │ │ │ │ -000335c0: 2063 6f6e 7465 6e74 7320 6861 6420 6265 contents had be │ │ │ │ -000335d0: 656e 0a20 2020 2020 696e 636f 7270 6f72 en. incorpor │ │ │ │ -000335e0: 6174 6564 2064 6972 6563 746c 7920 696e ated directly in │ │ │ │ -000335f0: 746f 2074 6865 2073 6f75 7263 696e 6720 to the sourcing │ │ │ │ -00033600: 6669 6c65 2e20 2055 6e6c 696b 6520 2763 file. Unlike 'c │ │ │ │ -00033610: 6f6e 6669 6766 696c 6527 0a20 2020 2020 onfigfile'. │ │ │ │ -00033620: 282a 6e6f 7465 2063 6f6e 6669 6766 696c (*note configfil │ │ │ │ -00033630: 653a 3a29 2c20 7468 6973 2065 7865 6375 e::), this execu │ │ │ │ -00033640: 7465 7320 7468 6520 636f 6e74 656e 7473 tes the contents │ │ │ │ -00033650: 206f 6620 4649 4c45 2077 6974 686f 7574 of FILE without │ │ │ │ -00033660: 0a20 2020 2020 6368 616e 6769 6e67 2063 . changing c │ │ │ │ -00033670: 6f6e 7465 7874 3a20 616e 7920 656e 7669 ontext: any envi │ │ │ │ -00033680: 726f 6e6d 656e 7420 7661 7269 6162 6c65 ronment variable │ │ │ │ -00033690: 2063 6861 6e67 6573 206d 6164 6520 6279 changes made by │ │ │ │ -000336a0: 2074 6865 0a20 2020 2020 636f 6d6d 616e the. comman │ │ │ │ -000336b0: 6473 2069 6e20 4649 4c45 2077 696c 6c20 ds in FILE will │ │ │ │ -000336c0: 6265 2070 7265 7365 7276 6564 2061 6674 be preserved aft │ │ │ │ -000336d0: 6572 2027 736f 7572 6365 2720 7265 7475 er 'source' retu │ │ │ │ -000336e0: 726e 732c 2061 6e64 2074 6865 0a20 2020 rns, and the. │ │ │ │ -000336f0: 2020 6d65 6e75 2077 696c 6c20 6e6f 7420 menu will not │ │ │ │ -00033700: 6265 2073 686f 776e 2069 6d6d 6564 6961 be shown immedia │ │ │ │ -00033710: 7465 6c79 2e0a 0a1f 0a46 696c 653a 2067 tely.....File: g │ │ │ │ -00033720: 7275 622e 696e 666f 2c20 204e 6f64 653a rub.info, Node: │ │ │ │ -00033730: 2074 6573 742c 2020 4e65 7874 3a20 7472 test, Next: tr │ │ │ │ -00033740: 7565 2c20 2050 7265 763a 2073 6f75 7263 ue, Prev: sourc │ │ │ │ -00033750: 652c 2020 5570 3a20 436f 6d6d 616e 642d e, Up: Command- │ │ │ │ -00033760: 6c69 6e65 2061 6e64 206d 656e 7520 656e line and menu en │ │ │ │ -00033770: 7472 7920 636f 6d6d 616e 6473 0a0a 3136 try commands..16 │ │ │ │ -00033780: 2e33 2e37 3420 7465 7374 0a2d 2d2d 2d2d .3.74 test.----- │ │ │ │ -00033790: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2043 6f6d -------.. -- Com │ │ │ │ -000337a0: 6d61 6e64 3a20 7465 7374 2065 7870 7265 mand: test expre │ │ │ │ -000337b0: 7373 696f 6e0a 2020 2020 2045 7661 6c75 ssion. Evalu │ │ │ │ -000337c0: 6174 6520 4558 5052 4553 5349 4f4e 2061 ate EXPRESSION a │ │ │ │ -000337d0: 6e64 2072 6574 7572 6e20 7a65 726f 2065 nd return zero e │ │ │ │ -000337e0: 7869 7420 7374 6174 7573 2069 6620 7265 xit status if re │ │ │ │ -000337f0: 7375 6c74 2069 7320 7472 7565 2c0a 2020 sult is true,. │ │ │ │ -00033800: 2020 206e 6f6e 207a 6572 6f20 7374 6174 non zero stat │ │ │ │ -00033810: 7573 206f 7468 6572 7769 7365 2e0a 0a20 us otherwise... │ │ │ │ -00033820: 2020 2020 4558 5052 4553 5349 4f4e 2069 EXPRESSION i │ │ │ │ -00033830: 7320 6f6e 6520 6f66 3a0a 0a20 2020 2020 s one of:.. │ │ │ │ -00033840: 5354 5249 4e47 3120 273d 3d27 2053 5452 STRING1 '==' STR │ │ │ │ -00033850: 494e 4732 0a20 2020 2020 2020 2020 2074 ING2. t │ │ │ │ -00033860: 6865 2073 7472 696e 6773 2061 7265 2065 he strings are e │ │ │ │ -00033870: 7175 616c 0a20 2020 2020 5354 5249 4e47 qual. STRING │ │ │ │ -00033880: 3120 2721 3d27 2053 5452 494e 4732 0a20 1 '!=' STRING2. │ │ │ │ -00033890: 2020 2020 2020 2020 2074 6865 2073 7472 the str │ │ │ │ -000338a0: 696e 6773 2061 7265 206e 6f74 2065 7175 ings are not equ │ │ │ │ -000338b0: 616c 0a20 2020 2020 5354 5249 4e47 3120 al. STRING1 │ │ │ │ -000338c0: 273c 2720 5354 5249 4e47 320a 2020 2020 '<' STRING2. │ │ │ │ -000338d0: 2020 2020 2020 5354 5249 4e47 3120 6973 STRING1 is │ │ │ │ -000338e0: 206c 6578 6963 6f67 7261 7068 6963 616c lexicographical │ │ │ │ -000338f0: 6c79 206c 6573 7320 7468 616e 2053 5452 ly less than STR │ │ │ │ -00033900: 494e 4732 0a20 2020 2020 5354 5249 4e47 ING2. STRING │ │ │ │ -00033910: 3120 273c 3d27 2053 5452 494e 4732 0a20 1 '<=' STRING2. │ │ │ │ -00033920: 2020 2020 2020 2020 2053 5452 494e 4731 STRING1 │ │ │ │ -00033930: 2069 7320 6c65 7869 636f 6772 6170 6869 is lexicographi │ │ │ │ -00033940: 6361 6c6c 7920 6c65 7373 206f 7220 6571 cally less or eq │ │ │ │ -00033950: 7561 6c20 7468 616e 2053 5452 494e 4732 ual than STRING2 │ │ │ │ -00033960: 0a20 2020 2020 5354 5249 4e47 3120 273e . STRING1 '> │ │ │ │ -00033970: 2720 5354 5249 4e47 320a 2020 2020 2020 ' STRING2. │ │ │ │ -00033980: 2020 2020 5354 5249 4e47 3120 6973 206c STRING1 is l │ │ │ │ -00033990: 6578 6963 6f67 7261 7068 6963 616c 6c79 exicographically │ │ │ │ -000339a0: 2067 7265 6174 6572 2074 6861 6e20 5354 greater than ST │ │ │ │ -000339b0: 5249 4e47 320a 2020 2020 2053 5452 494e RING2. STRIN │ │ │ │ -000339c0: 4731 2027 3e3d 2720 5354 5249 4e47 320a G1 '>=' STRING2. │ │ │ │ -000339d0: 2020 2020 2020 2020 2020 5354 5249 4e47 STRING │ │ │ │ -000339e0: 3120 6973 206c 6578 6963 6f67 7261 7068 1 is lexicograph │ │ │ │ -000339f0: 6963 616c 6c79 2067 7265 6174 6572 206f ically greater o │ │ │ │ -00033a00: 7220 6571 7561 6c20 7468 616e 2053 5452 r equal than STR │ │ │ │ -00033a10: 494e 4732 0a20 2020 2020 494e 5445 4745 ING2. INTEGE │ │ │ │ -00033a20: 5231 2027 2d65 7127 2049 4e54 4547 4552 R1 '-eq' INTEGER │ │ │ │ -00033a30: 320a 2020 2020 2020 2020 2020 494e 5445 2. INTE │ │ │ │ -00033a40: 4745 5231 2069 7320 6571 7561 6c20 746f GER1 is equal to │ │ │ │ -00033a50: 2049 4e54 4547 4552 320a 2020 2020 2049 INTEGER2. I │ │ │ │ -00033a60: 4e54 4547 4552 3120 272d 6765 2720 494e NTEGER1 '-ge' IN │ │ │ │ -00033a70: 5445 4745 5232 0a20 2020 2020 2020 2020 TEGER2. │ │ │ │ -00033a80: 2049 4e54 4547 4552 3120 6973 2067 7265 INTEGER1 is gre │ │ │ │ -00033a90: 6174 6572 2074 6861 6e20 6f72 2065 7175 ater than or equ │ │ │ │ -00033aa0: 616c 2074 6f20 494e 5445 4745 5232 0a20 al to INTEGER2. │ │ │ │ -00033ab0: 2020 2020 494e 5445 4745 5231 2027 2d67 INTEGER1 '-g │ │ │ │ -00033ac0: 7427 2049 4e54 4547 4552 320a 2020 2020 t' INTEGER2. │ │ │ │ -00033ad0: 2020 2020 2020 494e 5445 4745 5231 2069 INTEGER1 i │ │ │ │ -00033ae0: 7320 6772 6561 7465 7220 7468 616e 2049 s greater than I │ │ │ │ -00033af0: 4e54 4547 4552 320a 2020 2020 2049 4e54 NTEGER2. INT │ │ │ │ -00033b00: 4547 4552 3120 272d 6c65 2720 494e 5445 EGER1 '-le' INTE │ │ │ │ -00033b10: 4745 5232 0a20 2020 2020 2020 2020 2049 GER2. I │ │ │ │ -00033b20: 4e54 4547 4552 3120 6973 206c 6573 7320 NTEGER1 is less │ │ │ │ -00033b30: 7468 616e 206f 7220 6571 7561 6c20 746f than or equal to │ │ │ │ -00033b40: 2049 4e54 4547 4552 320a 2020 2020 2049 INTEGER2. I │ │ │ │ -00033b50: 4e54 4547 4552 3120 272d 6c74 2720 494e NTEGER1 '-lt' IN │ │ │ │ -00033b60: 5445 4745 5232 0a20 2020 2020 2020 2020 TEGER2. │ │ │ │ -00033b70: 2049 4e54 4547 4552 3120 6973 206c 6573 INTEGER1 is les │ │ │ │ -00033b80: 7320 7468 616e 2049 4e54 4547 4552 320a s than INTEGER2. │ │ │ │ -00033b90: 2020 2020 2049 4e54 4547 4552 3120 272d INTEGER1 '- │ │ │ │ -00033ba0: 6e65 2720 494e 5445 4745 5232 0a20 2020 ne' INTEGER2. │ │ │ │ -00033bb0: 2020 2020 2020 2049 4e54 4547 4552 3120 INTEGER1 │ │ │ │ -00033bc0: 6973 206e 6f74 2065 7175 616c 2074 6f20 is not equal to │ │ │ │ -00033bd0: 494e 5445 4745 5232 0a20 2020 2020 5052 INTEGER2. PR │ │ │ │ -00033be0: 4546 4958 494e 5445 4745 5231 2027 2d70 EFIXINTEGER1 '-p │ │ │ │ -00033bf0: 6774 2720 5052 4546 4958 494e 5445 4745 gt' PREFIXINTEGE │ │ │ │ -00033c00: 5232 0a20 2020 2020 2020 2020 2049 4e54 R2. INT │ │ │ │ -00033c10: 4547 4552 3120 6973 2067 7265 6174 6572 EGER1 is greater │ │ │ │ -00033c20: 2074 6861 6e20 494e 5445 4745 5232 2061 than INTEGER2 a │ │ │ │ -00033c30: 6674 6572 2073 7472 6970 7069 6e67 206f fter stripping o │ │ │ │ -00033c40: 6666 2063 6f6d 6d6f 6e0a 2020 2020 2020 ff common. │ │ │ │ -00033c50: 2020 2020 6e6f 6e2d 6e75 6d65 7269 6320 non-numeric │ │ │ │ -00033c60: 5052 4546 4958 2e0a 2020 2020 2050 5245 PREFIX.. PRE │ │ │ │ -00033c70: 4649 5849 4e54 4547 4552 3120 272d 706c FIXINTEGER1 '-pl │ │ │ │ -00033c80: 7427 2050 5245 4649 5849 4e54 4547 4552 t' PREFIXINTEGER │ │ │ │ -00033c90: 320a 2020 2020 2020 2020 2020 494e 5445 2. INTE │ │ │ │ -00033ca0: 4745 5231 2069 7320 6c65 7373 2074 6861 GER1 is less tha │ │ │ │ -00033cb0: 6e20 494e 5445 4745 5232 2061 6674 6572 n INTEGER2 after │ │ │ │ -00033cc0: 2073 7472 6970 7069 6e67 206f 6666 2063 stripping off c │ │ │ │ -00033cd0: 6f6d 6d6f 6e0a 2020 2020 2020 2020 2020 ommon. │ │ │ │ -00033ce0: 6e6f 6e2d 6e75 6d65 7269 6320 5052 4546 non-numeric PREF │ │ │ │ -00033cf0: 4958 2e0a 2020 2020 2046 494c 4531 2027 IX.. FILE1 ' │ │ │ │ -00033d00: 2d6e 7427 2046 494c 4532 0a20 2020 2020 -nt' FILE2. │ │ │ │ -00033d10: 2020 2020 2046 494c 4531 2069 7320 6e65 FILE1 is ne │ │ │ │ -00033d20: 7765 7220 7468 616e 2046 494c 4532 2028 wer than FILE2 ( │ │ │ │ -00033d30: 6d6f 6469 6669 6361 7469 6f6e 2074 696d modification tim │ │ │ │ -00033d40: 6529 2e20 204f 7074 696f 6e61 6c6c 790a e). Optionally. │ │ │ │ -00033d50: 2020 2020 2020 2020 2020 6e75 6d65 7269 numeri │ │ │ │ -00033d60: 6320 4249 4153 206d 6179 2062 6520 6469 c BIAS may be di │ │ │ │ -00033d70: 7265 6374 6c79 2061 7070 656e 6465 6420 rectly appended │ │ │ │ -00033d80: 746f 2027 2d6e 7427 2069 6e20 7768 6963 to '-nt' in whic │ │ │ │ -00033d90: 6820 6361 7365 0a20 2020 2020 2020 2020 h case. │ │ │ │ -00033da0: 2069 7420 6973 2061 6464 6564 2074 6f20 it is added to │ │ │ │ -00033db0: 7468 6520 6669 7273 7420 6669 6c65 206d the first file m │ │ │ │ -00033dc0: 6f64 6966 6963 6174 696f 6e20 7469 6d65 odification time │ │ │ │ -00033dd0: 2e0a 2020 2020 2046 494c 4531 2027 2d6f .. FILE1 '-o │ │ │ │ -00033de0: 7427 2046 494c 4532 0a20 2020 2020 2020 t' FILE2. │ │ │ │ -00033df0: 2020 2046 494c 4531 2069 7320 6f6c 6465 FILE1 is olde │ │ │ │ -00033e00: 7220 7468 616e 2046 494c 4532 2028 6d6f r than FILE2 (mo │ │ │ │ -00033e10: 6469 6669 6361 7469 6f6e 2074 696d 6529 dification time) │ │ │ │ -00033e20: 2e20 204f 7074 696f 6e61 6c6c 790a 2020 . Optionally. │ │ │ │ -00033e30: 2020 2020 2020 2020 6e75 6d65 7269 6320 numeric │ │ │ │ -00033e40: 4249 4153 206d 6179 2062 6520 6469 7265 BIAS may be dire │ │ │ │ -00033e50: 6374 6c79 2061 7070 656e 6465 6420 746f ctly appended to │ │ │ │ -00033e60: 2027 2d6f 7427 2069 6e20 7768 6963 6820 '-ot' in which │ │ │ │ -00033e70: 6361 7365 0a20 2020 2020 2020 2020 2069 case. i │ │ │ │ -00033e80: 7420 6973 2061 6464 6564 2074 6f20 7468 t is added to th │ │ │ │ -00033e90: 6520 6669 7273 7420 6669 6c65 206d 6f64 e first file mod │ │ │ │ -00033ea0: 6966 6963 6174 696f 6e20 7469 6d65 2e0a ification time.. │ │ │ │ -00033eb0: 2020 2020 2027 2d64 2720 4649 4c45 0a20 '-d' FILE. │ │ │ │ -00033ec0: 2020 2020 2020 2020 2046 494c 4520 6578 FILE ex │ │ │ │ -00033ed0: 6973 7473 2061 6e64 2069 7320 6120 6469 ists and is a di │ │ │ │ -00033ee0: 7265 6374 6f72 790a 2020 2020 2027 2d65 rectory. '-e │ │ │ │ -00033ef0: 2720 4649 4c45 0a20 2020 2020 2020 2020 ' FILE. │ │ │ │ -00033f00: 2046 494c 4520 6578 6973 7473 0a20 2020 FILE exists. │ │ │ │ -00033f10: 2020 272d 6627 2046 494c 450a 2020 2020 '-f' FILE. │ │ │ │ -00033f20: 2020 2020 2020 4649 4c45 2065 7869 7374 FILE exist │ │ │ │ -00033f30: 7320 616e 6420 6973 206e 6f74 2061 2064 s and is not a d │ │ │ │ -00033f40: 6972 6563 746f 7279 0a20 2020 2020 272d irectory. '- │ │ │ │ -00033f50: 7327 2046 494c 450a 2020 2020 2020 2020 s' FILE. │ │ │ │ -00033f60: 2020 4649 4c45 2065 7869 7374 7320 616e FILE exists an │ │ │ │ -00033f70: 6420 6861 7320 6120 7369 7a65 2067 7265 d has a size gre │ │ │ │ -00033f80: 6174 6572 2074 6861 6e20 7a65 726f 0a20 ater than zero. │ │ │ │ -00033f90: 2020 2020 272d 6e27 2053 5452 494e 470a '-n' STRING. │ │ │ │ -00033fa0: 2020 2020 2020 2020 2020 7468 6520 6c65 the le │ │ │ │ -00033fb0: 6e67 7468 206f 6620 5354 5249 4e47 2069 ngth of STRING i │ │ │ │ -00033fc0: 7320 6e6f 6e7a 6572 6f0a 2020 2020 2053 s nonzero. S │ │ │ │ -00033fd0: 5452 494e 470a 2020 2020 2020 2020 2020 TRING. │ │ │ │ -00033fe0: 5354 5249 4e47 2069 7320 6571 7569 7661 STRING is equiva │ │ │ │ -00033ff0: 6c65 6e74 2074 6f20 272d 6e20 5354 5249 lent to '-n STRI │ │ │ │ -00034000: 4e47 270a 2020 2020 2027 2d7a 2720 5354 NG'. '-z' ST │ │ │ │ -00034010: 5249 4e47 0a20 2020 2020 2020 2020 2074 RING. t │ │ │ │ -00034020: 6865 206c 656e 6774 6820 6f66 2053 5452 he length of STR │ │ │ │ -00034030: 494e 4720 6973 207a 6572 6f0a 2020 2020 ING is zero. │ │ │ │ -00034040: 2027 2827 2045 5850 5245 5353 494f 4e20 '(' EXPRESSION │ │ │ │ -00034050: 2729 270a 2020 2020 2020 2020 2020 4558 ')'. EX │ │ │ │ -00034060: 5052 4553 5349 4f4e 2069 7320 7472 7565 PRESSION is true │ │ │ │ -00034070: 0a20 2020 2020 2721 2720 4558 5052 4553 . '!' EXPRES │ │ │ │ -00034080: 5349 4f4e 0a20 2020 2020 2020 2020 2045 SION. E │ │ │ │ -00034090: 5850 5245 5353 494f 4e20 6973 2066 616c XPRESSION is fal │ │ │ │ -000340a0: 7365 0a20 2020 2020 4558 5052 4553 5349 se. EXPRESSI │ │ │ │ -000340b0: 4f4e 3120 272d 6127 2045 5850 5245 5353 ON1 '-a' EXPRESS │ │ │ │ -000340c0: 494f 4e32 0a20 2020 2020 2020 2020 2062 ION2. b │ │ │ │ -000340d0: 6f74 6820 4558 5052 4553 5349 4f4e 3120 oth EXPRESSION1 │ │ │ │ -000340e0: 616e 6420 4558 5052 4553 5349 4f4e 3220 and EXPRESSION2 │ │ │ │ -000340f0: 6172 6520 7472 7565 0a20 2020 2020 4558 are true. EX │ │ │ │ -00034100: 5052 4553 5349 4f4e 3120 4558 5052 4553 PRESSION1 EXPRES │ │ │ │ -00034110: 5349 4f4e 320a 2020 2020 2020 2020 2020 SION2. │ │ │ │ -00034120: 626f 7468 2045 5850 5245 5353 494f 4e31 both EXPRESSION1 │ │ │ │ -00034130: 2061 6e64 2045 5850 5245 5353 494f 4e32 and EXPRESSION2 │ │ │ │ -00034140: 2061 7265 2074 7275 652e 2020 5468 6973 are true. This │ │ │ │ -00034150: 2073 796e 7461 7820 6973 206e 6f74 0a20 syntax is not. │ │ │ │ -00034160: 2020 2020 2020 2020 2050 4f53 4958 2d63 POSIX-c │ │ │ │ -00034170: 6f6d 706c 6961 6e74 2061 6e64 2069 7320 ompliant and is │ │ │ │ -00034180: 6e6f 7420 7265 636f 6d6d 656e 6465 642e not recommended. │ │ │ │ -00034190: 0a20 2020 2020 4558 5052 4553 5349 4f4e . EXPRESSION │ │ │ │ -000341a0: 3120 272d 6f27 2045 5850 5245 5353 494f 1 '-o' EXPRESSIO │ │ │ │ -000341b0: 4e32 0a20 2020 2020 2020 2020 2065 6974 N2. eit │ │ │ │ -000341c0: 6865 7220 4558 5052 4553 5349 4f4e 3120 her EXPRESSION1 │ │ │ │ -000341d0: 6f72 2045 5850 5245 5353 494f 4e32 2069 or EXPRESSION2 i │ │ │ │ -000341e0: 7320 7472 7565 0a0a 1f0a 4669 6c65 3a20 s true....File: │ │ │ │ -000341f0: 6772 7562 2e69 6e66 6f2c 2020 4e6f 6465 grub.info, Node │ │ │ │ -00034200: 3a20 7472 7565 2c20 204e 6578 743a 2074 : true, Next: t │ │ │ │ -00034210: 7275 7374 2c20 2050 7265 763a 2074 6573 rust, Prev: tes │ │ │ │ -00034220: 742c 2020 5570 3a20 436f 6d6d 616e 642d t, Up: Command- │ │ │ │ -00034230: 6c69 6e65 2061 6e64 206d 656e 7520 656e line and menu en │ │ │ │ -00034240: 7472 7920 636f 6d6d 616e 6473 0a0a 3136 try commands..16 │ │ │ │ -00034250: 2e33 2e37 3520 7472 7565 0a2d 2d2d 2d2d .3.75 true.----- │ │ │ │ -00034260: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2043 6f6d -------.. -- Com │ │ │ │ -00034270: 6d61 6e64 3a20 7472 7565 0a20 2020 2020 mand: true. │ │ │ │ -00034280: 446f 206e 6f74 6869 6e67 2c20 7375 6363 Do nothing, succ │ │ │ │ -00034290: 6573 7366 756c 6c79 2e20 2054 6869 7320 essfully. This │ │ │ │ -000342a0: 6973 206d 6169 6e6c 7920 7573 6566 756c is mainly useful │ │ │ │ -000342b0: 2069 6e20 636f 6e74 726f 6c0a 2020 2020 in control. │ │ │ │ -000342c0: 2063 6f6e 7374 7275 6374 7320 7375 6368 constructs such │ │ │ │ -000342d0: 2061 7320 2769 6627 2061 6e64 2027 7768 as 'if' and 'wh │ │ │ │ -000342e0: 696c 6527 2028 2a6e 6f74 6520 5368 656c ile' (*note Shel │ │ │ │ -000342f0: 6c2d 6c69 6b65 2073 6372 6970 7469 6e67 l-like scripting │ │ │ │ -00034300: 3a3a 292e 0a0a 1f0a 4669 6c65 3a20 6772 ::).....File: gr │ │ │ │ -00034310: 7562 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ub.info, Node: │ │ │ │ -00034320: 7472 7573 742c 2020 4e65 7874 3a20 756e trust, Next: un │ │ │ │ -00034330: 7365 742c 2020 5072 6576 3a20 7472 7565 set, Prev: true │ │ │ │ -00034340: 2c20 2055 703a 2043 6f6d 6d61 6e64 2d6c , Up: Command-l │ │ │ │ -00034350: 696e 6520 616e 6420 6d65 6e75 2065 6e74 ine and menu ent │ │ │ │ -00034360: 7279 2063 6f6d 6d61 6e64 730a 0a31 362e ry commands..16. │ │ │ │ -00034370: 332e 3736 2074 7275 7374 0a2d 2d2d 2d2d 3.76 trust.----- │ │ │ │ -00034380: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 436f --------.. -- Co │ │ │ │ -00034390: 6d6d 616e 643a 2074 7275 7374 205b 272d mmand: trust ['- │ │ │ │ -000343a0: 2d73 6b69 702d 7369 6727 5d20 7075 626b -skip-sig'] pubk │ │ │ │ -000343b0: 6579 5f66 696c 650a 2020 2020 2052 6561 ey_file. Rea │ │ │ │ -000343c0: 6420 7075 626c 6963 206b 6579 2066 726f d public key fro │ │ │ │ -000343d0: 6d20 5055 424b 4559 5f46 494c 4520 616e m PUBKEY_FILE an │ │ │ │ -000343e0: 6420 6164 6420 6974 2074 6f20 4752 5542 d add it to GRUB │ │ │ │ -000343f0: 2773 2069 6e74 6572 6e61 6c20 6c69 7374 's internal list │ │ │ │ -00034400: 0a20 2020 2020 6f66 2074 7275 7374 6564 . of trusted │ │ │ │ -00034410: 2070 7562 6c69 6320 6b65 7973 2e20 2054 public keys. T │ │ │ │ -00034420: 6865 7365 206b 6579 7320 6172 6520 7573 hese keys are us │ │ │ │ -00034430: 6564 2074 6f20 7661 6c69 6461 7465 2064 ed to validate d │ │ │ │ -00034440: 6967 6974 616c 0a20 2020 2020 7369 676e igital. sign │ │ │ │ -00034450: 6174 7572 6573 2077 6865 6e20 656e 7669 atures when envi │ │ │ │ -00034460: 726f 6e6d 656e 7420 7661 7269 6162 6c65 ronment variable │ │ │ │ -00034470: 2027 6368 6563 6b5f 7369 676e 6174 7572 'check_signatur │ │ │ │ -00034480: 6573 2720 6973 2073 6574 2074 6f0a 2020 es' is set to. │ │ │ │ -00034490: 2020 2027 656e 666f 7263 6527 2e20 204e 'enforce'. N │ │ │ │ -000344a0: 6f74 6520 7468 6174 2069 6620 2763 6865 ote that if 'che │ │ │ │ -000344b0: 636b 5f73 6967 6e61 7475 7265 7327 2069 ck_signatures' i │ │ │ │ -000344c0: 7320 7365 7420 746f 2027 656e 666f 7263 s set to 'enforc │ │ │ │ -000344d0: 6527 0a20 2020 2020 7768 656e 2027 7472 e'. when 'tr │ │ │ │ -000344e0: 7573 7427 2065 7865 6375 7465 732c 2074 ust' executes, t │ │ │ │ -000344f0: 6865 6e20 5055 424b 4559 5f46 494c 4520 hen PUBKEY_FILE │ │ │ │ -00034500: 6d75 7374 2069 7473 656c 6620 6265 2070 must itself be p │ │ │ │ -00034510: 726f 7065 726c 790a 2020 2020 2073 6967 roperly. sig │ │ │ │ -00034520: 6e65 642e 2020 5468 6520 272d 2d73 6b69 ned. The '--ski │ │ │ │ -00034530: 702d 7369 6727 206f 7074 696f 6e20 6361 p-sig' option ca │ │ │ │ -00034540: 6e20 6265 2075 7365 6420 746f 2064 6973 n be used to dis │ │ │ │ -00034550: 6162 6c65 0a20 2020 2020 7369 676e 6174 able. signat │ │ │ │ -00034560: 7572 652d 6368 6563 6b69 6e67 2077 6865 ure-checking whe │ │ │ │ -00034570: 6e20 7265 6164 696e 6720 5055 424b 4559 n reading PUBKEY │ │ │ │ -00034580: 5f46 494c 4520 6974 7365 6c66 2e20 2049 _FILE itself. I │ │ │ │ -00034590: 7420 6973 2065 7870 6563 7465 640a 2020 t is expected. │ │ │ │ -000345a0: 2020 2074 6861 7420 272d 2d73 6b69 702d that '--skip- │ │ │ │ -000345b0: 7369 6727 2069 7320 7573 6566 756c 2066 sig' is useful f │ │ │ │ -000345c0: 6f72 2074 6573 7469 6e67 2061 6e64 206d or testing and m │ │ │ │ -000345d0: 616e 7561 6c20 626f 6f74 696e 672e 2020 anual booting. │ │ │ │ -000345e0: 2a4e 6f74 650a 2020 2020 2055 7369 6e67 *Note. Using │ │ │ │ -000345f0: 2064 6967 6974 616c 2073 6967 6e61 7475 digital signatu │ │ │ │ -00034600: 7265 733a 3a2c 2066 6f72 206d 6f72 6520 res::, for more │ │ │ │ -00034610: 696e 666f 726d 6174 696f 6e2e 0a0a 1f0a information..... │ │ │ │ -00034620: 4669 6c65 3a20 6772 7562 2e69 6e66 6f2c File: grub.info, │ │ │ │ -00034630: 2020 4e6f 6465 3a20 756e 7365 742c 2020 Node: unset, │ │ │ │ -00034640: 4e65 7874 3a20 7570 7065 726d 656d 2c20 Next: uppermem, │ │ │ │ -00034650: 2050 7265 763a 2074 7275 7374 2c20 2055 Prev: trust, U │ │ │ │ -00034660: 703a 2043 6f6d 6d61 6e64 2d6c 696e 6520 p: Command-line │ │ │ │ -00034670: 616e 6420 6d65 6e75 2065 6e74 7279 2063 and menu entry c │ │ │ │ -00034680: 6f6d 6d61 6e64 730a 0a31 362e 332e 3737 ommands..16.3.77 │ │ │ │ -00034690: 2075 6e73 6574 0a2d 2d2d 2d2d 2d2d 2d2d unset.--------- │ │ │ │ -000346a0: 2d2d 2d2d 0a0a 202d 2d20 436f 6d6d 616e ----.. -- Comman │ │ │ │ -000346b0: 643a 2075 6e73 6574 2065 6e76 7661 720a d: unset envvar. │ │ │ │ -000346c0: 2020 2020 2055 6e73 6574 2074 6865 2065 Unset the e │ │ │ │ -000346d0: 6e76 6972 6f6e 6d65 6e74 2076 6172 6961 nvironment varia │ │ │ │ -000346e0: 626c 6520 454e 5656 4152 2e0a 0a1f 0a46 ble ENVVAR.....F │ │ │ │ -000346f0: 696c 653a 2067 7275 622e 696e 666f 2c20 ile: grub.info, │ │ │ │ -00034700: 204e 6f64 653a 2075 7070 6572 6d65 6d2c Node: uppermem, │ │ │ │ -00034710: 2020 4e65 7874 3a20 7665 7269 6679 5f64 Next: verify_d │ │ │ │ -00034720: 6574 6163 6865 642c 2020 5072 6576 3a20 etached, Prev: │ │ │ │ -00034730: 756e 7365 742c 2020 5570 3a20 436f 6d6d unset, Up: Comm │ │ │ │ -00034740: 616e 642d 6c69 6e65 2061 6e64 206d 656e and-line and men │ │ │ │ -00034750: 7520 656e 7472 7920 636f 6d6d 616e 6473 u entry commands │ │ │ │ -00034760: 0a0a 3136 2e33 2e37 3820 7570 7065 726d ..16.3.78 upperm │ │ │ │ -00034770: 656d 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d em.------------- │ │ │ │ -00034780: 2d2d 2d0a 0a54 6869 7320 636f 6d6d 616e ---..This comman │ │ │ │ -00034790: 6420 6973 206e 6f74 2079 6574 2069 6d70 d is not yet imp │ │ │ │ -000347a0: 6c65 6d65 6e74 6564 2066 6f72 2047 5255 lemented for GRU │ │ │ │ -000347b0: 4220 322c 2061 6c74 686f 7567 6820 6974 B 2, although it │ │ │ │ -000347c0: 2069 7320 706c 616e 6e65 642e 0a0a 1f0a is planned..... │ │ │ │ -000347d0: 4669 6c65 3a20 6772 7562 2e69 6e66 6f2c File: grub.info, │ │ │ │ -000347e0: 2020 4e6f 6465 3a20 7665 7269 6679 5f64 Node: verify_d │ │ │ │ -000347f0: 6574 6163 6865 642c 2020 4e65 7874 3a20 etached, Next: │ │ │ │ -00034800: 7669 6465 6f69 6e66 6f2c 2020 5072 6576 videoinfo, Prev │ │ │ │ -00034810: 3a20 7570 7065 726d 656d 2c20 2055 703a : uppermem, Up: │ │ │ │ -00034820: 2043 6f6d 6d61 6e64 2d6c 696e 6520 616e Command-line an │ │ │ │ -00034830: 6420 6d65 6e75 2065 6e74 7279 2063 6f6d d menu entry com │ │ │ │ -00034840: 6d61 6e64 730a 0a31 362e 332e 3739 2076 mands..16.3.79 v │ │ │ │ -00034850: 6572 6966 795f 6465 7461 6368 6564 0a2d erify_detached.- │ │ │ │ -00034860: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ -00034870: 2d2d 2d2d 2d2d 0a0a 202d 2d20 436f 6d6d ------.. -- Comm │ │ │ │ -00034880: 616e 643a 2076 6572 6966 795f 6465 7461 and: verify_deta │ │ │ │ -00034890: 6368 6564 205b 272d 2d73 6b69 702d 7369 ched ['--skip-si │ │ │ │ -000348a0: 6727 5d20 6669 6c65 2073 6967 6e61 7475 g'] file signatu │ │ │ │ -000348b0: 7265 5f66 696c 650a 2020 2020 2020 2020 re_file. │ │ │ │ -000348c0: 2020 5b70 7562 6b65 795f 6669 6c65 5d0a [pubkey_file]. │ │ │ │ -000348d0: 2020 2020 2056 6572 6966 6965 7320 6120 Verifies a │ │ │ │ -000348e0: 4750 472d 7374 796c 6520 6465 7461 6368 GPG-style detach │ │ │ │ -000348f0: 6564 2073 6967 6e61 7475 7265 2c20 7768 ed signature, wh │ │ │ │ -00034900: 6572 6520 7468 6520 7369 676e 6564 2066 ere the signed f │ │ │ │ -00034910: 696c 6520 6973 0a20 2020 2020 4649 4c45 ile is. FILE │ │ │ │ -00034920: 2c20 616e 6420 7468 6520 7369 676e 6174 , and the signat │ │ │ │ -00034930: 7572 6520 6974 7365 6c66 2069 7320 696e ure itself is in │ │ │ │ -00034940: 2066 696c 6520 5349 474e 4154 5552 455f file SIGNATURE_ │ │ │ │ -00034950: 4649 4c45 2e0a 2020 2020 204f 7074 696f FILE.. Optio │ │ │ │ -00034960: 6e61 6c6c 792c 2061 2073 7065 6369 6669 nally, a specifi │ │ │ │ -00034970: 6320 7075 626c 6963 206b 6579 2074 6f20 c public key to │ │ │ │ -00034980: 7573 6520 6361 6e20 6265 2073 7065 6369 use can be speci │ │ │ │ -00034990: 6669 6564 2075 7369 6e67 0a20 2020 2020 fied using. │ │ │ │ -000349a0: 5055 424b 4559 5f46 494c 452e 2020 5768 PUBKEY_FILE. Wh │ │ │ │ -000349b0: 656e 2065 6e76 6972 6f6e 6d65 6e74 2076 en environment v │ │ │ │ -000349c0: 6172 6961 626c 6520 2763 6865 636b 5f73 ariable 'check_s │ │ │ │ -000349d0: 6967 6e61 7475 7265 7327 2069 7320 7365 ignatures' is se │ │ │ │ -000349e0: 740a 2020 2020 2074 6f20 2765 6e66 6f72 t. to 'enfor │ │ │ │ -000349f0: 6365 272c 2074 6865 6e20 5055 424b 4559 ce', then PUBKEY │ │ │ │ -00034a00: 5f46 494c 4520 6d75 7374 2069 7473 656c _FILE must itsel │ │ │ │ -00034a10: 6620 6265 2070 726f 7065 726c 7920 7369 f be properly si │ │ │ │ -00034a20: 676e 6564 2062 7920 616e 0a20 2020 2020 gned by an. │ │ │ │ -00034a30: 616c 7265 6164 792d 7472 7573 7465 6420 already-trusted │ │ │ │ -00034a40: 6b65 792e 2020 416e 2075 6e73 6967 6e65 key. An unsigne │ │ │ │ -00034a50: 6420 5055 424b 4559 5f46 494c 4520 6361 d PUBKEY_FILE ca │ │ │ │ -00034a60: 6e20 6265 206c 6f61 6465 6420 6279 0a20 n be loaded by. │ │ │ │ -00034a70: 2020 2020 7370 6563 6966 7969 6e67 2027 specifying ' │ │ │ │ -00034a80: 2d2d 736b 6970 2d73 6967 272e 2020 4966 --skip-sig'. If │ │ │ │ -00034a90: 2050 5542 4b45 595f 4649 4c45 2069 7320 PUBKEY_FILE is │ │ │ │ -00034aa0: 6f6d 6974 7465 642c 2074 6865 6e20 7075 omitted, then pu │ │ │ │ -00034ab0: 626c 6963 0a20 2020 2020 6b65 7973 2066 blic. keys f │ │ │ │ -00034ac0: 726f 6d20 4752 5542 2773 2074 7275 7374 rom GRUB's trust │ │ │ │ -00034ad0: 6564 206b 6579 7320 282a 6e6f 7465 206c ed keys (*note l │ │ │ │ -00034ae0: 6973 745f 7472 7573 7465 643a 3a2c 202a ist_trusted::, * │ │ │ │ -00034af0: 6e6f 7465 2074 7275 7374 3a3a 2c0a 2020 note trust::,. │ │ │ │ -00034b00: 2020 2061 6e64 202a 6e6f 7465 2064 6973 and *note dis │ │ │ │ -00034b10: 7472 7573 743a 3a29 2061 7265 2074 7269 trust::) are tri │ │ │ │ -00034b20: 6564 2e0a 0a20 2020 2020 4578 6974 2063 ed... Exit c │ │ │ │ -00034b30: 6f64 6520 2724 3f27 2069 7320 7365 7420 ode '$?' is set │ │ │ │ -00034b40: 746f 2030 2069 6620 7468 6520 7369 676e to 0 if the sign │ │ │ │ -00034b50: 6174 7572 6520 7661 6c69 6461 7465 7320 ature validates │ │ │ │ -00034b60: 7375 6363 6573 7366 756c 6c79 2e0a 2020 successfully.. │ │ │ │ -00034b70: 2020 2049 6620 7661 6c69 6461 7469 6f6e If validation │ │ │ │ -00034b80: 2066 6169 6c73 2c20 6974 2069 7320 7365 fails, it is se │ │ │ │ -00034b90: 7420 746f 2061 206e 6f6e 2d7a 6572 6f20 t to a non-zero │ │ │ │ -00034ba0: 7661 6c75 652e 2020 2a4e 6f74 6520 5573 value. *Note Us │ │ │ │ -00034bb0: 696e 670a 2020 2020 2064 6967 6974 616c ing. digital │ │ │ │ -00034bc0: 2073 6967 6e61 7475 7265 733a 3a2c 2066 signatures::, f │ │ │ │ -00034bd0: 6f72 206d 6f72 6520 696e 666f 726d 6174 or more informat │ │ │ │ -00034be0: 696f 6e2e 0a0a 1f0a 4669 6c65 3a20 6772 ion.....File: gr │ │ │ │ -00034bf0: 7562 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ub.info, Node: │ │ │ │ -00034c00: 7669 6465 6f69 6e66 6f2c 2020 4e65 7874 videoinfo, Next │ │ │ │ -00034c10: 3a20 7772 6d73 722c 2020 5072 6576 3a20 : wrmsr, Prev: │ │ │ │ -00034c20: 7665 7269 6679 5f64 6574 6163 6865 642c verify_detached, │ │ │ │ -00034c30: 2020 5570 3a20 436f 6d6d 616e 642d 6c69 Up: Command-li │ │ │ │ -00034c40: 6e65 2061 6e64 206d 656e 7520 656e 7472 ne and menu entr │ │ │ │ -00034c50: 7920 636f 6d6d 616e 6473 0a0a 3136 2e33 y commands..16.3 │ │ │ │ -00034c60: 2e38 3020 7669 6465 6f69 6e66 6f0a 2d2d .80 videoinfo.-- │ │ │ │ -00034c70: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a ---------------. │ │ │ │ -00034c80: 0a20 2d2d 2043 6f6d 6d61 6e64 3a20 7669 . -- Command: vi │ │ │ │ -00034c90: 6465 6f69 6e66 6f20 5b5b 5778 485d 7844 deoinfo [[WxH]xD │ │ │ │ -00034ca0: 5d0a 2020 2020 204c 6973 7420 6176 6169 ]. List avai │ │ │ │ -00034cb0: 6c61 626c 6520 7669 6465 6f20 6d6f 6465 lable video mode │ │ │ │ -00034cc0: 732e 2020 4966 2072 6573 6f6c 7574 696f s. If resolutio │ │ │ │ -00034cd0: 6e20 6973 2067 6976 656e 2c20 7368 6f77 n is given, show │ │ │ │ -00034ce0: 206f 6e6c 790a 2020 2020 206d 6174 6368 only. match │ │ │ │ -00034cf0: 696e 6720 6d6f 6465 732e 0a0a 1f0a 4669 ing modes.....Fi │ │ │ │ -00034d00: 6c65 3a20 6772 7562 2e69 6e66 6f2c 2020 le: grub.info, │ │ │ │ -00034d10: 4e6f 6465 3a20 7772 6d73 722c 2020 4e65 Node: wrmsr, Ne │ │ │ │ -00034d20: 7874 3a20 7865 6e5f 6879 7065 7276 6973 xt: xen_hypervis │ │ │ │ -00034d30: 6f72 2c20 2050 7265 763a 2076 6964 656f or, Prev: video │ │ │ │ -00034d40: 696e 666f 2c20 2055 703a 2043 6f6d 6d61 info, Up: Comma │ │ │ │ -00034d50: 6e64 2d6c 696e 6520 616e 6420 6d65 6e75 nd-line and menu │ │ │ │ -00034d60: 2065 6e74 7279 2063 6f6d 6d61 6e64 730a entry commands. │ │ │ │ -00034d70: 0a31 362e 332e 3831 2077 726d 7372 0a2d .16.3.81 wrmsr.- │ │ │ │ -00034d80: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d ------------.. - │ │ │ │ -00034d90: 2d20 436f 6d6d 616e 643a 3a20 7772 6d73 - Command:: wrms │ │ │ │ -00034da0: 7220 3078 4144 4452 2030 7856 414c 5545 r 0xADDR 0xVALUE │ │ │ │ -00034db0: 0a20 2020 2020 5772 6974 6520 6120 3078 . Write a 0x │ │ │ │ -00034dc0: 5641 4c55 4520 746f 2061 206d 6f64 656c VALUE to a model │ │ │ │ -00034dd0: 2d73 7065 6369 6669 6320 7265 6769 7374 -specific regist │ │ │ │ -00034de0: 6572 2061 7420 6164 6472 6573 7320 3078 er at address 0x │ │ │ │ -00034df0: 4144 4452 2e0a 0a20 2020 2020 506c 6561 ADDR... Plea │ │ │ │ -00034e00: 7365 206e 6f74 6520 7468 6174 206f 6e20 se note that on │ │ │ │ -00034e10: 534d 5020 7379 7374 656d 732c 2077 7269 SMP systems, wri │ │ │ │ -00034e20: 7469 6e67 2074 6f20 6120 4d53 5220 7468 ting to a MSR th │ │ │ │ -00034e30: 6174 2068 6173 2061 2073 636f 7065 0a20 at has a scope. │ │ │ │ -00034e40: 2020 2020 7065 7220 6861 7264 7761 7265 per hardware │ │ │ │ -00034e50: 2074 6872 6561 642c 2069 6d70 6c69 6573 thread, implies │ │ │ │ -00034e60: 2074 6861 7420 7468 6520 7661 6c75 6520 that the value │ │ │ │ -00034e70: 7468 6174 2069 7320 7772 6974 7465 6e20 that is written │ │ │ │ -00034e80: 6f6e 6c79 0a20 2020 2020 6170 706c 6965 only. applie │ │ │ │ -00034e90: 7320 746f 2074 6865 2070 6172 7469 6375 s to the particu │ │ │ │ -00034ea0: 6c61 7220 6370 752f 636f 7265 2f74 6872 lar cpu/core/thr │ │ │ │ -00034eb0: 6561 6420 7468 6174 2072 756e 7320 7468 ead that runs th │ │ │ │ -00034ec0: 6520 636f 6d6d 616e 642e 0a0a 2020 2020 e command... │ │ │ │ -00034ed0: 2041 6c73 6f2c 2069 6620 796f 7520 7370 Also, if you sp │ │ │ │ -00034ee0: 6563 6966 7920 6120 7265 7365 7276 6564 ecify a reserved │ │ │ │ -00034ef0: 206f 7220 756e 696d 706c 656d 656e 7465 or unimplemente │ │ │ │ -00034f00: 6420 4d53 5220 6164 6472 6573 732c 2069 d MSR address, i │ │ │ │ -00034f10: 740a 2020 2020 2077 696c 6c20 6361 7573 t. will caus │ │ │ │ -00034f20: 6520 6120 6765 6e65 7261 6c20 7072 6f74 e a general prot │ │ │ │ -00034f30: 6563 7469 6f6e 2065 7863 6570 7469 6f6e ection exception │ │ │ │ -00034f40: 2028 7768 6963 6820 6973 206e 6f74 2063 (which is not c │ │ │ │ -00034f50: 7572 7265 6e74 6c79 0a20 2020 2020 6265 urrently. be │ │ │ │ -00034f60: 696e 6720 6861 6e64 6c65 6429 2061 6e64 ing handled) and │ │ │ │ -00034f70: 2074 6865 2073 7973 7465 6d20 7769 6c6c the system will │ │ │ │ -00034f80: 2072 6562 6f6f 742e 0a0a 2020 2020 204e reboot... N │ │ │ │ -00034f90: 6f74 653a 2054 6865 2063 6f6d 6d61 6e64 ote: The command │ │ │ │ -00034fa0: 2069 7320 6e6f 7420 616c 6c6f 7765 6420 is not allowed │ │ │ │ -00034fb0: 7768 656e 206c 6f63 6b64 6f77 6e20 6973 when lockdown is │ │ │ │ -00034fc0: 2065 6e66 6f72 6365 6420 282a 6e6f 7465 enforced (*note │ │ │ │ -00034fd0: 0a20 2020 2020 4c6f 636b 646f 776e 3a3a . Lockdown:: │ │ │ │ -00034fe0: 292e 2020 5468 6973 2069 7320 646f 6e65 ). This is done │ │ │ │ -00034ff0: 2074 6f20 7072 6576 656e 7420 7375 6276 to prevent subv │ │ │ │ -00035000: 6572 7469 6e67 2076 6172 696f 7573 2073 erting various s │ │ │ │ -00035010: 6563 7572 6974 790a 2020 2020 206d 6563 ecurity. mec │ │ │ │ -00035020: 6861 6e69 736d 732e 0a0a 1f0a 4669 6c65 hanisms.....File │ │ │ │ -00035030: 3a20 6772 7562 2e69 6e66 6f2c 2020 4e6f : grub.info, No │ │ │ │ -00035040: 6465 3a20 7865 6e5f 6879 7065 7276 6973 de: xen_hypervis │ │ │ │ -00035050: 6f72 2c20 204e 6578 743a 2078 656e 5f6d or, Next: xen_m │ │ │ │ -00035060: 6f64 756c 652c 2020 5072 6576 3a20 7772 odule, Prev: wr │ │ │ │ -00035070: 6d73 722c 2020 5570 3a20 436f 6d6d 616e msr, Up: Comman │ │ │ │ -00035080: 642d 6c69 6e65 2061 6e64 206d 656e 7520 d-line and menu │ │ │ │ -00035090: 656e 7472 7920 636f 6d6d 616e 6473 0a0a entry commands.. │ │ │ │ -000350a0: 3136 2e33 2e38 3220 7865 6e5f 6879 7065 16.3.82 xen_hype │ │ │ │ -000350b0: 7276 6973 6f72 0a2d 2d2d 2d2d 2d2d 2d2d rvisor.--------- │ │ │ │ -000350c0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 -------------.. │ │ │ │ -000350d0: 2d2d 2043 6f6d 6d61 6e64 3a20 7865 6e5f -- Command: xen_ │ │ │ │ -000350e0: 6879 7065 7276 6973 6f72 2066 696c 6520 hypervisor file │ │ │ │ -000350f0: 5b61 7267 756d 656e 7473 5d20 2e2e 2e0a [arguments] .... │ │ │ │ -00035100: 2020 2020 204c 6f61 6420 6120 5865 6e20 Load a Xen │ │ │ │ -00035110: 6879 7065 7276 6973 6f72 2062 696e 6172 hypervisor binar │ │ │ │ -00035120: 7920 6672 6f6d 2046 494c 452e 2020 5468 y from FILE. Th │ │ │ │ -00035130: 6520 7265 7374 206f 6620 7468 6520 6c69 e rest of the li │ │ │ │ -00035140: 6e65 2069 730a 2020 2020 2070 6173 7365 ne is. passe │ │ │ │ -00035150: 6420 7665 7262 6174 696d 2061 7320 7468 d verbatim as th │ │ │ │ -00035160: 6520 226b 6572 6e65 6c20 636f 6d6d 616e e "kernel comman │ │ │ │ -00035170: 642d 6c69 6e65 222e 2020 416e 7920 6f74 d-line". Any ot │ │ │ │ -00035180: 6865 7220 6269 6e61 7269 6573 0a20 2020 her binaries. │ │ │ │ -00035190: 2020 6d75 7374 2062 6520 7265 6c6f 6164 must be reload │ │ │ │ -000351a0: 6564 2061 6674 6572 2075 7369 6e67 2074 ed after using t │ │ │ │ -000351b0: 6869 7320 636f 6d6d 616e 642e 2020 5468 his command. Th │ │ │ │ -000351c0: 6973 2063 6f6d 6d61 6e64 2069 7320 6f6e is command is on │ │ │ │ -000351d0: 6c79 0a20 2020 2020 6176 6169 6c61 626c ly. availabl │ │ │ │ -000351e0: 6520 6f6e 2041 4172 6368 3634 2073 7973 e on AArch64 sys │ │ │ │ -000351f0: 7465 6d73 2e0a 0a1f 0a46 696c 653a 2067 tems.....File: g │ │ │ │ -00035200: 7275 622e 696e 666f 2c20 204e 6f64 653a rub.info, Node: │ │ │ │ -00035210: 2078 656e 5f6d 6f64 756c 652c 2020 5072 xen_module, Pr │ │ │ │ -00035220: 6576 3a20 7865 6e5f 6879 7065 7276 6973 ev: xen_hypervis │ │ │ │ -00035230: 6f72 2c20 2055 703a 2043 6f6d 6d61 6e64 or, Up: Command │ │ │ │ -00035240: 2d6c 696e 6520 616e 6420 6d65 6e75 2065 -line and menu e │ │ │ │ -00035250: 6e74 7279 2063 6f6d 6d61 6e64 730a 0a31 ntry commands..1 │ │ │ │ -00035260: 362e 332e 3833 2078 656e 5f6d 6f64 756c 6.3.83 xen_modul │ │ │ │ -00035270: 650a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d e.-------------- │ │ │ │ -00035280: 2d2d 2d2d 0a0a 202d 2d20 436f 6d6d 616e ----.. -- Comman │ │ │ │ -00035290: 643a 2078 656e 5f6d 6f64 756c 6520 5b2d d: xen_module [- │ │ │ │ -000352a0: 2d6e 6f75 6e7a 6970 5d20 6669 6c65 205b -nounzip] file [ │ │ │ │ -000352b0: 6172 6775 6d65 6e74 735d 0a20 2020 2020 arguments]. │ │ │ │ -000352c0: 4c6f 6164 2061 206d 6f64 756c 6520 666f Load a module fo │ │ │ │ -000352d0: 7220 7865 6e20 6879 7065 7276 6973 6f72 r xen hypervisor │ │ │ │ -000352e0: 2061 7420 7468 6520 626f 6f74 696e 6720 at the booting │ │ │ │ -000352f0: 7072 6f63 6573 7320 6f66 2078 656e 2e0a process of xen.. │ │ │ │ -00035300: 2020 2020 2054 6865 2072 6573 7420 6f66 The rest of │ │ │ │ -00035310: 2074 6865 206c 696e 6520 6973 2070 6173 the line is pas │ │ │ │ -00035320: 7365 6420 7665 7262 6174 696d 2061 7320 sed verbatim as │ │ │ │ -00035330: 7468 6520 6d6f 6475 6c65 2063 6f6d 6d61 the module comma │ │ │ │ -00035340: 6e64 206c 696e 652e 0a20 2020 2020 4d6f nd line.. Mo │ │ │ │ -00035350: 6475 6c65 7320 7368 6f75 6c64 2062 6520 dules should be │ │ │ │ -00035360: 6c6f 6164 6564 2069 6e20 7468 6520 666f loaded in the fo │ │ │ │ -00035370: 6c6c 6f77 696e 6720 6f72 6465 723a 202d llowing order: - │ │ │ │ -00035380: 2064 6f6d 3020 6b65 726e 656c 0a20 2020 dom0 kernel. │ │ │ │ -00035390: 2020 696d 6167 6520 2d20 646f 6d30 2072 image - dom0 r │ │ │ │ -000353a0: 616d 6469 736b 2069 6620 7072 6573 656e amdisk if presen │ │ │ │ -000353b0: 7420 2d20 5853 4d20 706f 6c69 6379 2069 t - XSM policy i │ │ │ │ -000353c0: 6620 7072 6573 656e 7420 5468 6973 0a20 f present This. │ │ │ │ -000353d0: 2020 2020 636f 6d6d 616e 6420 6973 206f command is o │ │ │ │ -000353e0: 6e6c 7920 6176 6169 6c61 626c 6520 6f6e nly available on │ │ │ │ -000353f0: 2041 4172 6368 3634 2073 7973 7465 6d73 AArch64 systems │ │ │ │ -00035400: 2e0a 0a1f 0a46 696c 653a 2067 7275 622e .....File: grub. │ │ │ │ -00035410: 696e 666f 2c20 204e 6f64 653a 204e 6574 info, Node: Net │ │ │ │ -00035420: 776f 726b 696e 6720 636f 6d6d 616e 6473 working commands │ │ │ │ -00035430: 2c20 2050 7265 763a 2043 6f6d 6d61 6e64 , Prev: Command │ │ │ │ -00035440: 2d6c 696e 6520 616e 6420 6d65 6e75 2065 -line and menu e │ │ │ │ -00035450: 6e74 7279 2063 6f6d 6d61 6e64 732c 2020 ntry commands, │ │ │ │ -00035460: 5570 3a20 436f 6d6d 616e 6473 0a0a 3136 Up: Commands..16 │ │ │ │ -00035470: 2e34 2054 6865 206c 6973 7420 6f66 206e .4 The list of n │ │ │ │ -00035480: 6574 776f 726b 696e 6720 636f 6d6d 616e etworking comman │ │ │ │ -00035490: 6473 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ds.============= │ │ │ │ +00032980: 2020 2020 2020 2020 204c 6566 740a 2020 Left. │ │ │ │ +00032990: 2020 2072 6967 6874 2020 2020 2020 2020 right │ │ │ │ +000329a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +000329b0: 2052 6967 6874 0a0a 2020 2020 2041 7320 Right.. As │ │ │ │ +000329c0: 7765 6c6c 2061 7320 6b65 7973 7472 6f6b well as keystrok │ │ │ │ +000329d0: 6573 2c20 7468 6520 2773 656e 646b 6579 es, the 'sendkey │ │ │ │ +000329e0: 2720 636f 6d6d 616e 6420 7461 6b65 7320 ' command takes │ │ │ │ +000329f0: 7661 7269 6f75 7320 6f70 7469 6f6e 730a various options. │ │ │ │ +00032a00: 2020 2020 2074 6861 7420 6166 6665 6374 that affect │ │ │ │ +00032a10: 2074 6865 2042 494f 5320 6b65 7962 6f61 the BIOS keyboa │ │ │ │ +00032a20: 7264 2073 7461 7475 7320 666c 6167 732e rd status flags. │ │ │ │ +00032a30: 2020 5468 6573 6520 6f70 7469 6f6e 7320 These options │ │ │ │ +00032a40: 7461 6b65 2061 6e0a 2020 2020 2027 6f6e take an. 'on │ │ │ │ +00032a50: 2720 6f72 2027 6f66 6627 2070 6172 616d ' or 'off' param │ │ │ │ +00032a60: 6574 6572 2c20 7370 6563 6966 7969 6e67 eter, specifying │ │ │ │ +00032a70: 2074 6861 7420 7468 6520 636f 7272 6573 that the corres │ │ │ │ +00032a80: 706f 6e64 696e 6720 7374 6174 7573 0a20 ponding status. │ │ │ │ +00032a90: 2020 2020 666c 6167 2062 6520 7365 7420 flag be set │ │ │ │ +00032aa0: 6f72 2075 6e73 6574 3b20 6f6d 6974 7469 or unset; omitti │ │ │ │ +00032ab0: 6e67 2074 6865 206f 7074 696f 6e20 666f ng the option fo │ │ │ │ +00032ac0: 7220 6120 6769 7665 6e20 7374 6174 7573 r a given status │ │ │ │ +00032ad0: 2066 6c61 670a 2020 2020 2077 696c 6c20 flag. will │ │ │ │ +00032ae0: 6c65 6176 6520 7468 6174 2066 6c61 6720 leave that flag │ │ │ │ +00032af0: 6174 2069 7473 2069 6e69 7469 616c 2073 at its initial s │ │ │ │ +00032b00: 7461 7465 2061 7420 626f 6f74 2e20 2054 tate at boot. T │ │ │ │ +00032b10: 6865 2027 2d2d 6e75 6d27 2c0a 2020 2020 he '--num',. │ │ │ │ +00032b20: 2027 2d2d 6361 7073 272c 2027 2d2d 7363 '--caps', '--sc │ │ │ │ +00032b30: 726f 6c6c 272c 2061 6e64 2027 2d2d 696e roll', and '--in │ │ │ │ +00032b40: 7365 7274 2720 6f70 7469 6f6e 7320 656d sert' options em │ │ │ │ +00032b50: 756c 6174 6520 7365 7474 696e 6720 7468 ulate setting th │ │ │ │ +00032b60: 650a 2020 2020 2063 6f72 7265 7370 6f6e e. correspon │ │ │ │ +00032b70: 6469 6e67 206d 6f64 652c 2077 6869 6c65 ding mode, while │ │ │ │ +00032b80: 2074 6865 2027 2d2d 6e75 6d6b 6579 272c the '--numkey', │ │ │ │ +00032b90: 2027 2d2d 6361 7073 6b65 7927 2c0a 2020 '--capskey',. │ │ │ │ +00032ba0: 2020 2027 2d2d 7363 726f 6c6c 6b65 7927 '--scrollkey' │ │ │ │ +00032bb0: 2c20 616e 6420 272d 2d69 6e73 6572 746b , and '--insertk │ │ │ │ +00032bc0: 6579 2720 6f70 7469 6f6e 7320 656d 756c ey' options emul │ │ │ │ +00032bd0: 6174 6520 7072 6573 7369 6e67 2061 6e64 ate pressing and │ │ │ │ +00032be0: 0a20 2020 2020 686f 6c64 696e 6720 7468 . holding th │ │ │ │ +00032bf0: 6520 636f 7272 6573 706f 6e64 696e 6720 e corresponding │ │ │ │ +00032c00: 6b65 792e 2020 5468 6520 6f74 6865 7220 key. The other │ │ │ │ +00032c10: 7374 6174 7573 2066 6c61 6720 6f70 7469 status flag opti │ │ │ │ +00032c20: 6f6e 7320 6172 650a 2020 2020 2073 656c ons are. sel │ │ │ │ +00032c30: 662d 6578 706c 616e 6174 6f72 792e 0a0a f-explanatory... │ │ │ │ +00032c40: 2020 2020 2049 6620 7468 6520 272d 2d6e If the '--n │ │ │ │ +00032c50: 6f2d 6c65 6427 206f 7074 696f 6e20 6973 o-led' option is │ │ │ │ +00032c60: 2067 6976 656e 2c20 7468 6520 7374 6174 given, the stat │ │ │ │ +00032c70: 7573 2066 6c61 6720 6f70 7469 6f6e 7320 us flag options │ │ │ │ +00032c80: 7769 6c6c 0a20 2020 2020 6861 7665 206e will. have n │ │ │ │ +00032c90: 6f20 6566 6665 6374 206f 6e20 6b65 7962 o effect on keyb │ │ │ │ +00032ca0: 6f61 7264 204c 4544 732e 0a0a 2020 2020 oard LEDs... │ │ │ │ +00032cb0: 2049 6620 7468 6520 2773 656e 646b 6579 If the 'sendkey │ │ │ │ +00032cc0: 2720 636f 6d6d 616e 6420 6973 2067 6976 ' command is giv │ │ │ │ +00032cd0: 656e 206d 756c 7469 706c 6520 7469 6d65 en multiple time │ │ │ │ +00032ce0: 732c 2074 6865 6e20 6f6e 6c79 2074 6865 s, then only the │ │ │ │ +00032cf0: 0a20 2020 2020 6c61 7374 2069 6e76 6f63 . last invoc │ │ │ │ +00032d00: 6174 696f 6e20 6861 7320 616e 7920 6566 ation has any ef │ │ │ │ +00032d10: 6665 6374 2e0a 0a20 2020 2020 5369 6e63 fect... Sinc │ │ │ │ +00032d20: 6520 2773 656e 646b 6579 2720 6d61 6e69 e 'sendkey' mani │ │ │ │ +00032d30: 7075 6c61 7465 7320 7468 6520 4249 4f53 pulates the BIOS │ │ │ │ +00032d40: 206b 6579 626f 6172 6420 6275 6666 6572 keyboard buffer │ │ │ │ +00032d50: 2c20 6974 206d 6179 2063 6175 7365 0a20 , it may cause. │ │ │ │ +00032d60: 2020 2020 6861 6e67 732c 2072 6562 6f6f hangs, reboo │ │ │ │ +00032d70: 7473 2c20 6f72 206f 7468 6572 206d 6973 ts, or other mis │ │ │ │ +00032d80: 6265 6861 7669 6f75 7220 6f6e 2073 6f6d behaviour on som │ │ │ │ +00032d90: 6520 7379 7374 656d 732e 2020 4966 2074 e systems. If t │ │ │ │ +00032da0: 6865 0a20 2020 2020 6f70 6572 6174 696e he. operatin │ │ │ │ +00032db0: 6720 7379 7374 656d 206f 7220 626f 6f74 g system or boot │ │ │ │ +00032dc0: 206c 6f61 6465 7220 7468 6174 2072 756e loader that run │ │ │ │ +00032dd0: 7320 6166 7465 7220 4752 5542 2075 7365 s after GRUB use │ │ │ │ +00032de0: 7320 6974 7320 6f77 6e0a 2020 2020 206b s its own. k │ │ │ │ +00032df0: 6579 626f 6172 6420 6472 6976 6572 2072 eyboard driver r │ │ │ │ +00032e00: 6174 6865 7220 7468 616e 2074 6865 2042 ather than the B │ │ │ │ +00032e10: 494f 5320 6b65 7962 6f61 7264 2066 756e IOS keyboard fun │ │ │ │ +00032e20: 6374 696f 6e73 2c20 7468 656e 0a20 2020 ctions, then. │ │ │ │ +00032e30: 2020 2773 656e 646b 6579 2720 7769 6c6c 'sendkey' will │ │ │ │ +00032e40: 2068 6176 6520 6e6f 2065 6666 6563 742e have no effect. │ │ │ │ +00032e50: 0a0a 2020 2020 2054 6869 7320 636f 6d6d .. This comm │ │ │ │ +00032e60: 616e 6420 6973 206f 6e6c 7920 6176 6169 and is only avai │ │ │ │ +00032e70: 6c61 626c 6520 6f6e 2050 4320 4249 4f53 lable on PC BIOS │ │ │ │ +00032e80: 2073 7973 7465 6d73 2e0a 0a1f 0a46 696c systems.....Fil │ │ │ │ +00032e90: 653a 2067 7275 622e 696e 666f 2c20 204e e: grub.info, N │ │ │ │ +00032ea0: 6f64 653a 2073 6574 2c20 204e 6578 743a ode: set, Next: │ │ │ │ +00032eb0: 2073 6861 3173 756d 2c20 2050 7265 763a sha1sum, Prev: │ │ │ │ +00032ec0: 2073 656e 646b 6579 2c20 2055 703a 2043 sendkey, Up: C │ │ │ │ +00032ed0: 6f6d 6d61 6e64 2d6c 696e 6520 616e 6420 ommand-line and │ │ │ │ +00032ee0: 6d65 6e75 2065 6e74 7279 2063 6f6d 6d61 menu entry comma │ │ │ │ +00032ef0: 6e64 730a 0a31 362e 332e 3638 2073 6574 nds..16.3.68 set │ │ │ │ +00032f00: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d .-----------.. - │ │ │ │ +00032f10: 2d20 436f 6d6d 616e 643a 2073 6574 205b - Command: set [ │ │ │ │ +00032f20: 656e 7676 6172 3d76 616c 7565 5d0a 2020 envvar=value]. │ │ │ │ +00032f30: 2020 2053 6574 2074 6865 2065 6e76 6972 Set the envir │ │ │ │ +00032f40: 6f6e 6d65 6e74 2076 6172 6961 626c 6520 onment variable │ │ │ │ +00032f50: 454e 5656 4152 2074 6f20 5641 4c55 452e ENVVAR to VALUE. │ │ │ │ +00032f60: 2020 4966 2069 6e76 6f6b 6564 2077 6974 If invoked wit │ │ │ │ +00032f70: 6820 6e6f 0a20 2020 2020 6172 6775 6d65 h no. argume │ │ │ │ +00032f80: 6e74 732c 2070 7269 6e74 2061 6c6c 2065 nts, print all e │ │ │ │ +00032f90: 6e76 6972 6f6e 6d65 6e74 2076 6172 6961 nvironment varia │ │ │ │ +00032fa0: 626c 6573 2077 6974 6820 7468 6569 7220 bles with their │ │ │ │ +00032fb0: 7661 6c75 6573 2e0a 0a1f 0a46 696c 653a values.....File: │ │ │ │ +00032fc0: 2067 7275 622e 696e 666f 2c20 204e 6f64 grub.info, Nod │ │ │ │ +00032fd0: 653a 2073 6861 3173 756d 2c20 204e 6578 e: sha1sum, Nex │ │ │ │ +00032fe0: 743a 2073 6861 3235 3673 756d 2c20 2050 t: sha256sum, P │ │ │ │ +00032ff0: 7265 763a 2073 6574 2c20 2055 703a 2043 rev: set, Up: C │ │ │ │ +00033000: 6f6d 6d61 6e64 2d6c 696e 6520 616e 6420 ommand-line and │ │ │ │ +00033010: 6d65 6e75 2065 6e74 7279 2063 6f6d 6d61 menu entry comma │ │ │ │ +00033020: 6e64 730a 0a31 362e 332e 3639 2073 6861 nds..16.3.69 sha │ │ │ │ +00033030: 3173 756d 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 1sum.----------- │ │ │ │ +00033040: 2d2d 2d2d 0a0a 202d 2d20 436f 6d6d 616e ----.. -- Comman │ │ │ │ +00033050: 643a 2073 6861 3173 756d 2061 7267 202e d: sha1sum arg . │ │ │ │ +00033060: 2e2e 0a20 2020 2020 416c 6961 7320 666f ... Alias fo │ │ │ │ +00033070: 7220 2768 6173 6873 756d 202d 2d68 6173 r 'hashsum --has │ │ │ │ +00033080: 6820 7368 6131 2061 7267 202e 2e2e 272e h sha1 arg ...'. │ │ │ │ +00033090: 2020 5365 6520 636f 6d6d 616e 6420 2768 See command 'h │ │ │ │ +000330a0: 6173 6873 756d 270a 2020 2020 2028 2a6e ashsum'. (*n │ │ │ │ +000330b0: 6f74 6520 6861 7368 7375 6d3a 3a29 2066 ote hashsum::) f │ │ │ │ +000330c0: 6f72 2066 756c 6c20 6465 7363 7269 7074 or full descript │ │ │ │ +000330d0: 696f 6e2e 0a0a 1f0a 4669 6c65 3a20 6772 ion.....File: gr │ │ │ │ +000330e0: 7562 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ub.info, Node: │ │ │ │ +000330f0: 7368 6132 3536 7375 6d2c 2020 4e65 7874 sha256sum, Next │ │ │ │ +00033100: 3a20 7368 6135 3132 7375 6d2c 2020 5072 : sha512sum, Pr │ │ │ │ +00033110: 6576 3a20 7368 6131 7375 6d2c 2020 5570 ev: sha1sum, Up │ │ │ │ +00033120: 3a20 436f 6d6d 616e 642d 6c69 6e65 2061 : Command-line a │ │ │ │ +00033130: 6e64 206d 656e 7520 656e 7472 7920 636f nd menu entry co │ │ │ │ +00033140: 6d6d 616e 6473 0a0a 3136 2e33 2e37 3020 mmands..16.3.70 │ │ │ │ +00033150: 7368 6132 3536 7375 6d0a 2d2d 2d2d 2d2d sha256sum.------ │ │ │ │ +00033160: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d -----------.. -- │ │ │ │ +00033170: 2043 6f6d 6d61 6e64 3a20 7368 6132 3536 Command: sha256 │ │ │ │ +00033180: 7375 6d20 6172 6720 2e2e 2e0a 2020 2020 sum arg .... │ │ │ │ +00033190: 2041 6c69 6173 2066 6f72 2027 6861 7368 Alias for 'hash │ │ │ │ +000331a0: 7375 6d20 2d2d 6861 7368 2073 6861 3235 sum --hash sha25 │ │ │ │ +000331b0: 3620 6172 6720 2e2e 2e27 2e20 2053 6565 6 arg ...'. See │ │ │ │ +000331c0: 2063 6f6d 6d61 6e64 2027 6861 7368 7375 command 'hashsu │ │ │ │ +000331d0: 6d27 0a20 2020 2020 282a 6e6f 7465 2068 m'. (*note h │ │ │ │ +000331e0: 6173 6873 756d 3a3a 2920 666f 7220 6675 ashsum::) for fu │ │ │ │ +000331f0: 6c6c 2064 6573 6372 6970 7469 6f6e 2e0a ll description.. │ │ │ │ +00033200: 0a1f 0a46 696c 653a 2067 7275 622e 696e ...File: grub.in │ │ │ │ +00033210: 666f 2c20 204e 6f64 653a 2073 6861 3531 fo, Node: sha51 │ │ │ │ +00033220: 3273 756d 2c20 204e 6578 743a 2073 6c65 2sum, Next: sle │ │ │ │ +00033230: 6570 2c20 2050 7265 763a 2073 6861 3235 ep, Prev: sha25 │ │ │ │ +00033240: 3673 756d 2c20 2055 703a 2043 6f6d 6d61 6sum, Up: Comma │ │ │ │ +00033250: 6e64 2d6c 696e 6520 616e 6420 6d65 6e75 nd-line and menu │ │ │ │ +00033260: 2065 6e74 7279 2063 6f6d 6d61 6e64 730a entry commands. │ │ │ │ +00033270: 0a31 362e 332e 3731 2073 6861 3531 3273 .16.3.71 sha512s │ │ │ │ +00033280: 756d 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d um.------------- │ │ │ │ +00033290: 2d2d 2d2d 0a0a 202d 2d20 436f 6d6d 616e ----.. -- Comman │ │ │ │ +000332a0: 643a 2073 6861 3531 3273 756d 2061 7267 d: sha512sum arg │ │ │ │ +000332b0: 202e 2e2e 0a20 2020 2020 416c 6961 7320 .... Alias │ │ │ │ +000332c0: 666f 7220 2768 6173 6873 756d 202d 2d68 for 'hashsum --h │ │ │ │ +000332d0: 6173 6820 7368 6135 3132 2061 7267 202e ash sha512 arg . │ │ │ │ +000332e0: 2e2e 272e 2020 5365 6520 636f 6d6d 616e ..'. See comman │ │ │ │ +000332f0: 6420 2768 6173 6873 756d 270a 2020 2020 d 'hashsum'. │ │ │ │ +00033300: 2028 2a6e 6f74 6520 6861 7368 7375 6d3a (*note hashsum: │ │ │ │ +00033310: 3a29 2066 6f72 2066 756c 6c20 6465 7363 :) for full desc │ │ │ │ +00033320: 7269 7074 696f 6e2e 0a0a 1f0a 4669 6c65 ription.....File │ │ │ │ +00033330: 3a20 6772 7562 2e69 6e66 6f2c 2020 4e6f : grub.info, No │ │ │ │ +00033340: 6465 3a20 736c 6565 702c 2020 4e65 7874 de: sleep, Next │ │ │ │ +00033350: 3a20 736f 7572 6365 2c20 2050 7265 763a : source, Prev: │ │ │ │ +00033360: 2073 6861 3531 3273 756d 2c20 2055 703a sha512sum, Up: │ │ │ │ +00033370: 2043 6f6d 6d61 6e64 2d6c 696e 6520 616e Command-line an │ │ │ │ +00033380: 6420 6d65 6e75 2065 6e74 7279 2063 6f6d d menu entry com │ │ │ │ +00033390: 6d61 6e64 730a 0a31 362e 332e 3732 2073 mands..16.3.72 s │ │ │ │ +000333a0: 6c65 6570 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d leep.----------- │ │ │ │ +000333b0: 2d2d 0a0a 202d 2d20 436f 6d6d 616e 643a --.. -- Command: │ │ │ │ +000333c0: 2073 6c65 6570 205b 272d 2d76 6572 626f sleep ['--verbo │ │ │ │ +000333d0: 7365 275d 205b 272d 2d69 6e74 6572 7275 se'] ['--interru │ │ │ │ +000333e0: 7074 6962 6c65 275d 2063 6f75 6e74 0a20 ptible'] count. │ │ │ │ +000333f0: 2020 2020 536c 6565 7020 666f 7220 434f Sleep for CO │ │ │ │ +00033400: 554e 5420 7365 636f 6e64 732e 2020 4966 UNT seconds. If │ │ │ │ +00033410: 206f 7074 696f 6e20 272d 2d69 6e74 6572 option '--inter │ │ │ │ +00033420: 7275 7074 6962 6c65 2720 6973 2067 6976 ruptible' is giv │ │ │ │ +00033430: 656e 2c0a 2020 2020 2061 6c6c 6f77 203c en,. allow < │ │ │ │ +00033440: 4553 433e 2074 6f20 696e 7465 7272 7570 ESC> to interrup │ │ │ │ +00033450: 7420 736c 6565 702e 2020 5769 7468 2027 t sleep. With ' │ │ │ │ +00033460: 2d2d 7665 7262 6f73 6527 2073 686f 7720 --verbose' show │ │ │ │ +00033470: 636f 756e 7464 6f77 6e20 6f66 0a20 2020 countdown of. │ │ │ │ +00033480: 2020 7265 6d61 696e 696e 6720 7365 636f remaining seco │ │ │ │ +00033490: 6e64 732e 2020 4578 6974 2063 6f64 6520 nds. Exit code │ │ │ │ +000334a0: 6973 2073 6574 2074 6f20 3020 6966 2074 is set to 0 if t │ │ │ │ +000334b0: 696d 656f 7574 2065 7870 6972 6564 2061 imeout expired a │ │ │ │ +000334c0: 6e64 2074 6f0a 2020 2020 2031 2069 6620 nd to. 1 if │ │ │ │ +000334d0: 7469 6d65 6f75 7420 7761 7320 696e 7465 timeout was inte │ │ │ │ +000334e0: 7272 7570 7465 6420 6279 203c 4553 433e rrupted by │ │ │ │ +000334f0: 2e0a 0a1f 0a46 696c 653a 2067 7275 622e .....File: grub. │ │ │ │ +00033500: 696e 666f 2c20 204e 6f64 653a 2073 6f75 info, Node: sou │ │ │ │ +00033510: 7263 652c 2020 4e65 7874 3a20 7465 7374 rce, Next: test │ │ │ │ +00033520: 2c20 2050 7265 763a 2073 6c65 6570 2c20 , Prev: sleep, │ │ │ │ +00033530: 2055 703a 2043 6f6d 6d61 6e64 2d6c 696e Up: Command-lin │ │ │ │ +00033540: 6520 616e 6420 6d65 6e75 2065 6e74 7279 e and menu entry │ │ │ │ +00033550: 2063 6f6d 6d61 6e64 730a 0a31 362e 332e commands..16.3. │ │ │ │ +00033560: 3733 2073 6f75 7263 650a 2d2d 2d2d 2d2d 73 source.------ │ │ │ │ +00033570: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 436f --------.. -- Co │ │ │ │ +00033580: 6d6d 616e 643a 2073 6f75 7263 6520 6669 mmand: source fi │ │ │ │ +00033590: 6c65 0a20 2020 2020 5265 6164 2046 494c le. Read FIL │ │ │ │ +000335a0: 4520 6173 2061 2063 6f6e 6669 6775 7261 E as a configura │ │ │ │ +000335b0: 7469 6f6e 2066 696c 652c 2061 7320 6966 tion file, as if │ │ │ │ +000335c0: 2069 7473 2063 6f6e 7465 6e74 7320 6861 its contents ha │ │ │ │ +000335d0: 6420 6265 656e 0a20 2020 2020 696e 636f d been. inco │ │ │ │ +000335e0: 7270 6f72 6174 6564 2064 6972 6563 746c rporated directl │ │ │ │ +000335f0: 7920 696e 746f 2074 6865 2073 6f75 7263 y into the sourc │ │ │ │ +00033600: 696e 6720 6669 6c65 2e20 2055 6e6c 696b ing file. Unlik │ │ │ │ +00033610: 6520 2763 6f6e 6669 6766 696c 6527 0a20 e 'configfile'. │ │ │ │ +00033620: 2020 2020 282a 6e6f 7465 2063 6f6e 6669 (*note confi │ │ │ │ +00033630: 6766 696c 653a 3a29 2c20 7468 6973 2065 gfile::), this e │ │ │ │ +00033640: 7865 6375 7465 7320 7468 6520 636f 6e74 xecutes the cont │ │ │ │ +00033650: 656e 7473 206f 6620 4649 4c45 2077 6974 ents of FILE wit │ │ │ │ +00033660: 686f 7574 0a20 2020 2020 6368 616e 6769 hout. changi │ │ │ │ +00033670: 6e67 2063 6f6e 7465 7874 3a20 616e 7920 ng context: any │ │ │ │ +00033680: 656e 7669 726f 6e6d 656e 7420 7661 7269 environment vari │ │ │ │ +00033690: 6162 6c65 2063 6861 6e67 6573 206d 6164 able changes mad │ │ │ │ +000336a0: 6520 6279 2074 6865 0a20 2020 2020 636f e by the. co │ │ │ │ +000336b0: 6d6d 616e 6473 2069 6e20 4649 4c45 2077 mmands in FILE w │ │ │ │ +000336c0: 696c 6c20 6265 2070 7265 7365 7276 6564 ill be preserved │ │ │ │ +000336d0: 2061 6674 6572 2027 736f 7572 6365 2720 after 'source' │ │ │ │ +000336e0: 7265 7475 726e 732c 2061 6e64 2074 6865 returns, and the │ │ │ │ +000336f0: 0a20 2020 2020 6d65 6e75 2077 696c 6c20 . menu will │ │ │ │ +00033700: 6e6f 7420 6265 2073 686f 776e 2069 6d6d not be shown imm │ │ │ │ +00033710: 6564 6961 7465 6c79 2e0a 0a1f 0a46 696c ediately.....Fil │ │ │ │ +00033720: 653a 2067 7275 622e 696e 666f 2c20 204e e: grub.info, N │ │ │ │ +00033730: 6f64 653a 2074 6573 742c 2020 4e65 7874 ode: test, Next │ │ │ │ +00033740: 3a20 7472 7565 2c20 2050 7265 763a 2073 : true, Prev: s │ │ │ │ +00033750: 6f75 7263 652c 2020 5570 3a20 436f 6d6d ource, Up: Comm │ │ │ │ +00033760: 616e 642d 6c69 6e65 2061 6e64 206d 656e and-line and men │ │ │ │ +00033770: 7520 656e 7472 7920 636f 6d6d 616e 6473 u entry commands │ │ │ │ +00033780: 0a0a 3136 2e33 2e37 3420 7465 7374 0a2d ..16.3.74 test.- │ │ │ │ +00033790: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d -----------.. -- │ │ │ │ +000337a0: 2043 6f6d 6d61 6e64 3a20 7465 7374 2065 Command: test e │ │ │ │ +000337b0: 7870 7265 7373 696f 6e0a 2020 2020 2045 xpression. E │ │ │ │ +000337c0: 7661 6c75 6174 6520 4558 5052 4553 5349 valuate EXPRESSI │ │ │ │ +000337d0: 4f4e 2061 6e64 2072 6574 7572 6e20 7a65 ON and return ze │ │ │ │ +000337e0: 726f 2065 7869 7420 7374 6174 7573 2069 ro exit status i │ │ │ │ +000337f0: 6620 7265 7375 6c74 2069 7320 7472 7565 f result is true │ │ │ │ +00033800: 2c0a 2020 2020 206e 6f6e 207a 6572 6f20 ,. non zero │ │ │ │ +00033810: 7374 6174 7573 206f 7468 6572 7769 7365 status otherwise │ │ │ │ +00033820: 2e0a 0a20 2020 2020 4558 5052 4553 5349 ... EXPRESSI │ │ │ │ +00033830: 4f4e 2069 7320 6f6e 6520 6f66 3a0a 0a20 ON is one of:.. │ │ │ │ +00033840: 2020 2020 5354 5249 4e47 3120 273d 3d27 STRING1 '==' │ │ │ │ +00033850: 2053 5452 494e 4732 0a20 2020 2020 2020 STRING2. │ │ │ │ +00033860: 2020 2074 6865 2073 7472 696e 6773 2061 the strings a │ │ │ │ +00033870: 7265 2065 7175 616c 0a20 2020 2020 5354 re equal. ST │ │ │ │ +00033880: 5249 4e47 3120 2721 3d27 2053 5452 494e RING1 '!=' STRIN │ │ │ │ +00033890: 4732 0a20 2020 2020 2020 2020 2074 6865 G2. the │ │ │ │ +000338a0: 2073 7472 696e 6773 2061 7265 206e 6f74 strings are not │ │ │ │ +000338b0: 2065 7175 616c 0a20 2020 2020 5354 5249 equal. STRI │ │ │ │ +000338c0: 4e47 3120 273c 2720 5354 5249 4e47 320a NG1 '<' STRING2. │ │ │ │ +000338d0: 2020 2020 2020 2020 2020 5354 5249 4e47 STRING │ │ │ │ +000338e0: 3120 6973 206c 6578 6963 6f67 7261 7068 1 is lexicograph │ │ │ │ +000338f0: 6963 616c 6c79 206c 6573 7320 7468 616e ically less than │ │ │ │ +00033900: 2053 5452 494e 4732 0a20 2020 2020 5354 STRING2. ST │ │ │ │ +00033910: 5249 4e47 3120 273c 3d27 2053 5452 494e RING1 '<=' STRIN │ │ │ │ +00033920: 4732 0a20 2020 2020 2020 2020 2053 5452 G2. STR │ │ │ │ +00033930: 494e 4731 2069 7320 6c65 7869 636f 6772 ING1 is lexicogr │ │ │ │ +00033940: 6170 6869 6361 6c6c 7920 6c65 7373 206f aphically less o │ │ │ │ +00033950: 7220 6571 7561 6c20 7468 616e 2053 5452 r equal than STR │ │ │ │ +00033960: 494e 4732 0a20 2020 2020 5354 5249 4e47 ING2. STRING │ │ │ │ +00033970: 3120 273e 2720 5354 5249 4e47 320a 2020 1 '>' STRING2. │ │ │ │ +00033980: 2020 2020 2020 2020 5354 5249 4e47 3120 STRING1 │ │ │ │ +00033990: 6973 206c 6578 6963 6f67 7261 7068 6963 is lexicographic │ │ │ │ +000339a0: 616c 6c79 2067 7265 6174 6572 2074 6861 ally greater tha │ │ │ │ +000339b0: 6e20 5354 5249 4e47 320a 2020 2020 2053 n STRING2. S │ │ │ │ +000339c0: 5452 494e 4731 2027 3e3d 2720 5354 5249 TRING1 '>=' STRI │ │ │ │ +000339d0: 4e47 320a 2020 2020 2020 2020 2020 5354 NG2. ST │ │ │ │ +000339e0: 5249 4e47 3120 6973 206c 6578 6963 6f67 RING1 is lexicog │ │ │ │ +000339f0: 7261 7068 6963 616c 6c79 2067 7265 6174 raphically great │ │ │ │ +00033a00: 6572 206f 7220 6571 7561 6c20 7468 616e er or equal than │ │ │ │ +00033a10: 2053 5452 494e 4732 0a20 2020 2020 494e STRING2. IN │ │ │ │ +00033a20: 5445 4745 5231 2027 2d65 7127 2049 4e54 TEGER1 '-eq' INT │ │ │ │ +00033a30: 4547 4552 320a 2020 2020 2020 2020 2020 EGER2. │ │ │ │ +00033a40: 494e 5445 4745 5231 2069 7320 6571 7561 INTEGER1 is equa │ │ │ │ +00033a50: 6c20 746f 2049 4e54 4547 4552 320a 2020 l to INTEGER2. │ │ │ │ +00033a60: 2020 2049 4e54 4547 4552 3120 272d 6765 INTEGER1 '-ge │ │ │ │ +00033a70: 2720 494e 5445 4745 5232 0a20 2020 2020 ' INTEGER2. │ │ │ │ +00033a80: 2020 2020 2049 4e54 4547 4552 3120 6973 INTEGER1 is │ │ │ │ +00033a90: 2067 7265 6174 6572 2074 6861 6e20 6f72 greater than or │ │ │ │ +00033aa0: 2065 7175 616c 2074 6f20 494e 5445 4745 equal to INTEGE │ │ │ │ +00033ab0: 5232 0a20 2020 2020 494e 5445 4745 5231 R2. INTEGER1 │ │ │ │ +00033ac0: 2027 2d67 7427 2049 4e54 4547 4552 320a '-gt' INTEGER2. │ │ │ │ +00033ad0: 2020 2020 2020 2020 2020 494e 5445 4745 INTEGE │ │ │ │ +00033ae0: 5231 2069 7320 6772 6561 7465 7220 7468 R1 is greater th │ │ │ │ +00033af0: 616e 2049 4e54 4547 4552 320a 2020 2020 an INTEGER2. │ │ │ │ +00033b00: 2049 4e54 4547 4552 3120 272d 6c65 2720 INTEGER1 '-le' │ │ │ │ +00033b10: 494e 5445 4745 5232 0a20 2020 2020 2020 INTEGER2. │ │ │ │ +00033b20: 2020 2049 4e54 4547 4552 3120 6973 206c INTEGER1 is l │ │ │ │ +00033b30: 6573 7320 7468 616e 206f 7220 6571 7561 ess than or equa │ │ │ │ +00033b40: 6c20 746f 2049 4e54 4547 4552 320a 2020 l to INTEGER2. │ │ │ │ +00033b50: 2020 2049 4e54 4547 4552 3120 272d 6c74 INTEGER1 '-lt │ │ │ │ +00033b60: 2720 494e 5445 4745 5232 0a20 2020 2020 ' INTEGER2. │ │ │ │ +00033b70: 2020 2020 2049 4e54 4547 4552 3120 6973 INTEGER1 is │ │ │ │ +00033b80: 206c 6573 7320 7468 616e 2049 4e54 4547 less than INTEG │ │ │ │ +00033b90: 4552 320a 2020 2020 2049 4e54 4547 4552 ER2. INTEGER │ │ │ │ +00033ba0: 3120 272d 6e65 2720 494e 5445 4745 5232 1 '-ne' INTEGER2 │ │ │ │ +00033bb0: 0a20 2020 2020 2020 2020 2049 4e54 4547 . INTEG │ │ │ │ +00033bc0: 4552 3120 6973 206e 6f74 2065 7175 616c ER1 is not equal │ │ │ │ +00033bd0: 2074 6f20 494e 5445 4745 5232 0a20 2020 to INTEGER2. │ │ │ │ +00033be0: 2020 5052 4546 4958 494e 5445 4745 5231 PREFIXINTEGER1 │ │ │ │ +00033bf0: 2027 2d70 6774 2720 5052 4546 4958 494e '-pgt' PREFIXIN │ │ │ │ +00033c00: 5445 4745 5232 0a20 2020 2020 2020 2020 TEGER2. │ │ │ │ +00033c10: 2049 4e54 4547 4552 3120 6973 2067 7265 INTEGER1 is gre │ │ │ │ +00033c20: 6174 6572 2074 6861 6e20 494e 5445 4745 ater than INTEGE │ │ │ │ +00033c30: 5232 2061 6674 6572 2073 7472 6970 7069 R2 after strippi │ │ │ │ +00033c40: 6e67 206f 6666 2063 6f6d 6d6f 6e0a 2020 ng off common. │ │ │ │ +00033c50: 2020 2020 2020 2020 6e6f 6e2d 6e75 6d65 non-nume │ │ │ │ +00033c60: 7269 6320 5052 4546 4958 2e0a 2020 2020 ric PREFIX.. │ │ │ │ +00033c70: 2050 5245 4649 5849 4e54 4547 4552 3120 PREFIXINTEGER1 │ │ │ │ +00033c80: 272d 706c 7427 2050 5245 4649 5849 4e54 '-plt' PREFIXINT │ │ │ │ +00033c90: 4547 4552 320a 2020 2020 2020 2020 2020 EGER2. │ │ │ │ +00033ca0: 494e 5445 4745 5231 2069 7320 6c65 7373 INTEGER1 is less │ │ │ │ +00033cb0: 2074 6861 6e20 494e 5445 4745 5232 2061 than INTEGER2 a │ │ │ │ +00033cc0: 6674 6572 2073 7472 6970 7069 6e67 206f fter stripping o │ │ │ │ +00033cd0: 6666 2063 6f6d 6d6f 6e0a 2020 2020 2020 ff common. │ │ │ │ +00033ce0: 2020 2020 6e6f 6e2d 6e75 6d65 7269 6320 non-numeric │ │ │ │ +00033cf0: 5052 4546 4958 2e0a 2020 2020 2046 494c PREFIX.. FIL │ │ │ │ +00033d00: 4531 2027 2d6e 7427 2046 494c 4532 0a20 E1 '-nt' FILE2. │ │ │ │ +00033d10: 2020 2020 2020 2020 2046 494c 4531 2069 FILE1 i │ │ │ │ +00033d20: 7320 6e65 7765 7220 7468 616e 2046 494c s newer than FIL │ │ │ │ +00033d30: 4532 2028 6d6f 6469 6669 6361 7469 6f6e E2 (modification │ │ │ │ +00033d40: 2074 696d 6529 2e20 204f 7074 696f 6e61 time). Optiona │ │ │ │ +00033d50: 6c6c 790a 2020 2020 2020 2020 2020 6e75 lly. nu │ │ │ │ +00033d60: 6d65 7269 6320 4249 4153 206d 6179 2062 meric BIAS may b │ │ │ │ +00033d70: 6520 6469 7265 6374 6c79 2061 7070 656e e directly appen │ │ │ │ +00033d80: 6465 6420 746f 2027 2d6e 7427 2069 6e20 ded to '-nt' in │ │ │ │ +00033d90: 7768 6963 6820 6361 7365 0a20 2020 2020 which case. │ │ │ │ +00033da0: 2020 2020 2069 7420 6973 2061 6464 6564 it is added │ │ │ │ +00033db0: 2074 6f20 7468 6520 6669 7273 7420 6669 to the first fi │ │ │ │ +00033dc0: 6c65 206d 6f64 6966 6963 6174 696f 6e20 le modification │ │ │ │ +00033dd0: 7469 6d65 2e0a 2020 2020 2046 494c 4531 time.. FILE1 │ │ │ │ +00033de0: 2027 2d6f 7427 2046 494c 4532 0a20 2020 '-ot' FILE2. │ │ │ │ +00033df0: 2020 2020 2020 2046 494c 4531 2069 7320 FILE1 is │ │ │ │ +00033e00: 6f6c 6465 7220 7468 616e 2046 494c 4532 older than FILE2 │ │ │ │ +00033e10: 2028 6d6f 6469 6669 6361 7469 6f6e 2074 (modification t │ │ │ │ +00033e20: 696d 6529 2e20 204f 7074 696f 6e61 6c6c ime). Optionall │ │ │ │ +00033e30: 790a 2020 2020 2020 2020 2020 6e75 6d65 y. nume │ │ │ │ +00033e40: 7269 6320 4249 4153 206d 6179 2062 6520 ric BIAS may be │ │ │ │ +00033e50: 6469 7265 6374 6c79 2061 7070 656e 6465 directly appende │ │ │ │ +00033e60: 6420 746f 2027 2d6f 7427 2069 6e20 7768 d to '-ot' in wh │ │ │ │ +00033e70: 6963 6820 6361 7365 0a20 2020 2020 2020 ich case. │ │ │ │ +00033e80: 2020 2069 7420 6973 2061 6464 6564 2074 it is added t │ │ │ │ +00033e90: 6f20 7468 6520 6669 7273 7420 6669 6c65 o the first file │ │ │ │ +00033ea0: 206d 6f64 6966 6963 6174 696f 6e20 7469 modification ti │ │ │ │ +00033eb0: 6d65 2e0a 2020 2020 2027 2d64 2720 4649 me.. '-d' FI │ │ │ │ +00033ec0: 4c45 0a20 2020 2020 2020 2020 2046 494c LE. FIL │ │ │ │ +00033ed0: 4520 6578 6973 7473 2061 6e64 2069 7320 E exists and is │ │ │ │ +00033ee0: 6120 6469 7265 6374 6f72 790a 2020 2020 a directory. │ │ │ │ +00033ef0: 2027 2d65 2720 4649 4c45 0a20 2020 2020 '-e' FILE. │ │ │ │ +00033f00: 2020 2020 2046 494c 4520 6578 6973 7473 FILE exists │ │ │ │ +00033f10: 0a20 2020 2020 272d 6627 2046 494c 450a . '-f' FILE. │ │ │ │ +00033f20: 2020 2020 2020 2020 2020 4649 4c45 2065 FILE e │ │ │ │ +00033f30: 7869 7374 7320 616e 6420 6973 206e 6f74 xists and is not │ │ │ │ +00033f40: 2061 2064 6972 6563 746f 7279 0a20 2020 a directory. │ │ │ │ +00033f50: 2020 272d 7327 2046 494c 450a 2020 2020 '-s' FILE. │ │ │ │ +00033f60: 2020 2020 2020 4649 4c45 2065 7869 7374 FILE exist │ │ │ │ +00033f70: 7320 616e 6420 6861 7320 6120 7369 7a65 s and has a size │ │ │ │ +00033f80: 2067 7265 6174 6572 2074 6861 6e20 7a65 greater than ze │ │ │ │ +00033f90: 726f 0a20 2020 2020 272d 6e27 2053 5452 ro. '-n' STR │ │ │ │ +00033fa0: 494e 470a 2020 2020 2020 2020 2020 7468 ING. th │ │ │ │ +00033fb0: 6520 6c65 6e67 7468 206f 6620 5354 5249 e length of STRI │ │ │ │ +00033fc0: 4e47 2069 7320 6e6f 6e7a 6572 6f0a 2020 NG is nonzero. │ │ │ │ +00033fd0: 2020 2053 5452 494e 470a 2020 2020 2020 STRING. │ │ │ │ +00033fe0: 2020 2020 5354 5249 4e47 2069 7320 6571 STRING is eq │ │ │ │ +00033ff0: 7569 7661 6c65 6e74 2074 6f20 272d 6e20 uivalent to '-n │ │ │ │ +00034000: 5354 5249 4e47 270a 2020 2020 2027 2d7a STRING'. '-z │ │ │ │ +00034010: 2720 5354 5249 4e47 0a20 2020 2020 2020 ' STRING. │ │ │ │ +00034020: 2020 2074 6865 206c 656e 6774 6820 6f66 the length of │ │ │ │ +00034030: 2053 5452 494e 4720 6973 207a 6572 6f0a STRING is zero. │ │ │ │ +00034040: 2020 2020 2027 2827 2045 5850 5245 5353 '(' EXPRESS │ │ │ │ +00034050: 494f 4e20 2729 270a 2020 2020 2020 2020 ION ')'. │ │ │ │ +00034060: 2020 4558 5052 4553 5349 4f4e 2069 7320 EXPRESSION is │ │ │ │ +00034070: 7472 7565 0a20 2020 2020 2721 2720 4558 true. '!' EX │ │ │ │ +00034080: 5052 4553 5349 4f4e 0a20 2020 2020 2020 PRESSION. │ │ │ │ +00034090: 2020 2045 5850 5245 5353 494f 4e20 6973 EXPRESSION is │ │ │ │ +000340a0: 2066 616c 7365 0a20 2020 2020 4558 5052 false. EXPR │ │ │ │ +000340b0: 4553 5349 4f4e 3120 272d 6127 2045 5850 ESSION1 '-a' EXP │ │ │ │ +000340c0: 5245 5353 494f 4e32 0a20 2020 2020 2020 RESSION2. │ │ │ │ +000340d0: 2020 2062 6f74 6820 4558 5052 4553 5349 both EXPRESSI │ │ │ │ +000340e0: 4f4e 3120 616e 6420 4558 5052 4553 5349 ON1 and EXPRESSI │ │ │ │ +000340f0: 4f4e 3220 6172 6520 7472 7565 0a20 2020 ON2 are true. │ │ │ │ +00034100: 2020 4558 5052 4553 5349 4f4e 3120 4558 EXPRESSION1 EX │ │ │ │ +00034110: 5052 4553 5349 4f4e 320a 2020 2020 2020 PRESSION2. │ │ │ │ +00034120: 2020 2020 626f 7468 2045 5850 5245 5353 both EXPRESS │ │ │ │ +00034130: 494f 4e31 2061 6e64 2045 5850 5245 5353 ION1 and EXPRESS │ │ │ │ +00034140: 494f 4e32 2061 7265 2074 7275 652e 2020 ION2 are true. │ │ │ │ +00034150: 5468 6973 2073 796e 7461 7820 6973 206e This syntax is n │ │ │ │ +00034160: 6f74 0a20 2020 2020 2020 2020 2050 4f53 ot. POS │ │ │ │ +00034170: 4958 2d63 6f6d 706c 6961 6e74 2061 6e64 IX-compliant and │ │ │ │ +00034180: 2069 7320 6e6f 7420 7265 636f 6d6d 656e is not recommen │ │ │ │ +00034190: 6465 642e 0a20 2020 2020 4558 5052 4553 ded.. EXPRES │ │ │ │ +000341a0: 5349 4f4e 3120 272d 6f27 2045 5850 5245 SION1 '-o' EXPRE │ │ │ │ +000341b0: 5353 494f 4e32 0a20 2020 2020 2020 2020 SSION2. │ │ │ │ +000341c0: 2065 6974 6865 7220 4558 5052 4553 5349 either EXPRESSI │ │ │ │ +000341d0: 4f4e 3120 6f72 2045 5850 5245 5353 494f ON1 or EXPRESSIO │ │ │ │ +000341e0: 4e32 2069 7320 7472 7565 0a0a 1f0a 4669 N2 is true....Fi │ │ │ │ +000341f0: 6c65 3a20 6772 7562 2e69 6e66 6f2c 2020 le: grub.info, │ │ │ │ +00034200: 4e6f 6465 3a20 7472 7565 2c20 204e 6578 Node: true, Nex │ │ │ │ +00034210: 743a 2074 7275 7374 2c20 2050 7265 763a t: trust, Prev: │ │ │ │ +00034220: 2074 6573 742c 2020 5570 3a20 436f 6d6d test, Up: Comm │ │ │ │ +00034230: 616e 642d 6c69 6e65 2061 6e64 206d 656e and-line and men │ │ │ │ +00034240: 7520 656e 7472 7920 636f 6d6d 616e 6473 u entry commands │ │ │ │ +00034250: 0a0a 3136 2e33 2e37 3520 7472 7565 0a2d ..16.3.75 true.- │ │ │ │ +00034260: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d -----------.. -- │ │ │ │ +00034270: 2043 6f6d 6d61 6e64 3a20 7472 7565 0a20 Command: true. │ │ │ │ +00034280: 2020 2020 446f 206e 6f74 6869 6e67 2c20 Do nothing, │ │ │ │ +00034290: 7375 6363 6573 7366 756c 6c79 2e20 2054 successfully. T │ │ │ │ +000342a0: 6869 7320 6973 206d 6169 6e6c 7920 7573 his is mainly us │ │ │ │ +000342b0: 6566 756c 2069 6e20 636f 6e74 726f 6c0a eful in control. │ │ │ │ +000342c0: 2020 2020 2063 6f6e 7374 7275 6374 7320 constructs │ │ │ │ +000342d0: 7375 6368 2061 7320 2769 6627 2061 6e64 such as 'if' and │ │ │ │ +000342e0: 2027 7768 696c 6527 2028 2a6e 6f74 6520 'while' (*note │ │ │ │ +000342f0: 5368 656c 6c2d 6c69 6b65 2073 6372 6970 Shell-like scrip │ │ │ │ +00034300: 7469 6e67 3a3a 292e 0a0a 1f0a 4669 6c65 ting::).....File │ │ │ │ +00034310: 3a20 6772 7562 2e69 6e66 6f2c 2020 4e6f : grub.info, No │ │ │ │ +00034320: 6465 3a20 7472 7573 742c 2020 4e65 7874 de: trust, Next │ │ │ │ +00034330: 3a20 756e 7365 742c 2020 5072 6576 3a20 : unset, Prev: │ │ │ │ +00034340: 7472 7565 2c20 2055 703a 2043 6f6d 6d61 true, Up: Comma │ │ │ │ +00034350: 6e64 2d6c 696e 6520 616e 6420 6d65 6e75 nd-line and menu │ │ │ │ +00034360: 2065 6e74 7279 2063 6f6d 6d61 6e64 730a entry commands. │ │ │ │ +00034370: 0a31 362e 332e 3736 2074 7275 7374 0a2d .16.3.76 trust.- │ │ │ │ +00034380: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d ------------.. - │ │ │ │ +00034390: 2d20 436f 6d6d 616e 643a 2074 7275 7374 - Command: trust │ │ │ │ +000343a0: 205b 272d 2d73 6b69 702d 7369 6727 5d20 ['--skip-sig'] │ │ │ │ +000343b0: 7075 626b 6579 5f66 696c 650a 2020 2020 pubkey_file. │ │ │ │ +000343c0: 2052 6561 6420 7075 626c 6963 206b 6579 Read public key │ │ │ │ +000343d0: 2066 726f 6d20 5055 424b 4559 5f46 494c from PUBKEY_FIL │ │ │ │ +000343e0: 4520 616e 6420 6164 6420 6974 2074 6f20 E and add it to │ │ │ │ +000343f0: 4752 5542 2773 2069 6e74 6572 6e61 6c20 GRUB's internal │ │ │ │ +00034400: 6c69 7374 0a20 2020 2020 6f66 2074 7275 list. of tru │ │ │ │ +00034410: 7374 6564 2070 7562 6c69 6320 6b65 7973 sted public keys │ │ │ │ +00034420: 2e20 2054 6865 7365 206b 6579 7320 6172 . These keys ar │ │ │ │ +00034430: 6520 7573 6564 2074 6f20 7661 6c69 6461 e used to valida │ │ │ │ +00034440: 7465 2064 6967 6974 616c 0a20 2020 2020 te digital. │ │ │ │ +00034450: 7369 676e 6174 7572 6573 2077 6865 6e20 signatures when │ │ │ │ +00034460: 656e 7669 726f 6e6d 656e 7420 7661 7269 environment vari │ │ │ │ +00034470: 6162 6c65 2027 6368 6563 6b5f 7369 676e able 'check_sign │ │ │ │ +00034480: 6174 7572 6573 2720 6973 2073 6574 2074 atures' is set t │ │ │ │ +00034490: 6f0a 2020 2020 2027 656e 666f 7263 6527 o. 'enforce' │ │ │ │ +000344a0: 2e20 204e 6f74 6520 7468 6174 2069 6620 . Note that if │ │ │ │ +000344b0: 2763 6865 636b 5f73 6967 6e61 7475 7265 'check_signature │ │ │ │ +000344c0: 7327 2069 7320 7365 7420 746f 2027 656e s' is set to 'en │ │ │ │ +000344d0: 666f 7263 6527 0a20 2020 2020 7768 656e force'. when │ │ │ │ +000344e0: 2027 7472 7573 7427 2065 7865 6375 7465 'trust' execute │ │ │ │ +000344f0: 732c 2074 6865 6e20 5055 424b 4559 5f46 s, then PUBKEY_F │ │ │ │ +00034500: 494c 4520 6d75 7374 2069 7473 656c 6620 ILE must itself │ │ │ │ +00034510: 6265 2070 726f 7065 726c 790a 2020 2020 be properly. │ │ │ │ +00034520: 2073 6967 6e65 642e 2020 5468 6520 272d signed. The '- │ │ │ │ +00034530: 2d73 6b69 702d 7369 6727 206f 7074 696f -skip-sig' optio │ │ │ │ +00034540: 6e20 6361 6e20 6265 2075 7365 6420 746f n can be used to │ │ │ │ +00034550: 2064 6973 6162 6c65 0a20 2020 2020 7369 disable. si │ │ │ │ +00034560: 676e 6174 7572 652d 6368 6563 6b69 6e67 gnature-checking │ │ │ │ +00034570: 2077 6865 6e20 7265 6164 696e 6720 5055 when reading PU │ │ │ │ +00034580: 424b 4559 5f46 494c 4520 6974 7365 6c66 BKEY_FILE itself │ │ │ │ +00034590: 2e20 2049 7420 6973 2065 7870 6563 7465 . It is expecte │ │ │ │ +000345a0: 640a 2020 2020 2074 6861 7420 272d 2d73 d. that '--s │ │ │ │ +000345b0: 6b69 702d 7369 6727 2069 7320 7573 6566 kip-sig' is usef │ │ │ │ +000345c0: 756c 2066 6f72 2074 6573 7469 6e67 2061 ul for testing a │ │ │ │ +000345d0: 6e64 206d 616e 7561 6c20 626f 6f74 696e nd manual bootin │ │ │ │ +000345e0: 672e 2020 2a4e 6f74 650a 2020 2020 2055 g. *Note. U │ │ │ │ +000345f0: 7369 6e67 2064 6967 6974 616c 2073 6967 sing digital sig │ │ │ │ +00034600: 6e61 7475 7265 733a 3a2c 2066 6f72 206d natures::, for m │ │ │ │ +00034610: 6f72 6520 696e 666f 726d 6174 696f 6e2e ore information. │ │ │ │ +00034620: 0a0a 1f0a 4669 6c65 3a20 6772 7562 2e69 ....File: grub.i │ │ │ │ +00034630: 6e66 6f2c 2020 4e6f 6465 3a20 756e 7365 nfo, Node: unse │ │ │ │ +00034640: 742c 2020 4e65 7874 3a20 7570 7065 726d t, Next: upperm │ │ │ │ +00034650: 656d 2c20 2050 7265 763a 2074 7275 7374 em, Prev: trust │ │ │ │ +00034660: 2c20 2055 703a 2043 6f6d 6d61 6e64 2d6c , Up: Command-l │ │ │ │ +00034670: 696e 6520 616e 6420 6d65 6e75 2065 6e74 ine and menu ent │ │ │ │ +00034680: 7279 2063 6f6d 6d61 6e64 730a 0a31 362e ry commands..16. │ │ │ │ +00034690: 332e 3737 2075 6e73 6574 0a2d 2d2d 2d2d 3.77 unset.----- │ │ │ │ +000346a0: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 436f --------.. -- Co │ │ │ │ +000346b0: 6d6d 616e 643a 2075 6e73 6574 2065 6e76 mmand: unset env │ │ │ │ +000346c0: 7661 720a 2020 2020 2055 6e73 6574 2074 var. Unset t │ │ │ │ +000346d0: 6865 2065 6e76 6972 6f6e 6d65 6e74 2076 he environment v │ │ │ │ +000346e0: 6172 6961 626c 6520 454e 5656 4152 2e0a ariable ENVVAR.. │ │ │ │ +000346f0: 0a1f 0a46 696c 653a 2067 7275 622e 696e ...File: grub.in │ │ │ │ +00034700: 666f 2c20 204e 6f64 653a 2075 7070 6572 fo, Node: upper │ │ │ │ +00034710: 6d65 6d2c 2020 4e65 7874 3a20 7665 7269 mem, Next: veri │ │ │ │ +00034720: 6679 5f64 6574 6163 6865 642c 2020 5072 fy_detached, Pr │ │ │ │ +00034730: 6576 3a20 756e 7365 742c 2020 5570 3a20 ev: unset, Up: │ │ │ │ +00034740: 436f 6d6d 616e 642d 6c69 6e65 2061 6e64 Command-line and │ │ │ │ +00034750: 206d 656e 7520 656e 7472 7920 636f 6d6d menu entry comm │ │ │ │ +00034760: 616e 6473 0a0a 3136 2e33 2e37 3820 7570 ands..16.3.78 up │ │ │ │ +00034770: 7065 726d 656d 0a2d 2d2d 2d2d 2d2d 2d2d permem.--------- │ │ │ │ +00034780: 2d2d 2d2d 2d2d 2d0a 0a54 6869 7320 636f -------..This co │ │ │ │ +00034790: 6d6d 616e 6420 6973 206e 6f74 2079 6574 mmand is not yet │ │ │ │ +000347a0: 2069 6d70 6c65 6d65 6e74 6564 2066 6f72 implemented for │ │ │ │ +000347b0: 2047 5255 4220 322c 2061 6c74 686f 7567 GRUB 2, althoug │ │ │ │ +000347c0: 6820 6974 2069 7320 706c 616e 6e65 642e h it is planned. │ │ │ │ +000347d0: 0a0a 1f0a 4669 6c65 3a20 6772 7562 2e69 ....File: grub.i │ │ │ │ +000347e0: 6e66 6f2c 2020 4e6f 6465 3a20 7665 7269 nfo, Node: veri │ │ │ │ +000347f0: 6679 5f64 6574 6163 6865 642c 2020 4e65 fy_detached, Ne │ │ │ │ +00034800: 7874 3a20 7669 6465 6f69 6e66 6f2c 2020 xt: videoinfo, │ │ │ │ +00034810: 5072 6576 3a20 7570 7065 726d 656d 2c20 Prev: uppermem, │ │ │ │ +00034820: 2055 703a 2043 6f6d 6d61 6e64 2d6c 696e Up: Command-lin │ │ │ │ +00034830: 6520 616e 6420 6d65 6e75 2065 6e74 7279 e and menu entry │ │ │ │ +00034840: 2063 6f6d 6d61 6e64 730a 0a31 362e 332e commands..16.3. │ │ │ │ +00034850: 3739 2076 6572 6966 795f 6465 7461 6368 79 verify_detach │ │ │ │ +00034860: 6564 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ed.------------- │ │ │ │ +00034870: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 ----------.. -- │ │ │ │ +00034880: 436f 6d6d 616e 643a 2076 6572 6966 795f Command: verify_ │ │ │ │ +00034890: 6465 7461 6368 6564 205b 272d 2d73 6b69 detached ['--ski │ │ │ │ +000348a0: 702d 7369 6727 5d20 6669 6c65 2073 6967 p-sig'] file sig │ │ │ │ +000348b0: 6e61 7475 7265 5f66 696c 650a 2020 2020 nature_file. │ │ │ │ +000348c0: 2020 2020 2020 5b70 7562 6b65 795f 6669 [pubkey_fi │ │ │ │ +000348d0: 6c65 5d0a 2020 2020 2056 6572 6966 6965 le]. Verifie │ │ │ │ +000348e0: 7320 6120 4750 472d 7374 796c 6520 6465 s a GPG-style de │ │ │ │ +000348f0: 7461 6368 6564 2073 6967 6e61 7475 7265 tached signature │ │ │ │ +00034900: 2c20 7768 6572 6520 7468 6520 7369 676e , where the sign │ │ │ │ +00034910: 6564 2066 696c 6520 6973 0a20 2020 2020 ed file is. │ │ │ │ +00034920: 4649 4c45 2c20 616e 6420 7468 6520 7369 FILE, and the si │ │ │ │ +00034930: 676e 6174 7572 6520 6974 7365 6c66 2069 gnature itself i │ │ │ │ +00034940: 7320 696e 2066 696c 6520 5349 474e 4154 s in file SIGNAT │ │ │ │ +00034950: 5552 455f 4649 4c45 2e0a 2020 2020 204f URE_FILE.. O │ │ │ │ +00034960: 7074 696f 6e61 6c6c 792c 2061 2073 7065 ptionally, a spe │ │ │ │ +00034970: 6369 6669 6320 7075 626c 6963 206b 6579 cific public key │ │ │ │ +00034980: 2074 6f20 7573 6520 6361 6e20 6265 2073 to use can be s │ │ │ │ +00034990: 7065 6369 6669 6564 2075 7369 6e67 0a20 pecified using. │ │ │ │ +000349a0: 2020 2020 5055 424b 4559 5f46 494c 452e PUBKEY_FILE. │ │ │ │ +000349b0: 2020 5768 656e 2065 6e76 6972 6f6e 6d65 When environme │ │ │ │ +000349c0: 6e74 2076 6172 6961 626c 6520 2763 6865 nt variable 'che │ │ │ │ +000349d0: 636b 5f73 6967 6e61 7475 7265 7327 2069 ck_signatures' i │ │ │ │ +000349e0: 7320 7365 740a 2020 2020 2074 6f20 2765 s set. to 'e │ │ │ │ +000349f0: 6e66 6f72 6365 272c 2074 6865 6e20 5055 nforce', then PU │ │ │ │ +00034a00: 424b 4559 5f46 494c 4520 6d75 7374 2069 BKEY_FILE must i │ │ │ │ +00034a10: 7473 656c 6620 6265 2070 726f 7065 726c tself be properl │ │ │ │ +00034a20: 7920 7369 676e 6564 2062 7920 616e 0a20 y signed by an. │ │ │ │ +00034a30: 2020 2020 616c 7265 6164 792d 7472 7573 already-trus │ │ │ │ +00034a40: 7465 6420 6b65 792e 2020 416e 2075 6e73 ted key. An uns │ │ │ │ +00034a50: 6967 6e65 6420 5055 424b 4559 5f46 494c igned PUBKEY_FIL │ │ │ │ +00034a60: 4520 6361 6e20 6265 206c 6f61 6465 6420 E can be loaded │ │ │ │ +00034a70: 6279 0a20 2020 2020 7370 6563 6966 7969 by. specifyi │ │ │ │ +00034a80: 6e67 2027 2d2d 736b 6970 2d73 6967 272e ng '--skip-sig'. │ │ │ │ +00034a90: 2020 4966 2050 5542 4b45 595f 4649 4c45 If PUBKEY_FILE │ │ │ │ +00034aa0: 2069 7320 6f6d 6974 7465 642c 2074 6865 is omitted, the │ │ │ │ +00034ab0: 6e20 7075 626c 6963 0a20 2020 2020 6b65 n public. ke │ │ │ │ +00034ac0: 7973 2066 726f 6d20 4752 5542 2773 2074 ys from GRUB's t │ │ │ │ +00034ad0: 7275 7374 6564 206b 6579 7320 282a 6e6f rusted keys (*no │ │ │ │ +00034ae0: 7465 206c 6973 745f 7472 7573 7465 643a te list_trusted: │ │ │ │ +00034af0: 3a2c 202a 6e6f 7465 2074 7275 7374 3a3a :, *note trust:: │ │ │ │ +00034b00: 2c0a 2020 2020 2061 6e64 202a 6e6f 7465 ,. and *note │ │ │ │ +00034b10: 2064 6973 7472 7573 743a 3a29 2061 7265 distrust::) are │ │ │ │ +00034b20: 2074 7269 6564 2e0a 0a20 2020 2020 4578 tried... Ex │ │ │ │ +00034b30: 6974 2063 6f64 6520 2724 3f27 2069 7320 it code '$?' is │ │ │ │ +00034b40: 7365 7420 746f 2030 2069 6620 7468 6520 set to 0 if the │ │ │ │ +00034b50: 7369 676e 6174 7572 6520 7661 6c69 6461 signature valida │ │ │ │ +00034b60: 7465 7320 7375 6363 6573 7366 756c 6c79 tes successfully │ │ │ │ +00034b70: 2e0a 2020 2020 2049 6620 7661 6c69 6461 .. If valida │ │ │ │ +00034b80: 7469 6f6e 2066 6169 6c73 2c20 6974 2069 tion fails, it i │ │ │ │ +00034b90: 7320 7365 7420 746f 2061 206e 6f6e 2d7a s set to a non-z │ │ │ │ +00034ba0: 6572 6f20 7661 6c75 652e 2020 2a4e 6f74 ero value. *Not │ │ │ │ +00034bb0: 6520 5573 696e 670a 2020 2020 2064 6967 e Using. dig │ │ │ │ +00034bc0: 6974 616c 2073 6967 6e61 7475 7265 733a ital signatures: │ │ │ │ +00034bd0: 3a2c 2066 6f72 206d 6f72 6520 696e 666f :, for more info │ │ │ │ +00034be0: 726d 6174 696f 6e2e 0a0a 1f0a 4669 6c65 rmation.....File │ │ │ │ +00034bf0: 3a20 6772 7562 2e69 6e66 6f2c 2020 4e6f : grub.info, No │ │ │ │ +00034c00: 6465 3a20 7669 6465 6f69 6e66 6f2c 2020 de: videoinfo, │ │ │ │ +00034c10: 4e65 7874 3a20 7772 6d73 722c 2020 5072 Next: wrmsr, Pr │ │ │ │ +00034c20: 6576 3a20 7665 7269 6679 5f64 6574 6163 ev: verify_detac │ │ │ │ +00034c30: 6865 642c 2020 5570 3a20 436f 6d6d 616e hed, Up: Comman │ │ │ │ +00034c40: 642d 6c69 6e65 2061 6e64 206d 656e 7520 d-line and menu │ │ │ │ +00034c50: 656e 7472 7920 636f 6d6d 616e 6473 0a0a entry commands.. │ │ │ │ +00034c60: 3136 2e33 2e38 3020 7669 6465 6f69 6e66 16.3.80 videoinf │ │ │ │ +00034c70: 6f0a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d o.-------------- │ │ │ │ +00034c80: 2d2d 2d0a 0a20 2d2d 2043 6f6d 6d61 6e64 ---.. -- Command │ │ │ │ +00034c90: 3a20 7669 6465 6f69 6e66 6f20 5b5b 5778 : videoinfo [[Wx │ │ │ │ +00034ca0: 485d 7844 5d0a 2020 2020 204c 6973 7420 H]xD]. List │ │ │ │ +00034cb0: 6176 6169 6c61 626c 6520 7669 6465 6f20 available video │ │ │ │ +00034cc0: 6d6f 6465 732e 2020 4966 2072 6573 6f6c modes. If resol │ │ │ │ +00034cd0: 7574 696f 6e20 6973 2067 6976 656e 2c20 ution is given, │ │ │ │ +00034ce0: 7368 6f77 206f 6e6c 790a 2020 2020 206d show only. m │ │ │ │ +00034cf0: 6174 6368 696e 6720 6d6f 6465 732e 0a0a atching modes... │ │ │ │ +00034d00: 1f0a 4669 6c65 3a20 6772 7562 2e69 6e66 ..File: grub.inf │ │ │ │ +00034d10: 6f2c 2020 4e6f 6465 3a20 7772 6d73 722c o, Node: wrmsr, │ │ │ │ +00034d20: 2020 4e65 7874 3a20 7865 6e5f 6879 7065 Next: xen_hype │ │ │ │ +00034d30: 7276 6973 6f72 2c20 2050 7265 763a 2076 rvisor, Prev: v │ │ │ │ +00034d40: 6964 656f 696e 666f 2c20 2055 703a 2043 ideoinfo, Up: C │ │ │ │ +00034d50: 6f6d 6d61 6e64 2d6c 696e 6520 616e 6420 ommand-line and │ │ │ │ +00034d60: 6d65 6e75 2065 6e74 7279 2063 6f6d 6d61 menu entry comma │ │ │ │ +00034d70: 6e64 730a 0a31 362e 332e 3831 2077 726d nds..16.3.81 wrm │ │ │ │ +00034d80: 7372 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d sr.------------- │ │ │ │ +00034d90: 0a0a 202d 2d20 436f 6d6d 616e 643a 3a20 .. -- Command:: │ │ │ │ +00034da0: 7772 6d73 7220 3078 4144 4452 2030 7856 wrmsr 0xADDR 0xV │ │ │ │ +00034db0: 414c 5545 0a20 2020 2020 5772 6974 6520 ALUE. Write │ │ │ │ +00034dc0: 6120 3078 5641 4c55 4520 746f 2061 206d a 0xVALUE to a m │ │ │ │ +00034dd0: 6f64 656c 2d73 7065 6369 6669 6320 7265 odel-specific re │ │ │ │ +00034de0: 6769 7374 6572 2061 7420 6164 6472 6573 gister at addres │ │ │ │ +00034df0: 7320 3078 4144 4452 2e0a 0a20 2020 2020 s 0xADDR... │ │ │ │ +00034e00: 506c 6561 7365 206e 6f74 6520 7468 6174 Please note that │ │ │ │ +00034e10: 206f 6e20 534d 5020 7379 7374 656d 732c on SMP systems, │ │ │ │ +00034e20: 2077 7269 7469 6e67 2074 6f20 6120 4d53 writing to a MS │ │ │ │ +00034e30: 5220 7468 6174 2068 6173 2061 2073 636f R that has a sco │ │ │ │ +00034e40: 7065 0a20 2020 2020 7065 7220 6861 7264 pe. per hard │ │ │ │ +00034e50: 7761 7265 2074 6872 6561 642c 2069 6d70 ware thread, imp │ │ │ │ +00034e60: 6c69 6573 2074 6861 7420 7468 6520 7661 lies that the va │ │ │ │ +00034e70: 6c75 6520 7468 6174 2069 7320 7772 6974 lue that is writ │ │ │ │ +00034e80: 7465 6e20 6f6e 6c79 0a20 2020 2020 6170 ten only. ap │ │ │ │ +00034e90: 706c 6965 7320 746f 2074 6865 2070 6172 plies to the par │ │ │ │ +00034ea0: 7469 6375 6c61 7220 6370 752f 636f 7265 ticular cpu/core │ │ │ │ +00034eb0: 2f74 6872 6561 6420 7468 6174 2072 756e /thread that run │ │ │ │ +00034ec0: 7320 7468 6520 636f 6d6d 616e 642e 0a0a s the command... │ │ │ │ +00034ed0: 2020 2020 2041 6c73 6f2c 2069 6620 796f Also, if yo │ │ │ │ +00034ee0: 7520 7370 6563 6966 7920 6120 7265 7365 u specify a rese │ │ │ │ +00034ef0: 7276 6564 206f 7220 756e 696d 706c 656d rved or unimplem │ │ │ │ +00034f00: 656e 7465 6420 4d53 5220 6164 6472 6573 ented MSR addres │ │ │ │ +00034f10: 732c 2069 740a 2020 2020 2077 696c 6c20 s, it. will │ │ │ │ +00034f20: 6361 7573 6520 6120 6765 6e65 7261 6c20 cause a general │ │ │ │ +00034f30: 7072 6f74 6563 7469 6f6e 2065 7863 6570 protection excep │ │ │ │ +00034f40: 7469 6f6e 2028 7768 6963 6820 6973 206e tion (which is n │ │ │ │ +00034f50: 6f74 2063 7572 7265 6e74 6c79 0a20 2020 ot currently. │ │ │ │ +00034f60: 2020 6265 696e 6720 6861 6e64 6c65 6429 being handled) │ │ │ │ +00034f70: 2061 6e64 2074 6865 2073 7973 7465 6d20 and the system │ │ │ │ +00034f80: 7769 6c6c 2072 6562 6f6f 742e 0a0a 2020 will reboot... │ │ │ │ +00034f90: 2020 204e 6f74 653a 2054 6865 2063 6f6d Note: The com │ │ │ │ +00034fa0: 6d61 6e64 2069 7320 6e6f 7420 616c 6c6f mand is not allo │ │ │ │ +00034fb0: 7765 6420 7768 656e 206c 6f63 6b64 6f77 wed when lockdow │ │ │ │ +00034fc0: 6e20 6973 2065 6e66 6f72 6365 6420 282a n is enforced (* │ │ │ │ +00034fd0: 6e6f 7465 0a20 2020 2020 4c6f 636b 646f note. Lockdo │ │ │ │ +00034fe0: 776e 3a3a 292e 2020 5468 6973 2069 7320 wn::). This is │ │ │ │ +00034ff0: 646f 6e65 2074 6f20 7072 6576 656e 7420 done to prevent │ │ │ │ +00035000: 7375 6276 6572 7469 6e67 2076 6172 696f subverting vario │ │ │ │ +00035010: 7573 2073 6563 7572 6974 790a 2020 2020 us security. │ │ │ │ +00035020: 206d 6563 6861 6e69 736d 732e 0a0a 1f0a mechanisms..... │ │ │ │ +00035030: 4669 6c65 3a20 6772 7562 2e69 6e66 6f2c File: grub.info, │ │ │ │ +00035040: 2020 4e6f 6465 3a20 7865 6e5f 6879 7065 Node: xen_hype │ │ │ │ +00035050: 7276 6973 6f72 2c20 204e 6578 743a 2078 rvisor, Next: x │ │ │ │ +00035060: 656e 5f6d 6f64 756c 652c 2020 5072 6576 en_module, Prev │ │ │ │ +00035070: 3a20 7772 6d73 722c 2020 5570 3a20 436f : wrmsr, Up: Co │ │ │ │ +00035080: 6d6d 616e 642d 6c69 6e65 2061 6e64 206d mmand-line and m │ │ │ │ +00035090: 656e 7520 656e 7472 7920 636f 6d6d 616e enu entry comman │ │ │ │ +000350a0: 6473 0a0a 3136 2e33 2e38 3220 7865 6e5f ds..16.3.82 xen_ │ │ │ │ +000350b0: 6879 7065 7276 6973 6f72 0a2d 2d2d 2d2d hypervisor.----- │ │ │ │ +000350c0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ +000350d0: 2d0a 0a20 2d2d 2043 6f6d 6d61 6e64 3a20 -.. -- Command: │ │ │ │ +000350e0: 7865 6e5f 6879 7065 7276 6973 6f72 2066 xen_hypervisor f │ │ │ │ +000350f0: 696c 6520 5b61 7267 756d 656e 7473 5d20 ile [arguments] │ │ │ │ +00035100: 2e2e 2e0a 2020 2020 204c 6f61 6420 6120 .... Load a │ │ │ │ +00035110: 5865 6e20 6879 7065 7276 6973 6f72 2062 Xen hypervisor b │ │ │ │ +00035120: 696e 6172 7920 6672 6f6d 2046 494c 452e inary from FILE. │ │ │ │ +00035130: 2020 5468 6520 7265 7374 206f 6620 7468 The rest of th │ │ │ │ +00035140: 6520 6c69 6e65 2069 730a 2020 2020 2070 e line is. p │ │ │ │ +00035150: 6173 7365 6420 7665 7262 6174 696d 2061 assed verbatim a │ │ │ │ +00035160: 7320 7468 6520 226b 6572 6e65 6c20 636f s the "kernel co │ │ │ │ +00035170: 6d6d 616e 642d 6c69 6e65 222e 2020 416e mmand-line". An │ │ │ │ +00035180: 7920 6f74 6865 7220 6269 6e61 7269 6573 y other binaries │ │ │ │ +00035190: 0a20 2020 2020 6d75 7374 2062 6520 7265 . must be re │ │ │ │ +000351a0: 6c6f 6164 6564 2061 6674 6572 2075 7369 loaded after usi │ │ │ │ +000351b0: 6e67 2074 6869 7320 636f 6d6d 616e 642e ng this command. │ │ │ │ +000351c0: 2020 5468 6973 2063 6f6d 6d61 6e64 2069 This command i │ │ │ │ +000351d0: 7320 6f6e 6c79 0a20 2020 2020 6176 6169 s only. avai │ │ │ │ +000351e0: 6c61 626c 6520 6f6e 2041 4172 6368 3634 lable on AArch64 │ │ │ │ +000351f0: 2073 7973 7465 6d73 2e0a 0a1f 0a46 696c systems.....Fil │ │ │ │ +00035200: 653a 2067 7275 622e 696e 666f 2c20 204e e: grub.info, N │ │ │ │ +00035210: 6f64 653a 2078 656e 5f6d 6f64 756c 652c ode: xen_module, │ │ │ │ +00035220: 2020 5072 6576 3a20 7865 6e5f 6879 7065 Prev: xen_hype │ │ │ │ +00035230: 7276 6973 6f72 2c20 2055 703a 2043 6f6d rvisor, Up: Com │ │ │ │ +00035240: 6d61 6e64 2d6c 696e 6520 616e 6420 6d65 mand-line and me │ │ │ │ +00035250: 6e75 2065 6e74 7279 2063 6f6d 6d61 6e64 nu entry command │ │ │ │ +00035260: 730a 0a31 362e 332e 3833 2078 656e 5f6d s..16.3.83 xen_m │ │ │ │ +00035270: 6f64 756c 650a 2d2d 2d2d 2d2d 2d2d 2d2d odule.---------- │ │ │ │ +00035280: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 436f --------.. -- Co │ │ │ │ +00035290: 6d6d 616e 643a 2078 656e 5f6d 6f64 756c mmand: xen_modul │ │ │ │ +000352a0: 6520 5b2d 2d6e 6f75 6e7a 6970 5d20 6669 e [--nounzip] fi │ │ │ │ +000352b0: 6c65 205b 6172 6775 6d65 6e74 735d 0a20 le [arguments]. │ │ │ │ +000352c0: 2020 2020 4c6f 6164 2061 206d 6f64 756c Load a modul │ │ │ │ +000352d0: 6520 666f 7220 7865 6e20 6879 7065 7276 e for xen hyperv │ │ │ │ +000352e0: 6973 6f72 2061 7420 7468 6520 626f 6f74 isor at the boot │ │ │ │ +000352f0: 696e 6720 7072 6f63 6573 7320 6f66 2078 ing process of x │ │ │ │ +00035300: 656e 2e0a 2020 2020 2054 6865 2072 6573 en.. The res │ │ │ │ +00035310: 7420 6f66 2074 6865 206c 696e 6520 6973 t of the line is │ │ │ │ +00035320: 2070 6173 7365 6420 7665 7262 6174 696d passed verbatim │ │ │ │ +00035330: 2061 7320 7468 6520 6d6f 6475 6c65 2063 as the module c │ │ │ │ +00035340: 6f6d 6d61 6e64 206c 696e 652e 0a20 2020 ommand line.. │ │ │ │ +00035350: 2020 4d6f 6475 6c65 7320 7368 6f75 6c64 Modules should │ │ │ │ +00035360: 2062 6520 6c6f 6164 6564 2069 6e20 7468 be loaded in th │ │ │ │ +00035370: 6520 666f 6c6c 6f77 696e 6720 6f72 6465 e following orde │ │ │ │ +00035380: 723a 202d 2064 6f6d 3020 6b65 726e 656c r: - dom0 kernel │ │ │ │ +00035390: 0a20 2020 2020 696d 6167 6520 2d20 646f . image - do │ │ │ │ +000353a0: 6d30 2072 616d 6469 736b 2069 6620 7072 m0 ramdisk if pr │ │ │ │ +000353b0: 6573 656e 7420 2d20 5853 4d20 706f 6c69 esent - XSM poli │ │ │ │ +000353c0: 6379 2069 6620 7072 6573 656e 7420 5468 cy if present Th │ │ │ │ +000353d0: 6973 0a20 2020 2020 636f 6d6d 616e 6420 is. command │ │ │ │ +000353e0: 6973 206f 6e6c 7920 6176 6169 6c61 626c is only availabl │ │ │ │ +000353f0: 6520 6f6e 2041 4172 6368 3634 2073 7973 e on AArch64 sys │ │ │ │ +00035400: 7465 6d73 2e0a 0a1f 0a46 696c 653a 2067 tems.....File: g │ │ │ │ +00035410: 7275 622e 696e 666f 2c20 204e 6f64 653a rub.info, Node: │ │ │ │ +00035420: 204e 6574 776f 726b 696e 6720 636f 6d6d Networking comm │ │ │ │ +00035430: 616e 6473 2c20 2050 7265 763a 2043 6f6d ands, Prev: Com │ │ │ │ +00035440: 6d61 6e64 2d6c 696e 6520 616e 6420 6d65 mand-line and me │ │ │ │ +00035450: 6e75 2065 6e74 7279 2063 6f6d 6d61 6e64 nu entry command │ │ │ │ +00035460: 732c 2020 5570 3a20 436f 6d6d 616e 6473 s, Up: Commands │ │ │ │ +00035470: 0a0a 3136 2e34 2054 6865 206c 6973 7420 ..16.4 The list │ │ │ │ +00035480: 6f66 206e 6574 776f 726b 696e 6720 636f of networking co │ │ │ │ +00035490: 6d6d 616e 6473 0a3d 3d3d 3d3d 3d3d 3d3d mmands.========= │ │ │ │ 000354a0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ -000354b0: 3d3d 3d3d 3d3d 3d0a 0a2a 204d 656e 753a =======..* Menu: │ │ │ │ -000354c0: 0a0a 2a20 6e65 745f 6164 645f 6164 6472 ..* net_add_addr │ │ │ │ -000354d0: 3a3a 2020 2020 2020 2020 2020 2020 2020 :: │ │ │ │ -000354e0: 2020 4164 6420 6120 6e65 7477 6f72 6b20 Add a network │ │ │ │ -000354f0: 6164 6472 6573 730a 2a20 6e65 745f 6164 address.* net_ad │ │ │ │ -00035500: 645f 646e 733a 3a20 2020 2020 2020 2020 d_dns:: │ │ │ │ -00035510: 2020 2020 2020 2020 4164 6420 6120 444e Add a DN │ │ │ │ -00035520: 5320 7365 7276 6572 0a2a 206e 6574 5f61 S server.* net_a │ │ │ │ -00035530: 6464 5f72 6f75 7465 3a3a 2020 2020 2020 dd_route:: │ │ │ │ -00035540: 2020 2020 2020 2020 2041 6464 2072 6f75 Add rou │ │ │ │ -00035550: 7469 6e67 2065 6e74 7279 0a2a 206e 6574 ting entry.* net │ │ │ │ -00035560: 5f62 6f6f 7470 3a3a 2020 2020 2020 2020 _bootp:: │ │ │ │ -00035570: 2020 2020 2020 2020 2020 2050 6572 666f Perfo │ │ │ │ -00035580: 726d 2061 2062 6f6f 7470 2061 7574 6f63 rm a bootp autoc │ │ │ │ -00035590: 6f6e 6669 6775 7261 7469 6f6e 0a2a 206e onfiguration.* n │ │ │ │ -000355a0: 6574 5f64 656c 5f61 6464 723a 3a20 2020 et_del_addr:: │ │ │ │ -000355b0: 2020 2020 2020 2020 2020 2020 2052 656d Rem │ │ │ │ -000355c0: 6f76 6520 4950 2061 6464 7265 7373 2066 ove IP address f │ │ │ │ -000355d0: 726f 6d20 696e 7465 7266 6163 650a 2a20 rom interface.* │ │ │ │ -000355e0: 6e65 745f 6465 6c5f 646e 733a 3a20 2020 net_del_dns:: │ │ │ │ -000355f0: 2020 2020 2020 2020 2020 2020 2020 5265 Re │ │ │ │ -00035600: 6d6f 7665 2061 2044 4e53 2073 6572 7665 move a DNS serve │ │ │ │ -00035610: 720a 2a20 6e65 745f 6465 6c5f 726f 7574 r.* net_del_rout │ │ │ │ -00035620: 653a 3a20 2020 2020 2020 2020 2020 2020 e:: │ │ │ │ -00035630: 2020 5265 6d6f 7665 2061 2072 6f75 7465 Remove a route │ │ │ │ -00035640: 2065 6e74 7279 0a2a 206e 6574 5f67 6574 entry.* net_get │ │ │ │ -00035650: 5f64 6863 705f 6f70 7469 6f6e 3a3a 2020 _dhcp_option:: │ │ │ │ -00035660: 2020 2020 2020 2052 6574 7269 6576 6520 Retrieve │ │ │ │ -00035670: 4448 4350 206f 7074 696f 6e73 0a2a 206e DHCP options.* n │ │ │ │ -00035680: 6574 5f69 7076 365f 6175 746f 636f 6e66 et_ipv6_autoconf │ │ │ │ -00035690: 3a3a 2020 2020 2020 2020 2020 2050 6572 :: Per │ │ │ │ -000356a0: 666f 726d 2049 5076 3620 6175 746f 636f form IPv6 autoco │ │ │ │ -000356b0: 6e66 6967 7572 6174 696f 6e0a 2a20 6e65 nfiguration.* ne │ │ │ │ -000356c0: 745f 6c73 5f61 6464 723a 3a20 2020 2020 t_ls_addr:: │ │ │ │ -000356d0: 2020 2020 2020 2020 2020 2020 4c69 7374 List │ │ │ │ -000356e0: 2069 6e74 6572 6661 6365 730a 2a20 6e65 interfaces.* ne │ │ │ │ -000356f0: 745f 6c73 5f63 6172 6473 3a3a 2020 2020 t_ls_cards:: │ │ │ │ -00035700: 2020 2020 2020 2020 2020 2020 4c69 7374 List │ │ │ │ -00035710: 206e 6574 776f 726b 2063 6172 6473 0a2a network cards.* │ │ │ │ -00035720: 206e 6574 5f6c 735f 646e 733a 3a20 2020 net_ls_dns:: │ │ │ │ -00035730: 2020 2020 2020 2020 2020 2020 2020 204c L │ │ │ │ -00035740: 6973 7420 444e 5320 7365 7276 6572 730a ist DNS servers. │ │ │ │ -00035750: 2a20 6e65 745f 6c73 5f72 6f75 7465 733a * net_ls_routes: │ │ │ │ -00035760: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ -00035770: 4c69 7374 2072 6f75 7469 6e67 2065 6e74 List routing ent │ │ │ │ -00035780: 7269 6573 0a2a 206e 6574 5f6e 736c 6f6f ries.* net_nsloo │ │ │ │ -00035790: 6b75 703a 3a20 2020 2020 2020 2020 2020 kup:: │ │ │ │ -000357a0: 2020 2020 2050 6572 666f 726d 2061 2044 Perform a D │ │ │ │ -000357b0: 4e53 206c 6f6f 6b75 700a 0a1f 0a46 696c NS lookup....Fil │ │ │ │ -000357c0: 653a 2067 7275 622e 696e 666f 2c20 204e e: grub.info, N │ │ │ │ -000357d0: 6f64 653a 206e 6574 5f61 6464 5f61 6464 ode: net_add_add │ │ │ │ -000357e0: 722c 2020 4e65 7874 3a20 6e65 745f 6164 r, Next: net_ad │ │ │ │ -000357f0: 645f 646e 732c 2020 5570 3a20 4e65 7477 d_dns, Up: Netw │ │ │ │ -00035800: 6f72 6b69 6e67 2063 6f6d 6d61 6e64 730a orking commands. │ │ │ │ -00035810: 0a31 362e 342e 3120 6e65 745f 6164 645f .16.4.1 net_add_ │ │ │ │ -00035820: 6164 6472 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d addr.----------- │ │ │ │ -00035830: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 436f --------.. -- Co │ │ │ │ -00035840: 6d6d 616e 643a 206e 6574 5f61 6464 5f61 mmand: net_add_a │ │ │ │ -00035850: 6464 7220 494e 5445 5246 4143 4520 4341 ddr INTERFACE CA │ │ │ │ -00035860: 5244 2041 4444 5245 5353 0a20 2020 2020 RD ADDRESS. │ │ │ │ -00035870: 436f 6e66 6967 7572 6520 6164 6469 7469 Configure additi │ │ │ │ -00035880: 6f6e 616c 206e 6574 776f 726b 2049 4e54 onal network INT │ │ │ │ -00035890: 4552 4641 4345 2077 6974 6820 4144 4452 ERFACE with ADDR │ │ │ │ -000358a0: 4553 5320 6f6e 2061 206e 6574 776f 726b ESS on a network │ │ │ │ -000358b0: 0a20 2020 2020 4341 5244 2e20 2041 4444 . CARD. ADD │ │ │ │ -000358c0: 5245 5353 2063 616e 2062 6520 6569 7468 RESS can be eith │ │ │ │ -000358d0: 6572 2049 5020 696e 2064 6f74 7465 6420 er IP in dotted │ │ │ │ -000358e0: 6465 6369 6d61 6c20 6e6f 7461 7469 6f6e decimal notation │ │ │ │ -000358f0: 2c20 6f72 0a20 2020 2020 7379 6d62 6f6c , or. symbol │ │ │ │ -00035900: 6963 206e 616d 6520 7768 6963 6820 6973 ic name which is │ │ │ │ -00035910: 2072 6573 6f6c 7665 6420 7573 696e 6720 resolved using │ │ │ │ -00035920: 444e 5320 6c6f 6f6b 7570 2e20 2049 6620 DNS lookup. If │ │ │ │ -00035930: 7375 6363 6573 7366 756c 2c0a 2020 2020 successful,. │ │ │ │ -00035940: 2074 6869 7320 636f 6d6d 616e 6420 616c this command al │ │ │ │ -00035950: 736f 2061 6464 7320 6c6f 6361 6c20 6c69 so adds local li │ │ │ │ -00035960: 6e6b 2072 6f75 7469 6e67 2065 6e74 7279 nk routing entry │ │ │ │ -00035970: 2074 6f20 7468 6520 6465 6661 756c 740a to the default. │ │ │ │ -00035980: 2020 2020 2073 7562 6e65 7420 6f66 2041 subnet of A │ │ │ │ -00035990: 4444 5245 5353 2077 6974 6820 6e61 6d65 DDRESS with name │ │ │ │ -000359a0: 2049 4e54 4552 4641 4345 273a 6c6f 6361 INTERFACE':loca │ │ │ │ -000359b0: 6c27 2076 6961 2049 4e54 4552 4641 4345 l' via INTERFACE │ │ │ │ -000359c0: 2e0a 0a1f 0a46 696c 653a 2067 7275 622e .....File: grub. │ │ │ │ -000359d0: 696e 666f 2c20 204e 6f64 653a 206e 6574 info, Node: net │ │ │ │ -000359e0: 5f61 6464 5f64 6e73 2c20 204e 6578 743a _add_dns, Next: │ │ │ │ -000359f0: 206e 6574 5f61 6464 5f72 6f75 7465 2c20 net_add_route, │ │ │ │ -00035a00: 2050 7265 763a 206e 6574 5f61 6464 5f61 Prev: net_add_a │ │ │ │ -00035a10: 6464 722c 2020 5570 3a20 4e65 7477 6f72 ddr, Up: Networ │ │ │ │ -00035a20: 6b69 6e67 2063 6f6d 6d61 6e64 730a 0a31 king commands..1 │ │ │ │ -00035a30: 362e 342e 3220 6e65 745f 6164 645f 646e 6.4.2 net_add_dn │ │ │ │ -00035a40: 730a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d s.-------------- │ │ │ │ -00035a50: 2d2d 2d2d 0a0a 202d 2d20 436f 6d6d 616e ----.. -- Comman │ │ │ │ -00035a60: 643a 206e 6574 5f61 6464 5f64 6e73 2053 d: net_add_dns S │ │ │ │ -00035a70: 4552 5645 520a 2020 2020 2052 6573 6f6c ERVER. Resol │ │ │ │ -00035a80: 7665 2053 4552 5645 5220 4950 2061 6464 ve SERVER IP add │ │ │ │ -00035a90: 7265 7373 2061 6e64 2061 6464 2074 6f20 ress and add to │ │ │ │ -00035aa0: 7468 6520 6c69 7374 206f 6620 444e 5320 the list of DNS │ │ │ │ -00035ab0: 7365 7276 6572 7320 7573 6564 0a20 2020 servers used. │ │ │ │ -00035ac0: 2020 6475 7269 6e67 206e 616d 6520 6c6f during name lo │ │ │ │ -00035ad0: 6f6b 7570 2e0a 0a1f 0a46 696c 653a 2067 okup.....File: g │ │ │ │ -00035ae0: 7275 622e 696e 666f 2c20 204e 6f64 653a rub.info, Node: │ │ │ │ -00035af0: 206e 6574 5f61 6464 5f72 6f75 7465 2c20 net_add_route, │ │ │ │ -00035b00: 204e 6578 743a 206e 6574 5f62 6f6f 7470 Next: net_bootp │ │ │ │ -00035b10: 2c20 2050 7265 763a 206e 6574 5f61 6464 , Prev: net_add │ │ │ │ -00035b20: 5f64 6e73 2c20 2055 703a 204e 6574 776f _dns, Up: Netwo │ │ │ │ -00035b30: 726b 696e 6720 636f 6d6d 616e 6473 0a0a rking commands.. │ │ │ │ -00035b40: 3136 2e34 2e33 206e 6574 5f61 6464 5f72 16.4.3 net_add_r │ │ │ │ -00035b50: 6f75 7465 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d oute.----------- │ │ │ │ -00035b60: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2043 ---------.. -- C │ │ │ │ -00035b70: 6f6d 6d61 6e64 3a20 6e65 745f 6164 645f ommand: net_add_ │ │ │ │ -00035b80: 726f 7574 6520 5348 4f52 544e 414d 4520 route SHORTNAME │ │ │ │ -00035b90: 4950 5b2f 5052 4546 4958 5d20 5b49 4e54 IP[/PREFIX] [INT │ │ │ │ -00035ba0: 4552 4641 4345 207c 2027 6777 270a 2020 ERFACE | 'gw'. │ │ │ │ -00035bb0: 2020 2020 2020 2020 4741 5445 5741 595d GATEWAY] │ │ │ │ -00035bc0: 0a20 2020 2020 4164 6420 726f 7574 6520 . Add route │ │ │ │ -00035bd0: 746f 206e 6574 776f 726b 2077 6974 6820 to network with │ │ │ │ -00035be0: 6164 6472 6573 7320 4950 2061 7320 6d6f address IP as mo │ │ │ │ -00035bf0: 6469 6669 6564 2062 7920 5052 4546 4958 dified by PREFIX │ │ │ │ -00035c00: 2076 6961 0a20 2020 2020 6569 7468 6572 via. either │ │ │ │ -00035c10: 206c 6f63 616c 2049 4e54 4552 4641 4345 local INTERFACE │ │ │ │ -00035c20: 206f 7220 4741 5445 5741 592e 2020 5052 or GATEWAY. PR │ │ │ │ -00035c30: 4546 4958 2069 7320 6f70 7469 6f6e 616c EFIX is optional │ │ │ │ -00035c40: 2061 6e64 2064 6566 6175 6c74 730a 2020 and defaults. │ │ │ │ -00035c50: 2020 2074 6f20 3332 2066 6f72 2049 5076 to 32 for IPv │ │ │ │ -00035c60: 3420 6164 6472 6573 7320 616e 6420 3132 4 address and 12 │ │ │ │ -00035c70: 3820 666f 7220 4950 7636 2061 6464 7265 8 for IPv6 addre │ │ │ │ -00035c80: 7373 2e20 2052 6f75 7465 2069 730a 2020 ss. Route is. │ │ │ │ -00035c90: 2020 2069 6465 6e74 6966 6965 6420 6279 identified by │ │ │ │ -00035ca0: 2053 484f 5254 4e41 4d45 2077 6869 6368 SHORTNAME which │ │ │ │ -00035cb0: 2063 616e 2062 6520 7573 6564 2074 6f20 can be used to │ │ │ │ -00035cc0: 7265 6d6f 7665 2069 7420 282a 6e6f 7465 remove it (*note │ │ │ │ -00035cd0: 0a20 2020 2020 6e65 745f 6465 6c5f 726f . net_del_ro │ │ │ │ -00035ce0: 7574 653a 3a29 2e0a 0a1f 0a46 696c 653a ute::).....File: │ │ │ │ -00035cf0: 2067 7275 622e 696e 666f 2c20 204e 6f64 grub.info, Nod │ │ │ │ -00035d00: 653a 206e 6574 5f62 6f6f 7470 2c20 204e e: net_bootp, N │ │ │ │ -00035d10: 6578 743a 206e 6574 5f64 656c 5f61 6464 ext: net_del_add │ │ │ │ -00035d20: 722c 2020 5072 6576 3a20 6e65 745f 6164 r, Prev: net_ad │ │ │ │ -00035d30: 645f 726f 7574 652c 2020 5570 3a20 4e65 d_route, Up: Ne │ │ │ │ -00035d40: 7477 6f72 6b69 6e67 2063 6f6d 6d61 6e64 tworking command │ │ │ │ -00035d50: 730a 0a31 362e 342e 3420 6e65 745f 626f s..16.4.4 net_bo │ │ │ │ -00035d60: 6f74 700a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d otp.------------ │ │ │ │ -00035d70: 2d2d 2d2d 0a0a 202d 2d20 436f 6d6d 616e ----.. -- Comman │ │ │ │ -00035d80: 643a 206e 6574 5f62 6f6f 7470 205b 4341 d: net_bootp [CA │ │ │ │ -00035d90: 5244 5d0a 2020 2020 2050 6572 666f 726d RD]. Perform │ │ │ │ -00035da0: 2063 6f6e 6669 6775 7261 7469 6f6e 206f configuration o │ │ │ │ -00035db0: 6620 4341 5244 2075 7369 6e67 2044 4843 f CARD using DHC │ │ │ │ -00035dc0: 5020 7072 6f74 6f63 6f6c 2e20 2049 6620 P protocol. If │ │ │ │ -00035dd0: 6e6f 2063 6172 6420 6e61 6d65 0a20 2020 no card name. │ │ │ │ -00035de0: 2020 6973 2073 7065 6369 6669 6564 2c20 is specified, │ │ │ │ -00035df0: 7472 7920 746f 2063 6f6e 6669 6775 7265 try to configure │ │ │ │ -00035e00: 2061 6c6c 2065 7869 7374 696e 6720 6361 all existing ca │ │ │ │ -00035e10: 7264 732e 2020 4966 0a20 2020 2020 636f rds. If. co │ │ │ │ -00035e20: 6e66 6967 7572 6174 696f 6e20 7761 7320 nfiguration was │ │ │ │ -00035e30: 7375 6363 6573 7366 756c 2c20 696e 7465 successful, inte │ │ │ │ -00035e40: 7266 6163 6520 7769 7468 206e 616d 6520 rface with name │ │ │ │ -00035e50: 4341 5244 273a 6468 6370 2720 616e 640a CARD':dhcp' and. │ │ │ │ -00035e60: 2020 2020 2063 6f6e 6669 6775 7265 6420 configured │ │ │ │ -00035e70: 6164 6472 6573 7320 6973 2061 6464 6564 address is added │ │ │ │ -00035e80: 2074 6f20 4341 5244 2e20 2041 6464 6974 to CARD. Addit │ │ │ │ -00035e90: 696f 6e61 6c6c 7920 7468 6520 666f 6c6c ionally the foll │ │ │ │ -00035ea0: 6f77 696e 670a 2020 2020 2044 4843 5020 owing. DHCP │ │ │ │ -00035eb0: 6f70 7469 6f6e 7320 6172 6520 7265 636f options are reco │ │ │ │ -00035ec0: 676e 697a 6564 2061 6e64 2070 726f 6365 gnized and proce │ │ │ │ -00035ed0: 7373 6564 3a0a 0a20 2020 2020 2731 2028 ssed:.. '1 ( │ │ │ │ -00035ee0: 5375 626e 6574 204d 6173 6b29 270a 2020 Subnet Mask)'. │ │ │ │ -00035ef0: 2020 2020 2020 2020 5573 6564 2074 6f20 Used to │ │ │ │ -00035f00: 6361 6c63 756c 6174 6520 6e65 7477 6f72 calculate networ │ │ │ │ -00035f10: 6b20 6c6f 6361 6c20 726f 7574 696e 6720 k local routing │ │ │ │ -00035f20: 656e 7472 7920 666f 7220 696e 7465 7266 entry for interf │ │ │ │ -00035f30: 6163 650a 2020 2020 2020 2020 2020 4341 ace. CA │ │ │ │ -00035f40: 5244 273a 6468 6370 272e 0a20 2020 2020 RD':dhcp'.. │ │ │ │ -00035f50: 2733 2028 526f 7574 6572 2927 0a20 2020 '3 (Router)'. │ │ │ │ -00035f60: 2020 2020 2020 2041 6464 7320 6465 6661 Adds defa │ │ │ │ -00035f70: 756c 7420 726f 7574 6520 656e 7472 7920 ult route entry │ │ │ │ -00035f80: 7769 7468 2074 6865 206e 616d 6520 4341 with the name CA │ │ │ │ -00035f90: 5244 273a 6468 6370 3a64 6566 6175 6c74 RD':dhcp:default │ │ │ │ -00035fa0: 2720 7669 610a 2020 2020 2020 2020 2020 ' via. │ │ │ │ -00035fb0: 6761 7465 7761 7920 6672 6f6d 2044 4843 gateway from DHC │ │ │ │ -00035fc0: 5020 6f70 7469 6f6e 2e20 204e 6f74 6520 P option. Note │ │ │ │ -00035fd0: 7468 6174 206f 6e6c 7920 6f70 7469 6f6e that only option │ │ │ │ -00035fe0: 2077 6974 6820 7369 6e67 6c65 0a20 2020 with single. │ │ │ │ -00035ff0: 2020 2020 2020 2072 6f75 7465 2069 7320 route is │ │ │ │ -00036000: 6163 6365 7074 6564 2e0a 2020 2020 2027 accepted.. ' │ │ │ │ -00036010: 3620 2844 6f6d 6169 6e20 4e61 6d65 2053 6 (Domain Name S │ │ │ │ -00036020: 6572 7665 7229 270a 2020 2020 2020 2020 erver)'. │ │ │ │ -00036030: 2020 4164 6473 2061 6c6c 2073 6572 7665 Adds all serve │ │ │ │ -00036040: 7273 2066 726f 6d20 6f70 7469 6f6e 2076 rs from option v │ │ │ │ -00036050: 616c 7565 2074 6f20 7468 6520 6c69 7374 alue to the list │ │ │ │ -00036060: 206f 6620 7365 7276 6572 7320 7573 6564 of servers used │ │ │ │ -00036070: 0a20 2020 2020 2020 2020 2064 7572 696e . durin │ │ │ │ -00036080: 6720 6e61 6d65 2072 6573 6f6c 7574 696f g name resolutio │ │ │ │ -00036090: 6e2e 0a20 2020 2020 2731 3220 2848 6f73 n.. '12 (Hos │ │ │ │ -000360a0: 7420 4e61 6d65 2927 0a20 2020 2020 2020 t Name)'. │ │ │ │ -000360b0: 2020 2053 6574 7320 656e 7669 726f 6e6d Sets environm │ │ │ │ -000360c0: 656e 7420 7661 7269 6162 6c65 2027 6e65 ent variable 'ne │ │ │ │ -000360d0: 745f 273c 4341 5244 3e27 5f64 6863 705f t_''_dhcp_ │ │ │ │ -000360e0: 686f 7374 6e61 6d65 2720 282a 6e6f 7465 hostname' (*note │ │ │ │ -000360f0: 0a20 2020 2020 2020 2020 206e 6574 5f3c . net_< │ │ │ │ -00036100: 494e 5445 5246 4143 453e 5f68 6f73 746e INTERFACE>_hostn │ │ │ │ -00036110: 616d 653a 3a29 2074 6f20 7468 6520 7661 ame::) to the va │ │ │ │ -00036120: 6c75 6520 6f66 206f 7074 696f 6e2e 0a20 lue of option.. │ │ │ │ -00036130: 2020 2020 2731 3520 2844 6f6d 6169 6e20 '15 (Domain │ │ │ │ -00036140: 4e61 6d65 2927 0a20 2020 2020 2020 2020 Name)'. │ │ │ │ -00036150: 2053 6574 7320 656e 7669 726f 6e6d 656e Sets environmen │ │ │ │ -00036160: 7420 7661 7269 6162 6c65 2027 6e65 745f t variable 'net_ │ │ │ │ -00036170: 273c 4341 5244 3e27 5f64 6863 705f 646f ''_dhcp_do │ │ │ │ -00036180: 6d61 696e 2720 282a 6e6f 7465 0a20 2020 main' (*note. │ │ │ │ -00036190: 2020 2020 2020 206e 6574 5f3c 494e 5445 net__domain::) │ │ │ │ -000361b0: 2074 6f20 7468 6520 7661 6c75 6520 6f66 to the value of │ │ │ │ -000361c0: 206f 7074 696f 6e2e 0a20 2020 2020 2731 option.. '1 │ │ │ │ -000361d0: 3720 2852 6f6f 7420 5061 7468 2927 0a20 7 (Root Path)'. │ │ │ │ -000361e0: 2020 2020 2020 2020 2053 6574 7320 656e Sets en │ │ │ │ -000361f0: 7669 726f 6e6d 656e 7420 7661 7269 6162 vironment variab │ │ │ │ -00036200: 6c65 2027 6e65 745f 273c 4341 5244 3e27 le 'net_'' │ │ │ │ -00036210: 5f64 6863 705f 726f 6f74 7061 7468 2720 _dhcp_rootpath' │ │ │ │ -00036220: 282a 6e6f 7465 0a20 2020 2020 2020 2020 (*note. │ │ │ │ -00036230: 206e 6574 5f3c 494e 5445 5246 4143 453e net_ │ │ │ │ -00036240: 5f72 6f6f 7470 6174 683a 3a29 2074 6f20 _rootpath::) to │ │ │ │ -00036250: 7468 6520 7661 6c75 6520 6f66 206f 7074 the value of opt │ │ │ │ -00036260: 696f 6e2e 0a20 2020 2020 2731 3820 2845 ion.. '18 (E │ │ │ │ -00036270: 7874 656e 7369 6f6e 7320 5061 7468 2927 xtensions Path)' │ │ │ │ -00036280: 0a20 2020 2020 2020 2020 2053 6574 7320 . Sets │ │ │ │ -00036290: 656e 7669 726f 6e6d 656e 7420 7661 7269 environment vari │ │ │ │ -000362a0: 6162 6c65 2027 6e65 745f 273c 4341 5244 able 'net_''_dhcp_extensio │ │ │ │ -000362c0: 6e73 7061 7468 270a 2020 2020 2020 2020 nspath'. │ │ │ │ -000362d0: 2020 282a 6e6f 7465 206e 6574 5f3c 494e (*note net__extensi │ │ │ │ -000362f0: 6f6e 7370 6174 683a 3a29 2074 6f20 7468 onspath::) to th │ │ │ │ -00036300: 6520 7661 6c75 6520 6f66 0a20 2020 2020 e value of. │ │ │ │ -00036310: 2020 2020 206f 7074 696f 6e2e 0a0a 1f0a option..... │ │ │ │ -00036320: 4669 6c65 3a20 6772 7562 2e69 6e66 6f2c File: grub.info, │ │ │ │ -00036330: 2020 4e6f 6465 3a20 6e65 745f 6465 6c5f Node: net_del_ │ │ │ │ -00036340: 6164 6472 2c20 204e 6578 743a 206e 6574 addr, Next: net │ │ │ │ -00036350: 5f64 656c 5f64 6e73 2c20 2050 7265 763a _del_dns, Prev: │ │ │ │ -00036360: 206e 6574 5f62 6f6f 7470 2c20 2055 703a net_bootp, Up: │ │ │ │ -00036370: 204e 6574 776f 726b 696e 6720 636f 6d6d Networking comm │ │ │ │ -00036380: 616e 6473 0a0a 3136 2e34 2e35 206e 6574 ands..16.4.5 net │ │ │ │ -00036390: 5f64 656c 5f61 6464 720a 2d2d 2d2d 2d2d _del_addr.------ │ │ │ │ -000363a0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 -------------.. │ │ │ │ -000363b0: 2d2d 2043 6f6d 6d61 6e64 3a20 6e65 745f -- Command: net_ │ │ │ │ -000363c0: 6465 6c5f 6164 6472 2049 4e54 4552 4641 del_addr INTERFA │ │ │ │ -000363d0: 4345 0a20 2020 2020 5265 6d6f 7665 2063 CE. Remove c │ │ │ │ -000363e0: 6f6e 6669 6775 7265 6420 494e 5445 5246 onfigured INTERF │ │ │ │ -000363f0: 4143 4520 7769 7468 2061 7373 6f63 6961 ACE with associa │ │ │ │ -00036400: 7465 6420 6164 6472 6573 732e 0a0a 1f0a ted address..... │ │ │ │ -00036410: 4669 6c65 3a20 6772 7562 2e69 6e66 6f2c File: grub.info, │ │ │ │ -00036420: 2020 4e6f 6465 3a20 6e65 745f 6465 6c5f Node: net_del_ │ │ │ │ -00036430: 646e 732c 2020 4e65 7874 3a20 6e65 745f dns, Next: net_ │ │ │ │ -00036440: 6465 6c5f 726f 7574 652c 2020 5072 6576 del_route, Prev │ │ │ │ -00036450: 3a20 6e65 745f 6465 6c5f 6164 6472 2c20 : net_del_addr, │ │ │ │ -00036460: 2055 703a 204e 6574 776f 726b 696e 6720 Up: Networking │ │ │ │ -00036470: 636f 6d6d 616e 6473 0a0a 3136 2e34 2e36 commands..16.4.6 │ │ │ │ -00036480: 206e 6574 5f64 656c 5f64 6e73 0a2d 2d2d net_del_dns.--- │ │ │ │ -00036490: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a ---------------. │ │ │ │ -000364a0: 0a20 2d2d 2043 6f6d 6d61 6e64 3a20 6e65 . -- Command: ne │ │ │ │ -000364b0: 745f 6465 6c5f 646e 7320 4144 4452 4553 t_del_dns ADDRES │ │ │ │ -000364c0: 530a 2020 2020 2052 656d 6f76 6520 4144 S. Remove AD │ │ │ │ -000364d0: 4452 4553 5320 6672 6f6d 206c 6973 7420 DRESS from list │ │ │ │ -000364e0: 6f66 2073 6572 7665 7273 2075 7365 6420 of servers used │ │ │ │ -000364f0: 6475 7269 6e67 206e 616d 6520 6c6f 6f6b during name look │ │ │ │ -00036500: 7570 2e0a 0a1f 0a46 696c 653a 2067 7275 up.....File: gru │ │ │ │ -00036510: 622e 696e 666f 2c20 204e 6f64 653a 206e b.info, Node: n │ │ │ │ -00036520: 6574 5f64 656c 5f72 6f75 7465 2c20 204e et_del_route, N │ │ │ │ -00036530: 6578 743a 206e 6574 5f67 6574 5f64 6863 ext: net_get_dhc │ │ │ │ -00036540: 705f 6f70 7469 6f6e 2c20 2050 7265 763a p_option, Prev: │ │ │ │ -00036550: 206e 6574 5f64 656c 5f64 6e73 2c20 2055 net_del_dns, U │ │ │ │ -00036560: 703a 204e 6574 776f 726b 696e 6720 636f p: Networking co │ │ │ │ -00036570: 6d6d 616e 6473 0a0a 3136 2e34 2e37 206e mmands..16.4.7 n │ │ │ │ -00036580: 6574 5f64 656c 5f72 6f75 7465 0a2d 2d2d et_del_route.--- │ │ │ │ -00036590: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ -000365a0: 2d0a 0a20 2d2d 2043 6f6d 6d61 6e64 3a20 -.. -- Command: │ │ │ │ -000365b0: 6e65 745f 6465 6c5f 726f 7574 6520 5348 net_del_route SH │ │ │ │ -000365c0: 4f52 544e 414d 450a 2020 2020 2052 656d ORTNAME. Rem │ │ │ │ -000365d0: 6f76 6520 726f 7574 6520 656e 7472 7920 ove route entry │ │ │ │ -000365e0: 6964 656e 7469 6669 6564 2062 7920 5348 identified by SH │ │ │ │ -000365f0: 4f52 544e 414d 452e 0a0a 1f0a 4669 6c65 ORTNAME.....File │ │ │ │ -00036600: 3a20 6772 7562 2e69 6e66 6f2c 2020 4e6f : grub.info, No │ │ │ │ -00036610: 6465 3a20 6e65 745f 6765 745f 6468 6370 de: net_get_dhcp │ │ │ │ -00036620: 5f6f 7074 696f 6e2c 2020 4e65 7874 3a20 _option, Next: │ │ │ │ -00036630: 6e65 745f 6970 7636 5f61 7574 6f63 6f6e net_ipv6_autocon │ │ │ │ -00036640: 662c 2020 5072 6576 3a20 6e65 745f 6465 f, Prev: net_de │ │ │ │ -00036650: 6c5f 726f 7574 652c 2020 5570 3a20 4e65 l_route, Up: Ne │ │ │ │ -00036660: 7477 6f72 6b69 6e67 2063 6f6d 6d61 6e64 tworking command │ │ │ │ -00036670: 730a 0a31 362e 342e 3820 6e65 745f 6765 s..16.4.8 net_ge │ │ │ │ -00036680: 745f 6468 6370 5f6f 7074 696f 6e0a 2d2d t_dhcp_option.-- │ │ │ │ -00036690: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ -000366a0: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 436f --------.. -- Co │ │ │ │ -000366b0: 6d6d 616e 643a 206e 6574 5f67 6574 5f64 mmand: net_get_d │ │ │ │ -000366c0: 6863 705f 6f70 7469 6f6e 2056 4152 2049 hcp_option VAR I │ │ │ │ -000366d0: 4e54 4552 4641 4345 204e 554d 4245 5220 NTERFACE NUMBER │ │ │ │ -000366e0: 5459 5045 0a20 2020 2020 5265 7175 6573 TYPE. Reques │ │ │ │ -000366f0: 7420 4448 4350 206f 7074 696f 6e20 4e55 t DHCP option NU │ │ │ │ -00036700: 4d42 4552 206f 6620 5459 5045 2076 6961 MBER of TYPE via │ │ │ │ -00036710: 2049 4e54 4552 4641 4345 2e20 2054 5950 INTERFACE. TYP │ │ │ │ -00036720: 4520 6361 6e20 6265 206f 6e65 0a20 2020 E can be one. │ │ │ │ -00036730: 2020 6f66 2027 7374 7269 6e67 272c 2027 of 'string', ' │ │ │ │ -00036740: 6e75 6d62 6572 2720 6f72 2027 6865 7827 number' or 'hex' │ │ │ │ -00036750: 2e20 2049 6620 6f70 7469 6f6e 2069 7320 . If option is │ │ │ │ -00036760: 666f 756e 642c 2061 7373 6967 6e20 6974 found, assign it │ │ │ │ -00036770: 730a 2020 2020 2076 616c 7565 2074 6f20 s. value to │ │ │ │ -00036780: 7661 7269 6162 6c65 2056 4152 2e20 2056 variable VAR. V │ │ │ │ -00036790: 616c 7565 7320 6f66 2074 7970 6573 2027 alues of types ' │ │ │ │ -000367a0: 6e75 6d62 6572 2720 616e 6420 2768 6578 number' and 'hex │ │ │ │ -000367b0: 2720 6172 650a 2020 2020 2063 6f6e 7665 ' are. conve │ │ │ │ -000367c0: 7274 6564 2074 6f20 7374 7269 6e67 2072 rted to string r │ │ │ │ -000367d0: 6570 7265 7365 6e74 6174 696f 6e2e 0a0a epresentation... │ │ │ │ -000367e0: 1f0a 4669 6c65 3a20 6772 7562 2e69 6e66 ..File: grub.inf │ │ │ │ -000367f0: 6f2c 2020 4e6f 6465 3a20 6e65 745f 6970 o, Node: net_ip │ │ │ │ -00036800: 7636 5f61 7574 6f63 6f6e 662c 2020 4e65 v6_autoconf, Ne │ │ │ │ -00036810: 7874 3a20 6e65 745f 6c73 5f61 6464 722c xt: net_ls_addr, │ │ │ │ -00036820: 2020 5072 6576 3a20 6e65 745f 6765 745f Prev: net_get_ │ │ │ │ -00036830: 6468 6370 5f6f 7074 696f 6e2c 2020 5570 dhcp_option, Up │ │ │ │ -00036840: 3a20 4e65 7477 6f72 6b69 6e67 2063 6f6d : Networking com │ │ │ │ -00036850: 6d61 6e64 730a 0a31 362e 342e 3920 6e65 mands..16.4.9 ne │ │ │ │ -00036860: 745f 6970 7636 5f61 7574 6f63 6f6e 660a t_ipv6_autoconf. │ │ │ │ -00036870: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ -00036880: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 436f --------.. -- Co │ │ │ │ -00036890: 6d6d 616e 643a 206e 6574 5f69 7076 365f mmand: net_ipv6_ │ │ │ │ -000368a0: 6175 746f 636f 6e66 205b 4341 5244 5d0a autoconf [CARD]. │ │ │ │ -000368b0: 2020 2020 2050 6572 666f 726d 2049 5076 Perform IPv │ │ │ │ -000368c0: 3620 6175 746f 636f 6e66 6967 7572 6174 6 autoconfigurat │ │ │ │ -000368d0: 696f 6e20 6279 2061 6464 696e 6720 746f ion by adding to │ │ │ │ -000368e0: 2074 6865 2043 4152 4420 696e 7465 7266 the CARD interf │ │ │ │ -000368f0: 6163 6520 7769 7468 0a20 2020 2020 6e61 ace with. na │ │ │ │ -00036900: 6d65 2043 4152 4427 3a6c 696e 6b27 2061 me CARD':link' a │ │ │ │ -00036910: 6e64 206c 696e 6b20 6c6f 6361 6c20 4d41 nd link local MA │ │ │ │ -00036920: 432d 6261 7365 6420 6164 6472 6573 732e C-based address. │ │ │ │ -00036930: 2020 4966 206e 6f20 6361 7264 2069 730a If no card is. │ │ │ │ -00036940: 2020 2020 2073 7065 6369 6669 6564 2c20 specified, │ │ │ │ -00036950: 7065 7266 6f72 6d20 6175 746f 636f 6e66 perform autoconf │ │ │ │ -00036960: 6967 7572 6174 696f 6e20 666f 7220 616c iguration for al │ │ │ │ -00036970: 6c20 6578 6973 7469 6e67 2063 6172 6473 l existing cards │ │ │ │ -00036980: 2e0a 0a1f 0a46 696c 653a 2067 7275 622e .....File: grub. │ │ │ │ -00036990: 696e 666f 2c20 204e 6f64 653a 206e 6574 info, Node: net │ │ │ │ -000369a0: 5f6c 735f 6164 6472 2c20 204e 6578 743a _ls_addr, Next: │ │ │ │ -000369b0: 206e 6574 5f6c 735f 6361 7264 732c 2020 net_ls_cards, │ │ │ │ -000369c0: 5072 6576 3a20 6e65 745f 6970 7636 5f61 Prev: net_ipv6_a │ │ │ │ -000369d0: 7574 6f63 6f6e 662c 2020 5570 3a20 4e65 utoconf, Up: Ne │ │ │ │ -000369e0: 7477 6f72 6b69 6e67 2063 6f6d 6d61 6e64 tworking command │ │ │ │ -000369f0: 730a 0a31 362e 342e 3130 206e 6574 5f6c s..16.4.10 net_l │ │ │ │ -00036a00: 735f 6164 6472 0a2d 2d2d 2d2d 2d2d 2d2d s_addr.--------- │ │ │ │ -00036a10: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 ----------.. -- │ │ │ │ -00036a20: 436f 6d6d 616e 643a 206e 6574 5f6c 735f Command: net_ls_ │ │ │ │ -00036a30: 6164 6472 0a20 2020 2020 4c69 7374 2061 addr. List a │ │ │ │ -00036a40: 6c6c 2063 6f6e 6669 6775 7265 6420 696e ll configured in │ │ │ │ -00036a50: 7465 7266 6163 6573 2077 6974 6820 7468 terfaces with th │ │ │ │ -00036a60: 6569 7220 4d41 4320 616e 6420 4950 2061 eir MAC and IP a │ │ │ │ -00036a70: 6464 7265 7373 6573 2e0a 0a1f 0a46 696c ddresses.....Fil │ │ │ │ -00036a80: 653a 2067 7275 622e 696e 666f 2c20 204e e: grub.info, N │ │ │ │ -00036a90: 6f64 653a 206e 6574 5f6c 735f 6361 7264 ode: net_ls_card │ │ │ │ -00036aa0: 732c 2020 4e65 7874 3a20 6e65 745f 6c73 s, Next: net_ls │ │ │ │ -00036ab0: 5f64 6e73 2c20 2050 7265 763a 206e 6574 _dns, Prev: net │ │ │ │ -00036ac0: 5f6c 735f 6164 6472 2c20 2055 703a 204e _ls_addr, Up: N │ │ │ │ -00036ad0: 6574 776f 726b 696e 6720 636f 6d6d 616e etworking comman │ │ │ │ -00036ae0: 6473 0a0a 3136 2e34 2e31 3120 6e65 745f ds..16.4.11 net_ │ │ │ │ -00036af0: 6c73 5f63 6172 6473 0a2d 2d2d 2d2d 2d2d ls_cards.------- │ │ │ │ -00036b00: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 -------------.. │ │ │ │ -00036b10: 2d2d 2043 6f6d 6d61 6e64 3a20 6e65 745f -- Command: net_ │ │ │ │ -00036b20: 6c73 5f63 6172 6473 0a20 2020 2020 4c69 ls_cards. Li │ │ │ │ -00036b30: 7374 2061 6c6c 2064 6574 6563 7465 6420 st all detected │ │ │ │ -00036b40: 6e65 7477 6f72 6b20 6361 7264 7320 7769 network cards wi │ │ │ │ -00036b50: 7468 2074 6865 6972 204d 4143 2061 6464 th their MAC add │ │ │ │ -00036b60: 7265 7373 2e0a 0a1f 0a46 696c 653a 2067 ress.....File: g │ │ │ │ -00036b70: 7275 622e 696e 666f 2c20 204e 6f64 653a rub.info, Node: │ │ │ │ -00036b80: 206e 6574 5f6c 735f 646e 732c 2020 4e65 net_ls_dns, Ne │ │ │ │ -00036b90: 7874 3a20 6e65 745f 6c73 5f72 6f75 7465 xt: net_ls_route │ │ │ │ -00036ba0: 732c 2020 5072 6576 3a20 6e65 745f 6c73 s, Prev: net_ls │ │ │ │ -00036bb0: 5f63 6172 6473 2c20 2055 703a 204e 6574 _cards, Up: Net │ │ │ │ -00036bc0: 776f 726b 696e 6720 636f 6d6d 616e 6473 working commands │ │ │ │ -00036bd0: 0a0a 3136 2e34 2e31 3220 6e65 745f 6c73 ..16.4.12 net_ls │ │ │ │ -00036be0: 5f64 6e73 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d _dns.----------- │ │ │ │ -00036bf0: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2043 6f6d -------.. -- Com │ │ │ │ -00036c00: 6d61 6e64 3a20 6e65 745f 6c73 5f64 6e73 mand: net_ls_dns │ │ │ │ -00036c10: 0a20 2020 2020 4c69 7374 2061 6464 7265 . List addre │ │ │ │ -00036c20: 7373 6573 206f 6620 444e 5320 7365 7276 sses of DNS serv │ │ │ │ -00036c30: 6572 7320 7573 6564 2064 7572 696e 6720 ers used during │ │ │ │ -00036c40: 6e61 6d65 206c 6f6f 6b75 702e 0a0a 1f0a name lookup..... │ │ │ │ -00036c50: 4669 6c65 3a20 6772 7562 2e69 6e66 6f2c File: grub.info, │ │ │ │ -00036c60: 2020 4e6f 6465 3a20 6e65 745f 6c73 5f72 Node: net_ls_r │ │ │ │ -00036c70: 6f75 7465 732c 2020 4e65 7874 3a20 6e65 outes, Next: ne │ │ │ │ -00036c80: 745f 6e73 6c6f 6f6b 7570 2c20 2050 7265 t_nslookup, Pre │ │ │ │ -00036c90: 763a 206e 6574 5f6c 735f 646e 732c 2020 v: net_ls_dns, │ │ │ │ -00036ca0: 5570 3a20 4e65 7477 6f72 6b69 6e67 2063 Up: Networking c │ │ │ │ -00036cb0: 6f6d 6d61 6e64 730a 0a31 362e 342e 3133 ommands..16.4.13 │ │ │ │ -00036cc0: 206e 6574 5f6c 735f 726f 7574 6573 0a2d net_ls_routes.- │ │ │ │ -00036cd0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ -00036ce0: 2d2d 2d2d 0a0a 202d 2d20 436f 6d6d 616e ----.. -- Comman │ │ │ │ -00036cf0: 643a 206e 6574 5f6c 735f 726f 7574 6573 d: net_ls_routes │ │ │ │ -00036d00: 0a20 2020 2020 4c69 7374 2072 6f75 7469 . List routi │ │ │ │ -00036d10: 6e67 2065 6e74 7269 6573 2e0a 0a1f 0a46 ng entries.....F │ │ │ │ -00036d20: 696c 653a 2067 7275 622e 696e 666f 2c20 ile: grub.info, │ │ │ │ -00036d30: 204e 6f64 653a 206e 6574 5f6e 736c 6f6f Node: net_nsloo │ │ │ │ -00036d40: 6b75 702c 2020 5072 6576 3a20 6e65 745f kup, Prev: net_ │ │ │ │ -00036d50: 6c73 5f72 6f75 7465 732c 2020 5570 3a20 ls_routes, Up: │ │ │ │ -00036d60: 4e65 7477 6f72 6b69 6e67 2063 6f6d 6d61 Networking comma │ │ │ │ -00036d70: 6e64 730a 0a31 362e 342e 3134 206e 6574 nds..16.4.14 net │ │ │ │ -00036d80: 5f6e 736c 6f6f 6b75 700a 2d2d 2d2d 2d2d _nslookup.------ │ │ │ │ -00036d90: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a --------------.. │ │ │ │ -00036da0: 202d 2d20 436f 6d6d 616e 643a 206e 6574 -- Command: net │ │ │ │ -00036db0: 5f6e 736c 6f6f 6b75 7020 4e41 4d45 205b _nslookup NAME [ │ │ │ │ -00036dc0: 5345 5256 4552 5d0a 2020 2020 2052 6573 SERVER]. Res │ │ │ │ -00036dd0: 6f6c 7665 2061 6464 7265 7373 206f 6620 olve address of │ │ │ │ -00036de0: 4e41 4d45 2075 7369 6e67 2044 4e53 2073 NAME using DNS s │ │ │ │ -00036df0: 6572 7665 7220 5345 5256 4552 2e20 2049 erver SERVER. I │ │ │ │ -00036e00: 6620 6e6f 2073 6572 7665 7220 6973 0a20 f no server is. │ │ │ │ -00036e10: 2020 2020 6769 7665 6e2c 2075 7365 2064 given, use d │ │ │ │ -00036e20: 6566 6175 6c74 206c 6973 7420 6f66 2073 efault list of s │ │ │ │ -00036e30: 6572 7665 7273 2e0a 0a1f 0a46 696c 653a ervers.....File: │ │ │ │ -00036e40: 2067 7275 622e 696e 666f 2c20 204e 6f64 grub.info, Nod │ │ │ │ -00036e50: 653a 2049 6e74 6572 6e61 7469 6f6e 616c e: International │ │ │ │ -00036e60: 6973 6174 696f 6e2c 2020 4e65 7874 3a20 isation, Next: │ │ │ │ -00036e70: 5365 6375 7269 7479 2c20 2050 7265 763a Security, Prev: │ │ │ │ -00036e80: 2043 6f6d 6d61 6e64 732c 2020 5570 3a20 Commands, Up: │ │ │ │ -00036e90: 546f 700a 0a31 3720 496e 7465 726e 6174 Top..17 Internat │ │ │ │ -00036ea0: 696f 6e61 6c69 7361 7469 6f6e 0a2a 2a2a ionalisation.*** │ │ │ │ -00036eb0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ -00036ec0: 2a2a 2a2a 0a0a 3137 2e31 2043 6861 7273 ****..17.1 Chars │ │ │ │ -00036ed0: 6574 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a et.============. │ │ │ │ -00036ee0: 0a47 5255 4220 7573 6573 2055 5446 2d38 .GRUB uses UTF-8 │ │ │ │ -00036ef0: 2069 6e74 6572 6e61 6c6c 7920 6f74 6865 internally othe │ │ │ │ -00036f00: 7220 7468 616e 2069 6e20 7265 6e64 6572 r than in render │ │ │ │ -00036f10: 696e 6720 7768 6572 6520 736f 6d65 0a47 ing where some.G │ │ │ │ -00036f20: 5255 422d 7370 6563 6966 6963 2061 7070 RUB-specific app │ │ │ │ -00036f30: 726f 7072 6961 7465 2072 6570 7265 7365 ropriate represe │ │ │ │ -00036f40: 6e74 6174 696f 6e20 6973 2075 7365 642e ntation is used. │ │ │ │ -00036f50: 2020 416c 6c20 7465 7874 2066 696c 6573 All text files │ │ │ │ -00036f60: 0a28 696e 636c 7564 696e 6720 636f 6e66 .(including conf │ │ │ │ -00036f70: 6967 2920 6172 6520 6173 7375 6d65 6420 ig) are assumed │ │ │ │ -00036f80: 746f 2062 6520 656e 636f 6465 6420 696e to be encoded in │ │ │ │ -00036f90: 2055 5446 2d38 2e0a 0a31 372e 3220 4669 UTF-8...17.2 Fi │ │ │ │ -00036fa0: 6c65 7379 7374 656d 730a 3d3d 3d3d 3d3d lesystems.====== │ │ │ │ -00036fb0: 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a 4e54 4653 ==========..NTFS │ │ │ │ -00036fc0: 2c20 4a46 532c 2055 4446 2c20 4846 532b , JFS, UDF, HFS+ │ │ │ │ -00036fd0: 2c20 6578 4641 542c 206c 6f6e 6720 6669 , exFAT, long fi │ │ │ │ -00036fe0: 6c65 6e61 6d65 7320 696e 2046 4154 2c20 lenames in FAT, │ │ │ │ -00036ff0: 4a6f 6c69 6574 2070 6172 7420 6f66 0a49 Joliet part of.I │ │ │ │ -00037000: 534f 3936 3630 2061 7265 2074 7265 6174 SO9660 are treat │ │ │ │ -00037010: 6564 2061 7320 5554 462d 3136 2061 7320 ed as UTF-16 as │ │ │ │ -00037020: 7065 7220 7370 6563 6966 6963 6174 696f per specificatio │ │ │ │ -00037030: 6e2e 2020 4146 5320 616e 6420 4246 5320 n. AFS and BFS │ │ │ │ -00037040: 6172 650a 7265 6164 2061 7320 5554 462d are.read as UTF- │ │ │ │ -00037050: 382c 2061 6761 696e 2061 6363 6f72 6469 8, again accordi │ │ │ │ -00037060: 6e67 2074 6f20 7370 6563 6966 6963 6174 ng to specificat │ │ │ │ -00037070: 696f 6e2e 2020 4274 7246 532c 2063 7069 ion. BtrFS, cpi │ │ │ │ -00037080: 6f2c 2074 6172 2c0a 7371 7561 7368 342c o, tar,.squash4, │ │ │ │ -00037090: 206d 696e 6978 2c20 6d69 6e69 7832 2c20 minix, minix2, │ │ │ │ -000370a0: 6d69 6e69 7833 2c20 524f 4d46 532c 2052 minix3, ROMFS, R │ │ │ │ -000370b0: 6569 7365 7246 532c 2058 4653 2c20 6578 eiserFS, XFS, ex │ │ │ │ -000370c0: 7432 2c20 6578 7433 2c20 6578 7434 2c0a t2, ext3, ext4,. │ │ │ │ -000370d0: 4641 5420 2873 686f 7274 206e 616d 6573 FAT (short names │ │ │ │ -000370e0: 292c 2046 3246 532c 2052 6f63 6b52 6964 ), F2FS, RockRid │ │ │ │ -000370f0: 6765 2070 6172 7420 6f66 2049 534f 3936 ge part of ISO96 │ │ │ │ -00037100: 3630 2c20 6e69 6c66 7332 2c20 5546 5331 60, nilfs2, UFS1 │ │ │ │ -00037110: 2c20 5546 5332 0a61 6e64 205a 4653 2061 , UFS2.and ZFS a │ │ │ │ -00037120: 7265 2061 7373 756d 6564 2074 6f20 6265 re assumed to be │ │ │ │ -00037130: 2055 5446 2d38 2e20 2054 6869 7320 6d69 UTF-8. This mi │ │ │ │ -00037140: 6768 7420 6265 2066 616c 7365 206f 6e20 ght be false on │ │ │ │ -00037150: 7379 7374 656d 730a 636f 6e66 6967 7572 systems.configur │ │ │ │ -00037160: 6564 2077 6974 6820 6c65 6761 6379 2063 ed with legacy c │ │ │ │ -00037170: 6861 7273 6574 2062 7574 2061 7320 6c6f harset but as lo │ │ │ │ -00037180: 6e67 2061 7320 7468 6520 6368 6172 7365 ng as the charse │ │ │ │ -00037190: 7420 7573 6564 2069 730a 7375 7065 7273 t used is.supers │ │ │ │ -000371a0: 6574 206f 6620 4153 4349 4920 796f 7520 et of ASCII you │ │ │ │ -000371b0: 7368 6f75 6c64 2062 6520 6162 6c65 2074 should be able t │ │ │ │ -000371c0: 6f20 6163 6365 7373 2041 5343 4949 2d6e o access ASCII-n │ │ │ │ -000371d0: 616d 6564 2066 696c 6573 2e20 2041 6e64 amed files. And │ │ │ │ -000371e0: 0a69 7427 7320 7265 636f 6d6d 656e 6465 .it's recommende │ │ │ │ -000371f0: 6420 746f 2063 6f6e 6669 6775 7265 2079 d to configure y │ │ │ │ -00037200: 6f75 7220 7379 7374 656d 2074 6f20 7573 our system to us │ │ │ │ -00037210: 6520 5554 462d 3820 746f 2061 6363 6573 e UTF-8 to acces │ │ │ │ -00037220: 7320 7468 650a 6669 6c65 7379 7374 656d s the.filesystem │ │ │ │ -00037230: 2c20 636f 6e76 6d76 206d 6179 2068 656c , convmv may hel │ │ │ │ -00037240: 7020 7769 7468 206d 6967 7261 7469 6f6e p with migration │ │ │ │ -00037250: 2e20 2049 534f 3936 3630 2028 706c 6169 . ISO9660 (plai │ │ │ │ -00037260: 6e29 2066 696c 656e 616d 6573 0a61 7265 n) filenames.are │ │ │ │ -00037270: 2073 7065 6369 6669 6564 2061 7320 6265 specified as be │ │ │ │ -00037280: 696e 6720 4153 4349 4920 6f72 2062 6569 ing ASCII or bei │ │ │ │ -00037290: 6e67 2064 6573 6372 6962 6564 2077 6974 ng described wit │ │ │ │ -000372a0: 6820 756e 7370 6563 6966 6965 6420 6573 h unspecified es │ │ │ │ -000372b0: 6361 7065 0a73 6571 7565 6e63 6573 2e20 cape.sequences. │ │ │ │ -000372c0: 2047 5255 4220 6173 7375 6d65 7320 7468 GRUB assumes th │ │ │ │ -000372d0: 6174 2074 6865 2049 534f 3936 3630 206e at the ISO9660 n │ │ │ │ -000372e0: 616d 6573 2061 7265 2055 5446 2d38 2028 ames are UTF-8 ( │ │ │ │ -000372f0: 7369 6e63 6520 616e 790a 4153 4349 4920 since any.ASCII │ │ │ │ -00037300: 6973 2076 616c 6964 2055 5446 2d38 292e is valid UTF-8). │ │ │ │ -00037310: 2020 5468 6572 6520 6172 6520 736f 6d65 There are some │ │ │ │ -00037320: 206f 6c64 2043 442d 524f 4d73 2077 6869 old CD-ROMs whi │ │ │ │ -00037330: 6368 2075 7365 2043 5034 3337 2069 6e0a ch use CP437 in. │ │ │ │ -00037340: 6e6f 6e2d 636f 6d70 6c69 616e 7420 7761 non-compliant wa │ │ │ │ -00037350: 792e 2020 596f 7527 7265 2073 7469 6c6c y. You're still │ │ │ │ -00037360: 2061 626c 6520 746f 2061 6363 6573 7320 able to access │ │ │ │ -00037370: 6669 6c65 7320 7769 7468 206e 616d 6573 files with names │ │ │ │ -00037380: 0a63 6f6e 7461 696e 696e 6720 6f6e 6c79 .containing only │ │ │ │ -00037390: 2041 5343 4949 2063 6861 7261 6374 6572 ASCII character │ │ │ │ -000373a0: 7320 6f6e 2073 7563 6820 6669 6c65 7379 s on such filesy │ │ │ │ -000373b0: 7374 656d 7320 7468 6f75 6768 2e20 2059 stems though. Y │ │ │ │ -000373c0: 6f75 2772 650a 616c 736f 2061 626c 6520 ou're.also able │ │ │ │ -000373d0: 746f 2061 6363 6573 7320 616e 7920 6669 to access any fi │ │ │ │ -000373e0: 6c65 2069 6620 7468 6520 6669 6c65 7379 le if the filesy │ │ │ │ -000373f0: 7374 656d 2063 6f6e 7461 696e 7320 7661 stem contains va │ │ │ │ -00037400: 6c69 6420 4a6f 6c69 6574 0a28 5554 462d lid Joliet.(UTF- │ │ │ │ -00037410: 3136 2920 6f72 2052 6f63 6b52 6964 6765 16) or RockRidge │ │ │ │ -00037420: 2028 5554 462d 3829 2e20 2041 4646 532c (UTF-8). AFFS, │ │ │ │ -00037430: 2053 4653 2061 6e64 2048 4653 206e 6576 SFS and HFS nev │ │ │ │ -00037440: 6572 2075 7365 2075 6e69 636f 6465 2061 er use unicode a │ │ │ │ -00037450: 6e64 0a47 5255 4220 6173 7375 6d65 7320 nd.GRUB assumes │ │ │ │ -00037460: 7468 656d 2074 6f20 6265 2069 6e20 4c61 them to be in La │ │ │ │ -00037470: 7469 6e31 2c20 4c61 7469 6e31 2061 6e64 tin1, Latin1 and │ │ │ │ -00037480: 204d 6163 526f 6d61 6e20 7265 7370 6563 MacRoman respec │ │ │ │ -00037490: 7469 7665 6c79 2e0a 4752 5542 2068 616e tively..GRUB han │ │ │ │ -000374a0: 646c 6573 2066 696c 6573 7973 7465 6d20 dles filesystem │ │ │ │ -000374b0: 6361 7365 2d69 6e73 656e 7369 7469 7669 case-insensitivi │ │ │ │ -000374c0: 7479 2068 6f77 6576 6572 206e 6f20 6174 ty however no at │ │ │ │ -000374d0: 7465 6d70 7420 6973 0a70 6572 666f 726d tempt is.perform │ │ │ │ -000374e0: 6564 2061 7420 6361 7365 2063 6f6e 7665 ed at case conve │ │ │ │ -000374f0: 7273 696f 6e20 6f66 2069 6e74 6572 6e61 rsion of interna │ │ │ │ -00037500: 7469 6f6e 616c 2063 6861 7261 6374 6572 tional character │ │ │ │ -00037510: 7320 736f 2065 2e67 2e20 2061 2066 696c s so e.g. a fil │ │ │ │ -00037520: 650a 6e61 6d65 6420 6c6f 7765 7263 6173 e.named lowercas │ │ │ │ -00037530: 6520 6772 6565 6b20 616c 7068 6120 6973 e greek alpha is │ │ │ │ -00037540: 2074 7265 6174 6564 2061 7320 6469 6666 treated as diff │ │ │ │ -00037550: 6572 656e 7420 6672 6f6d 2074 6865 206f erent from the o │ │ │ │ -00037560: 6e65 206e 616d 6564 0a61 7320 7570 7065 ne named.as uppe │ │ │ │ -00037570: 7263 6173 6520 616c 7068 612e 2020 5468 rcase alpha. Th │ │ │ │ -00037580: 6520 6669 6c65 7379 7374 656d 7320 696e e filesystems in │ │ │ │ -00037590: 2071 7565 7374 696f 6e73 2061 7265 204e questions are N │ │ │ │ -000375a0: 5446 5320 2865 7863 6570 7420 504f 5349 TFS (except POSI │ │ │ │ -000375b0: 580a 6e61 6d65 7370 6163 6529 2c20 4846 X.namespace), HF │ │ │ │ -000375c0: 532b 2028 636f 6e66 6967 7572 6162 6c65 S+ (configurable │ │ │ │ -000375d0: 2061 7420 6d6b 6673 2074 696d 652c 2064 at mkfs time, d │ │ │ │ -000375e0: 6566 6175 6c74 2069 6e73 656e 7369 7469 efault insensiti │ │ │ │ -000375f0: 7665 292c 2053 4653 0a28 636f 6e66 6967 ve), SFS.(config │ │ │ │ -00037600: 7572 6162 6c65 2061 7420 6d6b 6673 2074 urable at mkfs t │ │ │ │ -00037610: 696d 652c 2064 6566 6175 6c74 2069 6e73 ime, default ins │ │ │ │ -00037620: 656e 7369 7469 7665 292c 204a 4653 2028 ensitive), JFS ( │ │ │ │ -00037630: 636f 6e66 6967 7572 6162 6c65 2061 740a configurable at. │ │ │ │ -00037640: 6d6b 6673 2074 696d 652c 2064 6566 6175 mkfs time, defau │ │ │ │ -00037650: 6c74 2073 656e 7369 7469 7665 292c 2048 lt sensitive), H │ │ │ │ -00037660: 4653 2c20 4146 4653 2c20 4641 542c 2065 FS, AFFS, FAT, e │ │ │ │ -00037670: 7846 4154 2061 6e64 205a 4653 0a28 636f xFAT and ZFS.(co │ │ │ │ -00037680: 6e66 6967 7572 6162 6c65 206f 6e20 7065 nfigurable on pe │ │ │ │ -00037690: 722d 7375 6276 6f6c 756d 6520 6261 7369 r-subvolume basi │ │ │ │ -000376a0: 7320 6279 2070 726f 7065 7274 7920 2263 s by property "c │ │ │ │ -000376b0: 6173 6573 656e 7369 7469 7669 7479 222c asesensitivity", │ │ │ │ -000376c0: 0a64 6566 6175 6c74 2073 656e 7369 7469 .default sensiti │ │ │ │ -000376d0: 7665 292e 2020 4f6e 205a 4653 2073 7562 ve). On ZFS sub │ │ │ │ -000376e0: 766f 6c75 6d65 7320 6d61 726b 6564 2061 volumes marked a │ │ │ │ -000376f0: 7320 6361 7365 2069 6e73 656e 7369 7469 s case insensiti │ │ │ │ -00037700: 7665 2066 696c 6573 0a63 6f6e 7461 696e ve files.contain │ │ │ │ -00037710: 696e 6720 6c6f 7765 7263 6173 6520 696e ing lowercase in │ │ │ │ -00037720: 7465 726e 6174 696f 6e61 6c20 6368 6172 ternational char │ │ │ │ -00037730: 6163 7465 7273 2061 7265 2069 6e61 6363 acters are inacc │ │ │ │ -00037740: 6573 7369 626c 652e 2020 416c 736f 0a6c essible. Also.l │ │ │ │ -00037750: 696b 6520 616c 6c20 7375 7070 6f72 7465 ike all supporte │ │ │ │ -00037760: 6420 6669 6c65 7379 7374 656d 7320 6578 d filesystems ex │ │ │ │ -00037770: 6365 7074 2048 4653 2b20 616e 6420 5a46 cept HFS+ and ZF │ │ │ │ -00037780: 5320 2863 6f6e 6669 6775 7261 626c 6520 S (configurable │ │ │ │ -00037790: 6f6e 0a70 6572 2d73 7562 766f 6c75 6d65 on.per-subvolume │ │ │ │ -000377a0: 2062 6173 6973 2062 7920 7072 6f70 6572 basis by proper │ │ │ │ -000377b0: 7479 2022 6e6f 726d 616c 697a 6174 696f ty "normalizatio │ │ │ │ -000377c0: 6e22 2c20 6465 6661 756c 7420 6e6f 6e65 n", default none │ │ │ │ -000377d0: 2920 4752 5542 0a6d 616b 6573 206e 6f20 ) GRUB.makes no │ │ │ │ -000377e0: 6174 7465 6d70 7420 6174 2063 6865 636b attempt at check │ │ │ │ -000377f0: 206f 6620 6361 6e6f 6e69 6361 6c20 6571 of canonical eq │ │ │ │ -00037800: 7569 7661 6c65 6e63 6520 736f 2061 2066 uivalence so a f │ │ │ │ -00037810: 696c 6520 6e61 6d65 0a75 2d64 6961 7265 ile name.u-diare │ │ │ │ -00037820: 7369 7320 6973 2074 7265 6174 6564 2061 sis is treated a │ │ │ │ -00037830: 7320 6469 7374 696e 6374 2066 726f 6d20 s distinct from │ │ │ │ -00037840: 752b 636f 6d62 696e 696e 6720 6469 6172 u+combining diar │ │ │ │ -00037850: 6573 6973 2e20 2054 6869 730a 686f 7765 esis. This.howe │ │ │ │ -00037860: 7665 7220 6d65 616e 7320 7468 6174 2069 ver means that i │ │ │ │ -00037870: 6e20 6f72 6465 7220 746f 2061 6363 6573 n order to acces │ │ │ │ -00037880: 7320 6669 6c65 206f 6e20 4846 532b 2069 s file on HFS+ i │ │ │ │ -00037890: 7473 206e 616d 6520 6d75 7374 2062 650a ts name must be. │ │ │ │ -000378a0: 7370 6563 6966 6965 6420 696e 206e 6f72 specified in nor │ │ │ │ -000378b0: 6d61 6c69 7361 7469 6f6e 2066 6f72 6d20 malisation form │ │ │ │ -000378c0: 442e 204f 6e20 6e6f 726d 616c 697a 6564 D. On normalized │ │ │ │ -000378d0: 205a 4653 2073 7562 766f 6c75 6d65 730a ZFS subvolumes. │ │ │ │ -000378e0: 6669 6c65 6e61 6d65 7320 6f75 7420 6f66 filenames out of │ │ │ │ -000378f0: 206e 6f72 6d61 6c69 7361 7469 6f6e 2061 normalisation a │ │ │ │ -00037900: 7265 2069 6e61 6363 6573 7369 626c 652e re inaccessible. │ │ │ │ -00037910: 0a0a 3137 2e33 204f 7574 7075 7420 7465 ..17.3 Output te │ │ │ │ -00037920: 726d 696e 616c 0a3d 3d3d 3d3d 3d3d 3d3d rminal.========= │ │ │ │ -00037930: 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a46 6972 ===========..Fir │ │ │ │ -00037940: 6d77 6172 6520 6f75 7470 7574 2063 6f6e mware output con │ │ │ │ -00037950: 736f 6c65 2022 636f 6e73 6f6c 6522 206f sole "console" o │ │ │ │ -00037960: 6e20 4152 4320 616e 6420 4945 4545 3132 n ARC and IEEE12 │ │ │ │ -00037970: 3735 2061 7265 206c 696d 6974 6564 2074 75 are limited t │ │ │ │ -00037980: 6f0a 4153 4349 492e 0a0a 2020 2042 494f o.ASCII... BIO │ │ │ │ -00037990: 5320 6669 726d 7761 7265 2063 6f6e 736f S firmware conso │ │ │ │ -000379a0: 6c65 2061 6e64 2056 4741 2074 6578 7420 le and VGA text │ │ │ │ -000379b0: 6172 6520 6c69 6d69 7465 6420 746f 2041 are limited to A │ │ │ │ -000379c0: 5343 4949 2061 6e64 2073 6f6d 650a 7073 SCII and some.ps │ │ │ │ -000379d0: 6575 646f 6772 6170 6869 6373 2e0a 0a20 eudographics... │ │ │ │ -000379e0: 2020 4e6f 6e65 206f 6620 6162 6f76 6520 None of above │ │ │ │ -000379f0: 6d65 6e74 696f 6e65 6420 6973 2061 7070 mentioned is app │ │ │ │ -00037a00: 726f 7072 6961 7465 2066 6f72 2064 6973 ropriate for dis │ │ │ │ -00037a10: 706c 6179 696e 6720 696e 7465 726e 6174 playing internat │ │ │ │ -00037a20: 696f 6e61 6c0a 616e 6420 616e 7920 756e ional.and any un │ │ │ │ -00037a30: 7375 7070 6f72 7465 6420 6368 6172 6163 supported charac │ │ │ │ -00037a40: 7465 7220 6973 2072 6570 6c61 6365 6420 ter is replaced │ │ │ │ -00037a50: 7769 7468 2071 7565 7374 696f 6e20 6d61 with question ma │ │ │ │ -00037a60: 726b 2065 7863 6570 740a 7073 6575 646f rk except.pseudo │ │ │ │ -00037a70: 6772 6170 6869 6373 2077 6869 6368 2077 graphics which w │ │ │ │ -00037a80: 6520 6174 7465 6d70 7420 746f 2061 7070 e attempt to app │ │ │ │ -00037a90: 726f 7869 6d61 7465 2077 6974 6820 4153 roximate with AS │ │ │ │ -00037aa0: 4349 492e 0a0a 2020 2045 4649 2063 6f6e CII... EFI con │ │ │ │ -00037ab0: 736f 6c65 206f 6e20 7468 6520 6f74 6865 sole on the othe │ │ │ │ -00037ac0: 7220 6861 6e64 206e 6f6d 696e 616c 6c79 r hand nominally │ │ │ │ -00037ad0: 2073 7570 706f 7274 7320 5554 462d 3136 supports UTF-16 │ │ │ │ -00037ae0: 2062 7574 2061 6374 7561 6c0a 6c61 6e67 but actual.lang │ │ │ │ -00037af0: 7561 6765 2063 6f76 6572 6167 6520 6465 uage coverage de │ │ │ │ -00037b00: 7065 6e64 7320 6f6e 2066 6972 6d77 6172 pends on firmwar │ │ │ │ -00037b10: 6520 616e 6420 6d61 7920 6265 2076 6572 e and may be ver │ │ │ │ -00037b20: 7920 6c69 6d69 7465 642e 0a0a 2020 2054 y limited... T │ │ │ │ -00037b30: 6865 2065 6e63 6f64 696e 6720 7573 6564 he encoding used │ │ │ │ -00037b40: 206f 6e20 7365 7269 616c 2063 616e 2062 on serial can b │ │ │ │ -00037b50: 6520 6368 6f73 656e 2077 6974 6820 2774 e chosen with 't │ │ │ │ -00037b60: 6572 6d69 6e66 6f27 2061 7320 6569 7468 erminfo' as eith │ │ │ │ -00037b70: 6572 0a41 5343 4949 2c20 5554 462d 3820 er.ASCII, UTF-8 │ │ │ │ -00037b80: 6f72 2022 7669 7375 616c 2055 5446 2d38 or "visual UTF-8 │ │ │ │ -00037b90: 222e 2020 4c61 7374 206f 6e65 2069 7320 ". Last one is │ │ │ │ -00037ba0: 6167 6169 6e73 7420 7468 6520 7370 6563 against the spec │ │ │ │ -00037bb0: 6966 6963 6174 696f 6e0a 6275 7420 7265 ification.but re │ │ │ │ -00037bc0: 7375 6c74 7320 696e 2063 6f72 7265 6374 sults in correct │ │ │ │ -00037bd0: 2072 656e 6465 7269 6e67 206f 6620 7269 rendering of ri │ │ │ │ -00037be0: 6768 742d 746f 2d6c 6566 7420 6f6e 2073 ght-to-left on s │ │ │ │ -00037bf0: 6f6d 6520 7265 6164 6572 7320 7768 6963 ome readers whic │ │ │ │ -00037c00: 680a 646f 6e27 7420 6861 7665 206f 776e h.don't have own │ │ │ │ -00037c10: 2062 6964 6920 696d 706c 656d 656e 7461 bidi implementa │ │ │ │ -00037c20: 7469 6f6e 2e0a 0a20 2020 4f6e 2065 6d75 tion... On emu │ │ │ │ -00037c30: 2047 5255 4220 6368 6563 6b73 2069 6620 GRUB checks if │ │ │ │ -00037c40: 6368 6172 7365 7420 6973 2055 5446 2d38 charset is UTF-8 │ │ │ │ -00037c50: 2061 6e64 2075 7365 7320 6974 2069 6620 and uses it if │ │ │ │ -00037c60: 736f 2061 6e64 2075 7365 730a 4153 4349 so and uses.ASCI │ │ │ │ -00037c70: 4920 6f74 6865 7277 6973 652e 0a0a 2020 I otherwise... │ │ │ │ -00037c80: 2057 6865 6e20 7573 696e 6720 6766 7874 When using gfxt │ │ │ │ -00037c90: 6572 6d20 6f72 2067 6678 6d65 6e75 2047 erm or gfxmenu G │ │ │ │ -00037ca0: 5255 4220 6974 7365 6c66 2069 7320 7265 RUB itself is re │ │ │ │ -00037cb0: 7370 6f6e 7369 626c 6520 666f 720a 7265 sponsible for.re │ │ │ │ -00037cc0: 6e64 6572 696e 6720 7468 6520 7465 7874 ndering the text │ │ │ │ -00037cd0: 2e20 2049 6e20 7468 6973 2063 6173 6520 . In this case │ │ │ │ -00037ce0: 4752 5542 2069 7320 6c69 6d69 7465 6420 GRUB is limited │ │ │ │ -00037cf0: 6279 206c 6f61 6465 6420 666f 6e74 732e by loaded fonts. │ │ │ │ -00037d00: 2020 4966 0a66 6f6e 7473 2063 6f6e 7461 If.fonts conta │ │ │ │ -00037d10: 696e 2061 6c6c 2072 6571 7569 7265 6420 in all required │ │ │ │ -00037d20: 6368 6172 6163 7465 7273 2074 6865 6e20 characters then │ │ │ │ -00037d30: 6269 6469 7265 6374 696f 6e61 6c20 7465 bidirectional te │ │ │ │ -00037d40: 7874 2c20 6375 7273 6976 650a 7661 7269 xt, cursive.vari │ │ │ │ -00037d50: 616e 7473 2061 6e64 2063 6f6d 6269 6e69 ants and combini │ │ │ │ -00037d60: 6e67 206d 6172 6b73 206f 7468 6572 2074 ng marks other t │ │ │ │ -00037d70: 6861 6e20 656e 636c 6f73 696e 672c 2068 han enclosing, h │ │ │ │ -00037d80: 616c 6620 2865 2e67 2e20 206c 6566 7420 alf (e.g. left │ │ │ │ -00037d90: 6861 6c66 0a74 696c 6465 206f 7220 636f half.tilde or co │ │ │ │ -00037da0: 6d62 696e 696e 6720 6f76 6572 6c69 6e65 mbining overline │ │ │ │ -00037db0: 2920 616e 6420 646f 7562 6c65 206f 6e65 ) and double one │ │ │ │ -00037dc0: 732e 2020 4c69 6761 7475 7265 7320 6172 s. Ligatures ar │ │ │ │ -00037dd0: 656e 2774 0a73 7570 706f 7274 6564 2074 en't.supported t │ │ │ │ -00037de0: 686f 7567 682e 2020 5468 6973 2073 686f hough. This sho │ │ │ │ -00037df0: 756c 6420 636f 7665 7220 4575 726f 7065 uld cover Europe │ │ │ │ -00037e00: 616e 2c20 4d69 6464 6c65 2045 6173 7465 an, Middle Easte │ │ │ │ -00037e10: 726e 2028 6966 2079 6f75 0a64 6f6e 2774 rn (if you.don't │ │ │ │ -00037e20: 206d 696e 6420 6c61 636b 206f 6620 6c61 mind lack of la │ │ │ │ -00037e30: 6d2d 616c 6966 206c 6967 6174 7572 6520 m-alif ligature │ │ │ │ -00037e40: 696e 2041 7261 6269 6329 2061 6e64 2045 in Arabic) and E │ │ │ │ -00037e50: 6173 7420 4173 6961 6e20 7363 7269 7074 ast Asian script │ │ │ │ -00037e60: 732e 0a4e 6f74 6162 6c65 2075 6e73 7570 s..Notable unsup │ │ │ │ -00037e70: 706f 7274 6564 2073 6372 6970 7473 2061 ported scripts a │ │ │ │ -00037e80: 7265 2042 7261 686d 6963 2066 616d 696c re Brahmic famil │ │ │ │ -00037e90: 7920 616e 6420 6465 7269 7665 6420 6173 y and derived as │ │ │ │ -00037ea0: 2077 656c 6c20 6173 0a4d 6f6e 676f 6c69 well as.Mongoli │ │ │ │ -00037eb0: 616e 2c20 5469 6669 6e61 6768 2c20 4b6f an, Tifinagh, Ko │ │ │ │ -00037ec0: 7265 616e 204a 616d 6f20 2870 7265 636f rean Jamo (preco │ │ │ │ -00037ed0: 6d70 6f73 6564 2063 6861 7261 6374 6572 mposed character │ │ │ │ -00037ee0: 7320 6861 7665 206e 6f0a 7072 6f62 6c65 s have no.proble │ │ │ │ -00037ef0: 6d29 2061 6e64 2074 6f6e 616c 2077 7269 m) and tonal wri │ │ │ │ -00037f00: 7469 6e67 2028 3265 352d 3265 3929 2e20 ting (2e5-2e9). │ │ │ │ -00037f10: 2047 5255 4220 616c 736f 2069 676e 6f72 GRUB also ignor │ │ │ │ -00037f20: 6573 2064 6570 7265 6361 7465 6420 2861 es deprecated (a │ │ │ │ -00037f30: 730a 7370 6563 6966 6965 6420 696e 2055 s.specified in U │ │ │ │ -00037f40: 6e69 636f 6465 2920 6368 6172 6163 7465 nicode) characte │ │ │ │ -00037f50: 7273 2028 652e 672e 2020 7461 6773 292e rs (e.g. tags). │ │ │ │ -00037f60: 2020 4752 5542 2061 6c73 6f20 646f 6573 GRUB also does │ │ │ │ -00037f70: 6e27 7420 6861 6e64 6c65 0a73 6f20 6361 n't handle.so ca │ │ │ │ -00037f80: 6c6c 6564 2022 616e 6e6f 7461 7469 6f6e lled "annotation │ │ │ │ -00037f90: 2063 6861 7261 6374 6572 7322 2049 6620 characters" If │ │ │ │ -00037fa0: 796f 7520 6361 6e20 636f 6d70 6c65 7465 you can complete │ │ │ │ -00037fb0: 2065 6974 6865 7220 6f66 2074 776f 0a6c either of two.l │ │ │ │ -00037fc0: 6973 7473 206f 722c 2062 6574 7465 722c ists or, better, │ │ │ │ -00037fd0: 2070 726f 706f 7365 2061 2070 6174 6368 propose a patch │ │ │ │ -00037fe0: 2074 6f20 696d 7072 6f76 6520 7265 6e64 to improve rend │ │ │ │ -00037ff0: 6572 696e 672c 2070 6c65 6173 6520 636f ering, please co │ │ │ │ -00038000: 6e74 6163 740a 6465 7665 6c6f 7065 7220 ntact.developer │ │ │ │ -00038010: 7465 616d 2e0a 0a31 372e 3420 496e 7075 team...17.4 Inpu │ │ │ │ -00038020: 7420 7465 726d 696e 616c 0a3d 3d3d 3d3d t terminal.===== │ │ │ │ -00038030: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a ==============.. │ │ │ │ -00038040: 4669 726d 7761 7265 2063 6f6e 736f 6c65 Firmware console │ │ │ │ -00038050: 206f 6e20 4249 4f53 2c20 4945 4545 3132 on BIOS, IEEE12 │ │ │ │ -00038060: 3735 2061 6e64 2041 5243 2064 6f65 736e 75 and ARC doesn │ │ │ │ -00038070: 2774 2061 6c6c 6f77 2079 6f75 2074 6f20 't allow you to │ │ │ │ -00038080: 656e 7465 720a 6e6f 6e2d 4153 4349 4920 enter.non-ASCII │ │ │ │ -00038090: 6368 6172 6163 7465 7273 2e20 2045 4649 characters. EFI │ │ │ │ -000380a0: 2073 7065 6369 6669 6361 7469 6f6e 2061 specification a │ │ │ │ -000380b0: 6c6c 6f77 7320 666f 7220 7375 6368 2062 llows for such b │ │ │ │ -000380c0: 7574 2061 7574 686f 7220 6973 0a75 6e61 ut author is.una │ │ │ │ -000380d0: 7761 7265 206f 6620 616e 7920 6163 7475 ware of any actu │ │ │ │ -000380e0: 616c 2069 6d70 6c65 6d65 6e74 6174 696f al implementatio │ │ │ │ -000380f0: 6e73 2e20 2053 6572 6961 6c20 696e 7075 ns. Serial inpu │ │ │ │ -00038100: 7420 6973 2063 7572 7265 6e74 6c79 0a6c t is currently.l │ │ │ │ -00038110: 696d 6974 6564 2066 6f72 206c 6174 696e imited for latin │ │ │ │ -00038120: 3120 2875 6e6c 696b 656c 7920 746f 2063 1 (unlikely to c │ │ │ │ -00038130: 6861 6e67 6529 2e20 204f 776e 206b 6579 hange). Own key │ │ │ │ -00038140: 626f 6172 6420 696d 706c 656d 656e 7461 board implementa │ │ │ │ -00038150: 7469 6f6e 730a 2861 745f 6b65 7962 6f61 tions.(at_keyboa │ │ │ │ -00038160: 7264 2061 6e64 2075 7362 5f6b 6579 626f rd and usb_keybo │ │ │ │ -00038170: 6172 6429 2073 7570 706f 7274 7320 616e ard) supports an │ │ │ │ -00038180: 7920 6b65 7920 6275 7420 776f 726b 206f y key but work o │ │ │ │ -00038190: 6e0a 6f6e 652d 6368 6172 2d70 6572 2d6b n.one-char-per-k │ │ │ │ -000381a0: 6579 7374 726f 6b65 2e20 2053 6f20 6e6f eystroke. So no │ │ │ │ -000381b0: 2064 6561 6420 6b65 7973 206f 7220 6164 dead keys or ad │ │ │ │ -000381c0: 7661 6e63 6564 2069 6e70 7574 206d 6574 vanced input met │ │ │ │ -000381d0: 686f 642e 2020 416c 736f 0a74 6865 7265 hod. Also.there │ │ │ │ -000381e0: 2069 7320 6e6f 206b 6579 6d61 7020 6368 is no keymap ch │ │ │ │ -000381f0: 616e 6765 2068 6f74 6b65 792e 2020 496e ange hotkey. In │ │ │ │ -00038200: 2070 7261 6374 6963 6520 6974 206d 616b practice it mak │ │ │ │ -00038210: 6573 2064 6966 6669 6375 6c74 2074 6f0a es difficult to. │ │ │ │ -00038220: 656e 7465 7220 616e 7920 7465 7874 2075 enter any text u │ │ │ │ -00038230: 7369 6e67 206e 6f6e 2d4c 6174 696e 2061 sing non-Latin a │ │ │ │ -00038240: 6c70 6861 6265 742e 2020 4d6f 7265 6f76 lphabet. Moreov │ │ │ │ -00038250: 6572 2061 6c6c 2063 7572 7265 6e74 2069 er all current i │ │ │ │ -00038260: 6e70 7574 0a63 6f6e 7375 6d65 7273 2061 nput.consumers a │ │ │ │ -00038270: 7265 206c 696d 6974 6564 2074 6f20 4153 re limited to AS │ │ │ │ -00038280: 4349 492e 0a0a 3137 2e35 2047 6574 7465 CII...17.5 Gette │ │ │ │ -00038290: 7874 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a xt.============. │ │ │ │ -000382a0: 0a47 5255 4220 7375 7070 6f72 7473 2062 .GRUB supports b │ │ │ │ -000382b0: 6569 6e67 2074 7261 6e73 6c61 7465 642e eing translated. │ │ │ │ -000382c0: 2020 466f 7220 7468 6973 2079 6f75 206e For this you n │ │ │ │ -000382d0: 6565 6420 746f 2068 6176 6520 6c61 6e67 eed to have lang │ │ │ │ -000382e0: 7561 6765 202a 2e6d 6f0a 6669 6c65 7320 uage *.mo.files │ │ │ │ -000382f0: 696e 2024 7072 6566 6978 2f6c 6f63 616c in $prefix/local │ │ │ │ -00038300: 652c 206c 6f61 6420 6765 7474 6578 7420 e, load gettext │ │ │ │ -00038310: 6d6f 6475 6c65 2061 6e64 2073 6574 2022 module and set " │ │ │ │ -00038320: 6c61 6e67 2220 7661 7269 6162 6c65 2e0a lang" variable.. │ │ │ │ -00038330: 0a31 372e 3620 5265 6765 7870 0a3d 3d3d .17.6 Regexp.=== │ │ │ │ -00038340: 3d3d 3d3d 3d3d 3d3d 0a0a 5265 6765 7870 ========..Regexp │ │ │ │ -00038350: 7320 776f 726b 206f 6e20 756e 6963 6f64 s work on unicod │ │ │ │ -00038360: 6520 6368 6172 6163 7465 7273 2c20 686f e characters, ho │ │ │ │ -00038370: 7765 7665 7220 6e6f 2061 7474 656d 7074 wever no attempt │ │ │ │ -00038380: 2061 7420 6368 6563 6b69 6e67 0a63 616e at checking.can │ │ │ │ -00038390: 6e6f 6e69 6361 6c20 6571 7569 7661 6c65 nonical equivale │ │ │ │ -000383a0: 6e63 6520 6861 7320 6265 656e 206d 6164 nce has been mad │ │ │ │ -000383b0: 652e 2020 4d6f 7265 6f76 6572 2074 6865 e. Moreover the │ │ │ │ -000383c0: 2063 6c61 7373 6573 206c 696b 650a 5b3a classes like.[: │ │ │ │ -000383d0: 616c 7068 613a 5d20 6d61 7463 6820 6f6e alpha:] match on │ │ │ │ -000383e0: 6c79 2041 5343 4949 2073 7562 7365 742e ly ASCII subset. │ │ │ │ -000383f0: 0a0a 3137 2e37 204f 7468 6572 0a3d 3d3d ..17.7 Other.=== │ │ │ │ -00038400: 3d3d 3d3d 3d3d 3d0a 0a43 7572 7265 6e74 =======..Current │ │ │ │ -00038410: 6c79 2047 5255 4220 616c 7761 7973 2075 ly GRUB always u │ │ │ │ -00038420: 7365 7320 5945 4152 2d4d 4f4e 5448 2d44 ses YEAR-MONTH-D │ │ │ │ -00038430: 4159 2048 4f55 523a 4d49 4e55 5445 3a53 AY HOUR:MINUTE:S │ │ │ │ -00038440: 4543 4f4e 4420 5b57 4545 4b44 4159 5d0a ECOND [WEEKDAY]. │ │ │ │ -00038450: 3234 2d68 6f75 7220 6461 7465 7469 6d65 24-hour datetime │ │ │ │ -00038460: 2066 6f72 6d61 7420 6275 7420 7765 656b format but week │ │ │ │ -00038470: 6461 7973 2061 7265 2074 7261 6e73 6c61 days are transla │ │ │ │ -00038480: 7465 642e 2020 4752 5542 2061 6c77 6179 ted. GRUB alway │ │ │ │ -00038490: 7320 7573 6573 0a74 6865 2064 6563 696d s uses.the decim │ │ │ │ -000384a0: 616c 206e 756d 6265 7220 666f 726d 6174 al number format │ │ │ │ -000384b0: 2077 6974 6820 5b30 2d39 5d20 6173 2064 with [0-9] as d │ │ │ │ -000384c0: 6967 6974 7320 616e 6420 2e20 2061 7320 igits and . as │ │ │ │ -000384d0: 6465 7363 696d 616c 0a73 6570 6172 6174 descimal.separat │ │ │ │ -000384e0: 6f72 2061 6e64 206e 6f20 6772 6f75 7020 or and no group │ │ │ │ -000384f0: 7365 7061 7261 746f 722e 2020 4945 4545 separator. IEEE │ │ │ │ -00038500: 3132 3735 2061 6c69 6173 6573 2061 7265 1275 aliases are │ │ │ │ -00038510: 206d 6174 6368 6564 0a63 6173 652d 696e matched.case-in │ │ │ │ -00038520: 7365 6e73 6974 6976 656c 7920 6578 6365 sensitively exce │ │ │ │ -00038530: 7074 206e 6f6e 2d41 5343 4949 2077 6869 pt non-ASCII whi │ │ │ │ -00038540: 6368 2069 7320 6d61 7463 6865 6420 6173 ch is matched as │ │ │ │ -00038550: 2062 696e 6172 792e 2020 5369 6d69 6c61 binary. Simila │ │ │ │ -00038560: 720a 6265 6861 7669 6f75 7220 6973 2066 r.behaviour is f │ │ │ │ -00038570: 6f72 206d 6174 6368 696e 6720 4f53 4275 or matching OSBu │ │ │ │ -00038580: 6e64 6c65 5265 7175 6972 6564 2e20 2053 ndleRequired. S │ │ │ │ -00038590: 696e 6365 2049 4545 4531 3237 3520 616c ince IEEE1275 al │ │ │ │ -000385a0: 6961 7365 7320 616e 640a 4f53 4275 6e64 iases and.OSBund │ │ │ │ -000385b0: 6c65 5265 7175 6972 6564 2064 6f6e 2774 leRequired don't │ │ │ │ -000385c0: 2063 6f6e 7461 696e 2061 6e79 206e 6f6e contain any non │ │ │ │ -000385d0: 2d41 5343 4949 2069 7420 7368 6f75 6c64 -ASCII it should │ │ │ │ -000385e0: 206e 6576 6572 2062 6520 610a 7072 6f62 never be a.prob │ │ │ │ -000385f0: 6c65 6d20 696e 2070 7261 6374 6963 652e lem in practice. │ │ │ │ -00038600: 2020 4361 7365 2d73 656e 7369 7469 7665 Case-sensitive │ │ │ │ -00038610: 2069 6465 6e74 6966 6965 7273 2061 7265 identifiers are │ │ │ │ -00038620: 206d 6174 6368 6564 2061 7320 7261 770a matched as raw. │ │ │ │ -00038630: 7374 7269 6e67 732c 206e 6f20 6361 6e6f strings, no cano │ │ │ │ -00038640: 6e69 6361 6c20 6571 7569 7661 6c65 6e63 nical equivalenc │ │ │ │ -00038650: 6520 6368 6563 6b20 6973 2070 6572 666f e check is perfo │ │ │ │ -00038660: 726d 6564 2e20 2043 6173 652d 696e 7365 rmed. Case-inse │ │ │ │ -00038670: 6e73 7469 7665 0a69 6465 6e74 6966 6965 nstive.identifie │ │ │ │ -00038680: 7273 2061 7265 206d 6174 6368 6564 2061 rs are matched a │ │ │ │ -00038690: 7320 5241 5720 6275 7420 6164 6469 7469 s RAW but additi │ │ │ │ -000386a0: 6f6e 616c 6c79 205b 612d 7a5d 2069 7320 onally [a-z] is │ │ │ │ -000386b0: 6571 7569 7661 6c65 6e74 2074 6f0a 5b41 equivalent to.[A │ │ │ │ -000386c0: 2d5a 5d2e 2047 5255 422d 6465 6669 6e65 -Z]. GRUB-define │ │ │ │ -000386d0: 6420 6964 656e 7469 6669 6572 7320 7573 d identifiers us │ │ │ │ -000386e0: 6520 6f6e 6c79 2041 5343 4949 2061 6e64 e only ASCII and │ │ │ │ -000386f0: 2073 6f20 7368 6f75 6c64 0a75 7365 722d so should.user- │ │ │ │ -00038700: 6465 6669 6e65 6420 6f6e 6573 2e20 2049 defined ones. I │ │ │ │ -00038710: 6465 6e74 6966 6965 7273 2063 6f6e 7461 dentifiers conta │ │ │ │ -00038720: 696e 696e 6720 6e6f 6e2d 4153 4349 4920 ining non-ASCII │ │ │ │ -00038730: 6d61 7920 776f 726b 2062 7574 2061 7265 may work but are │ │ │ │ -00038740: 6e27 740a 7375 7070 6f72 7465 642e 2020 n't.supported. │ │ │ │ -00038750: 4f6e 6c79 2074 6865 2041 5343 4949 2073 Only the ASCII s │ │ │ │ -00038760: 7061 6365 2063 6861 7261 6374 6572 7320 pace characters │ │ │ │ -00038770: 2873 7061 6365 2055 2b30 3032 302c 2074 (space U+0020, t │ │ │ │ -00038780: 6162 2055 2b30 3030 622c 0a43 5220 552b ab U+000b,.CR U+ │ │ │ │ -00038790: 3030 3064 2061 6e64 204c 4620 552b 3030 000d and LF U+00 │ │ │ │ -000387a0: 3061 2920 6172 6520 7265 636f 676e 6973 0a) are recognis │ │ │ │ -000387b0: 6564 2e20 204f 7468 6572 2075 6e69 636f ed. Other unico │ │ │ │ -000387c0: 6465 2073 7061 6365 2063 6861 7261 6374 de space charact │ │ │ │ -000387d0: 6572 730a 6172 656e 2774 2061 2076 616c ers.aren't a val │ │ │ │ -000387e0: 6964 2066 6965 6c64 2073 6570 6172 6174 id field separat │ │ │ │ -000387f0: 6f72 2e20 2027 7465 7374 2720 282a 6e6f or. 'test' (*no │ │ │ │ -00038800: 7465 2074 6573 743a 3a29 2074 6573 7473 te test::) tests │ │ │ │ -00038810: 203c 2c20 3e2c 203c 3d2c 0a3e 3d2c 202d <, >, <=,.>=, - │ │ │ │ -00038820: 7067 7420 616e 6420 2d70 6c74 2063 6f6d pgt and -plt com │ │ │ │ -00038830: 7061 7265 2074 6865 2073 7472 696e 6773 pare the strings │ │ │ │ -00038840: 2069 6e20 7468 6520 6c65 7869 636f 6772 in the lexicogr │ │ │ │ -00038850: 6170 6869 6361 6c20 6f72 6465 7220 6f66 aphical order of │ │ │ │ -00038860: 0a75 6e69 636f 6465 2063 6f64 6570 6f69 .unicode codepoi │ │ │ │ -00038870: 6e74 732c 2072 6570 6c69 6361 7469 6e67 nts, replicating │ │ │ │ -00038880: 2074 6865 2062 6568 6176 696f 7572 206f the behaviour o │ │ │ │ -00038890: 6620 7465 7374 2066 726f 6d20 636f 7265 f test from core │ │ │ │ -000388a0: 7574 696c 732e 0a65 6e76 6972 6f6e 6d65 utils..environme │ │ │ │ -000388b0: 6e74 2076 6172 6961 626c 6573 2061 6e64 nt variables and │ │ │ │ -000388c0: 2063 6f6d 6d61 6e64 7320 6172 6520 6c69 commands are li │ │ │ │ -000388d0: 7374 6564 2069 6e20 7468 6520 7361 6d65 sted in the same │ │ │ │ -000388e0: 206f 7264 6572 2e0a 0a1f 0a46 696c 653a order.....File: │ │ │ │ -000388f0: 2067 7275 622e 696e 666f 2c20 204e 6f64 grub.info, Nod │ │ │ │ -00038900: 653a 2053 6563 7572 6974 792c 2020 4e65 e: Security, Ne │ │ │ │ -00038910: 7874 3a20 506c 6174 666f 726d 206c 696d xt: Platform lim │ │ │ │ -00038920: 6974 6174 696f 6e73 2c20 2050 7265 763a itations, Prev: │ │ │ │ -00038930: 2049 6e74 6572 6e61 7469 6f6e 616c 6973 Internationalis │ │ │ │ -00038940: 6174 696f 6e2c 2020 5570 3a20 546f 700a ation, Up: Top. │ │ │ │ -00038950: 0a31 3820 5365 6375 7269 7479 0a2a 2a2a .18 Security.*** │ │ │ │ -00038960: 2a2a 2a2a 2a2a 2a2a 0a0a 2a20 4d65 6e75 ********..* Menu │ │ │ │ -00038970: 3a0a 0a2a 2041 7574 6865 6e74 6963 6174 :..* Authenticat │ │ │ │ -00038980: 696f 6e20 616e 6420 6175 7468 6f72 6973 ion and authoris │ │ │ │ -00038990: 6174 696f 6e3a 3a20 5573 6572 7320 616e ation:: Users an │ │ │ │ -000389a0: 6420 6163 6365 7373 2063 6f6e 7472 6f6c d access control │ │ │ │ -000389b0: 0a2a 2055 7369 6e67 2064 6967 6974 616c .* Using digital │ │ │ │ -000389c0: 2073 6967 6e61 7475 7265 733a 3a20 2020 signatures:: │ │ │ │ -000389d0: 2020 2020 2020 426f 6f74 696e 6720 6469 Booting di │ │ │ │ -000389e0: 6769 7461 6c6c 7920 7369 676e 6564 2063 gitally signed c │ │ │ │ -000389f0: 6f64 650a 2a20 5545 4649 2073 6563 7572 ode.* UEFI secur │ │ │ │ -00038a00: 6520 626f 6f74 2061 6e64 2073 6869 6d3a e boot and shim: │ │ │ │ -00038a10: 3a20 2020 2020 2020 2042 6f6f 7469 6e67 : Booting │ │ │ │ -00038a20: 2064 6967 6974 616c 6c79 2073 6967 6e65 digitally signe │ │ │ │ -00038a30: 6420 5045 2066 696c 6573 0a2a 2053 6563 d PE files.* Sec │ │ │ │ -00038a40: 7572 6520 426f 6f74 2041 6476 616e 6365 ure Boot Advance │ │ │ │ -00038a50: 6420 5461 7267 6574 696e 673a 3a20 2020 d Targeting:: │ │ │ │ -00038a60: 456d 6265 6464 6564 2069 6e66 6f72 6d61 Embedded informa │ │ │ │ -00038a70: 7469 6f6e 2066 6f72 2067 656e 6572 6174 tion for generat │ │ │ │ -00038a80: 696f 6e20 6e75 6d62 6572 2062 6173 6564 ion number based │ │ │ │ -00038a90: 2072 6576 6f63 6174 696f 6e0a 2a20 4d65 revocation.* Me │ │ │ │ -00038aa0: 6173 7572 6564 2042 6f6f 743a 3a20 2020 asured Boot:: │ │ │ │ -00038ab0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00038ac0: 204d 6561 7375 7269 6e67 2062 6f6f 7420 Measuring boot │ │ │ │ -00038ad0: 636f 6d70 6f6e 656e 7473 0a2a 204c 6f63 components.* Loc │ │ │ │ -00038ae0: 6b64 6f77 6e3a 3a20 2020 2020 2020 2020 kdown:: │ │ │ │ +000354b0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a2a 204d ===========..* M │ │ │ │ +000354c0: 656e 753a 0a0a 2a20 6e65 745f 6164 645f enu:..* net_add_ │ │ │ │ +000354d0: 6164 6472 3a3a 2020 2020 2020 2020 2020 addr:: │ │ │ │ +000354e0: 2020 2020 2020 4164 6420 6120 6e65 7477 Add a netw │ │ │ │ +000354f0: 6f72 6b20 6164 6472 6573 730a 2a20 6e65 ork address.* ne │ │ │ │ +00035500: 745f 6164 645f 646e 733a 3a20 2020 2020 t_add_dns:: │ │ │ │ +00035510: 2020 2020 2020 2020 2020 2020 4164 6420 Add │ │ │ │ +00035520: 6120 444e 5320 7365 7276 6572 0a2a 206e a DNS server.* n │ │ │ │ +00035530: 6574 5f61 6464 5f72 6f75 7465 3a3a 2020 et_add_route:: │ │ │ │ +00035540: 2020 2020 2020 2020 2020 2020 2041 6464 Add │ │ │ │ +00035550: 2072 6f75 7469 6e67 2065 6e74 7279 0a2a routing entry.* │ │ │ │ +00035560: 206e 6574 5f62 6f6f 7470 3a3a 2020 2020 net_bootp:: │ │ │ │ +00035570: 2020 2020 2020 2020 2020 2020 2020 2050 P │ │ │ │ +00035580: 6572 666f 726d 2061 2062 6f6f 7470 2061 erform a bootp a │ │ │ │ +00035590: 7574 6f63 6f6e 6669 6775 7261 7469 6f6e utoconfiguration │ │ │ │ +000355a0: 0a2a 206e 6574 5f64 656c 5f61 6464 723a .* net_del_addr: │ │ │ │ +000355b0: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ +000355c0: 2052 656d 6f76 6520 4950 2061 6464 7265 Remove IP addre │ │ │ │ +000355d0: 7373 2066 726f 6d20 696e 7465 7266 6163 ss from interfac │ │ │ │ +000355e0: 650a 2a20 6e65 745f 6465 6c5f 646e 733a e.* net_del_dns: │ │ │ │ +000355f0: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ +00035600: 2020 5265 6d6f 7665 2061 2044 4e53 2073 Remove a DNS s │ │ │ │ +00035610: 6572 7665 720a 2a20 6e65 745f 6465 6c5f erver.* net_del_ │ │ │ │ +00035620: 726f 7574 653a 3a20 2020 2020 2020 2020 route:: │ │ │ │ +00035630: 2020 2020 2020 5265 6d6f 7665 2061 2072 Remove a r │ │ │ │ +00035640: 6f75 7465 2065 6e74 7279 0a2a 206e 6574 oute entry.* net │ │ │ │ +00035650: 5f67 6574 5f64 6863 705f 6f70 7469 6f6e _get_dhcp_option │ │ │ │ +00035660: 3a3a 2020 2020 2020 2020 2052 6574 7269 :: Retri │ │ │ │ +00035670: 6576 6520 4448 4350 206f 7074 696f 6e73 eve DHCP options │ │ │ │ +00035680: 0a2a 206e 6574 5f69 7076 365f 6175 746f .* net_ipv6_auto │ │ │ │ +00035690: 636f 6e66 3a3a 2020 2020 2020 2020 2020 conf:: │ │ │ │ +000356a0: 2050 6572 666f 726d 2049 5076 3620 6175 Perform IPv6 au │ │ │ │ +000356b0: 746f 636f 6e66 6967 7572 6174 696f 6e0a toconfiguration. │ │ │ │ +000356c0: 2a20 6e65 745f 6c73 5f61 6464 723a 3a20 * net_ls_addr:: │ │ │ │ +000356d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +000356e0: 4c69 7374 2069 6e74 6572 6661 6365 730a List interfaces. │ │ │ │ +000356f0: 2a20 6e65 745f 6c73 5f63 6172 6473 3a3a * net_ls_cards:: │ │ │ │ +00035700: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00035710: 4c69 7374 206e 6574 776f 726b 2063 6172 List network car │ │ │ │ +00035720: 6473 0a2a 206e 6574 5f6c 735f 646e 733a ds.* net_ls_dns: │ │ │ │ +00035730: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ +00035740: 2020 204c 6973 7420 444e 5320 7365 7276 List DNS serv │ │ │ │ +00035750: 6572 730a 2a20 6e65 745f 6c73 5f72 6f75 ers.* net_ls_rou │ │ │ │ +00035760: 7465 733a 3a20 2020 2020 2020 2020 2020 tes:: │ │ │ │ +00035770: 2020 2020 4c69 7374 2072 6f75 7469 6e67 List routing │ │ │ │ +00035780: 2065 6e74 7269 6573 0a2a 206e 6574 5f6e entries.* net_n │ │ │ │ +00035790: 736c 6f6f 6b75 703a 3a20 2020 2020 2020 slookup:: │ │ │ │ +000357a0: 2020 2020 2020 2020 2050 6572 666f 726d Perform │ │ │ │ +000357b0: 2061 2044 4e53 206c 6f6f 6b75 700a 0a1f a DNS lookup... │ │ │ │ +000357c0: 0a46 696c 653a 2067 7275 622e 696e 666f .File: grub.info │ │ │ │ +000357d0: 2c20 204e 6f64 653a 206e 6574 5f61 6464 , Node: net_add │ │ │ │ +000357e0: 5f61 6464 722c 2020 4e65 7874 3a20 6e65 _addr, Next: ne │ │ │ │ +000357f0: 745f 6164 645f 646e 732c 2020 5570 3a20 t_add_dns, Up: │ │ │ │ +00035800: 4e65 7477 6f72 6b69 6e67 2063 6f6d 6d61 Networking comma │ │ │ │ +00035810: 6e64 730a 0a31 362e 342e 3120 6e65 745f nds..16.4.1 net_ │ │ │ │ +00035820: 6164 645f 6164 6472 0a2d 2d2d 2d2d 2d2d add_addr.------- │ │ │ │ +00035830: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d ------------.. - │ │ │ │ +00035840: 2d20 436f 6d6d 616e 643a 206e 6574 5f61 - Command: net_a │ │ │ │ +00035850: 6464 5f61 6464 7220 494e 5445 5246 4143 dd_addr INTERFAC │ │ │ │ +00035860: 4520 4341 5244 2041 4444 5245 5353 0a20 E CARD ADDRESS. │ │ │ │ +00035870: 2020 2020 436f 6e66 6967 7572 6520 6164 Configure ad │ │ │ │ +00035880: 6469 7469 6f6e 616c 206e 6574 776f 726b ditional network │ │ │ │ +00035890: 2049 4e54 4552 4641 4345 2077 6974 6820 INTERFACE with │ │ │ │ +000358a0: 4144 4452 4553 5320 6f6e 2061 206e 6574 ADDRESS on a net │ │ │ │ +000358b0: 776f 726b 0a20 2020 2020 4341 5244 2e20 work. CARD. │ │ │ │ +000358c0: 2041 4444 5245 5353 2063 616e 2062 6520 ADDRESS can be │ │ │ │ +000358d0: 6569 7468 6572 2049 5020 696e 2064 6f74 either IP in dot │ │ │ │ +000358e0: 7465 6420 6465 6369 6d61 6c20 6e6f 7461 ted decimal nota │ │ │ │ +000358f0: 7469 6f6e 2c20 6f72 0a20 2020 2020 7379 tion, or. sy │ │ │ │ +00035900: 6d62 6f6c 6963 206e 616d 6520 7768 6963 mbolic name whic │ │ │ │ +00035910: 6820 6973 2072 6573 6f6c 7665 6420 7573 h is resolved us │ │ │ │ +00035920: 696e 6720 444e 5320 6c6f 6f6b 7570 2e20 ing DNS lookup. │ │ │ │ +00035930: 2049 6620 7375 6363 6573 7366 756c 2c0a If successful,. │ │ │ │ +00035940: 2020 2020 2074 6869 7320 636f 6d6d 616e this comman │ │ │ │ +00035950: 6420 616c 736f 2061 6464 7320 6c6f 6361 d also adds loca │ │ │ │ +00035960: 6c20 6c69 6e6b 2072 6f75 7469 6e67 2065 l link routing e │ │ │ │ +00035970: 6e74 7279 2074 6f20 7468 6520 6465 6661 ntry to the defa │ │ │ │ +00035980: 756c 740a 2020 2020 2073 7562 6e65 7420 ult. subnet │ │ │ │ +00035990: 6f66 2041 4444 5245 5353 2077 6974 6820 of ADDRESS with │ │ │ │ +000359a0: 6e61 6d65 2049 4e54 4552 4641 4345 273a name INTERFACE': │ │ │ │ +000359b0: 6c6f 6361 6c27 2076 6961 2049 4e54 4552 local' via INTER │ │ │ │ +000359c0: 4641 4345 2e0a 0a1f 0a46 696c 653a 2067 FACE.....File: g │ │ │ │ +000359d0: 7275 622e 696e 666f 2c20 204e 6f64 653a rub.info, Node: │ │ │ │ +000359e0: 206e 6574 5f61 6464 5f64 6e73 2c20 204e net_add_dns, N │ │ │ │ +000359f0: 6578 743a 206e 6574 5f61 6464 5f72 6f75 ext: net_add_rou │ │ │ │ +00035a00: 7465 2c20 2050 7265 763a 206e 6574 5f61 te, Prev: net_a │ │ │ │ +00035a10: 6464 5f61 6464 722c 2020 5570 3a20 4e65 dd_addr, Up: Ne │ │ │ │ +00035a20: 7477 6f72 6b69 6e67 2063 6f6d 6d61 6e64 tworking command │ │ │ │ +00035a30: 730a 0a31 362e 342e 3220 6e65 745f 6164 s..16.4.2 net_ad │ │ │ │ +00035a40: 645f 646e 730a 2d2d 2d2d 2d2d 2d2d 2d2d d_dns.---------- │ │ │ │ +00035a50: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 436f --------.. -- Co │ │ │ │ +00035a60: 6d6d 616e 643a 206e 6574 5f61 6464 5f64 mmand: net_add_d │ │ │ │ +00035a70: 6e73 2053 4552 5645 520a 2020 2020 2052 ns SERVER. R │ │ │ │ +00035a80: 6573 6f6c 7665 2053 4552 5645 5220 4950 esolve SERVER IP │ │ │ │ +00035a90: 2061 6464 7265 7373 2061 6e64 2061 6464 address and add │ │ │ │ +00035aa0: 2074 6f20 7468 6520 6c69 7374 206f 6620 to the list of │ │ │ │ +00035ab0: 444e 5320 7365 7276 6572 7320 7573 6564 DNS servers used │ │ │ │ +00035ac0: 0a20 2020 2020 6475 7269 6e67 206e 616d . during nam │ │ │ │ +00035ad0: 6520 6c6f 6f6b 7570 2e0a 0a1f 0a46 696c e lookup.....Fil │ │ │ │ +00035ae0: 653a 2067 7275 622e 696e 666f 2c20 204e e: grub.info, N │ │ │ │ +00035af0: 6f64 653a 206e 6574 5f61 6464 5f72 6f75 ode: net_add_rou │ │ │ │ +00035b00: 7465 2c20 204e 6578 743a 206e 6574 5f62 te, Next: net_b │ │ │ │ +00035b10: 6f6f 7470 2c20 2050 7265 763a 206e 6574 ootp, Prev: net │ │ │ │ +00035b20: 5f61 6464 5f64 6e73 2c20 2055 703a 204e _add_dns, Up: N │ │ │ │ +00035b30: 6574 776f 726b 696e 6720 636f 6d6d 616e etworking comman │ │ │ │ +00035b40: 6473 0a0a 3136 2e34 2e33 206e 6574 5f61 ds..16.4.3 net_a │ │ │ │ +00035b50: 6464 5f72 6f75 7465 0a2d 2d2d 2d2d 2d2d dd_route.------- │ │ │ │ +00035b60: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 -------------.. │ │ │ │ +00035b70: 2d2d 2043 6f6d 6d61 6e64 3a20 6e65 745f -- Command: net_ │ │ │ │ +00035b80: 6164 645f 726f 7574 6520 5348 4f52 544e add_route SHORTN │ │ │ │ +00035b90: 414d 4520 4950 5b2f 5052 4546 4958 5d20 AME IP[/PREFIX] │ │ │ │ +00035ba0: 5b49 4e54 4552 4641 4345 207c 2027 6777 [INTERFACE | 'gw │ │ │ │ +00035bb0: 270a 2020 2020 2020 2020 2020 4741 5445 '. GATE │ │ │ │ +00035bc0: 5741 595d 0a20 2020 2020 4164 6420 726f WAY]. Add ro │ │ │ │ +00035bd0: 7574 6520 746f 206e 6574 776f 726b 2077 ute to network w │ │ │ │ +00035be0: 6974 6820 6164 6472 6573 7320 4950 2061 ith address IP a │ │ │ │ +00035bf0: 7320 6d6f 6469 6669 6564 2062 7920 5052 s modified by PR │ │ │ │ +00035c00: 4546 4958 2076 6961 0a20 2020 2020 6569 EFIX via. ei │ │ │ │ +00035c10: 7468 6572 206c 6f63 616c 2049 4e54 4552 ther local INTER │ │ │ │ +00035c20: 4641 4345 206f 7220 4741 5445 5741 592e FACE or GATEWAY. │ │ │ │ +00035c30: 2020 5052 4546 4958 2069 7320 6f70 7469 PREFIX is opti │ │ │ │ +00035c40: 6f6e 616c 2061 6e64 2064 6566 6175 6c74 onal and default │ │ │ │ +00035c50: 730a 2020 2020 2074 6f20 3332 2066 6f72 s. to 32 for │ │ │ │ +00035c60: 2049 5076 3420 6164 6472 6573 7320 616e IPv4 address an │ │ │ │ +00035c70: 6420 3132 3820 666f 7220 4950 7636 2061 d 128 for IPv6 a │ │ │ │ +00035c80: 6464 7265 7373 2e20 2052 6f75 7465 2069 ddress. Route i │ │ │ │ +00035c90: 730a 2020 2020 2069 6465 6e74 6966 6965 s. identifie │ │ │ │ +00035ca0: 6420 6279 2053 484f 5254 4e41 4d45 2077 d by SHORTNAME w │ │ │ │ +00035cb0: 6869 6368 2063 616e 2062 6520 7573 6564 hich can be used │ │ │ │ +00035cc0: 2074 6f20 7265 6d6f 7665 2069 7420 282a to remove it (* │ │ │ │ +00035cd0: 6e6f 7465 0a20 2020 2020 6e65 745f 6465 note. net_de │ │ │ │ +00035ce0: 6c5f 726f 7574 653a 3a29 2e0a 0a1f 0a46 l_route::).....F │ │ │ │ +00035cf0: 696c 653a 2067 7275 622e 696e 666f 2c20 ile: grub.info, │ │ │ │ +00035d00: 204e 6f64 653a 206e 6574 5f62 6f6f 7470 Node: net_bootp │ │ │ │ +00035d10: 2c20 204e 6578 743a 206e 6574 5f64 656c , Next: net_del │ │ │ │ +00035d20: 5f61 6464 722c 2020 5072 6576 3a20 6e65 _addr, Prev: ne │ │ │ │ +00035d30: 745f 6164 645f 726f 7574 652c 2020 5570 t_add_route, Up │ │ │ │ +00035d40: 3a20 4e65 7477 6f72 6b69 6e67 2063 6f6d : Networking com │ │ │ │ +00035d50: 6d61 6e64 730a 0a31 362e 342e 3420 6e65 mands..16.4.4 ne │ │ │ │ +00035d60: 745f 626f 6f74 700a 2d2d 2d2d 2d2d 2d2d t_bootp.-------- │ │ │ │ +00035d70: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 436f --------.. -- Co │ │ │ │ +00035d80: 6d6d 616e 643a 206e 6574 5f62 6f6f 7470 mmand: net_bootp │ │ │ │ +00035d90: 205b 4341 5244 5d0a 2020 2020 2050 6572 [CARD]. Per │ │ │ │ +00035da0: 666f 726d 2063 6f6e 6669 6775 7261 7469 form configurati │ │ │ │ +00035db0: 6f6e 206f 6620 4341 5244 2075 7369 6e67 on of CARD using │ │ │ │ +00035dc0: 2044 4843 5020 7072 6f74 6f63 6f6c 2e20 DHCP protocol. │ │ │ │ +00035dd0: 2049 6620 6e6f 2063 6172 6420 6e61 6d65 If no card name │ │ │ │ +00035de0: 0a20 2020 2020 6973 2073 7065 6369 6669 . is specifi │ │ │ │ +00035df0: 6564 2c20 7472 7920 746f 2063 6f6e 6669 ed, try to confi │ │ │ │ +00035e00: 6775 7265 2061 6c6c 2065 7869 7374 696e gure all existin │ │ │ │ +00035e10: 6720 6361 7264 732e 2020 4966 0a20 2020 g cards. If. │ │ │ │ +00035e20: 2020 636f 6e66 6967 7572 6174 696f 6e20 configuration │ │ │ │ +00035e30: 7761 7320 7375 6363 6573 7366 756c 2c20 was successful, │ │ │ │ +00035e40: 696e 7465 7266 6163 6520 7769 7468 206e interface with n │ │ │ │ +00035e50: 616d 6520 4341 5244 273a 6468 6370 2720 ame CARD':dhcp' │ │ │ │ +00035e60: 616e 640a 2020 2020 2063 6f6e 6669 6775 and. configu │ │ │ │ +00035e70: 7265 6420 6164 6472 6573 7320 6973 2061 red address is a │ │ │ │ +00035e80: 6464 6564 2074 6f20 4341 5244 2e20 2041 dded to CARD. A │ │ │ │ +00035e90: 6464 6974 696f 6e61 6c6c 7920 7468 6520 dditionally the │ │ │ │ +00035ea0: 666f 6c6c 6f77 696e 670a 2020 2020 2044 following. D │ │ │ │ +00035eb0: 4843 5020 6f70 7469 6f6e 7320 6172 6520 HCP options are │ │ │ │ +00035ec0: 7265 636f 676e 697a 6564 2061 6e64 2070 recognized and p │ │ │ │ +00035ed0: 726f 6365 7373 6564 3a0a 0a20 2020 2020 rocessed:.. │ │ │ │ +00035ee0: 2731 2028 5375 626e 6574 204d 6173 6b29 '1 (Subnet Mask) │ │ │ │ +00035ef0: 270a 2020 2020 2020 2020 2020 5573 6564 '. Used │ │ │ │ +00035f00: 2074 6f20 6361 6c63 756c 6174 6520 6e65 to calculate ne │ │ │ │ +00035f10: 7477 6f72 6b20 6c6f 6361 6c20 726f 7574 twork local rout │ │ │ │ +00035f20: 696e 6720 656e 7472 7920 666f 7220 696e ing entry for in │ │ │ │ +00035f30: 7465 7266 6163 650a 2020 2020 2020 2020 terface. │ │ │ │ +00035f40: 2020 4341 5244 273a 6468 6370 272e 0a20 CARD':dhcp'.. │ │ │ │ +00035f50: 2020 2020 2733 2028 526f 7574 6572 2927 '3 (Router)' │ │ │ │ +00035f60: 0a20 2020 2020 2020 2020 2041 6464 7320 . Adds │ │ │ │ +00035f70: 6465 6661 756c 7420 726f 7574 6520 656e default route en │ │ │ │ +00035f80: 7472 7920 7769 7468 2074 6865 206e 616d try with the nam │ │ │ │ +00035f90: 6520 4341 5244 273a 6468 6370 3a64 6566 e CARD':dhcp:def │ │ │ │ +00035fa0: 6175 6c74 2720 7669 610a 2020 2020 2020 ault' via. │ │ │ │ +00035fb0: 2020 2020 6761 7465 7761 7920 6672 6f6d gateway from │ │ │ │ +00035fc0: 2044 4843 5020 6f70 7469 6f6e 2e20 204e DHCP option. N │ │ │ │ +00035fd0: 6f74 6520 7468 6174 206f 6e6c 7920 6f70 ote that only op │ │ │ │ +00035fe0: 7469 6f6e 2077 6974 6820 7369 6e67 6c65 tion with single │ │ │ │ +00035ff0: 0a20 2020 2020 2020 2020 2072 6f75 7465 . route │ │ │ │ +00036000: 2069 7320 6163 6365 7074 6564 2e0a 2020 is accepted.. │ │ │ │ +00036010: 2020 2027 3620 2844 6f6d 6169 6e20 4e61 '6 (Domain Na │ │ │ │ +00036020: 6d65 2053 6572 7665 7229 270a 2020 2020 me Server)'. │ │ │ │ +00036030: 2020 2020 2020 4164 6473 2061 6c6c 2073 Adds all s │ │ │ │ +00036040: 6572 7665 7273 2066 726f 6d20 6f70 7469 ervers from opti │ │ │ │ +00036050: 6f6e 2076 616c 7565 2074 6f20 7468 6520 on value to the │ │ │ │ +00036060: 6c69 7374 206f 6620 7365 7276 6572 7320 list of servers │ │ │ │ +00036070: 7573 6564 0a20 2020 2020 2020 2020 2064 used. d │ │ │ │ +00036080: 7572 696e 6720 6e61 6d65 2072 6573 6f6c uring name resol │ │ │ │ +00036090: 7574 696f 6e2e 0a20 2020 2020 2731 3220 ution.. '12 │ │ │ │ +000360a0: 2848 6f73 7420 4e61 6d65 2927 0a20 2020 (Host Name)'. │ │ │ │ +000360b0: 2020 2020 2020 2053 6574 7320 656e 7669 Sets envi │ │ │ │ +000360c0: 726f 6e6d 656e 7420 7661 7269 6162 6c65 ronment variable │ │ │ │ +000360d0: 2027 6e65 745f 273c 4341 5244 3e27 5f64 'net_''_d │ │ │ │ +000360e0: 6863 705f 686f 7374 6e61 6d65 2720 282a hcp_hostname' (* │ │ │ │ +000360f0: 6e6f 7465 0a20 2020 2020 2020 2020 206e note. n │ │ │ │ +00036100: 6574 5f3c 494e 5445 5246 4143 453e 5f68 et__h │ │ │ │ +00036110: 6f73 746e 616d 653a 3a29 2074 6f20 7468 ostname::) to th │ │ │ │ +00036120: 6520 7661 6c75 6520 6f66 206f 7074 696f e value of optio │ │ │ │ +00036130: 6e2e 0a20 2020 2020 2731 3520 2844 6f6d n.. '15 (Dom │ │ │ │ +00036140: 6169 6e20 4e61 6d65 2927 0a20 2020 2020 ain Name)'. │ │ │ │ +00036150: 2020 2020 2053 6574 7320 656e 7669 726f Sets enviro │ │ │ │ +00036160: 6e6d 656e 7420 7661 7269 6162 6c65 2027 nment variable ' │ │ │ │ +00036170: 6e65 745f 273c 4341 5244 3e27 5f64 6863 net_''_dhc │ │ │ │ +00036180: 705f 646f 6d61 696e 2720 282a 6e6f 7465 p_domain' (*note │ │ │ │ +00036190: 0a20 2020 2020 2020 2020 206e 6574 5f3c . net_< │ │ │ │ +000361a0: 494e 5445 5246 4143 453e 5f64 6f6d 6169 INTERFACE>_domai │ │ │ │ +000361b0: 6e3a 3a29 2074 6f20 7468 6520 7661 6c75 n::) to the valu │ │ │ │ +000361c0: 6520 6f66 206f 7074 696f 6e2e 0a20 2020 e of option.. │ │ │ │ +000361d0: 2020 2731 3720 2852 6f6f 7420 5061 7468 '17 (Root Path │ │ │ │ +000361e0: 2927 0a20 2020 2020 2020 2020 2053 6574 )'. Set │ │ │ │ +000361f0: 7320 656e 7669 726f 6e6d 656e 7420 7661 s environment va │ │ │ │ +00036200: 7269 6162 6c65 2027 6e65 745f 273c 4341 riable 'net_''_dhcp_rootpa │ │ │ │ +00036220: 7468 2720 282a 6e6f 7465 0a20 2020 2020 th' (*note. │ │ │ │ +00036230: 2020 2020 206e 6574 5f3c 494e 5445 5246 net__rootpath::) │ │ │ │ +00036250: 2074 6f20 7468 6520 7661 6c75 6520 6f66 to the value of │ │ │ │ +00036260: 206f 7074 696f 6e2e 0a20 2020 2020 2731 option.. '1 │ │ │ │ +00036270: 3820 2845 7874 656e 7369 6f6e 7320 5061 8 (Extensions Pa │ │ │ │ +00036280: 7468 2927 0a20 2020 2020 2020 2020 2053 th)'. S │ │ │ │ +00036290: 6574 7320 656e 7669 726f 6e6d 656e 7420 ets environment │ │ │ │ +000362a0: 7661 7269 6162 6c65 2027 6e65 745f 273c variable 'net_'< │ │ │ │ +000362b0: 4341 5244 3e27 5f64 6863 705f 6578 7465 CARD>'_dhcp_exte │ │ │ │ +000362c0: 6e73 696f 6e73 7061 7468 270a 2020 2020 nsionspath'. │ │ │ │ +000362d0: 2020 2020 2020 282a 6e6f 7465 206e 6574 (*note net │ │ │ │ +000362e0: 5f3c 494e 5445 5246 4143 453e 5f65 7874 __ext │ │ │ │ +000362f0: 656e 7369 6f6e 7370 6174 683a 3a29 2074 ensionspath::) t │ │ │ │ +00036300: 6f20 7468 6520 7661 6c75 6520 6f66 0a20 o the value of. │ │ │ │ +00036310: 2020 2020 2020 2020 206f 7074 696f 6e2e option. │ │ │ │ +00036320: 0a0a 1f0a 4669 6c65 3a20 6772 7562 2e69 ....File: grub.i │ │ │ │ +00036330: 6e66 6f2c 2020 4e6f 6465 3a20 6e65 745f nfo, Node: net_ │ │ │ │ +00036340: 6465 6c5f 6164 6472 2c20 204e 6578 743a del_addr, Next: │ │ │ │ +00036350: 206e 6574 5f64 656c 5f64 6e73 2c20 2050 net_del_dns, P │ │ │ │ +00036360: 7265 763a 206e 6574 5f62 6f6f 7470 2c20 rev: net_bootp, │ │ │ │ +00036370: 2055 703a 204e 6574 776f 726b 696e 6720 Up: Networking │ │ │ │ +00036380: 636f 6d6d 616e 6473 0a0a 3136 2e34 2e35 commands..16.4.5 │ │ │ │ +00036390: 206e 6574 5f64 656c 5f61 6464 720a 2d2d net_del_addr.-- │ │ │ │ +000363a0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ +000363b0: 2d0a 0a20 2d2d 2043 6f6d 6d61 6e64 3a20 -.. -- Command: │ │ │ │ +000363c0: 6e65 745f 6465 6c5f 6164 6472 2049 4e54 net_del_addr INT │ │ │ │ +000363d0: 4552 4641 4345 0a20 2020 2020 5265 6d6f ERFACE. Remo │ │ │ │ +000363e0: 7665 2063 6f6e 6669 6775 7265 6420 494e ve configured IN │ │ │ │ +000363f0: 5445 5246 4143 4520 7769 7468 2061 7373 TERFACE with ass │ │ │ │ +00036400: 6f63 6961 7465 6420 6164 6472 6573 732e ociated address. │ │ │ │ +00036410: 0a0a 1f0a 4669 6c65 3a20 6772 7562 2e69 ....File: grub.i │ │ │ │ +00036420: 6e66 6f2c 2020 4e6f 6465 3a20 6e65 745f nfo, Node: net_ │ │ │ │ +00036430: 6465 6c5f 646e 732c 2020 4e65 7874 3a20 del_dns, Next: │ │ │ │ +00036440: 6e65 745f 6465 6c5f 726f 7574 652c 2020 net_del_route, │ │ │ │ +00036450: 5072 6576 3a20 6e65 745f 6465 6c5f 6164 Prev: net_del_ad │ │ │ │ +00036460: 6472 2c20 2055 703a 204e 6574 776f 726b dr, Up: Network │ │ │ │ +00036470: 696e 6720 636f 6d6d 616e 6473 0a0a 3136 ing commands..16 │ │ │ │ +00036480: 2e34 2e36 206e 6574 5f64 656c 5f64 6e73 .4.6 net_del_dns │ │ │ │ +00036490: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d .--------------- │ │ │ │ +000364a0: 2d2d 2d0a 0a20 2d2d 2043 6f6d 6d61 6e64 ---.. -- Command │ │ │ │ +000364b0: 3a20 6e65 745f 6465 6c5f 646e 7320 4144 : net_del_dns AD │ │ │ │ +000364c0: 4452 4553 530a 2020 2020 2052 656d 6f76 DRESS. Remov │ │ │ │ +000364d0: 6520 4144 4452 4553 5320 6672 6f6d 206c e ADDRESS from l │ │ │ │ +000364e0: 6973 7420 6f66 2073 6572 7665 7273 2075 ist of servers u │ │ │ │ +000364f0: 7365 6420 6475 7269 6e67 206e 616d 6520 sed during name │ │ │ │ +00036500: 6c6f 6f6b 7570 2e0a 0a1f 0a46 696c 653a lookup.....File: │ │ │ │ +00036510: 2067 7275 622e 696e 666f 2c20 204e 6f64 grub.info, Nod │ │ │ │ +00036520: 653a 206e 6574 5f64 656c 5f72 6f75 7465 e: net_del_route │ │ │ │ +00036530: 2c20 204e 6578 743a 206e 6574 5f67 6574 , Next: net_get │ │ │ │ +00036540: 5f64 6863 705f 6f70 7469 6f6e 2c20 2050 _dhcp_option, P │ │ │ │ +00036550: 7265 763a 206e 6574 5f64 656c 5f64 6e73 rev: net_del_dns │ │ │ │ +00036560: 2c20 2055 703a 204e 6574 776f 726b 696e , Up: Networkin │ │ │ │ +00036570: 6720 636f 6d6d 616e 6473 0a0a 3136 2e34 g commands..16.4 │ │ │ │ +00036580: 2e37 206e 6574 5f64 656c 5f72 6f75 7465 .7 net_del_route │ │ │ │ +00036590: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d .--------------- │ │ │ │ +000365a0: 2d2d 2d2d 2d0a 0a20 2d2d 2043 6f6d 6d61 -----.. -- Comma │ │ │ │ +000365b0: 6e64 3a20 6e65 745f 6465 6c5f 726f 7574 nd: net_del_rout │ │ │ │ +000365c0: 6520 5348 4f52 544e 414d 450a 2020 2020 e SHORTNAME. │ │ │ │ +000365d0: 2052 656d 6f76 6520 726f 7574 6520 656e Remove route en │ │ │ │ +000365e0: 7472 7920 6964 656e 7469 6669 6564 2062 try identified b │ │ │ │ +000365f0: 7920 5348 4f52 544e 414d 452e 0a0a 1f0a y SHORTNAME..... │ │ │ │ +00036600: 4669 6c65 3a20 6772 7562 2e69 6e66 6f2c File: grub.info, │ │ │ │ +00036610: 2020 4e6f 6465 3a20 6e65 745f 6765 745f Node: net_get_ │ │ │ │ +00036620: 6468 6370 5f6f 7074 696f 6e2c 2020 4e65 dhcp_option, Ne │ │ │ │ +00036630: 7874 3a20 6e65 745f 6970 7636 5f61 7574 xt: net_ipv6_aut │ │ │ │ +00036640: 6f63 6f6e 662c 2020 5072 6576 3a20 6e65 oconf, Prev: ne │ │ │ │ +00036650: 745f 6465 6c5f 726f 7574 652c 2020 5570 t_del_route, Up │ │ │ │ +00036660: 3a20 4e65 7477 6f72 6b69 6e67 2063 6f6d : Networking com │ │ │ │ +00036670: 6d61 6e64 730a 0a31 362e 342e 3820 6e65 mands..16.4.8 ne │ │ │ │ +00036680: 745f 6765 745f 6468 6370 5f6f 7074 696f t_get_dhcp_optio │ │ │ │ +00036690: 6e0a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d n.-------------- │ │ │ │ +000366a0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d ------------.. - │ │ │ │ +000366b0: 2d20 436f 6d6d 616e 643a 206e 6574 5f67 - Command: net_g │ │ │ │ +000366c0: 6574 5f64 6863 705f 6f70 7469 6f6e 2056 et_dhcp_option V │ │ │ │ +000366d0: 4152 2049 4e54 4552 4641 4345 204e 554d AR INTERFACE NUM │ │ │ │ +000366e0: 4245 5220 5459 5045 0a20 2020 2020 5265 BER TYPE. Re │ │ │ │ +000366f0: 7175 6573 7420 4448 4350 206f 7074 696f quest DHCP optio │ │ │ │ +00036700: 6e20 4e55 4d42 4552 206f 6620 5459 5045 n NUMBER of TYPE │ │ │ │ +00036710: 2076 6961 2049 4e54 4552 4641 4345 2e20 via INTERFACE. │ │ │ │ +00036720: 2054 5950 4520 6361 6e20 6265 206f 6e65 TYPE can be one │ │ │ │ +00036730: 0a20 2020 2020 6f66 2027 7374 7269 6e67 . of 'string │ │ │ │ +00036740: 272c 2027 6e75 6d62 6572 2720 6f72 2027 ', 'number' or ' │ │ │ │ +00036750: 6865 7827 2e20 2049 6620 6f70 7469 6f6e hex'. If option │ │ │ │ +00036760: 2069 7320 666f 756e 642c 2061 7373 6967 is found, assig │ │ │ │ +00036770: 6e20 6974 730a 2020 2020 2076 616c 7565 n its. value │ │ │ │ +00036780: 2074 6f20 7661 7269 6162 6c65 2056 4152 to variable VAR │ │ │ │ +00036790: 2e20 2056 616c 7565 7320 6f66 2074 7970 . Values of typ │ │ │ │ +000367a0: 6573 2027 6e75 6d62 6572 2720 616e 6420 es 'number' and │ │ │ │ +000367b0: 2768 6578 2720 6172 650a 2020 2020 2063 'hex' are. c │ │ │ │ +000367c0: 6f6e 7665 7274 6564 2074 6f20 7374 7269 onverted to stri │ │ │ │ +000367d0: 6e67 2072 6570 7265 7365 6e74 6174 696f ng representatio │ │ │ │ +000367e0: 6e2e 0a0a 1f0a 4669 6c65 3a20 6772 7562 n.....File: grub │ │ │ │ +000367f0: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 6e65 .info, Node: ne │ │ │ │ +00036800: 745f 6970 7636 5f61 7574 6f63 6f6e 662c t_ipv6_autoconf, │ │ │ │ +00036810: 2020 4e65 7874 3a20 6e65 745f 6c73 5f61 Next: net_ls_a │ │ │ │ +00036820: 6464 722c 2020 5072 6576 3a20 6e65 745f ddr, Prev: net_ │ │ │ │ +00036830: 6765 745f 6468 6370 5f6f 7074 696f 6e2c get_dhcp_option, │ │ │ │ +00036840: 2020 5570 3a20 4e65 7477 6f72 6b69 6e67 Up: Networking │ │ │ │ +00036850: 2063 6f6d 6d61 6e64 730a 0a31 362e 342e commands..16.4. │ │ │ │ +00036860: 3920 6e65 745f 6970 7636 5f61 7574 6f63 9 net_ipv6_autoc │ │ │ │ +00036870: 6f6e 660a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d onf.------------ │ │ │ │ +00036880: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d ------------.. - │ │ │ │ +00036890: 2d20 436f 6d6d 616e 643a 206e 6574 5f69 - Command: net_i │ │ │ │ +000368a0: 7076 365f 6175 746f 636f 6e66 205b 4341 pv6_autoconf [CA │ │ │ │ +000368b0: 5244 5d0a 2020 2020 2050 6572 666f 726d RD]. Perform │ │ │ │ +000368c0: 2049 5076 3620 6175 746f 636f 6e66 6967 IPv6 autoconfig │ │ │ │ +000368d0: 7572 6174 696f 6e20 6279 2061 6464 696e uration by addin │ │ │ │ +000368e0: 6720 746f 2074 6865 2043 4152 4420 696e g to the CARD in │ │ │ │ +000368f0: 7465 7266 6163 6520 7769 7468 0a20 2020 terface with. │ │ │ │ +00036900: 2020 6e61 6d65 2043 4152 4427 3a6c 696e name CARD':lin │ │ │ │ +00036910: 6b27 2061 6e64 206c 696e 6b20 6c6f 6361 k' and link loca │ │ │ │ +00036920: 6c20 4d41 432d 6261 7365 6420 6164 6472 l MAC-based addr │ │ │ │ +00036930: 6573 732e 2020 4966 206e 6f20 6361 7264 ess. If no card │ │ │ │ +00036940: 2069 730a 2020 2020 2073 7065 6369 6669 is. specifi │ │ │ │ +00036950: 6564 2c20 7065 7266 6f72 6d20 6175 746f ed, perform auto │ │ │ │ +00036960: 636f 6e66 6967 7572 6174 696f 6e20 666f configuration fo │ │ │ │ +00036970: 7220 616c 6c20 6578 6973 7469 6e67 2063 r all existing c │ │ │ │ +00036980: 6172 6473 2e0a 0a1f 0a46 696c 653a 2067 ards.....File: g │ │ │ │ +00036990: 7275 622e 696e 666f 2c20 204e 6f64 653a rub.info, Node: │ │ │ │ +000369a0: 206e 6574 5f6c 735f 6164 6472 2c20 204e net_ls_addr, N │ │ │ │ +000369b0: 6578 743a 206e 6574 5f6c 735f 6361 7264 ext: net_ls_card │ │ │ │ +000369c0: 732c 2020 5072 6576 3a20 6e65 745f 6970 s, Prev: net_ip │ │ │ │ +000369d0: 7636 5f61 7574 6f63 6f6e 662c 2020 5570 v6_autoconf, Up │ │ │ │ +000369e0: 3a20 4e65 7477 6f72 6b69 6e67 2063 6f6d : Networking com │ │ │ │ +000369f0: 6d61 6e64 730a 0a31 362e 342e 3130 206e mands..16.4.10 n │ │ │ │ +00036a00: 6574 5f6c 735f 6164 6472 0a2d 2d2d 2d2d et_ls_addr.----- │ │ │ │ +00036a10: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a --------------.. │ │ │ │ +00036a20: 202d 2d20 436f 6d6d 616e 643a 206e 6574 -- Command: net │ │ │ │ +00036a30: 5f6c 735f 6164 6472 0a20 2020 2020 4c69 _ls_addr. Li │ │ │ │ +00036a40: 7374 2061 6c6c 2063 6f6e 6669 6775 7265 st all configure │ │ │ │ +00036a50: 6420 696e 7465 7266 6163 6573 2077 6974 d interfaces wit │ │ │ │ +00036a60: 6820 7468 6569 7220 4d41 4320 616e 6420 h their MAC and │ │ │ │ +00036a70: 4950 2061 6464 7265 7373 6573 2e0a 0a1f IP addresses.... │ │ │ │ +00036a80: 0a46 696c 653a 2067 7275 622e 696e 666f .File: grub.info │ │ │ │ +00036a90: 2c20 204e 6f64 653a 206e 6574 5f6c 735f , Node: net_ls_ │ │ │ │ +00036aa0: 6361 7264 732c 2020 4e65 7874 3a20 6e65 cards, Next: ne │ │ │ │ +00036ab0: 745f 6c73 5f64 6e73 2c20 2050 7265 763a t_ls_dns, Prev: │ │ │ │ +00036ac0: 206e 6574 5f6c 735f 6164 6472 2c20 2055 net_ls_addr, U │ │ │ │ +00036ad0: 703a 204e 6574 776f 726b 696e 6720 636f p: Networking co │ │ │ │ +00036ae0: 6d6d 616e 6473 0a0a 3136 2e34 2e31 3120 mmands..16.4.11 │ │ │ │ +00036af0: 6e65 745f 6c73 5f63 6172 6473 0a2d 2d2d net_ls_cards.--- │ │ │ │ +00036b00: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ +00036b10: 2d0a 0a20 2d2d 2043 6f6d 6d61 6e64 3a20 -.. -- Command: │ │ │ │ +00036b20: 6e65 745f 6c73 5f63 6172 6473 0a20 2020 net_ls_cards. │ │ │ │ +00036b30: 2020 4c69 7374 2061 6c6c 2064 6574 6563 List all detec │ │ │ │ +00036b40: 7465 6420 6e65 7477 6f72 6b20 6361 7264 ted network card │ │ │ │ +00036b50: 7320 7769 7468 2074 6865 6972 204d 4143 s with their MAC │ │ │ │ +00036b60: 2061 6464 7265 7373 2e0a 0a1f 0a46 696c address.....Fil │ │ │ │ +00036b70: 653a 2067 7275 622e 696e 666f 2c20 204e e: grub.info, N │ │ │ │ +00036b80: 6f64 653a 206e 6574 5f6c 735f 646e 732c ode: net_ls_dns, │ │ │ │ +00036b90: 2020 4e65 7874 3a20 6e65 745f 6c73 5f72 Next: net_ls_r │ │ │ │ +00036ba0: 6f75 7465 732c 2020 5072 6576 3a20 6e65 outes, Prev: ne │ │ │ │ +00036bb0: 745f 6c73 5f63 6172 6473 2c20 2055 703a t_ls_cards, Up: │ │ │ │ +00036bc0: 204e 6574 776f 726b 696e 6720 636f 6d6d Networking comm │ │ │ │ +00036bd0: 616e 6473 0a0a 3136 2e34 2e31 3220 6e65 ands..16.4.12 ne │ │ │ │ +00036be0: 745f 6c73 5f64 6e73 0a2d 2d2d 2d2d 2d2d t_ls_dns.------- │ │ │ │ +00036bf0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d -----------.. -- │ │ │ │ +00036c00: 2043 6f6d 6d61 6e64 3a20 6e65 745f 6c73 Command: net_ls │ │ │ │ +00036c10: 5f64 6e73 0a20 2020 2020 4c69 7374 2061 _dns. List a │ │ │ │ +00036c20: 6464 7265 7373 6573 206f 6620 444e 5320 ddresses of DNS │ │ │ │ +00036c30: 7365 7276 6572 7320 7573 6564 2064 7572 servers used dur │ │ │ │ +00036c40: 696e 6720 6e61 6d65 206c 6f6f 6b75 702e ing name lookup. │ │ │ │ +00036c50: 0a0a 1f0a 4669 6c65 3a20 6772 7562 2e69 ....File: grub.i │ │ │ │ +00036c60: 6e66 6f2c 2020 4e6f 6465 3a20 6e65 745f nfo, Node: net_ │ │ │ │ +00036c70: 6c73 5f72 6f75 7465 732c 2020 4e65 7874 ls_routes, Next │ │ │ │ +00036c80: 3a20 6e65 745f 6e73 6c6f 6f6b 7570 2c20 : net_nslookup, │ │ │ │ +00036c90: 2050 7265 763a 206e 6574 5f6c 735f 646e Prev: net_ls_dn │ │ │ │ +00036ca0: 732c 2020 5570 3a20 4e65 7477 6f72 6b69 s, Up: Networki │ │ │ │ +00036cb0: 6e67 2063 6f6d 6d61 6e64 730a 0a31 362e ng commands..16. │ │ │ │ +00036cc0: 342e 3133 206e 6574 5f6c 735f 726f 7574 4.13 net_ls_rout │ │ │ │ +00036cd0: 6573 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d es.------------- │ │ │ │ +00036ce0: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 436f --------.. -- Co │ │ │ │ +00036cf0: 6d6d 616e 643a 206e 6574 5f6c 735f 726f mmand: net_ls_ro │ │ │ │ +00036d00: 7574 6573 0a20 2020 2020 4c69 7374 2072 utes. List r │ │ │ │ +00036d10: 6f75 7469 6e67 2065 6e74 7269 6573 2e0a outing entries.. │ │ │ │ +00036d20: 0a1f 0a46 696c 653a 2067 7275 622e 696e ...File: grub.in │ │ │ │ +00036d30: 666f 2c20 204e 6f64 653a 206e 6574 5f6e fo, Node: net_n │ │ │ │ +00036d40: 736c 6f6f 6b75 702c 2020 5072 6576 3a20 slookup, Prev: │ │ │ │ +00036d50: 6e65 745f 6c73 5f72 6f75 7465 732c 2020 net_ls_routes, │ │ │ │ +00036d60: 5570 3a20 4e65 7477 6f72 6b69 6e67 2063 Up: Networking c │ │ │ │ +00036d70: 6f6d 6d61 6e64 730a 0a31 362e 342e 3134 ommands..16.4.14 │ │ │ │ +00036d80: 206e 6574 5f6e 736c 6f6f 6b75 700a 2d2d net_nslookup.-- │ │ │ │ +00036d90: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ +00036da0: 2d2d 0a0a 202d 2d20 436f 6d6d 616e 643a --.. -- Command: │ │ │ │ +00036db0: 206e 6574 5f6e 736c 6f6f 6b75 7020 4e41 net_nslookup NA │ │ │ │ +00036dc0: 4d45 205b 5345 5256 4552 5d0a 2020 2020 ME [SERVER]. │ │ │ │ +00036dd0: 2052 6573 6f6c 7665 2061 6464 7265 7373 Resolve address │ │ │ │ +00036de0: 206f 6620 4e41 4d45 2075 7369 6e67 2044 of NAME using D │ │ │ │ +00036df0: 4e53 2073 6572 7665 7220 5345 5256 4552 NS server SERVER │ │ │ │ +00036e00: 2e20 2049 6620 6e6f 2073 6572 7665 7220 . If no server │ │ │ │ +00036e10: 6973 0a20 2020 2020 6769 7665 6e2c 2075 is. given, u │ │ │ │ +00036e20: 7365 2064 6566 6175 6c74 206c 6973 7420 se default list │ │ │ │ +00036e30: 6f66 2073 6572 7665 7273 2e0a 0a1f 0a46 of servers.....F │ │ │ │ +00036e40: 696c 653a 2067 7275 622e 696e 666f 2c20 ile: grub.info, │ │ │ │ +00036e50: 204e 6f64 653a 2049 6e74 6572 6e61 7469 Node: Internati │ │ │ │ +00036e60: 6f6e 616c 6973 6174 696f 6e2c 2020 4e65 onalisation, Ne │ │ │ │ +00036e70: 7874 3a20 5365 6375 7269 7479 2c20 2050 xt: Security, P │ │ │ │ +00036e80: 7265 763a 2043 6f6d 6d61 6e64 732c 2020 rev: Commands, │ │ │ │ +00036e90: 5570 3a20 546f 700a 0a31 3720 496e 7465 Up: Top..17 Inte │ │ │ │ +00036ea0: 726e 6174 696f 6e61 6c69 7361 7469 6f6e rnationalisation │ │ │ │ +00036eb0: 0a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a .*************** │ │ │ │ +00036ec0: 2a2a 2a2a 2a2a 2a2a 0a0a 3137 2e31 2043 ********..17.1 C │ │ │ │ +00036ed0: 6861 7273 6574 0a3d 3d3d 3d3d 3d3d 3d3d harset.========= │ │ │ │ +00036ee0: 3d3d 3d0a 0a47 5255 4220 7573 6573 2055 ===..GRUB uses U │ │ │ │ +00036ef0: 5446 2d38 2069 6e74 6572 6e61 6c6c 7920 TF-8 internally │ │ │ │ +00036f00: 6f74 6865 7220 7468 616e 2069 6e20 7265 other than in re │ │ │ │ +00036f10: 6e64 6572 696e 6720 7768 6572 6520 736f ndering where so │ │ │ │ +00036f20: 6d65 0a47 5255 422d 7370 6563 6966 6963 me.GRUB-specific │ │ │ │ +00036f30: 2061 7070 726f 7072 6961 7465 2072 6570 appropriate rep │ │ │ │ +00036f40: 7265 7365 6e74 6174 696f 6e20 6973 2075 resentation is u │ │ │ │ +00036f50: 7365 642e 2020 416c 6c20 7465 7874 2066 sed. All text f │ │ │ │ +00036f60: 696c 6573 0a28 696e 636c 7564 696e 6720 iles.(including │ │ │ │ +00036f70: 636f 6e66 6967 2920 6172 6520 6173 7375 config) are assu │ │ │ │ +00036f80: 6d65 6420 746f 2062 6520 656e 636f 6465 med to be encode │ │ │ │ +00036f90: 6420 696e 2055 5446 2d38 2e0a 0a31 372e d in UTF-8...17. │ │ │ │ +00036fa0: 3220 4669 6c65 7379 7374 656d 730a 3d3d 2 Filesystems.== │ │ │ │ +00036fb0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a ==============.. │ │ │ │ +00036fc0: 4e54 4653 2c20 4a46 532c 2055 4446 2c20 NTFS, JFS, UDF, │ │ │ │ +00036fd0: 4846 532b 2c20 6578 4641 542c 206c 6f6e HFS+, exFAT, lon │ │ │ │ +00036fe0: 6720 6669 6c65 6e61 6d65 7320 696e 2046 g filenames in F │ │ │ │ +00036ff0: 4154 2c20 4a6f 6c69 6574 2070 6172 7420 AT, Joliet part │ │ │ │ +00037000: 6f66 0a49 534f 3936 3630 2061 7265 2074 of.ISO9660 are t │ │ │ │ +00037010: 7265 6174 6564 2061 7320 5554 462d 3136 reated as UTF-16 │ │ │ │ +00037020: 2061 7320 7065 7220 7370 6563 6966 6963 as per specific │ │ │ │ +00037030: 6174 696f 6e2e 2020 4146 5320 616e 6420 ation. AFS and │ │ │ │ +00037040: 4246 5320 6172 650a 7265 6164 2061 7320 BFS are.read as │ │ │ │ +00037050: 5554 462d 382c 2061 6761 696e 2061 6363 UTF-8, again acc │ │ │ │ +00037060: 6f72 6469 6e67 2074 6f20 7370 6563 6966 ording to specif │ │ │ │ +00037070: 6963 6174 696f 6e2e 2020 4274 7246 532c ication. BtrFS, │ │ │ │ +00037080: 2063 7069 6f2c 2074 6172 2c0a 7371 7561 cpio, tar,.squa │ │ │ │ +00037090: 7368 342c 206d 696e 6978 2c20 6d69 6e69 sh4, minix, mini │ │ │ │ +000370a0: 7832 2c20 6d69 6e69 7833 2c20 524f 4d46 x2, minix3, ROMF │ │ │ │ +000370b0: 532c 2052 6569 7365 7246 532c 2058 4653 S, ReiserFS, XFS │ │ │ │ +000370c0: 2c20 6578 7432 2c20 6578 7433 2c20 6578 , ext2, ext3, ex │ │ │ │ +000370d0: 7434 2c0a 4641 5420 2873 686f 7274 206e t4,.FAT (short n │ │ │ │ +000370e0: 616d 6573 292c 2046 3246 532c 2052 6f63 ames), F2FS, Roc │ │ │ │ +000370f0: 6b52 6964 6765 2070 6172 7420 6f66 2049 kRidge part of I │ │ │ │ +00037100: 534f 3936 3630 2c20 6e69 6c66 7332 2c20 SO9660, nilfs2, │ │ │ │ +00037110: 5546 5331 2c20 5546 5332 0a61 6e64 205a UFS1, UFS2.and Z │ │ │ │ +00037120: 4653 2061 7265 2061 7373 756d 6564 2074 FS are assumed t │ │ │ │ +00037130: 6f20 6265 2055 5446 2d38 2e20 2054 6869 o be UTF-8. Thi │ │ │ │ +00037140: 7320 6d69 6768 7420 6265 2066 616c 7365 s might be false │ │ │ │ +00037150: 206f 6e20 7379 7374 656d 730a 636f 6e66 on systems.conf │ │ │ │ +00037160: 6967 7572 6564 2077 6974 6820 6c65 6761 igured with lega │ │ │ │ +00037170: 6379 2063 6861 7273 6574 2062 7574 2061 cy charset but a │ │ │ │ +00037180: 7320 6c6f 6e67 2061 7320 7468 6520 6368 s long as the ch │ │ │ │ +00037190: 6172 7365 7420 7573 6564 2069 730a 7375 arset used is.su │ │ │ │ +000371a0: 7065 7273 6574 206f 6620 4153 4349 4920 perset of ASCII │ │ │ │ +000371b0: 796f 7520 7368 6f75 6c64 2062 6520 6162 you should be ab │ │ │ │ +000371c0: 6c65 2074 6f20 6163 6365 7373 2041 5343 le to access ASC │ │ │ │ +000371d0: 4949 2d6e 616d 6564 2066 696c 6573 2e20 II-named files. │ │ │ │ +000371e0: 2041 6e64 0a69 7427 7320 7265 636f 6d6d And.it's recomm │ │ │ │ +000371f0: 656e 6465 6420 746f 2063 6f6e 6669 6775 ended to configu │ │ │ │ +00037200: 7265 2079 6f75 7220 7379 7374 656d 2074 re your system t │ │ │ │ +00037210: 6f20 7573 6520 5554 462d 3820 746f 2061 o use UTF-8 to a │ │ │ │ +00037220: 6363 6573 7320 7468 650a 6669 6c65 7379 ccess the.filesy │ │ │ │ +00037230: 7374 656d 2c20 636f 6e76 6d76 206d 6179 stem, convmv may │ │ │ │ +00037240: 2068 656c 7020 7769 7468 206d 6967 7261 help with migra │ │ │ │ +00037250: 7469 6f6e 2e20 2049 534f 3936 3630 2028 tion. ISO9660 ( │ │ │ │ +00037260: 706c 6169 6e29 2066 696c 656e 616d 6573 plain) filenames │ │ │ │ +00037270: 0a61 7265 2073 7065 6369 6669 6564 2061 .are specified a │ │ │ │ +00037280: 7320 6265 696e 6720 4153 4349 4920 6f72 s being ASCII or │ │ │ │ +00037290: 2062 6569 6e67 2064 6573 6372 6962 6564 being described │ │ │ │ +000372a0: 2077 6974 6820 756e 7370 6563 6966 6965 with unspecifie │ │ │ │ +000372b0: 6420 6573 6361 7065 0a73 6571 7565 6e63 d escape.sequenc │ │ │ │ +000372c0: 6573 2e20 2047 5255 4220 6173 7375 6d65 es. GRUB assume │ │ │ │ +000372d0: 7320 7468 6174 2074 6865 2049 534f 3936 s that the ISO96 │ │ │ │ +000372e0: 3630 206e 616d 6573 2061 7265 2055 5446 60 names are UTF │ │ │ │ +000372f0: 2d38 2028 7369 6e63 6520 616e 790a 4153 -8 (since any.AS │ │ │ │ +00037300: 4349 4920 6973 2076 616c 6964 2055 5446 CII is valid UTF │ │ │ │ +00037310: 2d38 292e 2020 5468 6572 6520 6172 6520 -8). There are │ │ │ │ +00037320: 736f 6d65 206f 6c64 2043 442d 524f 4d73 some old CD-ROMs │ │ │ │ +00037330: 2077 6869 6368 2075 7365 2043 5034 3337 which use CP437 │ │ │ │ +00037340: 2069 6e0a 6e6f 6e2d 636f 6d70 6c69 616e in.non-complian │ │ │ │ +00037350: 7420 7761 792e 2020 596f 7527 7265 2073 t way. You're s │ │ │ │ +00037360: 7469 6c6c 2061 626c 6520 746f 2061 6363 till able to acc │ │ │ │ +00037370: 6573 7320 6669 6c65 7320 7769 7468 206e ess files with n │ │ │ │ +00037380: 616d 6573 0a63 6f6e 7461 696e 696e 6720 ames.containing │ │ │ │ +00037390: 6f6e 6c79 2041 5343 4949 2063 6861 7261 only ASCII chara │ │ │ │ +000373a0: 6374 6572 7320 6f6e 2073 7563 6820 6669 cters on such fi │ │ │ │ +000373b0: 6c65 7379 7374 656d 7320 7468 6f75 6768 lesystems though │ │ │ │ +000373c0: 2e20 2059 6f75 2772 650a 616c 736f 2061 . You're.also a │ │ │ │ +000373d0: 626c 6520 746f 2061 6363 6573 7320 616e ble to access an │ │ │ │ +000373e0: 7920 6669 6c65 2069 6620 7468 6520 6669 y file if the fi │ │ │ │ +000373f0: 6c65 7379 7374 656d 2063 6f6e 7461 696e lesystem contain │ │ │ │ +00037400: 7320 7661 6c69 6420 4a6f 6c69 6574 0a28 s valid Joliet.( │ │ │ │ +00037410: 5554 462d 3136 2920 6f72 2052 6f63 6b52 UTF-16) or RockR │ │ │ │ +00037420: 6964 6765 2028 5554 462d 3829 2e20 2041 idge (UTF-8). A │ │ │ │ +00037430: 4646 532c 2053 4653 2061 6e64 2048 4653 FFS, SFS and HFS │ │ │ │ +00037440: 206e 6576 6572 2075 7365 2075 6e69 636f never use unico │ │ │ │ +00037450: 6465 2061 6e64 0a47 5255 4220 6173 7375 de and.GRUB assu │ │ │ │ +00037460: 6d65 7320 7468 656d 2074 6f20 6265 2069 mes them to be i │ │ │ │ +00037470: 6e20 4c61 7469 6e31 2c20 4c61 7469 6e31 n Latin1, Latin1 │ │ │ │ +00037480: 2061 6e64 204d 6163 526f 6d61 6e20 7265 and MacRoman re │ │ │ │ +00037490: 7370 6563 7469 7665 6c79 2e0a 4752 5542 spectively..GRUB │ │ │ │ +000374a0: 2068 616e 646c 6573 2066 696c 6573 7973 handles filesys │ │ │ │ +000374b0: 7465 6d20 6361 7365 2d69 6e73 656e 7369 tem case-insensi │ │ │ │ +000374c0: 7469 7669 7479 2068 6f77 6576 6572 206e tivity however n │ │ │ │ +000374d0: 6f20 6174 7465 6d70 7420 6973 0a70 6572 o attempt is.per │ │ │ │ +000374e0: 666f 726d 6564 2061 7420 6361 7365 2063 formed at case c │ │ │ │ +000374f0: 6f6e 7665 7273 696f 6e20 6f66 2069 6e74 onversion of int │ │ │ │ +00037500: 6572 6e61 7469 6f6e 616c 2063 6861 7261 ernational chara │ │ │ │ +00037510: 6374 6572 7320 736f 2065 2e67 2e20 2061 cters so e.g. a │ │ │ │ +00037520: 2066 696c 650a 6e61 6d65 6420 6c6f 7765 file.named lowe │ │ │ │ +00037530: 7263 6173 6520 6772 6565 6b20 616c 7068 rcase greek alph │ │ │ │ +00037540: 6120 6973 2074 7265 6174 6564 2061 7320 a is treated as │ │ │ │ +00037550: 6469 6666 6572 656e 7420 6672 6f6d 2074 different from t │ │ │ │ +00037560: 6865 206f 6e65 206e 616d 6564 0a61 7320 he one named.as │ │ │ │ +00037570: 7570 7065 7263 6173 6520 616c 7068 612e uppercase alpha. │ │ │ │ +00037580: 2020 5468 6520 6669 6c65 7379 7374 656d The filesystem │ │ │ │ +00037590: 7320 696e 2071 7565 7374 696f 6e73 2061 s in questions a │ │ │ │ +000375a0: 7265 204e 5446 5320 2865 7863 6570 7420 re NTFS (except │ │ │ │ +000375b0: 504f 5349 580a 6e61 6d65 7370 6163 6529 POSIX.namespace) │ │ │ │ +000375c0: 2c20 4846 532b 2028 636f 6e66 6967 7572 , HFS+ (configur │ │ │ │ +000375d0: 6162 6c65 2061 7420 6d6b 6673 2074 696d able at mkfs tim │ │ │ │ +000375e0: 652c 2064 6566 6175 6c74 2069 6e73 656e e, default insen │ │ │ │ +000375f0: 7369 7469 7665 292c 2053 4653 0a28 636f sitive), SFS.(co │ │ │ │ +00037600: 6e66 6967 7572 6162 6c65 2061 7420 6d6b nfigurable at mk │ │ │ │ +00037610: 6673 2074 696d 652c 2064 6566 6175 6c74 fs time, default │ │ │ │ +00037620: 2069 6e73 656e 7369 7469 7665 292c 204a insensitive), J │ │ │ │ +00037630: 4653 2028 636f 6e66 6967 7572 6162 6c65 FS (configurable │ │ │ │ +00037640: 2061 740a 6d6b 6673 2074 696d 652c 2064 at.mkfs time, d │ │ │ │ +00037650: 6566 6175 6c74 2073 656e 7369 7469 7665 efault sensitive │ │ │ │ +00037660: 292c 2048 4653 2c20 4146 4653 2c20 4641 ), HFS, AFFS, FA │ │ │ │ +00037670: 542c 2065 7846 4154 2061 6e64 205a 4653 T, exFAT and ZFS │ │ │ │ +00037680: 0a28 636f 6e66 6967 7572 6162 6c65 206f .(configurable o │ │ │ │ +00037690: 6e20 7065 722d 7375 6276 6f6c 756d 6520 n per-subvolume │ │ │ │ +000376a0: 6261 7369 7320 6279 2070 726f 7065 7274 basis by propert │ │ │ │ +000376b0: 7920 2263 6173 6573 656e 7369 7469 7669 y "casesensitivi │ │ │ │ +000376c0: 7479 222c 0a64 6566 6175 6c74 2073 656e ty",.default sen │ │ │ │ +000376d0: 7369 7469 7665 292e 2020 4f6e 205a 4653 sitive). On ZFS │ │ │ │ +000376e0: 2073 7562 766f 6c75 6d65 7320 6d61 726b subvolumes mark │ │ │ │ +000376f0: 6564 2061 7320 6361 7365 2069 6e73 656e ed as case insen │ │ │ │ +00037700: 7369 7469 7665 2066 696c 6573 0a63 6f6e sitive files.con │ │ │ │ +00037710: 7461 696e 696e 6720 6c6f 7765 7263 6173 taining lowercas │ │ │ │ +00037720: 6520 696e 7465 726e 6174 696f 6e61 6c20 e international │ │ │ │ +00037730: 6368 6172 6163 7465 7273 2061 7265 2069 characters are i │ │ │ │ +00037740: 6e61 6363 6573 7369 626c 652e 2020 416c naccessible. Al │ │ │ │ +00037750: 736f 0a6c 696b 6520 616c 6c20 7375 7070 so.like all supp │ │ │ │ +00037760: 6f72 7465 6420 6669 6c65 7379 7374 656d orted filesystem │ │ │ │ +00037770: 7320 6578 6365 7074 2048 4653 2b20 616e s except HFS+ an │ │ │ │ +00037780: 6420 5a46 5320 2863 6f6e 6669 6775 7261 d ZFS (configura │ │ │ │ +00037790: 626c 6520 6f6e 0a70 6572 2d73 7562 766f ble on.per-subvo │ │ │ │ +000377a0: 6c75 6d65 2062 6173 6973 2062 7920 7072 lume basis by pr │ │ │ │ +000377b0: 6f70 6572 7479 2022 6e6f 726d 616c 697a operty "normaliz │ │ │ │ +000377c0: 6174 696f 6e22 2c20 6465 6661 756c 7420 ation", default │ │ │ │ +000377d0: 6e6f 6e65 2920 4752 5542 0a6d 616b 6573 none) GRUB.makes │ │ │ │ +000377e0: 206e 6f20 6174 7465 6d70 7420 6174 2063 no attempt at c │ │ │ │ +000377f0: 6865 636b 206f 6620 6361 6e6f 6e69 6361 heck of canonica │ │ │ │ +00037800: 6c20 6571 7569 7661 6c65 6e63 6520 736f l equivalence so │ │ │ │ +00037810: 2061 2066 696c 6520 6e61 6d65 0a75 2d64 a file name.u-d │ │ │ │ +00037820: 6961 7265 7369 7320 6973 2074 7265 6174 iaresis is treat │ │ │ │ +00037830: 6564 2061 7320 6469 7374 696e 6374 2066 ed as distinct f │ │ │ │ +00037840: 726f 6d20 752b 636f 6d62 696e 696e 6720 rom u+combining │ │ │ │ +00037850: 6469 6172 6573 6973 2e20 2054 6869 730a diaresis. This. │ │ │ │ +00037860: 686f 7765 7665 7220 6d65 616e 7320 7468 however means th │ │ │ │ +00037870: 6174 2069 6e20 6f72 6465 7220 746f 2061 at in order to a │ │ │ │ +00037880: 6363 6573 7320 6669 6c65 206f 6e20 4846 ccess file on HF │ │ │ │ +00037890: 532b 2069 7473 206e 616d 6520 6d75 7374 S+ its name must │ │ │ │ +000378a0: 2062 650a 7370 6563 6966 6965 6420 696e be.specified in │ │ │ │ +000378b0: 206e 6f72 6d61 6c69 7361 7469 6f6e 2066 normalisation f │ │ │ │ +000378c0: 6f72 6d20 442e 204f 6e20 6e6f 726d 616c orm D. On normal │ │ │ │ +000378d0: 697a 6564 205a 4653 2073 7562 766f 6c75 ized ZFS subvolu │ │ │ │ +000378e0: 6d65 730a 6669 6c65 6e61 6d65 7320 6f75 mes.filenames ou │ │ │ │ +000378f0: 7420 6f66 206e 6f72 6d61 6c69 7361 7469 t of normalisati │ │ │ │ +00037900: 6f6e 2061 7265 2069 6e61 6363 6573 7369 on are inaccessi │ │ │ │ +00037910: 626c 652e 0a0a 3137 2e33 204f 7574 7075 ble...17.3 Outpu │ │ │ │ +00037920: 7420 7465 726d 696e 616c 0a3d 3d3d 3d3d t terminal.===== │ │ │ │ +00037930: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a ===============. │ │ │ │ +00037940: 0a46 6972 6d77 6172 6520 6f75 7470 7574 .Firmware output │ │ │ │ +00037950: 2063 6f6e 736f 6c65 2022 636f 6e73 6f6c console "consol │ │ │ │ +00037960: 6522 206f 6e20 4152 4320 616e 6420 4945 e" on ARC and IE │ │ │ │ +00037970: 4545 3132 3735 2061 7265 206c 696d 6974 EE1275 are limit │ │ │ │ +00037980: 6564 2074 6f0a 4153 4349 492e 0a0a 2020 ed to.ASCII... │ │ │ │ +00037990: 2042 494f 5320 6669 726d 7761 7265 2063 BIOS firmware c │ │ │ │ +000379a0: 6f6e 736f 6c65 2061 6e64 2056 4741 2074 onsole and VGA t │ │ │ │ +000379b0: 6578 7420 6172 6520 6c69 6d69 7465 6420 ext are limited │ │ │ │ +000379c0: 746f 2041 5343 4949 2061 6e64 2073 6f6d to ASCII and som │ │ │ │ +000379d0: 650a 7073 6575 646f 6772 6170 6869 6373 e.pseudographics │ │ │ │ +000379e0: 2e0a 0a20 2020 4e6f 6e65 206f 6620 6162 ... None of ab │ │ │ │ +000379f0: 6f76 6520 6d65 6e74 696f 6e65 6420 6973 ove mentioned is │ │ │ │ +00037a00: 2061 7070 726f 7072 6961 7465 2066 6f72 appropriate for │ │ │ │ +00037a10: 2064 6973 706c 6179 696e 6720 696e 7465 displaying inte │ │ │ │ +00037a20: 726e 6174 696f 6e61 6c0a 616e 6420 616e rnational.and an │ │ │ │ +00037a30: 7920 756e 7375 7070 6f72 7465 6420 6368 y unsupported ch │ │ │ │ +00037a40: 6172 6163 7465 7220 6973 2072 6570 6c61 aracter is repla │ │ │ │ +00037a50: 6365 6420 7769 7468 2071 7565 7374 696f ced with questio │ │ │ │ +00037a60: 6e20 6d61 726b 2065 7863 6570 740a 7073 n mark except.ps │ │ │ │ +00037a70: 6575 646f 6772 6170 6869 6373 2077 6869 eudographics whi │ │ │ │ +00037a80: 6368 2077 6520 6174 7465 6d70 7420 746f ch we attempt to │ │ │ │ +00037a90: 2061 7070 726f 7869 6d61 7465 2077 6974 approximate wit │ │ │ │ +00037aa0: 6820 4153 4349 492e 0a0a 2020 2045 4649 h ASCII... EFI │ │ │ │ +00037ab0: 2063 6f6e 736f 6c65 206f 6e20 7468 6520 console on the │ │ │ │ +00037ac0: 6f74 6865 7220 6861 6e64 206e 6f6d 696e other hand nomin │ │ │ │ +00037ad0: 616c 6c79 2073 7570 706f 7274 7320 5554 ally supports UT │ │ │ │ +00037ae0: 462d 3136 2062 7574 2061 6374 7561 6c0a F-16 but actual. │ │ │ │ +00037af0: 6c61 6e67 7561 6765 2063 6f76 6572 6167 language coverag │ │ │ │ +00037b00: 6520 6465 7065 6e64 7320 6f6e 2066 6972 e depends on fir │ │ │ │ +00037b10: 6d77 6172 6520 616e 6420 6d61 7920 6265 mware and may be │ │ │ │ +00037b20: 2076 6572 7920 6c69 6d69 7465 642e 0a0a very limited... │ │ │ │ +00037b30: 2020 2054 6865 2065 6e63 6f64 696e 6720 The encoding │ │ │ │ +00037b40: 7573 6564 206f 6e20 7365 7269 616c 2063 used on serial c │ │ │ │ +00037b50: 616e 2062 6520 6368 6f73 656e 2077 6974 an be chosen wit │ │ │ │ +00037b60: 6820 2774 6572 6d69 6e66 6f27 2061 7320 h 'terminfo' as │ │ │ │ +00037b70: 6569 7468 6572 0a41 5343 4949 2c20 5554 either.ASCII, UT │ │ │ │ +00037b80: 462d 3820 6f72 2022 7669 7375 616c 2055 F-8 or "visual U │ │ │ │ +00037b90: 5446 2d38 222e 2020 4c61 7374 206f 6e65 TF-8". Last one │ │ │ │ +00037ba0: 2069 7320 6167 6169 6e73 7420 7468 6520 is against the │ │ │ │ +00037bb0: 7370 6563 6966 6963 6174 696f 6e0a 6275 specification.bu │ │ │ │ +00037bc0: 7420 7265 7375 6c74 7320 696e 2063 6f72 t results in cor │ │ │ │ +00037bd0: 7265 6374 2072 656e 6465 7269 6e67 206f rect rendering o │ │ │ │ +00037be0: 6620 7269 6768 742d 746f 2d6c 6566 7420 f right-to-left │ │ │ │ +00037bf0: 6f6e 2073 6f6d 6520 7265 6164 6572 7320 on some readers │ │ │ │ +00037c00: 7768 6963 680a 646f 6e27 7420 6861 7665 which.don't have │ │ │ │ +00037c10: 206f 776e 2062 6964 6920 696d 706c 656d own bidi implem │ │ │ │ +00037c20: 656e 7461 7469 6f6e 2e0a 0a20 2020 4f6e entation... On │ │ │ │ +00037c30: 2065 6d75 2047 5255 4220 6368 6563 6b73 emu GRUB checks │ │ │ │ +00037c40: 2069 6620 6368 6172 7365 7420 6973 2055 if charset is U │ │ │ │ +00037c50: 5446 2d38 2061 6e64 2075 7365 7320 6974 TF-8 and uses it │ │ │ │ +00037c60: 2069 6620 736f 2061 6e64 2075 7365 730a if so and uses. │ │ │ │ +00037c70: 4153 4349 4920 6f74 6865 7277 6973 652e ASCII otherwise. │ │ │ │ +00037c80: 0a0a 2020 2057 6865 6e20 7573 696e 6720 .. When using │ │ │ │ +00037c90: 6766 7874 6572 6d20 6f72 2067 6678 6d65 gfxterm or gfxme │ │ │ │ +00037ca0: 6e75 2047 5255 4220 6974 7365 6c66 2069 nu GRUB itself i │ │ │ │ +00037cb0: 7320 7265 7370 6f6e 7369 626c 6520 666f s responsible fo │ │ │ │ +00037cc0: 720a 7265 6e64 6572 696e 6720 7468 6520 r.rendering the │ │ │ │ +00037cd0: 7465 7874 2e20 2049 6e20 7468 6973 2063 text. In this c │ │ │ │ +00037ce0: 6173 6520 4752 5542 2069 7320 6c69 6d69 ase GRUB is limi │ │ │ │ +00037cf0: 7465 6420 6279 206c 6f61 6465 6420 666f ted by loaded fo │ │ │ │ +00037d00: 6e74 732e 2020 4966 0a66 6f6e 7473 2063 nts. If.fonts c │ │ │ │ +00037d10: 6f6e 7461 696e 2061 6c6c 2072 6571 7569 ontain all requi │ │ │ │ +00037d20: 7265 6420 6368 6172 6163 7465 7273 2074 red characters t │ │ │ │ +00037d30: 6865 6e20 6269 6469 7265 6374 696f 6e61 hen bidirectiona │ │ │ │ +00037d40: 6c20 7465 7874 2c20 6375 7273 6976 650a l text, cursive. │ │ │ │ +00037d50: 7661 7269 616e 7473 2061 6e64 2063 6f6d variants and com │ │ │ │ +00037d60: 6269 6e69 6e67 206d 6172 6b73 206f 7468 bining marks oth │ │ │ │ +00037d70: 6572 2074 6861 6e20 656e 636c 6f73 696e er than enclosin │ │ │ │ +00037d80: 672c 2068 616c 6620 2865 2e67 2e20 206c g, half (e.g. l │ │ │ │ +00037d90: 6566 7420 6861 6c66 0a74 696c 6465 206f eft half.tilde o │ │ │ │ +00037da0: 7220 636f 6d62 696e 696e 6720 6f76 6572 r combining over │ │ │ │ +00037db0: 6c69 6e65 2920 616e 6420 646f 7562 6c65 line) and double │ │ │ │ +00037dc0: 206f 6e65 732e 2020 4c69 6761 7475 7265 ones. Ligature │ │ │ │ +00037dd0: 7320 6172 656e 2774 0a73 7570 706f 7274 s aren't.support │ │ │ │ +00037de0: 6564 2074 686f 7567 682e 2020 5468 6973 ed though. This │ │ │ │ +00037df0: 2073 686f 756c 6420 636f 7665 7220 4575 should cover Eu │ │ │ │ +00037e00: 726f 7065 616e 2c20 4d69 6464 6c65 2045 ropean, Middle E │ │ │ │ +00037e10: 6173 7465 726e 2028 6966 2079 6f75 0a64 astern (if you.d │ │ │ │ +00037e20: 6f6e 2774 206d 696e 6420 6c61 636b 206f on't mind lack o │ │ │ │ +00037e30: 6620 6c61 6d2d 616c 6966 206c 6967 6174 f lam-alif ligat │ │ │ │ +00037e40: 7572 6520 696e 2041 7261 6269 6329 2061 ure in Arabic) a │ │ │ │ +00037e50: 6e64 2045 6173 7420 4173 6961 6e20 7363 nd East Asian sc │ │ │ │ +00037e60: 7269 7074 732e 0a4e 6f74 6162 6c65 2075 ripts..Notable u │ │ │ │ +00037e70: 6e73 7570 706f 7274 6564 2073 6372 6970 nsupported scrip │ │ │ │ +00037e80: 7473 2061 7265 2042 7261 686d 6963 2066 ts are Brahmic f │ │ │ │ +00037e90: 616d 696c 7920 616e 6420 6465 7269 7665 amily and derive │ │ │ │ +00037ea0: 6420 6173 2077 656c 6c20 6173 0a4d 6f6e d as well as.Mon │ │ │ │ +00037eb0: 676f 6c69 616e 2c20 5469 6669 6e61 6768 golian, Tifinagh │ │ │ │ +00037ec0: 2c20 4b6f 7265 616e 204a 616d 6f20 2870 , Korean Jamo (p │ │ │ │ +00037ed0: 7265 636f 6d70 6f73 6564 2063 6861 7261 recomposed chara │ │ │ │ +00037ee0: 6374 6572 7320 6861 7665 206e 6f0a 7072 cters have no.pr │ │ │ │ +00037ef0: 6f62 6c65 6d29 2061 6e64 2074 6f6e 616c oblem) and tonal │ │ │ │ +00037f00: 2077 7269 7469 6e67 2028 3265 352d 3265 writing (2e5-2e │ │ │ │ +00037f10: 3929 2e20 2047 5255 4220 616c 736f 2069 9). GRUB also i │ │ │ │ +00037f20: 676e 6f72 6573 2064 6570 7265 6361 7465 gnores deprecate │ │ │ │ +00037f30: 6420 2861 730a 7370 6563 6966 6965 6420 d (as.specified │ │ │ │ +00037f40: 696e 2055 6e69 636f 6465 2920 6368 6172 in Unicode) char │ │ │ │ +00037f50: 6163 7465 7273 2028 652e 672e 2020 7461 acters (e.g. ta │ │ │ │ +00037f60: 6773 292e 2020 4752 5542 2061 6c73 6f20 gs). GRUB also │ │ │ │ +00037f70: 646f 6573 6e27 7420 6861 6e64 6c65 0a73 doesn't handle.s │ │ │ │ +00037f80: 6f20 6361 6c6c 6564 2022 616e 6e6f 7461 o called "annota │ │ │ │ +00037f90: 7469 6f6e 2063 6861 7261 6374 6572 7322 tion characters" │ │ │ │ +00037fa0: 2049 6620 796f 7520 6361 6e20 636f 6d70 If you can comp │ │ │ │ +00037fb0: 6c65 7465 2065 6974 6865 7220 6f66 2074 lete either of t │ │ │ │ +00037fc0: 776f 0a6c 6973 7473 206f 722c 2062 6574 wo.lists or, bet │ │ │ │ +00037fd0: 7465 722c 2070 726f 706f 7365 2061 2070 ter, propose a p │ │ │ │ +00037fe0: 6174 6368 2074 6f20 696d 7072 6f76 6520 atch to improve │ │ │ │ +00037ff0: 7265 6e64 6572 696e 672c 2070 6c65 6173 rendering, pleas │ │ │ │ +00038000: 6520 636f 6e74 6163 740a 6465 7665 6c6f e contact.develo │ │ │ │ +00038010: 7065 7220 7465 616d 2e0a 0a31 372e 3420 per team...17.4 │ │ │ │ +00038020: 496e 7075 7420 7465 726d 696e 616c 0a3d Input terminal.= │ │ │ │ +00038030: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ +00038040: 3d3d 0a0a 4669 726d 7761 7265 2063 6f6e ==..Firmware con │ │ │ │ +00038050: 736f 6c65 206f 6e20 4249 4f53 2c20 4945 sole on BIOS, IE │ │ │ │ +00038060: 4545 3132 3735 2061 6e64 2041 5243 2064 EE1275 and ARC d │ │ │ │ +00038070: 6f65 736e 2774 2061 6c6c 6f77 2079 6f75 oesn't allow you │ │ │ │ +00038080: 2074 6f20 656e 7465 720a 6e6f 6e2d 4153 to enter.non-AS │ │ │ │ +00038090: 4349 4920 6368 6172 6163 7465 7273 2e20 CII characters. │ │ │ │ +000380a0: 2045 4649 2073 7065 6369 6669 6361 7469 EFI specificati │ │ │ │ +000380b0: 6f6e 2061 6c6c 6f77 7320 666f 7220 7375 on allows for su │ │ │ │ +000380c0: 6368 2062 7574 2061 7574 686f 7220 6973 ch but author is │ │ │ │ +000380d0: 0a75 6e61 7761 7265 206f 6620 616e 7920 .unaware of any │ │ │ │ +000380e0: 6163 7475 616c 2069 6d70 6c65 6d65 6e74 actual implement │ │ │ │ +000380f0: 6174 696f 6e73 2e20 2053 6572 6961 6c20 ations. Serial │ │ │ │ +00038100: 696e 7075 7420 6973 2063 7572 7265 6e74 input is current │ │ │ │ +00038110: 6c79 0a6c 696d 6974 6564 2066 6f72 206c ly.limited for l │ │ │ │ +00038120: 6174 696e 3120 2875 6e6c 696b 656c 7920 atin1 (unlikely │ │ │ │ +00038130: 746f 2063 6861 6e67 6529 2e20 204f 776e to change). Own │ │ │ │ +00038140: 206b 6579 626f 6172 6420 696d 706c 656d keyboard implem │ │ │ │ +00038150: 656e 7461 7469 6f6e 730a 2861 745f 6b65 entations.(at_ke │ │ │ │ +00038160: 7962 6f61 7264 2061 6e64 2075 7362 5f6b yboard and usb_k │ │ │ │ +00038170: 6579 626f 6172 6429 2073 7570 706f 7274 eyboard) support │ │ │ │ +00038180: 7320 616e 7920 6b65 7920 6275 7420 776f s any key but wo │ │ │ │ +00038190: 726b 206f 6e0a 6f6e 652d 6368 6172 2d70 rk on.one-char-p │ │ │ │ +000381a0: 6572 2d6b 6579 7374 726f 6b65 2e20 2053 er-keystroke. S │ │ │ │ +000381b0: 6f20 6e6f 2064 6561 6420 6b65 7973 206f o no dead keys o │ │ │ │ +000381c0: 7220 6164 7661 6e63 6564 2069 6e70 7574 r advanced input │ │ │ │ +000381d0: 206d 6574 686f 642e 2020 416c 736f 0a74 method. Also.t │ │ │ │ +000381e0: 6865 7265 2069 7320 6e6f 206b 6579 6d61 here is no keyma │ │ │ │ +000381f0: 7020 6368 616e 6765 2068 6f74 6b65 792e p change hotkey. │ │ │ │ +00038200: 2020 496e 2070 7261 6374 6963 6520 6974 In practice it │ │ │ │ +00038210: 206d 616b 6573 2064 6966 6669 6375 6c74 makes difficult │ │ │ │ +00038220: 2074 6f0a 656e 7465 7220 616e 7920 7465 to.enter any te │ │ │ │ +00038230: 7874 2075 7369 6e67 206e 6f6e 2d4c 6174 xt using non-Lat │ │ │ │ +00038240: 696e 2061 6c70 6861 6265 742e 2020 4d6f in alphabet. Mo │ │ │ │ +00038250: 7265 6f76 6572 2061 6c6c 2063 7572 7265 reover all curre │ │ │ │ +00038260: 6e74 2069 6e70 7574 0a63 6f6e 7375 6d65 nt input.consume │ │ │ │ +00038270: 7273 2061 7265 206c 696d 6974 6564 2074 rs are limited t │ │ │ │ +00038280: 6f20 4153 4349 492e 0a0a 3137 2e35 2047 o ASCII...17.5 G │ │ │ │ +00038290: 6574 7465 7874 0a3d 3d3d 3d3d 3d3d 3d3d ettext.========= │ │ │ │ +000382a0: 3d3d 3d0a 0a47 5255 4220 7375 7070 6f72 ===..GRUB suppor │ │ │ │ +000382b0: 7473 2062 6569 6e67 2074 7261 6e73 6c61 ts being transla │ │ │ │ +000382c0: 7465 642e 2020 466f 7220 7468 6973 2079 ted. For this y │ │ │ │ +000382d0: 6f75 206e 6565 6420 746f 2068 6176 6520 ou need to have │ │ │ │ +000382e0: 6c61 6e67 7561 6765 202a 2e6d 6f0a 6669 language *.mo.fi │ │ │ │ +000382f0: 6c65 7320 696e 2024 7072 6566 6978 2f6c les in $prefix/l │ │ │ │ +00038300: 6f63 616c 652c 206c 6f61 6420 6765 7474 ocale, load gett │ │ │ │ +00038310: 6578 7420 6d6f 6475 6c65 2061 6e64 2073 ext module and s │ │ │ │ +00038320: 6574 2022 6c61 6e67 2220 7661 7269 6162 et "lang" variab │ │ │ │ +00038330: 6c65 2e0a 0a31 372e 3620 5265 6765 7870 le...17.6 Regexp │ │ │ │ +00038340: 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a 5265 .===========..Re │ │ │ │ +00038350: 6765 7870 7320 776f 726b 206f 6e20 756e gexps work on un │ │ │ │ +00038360: 6963 6f64 6520 6368 6172 6163 7465 7273 icode characters │ │ │ │ +00038370: 2c20 686f 7765 7665 7220 6e6f 2061 7474 , however no att │ │ │ │ +00038380: 656d 7074 2061 7420 6368 6563 6b69 6e67 empt at checking │ │ │ │ +00038390: 0a63 616e 6e6f 6e69 6361 6c20 6571 7569 .cannonical equi │ │ │ │ +000383a0: 7661 6c65 6e63 6520 6861 7320 6265 656e valence has been │ │ │ │ +000383b0: 206d 6164 652e 2020 4d6f 7265 6f76 6572 made. Moreover │ │ │ │ +000383c0: 2074 6865 2063 6c61 7373 6573 206c 696b the classes lik │ │ │ │ +000383d0: 650a 5b3a 616c 7068 613a 5d20 6d61 7463 e.[:alpha:] matc │ │ │ │ +000383e0: 6820 6f6e 6c79 2041 5343 4949 2073 7562 h only ASCII sub │ │ │ │ +000383f0: 7365 742e 0a0a 3137 2e37 204f 7468 6572 set...17.7 Other │ │ │ │ +00038400: 0a3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a43 7572 .==========..Cur │ │ │ │ +00038410: 7265 6e74 6c79 2047 5255 4220 616c 7761 rently GRUB alwa │ │ │ │ +00038420: 7973 2075 7365 7320 5945 4152 2d4d 4f4e ys uses YEAR-MON │ │ │ │ +00038430: 5448 2d44 4159 2048 4f55 523a 4d49 4e55 TH-DAY HOUR:MINU │ │ │ │ +00038440: 5445 3a53 4543 4f4e 4420 5b57 4545 4b44 TE:SECOND [WEEKD │ │ │ │ +00038450: 4159 5d0a 3234 2d68 6f75 7220 6461 7465 AY].24-hour date │ │ │ │ +00038460: 7469 6d65 2066 6f72 6d61 7420 6275 7420 time format but │ │ │ │ +00038470: 7765 656b 6461 7973 2061 7265 2074 7261 weekdays are tra │ │ │ │ +00038480: 6e73 6c61 7465 642e 2020 4752 5542 2061 nslated. GRUB a │ │ │ │ +00038490: 6c77 6179 7320 7573 6573 0a74 6865 2064 lways uses.the d │ │ │ │ +000384a0: 6563 696d 616c 206e 756d 6265 7220 666f ecimal number fo │ │ │ │ +000384b0: 726d 6174 2077 6974 6820 5b30 2d39 5d20 rmat with [0-9] │ │ │ │ +000384c0: 6173 2064 6967 6974 7320 616e 6420 2e20 as digits and . │ │ │ │ +000384d0: 2061 7320 6465 7363 696d 616c 0a73 6570 as descimal.sep │ │ │ │ +000384e0: 6172 6174 6f72 2061 6e64 206e 6f20 6772 arator and no gr │ │ │ │ +000384f0: 6f75 7020 7365 7061 7261 746f 722e 2020 oup separator. │ │ │ │ +00038500: 4945 4545 3132 3735 2061 6c69 6173 6573 IEEE1275 aliases │ │ │ │ +00038510: 2061 7265 206d 6174 6368 6564 0a63 6173 are matched.cas │ │ │ │ +00038520: 652d 696e 7365 6e73 6974 6976 656c 7920 e-insensitively │ │ │ │ +00038530: 6578 6365 7074 206e 6f6e 2d41 5343 4949 except non-ASCII │ │ │ │ +00038540: 2077 6869 6368 2069 7320 6d61 7463 6865 which is matche │ │ │ │ +00038550: 6420 6173 2062 696e 6172 792e 2020 5369 d as binary. Si │ │ │ │ +00038560: 6d69 6c61 720a 6265 6861 7669 6f75 7220 milar.behaviour │ │ │ │ +00038570: 6973 2066 6f72 206d 6174 6368 696e 6720 is for matching │ │ │ │ +00038580: 4f53 4275 6e64 6c65 5265 7175 6972 6564 OSBundleRequired │ │ │ │ +00038590: 2e20 2053 696e 6365 2049 4545 4531 3237 . Since IEEE127 │ │ │ │ +000385a0: 3520 616c 6961 7365 7320 616e 640a 4f53 5 aliases and.OS │ │ │ │ +000385b0: 4275 6e64 6c65 5265 7175 6972 6564 2064 BundleRequired d │ │ │ │ +000385c0: 6f6e 2774 2063 6f6e 7461 696e 2061 6e79 on't contain any │ │ │ │ +000385d0: 206e 6f6e 2d41 5343 4949 2069 7420 7368 non-ASCII it sh │ │ │ │ +000385e0: 6f75 6c64 206e 6576 6572 2062 6520 610a ould never be a. │ │ │ │ +000385f0: 7072 6f62 6c65 6d20 696e 2070 7261 6374 problem in pract │ │ │ │ +00038600: 6963 652e 2020 4361 7365 2d73 656e 7369 ice. Case-sensi │ │ │ │ +00038610: 7469 7665 2069 6465 6e74 6966 6965 7273 tive identifiers │ │ │ │ +00038620: 2061 7265 206d 6174 6368 6564 2061 7320 are matched as │ │ │ │ +00038630: 7261 770a 7374 7269 6e67 732c 206e 6f20 raw.strings, no │ │ │ │ +00038640: 6361 6e6f 6e69 6361 6c20 6571 7569 7661 canonical equiva │ │ │ │ +00038650: 6c65 6e63 6520 6368 6563 6b20 6973 2070 lence check is p │ │ │ │ +00038660: 6572 666f 726d 6564 2e20 2043 6173 652d erformed. Case- │ │ │ │ +00038670: 696e 7365 6e73 7469 7665 0a69 6465 6e74 insenstive.ident │ │ │ │ +00038680: 6966 6965 7273 2061 7265 206d 6174 6368 ifiers are match │ │ │ │ +00038690: 6564 2061 7320 5241 5720 6275 7420 6164 ed as RAW but ad │ │ │ │ +000386a0: 6469 7469 6f6e 616c 6c79 205b 612d 7a5d ditionally [a-z] │ │ │ │ +000386b0: 2069 7320 6571 7569 7661 6c65 6e74 2074 is equivalent t │ │ │ │ +000386c0: 6f0a 5b41 2d5a 5d2e 2047 5255 422d 6465 o.[A-Z]. GRUB-de │ │ │ │ +000386d0: 6669 6e65 6420 6964 656e 7469 6669 6572 fined identifier │ │ │ │ +000386e0: 7320 7573 6520 6f6e 6c79 2041 5343 4949 s use only ASCII │ │ │ │ +000386f0: 2061 6e64 2073 6f20 7368 6f75 6c64 0a75 and so should.u │ │ │ │ +00038700: 7365 722d 6465 6669 6e65 6420 6f6e 6573 ser-defined ones │ │ │ │ +00038710: 2e20 2049 6465 6e74 6966 6965 7273 2063 . Identifiers c │ │ │ │ +00038720: 6f6e 7461 696e 696e 6720 6e6f 6e2d 4153 ontaining non-AS │ │ │ │ +00038730: 4349 4920 6d61 7920 776f 726b 2062 7574 CII may work but │ │ │ │ +00038740: 2061 7265 6e27 740a 7375 7070 6f72 7465 aren't.supporte │ │ │ │ +00038750: 642e 2020 4f6e 6c79 2074 6865 2041 5343 d. Only the ASC │ │ │ │ +00038760: 4949 2073 7061 6365 2063 6861 7261 6374 II space charact │ │ │ │ +00038770: 6572 7320 2873 7061 6365 2055 2b30 3032 ers (space U+002 │ │ │ │ +00038780: 302c 2074 6162 2055 2b30 3030 622c 0a43 0, tab U+000b,.C │ │ │ │ +00038790: 5220 552b 3030 3064 2061 6e64 204c 4620 R U+000d and LF │ │ │ │ +000387a0: 552b 3030 3061 2920 6172 6520 7265 636f U+000a) are reco │ │ │ │ +000387b0: 676e 6973 6564 2e20 204f 7468 6572 2075 gnised. Other u │ │ │ │ +000387c0: 6e69 636f 6465 2073 7061 6365 2063 6861 nicode space cha │ │ │ │ +000387d0: 7261 6374 6572 730a 6172 656e 2774 2061 racters.aren't a │ │ │ │ +000387e0: 2076 616c 6964 2066 6965 6c64 2073 6570 valid field sep │ │ │ │ +000387f0: 6172 6174 6f72 2e20 2027 7465 7374 2720 arator. 'test' │ │ │ │ +00038800: 282a 6e6f 7465 2074 6573 743a 3a29 2074 (*note test::) t │ │ │ │ +00038810: 6573 7473 203c 2c20 3e2c 203c 3d2c 0a3e ests <, >, <=,.> │ │ │ │ +00038820: 3d2c 202d 7067 7420 616e 6420 2d70 6c74 =, -pgt and -plt │ │ │ │ +00038830: 2063 6f6d 7061 7265 2074 6865 2073 7472 compare the str │ │ │ │ +00038840: 696e 6773 2069 6e20 7468 6520 6c65 7869 ings in the lexi │ │ │ │ +00038850: 636f 6772 6170 6869 6361 6c20 6f72 6465 cographical orde │ │ │ │ +00038860: 7220 6f66 0a75 6e69 636f 6465 2063 6f64 r of.unicode cod │ │ │ │ +00038870: 6570 6f69 6e74 732c 2072 6570 6c69 6361 epoints, replica │ │ │ │ +00038880: 7469 6e67 2074 6865 2062 6568 6176 696f ting the behavio │ │ │ │ +00038890: 7572 206f 6620 7465 7374 2066 726f 6d20 ur of test from │ │ │ │ +000388a0: 636f 7265 7574 696c 732e 0a65 6e76 6972 coreutils..envir │ │ │ │ +000388b0: 6f6e 6d65 6e74 2076 6172 6961 626c 6573 onment variables │ │ │ │ +000388c0: 2061 6e64 2063 6f6d 6d61 6e64 7320 6172 and commands ar │ │ │ │ +000388d0: 6520 6c69 7374 6564 2069 6e20 7468 6520 e listed in the │ │ │ │ +000388e0: 7361 6d65 206f 7264 6572 2e0a 0a1f 0a46 same order.....F │ │ │ │ +000388f0: 696c 653a 2067 7275 622e 696e 666f 2c20 ile: grub.info, │ │ │ │ +00038900: 204e 6f64 653a 2053 6563 7572 6974 792c Node: Security, │ │ │ │ +00038910: 2020 4e65 7874 3a20 506c 6174 666f 726d Next: Platform │ │ │ │ +00038920: 206c 696d 6974 6174 696f 6e73 2c20 2050 limitations, P │ │ │ │ +00038930: 7265 763a 2049 6e74 6572 6e61 7469 6f6e rev: Internation │ │ │ │ +00038940: 616c 6973 6174 696f 6e2c 2020 5570 3a20 alisation, Up: │ │ │ │ +00038950: 546f 700a 0a31 3820 5365 6375 7269 7479 Top..18 Security │ │ │ │ +00038960: 0a2a 2a2a 2a2a 2a2a 2a2a 2a2a 0a0a 2a20 .***********..* │ │ │ │ +00038970: 4d65 6e75 3a0a 0a2a 2041 7574 6865 6e74 Menu:..* Authent │ │ │ │ +00038980: 6963 6174 696f 6e20 616e 6420 6175 7468 ication and auth │ │ │ │ +00038990: 6f72 6973 6174 696f 6e3a 3a20 5573 6572 orisation:: User │ │ │ │ +000389a0: 7320 616e 6420 6163 6365 7373 2063 6f6e s and access con │ │ │ │ +000389b0: 7472 6f6c 0a2a 2055 7369 6e67 2064 6967 trol.* Using dig │ │ │ │ +000389c0: 6974 616c 2073 6967 6e61 7475 7265 733a ital signatures: │ │ │ │ +000389d0: 3a20 2020 2020 2020 2020 426f 6f74 696e : Bootin │ │ │ │ +000389e0: 6720 6469 6769 7461 6c6c 7920 7369 676e g digitally sign │ │ │ │ +000389f0: 6564 2063 6f64 650a 2a20 5545 4649 2073 ed code.* UEFI s │ │ │ │ +00038a00: 6563 7572 6520 626f 6f74 2061 6e64 2073 ecure boot and s │ │ │ │ +00038a10: 6869 6d3a 3a20 2020 2020 2020 2042 6f6f him:: Boo │ │ │ │ +00038a20: 7469 6e67 2064 6967 6974 616c 6c79 2073 ting digitally s │ │ │ │ +00038a30: 6967 6e65 6420 5045 2066 696c 6573 0a2a igned PE files.* │ │ │ │ +00038a40: 2053 6563 7572 6520 426f 6f74 2041 6476 Secure Boot Adv │ │ │ │ +00038a50: 616e 6365 6420 5461 7267 6574 696e 673a anced Targeting: │ │ │ │ +00038a60: 3a20 2020 456d 6265 6464 6564 2069 6e66 : Embedded inf │ │ │ │ +00038a70: 6f72 6d61 7469 6f6e 2066 6f72 2067 656e ormation for gen │ │ │ │ +00038a80: 6572 6174 696f 6e20 6e75 6d62 6572 2062 eration number b │ │ │ │ +00038a90: 6173 6564 2072 6576 6f63 6174 696f 6e0a ased revocation. │ │ │ │ +00038aa0: 2a20 4d65 6173 7572 6564 2042 6f6f 743a * Measured Boot: │ │ │ │ +00038ab0: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ +00038ac0: 2020 2020 204d 6561 7375 7269 6e67 2062 Measuring b │ │ │ │ +00038ad0: 6f6f 7420 636f 6d70 6f6e 656e 7473 0a2a oot components.* │ │ │ │ +00038ae0: 204c 6f63 6b64 6f77 6e3a 3a20 2020 2020 Lockdown:: │ │ │ │ 00038af0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00038b00: 4c6f 636b 646f 776e 2077 6865 6e20 626f Lockdown when bo │ │ │ │ -00038b10: 6f74 696e 6720 6f6e 2061 2073 6563 7572 oting on a secur │ │ │ │ -00038b20: 6520 7365 7475 700a 0a1f 0a46 696c 653a e setup....File: │ │ │ │ -00038b30: 2067 7275 622e 696e 666f 2c20 204e 6f64 grub.info, Nod │ │ │ │ -00038b40: 653a 2041 7574 6865 6e74 6963 6174 696f e: Authenticatio │ │ │ │ -00038b50: 6e20 616e 6420 6175 7468 6f72 6973 6174 n and authorisat │ │ │ │ -00038b60: 696f 6e2c 2020 4e65 7874 3a20 5573 696e ion, Next: Usin │ │ │ │ -00038b70: 6720 6469 6769 7461 6c20 7369 676e 6174 g digital signat │ │ │ │ -00038b80: 7572 6573 2c20 2055 703a 2053 6563 7572 ures, Up: Secur │ │ │ │ -00038b90: 6974 790a 0a31 382e 3120 4175 7468 656e ity..18.1 Authen │ │ │ │ -00038ba0: 7469 6361 7469 6f6e 2061 6e64 2061 7574 tication and aut │ │ │ │ -00038bb0: 686f 7269 7361 7469 6f6e 2069 6e20 4752 horisation in GR │ │ │ │ -00038bc0: 5542 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d UB.============= │ │ │ │ +00038b00: 2020 2020 4c6f 636b 646f 776e 2077 6865 Lockdown whe │ │ │ │ +00038b10: 6e20 626f 6f74 696e 6720 6f6e 2061 2073 n booting on a s │ │ │ │ +00038b20: 6563 7572 6520 7365 7475 700a 0a1f 0a46 ecure setup....F │ │ │ │ +00038b30: 696c 653a 2067 7275 622e 696e 666f 2c20 ile: grub.info, │ │ │ │ +00038b40: 204e 6f64 653a 2041 7574 6865 6e74 6963 Node: Authentic │ │ │ │ +00038b50: 6174 696f 6e20 616e 6420 6175 7468 6f72 ation and author │ │ │ │ +00038b60: 6973 6174 696f 6e2c 2020 4e65 7874 3a20 isation, Next: │ │ │ │ +00038b70: 5573 696e 6720 6469 6769 7461 6c20 7369 Using digital si │ │ │ │ +00038b80: 676e 6174 7572 6573 2c20 2055 703a 2053 gnatures, Up: S │ │ │ │ +00038b90: 6563 7572 6974 790a 0a31 382e 3120 4175 ecurity..18.1 Au │ │ │ │ +00038ba0: 7468 656e 7469 6361 7469 6f6e 2061 6e64 thentication and │ │ │ │ +00038bb0: 2061 7574 686f 7269 7361 7469 6f6e 2069 authorisation i │ │ │ │ +00038bc0: 6e20 4752 5542 0a3d 3d3d 3d3d 3d3d 3d3d n GRUB.========= │ │ │ │ 00038bd0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ 00038be0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ -00038bf0: 0a0a 4279 2064 6566 6175 6c74 2c20 7468 ..By default, th │ │ │ │ -00038c00: 6520 626f 6f74 206c 6f61 6465 7220 696e e boot loader in │ │ │ │ -00038c10: 7465 7266 6163 6520 6973 2061 6363 6573 terface is acces │ │ │ │ -00038c20: 7369 626c 6520 746f 2061 6e79 6f6e 6520 sible to anyone │ │ │ │ -00038c30: 7769 7468 0a70 6879 7369 6361 6c20 6163 with.physical ac │ │ │ │ -00038c40: 6365 7373 2074 6f20 7468 6520 636f 6e73 cess to the cons │ │ │ │ -00038c50: 6f6c 653a 2061 6e79 6f6e 6520 6361 6e20 ole: anyone can │ │ │ │ -00038c60: 7365 6c65 6374 2061 6e64 2065 6469 7420 select and edit │ │ │ │ -00038c70: 616e 7920 6d65 6e75 0a65 6e74 7279 2c20 any menu.entry, │ │ │ │ -00038c80: 616e 6420 616e 796f 6e65 2063 616e 2067 and anyone can g │ │ │ │ -00038c90: 6574 2064 6972 6563 7420 6163 6365 7373 et direct access │ │ │ │ -00038ca0: 2074 6f20 6120 4752 5542 2073 6865 6c6c to a GRUB shell │ │ │ │ -00038cb0: 2070 726f 6d70 742e 2020 466f 720a 6d6f prompt. For.mo │ │ │ │ -00038cc0: 7374 2073 7973 7465 6d73 2c20 7468 6973 st systems, this │ │ │ │ -00038cd0: 2069 7320 7265 6173 6f6e 6162 6c65 2073 is reasonable s │ │ │ │ -00038ce0: 696e 6365 2061 6e79 6f6e 6520 7769 7468 ince anyone with │ │ │ │ -00038cf0: 2064 6972 6563 7420 7068 7973 6963 616c direct physical │ │ │ │ -00038d00: 0a61 6363 6573 7320 6861 7320 6120 7661 .access has a va │ │ │ │ -00038d10: 7269 6574 7920 6f66 206f 7468 6572 2077 riety of other w │ │ │ │ -00038d20: 6179 7320 746f 2067 6169 6e20 6675 6c6c ays to gain full │ │ │ │ -00038d30: 2061 6363 6573 732c 2061 6e64 2072 6571 access, and req │ │ │ │ -00038d40: 7569 7269 6e67 0a61 7574 6865 6e74 6963 uiring.authentic │ │ │ │ -00038d50: 6174 696f 6e20 6174 2074 6865 2062 6f6f ation at the boo │ │ │ │ -00038d60: 7420 6c6f 6164 6572 206c 6576 656c 2077 t loader level w │ │ │ │ -00038d70: 6f75 6c64 206f 6e6c 7920 7365 7276 6520 ould only serve │ │ │ │ -00038d80: 746f 206d 616b 6520 6974 0a64 6966 6669 to make it.diffi │ │ │ │ -00038d90: 6375 6c74 2074 6f20 7265 636f 7665 7220 cult to recover │ │ │ │ -00038da0: 6272 6f6b 656e 2073 7973 7465 6d73 2e0a broken systems.. │ │ │ │ -00038db0: 0a20 2020 486f 7765 7665 722c 2069 6e20 . However, in │ │ │ │ -00038dc0: 736f 6d65 2065 6e76 6972 6f6e 6d65 6e74 some environment │ │ │ │ -00038dd0: 732c 2073 7563 6820 6173 206b 696f 736b s, such as kiosk │ │ │ │ -00038de0: 732c 2069 7420 6d61 7920 6265 2061 7070 s, it may be app │ │ │ │ -00038df0: 726f 7072 6961 7465 0a74 6f20 6c6f 636b ropriate.to lock │ │ │ │ -00038e00: 2064 6f77 6e20 7468 6520 626f 6f74 206c down the boot l │ │ │ │ -00038e10: 6f61 6465 7220 746f 2072 6571 7569 7265 oader to require │ │ │ │ -00038e20: 2061 7574 6865 6e74 6963 6174 696f 6e20 authentication │ │ │ │ -00038e30: 6265 666f 7265 2070 6572 666f 726d 696e before performin │ │ │ │ -00038e40: 670a 6365 7274 6169 6e20 6f70 6572 6174 g.certain operat │ │ │ │ -00038e50: 696f 6e73 2e0a 0a20 2020 5468 6520 2770 ions... The 'p │ │ │ │ -00038e60: 6173 7377 6f72 6427 2028 2a6e 6f74 6520 assword' (*note │ │ │ │ -00038e70: 7061 7373 776f 7264 3a3a 2920 616e 6420 password::) and │ │ │ │ -00038e80: 2770 6173 7377 6f72 645f 7062 6b64 6632 'password_pbkdf2 │ │ │ │ -00038e90: 2720 282a 6e6f 7465 0a70 6173 7377 6f72 ' (*note.passwor │ │ │ │ -00038ea0: 645f 7062 6b64 6632 3a3a 2920 636f 6d6d d_pbkdf2::) comm │ │ │ │ -00038eb0: 616e 6473 2063 616e 2062 6520 7573 6564 ands can be used │ │ │ │ -00038ec0: 2074 6f20 6465 6669 6e65 2075 7365 7273 to define users │ │ │ │ -00038ed0: 2c20 6561 6368 206f 6620 7768 6963 680a , each of which. │ │ │ │ -00038ee0: 6861 7320 616e 2061 7373 6f63 6961 7465 has an associate │ │ │ │ -00038ef0: 6420 7061 7373 776f 7264 2e20 2027 7061 d password. 'pa │ │ │ │ -00038f00: 7373 776f 7264 2720 7365 7473 2074 6865 ssword' sets the │ │ │ │ -00038f10: 2070 6173 7377 6f72 6420 696e 2070 6c61 password in pla │ │ │ │ -00038f20: 696e 2074 6578 742c 0a72 6571 7569 7269 in text,.requiri │ │ │ │ -00038f30: 6e67 2027 6772 7562 2e63 6667 2720 746f ng 'grub.cfg' to │ │ │ │ -00038f40: 2062 6520 7365 6375 7265 3b20 2770 6173 be secure; 'pas │ │ │ │ -00038f50: 7377 6f72 645f 7062 6b64 6632 2720 7365 sword_pbkdf2' se │ │ │ │ -00038f60: 7473 2074 6865 2070 6173 7377 6f72 640a ts the password. │ │ │ │ -00038f70: 6861 7368 6564 2075 7369 6e67 2074 6865 hashed using the │ │ │ │ -00038f80: 2050 6173 7377 6f72 642d 4261 7365 6420 Password-Based │ │ │ │ -00038f90: 4b65 7920 4465 7269 7661 7469 6f6e 2046 Key Derivation F │ │ │ │ -00038fa0: 756e 6374 696f 6e20 2852 4643 2032 3839 unction (RFC 289 │ │ │ │ -00038fb0: 3829 2c0a 7265 7175 6972 696e 6720 7468 8),.requiring th │ │ │ │ -00038fc0: 6520 7573 6520 6f66 2027 6772 7562 2d6d e use of 'grub-m │ │ │ │ -00038fd0: 6b70 6173 7377 642d 7062 6b64 6632 2720 kpasswd-pbkdf2' │ │ │ │ -00038fe0: 282a 6e6f 7465 2049 6e76 6f6b 696e 670a (*note Invoking. │ │ │ │ -00038ff0: 6772 7562 2d6d 6b70 6173 7377 642d 7062 grub-mkpasswd-pb │ │ │ │ -00039000: 6b64 6632 3a3a 2920 746f 2067 656e 6572 kdf2::) to gener │ │ │ │ -00039010: 6174 6520 7061 7373 776f 7264 2068 6173 ate password has │ │ │ │ -00039020: 6865 732e 0a0a 2020 2049 6e20 6f72 6465 hes... In orde │ │ │ │ -00039030: 7220 746f 2065 6e61 626c 6520 6175 7468 r to enable auth │ │ │ │ -00039040: 656e 7469 6361 7469 6f6e 2073 7570 706f entication suppo │ │ │ │ -00039050: 7274 2c20 7468 6520 2773 7570 6572 7573 rt, the 'superus │ │ │ │ -00039060: 6572 7327 0a65 6e76 6972 6f6e 6d65 6e74 ers'.environment │ │ │ │ -00039070: 2076 6172 6961 626c 6520 6d75 7374 2062 variable must b │ │ │ │ -00039080: 6520 7365 7420 746f 2061 206c 6973 7420 e set to a list │ │ │ │ -00039090: 6f66 2075 7365 726e 616d 6573 2c20 7365 of usernames, se │ │ │ │ -000390a0: 7061 7261 7465 6420 6279 0a61 6e79 206f parated by.any o │ │ │ │ -000390b0: 6620 7370 6163 6573 2c20 636f 6d6d 6173 f spaces, commas │ │ │ │ -000390c0: 2c20 7365 6d69 636f 6c6f 6e73 2c20 7069 , semicolons, pi │ │ │ │ -000390d0: 7065 732c 206f 7220 616d 7065 7273 616e pes, or ampersan │ │ │ │ -000390e0: 6473 2e20 2053 7570 6572 7573 6572 7320 ds. Superusers │ │ │ │ -000390f0: 6172 650a 7065 726d 6974 7465 6420 746f are.permitted to │ │ │ │ -00039100: 2075 7365 2074 6865 2047 5255 4220 636f use the GRUB co │ │ │ │ -00039110: 6d6d 616e 6420 6c69 6e65 2c20 6564 6974 mmand line, edit │ │ │ │ -00039120: 206d 656e 7520 656e 7472 6965 732c 2061 menu entries, a │ │ │ │ -00039130: 6e64 2065 7865 6375 7465 0a61 6e79 206d nd execute.any m │ │ │ │ -00039140: 656e 7520 656e 7472 792e 2020 4966 2027 enu entry. If ' │ │ │ │ -00039150: 7375 7065 7275 7365 7273 2720 6973 2073 superusers' is s │ │ │ │ -00039160: 6574 2c20 7468 656e 2075 7365 206f 6620 et, then use of │ │ │ │ -00039170: 7468 6520 636f 6d6d 616e 6420 6c69 6e65 the command line │ │ │ │ -00039180: 0a61 6e64 2065 6469 7469 6e67 206f 6620 .and editing of │ │ │ │ -00039190: 6d65 6e75 2065 6e74 7269 6573 2061 7265 menu entries are │ │ │ │ -000391a0: 2061 7574 6f6d 6174 6963 616c 6c79 2072 automatically r │ │ │ │ -000391b0: 6573 7472 6963 7465 6420 746f 2073 7570 estricted to sup │ │ │ │ -000391c0: 6572 7573 6572 732e 0a53 6574 7469 6e67 erusers..Setting │ │ │ │ -000391d0: 2027 7375 7065 7275 7365 7273 2720 746f 'superusers' to │ │ │ │ -000391e0: 2065 6d70 7479 2073 7472 696e 6720 6566 empty string ef │ │ │ │ -000391f0: 6665 6374 6976 656c 7920 6469 7361 626c fectively disabl │ │ │ │ -00039200: 6573 2062 6f74 6820 6163 6365 7373 2074 es both access t │ │ │ │ -00039210: 6f0a 434c 4920 616e 6420 6564 6974 696e o.CLI and editin │ │ │ │ -00039220: 6720 6f66 206d 656e 7520 656e 7472 6965 g of menu entrie │ │ │ │ -00039230: 732e 0a0a 2020 204f 7468 6572 2075 7365 s... Other use │ │ │ │ -00039240: 7273 206d 6179 2062 6520 616c 6c6f 7765 rs may be allowe │ │ │ │ -00039250: 6420 746f 2065 7865 6375 7465 2073 7065 d to execute spe │ │ │ │ -00039260: 6369 6669 6320 6d65 6e75 2065 6e74 7269 cific menu entri │ │ │ │ -00039270: 6573 2062 7920 6769 7669 6e67 0a61 206c es by giving.a l │ │ │ │ -00039280: 6973 7420 6f66 2075 7365 726e 616d 6573 ist of usernames │ │ │ │ -00039290: 2028 6173 2061 626f 7665 2920 7573 696e (as above) usin │ │ │ │ -000392a0: 6720 7468 6520 272d 2d75 7365 7273 2720 g the '--users' │ │ │ │ -000392b0: 6f70 7469 6f6e 2074 6f20 7468 650a 276d option to the.'m │ │ │ │ -000392c0: 656e 7565 6e74 7279 2720 636f 6d6d 616e enuentry' comman │ │ │ │ -000392d0: 6420 282a 6e6f 7465 206d 656e 7565 6e74 d (*note menuent │ │ │ │ -000392e0: 7279 3a3a 292e 2020 4966 2074 6865 2027 ry::). If the ' │ │ │ │ -000392f0: 2d2d 756e 7265 7374 7269 6374 6564 2720 --unrestricted' │ │ │ │ -00039300: 6f70 7469 6f6e 0a69 7320 7573 6564 2066 option.is used f │ │ │ │ -00039310: 6f72 2061 206d 656e 7520 656e 7472 792c or a menu entry, │ │ │ │ -00039320: 2074 6865 6e20 7468 6174 2065 6e74 7279 then that entry │ │ │ │ -00039330: 2069 7320 756e 7265 7374 7269 6374 6564 is unrestricted │ │ │ │ -00039340: 2e20 2049 6620 7468 650a 272d 2d75 7365 . If the.'--use │ │ │ │ -00039350: 7273 2720 6f70 7469 6f6e 2069 7320 6e6f rs' option is no │ │ │ │ -00039360: 7420 7573 6564 2066 6f72 2061 206d 656e t used for a men │ │ │ │ -00039370: 7520 656e 7472 792c 2074 6865 6e20 7468 u entry, then th │ │ │ │ -00039380: 6174 206f 6e6c 7920 7375 7065 7275 7365 at only superuse │ │ │ │ -00039390: 7273 0a61 7265 2061 626c 6520 746f 2075 rs.are able to u │ │ │ │ -000393a0: 7365 2069 742e 0a0a 2020 2050 7574 7469 se it... Putti │ │ │ │ -000393b0: 6e67 2074 6869 7320 746f 6765 7468 6572 ng this together │ │ │ │ -000393c0: 2c20 6120 7479 7069 6361 6c20 2767 7275 , a typical 'gru │ │ │ │ -000393d0: 622e 6366 6727 2066 7261 676d 656e 7420 b.cfg' fragment │ │ │ │ -000393e0: 6d69 6768 7420 6c6f 6f6b 206c 696b 650a might look like. │ │ │ │ -000393f0: 7468 6973 3a0a 0a20 2020 2020 7365 7420 this:.. set │ │ │ │ -00039400: 7375 7065 7275 7365 7273 3d22 726f 6f74 superusers="root │ │ │ │ -00039410: 220a 2020 2020 2070 6173 7377 6f72 645f ". password_ │ │ │ │ -00039420: 7062 6b64 6632 2072 6f6f 7420 6772 7562 pbkdf2 root grub │ │ │ │ -00039430: 2e70 626b 6466 322e 7368 6135 3132 2e31 .pbkdf2.sha512.1 │ │ │ │ -00039440: 3030 3030 2e62 6967 6c6f 6e67 7374 7269 0000.biglongstri │ │ │ │ -00039450: 6e67 0a20 2020 2020 7061 7373 776f 7264 ng. password │ │ │ │ -00039460: 2075 7365 7231 2069 6e73 6563 7572 650a user1 insecure. │ │ │ │ -00039470: 0a20 2020 2020 6d65 6e75 656e 7472 7920 . menuentry │ │ │ │ -00039480: 224d 6179 2062 6520 7275 6e20 6279 2061 "May be run by a │ │ │ │ -00039490: 6e79 2075 7365 7222 202d 2d75 6e72 6573 ny user" --unres │ │ │ │ -000394a0: 7472 6963 7465 6420 7b0a 2020 2020 2009 tricted {. . │ │ │ │ -000394b0: 7365 7420 726f 6f74 3d28 6864 302c 3129 set root=(hd0,1) │ │ │ │ -000394c0: 0a20 2020 2020 096c 696e 7578 202f 766d . .linux /vm │ │ │ │ -000394d0: 6c69 6e75 7a0a 2020 2020 207d 0a0a 2020 linuz. }.. │ │ │ │ -000394e0: 2020 206d 656e 7565 6e74 7279 2022 5375 menuentry "Su │ │ │ │ -000394f0: 7065 7275 7365 7273 206f 6e6c 7922 202d perusers only" - │ │ │ │ -00039500: 2d75 7365 7273 2022 2220 7b0a 2020 2020 -users "" {. │ │ │ │ -00039510: 2009 7365 7420 726f 6f74 3d28 6864 302c .set root=(hd0, │ │ │ │ -00039520: 3129 0a20 2020 2020 096c 696e 7578 202f 1). .linux / │ │ │ │ -00039530: 766d 6c69 6e75 7a20 7369 6e67 6c65 0a20 vmlinuz single. │ │ │ │ -00039540: 2020 2020 7d0a 0a20 2020 2020 6d65 6e75 }.. menu │ │ │ │ -00039550: 656e 7472 7920 224d 6179 2062 6520 7275 entry "May be ru │ │ │ │ -00039560: 6e20 6279 2075 7365 7231 206f 7220 6120 n by user1 or a │ │ │ │ -00039570: 7375 7065 7275 7365 7222 202d 2d75 7365 superuser" --use │ │ │ │ -00039580: 7273 2075 7365 7231 207b 0a20 2020 2020 rs user1 {. │ │ │ │ -00039590: 0973 6574 2072 6f6f 743d 2868 6430 2c32 .set root=(hd0,2 │ │ │ │ -000395a0: 290a 2020 2020 2009 6368 6169 6e6c 6f61 ). .chainloa │ │ │ │ -000395b0: 6465 7220 2b31 0a20 2020 2020 7d0a 0a20 der +1. }.. │ │ │ │ -000395c0: 2020 5468 6520 2767 7275 622d 6d6b 636f The 'grub-mkco │ │ │ │ -000395d0: 6e66 6967 2720 7072 6f67 7261 6d20 646f nfig' program do │ │ │ │ -000395e0: 6573 206e 6f74 2079 6574 2068 6176 6520 es not yet have │ │ │ │ -000395f0: 6275 696c 742d 696e 2073 7570 706f 7274 built-in support │ │ │ │ -00039600: 2066 6f72 0a67 656e 6572 6174 696e 6720 for.generating │ │ │ │ -00039610: 636f 6e66 6967 7572 6174 696f 6e20 6669 configuration fi │ │ │ │ -00039620: 6c65 7320 7769 7468 2061 7574 6865 6e74 les with authent │ │ │ │ -00039630: 6963 6174 696f 6e2e 2020 596f 7520 6361 ication. You ca │ │ │ │ -00039640: 6e20 7573 650a 272f 6574 632f 6772 7562 n use.'/etc/grub │ │ │ │ -00039650: 2e64 2f34 305f 6375 7374 6f6d 2720 746f .d/40_custom' to │ │ │ │ -00039660: 2061 6464 2073 696d 706c 6520 7375 7065 add simple supe │ │ │ │ -00039670: 7275 7365 7220 6175 7468 656e 7469 6361 ruser authentica │ │ │ │ -00039680: 7469 6f6e 2c20 6279 0a61 6464 696e 6720 tion, by.adding │ │ │ │ -00039690: 2773 6574 2073 7570 6572 7573 6572 733d 'set superusers= │ │ │ │ -000396a0: 2720 616e 6420 2770 6173 7377 6f72 6427 ' and 'password' │ │ │ │ -000396b0: 206f 7220 2770 6173 7377 6f72 645f 7062 or 'password_pb │ │ │ │ -000396c0: 6b64 6632 2720 636f 6d6d 616e 6473 2e0a kdf2' commands.. │ │ │ │ -000396d0: 0a1f 0a46 696c 653a 2067 7275 622e 696e ...File: grub.in │ │ │ │ -000396e0: 666f 2c20 204e 6f64 653a 2055 7369 6e67 fo, Node: Using │ │ │ │ -000396f0: 2064 6967 6974 616c 2073 6967 6e61 7475 digital signatu │ │ │ │ -00039700: 7265 732c 2020 4e65 7874 3a20 5545 4649 res, Next: UEFI │ │ │ │ -00039710: 2073 6563 7572 6520 626f 6f74 2061 6e64 secure boot and │ │ │ │ -00039720: 2073 6869 6d2c 2020 5072 6576 3a20 4175 shim, Prev: Au │ │ │ │ -00039730: 7468 656e 7469 6361 7469 6f6e 2061 6e64 thentication and │ │ │ │ -00039740: 2061 7574 686f 7269 7361 7469 6f6e 2c20 authorisation, │ │ │ │ -00039750: 2055 703a 2053 6563 7572 6974 790a 0a31 Up: Security..1 │ │ │ │ -00039760: 382e 3220 5573 696e 6720 6469 6769 7461 8.2 Using digita │ │ │ │ -00039770: 6c20 7369 676e 6174 7572 6573 2069 6e20 l signatures in │ │ │ │ -00039780: 4752 5542 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d GRUB.=========== │ │ │ │ +00038bf0: 3d3d 3d3d 0a0a 4279 2064 6566 6175 6c74 ====..By default │ │ │ │ +00038c00: 2c20 7468 6520 626f 6f74 206c 6f61 6465 , the boot loade │ │ │ │ +00038c10: 7220 696e 7465 7266 6163 6520 6973 2061 r interface is a │ │ │ │ +00038c20: 6363 6573 7369 626c 6520 746f 2061 6e79 ccessible to any │ │ │ │ +00038c30: 6f6e 6520 7769 7468 0a70 6879 7369 6361 one with.physica │ │ │ │ +00038c40: 6c20 6163 6365 7373 2074 6f20 7468 6520 l access to the │ │ │ │ +00038c50: 636f 6e73 6f6c 653a 2061 6e79 6f6e 6520 console: anyone │ │ │ │ +00038c60: 6361 6e20 7365 6c65 6374 2061 6e64 2065 can select and e │ │ │ │ +00038c70: 6469 7420 616e 7920 6d65 6e75 0a65 6e74 dit any menu.ent │ │ │ │ +00038c80: 7279 2c20 616e 6420 616e 796f 6e65 2063 ry, and anyone c │ │ │ │ +00038c90: 616e 2067 6574 2064 6972 6563 7420 6163 an get direct ac │ │ │ │ +00038ca0: 6365 7373 2074 6f20 6120 4752 5542 2073 cess to a GRUB s │ │ │ │ +00038cb0: 6865 6c6c 2070 726f 6d70 742e 2020 466f hell prompt. Fo │ │ │ │ +00038cc0: 720a 6d6f 7374 2073 7973 7465 6d73 2c20 r.most systems, │ │ │ │ +00038cd0: 7468 6973 2069 7320 7265 6173 6f6e 6162 this is reasonab │ │ │ │ +00038ce0: 6c65 2073 696e 6365 2061 6e79 6f6e 6520 le since anyone │ │ │ │ +00038cf0: 7769 7468 2064 6972 6563 7420 7068 7973 with direct phys │ │ │ │ +00038d00: 6963 616c 0a61 6363 6573 7320 6861 7320 ical.access has │ │ │ │ +00038d10: 6120 7661 7269 6574 7920 6f66 206f 7468 a variety of oth │ │ │ │ +00038d20: 6572 2077 6179 7320 746f 2067 6169 6e20 er ways to gain │ │ │ │ +00038d30: 6675 6c6c 2061 6363 6573 732c 2061 6e64 full access, and │ │ │ │ +00038d40: 2072 6571 7569 7269 6e67 0a61 7574 6865 requiring.authe │ │ │ │ +00038d50: 6e74 6963 6174 696f 6e20 6174 2074 6865 ntication at the │ │ │ │ +00038d60: 2062 6f6f 7420 6c6f 6164 6572 206c 6576 boot loader lev │ │ │ │ +00038d70: 656c 2077 6f75 6c64 206f 6e6c 7920 7365 el would only se │ │ │ │ +00038d80: 7276 6520 746f 206d 616b 6520 6974 0a64 rve to make it.d │ │ │ │ +00038d90: 6966 6669 6375 6c74 2074 6f20 7265 636f ifficult to reco │ │ │ │ +00038da0: 7665 7220 6272 6f6b 656e 2073 7973 7465 ver broken syste │ │ │ │ +00038db0: 6d73 2e0a 0a20 2020 486f 7765 7665 722c ms... However, │ │ │ │ +00038dc0: 2069 6e20 736f 6d65 2065 6e76 6972 6f6e in some environ │ │ │ │ +00038dd0: 6d65 6e74 732c 2073 7563 6820 6173 206b ments, such as k │ │ │ │ +00038de0: 696f 736b 732c 2069 7420 6d61 7920 6265 iosks, it may be │ │ │ │ +00038df0: 2061 7070 726f 7072 6961 7465 0a74 6f20 appropriate.to │ │ │ │ +00038e00: 6c6f 636b 2064 6f77 6e20 7468 6520 626f lock down the bo │ │ │ │ +00038e10: 6f74 206c 6f61 6465 7220 746f 2072 6571 ot loader to req │ │ │ │ +00038e20: 7569 7265 2061 7574 6865 6e74 6963 6174 uire authenticat │ │ │ │ +00038e30: 696f 6e20 6265 666f 7265 2070 6572 666f ion before perfo │ │ │ │ +00038e40: 726d 696e 670a 6365 7274 6169 6e20 6f70 rming.certain op │ │ │ │ +00038e50: 6572 6174 696f 6e73 2e0a 0a20 2020 5468 erations... Th │ │ │ │ +00038e60: 6520 2770 6173 7377 6f72 6427 2028 2a6e e 'password' (*n │ │ │ │ +00038e70: 6f74 6520 7061 7373 776f 7264 3a3a 2920 ote password::) │ │ │ │ +00038e80: 616e 6420 2770 6173 7377 6f72 645f 7062 and 'password_pb │ │ │ │ +00038e90: 6b64 6632 2720 282a 6e6f 7465 0a70 6173 kdf2' (*note.pas │ │ │ │ +00038ea0: 7377 6f72 645f 7062 6b64 6632 3a3a 2920 sword_pbkdf2::) │ │ │ │ +00038eb0: 636f 6d6d 616e 6473 2063 616e 2062 6520 commands can be │ │ │ │ +00038ec0: 7573 6564 2074 6f20 6465 6669 6e65 2075 used to define u │ │ │ │ +00038ed0: 7365 7273 2c20 6561 6368 206f 6620 7768 sers, each of wh │ │ │ │ +00038ee0: 6963 680a 6861 7320 616e 2061 7373 6f63 ich.has an assoc │ │ │ │ +00038ef0: 6961 7465 6420 7061 7373 776f 7264 2e20 iated password. │ │ │ │ +00038f00: 2027 7061 7373 776f 7264 2720 7365 7473 'password' sets │ │ │ │ +00038f10: 2074 6865 2070 6173 7377 6f72 6420 696e the password in │ │ │ │ +00038f20: 2070 6c61 696e 2074 6578 742c 0a72 6571 plain text,.req │ │ │ │ +00038f30: 7569 7269 6e67 2027 6772 7562 2e63 6667 uiring 'grub.cfg │ │ │ │ +00038f40: 2720 746f 2062 6520 7365 6375 7265 3b20 ' to be secure; │ │ │ │ +00038f50: 2770 6173 7377 6f72 645f 7062 6b64 6632 'password_pbkdf2 │ │ │ │ +00038f60: 2720 7365 7473 2074 6865 2070 6173 7377 ' sets the passw │ │ │ │ +00038f70: 6f72 640a 6861 7368 6564 2075 7369 6e67 ord.hashed using │ │ │ │ +00038f80: 2074 6865 2050 6173 7377 6f72 642d 4261 the Password-Ba │ │ │ │ +00038f90: 7365 6420 4b65 7920 4465 7269 7661 7469 sed Key Derivati │ │ │ │ +00038fa0: 6f6e 2046 756e 6374 696f 6e20 2852 4643 on Function (RFC │ │ │ │ +00038fb0: 2032 3839 3829 2c0a 7265 7175 6972 696e 2898),.requirin │ │ │ │ +00038fc0: 6720 7468 6520 7573 6520 6f66 2027 6772 g the use of 'gr │ │ │ │ +00038fd0: 7562 2d6d 6b70 6173 7377 642d 7062 6b64 ub-mkpasswd-pbkd │ │ │ │ +00038fe0: 6632 2720 282a 6e6f 7465 2049 6e76 6f6b f2' (*note Invok │ │ │ │ +00038ff0: 696e 670a 6772 7562 2d6d 6b70 6173 7377 ing.grub-mkpassw │ │ │ │ +00039000: 642d 7062 6b64 6632 3a3a 2920 746f 2067 d-pbkdf2::) to g │ │ │ │ +00039010: 656e 6572 6174 6520 7061 7373 776f 7264 enerate password │ │ │ │ +00039020: 2068 6173 6865 732e 0a0a 2020 2049 6e20 hashes... In │ │ │ │ +00039030: 6f72 6465 7220 746f 2065 6e61 626c 6520 order to enable │ │ │ │ +00039040: 6175 7468 656e 7469 6361 7469 6f6e 2073 authentication s │ │ │ │ +00039050: 7570 706f 7274 2c20 7468 6520 2773 7570 upport, the 'sup │ │ │ │ +00039060: 6572 7573 6572 7327 0a65 6e76 6972 6f6e erusers'.environ │ │ │ │ +00039070: 6d65 6e74 2076 6172 6961 626c 6520 6d75 ment variable mu │ │ │ │ +00039080: 7374 2062 6520 7365 7420 746f 2061 206c st be set to a l │ │ │ │ +00039090: 6973 7420 6f66 2075 7365 726e 616d 6573 ist of usernames │ │ │ │ +000390a0: 2c20 7365 7061 7261 7465 6420 6279 0a61 , separated by.a │ │ │ │ +000390b0: 6e79 206f 6620 7370 6163 6573 2c20 636f ny of spaces, co │ │ │ │ +000390c0: 6d6d 6173 2c20 7365 6d69 636f 6c6f 6e73 mmas, semicolons │ │ │ │ +000390d0: 2c20 7069 7065 732c 206f 7220 616d 7065 , pipes, or ampe │ │ │ │ +000390e0: 7273 616e 6473 2e20 2053 7570 6572 7573 rsands. Superus │ │ │ │ +000390f0: 6572 7320 6172 650a 7065 726d 6974 7465 ers are.permitte │ │ │ │ +00039100: 6420 746f 2075 7365 2074 6865 2047 5255 d to use the GRU │ │ │ │ +00039110: 4220 636f 6d6d 616e 6420 6c69 6e65 2c20 B command line, │ │ │ │ +00039120: 6564 6974 206d 656e 7520 656e 7472 6965 edit menu entrie │ │ │ │ +00039130: 732c 2061 6e64 2065 7865 6375 7465 0a61 s, and execute.a │ │ │ │ +00039140: 6e79 206d 656e 7520 656e 7472 792e 2020 ny menu entry. │ │ │ │ +00039150: 4966 2027 7375 7065 7275 7365 7273 2720 If 'superusers' │ │ │ │ +00039160: 6973 2073 6574 2c20 7468 656e 2075 7365 is set, then use │ │ │ │ +00039170: 206f 6620 7468 6520 636f 6d6d 616e 6420 of the command │ │ │ │ +00039180: 6c69 6e65 0a61 6e64 2065 6469 7469 6e67 line.and editing │ │ │ │ +00039190: 206f 6620 6d65 6e75 2065 6e74 7269 6573 of menu entries │ │ │ │ +000391a0: 2061 7265 2061 7574 6f6d 6174 6963 616c are automatical │ │ │ │ +000391b0: 6c79 2072 6573 7472 6963 7465 6420 746f ly restricted to │ │ │ │ +000391c0: 2073 7570 6572 7573 6572 732e 0a53 6574 superusers..Set │ │ │ │ +000391d0: 7469 6e67 2027 7375 7065 7275 7365 7273 ting 'superusers │ │ │ │ +000391e0: 2720 746f 2065 6d70 7479 2073 7472 696e ' to empty strin │ │ │ │ +000391f0: 6720 6566 6665 6374 6976 656c 7920 6469 g effectively di │ │ │ │ +00039200: 7361 626c 6573 2062 6f74 6820 6163 6365 sables both acce │ │ │ │ +00039210: 7373 2074 6f0a 434c 4920 616e 6420 6564 ss to.CLI and ed │ │ │ │ +00039220: 6974 696e 6720 6f66 206d 656e 7520 656e iting of menu en │ │ │ │ +00039230: 7472 6965 732e 0a0a 2020 204f 7468 6572 tries... Other │ │ │ │ +00039240: 2075 7365 7273 206d 6179 2062 6520 616c users may be al │ │ │ │ +00039250: 6c6f 7765 6420 746f 2065 7865 6375 7465 lowed to execute │ │ │ │ +00039260: 2073 7065 6369 6669 6320 6d65 6e75 2065 specific menu e │ │ │ │ +00039270: 6e74 7269 6573 2062 7920 6769 7669 6e67 ntries by giving │ │ │ │ +00039280: 0a61 206c 6973 7420 6f66 2075 7365 726e .a list of usern │ │ │ │ +00039290: 616d 6573 2028 6173 2061 626f 7665 2920 ames (as above) │ │ │ │ +000392a0: 7573 696e 6720 7468 6520 272d 2d75 7365 using the '--use │ │ │ │ +000392b0: 7273 2720 6f70 7469 6f6e 2074 6f20 7468 rs' option to th │ │ │ │ +000392c0: 650a 276d 656e 7565 6e74 7279 2720 636f e.'menuentry' co │ │ │ │ +000392d0: 6d6d 616e 6420 282a 6e6f 7465 206d 656e mmand (*note men │ │ │ │ +000392e0: 7565 6e74 7279 3a3a 292e 2020 4966 2074 uentry::). If t │ │ │ │ +000392f0: 6865 2027 2d2d 756e 7265 7374 7269 6374 he '--unrestrict │ │ │ │ +00039300: 6564 2720 6f70 7469 6f6e 0a69 7320 7573 ed' option.is us │ │ │ │ +00039310: 6564 2066 6f72 2061 206d 656e 7520 656e ed for a menu en │ │ │ │ +00039320: 7472 792c 2074 6865 6e20 7468 6174 2065 try, then that e │ │ │ │ +00039330: 6e74 7279 2069 7320 756e 7265 7374 7269 ntry is unrestri │ │ │ │ +00039340: 6374 6564 2e20 2049 6620 7468 650a 272d cted. If the.'- │ │ │ │ +00039350: 2d75 7365 7273 2720 6f70 7469 6f6e 2069 -users' option i │ │ │ │ +00039360: 7320 6e6f 7420 7573 6564 2066 6f72 2061 s not used for a │ │ │ │ +00039370: 206d 656e 7520 656e 7472 792c 2074 6865 menu entry, the │ │ │ │ +00039380: 6e20 7468 6174 206f 6e6c 7920 7375 7065 n that only supe │ │ │ │ +00039390: 7275 7365 7273 0a61 7265 2061 626c 6520 rusers.are able │ │ │ │ +000393a0: 746f 2075 7365 2069 742e 0a0a 2020 2050 to use it... P │ │ │ │ +000393b0: 7574 7469 6e67 2074 6869 7320 746f 6765 utting this toge │ │ │ │ +000393c0: 7468 6572 2c20 6120 7479 7069 6361 6c20 ther, a typical │ │ │ │ +000393d0: 2767 7275 622e 6366 6727 2066 7261 676d 'grub.cfg' fragm │ │ │ │ +000393e0: 656e 7420 6d69 6768 7420 6c6f 6f6b 206c ent might look l │ │ │ │ +000393f0: 696b 650a 7468 6973 3a0a 0a20 2020 2020 ike.this:.. │ │ │ │ +00039400: 7365 7420 7375 7065 7275 7365 7273 3d22 set superusers=" │ │ │ │ +00039410: 726f 6f74 220a 2020 2020 2070 6173 7377 root". passw │ │ │ │ +00039420: 6f72 645f 7062 6b64 6632 2072 6f6f 7420 ord_pbkdf2 root │ │ │ │ +00039430: 6772 7562 2e70 626b 6466 322e 7368 6135 grub.pbkdf2.sha5 │ │ │ │ +00039440: 3132 2e31 3030 3030 2e62 6967 6c6f 6e67 12.10000.biglong │ │ │ │ +00039450: 7374 7269 6e67 0a20 2020 2020 7061 7373 string. pass │ │ │ │ +00039460: 776f 7264 2075 7365 7231 2069 6e73 6563 word user1 insec │ │ │ │ +00039470: 7572 650a 0a20 2020 2020 6d65 6e75 656e ure.. menuen │ │ │ │ +00039480: 7472 7920 224d 6179 2062 6520 7275 6e20 try "May be run │ │ │ │ +00039490: 6279 2061 6e79 2075 7365 7222 202d 2d75 by any user" --u │ │ │ │ +000394a0: 6e72 6573 7472 6963 7465 6420 7b0a 2020 nrestricted {. │ │ │ │ +000394b0: 2020 2009 7365 7420 726f 6f74 3d28 6864 .set root=(hd │ │ │ │ +000394c0: 302c 3129 0a20 2020 2020 096c 696e 7578 0,1). .linux │ │ │ │ +000394d0: 202f 766d 6c69 6e75 7a0a 2020 2020 207d /vmlinuz. } │ │ │ │ +000394e0: 0a0a 2020 2020 206d 656e 7565 6e74 7279 .. menuentry │ │ │ │ +000394f0: 2022 5375 7065 7275 7365 7273 206f 6e6c "Superusers onl │ │ │ │ +00039500: 7922 202d 2d75 7365 7273 2022 2220 7b0a y" --users "" {. │ │ │ │ +00039510: 2020 2020 2009 7365 7420 726f 6f74 3d28 .set root=( │ │ │ │ +00039520: 6864 302c 3129 0a20 2020 2020 096c 696e hd0,1). .lin │ │ │ │ +00039530: 7578 202f 766d 6c69 6e75 7a20 7369 6e67 ux /vmlinuz sing │ │ │ │ +00039540: 6c65 0a20 2020 2020 7d0a 0a20 2020 2020 le. }.. │ │ │ │ +00039550: 6d65 6e75 656e 7472 7920 224d 6179 2062 menuentry "May b │ │ │ │ +00039560: 6520 7275 6e20 6279 2075 7365 7231 206f e run by user1 o │ │ │ │ +00039570: 7220 6120 7375 7065 7275 7365 7222 202d r a superuser" - │ │ │ │ +00039580: 2d75 7365 7273 2075 7365 7231 207b 0a20 -users user1 {. │ │ │ │ +00039590: 2020 2020 0973 6574 2072 6f6f 743d 2868 .set root=(h │ │ │ │ +000395a0: 6430 2c32 290a 2020 2020 2009 6368 6169 d0,2). .chai │ │ │ │ +000395b0: 6e6c 6f61 6465 7220 2b31 0a20 2020 2020 nloader +1. │ │ │ │ +000395c0: 7d0a 0a20 2020 5468 6520 2767 7275 622d }.. The 'grub- │ │ │ │ +000395d0: 6d6b 636f 6e66 6967 2720 7072 6f67 7261 mkconfig' progra │ │ │ │ +000395e0: 6d20 646f 6573 206e 6f74 2079 6574 2068 m does not yet h │ │ │ │ +000395f0: 6176 6520 6275 696c 742d 696e 2073 7570 ave built-in sup │ │ │ │ +00039600: 706f 7274 2066 6f72 0a67 656e 6572 6174 port for.generat │ │ │ │ +00039610: 696e 6720 636f 6e66 6967 7572 6174 696f ing configuratio │ │ │ │ +00039620: 6e20 6669 6c65 7320 7769 7468 2061 7574 n files with aut │ │ │ │ +00039630: 6865 6e74 6963 6174 696f 6e2e 2020 596f hentication. Yo │ │ │ │ +00039640: 7520 6361 6e20 7573 650a 272f 6574 632f u can use.'/etc/ │ │ │ │ +00039650: 6772 7562 2e64 2f34 305f 6375 7374 6f6d grub.d/40_custom │ │ │ │ +00039660: 2720 746f 2061 6464 2073 696d 706c 6520 ' to add simple │ │ │ │ +00039670: 7375 7065 7275 7365 7220 6175 7468 656e superuser authen │ │ │ │ +00039680: 7469 6361 7469 6f6e 2c20 6279 0a61 6464 tication, by.add │ │ │ │ +00039690: 696e 6720 2773 6574 2073 7570 6572 7573 ing 'set superus │ │ │ │ +000396a0: 6572 733d 2720 616e 6420 2770 6173 7377 ers=' and 'passw │ │ │ │ +000396b0: 6f72 6427 206f 7220 2770 6173 7377 6f72 ord' or 'passwor │ │ │ │ +000396c0: 645f 7062 6b64 6632 2720 636f 6d6d 616e d_pbkdf2' comman │ │ │ │ +000396d0: 6473 2e0a 0a1f 0a46 696c 653a 2067 7275 ds.....File: gru │ │ │ │ +000396e0: 622e 696e 666f 2c20 204e 6f64 653a 2055 b.info, Node: U │ │ │ │ +000396f0: 7369 6e67 2064 6967 6974 616c 2073 6967 sing digital sig │ │ │ │ +00039700: 6e61 7475 7265 732c 2020 4e65 7874 3a20 natures, Next: │ │ │ │ +00039710: 5545 4649 2073 6563 7572 6520 626f 6f74 UEFI secure boot │ │ │ │ +00039720: 2061 6e64 2073 6869 6d2c 2020 5072 6576 and shim, Prev │ │ │ │ +00039730: 3a20 4175 7468 656e 7469 6361 7469 6f6e : Authentication │ │ │ │ +00039740: 2061 6e64 2061 7574 686f 7269 7361 7469 and authorisati │ │ │ │ +00039750: 6f6e 2c20 2055 703a 2053 6563 7572 6974 on, Up: Securit │ │ │ │ +00039760: 790a 0a31 382e 3220 5573 696e 6720 6469 y..18.2 Using di │ │ │ │ +00039770: 6769 7461 6c20 7369 676e 6174 7572 6573 gital signatures │ │ │ │ +00039780: 2069 6e20 4752 5542 0a3d 3d3d 3d3d 3d3d in GRUB.======= │ │ │ │ 00039790: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ -000397a0: 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a 4752 5542 ==========..GRUB │ │ │ │ -000397b0: 2773 2027 636f 7265 2e69 6d67 2720 6361 's 'core.img' ca │ │ │ │ -000397c0: 6e20 6f70 7469 6f6e 616c 6c79 2070 726f n optionally pro │ │ │ │ -000397d0: 7669 6465 2065 6e66 6f72 6365 6d65 6e74 vide enforcement │ │ │ │ -000397e0: 2074 6861 7420 616c 6c20 6669 6c65 730a that all files. │ │ │ │ -000397f0: 7375 6273 6571 7565 6e74 6c79 2072 6561 subsequently rea │ │ │ │ -00039800: 6420 6672 6f6d 2064 6973 6b20 6172 6520 d from disk are │ │ │ │ -00039810: 636f 7665 7265 6420 6279 2061 2076 616c covered by a val │ │ │ │ -00039820: 6964 2064 6967 6974 616c 2073 6967 6e61 id digital signa │ │ │ │ -00039830: 7475 7265 2e0a 5468 6973 2064 6f63 756d ture..This docum │ │ │ │ -00039840: 656e 7420 646f 6573 202a 6e6f 742a 2063 ent does *not* c │ │ │ │ -00039850: 6f76 6572 2068 6f77 2074 6f20 656e 7375 over how to ensu │ │ │ │ -00039860: 7265 2074 6861 7420 796f 7572 2070 6c61 re that your pla │ │ │ │ -00039870: 7466 6f72 6d27 730a 6669 726d 7761 7265 tform's.firmware │ │ │ │ -00039880: 2028 652e 672e 2c20 436f 7265 626f 6f74 (e.g., Coreboot │ │ │ │ -00039890: 2920 7661 6c69 6461 7465 7320 2763 6f72 ) validates 'cor │ │ │ │ -000398a0: 652e 696d 6727 2e0a 0a20 2020 4966 2065 e.img'... If e │ │ │ │ -000398b0: 6e76 6972 6f6e 6d65 6e74 2076 6172 6961 nvironment varia │ │ │ │ -000398c0: 626c 6520 2763 6865 636b 5f73 6967 6e61 ble 'check_signa │ │ │ │ -000398d0: 7475 7265 7327 2028 2a6e 6f74 6520 6368 tures' (*note ch │ │ │ │ -000398e0: 6563 6b5f 7369 676e 6174 7572 6573 3a3a eck_signatures:: │ │ │ │ -000398f0: 290a 6973 2073 6574 2074 6f20 2765 6e66 ).is set to 'enf │ │ │ │ -00039900: 6f72 6365 272c 2074 6865 6e20 6576 6572 orce', then ever │ │ │ │ -00039910: 7920 6174 7465 6d70 7420 6279 2074 6865 y attempt by the │ │ │ │ -00039920: 2047 5255 4220 2763 6f72 652e 696d 6727 GRUB 'core.img' │ │ │ │ -00039930: 2074 6f20 6c6f 6164 0a61 6e6f 7468 6572 to load.another │ │ │ │ -00039940: 2066 696c 6520 2766 6f6f 2720 696d 706c file 'foo' impl │ │ │ │ -00039950: 6963 6974 6c79 2069 6e76 6f6b 6573 2027 icitly invokes ' │ │ │ │ -00039960: 7665 7269 6679 5f64 6574 6163 6865 6420 verify_detached │ │ │ │ -00039970: 666f 6f20 666f 6f2e 7369 6727 0a28 2a6e foo foo.sig'.(*n │ │ │ │ -00039980: 6f74 6520 7665 7269 6679 5f64 6574 6163 ote verify_detac │ │ │ │ -00039990: 6865 643a 3a29 2e20 2027 666f 6f2e 7369 hed::). 'foo.si │ │ │ │ -000399a0: 6727 206d 7573 7420 636f 6e74 6169 6e20 g' must contain │ │ │ │ -000399b0: 6120 7661 6c69 6420 6469 6769 7461 6c0a a valid digital. │ │ │ │ -000399c0: 7369 676e 6174 7572 6520 6f76 6572 2074 signature over t │ │ │ │ -000399d0: 6865 2063 6f6e 7465 6e74 7320 6f66 2027 he contents of ' │ │ │ │ -000399e0: 666f 6f27 2c20 7768 6963 6820 6361 6e20 foo', which can │ │ │ │ -000399f0: 6265 2076 6572 6966 6965 6420 7769 7468 be verified with │ │ │ │ -00039a00: 2061 0a70 7562 6c69 6320 6b65 7920 6375 a.public key cu │ │ │ │ -00039a10: 7272 656e 746c 7920 7472 7573 7465 6420 rrently trusted │ │ │ │ -00039a20: 6279 2047 5255 4220 282a 6e6f 7465 206c by GRUB (*note l │ │ │ │ -00039a30: 6973 745f 7472 7573 7465 643a 3a2c 202a ist_trusted::, * │ │ │ │ -00039a40: 6e6f 7465 0a74 7275 7374 3a3a 2c20 616e note.trust::, an │ │ │ │ -00039a50: 6420 2a6e 6f74 6520 6469 7374 7275 7374 d *note distrust │ │ │ │ -00039a60: 3a3a 292e 2020 4966 2076 616c 6964 6174 ::). If validat │ │ │ │ -00039a70: 696f 6e20 6661 696c 732c 2074 6865 6e20 ion fails, then │ │ │ │ -00039a80: 6669 6c65 2027 666f 6f27 0a63 616e 6e6f file 'foo'.canno │ │ │ │ -00039a90: 7420 6265 206f 7065 6e65 642e 2020 5468 t be opened. Th │ │ │ │ -00039aa0: 6973 2066 6169 6c75 7265 206d 6179 2068 is failure may h │ │ │ │ -00039ab0: 616c 7420 6f72 206f 7468 6572 7769 7365 alt or otherwise │ │ │ │ -00039ac0: 2069 6d70 6163 7420 7468 6520 626f 6f74 impact the boot │ │ │ │ -00039ad0: 0a70 726f 6365 7373 2e0a 0a20 2020 4752 .process... GR │ │ │ │ -00039ae0: 5542 2075 7365 7320 4750 472d 7374 796c UB uses GPG-styl │ │ │ │ -00039af0: 6520 6465 7461 6368 6564 2073 6967 6e61 e detached signa │ │ │ │ -00039b00: 7475 7265 7320 286d 6561 6e69 6e67 2074 tures (meaning t │ │ │ │ -00039b10: 6861 7420 6120 6669 6c65 0a27 666f 6f2e hat a file.'foo. │ │ │ │ -00039b20: 7369 6727 2077 696c 6c20 6265 2070 726f sig' will be pro │ │ │ │ -00039b30: 6475 6365 6420 7768 656e 2066 696c 6520 duced when file │ │ │ │ -00039b40: 2766 6f6f 2720 6973 2073 6967 6e65 6429 'foo' is signed) │ │ │ │ -00039b50: 2c20 616e 6420 6375 7272 656e 746c 790a , and currently. │ │ │ │ -00039b60: 7375 7070 6f72 7473 2074 6865 2044 5341 supports the DSA │ │ │ │ -00039b70: 2061 6e64 2052 5341 2073 6967 6e69 6e67 and RSA signing │ │ │ │ -00039b80: 2061 6c67 6f72 6974 686d 732e 2020 4120 algorithms. A │ │ │ │ -00039b90: 7369 676e 696e 6720 6b65 7920 6361 6e20 signing key can │ │ │ │ -00039ba0: 6265 0a67 656e 6572 6174 6564 2061 7320 be.generated as │ │ │ │ -00039bb0: 666f 6c6c 6f77 733a 0a0a 2020 2020 2067 follows:.. g │ │ │ │ -00039bc0: 7067 202d 2d67 656e 2d6b 6579 0a0a 2020 pg --gen-key.. │ │ │ │ -00039bd0: 2041 6e20 696e 6469 7669 6475 616c 2066 An individual f │ │ │ │ -00039be0: 696c 6520 6361 6e20 6265 2073 6967 6e65 ile can be signe │ │ │ │ -00039bf0: 6420 6173 2066 6f6c 6c6f 7773 3a0a 0a20 d as follows:.. │ │ │ │ -00039c00: 2020 2020 6770 6720 2d2d 6465 7461 6368 gpg --detach │ │ │ │ -00039c10: 2d73 6967 6e20 2f70 6174 682f 746f 2f66 -sign /path/to/f │ │ │ │ -00039c20: 696c 650a 0a20 2020 466f 7220 7375 6363 ile.. For succ │ │ │ │ -00039c30: 6573 7366 756c 2076 616c 6964 6174 696f essful validatio │ │ │ │ -00039c40: 6e20 6f66 2061 6c6c 206f 6620 4752 5542 n of all of GRUB │ │ │ │ -00039c50: 2773 2073 7562 636f 6d70 6f6e 656e 7473 's subcomponents │ │ │ │ -00039c60: 2061 6e64 2074 6865 0a6c 6f61 6465 6420 and the.loaded │ │ │ │ -00039c70: 4f53 206b 6572 6e65 6c2c 2074 6865 7920 OS kernel, they │ │ │ │ -00039c80: 6d75 7374 2061 6c6c 2062 6520 7369 676e must all be sign │ │ │ │ -00039c90: 6564 2e20 204f 6e65 2077 6179 2074 6f20 ed. One way to │ │ │ │ -00039ca0: 6163 636f 6d70 6c69 7368 2074 6869 730a accomplish this. │ │ │ │ -00039cb0: 6973 2074 6865 2066 6f6c 6c6f 7769 6e67 is the following │ │ │ │ -00039cc0: 2028 6166 7465 7220 6861 7669 6e67 2061 (after having a │ │ │ │ -00039cd0: 6c72 6561 6479 2070 726f 6475 6365 6420 lready produced │ │ │ │ -00039ce0: 7468 6520 6465 7369 7265 6420 2767 7275 the desired 'gru │ │ │ │ -00039cf0: 622e 6366 6727 0a66 696c 652c 2065 2e67 b.cfg'.file, e.g │ │ │ │ -00039d00: 2e2c 2062 7920 7275 6e6e 696e 6720 2767 ., by running 'g │ │ │ │ -00039d10: 7275 622d 6d6b 636f 6e66 6967 2720 282a rub-mkconfig' (* │ │ │ │ -00039d20: 6e6f 7465 2049 6e76 6f6b 696e 6720 6772 note Invoking gr │ │ │ │ -00039d30: 7562 2d6d 6b63 6f6e 6669 673a 3a29 3a0a ub-mkconfig::):. │ │ │ │ -00039d40: 0a20 2020 2020 2320 4564 6974 202f 6465 . # Edit /de │ │ │ │ -00039d50: 762f 7368 6d2f 7061 7373 7068 7261 7365 v/shm/passphrase │ │ │ │ -00039d60: 2e74 7874 2074 6f20 636f 6e74 6169 6e20 .txt to contain │ │ │ │ -00039d70: 796f 7572 2073 6967 6e69 6e67 206b 6579 your signing key │ │ │ │ -00039d80: 2773 2070 6173 7370 6872 6173 650a 2020 's passphrase. │ │ │ │ -00039d90: 2020 2066 6f72 2069 2069 6e20 6066 696e for i in `fin │ │ │ │ -00039da0: 6420 2f62 6f6f 7420 2d6e 616d 6520 222a d /boot -name "* │ │ │ │ -00039db0: 2e63 6667 2220 2d6f 7220 2d6e 616d 6520 .cfg" -or -name │ │ │ │ -00039dc0: 222a 2e6c 7374 2220 2d6f 7220 5c0a 2020 "*.lst" -or \. │ │ │ │ -00039dd0: 2020 2020 202d 6e61 6d65 2022 2a2e 6d6f -name "*.mo │ │ │ │ -00039de0: 6422 202d 6f72 202d 6e61 6d65 2022 766d d" -or -name "vm │ │ │ │ -00039df0: 6c69 6e75 7a2a 2220 2d6f 7220 2d6e 616d linuz*" -or -nam │ │ │ │ -00039e00: 6520 2269 6e69 7472 642a 2220 2d6f 7220 e "initrd*" -or │ │ │ │ -00039e10: 5c0a 2020 2020 2020 202d 6e61 6d65 2022 \. -name " │ │ │ │ -00039e20: 6772 7562 656e 7622 603b 0a20 2020 2020 grubenv"`;. │ │ │ │ -00039e30: 646f 0a20 2020 2020 2020 6770 6720 2d2d do. gpg -- │ │ │ │ -00039e40: 6261 7463 6820 2d2d 6465 7461 6368 2d73 batch --detach-s │ │ │ │ -00039e50: 6967 6e20 2d2d 7061 7373 7068 7261 7365 ign --passphrase │ │ │ │ -00039e60: 2d66 6420 3020 2469 203c 205c 0a20 2020 -fd 0 $i < \. │ │ │ │ -00039e70: 2020 2020 2020 2f64 6576 2f73 686d 2f70 /dev/shm/p │ │ │ │ -00039e80: 6173 7370 6872 6173 652e 7478 740a 2020 assphrase.txt. │ │ │ │ -00039e90: 2020 2064 6f6e 650a 2020 2020 2073 6872 done. shr │ │ │ │ -00039ea0: 6564 202f 6465 762f 7368 6d2f 7061 7373 ed /dev/shm/pass │ │ │ │ -00039eb0: 7068 7261 7365 2e74 7874 0a0a 2020 2053 phrase.txt.. S │ │ │ │ -00039ec0: 6565 2061 6c73 6f3a 202a 6e6f 7465 2063 ee also: *note c │ │ │ │ -00039ed0: 6865 636b 5f73 6967 6e61 7475 7265 733a heck_signatures: │ │ │ │ -00039ee0: 3a2c 202a 6e6f 7465 2076 6572 6966 795f :, *note verify_ │ │ │ │ -00039ef0: 6465 7461 6368 6564 3a3a 2c20 2a6e 6f74 detached::, *not │ │ │ │ -00039f00: 650a 7472 7573 743a 3a2c 202a 6e6f 7465 e.trust::, *note │ │ │ │ -00039f10: 206c 6973 745f 7472 7573 7465 643a 3a2c list_trusted::, │ │ │ │ -00039f20: 202a 6e6f 7465 2064 6973 7472 7573 743a *note distrust: │ │ │ │ -00039f30: 3a2c 202a 6e6f 7465 206c 6f61 645f 656e :, *note load_en │ │ │ │ -00039f40: 763a 3a2c 202a 6e6f 7465 0a73 6176 655f v::, *note.save_ │ │ │ │ -00039f50: 656e 763a 3a2e 0a0a 2020 204e 6f74 6520 env::... Note │ │ │ │ -00039f60: 7468 6174 2069 6e74 6572 6e61 6c6c 7920 that internally │ │ │ │ -00039f70: 7369 676e 6174 7572 6520 656e 666f 7263 signature enforc │ │ │ │ -00039f80: 656d 656e 7420 6973 2063 6f6e 7472 6f6c ement is control │ │ │ │ -00039f90: 6c65 6420 6279 2073 6574 7469 6e67 0a74 led by setting.t │ │ │ │ -00039fa0: 6865 2065 6e76 6972 6f6e 6d65 6e74 2076 he environment v │ │ │ │ -00039fb0: 6172 6961 626c 6520 2763 6865 636b 5f73 ariable 'check_s │ │ │ │ -00039fc0: 6967 6e61 7475 7265 7327 2065 7175 616c ignatures' equal │ │ │ │ -00039fd0: 2074 6f20 2765 6e66 6f72 6365 272e 2020 to 'enforce'. │ │ │ │ -00039fe0: 5061 7373 696e 670a 6f6e 6520 6f72 206d Passing.one or m │ │ │ │ -00039ff0: 6f72 6520 272d 2d70 7562 6b65 7927 206f ore '--pubkey' o │ │ │ │ -0003a000: 7074 696f 6e73 2074 6f20 2767 7275 622d ptions to 'grub- │ │ │ │ -0003a010: 6d6b 696d 6167 6527 2069 6d70 6c69 6369 mkimage' implici │ │ │ │ -0003a020: 746c 7920 6465 6669 6e65 730a 2763 6865 tly defines.'che │ │ │ │ -0003a030: 636b 5f73 6967 6e61 7475 7265 7327 2065 ck_signatures' e │ │ │ │ -0003a040: 7175 616c 2074 6f20 2765 6e66 6f72 6365 qual to 'enforce │ │ │ │ -0003a050: 2720 696e 2027 636f 7265 2e69 6d67 2720 ' in 'core.img' │ │ │ │ -0003a060: 7072 696f 7220 746f 2070 726f 6365 7373 prior to process │ │ │ │ -0003a070: 696e 670a 616e 7920 636f 6e66 6967 7572 ing.any configur │ │ │ │ -0003a080: 6174 696f 6e20 6669 6c65 732e 0a0a 2020 ation files... │ │ │ │ -0003a090: 204e 6f74 6520 7468 6174 2073 6967 6e61 Note that signa │ │ │ │ -0003a0a0: 7475 7265 2063 6865 636b 696e 6720 646f ture checking do │ │ │ │ -0003a0b0: 6573 202a 6e6f 742a 2070 7265 7665 6e74 es *not* prevent │ │ │ │ -0003a0c0: 2061 6e20 6174 7461 636b 6572 2077 6974 an attacker wit │ │ │ │ -0003a0d0: 680a 2873 6572 6961 6c2c 2070 6879 7369 h.(serial, physi │ │ │ │ -0003a0e0: 6361 6c2c 202e 2e2e 2920 2063 6f6e 736f cal, ...) conso │ │ │ │ -0003a0f0: 6c65 2061 6363 6573 7320 6672 6f6d 2064 le access from d │ │ │ │ -0003a100: 726f 7070 696e 6720 6d61 6e75 616c 6c79 ropping manually │ │ │ │ -0003a110: 2074 6f20 7468 650a 4752 5542 2063 6f6e to the.GRUB con │ │ │ │ -0003a120: 736f 6c65 2061 6e64 2065 7865 6375 7469 sole and executi │ │ │ │ -0003a130: 6e67 3a0a 0a20 2020 2020 7365 7420 6368 ng:.. set ch │ │ │ │ -0003a140: 6563 6b5f 7369 676e 6174 7572 6573 3d6e eck_signatures=n │ │ │ │ -0003a150: 6f0a 0a20 2020 546f 2070 7265 7665 6e74 o.. To prevent │ │ │ │ -0003a160: 2074 6869 732c 2070 6173 7377 6f72 642d this, password- │ │ │ │ -0003a170: 7072 6f74 6563 7469 6f6e 2028 2a6e 6f74 protection (*not │ │ │ │ -0003a180: 6520 4175 7468 656e 7469 6361 7469 6f6e e Authentication │ │ │ │ -0003a190: 2061 6e64 0a61 7574 686f 7269 7361 7469 and.authorisati │ │ │ │ -0003a1a0: 6f6e 3a3a 2920 6973 2065 7373 656e 7469 on::) is essenti │ │ │ │ -0003a1b0: 616c 2e20 204e 6f74 6520 7468 6174 2065 al. Note that e │ │ │ │ -0003a1c0: 7665 6e20 7769 7468 2047 5255 4220 7061 ven with GRUB pa │ │ │ │ -0003a1d0: 7373 776f 7264 0a70 726f 7465 6374 696f ssword.protectio │ │ │ │ -0003a1e0: 6e2c 2047 5255 4220 6974 7365 6c66 2063 n, GRUB itself c │ │ │ │ -0003a1f0: 616e 6e6f 7420 7072 6576 656e 7420 736f annot prevent so │ │ │ │ -0003a200: 6d65 6f6e 6520 7769 7468 2070 6879 7369 meone with physi │ │ │ │ -0003a210: 6361 6c20 6163 6365 7373 2074 6f0a 7468 cal access to.th │ │ │ │ -0003a220: 6520 6d61 6368 696e 6520 6672 6f6d 2061 e machine from a │ │ │ │ -0003a230: 6c74 6572 696e 6720 7468 6174 206d 6163 ltering that mac │ │ │ │ -0003a240: 6869 6e65 2773 2066 6972 6d77 6172 6520 hine's firmware │ │ │ │ -0003a250: 2865 2e67 2e2c 2043 6f72 6562 6f6f 7420 (e.g., Coreboot │ │ │ │ -0003a260: 6f72 0a42 494f 5329 2063 6f6e 6669 6775 or.BIOS) configu │ │ │ │ -0003a270: 7261 7469 6f6e 2074 6f20 6361 7573 6520 ration to cause │ │ │ │ -0003a280: 7468 6520 6d61 6368 696e 6520 746f 2062 the machine to b │ │ │ │ -0003a290: 6f6f 7420 6672 6f6d 2061 2064 6966 6665 oot from a diffe │ │ │ │ -0003a2a0: 7265 6e74 0a28 6174 7461 636b 6572 2d63 rent.(attacker-c │ │ │ │ -0003a2b0: 6f6e 7472 6f6c 6c65 6429 2064 6576 6963 ontrolled) devic │ │ │ │ -0003a2c0: 652e 2020 4752 5542 2069 7320 6174 2062 e. GRUB is at b │ │ │ │ -0003a2d0: 6573 7420 6f6e 6c79 206f 6e65 206c 696e est only one lin │ │ │ │ -0003a2e0: 6b20 696e 2061 2073 6563 7572 650a 626f k in a secure.bo │ │ │ │ -0003a2f0: 6f74 2063 6861 696e 2e0a 0a1f 0a46 696c ot chain.....Fil │ │ │ │ -0003a300: 653a 2067 7275 622e 696e 666f 2c20 204e e: grub.info, N │ │ │ │ -0003a310: 6f64 653a 2055 4546 4920 7365 6375 7265 ode: UEFI secure │ │ │ │ -0003a320: 2062 6f6f 7420 616e 6420 7368 696d 2c20 boot and shim, │ │ │ │ -0003a330: 204e 6578 743a 2053 6563 7572 6520 426f Next: Secure Bo │ │ │ │ -0003a340: 6f74 2041 6476 616e 6365 6420 5461 7267 ot Advanced Targ │ │ │ │ -0003a350: 6574 696e 672c 2020 5072 6576 3a20 5573 eting, Prev: Us │ │ │ │ -0003a360: 696e 6720 6469 6769 7461 6c20 7369 676e ing digital sign │ │ │ │ -0003a370: 6174 7572 6573 2c20 2055 703a 2053 6563 atures, Up: Sec │ │ │ │ -0003a380: 7572 6974 790a 0a31 382e 3320 5545 4649 urity..18.3 UEFI │ │ │ │ -0003a390: 2073 6563 7572 6520 626f 6f74 2061 6e64 secure boot and │ │ │ │ -0003a3a0: 2073 6869 6d20 7375 7070 6f72 740a 3d3d shim support.== │ │ │ │ -0003a3b0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ +000397a0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a ==============.. │ │ │ │ +000397b0: 4752 5542 2773 2027 636f 7265 2e69 6d67 GRUB's 'core.img │ │ │ │ +000397c0: 2720 6361 6e20 6f70 7469 6f6e 616c 6c79 ' can optionally │ │ │ │ +000397d0: 2070 726f 7669 6465 2065 6e66 6f72 6365 provide enforce │ │ │ │ +000397e0: 6d65 6e74 2074 6861 7420 616c 6c20 6669 ment that all fi │ │ │ │ +000397f0: 6c65 730a 7375 6273 6571 7565 6e74 6c79 les.subsequently │ │ │ │ +00039800: 2072 6561 6420 6672 6f6d 2064 6973 6b20 read from disk │ │ │ │ +00039810: 6172 6520 636f 7665 7265 6420 6279 2061 are covered by a │ │ │ │ +00039820: 2076 616c 6964 2064 6967 6974 616c 2073 valid digital s │ │ │ │ +00039830: 6967 6e61 7475 7265 2e0a 5468 6973 2064 ignature..This d │ │ │ │ +00039840: 6f63 756d 656e 7420 646f 6573 202a 6e6f ocument does *no │ │ │ │ +00039850: 742a 2063 6f76 6572 2068 6f77 2074 6f20 t* cover how to │ │ │ │ +00039860: 656e 7375 7265 2074 6861 7420 796f 7572 ensure that your │ │ │ │ +00039870: 2070 6c61 7466 6f72 6d27 730a 6669 726d platform's.firm │ │ │ │ +00039880: 7761 7265 2028 652e 672e 2c20 436f 7265 ware (e.g., Core │ │ │ │ +00039890: 626f 6f74 2920 7661 6c69 6461 7465 7320 boot) validates │ │ │ │ +000398a0: 2763 6f72 652e 696d 6727 2e0a 0a20 2020 'core.img'... │ │ │ │ +000398b0: 4966 2065 6e76 6972 6f6e 6d65 6e74 2076 If environment v │ │ │ │ +000398c0: 6172 6961 626c 6520 2763 6865 636b 5f73 ariable 'check_s │ │ │ │ +000398d0: 6967 6e61 7475 7265 7327 2028 2a6e 6f74 ignatures' (*not │ │ │ │ +000398e0: 6520 6368 6563 6b5f 7369 676e 6174 7572 e check_signatur │ │ │ │ +000398f0: 6573 3a3a 290a 6973 2073 6574 2074 6f20 es::).is set to │ │ │ │ +00039900: 2765 6e66 6f72 6365 272c 2074 6865 6e20 'enforce', then │ │ │ │ +00039910: 6576 6572 7920 6174 7465 6d70 7420 6279 every attempt by │ │ │ │ +00039920: 2074 6865 2047 5255 4220 2763 6f72 652e the GRUB 'core. │ │ │ │ +00039930: 696d 6727 2074 6f20 6c6f 6164 0a61 6e6f img' to load.ano │ │ │ │ +00039940: 7468 6572 2066 696c 6520 2766 6f6f 2720 ther file 'foo' │ │ │ │ +00039950: 696d 706c 6963 6974 6c79 2069 6e76 6f6b implicitly invok │ │ │ │ +00039960: 6573 2027 7665 7269 6679 5f64 6574 6163 es 'verify_detac │ │ │ │ +00039970: 6865 6420 666f 6f20 666f 6f2e 7369 6727 hed foo foo.sig' │ │ │ │ +00039980: 0a28 2a6e 6f74 6520 7665 7269 6679 5f64 .(*note verify_d │ │ │ │ +00039990: 6574 6163 6865 643a 3a29 2e20 2027 666f etached::). 'fo │ │ │ │ +000399a0: 6f2e 7369 6727 206d 7573 7420 636f 6e74 o.sig' must cont │ │ │ │ +000399b0: 6169 6e20 6120 7661 6c69 6420 6469 6769 ain a valid digi │ │ │ │ +000399c0: 7461 6c0a 7369 676e 6174 7572 6520 6f76 tal.signature ov │ │ │ │ +000399d0: 6572 2074 6865 2063 6f6e 7465 6e74 7320 er the contents │ │ │ │ +000399e0: 6f66 2027 666f 6f27 2c20 7768 6963 6820 of 'foo', which │ │ │ │ +000399f0: 6361 6e20 6265 2076 6572 6966 6965 6420 can be verified │ │ │ │ +00039a00: 7769 7468 2061 0a70 7562 6c69 6320 6b65 with a.public ke │ │ │ │ +00039a10: 7920 6375 7272 656e 746c 7920 7472 7573 y currently trus │ │ │ │ +00039a20: 7465 6420 6279 2047 5255 4220 282a 6e6f ted by GRUB (*no │ │ │ │ +00039a30: 7465 206c 6973 745f 7472 7573 7465 643a te list_trusted: │ │ │ │ +00039a40: 3a2c 202a 6e6f 7465 0a74 7275 7374 3a3a :, *note.trust:: │ │ │ │ +00039a50: 2c20 616e 6420 2a6e 6f74 6520 6469 7374 , and *note dist │ │ │ │ +00039a60: 7275 7374 3a3a 292e 2020 4966 2076 616c rust::). If val │ │ │ │ +00039a70: 6964 6174 696f 6e20 6661 696c 732c 2074 idation fails, t │ │ │ │ +00039a80: 6865 6e20 6669 6c65 2027 666f 6f27 0a63 hen file 'foo'.c │ │ │ │ +00039a90: 616e 6e6f 7420 6265 206f 7065 6e65 642e annot be opened. │ │ │ │ +00039aa0: 2020 5468 6973 2066 6169 6c75 7265 206d This failure m │ │ │ │ +00039ab0: 6179 2068 616c 7420 6f72 206f 7468 6572 ay halt or other │ │ │ │ +00039ac0: 7769 7365 2069 6d70 6163 7420 7468 6520 wise impact the │ │ │ │ +00039ad0: 626f 6f74 0a70 726f 6365 7373 2e0a 0a20 boot.process... │ │ │ │ +00039ae0: 2020 4752 5542 2075 7365 7320 4750 472d GRUB uses GPG- │ │ │ │ +00039af0: 7374 796c 6520 6465 7461 6368 6564 2073 style detached s │ │ │ │ +00039b00: 6967 6e61 7475 7265 7320 286d 6561 6e69 ignatures (meani │ │ │ │ +00039b10: 6e67 2074 6861 7420 6120 6669 6c65 0a27 ng that a file.' │ │ │ │ +00039b20: 666f 6f2e 7369 6727 2077 696c 6c20 6265 foo.sig' will be │ │ │ │ +00039b30: 2070 726f 6475 6365 6420 7768 656e 2066 produced when f │ │ │ │ +00039b40: 696c 6520 2766 6f6f 2720 6973 2073 6967 ile 'foo' is sig │ │ │ │ +00039b50: 6e65 6429 2c20 616e 6420 6375 7272 656e ned), and curren │ │ │ │ +00039b60: 746c 790a 7375 7070 6f72 7473 2074 6865 tly.supports the │ │ │ │ +00039b70: 2044 5341 2061 6e64 2052 5341 2073 6967 DSA and RSA sig │ │ │ │ +00039b80: 6e69 6e67 2061 6c67 6f72 6974 686d 732e ning algorithms. │ │ │ │ +00039b90: 2020 4120 7369 676e 696e 6720 6b65 7920 A signing key │ │ │ │ +00039ba0: 6361 6e20 6265 0a67 656e 6572 6174 6564 can be.generated │ │ │ │ +00039bb0: 2061 7320 666f 6c6c 6f77 733a 0a0a 2020 as follows:.. │ │ │ │ +00039bc0: 2020 2067 7067 202d 2d67 656e 2d6b 6579 gpg --gen-key │ │ │ │ +00039bd0: 0a0a 2020 2041 6e20 696e 6469 7669 6475 .. An individu │ │ │ │ +00039be0: 616c 2066 696c 6520 6361 6e20 6265 2073 al file can be s │ │ │ │ +00039bf0: 6967 6e65 6420 6173 2066 6f6c 6c6f 7773 igned as follows │ │ │ │ +00039c00: 3a0a 0a20 2020 2020 6770 6720 2d2d 6465 :.. gpg --de │ │ │ │ +00039c10: 7461 6368 2d73 6967 6e20 2f70 6174 682f tach-sign /path/ │ │ │ │ +00039c20: 746f 2f66 696c 650a 0a20 2020 466f 7220 to/file.. For │ │ │ │ +00039c30: 7375 6363 6573 7366 756c 2076 616c 6964 successful valid │ │ │ │ +00039c40: 6174 696f 6e20 6f66 2061 6c6c 206f 6620 ation of all of │ │ │ │ +00039c50: 4752 5542 2773 2073 7562 636f 6d70 6f6e GRUB's subcompon │ │ │ │ +00039c60: 656e 7473 2061 6e64 2074 6865 0a6c 6f61 ents and the.loa │ │ │ │ +00039c70: 6465 6420 4f53 206b 6572 6e65 6c2c 2074 ded OS kernel, t │ │ │ │ +00039c80: 6865 7920 6d75 7374 2061 6c6c 2062 6520 hey must all be │ │ │ │ +00039c90: 7369 676e 6564 2e20 204f 6e65 2077 6179 signed. One way │ │ │ │ +00039ca0: 2074 6f20 6163 636f 6d70 6c69 7368 2074 to accomplish t │ │ │ │ +00039cb0: 6869 730a 6973 2074 6865 2066 6f6c 6c6f his.is the follo │ │ │ │ +00039cc0: 7769 6e67 2028 6166 7465 7220 6861 7669 wing (after havi │ │ │ │ +00039cd0: 6e67 2061 6c72 6561 6479 2070 726f 6475 ng already produ │ │ │ │ +00039ce0: 6365 6420 7468 6520 6465 7369 7265 6420 ced the desired │ │ │ │ +00039cf0: 2767 7275 622e 6366 6727 0a66 696c 652c 'grub.cfg'.file, │ │ │ │ +00039d00: 2065 2e67 2e2c 2062 7920 7275 6e6e 696e e.g., by runnin │ │ │ │ +00039d10: 6720 2767 7275 622d 6d6b 636f 6e66 6967 g 'grub-mkconfig │ │ │ │ +00039d20: 2720 282a 6e6f 7465 2049 6e76 6f6b 696e ' (*note Invokin │ │ │ │ +00039d30: 6720 6772 7562 2d6d 6b63 6f6e 6669 673a g grub-mkconfig: │ │ │ │ +00039d40: 3a29 3a0a 0a20 2020 2020 2320 4564 6974 :):.. # Edit │ │ │ │ +00039d50: 202f 6465 762f 7368 6d2f 7061 7373 7068 /dev/shm/passph │ │ │ │ +00039d60: 7261 7365 2e74 7874 2074 6f20 636f 6e74 rase.txt to cont │ │ │ │ +00039d70: 6169 6e20 796f 7572 2073 6967 6e69 6e67 ain your signing │ │ │ │ +00039d80: 206b 6579 2773 2070 6173 7370 6872 6173 key's passphras │ │ │ │ +00039d90: 650a 2020 2020 2066 6f72 2069 2069 6e20 e. for i in │ │ │ │ +00039da0: 6066 696e 6420 2f62 6f6f 7420 2d6e 616d `find /boot -nam │ │ │ │ +00039db0: 6520 222a 2e63 6667 2220 2d6f 7220 2d6e e "*.cfg" -or -n │ │ │ │ +00039dc0: 616d 6520 222a 2e6c 7374 2220 2d6f 7220 ame "*.lst" -or │ │ │ │ +00039dd0: 5c0a 2020 2020 2020 202d 6e61 6d65 2022 \. -name " │ │ │ │ +00039de0: 2a2e 6d6f 6422 202d 6f72 202d 6e61 6d65 *.mod" -or -name │ │ │ │ +00039df0: 2022 766d 6c69 6e75 7a2a 2220 2d6f 7220 "vmlinuz*" -or │ │ │ │ +00039e00: 2d6e 616d 6520 2269 6e69 7472 642a 2220 -name "initrd*" │ │ │ │ +00039e10: 2d6f 7220 5c0a 2020 2020 2020 202d 6e61 -or \. -na │ │ │ │ +00039e20: 6d65 2022 6772 7562 656e 7622 603b 0a20 me "grubenv"`;. │ │ │ │ +00039e30: 2020 2020 646f 0a20 2020 2020 2020 6770 do. gp │ │ │ │ +00039e40: 6720 2d2d 6261 7463 6820 2d2d 6465 7461 g --batch --deta │ │ │ │ +00039e50: 6368 2d73 6967 6e20 2d2d 7061 7373 7068 ch-sign --passph │ │ │ │ +00039e60: 7261 7365 2d66 6420 3020 2469 203c 205c rase-fd 0 $i < \ │ │ │ │ +00039e70: 0a20 2020 2020 2020 2020 2f64 6576 2f73 . /dev/s │ │ │ │ +00039e80: 686d 2f70 6173 7370 6872 6173 652e 7478 hm/passphrase.tx │ │ │ │ +00039e90: 740a 2020 2020 2064 6f6e 650a 2020 2020 t. done. │ │ │ │ +00039ea0: 2073 6872 6564 202f 6465 762f 7368 6d2f shred /dev/shm/ │ │ │ │ +00039eb0: 7061 7373 7068 7261 7365 2e74 7874 0a0a passphrase.txt.. │ │ │ │ +00039ec0: 2020 2053 6565 2061 6c73 6f3a 202a 6e6f See also: *no │ │ │ │ +00039ed0: 7465 2063 6865 636b 5f73 6967 6e61 7475 te check_signatu │ │ │ │ +00039ee0: 7265 733a 3a2c 202a 6e6f 7465 2076 6572 res::, *note ver │ │ │ │ +00039ef0: 6966 795f 6465 7461 6368 6564 3a3a 2c20 ify_detached::, │ │ │ │ +00039f00: 2a6e 6f74 650a 7472 7573 743a 3a2c 202a *note.trust::, * │ │ │ │ +00039f10: 6e6f 7465 206c 6973 745f 7472 7573 7465 note list_truste │ │ │ │ +00039f20: 643a 3a2c 202a 6e6f 7465 2064 6973 7472 d::, *note distr │ │ │ │ +00039f30: 7573 743a 3a2c 202a 6e6f 7465 206c 6f61 ust::, *note loa │ │ │ │ +00039f40: 645f 656e 763a 3a2c 202a 6e6f 7465 0a73 d_env::, *note.s │ │ │ │ +00039f50: 6176 655f 656e 763a 3a2e 0a0a 2020 204e ave_env::... N │ │ │ │ +00039f60: 6f74 6520 7468 6174 2069 6e74 6572 6e61 ote that interna │ │ │ │ +00039f70: 6c6c 7920 7369 676e 6174 7572 6520 656e lly signature en │ │ │ │ +00039f80: 666f 7263 656d 656e 7420 6973 2063 6f6e forcement is con │ │ │ │ +00039f90: 7472 6f6c 6c65 6420 6279 2073 6574 7469 trolled by setti │ │ │ │ +00039fa0: 6e67 0a74 6865 2065 6e76 6972 6f6e 6d65 ng.the environme │ │ │ │ +00039fb0: 6e74 2076 6172 6961 626c 6520 2763 6865 nt variable 'che │ │ │ │ +00039fc0: 636b 5f73 6967 6e61 7475 7265 7327 2065 ck_signatures' e │ │ │ │ +00039fd0: 7175 616c 2074 6f20 2765 6e66 6f72 6365 qual to 'enforce │ │ │ │ +00039fe0: 272e 2020 5061 7373 696e 670a 6f6e 6520 '. Passing.one │ │ │ │ +00039ff0: 6f72 206d 6f72 6520 272d 2d70 7562 6b65 or more '--pubke │ │ │ │ +0003a000: 7927 206f 7074 696f 6e73 2074 6f20 2767 y' options to 'g │ │ │ │ +0003a010: 7275 622d 6d6b 696d 6167 6527 2069 6d70 rub-mkimage' imp │ │ │ │ +0003a020: 6c69 6369 746c 7920 6465 6669 6e65 730a licitly defines. │ │ │ │ +0003a030: 2763 6865 636b 5f73 6967 6e61 7475 7265 'check_signature │ │ │ │ +0003a040: 7327 2065 7175 616c 2074 6f20 2765 6e66 s' equal to 'enf │ │ │ │ +0003a050: 6f72 6365 2720 696e 2027 636f 7265 2e69 orce' in 'core.i │ │ │ │ +0003a060: 6d67 2720 7072 696f 7220 746f 2070 726f mg' prior to pro │ │ │ │ +0003a070: 6365 7373 696e 670a 616e 7920 636f 6e66 cessing.any conf │ │ │ │ +0003a080: 6967 7572 6174 696f 6e20 6669 6c65 732e iguration files. │ │ │ │ +0003a090: 0a0a 2020 204e 6f74 6520 7468 6174 2073 .. Note that s │ │ │ │ +0003a0a0: 6967 6e61 7475 7265 2063 6865 636b 696e ignature checkin │ │ │ │ +0003a0b0: 6720 646f 6573 202a 6e6f 742a 2070 7265 g does *not* pre │ │ │ │ +0003a0c0: 7665 6e74 2061 6e20 6174 7461 636b 6572 vent an attacker │ │ │ │ +0003a0d0: 2077 6974 680a 2873 6572 6961 6c2c 2070 with.(serial, p │ │ │ │ +0003a0e0: 6879 7369 6361 6c2c 202e 2e2e 2920 2063 hysical, ...) c │ │ │ │ +0003a0f0: 6f6e 736f 6c65 2061 6363 6573 7320 6672 onsole access fr │ │ │ │ +0003a100: 6f6d 2064 726f 7070 696e 6720 6d61 6e75 om dropping manu │ │ │ │ +0003a110: 616c 6c79 2074 6f20 7468 650a 4752 5542 ally to the.GRUB │ │ │ │ +0003a120: 2063 6f6e 736f 6c65 2061 6e64 2065 7865 console and exe │ │ │ │ +0003a130: 6375 7469 6e67 3a0a 0a20 2020 2020 7365 cuting:.. se │ │ │ │ +0003a140: 7420 6368 6563 6b5f 7369 676e 6174 7572 t check_signatur │ │ │ │ +0003a150: 6573 3d6e 6f0a 0a20 2020 546f 2070 7265 es=no.. To pre │ │ │ │ +0003a160: 7665 6e74 2074 6869 732c 2070 6173 7377 vent this, passw │ │ │ │ +0003a170: 6f72 642d 7072 6f74 6563 7469 6f6e 2028 ord-protection ( │ │ │ │ +0003a180: 2a6e 6f74 6520 4175 7468 656e 7469 6361 *note Authentica │ │ │ │ +0003a190: 7469 6f6e 2061 6e64 0a61 7574 686f 7269 tion and.authori │ │ │ │ +0003a1a0: 7361 7469 6f6e 3a3a 2920 6973 2065 7373 sation::) is ess │ │ │ │ +0003a1b0: 656e 7469 616c 2e20 204e 6f74 6520 7468 ential. Note th │ │ │ │ +0003a1c0: 6174 2065 7665 6e20 7769 7468 2047 5255 at even with GRU │ │ │ │ +0003a1d0: 4220 7061 7373 776f 7264 0a70 726f 7465 B password.prote │ │ │ │ +0003a1e0: 6374 696f 6e2c 2047 5255 4220 6974 7365 ction, GRUB itse │ │ │ │ +0003a1f0: 6c66 2063 616e 6e6f 7420 7072 6576 656e lf cannot preven │ │ │ │ +0003a200: 7420 736f 6d65 6f6e 6520 7769 7468 2070 t someone with p │ │ │ │ +0003a210: 6879 7369 6361 6c20 6163 6365 7373 2074 hysical access t │ │ │ │ +0003a220: 6f0a 7468 6520 6d61 6368 696e 6520 6672 o.the machine fr │ │ │ │ +0003a230: 6f6d 2061 6c74 6572 696e 6720 7468 6174 om altering that │ │ │ │ +0003a240: 206d 6163 6869 6e65 2773 2066 6972 6d77 machine's firmw │ │ │ │ +0003a250: 6172 6520 2865 2e67 2e2c 2043 6f72 6562 are (e.g., Coreb │ │ │ │ +0003a260: 6f6f 7420 6f72 0a42 494f 5329 2063 6f6e oot or.BIOS) con │ │ │ │ +0003a270: 6669 6775 7261 7469 6f6e 2074 6f20 6361 figuration to ca │ │ │ │ +0003a280: 7573 6520 7468 6520 6d61 6368 696e 6520 use the machine │ │ │ │ +0003a290: 746f 2062 6f6f 7420 6672 6f6d 2061 2064 to boot from a d │ │ │ │ +0003a2a0: 6966 6665 7265 6e74 0a28 6174 7461 636b ifferent.(attack │ │ │ │ +0003a2b0: 6572 2d63 6f6e 7472 6f6c 6c65 6429 2064 er-controlled) d │ │ │ │ +0003a2c0: 6576 6963 652e 2020 4752 5542 2069 7320 evice. GRUB is │ │ │ │ +0003a2d0: 6174 2062 6573 7420 6f6e 6c79 206f 6e65 at best only one │ │ │ │ +0003a2e0: 206c 696e 6b20 696e 2061 2073 6563 7572 link in a secur │ │ │ │ +0003a2f0: 650a 626f 6f74 2063 6861 696e 2e0a 0a1f e.boot chain.... │ │ │ │ +0003a300: 0a46 696c 653a 2067 7275 622e 696e 666f .File: grub.info │ │ │ │ +0003a310: 2c20 204e 6f64 653a 2055 4546 4920 7365 , Node: UEFI se │ │ │ │ +0003a320: 6375 7265 2062 6f6f 7420 616e 6420 7368 cure boot and sh │ │ │ │ +0003a330: 696d 2c20 204e 6578 743a 2053 6563 7572 im, Next: Secur │ │ │ │ +0003a340: 6520 426f 6f74 2041 6476 616e 6365 6420 e Boot Advanced │ │ │ │ +0003a350: 5461 7267 6574 696e 672c 2020 5072 6576 Targeting, Prev │ │ │ │ +0003a360: 3a20 5573 696e 6720 6469 6769 7461 6c20 : Using digital │ │ │ │ +0003a370: 7369 676e 6174 7572 6573 2c20 2055 703a signatures, Up: │ │ │ │ +0003a380: 2053 6563 7572 6974 790a 0a31 382e 3320 Security..18.3 │ │ │ │ +0003a390: 5545 4649 2073 6563 7572 6520 626f 6f74 UEFI secure boot │ │ │ │ +0003a3a0: 2061 6e64 2073 6869 6d20 7375 7070 6f72 and shim suppor │ │ │ │ +0003a3b0: 740a 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d t.============== │ │ │ │ 0003a3c0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ -0003a3d0: 3d3d 3d3d 0a0a 5468 6520 4752 5542 2c20 ====..The GRUB, │ │ │ │ -0003a3e0: 6578 6365 7074 2074 6865 2027 6368 6169 except the 'chai │ │ │ │ -0003a3f0: 6e6c 6f61 6465 7227 2063 6f6d 6d61 6e64 nloader' command │ │ │ │ -0003a400: 2c20 776f 726b 7320 7769 7468 2074 6865 , works with the │ │ │ │ -0003a410: 2055 4546 4920 7365 6375 7265 0a62 6f6f UEFI secure.boo │ │ │ │ -0003a420: 7420 616e 6420 7468 6520 7368 696d 2e20 t and the shim. │ │ │ │ -0003a430: 2054 6869 7320 6675 6e63 7469 6f6e 616c This functional │ │ │ │ -0003a440: 6974 7920 6973 2070 726f 7669 6465 6420 ity is provided │ │ │ │ -0003a450: 6279 2074 6865 2073 6869 6d5f 6c6f 636b by the shim_lock │ │ │ │ -0003a460: 0a6d 6f64 756c 652e 2020 4974 2069 7320 .module. It is │ │ │ │ -0003a470: 7265 636f 6d6d 656e 6420 746f 2062 7569 recommend to bui │ │ │ │ -0003a480: 6c64 2069 6e20 7468 6973 2061 6e64 206f ld in this and o │ │ │ │ -0003a490: 7468 6572 2072 6571 7569 7265 6420 6d6f ther required mo │ │ │ │ -0003a4a0: 6475 6c65 730a 696e 746f 2074 6865 2027 dules.into the ' │ │ │ │ -0003a4b0: 636f 7265 2e69 6d67 272e 0a0a 2020 2041 core.img'... A │ │ │ │ -0003a4c0: 6c6c 2047 5255 4220 6d6f 6475 6c65 7320 ll GRUB modules │ │ │ │ -0003a4d0: 6e6f 7420 7374 6f72 6564 2069 6e20 7468 not stored in th │ │ │ │ -0003a4e0: 6520 2763 6f72 652e 696d 6727 2c20 4f53 e 'core.img', OS │ │ │ │ -0003a4f0: 206b 6572 6e65 6c73 2c20 4143 5049 0a74 kernels, ACPI.t │ │ │ │ -0003a500: 6162 6c65 732c 2044 6576 6963 6520 5472 ables, Device Tr │ │ │ │ -0003a510: 6565 732c 2065 7463 2e20 2068 6176 6520 ees, etc. have │ │ │ │ -0003a520: 746f 2062 6520 7369 676e 6564 2c20 652e to be signed, e. │ │ │ │ -0003a530: 672c 2075 7369 6e67 2050 4750 2e0a 4164 g, using PGP..Ad │ │ │ │ -0003a540: 6469 7469 6f6e 616c 6c79 2c20 7468 6520 ditionally, the │ │ │ │ -0003a550: 636f 6d6d 616e 6473 2074 6861 7420 6361 commands that ca │ │ │ │ -0003a560: 6e20 6265 2075 7365 6420 746f 2073 7562 n be used to sub │ │ │ │ -0003a570: 7665 7274 2074 6865 2055 4546 4920 7365 vert the UEFI se │ │ │ │ -0003a580: 6375 7265 0a62 6f6f 7420 6d65 6368 616e cure.boot mechan │ │ │ │ -0003a590: 6973 6d2c 2073 7563 6820 6173 2027 696f ism, such as 'io │ │ │ │ -0003a5a0: 7277 2720 616e 6420 276d 656d 7277 2720 rw' and 'memrw' │ │ │ │ -0003a5b0: 7769 6c6c 206e 6f74 2062 6520 6176 6169 will not be avai │ │ │ │ -0003a5c0: 6c61 626c 6520 7768 656e 0a74 6865 2055 lable when.the U │ │ │ │ -0003a5d0: 4546 4920 7365 6375 7265 2062 6f6f 7420 EFI secure boot │ │ │ │ -0003a5e0: 6973 2065 6e61 626c 6564 2e20 2054 6869 is enabled. Thi │ │ │ │ -0003a5f0: 7320 6973 2064 6f6e 6520 666f 7220 7365 s is done for se │ │ │ │ -0003a600: 6375 7269 7479 2072 6561 736f 6e73 2061 curity reasons a │ │ │ │ -0003a610: 6e64 0a61 7265 2065 6e66 6f72 6365 6420 nd.are enforced │ │ │ │ -0003a620: 6279 2074 6865 2047 5255 4220 4c6f 636b by the GRUB Lock │ │ │ │ -0003a630: 646f 776e 206d 6563 6861 6e69 736d 2028 down mechanism ( │ │ │ │ -0003a640: 2a6e 6f74 6520 4c6f 636b 646f 776e 3a3a *note Lockdown:: │ │ │ │ -0003a650: 292e 0a0a 1f0a 4669 6c65 3a20 6772 7562 ).....File: grub │ │ │ │ -0003a660: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 5365 .info, Node: Se │ │ │ │ -0003a670: 6375 7265 2042 6f6f 7420 4164 7661 6e63 cure Boot Advanc │ │ │ │ -0003a680: 6564 2054 6172 6765 7469 6e67 2c20 204e ed Targeting, N │ │ │ │ -0003a690: 6578 743a 204d 6561 7375 7265 6420 426f ext: Measured Bo │ │ │ │ -0003a6a0: 6f74 2c20 2050 7265 763a 2055 4546 4920 ot, Prev: UEFI │ │ │ │ -0003a6b0: 7365 6375 7265 2062 6f6f 7420 616e 6420 secure boot and │ │ │ │ -0003a6c0: 7368 696d 2c20 2055 703a 2053 6563 7572 shim, Up: Secur │ │ │ │ -0003a6d0: 6974 790a 0a31 382e 3420 456d 6265 6464 ity..18.4 Embedd │ │ │ │ -0003a6e0: 6564 2069 6e66 6f72 6d61 7469 6f6e 2066 ed information f │ │ │ │ -0003a6f0: 6f72 2067 656e 6572 6174 696f 6e20 6e75 or generation nu │ │ │ │ -0003a700: 6d62 6572 2062 6173 6564 2072 6576 6f63 mber based revoc │ │ │ │ -0003a710: 6174 696f 6e0a 3d3d 3d3d 3d3d 3d3d 3d3d ation.========== │ │ │ │ +0003a3d0: 3d3d 3d3d 3d3d 3d3d 0a0a 5468 6520 4752 ========..The GR │ │ │ │ +0003a3e0: 5542 2c20 6578 6365 7074 2074 6865 2027 UB, except the ' │ │ │ │ +0003a3f0: 6368 6169 6e6c 6f61 6465 7227 2063 6f6d chainloader' com │ │ │ │ +0003a400: 6d61 6e64 2c20 776f 726b 7320 7769 7468 mand, works with │ │ │ │ +0003a410: 2074 6865 2055 4546 4920 7365 6375 7265 the UEFI secure │ │ │ │ +0003a420: 0a62 6f6f 7420 616e 6420 7468 6520 7368 .boot and the sh │ │ │ │ +0003a430: 696d 2e20 2054 6869 7320 6675 6e63 7469 im. This functi │ │ │ │ +0003a440: 6f6e 616c 6974 7920 6973 2070 726f 7669 onality is provi │ │ │ │ +0003a450: 6465 6420 6279 2074 6865 2073 6869 6d5f ded by the shim_ │ │ │ │ +0003a460: 6c6f 636b 0a6d 6f64 756c 652e 2020 4974 lock.module. It │ │ │ │ +0003a470: 2069 7320 7265 636f 6d6d 656e 6420 746f is recommend to │ │ │ │ +0003a480: 2062 7569 6c64 2069 6e20 7468 6973 2061 build in this a │ │ │ │ +0003a490: 6e64 206f 7468 6572 2072 6571 7569 7265 nd other require │ │ │ │ +0003a4a0: 6420 6d6f 6475 6c65 730a 696e 746f 2074 d modules.into t │ │ │ │ +0003a4b0: 6865 2027 636f 7265 2e69 6d67 272e 0a0a he 'core.img'... │ │ │ │ +0003a4c0: 2020 2041 6c6c 2047 5255 4220 6d6f 6475 All GRUB modu │ │ │ │ +0003a4d0: 6c65 7320 6e6f 7420 7374 6f72 6564 2069 les not stored i │ │ │ │ +0003a4e0: 6e20 7468 6520 2763 6f72 652e 696d 6727 n the 'core.img' │ │ │ │ +0003a4f0: 2c20 4f53 206b 6572 6e65 6c73 2c20 4143 , OS kernels, AC │ │ │ │ +0003a500: 5049 0a74 6162 6c65 732c 2044 6576 6963 PI.tables, Devic │ │ │ │ +0003a510: 6520 5472 6565 732c 2065 7463 2e20 2068 e Trees, etc. h │ │ │ │ +0003a520: 6176 6520 746f 2062 6520 7369 676e 6564 ave to be signed │ │ │ │ +0003a530: 2c20 652e 672c 2075 7369 6e67 2050 4750 , e.g, using PGP │ │ │ │ +0003a540: 2e0a 4164 6469 7469 6f6e 616c 6c79 2c20 ..Additionally, │ │ │ │ +0003a550: 7468 6520 636f 6d6d 616e 6473 2074 6861 the commands tha │ │ │ │ +0003a560: 7420 6361 6e20 6265 2075 7365 6420 746f t can be used to │ │ │ │ +0003a570: 2073 7562 7665 7274 2074 6865 2055 4546 subvert the UEF │ │ │ │ +0003a580: 4920 7365 6375 7265 0a62 6f6f 7420 6d65 I secure.boot me │ │ │ │ +0003a590: 6368 616e 6973 6d2c 2073 7563 6820 6173 chanism, such as │ │ │ │ +0003a5a0: 2027 696f 7277 2720 616e 6420 276d 656d 'iorw' and 'mem │ │ │ │ +0003a5b0: 7277 2720 7769 6c6c 206e 6f74 2062 6520 rw' will not be │ │ │ │ +0003a5c0: 6176 6169 6c61 626c 6520 7768 656e 0a74 available when.t │ │ │ │ +0003a5d0: 6865 2055 4546 4920 7365 6375 7265 2062 he UEFI secure b │ │ │ │ +0003a5e0: 6f6f 7420 6973 2065 6e61 626c 6564 2e20 oot is enabled. │ │ │ │ +0003a5f0: 2054 6869 7320 6973 2064 6f6e 6520 666f This is done fo │ │ │ │ +0003a600: 7220 7365 6375 7269 7479 2072 6561 736f r security reaso │ │ │ │ +0003a610: 6e73 2061 6e64 0a61 7265 2065 6e66 6f72 ns and.are enfor │ │ │ │ +0003a620: 6365 6420 6279 2074 6865 2047 5255 4220 ced by the GRUB │ │ │ │ +0003a630: 4c6f 636b 646f 776e 206d 6563 6861 6e69 Lockdown mechani │ │ │ │ +0003a640: 736d 2028 2a6e 6f74 6520 4c6f 636b 646f sm (*note Lockdo │ │ │ │ +0003a650: 776e 3a3a 292e 0a0a 1f0a 4669 6c65 3a20 wn::).....File: │ │ │ │ +0003a660: 6772 7562 2e69 6e66 6f2c 2020 4e6f 6465 grub.info, Node │ │ │ │ +0003a670: 3a20 5365 6375 7265 2042 6f6f 7420 4164 : Secure Boot Ad │ │ │ │ +0003a680: 7661 6e63 6564 2054 6172 6765 7469 6e67 vanced Targeting │ │ │ │ +0003a690: 2c20 204e 6578 743a 204d 6561 7375 7265 , Next: Measure │ │ │ │ +0003a6a0: 6420 426f 6f74 2c20 2050 7265 763a 2055 d Boot, Prev: U │ │ │ │ +0003a6b0: 4546 4920 7365 6375 7265 2062 6f6f 7420 EFI secure boot │ │ │ │ +0003a6c0: 616e 6420 7368 696d 2c20 2055 703a 2053 and shim, Up: S │ │ │ │ +0003a6d0: 6563 7572 6974 790a 0a31 382e 3420 456d ecurity..18.4 Em │ │ │ │ +0003a6e0: 6265 6464 6564 2069 6e66 6f72 6d61 7469 bedded informati │ │ │ │ +0003a6f0: 6f6e 2066 6f72 2067 656e 6572 6174 696f on for generatio │ │ │ │ +0003a700: 6e20 6e75 6d62 6572 2062 6173 6564 2072 n number based r │ │ │ │ +0003a710: 6576 6f63 6174 696f 6e0a 3d3d 3d3d 3d3d evocation.====== │ │ │ │ 0003a720: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ 0003a730: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ 0003a740: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ -0003a750: 3d3d 3d3d 3d3d 0a0a 5468 6520 5365 6375 ======..The Secu │ │ │ │ -0003a760: 7265 2042 6f6f 7420 4164 7661 6e63 6564 re Boot Advanced │ │ │ │ -0003a770: 2054 6172 6765 7469 6e67 2028 5342 4154 Targeting (SBAT │ │ │ │ -0003a780: 2920 6973 2061 206d 6563 6861 6e69 736d ) is a mechanism │ │ │ │ -0003a790: 2074 6f20 616c 6c6f 7720 7468 650a 7265 to allow the.re │ │ │ │ -0003a7a0: 766f 6361 7469 6f6e 206f 6620 636f 6d70 vocation of comp │ │ │ │ -0003a7b0: 6f6e 656e 7473 2069 6e20 7468 6520 626f onents in the bo │ │ │ │ -0003a7c0: 6f74 2070 6174 6820 6279 2075 7369 6e67 ot path by using │ │ │ │ -0003a7d0: 2067 656e 6572 6174 696f 6e20 6e75 6d62 generation numb │ │ │ │ -0003a7e0: 6572 730a 656d 6265 6464 6564 2069 6e74 ers.embedded int │ │ │ │ -0003a7f0: 6f20 7468 6520 4546 4920 6269 6e61 7269 o the EFI binari │ │ │ │ -0003a800: 6573 2e20 2054 6865 2053 4241 5420 6d65 es. The SBAT me │ │ │ │ -0003a810: 7461 6461 7461 2069 7320 6c6f 6361 7465 tadata is locate │ │ │ │ -0003a820: 6420 696e 2061 6e0a 2e73 6261 7420 6461 d in an..sbat da │ │ │ │ -0003a830: 7461 2073 6563 7469 6f6e 2074 6861 7420 ta section that │ │ │ │ -0003a840: 6861 7320 7365 7420 6f66 2055 5446 2d38 has set of UTF-8 │ │ │ │ -0003a850: 2073 7472 696e 6773 2061 7320 636f 6d6d strings as comm │ │ │ │ -0003a860: 612d 7365 7061 7261 7465 640a 7661 6c75 a-separated.valu │ │ │ │ -0003a870: 6573 2028 4353 5629 2e20 5365 6520 3c68 es (CSV). See │ │ │ │ -0003a8b0: 2066 6f72 0a6d 6f72 6520 6465 7461 696c for.more detail │ │ │ │ -0003a8c0: 732e 0a0a 2020 2054 6f20 6164 6420 6120 s... To add a │ │ │ │ -0003a8d0: 6461 7461 2073 6563 7469 6f6e 2063 6f6e data section con │ │ │ │ -0003a8e0: 7461 696e 696e 6720 7468 6520 5342 4154 taining the SBAT │ │ │ │ -0003a8f0: 2069 6e66 6f72 6d61 7469 6f6e 2069 6e74 information int │ │ │ │ -0003a900: 6f20 7468 650a 6269 6e61 7279 2c20 7468 o the.binary, th │ │ │ │ -0003a910: 6520 272d 2d73 6261 7427 206f 7074 696f e '--sbat' optio │ │ │ │ -0003a920: 6e20 6f66 2027 6772 7562 2d6d 6b69 6d61 n of 'grub-mkima │ │ │ │ -0003a930: 6765 2720 636f 6d6d 616e 6420 7368 6f75 ge' command shou │ │ │ │ -0003a940: 6c64 2062 6520 7573 6564 2e0a 5468 6520 ld be used..The │ │ │ │ -0003a950: 636f 6e74 656e 7420 6f66 2061 2043 5356 content of a CSV │ │ │ │ -0003a960: 2066 696c 652c 2065 6e63 6f64 6564 2077 file, encoded w │ │ │ │ -0003a970: 6974 6820 5554 462d 382c 2069 7320 636f ith UTF-8, is co │ │ │ │ -0003a980: 7069 6564 2061 7320 6973 2074 6f20 7468 pied as is to th │ │ │ │ -0003a990: 650a 2e73 6261 7420 6461 7461 2073 6563 e..sbat data sec │ │ │ │ -0003a9a0: 7469 6f6e 2069 6e74 6f20 7468 6520 6765 tion into the ge │ │ │ │ -0003a9b0: 6e65 7261 7465 6420 4546 4920 6269 6e61 nerated EFI bina │ │ │ │ -0003a9c0: 7279 2e20 2054 6865 2043 5356 2066 696c ry. The CSV fil │ │ │ │ -0003a9d0: 6520 6361 6e20 6265 0a73 746f 7265 6420 e can be.stored │ │ │ │ -0003a9e0: 616e 7977 6865 7265 206f 6e20 7468 6520 anywhere on the │ │ │ │ -0003a9f0: 6669 6c65 2073 7973 7465 6d2e 0a0a 2020 file system... │ │ │ │ -0003aa00: 2020 2067 7275 622d 6d6b 696d 6167 6520 grub-mkimage │ │ │ │ -0003aa10: 2d4f 2078 3836 5f36 342d 6566 6920 2d6f -O x86_64-efi -o │ │ │ │ -0003aa20: 2067 7275 6278 3634 2e65 6669 202d 7020 grubx64.efi -p │ │ │ │ -0003aa30: 2728 7466 7470 292f 6772 7562 2720 2d2d '(tftp)/grub' -- │ │ │ │ -0003aa40: 7362 6174 2073 6261 742e 6373 7620 6566 sbat sbat.csv ef │ │ │ │ -0003aa50: 696e 6574 2074 6674 700a 0a1f 0a46 696c inet tftp....Fil │ │ │ │ -0003aa60: 653a 2067 7275 622e 696e 666f 2c20 204e e: grub.info, N │ │ │ │ -0003aa70: 6f64 653a 204d 6561 7375 7265 6420 426f ode: Measured Bo │ │ │ │ -0003aa80: 6f74 2c20 204e 6578 743a 204c 6f63 6b64 ot, Next: Lockd │ │ │ │ -0003aa90: 6f77 6e2c 2020 5072 6576 3a20 5365 6375 own, Prev: Secu │ │ │ │ -0003aaa0: 7265 2042 6f6f 7420 4164 7661 6e63 6564 re Boot Advanced │ │ │ │ -0003aab0: 2054 6172 6765 7469 6e67 2c20 2055 703a Targeting, Up: │ │ │ │ -0003aac0: 2053 6563 7572 6974 790a 0a31 382e 3520 Security..18.5 │ │ │ │ -0003aad0: 4d65 6173 7572 696e 6720 626f 6f74 2063 Measuring boot c │ │ │ │ -0003aae0: 6f6d 706f 6e65 6e74 730a 3d3d 3d3d 3d3d omponents.====== │ │ │ │ +0003a750: 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a 5468 6520 ==========..The │ │ │ │ +0003a760: 5365 6375 7265 2042 6f6f 7420 4164 7661 Secure Boot Adva │ │ │ │ +0003a770: 6e63 6564 2054 6172 6765 7469 6e67 2028 nced Targeting ( │ │ │ │ +0003a780: 5342 4154 2920 6973 2061 206d 6563 6861 SBAT) is a mecha │ │ │ │ +0003a790: 6e69 736d 2074 6f20 616c 6c6f 7720 7468 nism to allow th │ │ │ │ +0003a7a0: 650a 7265 766f 6361 7469 6f6e 206f 6620 e.revocation of │ │ │ │ +0003a7b0: 636f 6d70 6f6e 656e 7473 2069 6e20 7468 components in th │ │ │ │ +0003a7c0: 6520 626f 6f74 2070 6174 6820 6279 2075 e boot path by u │ │ │ │ +0003a7d0: 7369 6e67 2067 656e 6572 6174 696f 6e20 sing generation │ │ │ │ +0003a7e0: 6e75 6d62 6572 730a 656d 6265 6464 6564 numbers.embedded │ │ │ │ +0003a7f0: 2069 6e74 6f20 7468 6520 4546 4920 6269 into the EFI bi │ │ │ │ +0003a800: 6e61 7269 6573 2e20 2054 6865 2053 4241 naries. The SBA │ │ │ │ +0003a810: 5420 6d65 7461 6461 7461 2069 7320 6c6f T metadata is lo │ │ │ │ +0003a820: 6361 7465 6420 696e 2061 6e0a 2e73 6261 cated in an..sba │ │ │ │ +0003a830: 7420 6461 7461 2073 6563 7469 6f6e 2074 t data section t │ │ │ │ +0003a840: 6861 7420 6861 7320 7365 7420 6f66 2055 hat has set of U │ │ │ │ +0003a850: 5446 2d38 2073 7472 696e 6773 2061 7320 TF-8 strings as │ │ │ │ +0003a860: 636f 6d6d 612d 7365 7061 7261 7465 640a comma-separated. │ │ │ │ +0003a870: 7661 6c75 6573 2028 4353 5629 2e20 5365 values (CSV). Se │ │ │ │ +0003a880: 6520 3c68 7474 7073 3a2f 2f67 6974 6875 e for.more de │ │ │ │ +0003a8c0: 7461 696c 732e 0a0a 2020 2054 6f20 6164 tails... To ad │ │ │ │ +0003a8d0: 6420 6120 6461 7461 2073 6563 7469 6f6e d a data section │ │ │ │ +0003a8e0: 2063 6f6e 7461 696e 696e 6720 7468 6520 containing the │ │ │ │ +0003a8f0: 5342 4154 2069 6e66 6f72 6d61 7469 6f6e SBAT information │ │ │ │ +0003a900: 2069 6e74 6f20 7468 650a 6269 6e61 7279 into the.binary │ │ │ │ +0003a910: 2c20 7468 6520 272d 2d73 6261 7427 206f , the '--sbat' o │ │ │ │ +0003a920: 7074 696f 6e20 6f66 2027 6772 7562 2d6d ption of 'grub-m │ │ │ │ +0003a930: 6b69 6d61 6765 2720 636f 6d6d 616e 6420 kimage' command │ │ │ │ +0003a940: 7368 6f75 6c64 2062 6520 7573 6564 2e0a should be used.. │ │ │ │ +0003a950: 5468 6520 636f 6e74 656e 7420 6f66 2061 The content of a │ │ │ │ +0003a960: 2043 5356 2066 696c 652c 2065 6e63 6f64 CSV file, encod │ │ │ │ +0003a970: 6564 2077 6974 6820 5554 462d 382c 2069 ed with UTF-8, i │ │ │ │ +0003a980: 7320 636f 7069 6564 2061 7320 6973 2074 s copied as is t │ │ │ │ +0003a990: 6f20 7468 650a 2e73 6261 7420 6461 7461 o the..sbat data │ │ │ │ +0003a9a0: 2073 6563 7469 6f6e 2069 6e74 6f20 7468 section into th │ │ │ │ +0003a9b0: 6520 6765 6e65 7261 7465 6420 4546 4920 e generated EFI │ │ │ │ +0003a9c0: 6269 6e61 7279 2e20 2054 6865 2043 5356 binary. The CSV │ │ │ │ +0003a9d0: 2066 696c 6520 6361 6e20 6265 0a73 746f file can be.sto │ │ │ │ +0003a9e0: 7265 6420 616e 7977 6865 7265 206f 6e20 red anywhere on │ │ │ │ +0003a9f0: 7468 6520 6669 6c65 2073 7973 7465 6d2e the file system. │ │ │ │ +0003aa00: 0a0a 2020 2020 2067 7275 622d 6d6b 696d .. grub-mkim │ │ │ │ +0003aa10: 6167 6520 2d4f 2078 3836 5f36 342d 6566 age -O x86_64-ef │ │ │ │ +0003aa20: 6920 2d6f 2067 7275 6278 3634 2e65 6669 i -o grubx64.efi │ │ │ │ +0003aa30: 202d 7020 2728 7466 7470 292f 6772 7562 -p '(tftp)/grub │ │ │ │ +0003aa40: 2720 2d2d 7362 6174 2073 6261 742e 6373 ' --sbat sbat.cs │ │ │ │ +0003aa50: 7620 6566 696e 6574 2074 6674 700a 0a1f v efinet tftp... │ │ │ │ +0003aa60: 0a46 696c 653a 2067 7275 622e 696e 666f .File: grub.info │ │ │ │ +0003aa70: 2c20 204e 6f64 653a 204d 6561 7375 7265 , Node: Measure │ │ │ │ +0003aa80: 6420 426f 6f74 2c20 204e 6578 743a 204c d Boot, Next: L │ │ │ │ +0003aa90: 6f63 6b64 6f77 6e2c 2020 5072 6576 3a20 ockdown, Prev: │ │ │ │ +0003aaa0: 5365 6375 7265 2042 6f6f 7420 4164 7661 Secure Boot Adva │ │ │ │ +0003aab0: 6e63 6564 2054 6172 6765 7469 6e67 2c20 nced Targeting, │ │ │ │ +0003aac0: 2055 703a 2053 6563 7572 6974 790a 0a31 Up: Security..1 │ │ │ │ +0003aad0: 382e 3520 4d65 6173 7572 696e 6720 626f 8.5 Measuring bo │ │ │ │ +0003aae0: 6f74 2063 6f6d 706f 6e65 6e74 730a 3d3d ot components.== │ │ │ │ 0003aaf0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ -0003ab00: 3d3d 3d3d 3d3d 3d3d 0a0a 4966 2074 6865 ========..If the │ │ │ │ -0003ab10: 2074 706d 206d 6f64 756c 6520 6973 206c tpm module is l │ │ │ │ -0003ab20: 6f61 6465 6420 616e 6420 7468 6520 706c oaded and the pl │ │ │ │ -0003ab30: 6174 666f 726d 2068 6173 2061 2054 7275 atform has a Tru │ │ │ │ -0003ab40: 7374 6564 2050 6c61 7466 6f72 6d0a 4d6f sted Platform.Mo │ │ │ │ -0003ab50: 6475 6c65 2069 6e73 7461 6c6c 6564 2c20 dule installed, │ │ │ │ -0003ab60: 4752 5542 2077 696c 6c20 6c6f 6720 6561 GRUB will log ea │ │ │ │ -0003ab70: 6368 2063 6f6d 6d61 6e64 2065 7865 6375 ch command execu │ │ │ │ -0003ab80: 7465 6420 616e 6420 6561 6368 2066 696c ted and each fil │ │ │ │ -0003ab90: 650a 6c6f 6164 6564 2069 6e74 6f20 7468 e.loaded into th │ │ │ │ -0003aba0: 6520 5450 4d20 6576 656e 7420 6c6f 6720 e TPM event log │ │ │ │ -0003abb0: 616e 6420 6578 7465 6e64 2074 6865 2050 and extend the P │ │ │ │ -0003abc0: 4352 2076 616c 7565 7320 696e 2074 6865 CR values in the │ │ │ │ -0003abd0: 2054 504d 0a63 6f72 7265 7370 6f6e 6469 TPM.correspondi │ │ │ │ -0003abe0: 6e67 6c79 2e20 2041 6c6c 2065 7665 6e74 ngly. All event │ │ │ │ -0003abf0: 7320 7769 6c6c 2062 6520 6c6f 6767 6564 s will be logged │ │ │ │ -0003ac00: 2069 6e74 6f20 7468 6520 5043 5220 6465 into the PCR de │ │ │ │ -0003ac10: 7363 7269 6265 6420 6265 6c6f 770a 7769 scribed below.wi │ │ │ │ -0003ac20: 7468 2061 2074 7970 6520 6f66 2045 565f th a type of EV_ │ │ │ │ -0003ac30: 4950 4c20 616e 6420 616e 2065 7665 6e74 IPL and an event │ │ │ │ -0003ac40: 2064 6573 6372 6970 7469 6f6e 2061 7320 description as │ │ │ │ -0003ac50: 6465 7363 7269 6265 6420 6265 6c6f 772e described below. │ │ │ │ -0003ac60: 0a0a 4576 656e 7420 7479 7065 2020 2020 ..Event type │ │ │ │ -0003ac70: 2020 2020 2020 2020 2050 4352 2020 2020 PCR │ │ │ │ -0003ac80: 2044 6573 6372 6970 7469 6f6e 0a2d 2d2d Description.--- │ │ │ │ -0003ac90: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ +0003ab00: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a 4966 ============..If │ │ │ │ +0003ab10: 2074 6865 2074 706d 206d 6f64 756c 6520 the tpm module │ │ │ │ +0003ab20: 6973 206c 6f61 6465 6420 616e 6420 7468 is loaded and th │ │ │ │ +0003ab30: 6520 706c 6174 666f 726d 2068 6173 2061 e platform has a │ │ │ │ +0003ab40: 2054 7275 7374 6564 2050 6c61 7466 6f72 Trusted Platfor │ │ │ │ +0003ab50: 6d0a 4d6f 6475 6c65 2069 6e73 7461 6c6c m.Module install │ │ │ │ +0003ab60: 6564 2c20 4752 5542 2077 696c 6c20 6c6f ed, GRUB will lo │ │ │ │ +0003ab70: 6720 6561 6368 2063 6f6d 6d61 6e64 2065 g each command e │ │ │ │ +0003ab80: 7865 6375 7465 6420 616e 6420 6561 6368 xecuted and each │ │ │ │ +0003ab90: 2066 696c 650a 6c6f 6164 6564 2069 6e74 file.loaded int │ │ │ │ +0003aba0: 6f20 7468 6520 5450 4d20 6576 656e 7420 o the TPM event │ │ │ │ +0003abb0: 6c6f 6720 616e 6420 6578 7465 6e64 2074 log and extend t │ │ │ │ +0003abc0: 6865 2050 4352 2076 616c 7565 7320 696e he PCR values in │ │ │ │ +0003abd0: 2074 6865 2054 504d 0a63 6f72 7265 7370 the TPM.corresp │ │ │ │ +0003abe0: 6f6e 6469 6e67 6c79 2e20 2041 6c6c 2065 ondingly. All e │ │ │ │ +0003abf0: 7665 6e74 7320 7769 6c6c 2062 6520 6c6f vents will be lo │ │ │ │ +0003ac00: 6767 6564 2069 6e74 6f20 7468 6520 5043 gged into the PC │ │ │ │ +0003ac10: 5220 6465 7363 7269 6265 6420 6265 6c6f R described belo │ │ │ │ +0003ac20: 770a 7769 7468 2061 2074 7970 6520 6f66 w.with a type of │ │ │ │ +0003ac30: 2045 565f 4950 4c20 616e 6420 616e 2065 EV_IPL and an e │ │ │ │ +0003ac40: 7665 6e74 2064 6573 6372 6970 7469 6f6e vent description │ │ │ │ +0003ac50: 2061 7320 6465 7363 7269 6265 6420 6265 as described be │ │ │ │ +0003ac60: 6c6f 772e 0a0a 4576 656e 7420 7479 7065 low...Event type │ │ │ │ +0003ac70: 2020 2020 2020 2020 2020 2020 2050 4352 PCR │ │ │ │ +0003ac80: 2020 2020 2044 6573 6372 6970 7469 6f6e Description │ │ │ │ +0003ac90: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d .--------------- │ │ │ │ 0003aca0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ 0003acb0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ 0003acc0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ -0003acd0: 2d2d 2d2d 2d2d 2d2d 0a43 6f6d 6d61 6e64 --------.Command │ │ │ │ -0003ace0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -0003acf0: 3820 2020 2020 2020 416c 6c20 6578 6563 8 All exec │ │ │ │ -0003ad00: 7574 6564 2063 6f6d 6d61 6e64 7320 2869 uted commands (i │ │ │ │ -0003ad10: 6e63 6c75 6469 6e67 2074 686f 7365 0a20 ncluding those. │ │ │ │ -0003ad20: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -0003ad30: 2020 2020 2020 2020 2020 2020 2020 6672 fr │ │ │ │ -0003ad40: 6f6d 2063 6f6e 6669 6775 7261 7469 6f6e om configuration │ │ │ │ -0003ad50: 2066 696c 6573 2920 7769 6c6c 2062 6520 files) will be │ │ │ │ -0003ad60: 6c6f 6767 6564 0a20 2020 2020 2020 2020 logged. │ │ │ │ +0003acd0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a43 6f6d ------------.Com │ │ │ │ +0003ace0: 6d61 6e64 2020 2020 2020 2020 2020 2020 mand │ │ │ │ +0003acf0: 2020 2020 3820 2020 2020 2020 416c 6c20 8 All │ │ │ │ +0003ad00: 6578 6563 7574 6564 2063 6f6d 6d61 6e64 executed command │ │ │ │ +0003ad10: 7320 2869 6e63 6c75 6469 6e67 2074 686f s (including tho │ │ │ │ +0003ad20: 7365 0a20 2020 2020 2020 2020 2020 2020 se. │ │ │ │ +0003ad30: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +0003ad40: 2020 6672 6f6d 2063 6f6e 6669 6775 7261 from configura │ │ │ │ +0003ad50: 7469 6f6e 2066 696c 6573 2920 7769 6c6c tion files) will │ │ │ │ +0003ad60: 2062 6520 6c6f 6767 6564 0a20 2020 2020 be logged. │ │ │ │ 0003ad70: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -0003ad80: 2020 2020 2020 616e 6420 6d65 6173 7572 and measur │ │ │ │ -0003ad90: 6564 2061 7320 656e 7465 7265 6420 7769 ed as entered wi │ │ │ │ -0003ada0: 7468 2061 2070 7265 6669 7820 6f66 0a20 th a prefix of. │ │ │ │ -0003adb0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -0003adc0: 2020 2020 2020 2020 2020 2020 2020 2267 "g │ │ │ │ -0003add0: 7275 625f 636d 643a 2022 0a4b 6572 6e65 rub_cmd: ".Kerne │ │ │ │ -0003ade0: 6c20 636f 6d6d 616e 6420 6c69 6e65 2020 l command line │ │ │ │ -0003adf0: 2020 3820 2020 2020 2020 416e 7920 636f 8 Any co │ │ │ │ -0003ae00: 6d6d 616e 6420 6c69 6e65 2070 6173 7365 mmand line passe │ │ │ │ -0003ae10: 6420 746f 2061 206b 6572 6e65 6c20 7769 d to a kernel wi │ │ │ │ -0003ae20: 6c6c 0a20 2020 2020 2020 2020 2020 2020 ll. │ │ │ │ +0003ad80: 2020 2020 2020 2020 2020 616e 6420 6d65 and me │ │ │ │ +0003ad90: 6173 7572 6564 2061 7320 656e 7465 7265 asured as entere │ │ │ │ +0003ada0: 6420 7769 7468 2061 2070 7265 6669 7820 d with a prefix │ │ │ │ +0003adb0: 6f66 0a20 2020 2020 2020 2020 2020 2020 of. │ │ │ │ +0003adc0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +0003add0: 2020 2267 7275 625f 636d 643a 2022 0a4b "grub_cmd: ".K │ │ │ │ +0003ade0: 6572 6e65 6c20 636f 6d6d 616e 6420 6c69 ernel command li │ │ │ │ +0003adf0: 6e65 2020 2020 3820 2020 2020 2020 416e ne 8 An │ │ │ │ +0003ae00: 7920 636f 6d6d 616e 6420 6c69 6e65 2070 y command line p │ │ │ │ +0003ae10: 6173 7365 6420 746f 2061 206b 6572 6e65 assed to a kerne │ │ │ │ +0003ae20: 6c20 7769 6c6c 0a20 2020 2020 2020 2020 l will. │ │ │ │ 0003ae30: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -0003ae40: 2020 6265 206c 6f67 6765 6420 616e 6420 be logged and │ │ │ │ -0003ae50: 6d65 6173 7572 6564 2061 7320 656e 7465 measured as ente │ │ │ │ -0003ae60: 7265 6420 7769 7468 2061 0a20 2020 2020 red with a. │ │ │ │ +0003ae40: 2020 2020 2020 6265 206c 6f67 6765 6420 be logged │ │ │ │ +0003ae50: 616e 6420 6d65 6173 7572 6564 2061 7320 and measured as │ │ │ │ +0003ae60: 656e 7465 7265 6420 7769 7468 2061 0a20 entered with a. │ │ │ │ 0003ae70: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -0003ae80: 2020 2020 2020 2020 2020 7072 6566 6978 prefix │ │ │ │ -0003ae90: 206f 6620 226b 6572 6e65 6c5f 636d 646c of "kernel_cmdl │ │ │ │ -0003aea0: 696e 653a 2022 0a4d 6f64 756c 6520 636f ine: ".Module co │ │ │ │ -0003aeb0: 6d6d 616e 6420 6c69 6e65 2020 2020 3820 mmand line 8 │ │ │ │ -0003aec0: 2020 2020 2020 416e 7920 636f 6d6d 616e Any comman │ │ │ │ -0003aed0: 6420 6c69 6e65 2070 6173 7365 6420 746f d line passed to │ │ │ │ -0003aee0: 2061 206b 6572 6e65 6c0a 2020 2020 2020 a kernel. │ │ │ │ +0003ae80: 2020 2020 2020 2020 2020 2020 2020 7072 pr │ │ │ │ +0003ae90: 6566 6978 206f 6620 226b 6572 6e65 6c5f efix of "kernel_ │ │ │ │ +0003aea0: 636d 646c 696e 653a 2022 0a4d 6f64 756c cmdline: ".Modul │ │ │ │ +0003aeb0: 6520 636f 6d6d 616e 6420 6c69 6e65 2020 e command line │ │ │ │ +0003aec0: 2020 3820 2020 2020 2020 416e 7920 636f 8 Any co │ │ │ │ +0003aed0: 6d6d 616e 6420 6c69 6e65 2070 6173 7365 mmand line passe │ │ │ │ +0003aee0: 6420 746f 2061 206b 6572 6e65 6c0a 2020 d to a kernel. │ │ │ │ 0003aef0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -0003af00: 2020 2020 2020 2020 206d 6f64 756c 6520 module │ │ │ │ -0003af10: 7769 6c6c 2062 6520 6c6f 6767 6564 2061 will be logged a │ │ │ │ -0003af20: 6e64 206d 6561 7375 7265 6420 6173 0a20 nd measured as. │ │ │ │ -0003af30: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -0003af40: 2020 2020 2020 2020 2020 2020 2020 656e en │ │ │ │ -0003af50: 7465 7265 6420 7769 7468 2061 2070 7265 tered with a pre │ │ │ │ -0003af60: 6669 7820 6f66 2022 6d6f 6475 6c65 5f63 fix of "module_c │ │ │ │ -0003af70: 6d64 6c69 6e65 3a0a 2020 2020 2020 2020 mdline:. │ │ │ │ +0003af00: 2020 2020 2020 2020 2020 2020 206d 6f64 mod │ │ │ │ +0003af10: 756c 6520 7769 6c6c 2062 6520 6c6f 6767 ule will be logg │ │ │ │ +0003af20: 6564 2061 6e64 206d 6561 7375 7265 6420 ed and measured │ │ │ │ +0003af30: 6173 0a20 2020 2020 2020 2020 2020 2020 as. │ │ │ │ +0003af40: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +0003af50: 2020 656e 7465 7265 6420 7769 7468 2061 entered with a │ │ │ │ +0003af60: 2070 7265 6669 7820 6f66 2022 6d6f 6475 prefix of "modu │ │ │ │ +0003af70: 6c65 5f63 6d64 6c69 6e65 3a0a 2020 2020 le_cmdline:. │ │ │ │ 0003af80: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -0003af90: 2020 2020 2020 2022 0a46 696c 6573 2020 ".Files │ │ │ │ -0003afa0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -0003afb0: 3920 2020 2020 2020 416e 7920 6669 6c65 9 Any file │ │ │ │ -0003afc0: 2072 6561 6420 6279 2047 5255 4220 7769 read by GRUB wi │ │ │ │ -0003afd0: 6c6c 2062 6520 6c6f 6767 6564 2061 6e64 ll be logged and │ │ │ │ -0003afe0: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ +0003af90: 2020 2020 2020 2020 2020 2022 0a46 696c ".Fil │ │ │ │ +0003afa0: 6573 2020 2020 2020 2020 2020 2020 2020 es │ │ │ │ +0003afb0: 2020 2020 3920 2020 2020 2020 416e 7920 9 Any │ │ │ │ +0003afc0: 6669 6c65 2072 6561 6420 6279 2047 5255 file read by GRU │ │ │ │ +0003afd0: 4220 7769 6c6c 2062 6520 6c6f 6767 6564 B will be logged │ │ │ │ +0003afe0: 2061 6e64 0a20 2020 2020 2020 2020 2020 and. │ │ │ │ 0003aff0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -0003b000: 6d65 6173 7572 6564 2077 6974 6820 6120 measured with a │ │ │ │ -0003b010: 6465 7363 7269 7074 6976 6520 7465 7874 descriptive text │ │ │ │ -0003b020: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ +0003b000: 2020 2020 6d65 6173 7572 6564 2077 6974 measured wit │ │ │ │ +0003b010: 6820 6120 6465 7363 7269 7074 6976 6520 h a descriptive │ │ │ │ +0003b020: 7465 7874 0a20 2020 2020 2020 2020 2020 text. │ │ │ │ 0003b030: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -0003b040: 636f 7272 6573 706f 6e64 696e 6720 746f corresponding to │ │ │ │ -0003b050: 2074 6865 2066 696c 656e 616d 652e 0a0a the filename... │ │ │ │ -0003b060: 2020 2047 5255 4220 7769 6c6c 206e 6f74 GRUB will not │ │ │ │ -0003b070: 206d 6561 7375 7265 2069 7473 206f 776e measure its own │ │ │ │ -0003b080: 2027 636f 7265 2e69 6d67 2720 2d20 6974 'core.img' - it │ │ │ │ -0003b090: 2069 7320 6578 7065 6374 6564 2074 6861 is expected tha │ │ │ │ -0003b0a0: 740a 6669 726d 7761 7265 2077 696c 6c20 t.firmware will │ │ │ │ -0003b0b0: 6361 7272 7920 7468 6973 206f 7574 2e20 carry this out. │ │ │ │ -0003b0c0: 2047 5255 4220 7769 6c6c 2061 6c73 6f20 GRUB will also │ │ │ │ -0003b0d0: 6e6f 7420 7065 7266 6f72 6d20 616e 790a not perform any. │ │ │ │ -0003b0e0: 6d65 6173 7572 656d 656e 7473 2075 6e74 measurements unt │ │ │ │ -0003b0f0: 696c 2074 6865 2074 706d 206d 6f64 756c il the tpm modul │ │ │ │ -0003b100: 6520 6973 206c 6f61 6465 642e 2020 4173 e is loaded. As │ │ │ │ -0003b110: 2073 7563 6820 6974 2069 7320 7265 636f such it is reco │ │ │ │ -0003b120: 6d6d 656e 6465 640a 7468 6174 2074 6865 mmended.that the │ │ │ │ -0003b130: 2074 706d 206d 6f64 756c 6520 6265 2062 tpm module be b │ │ │ │ -0003b140: 7569 6c74 2069 6e74 6f20 2763 6f72 652e uilt into 'core. │ │ │ │ -0003b150: 696d 6727 2069 6e20 6f72 6465 7220 746f img' in order to │ │ │ │ -0003b160: 2061 766f 6964 2061 0a70 6f74 656e 7469 avoid a.potenti │ │ │ │ -0003b170: 616c 2067 6170 2069 6e20 6d65 6173 7572 al gap in measur │ │ │ │ -0003b180: 656d 656e 7420 6265 7477 6565 6e20 2763 ement between 'c │ │ │ │ -0003b190: 6f72 652e 696d 6727 2062 6569 6e67 206c ore.img' being l │ │ │ │ -0003b1a0: 6f61 6465 6420 616e 6420 7468 6520 7470 oaded and the tp │ │ │ │ -0003b1b0: 6d0a 6d6f 6475 6c65 2062 6569 6e67 206c m.module being l │ │ │ │ -0003b1c0: 6f61 6465 642e 0a0a 2020 204d 6561 7375 oaded... Measu │ │ │ │ -0003b1d0: 7265 6420 626f 6f74 2069 7320 6375 7272 red boot is curr │ │ │ │ -0003b1e0: 656e 746c 7920 6f6e 6c79 2073 7570 706f ently only suppo │ │ │ │ -0003b1f0: 7274 6564 206f 6e20 4546 4920 706c 6174 rted on EFI plat │ │ │ │ -0003b200: 666f 726d 732e 0a0a 1f0a 4669 6c65 3a20 forms.....File: │ │ │ │ -0003b210: 6772 7562 2e69 6e66 6f2c 2020 4e6f 6465 grub.info, Node │ │ │ │ -0003b220: 3a20 4c6f 636b 646f 776e 2c20 2050 7265 : Lockdown, Pre │ │ │ │ -0003b230: 763a 204d 6561 7375 7265 6420 426f 6f74 v: Measured Boot │ │ │ │ -0003b240: 2c20 2055 703a 2053 6563 7572 6974 790a , Up: Security. │ │ │ │ -0003b250: 0a31 382e 3620 4c6f 636b 646f 776e 2077 .18.6 Lockdown w │ │ │ │ -0003b260: 6865 6e20 626f 6f74 696e 6720 6f6e 2061 hen booting on a │ │ │ │ -0003b270: 2073 6563 7572 6520 7365 7475 700a 3d3d secure setup.== │ │ │ │ -0003b280: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ +0003b040: 2020 2020 636f 7272 6573 706f 6e64 696e correspondin │ │ │ │ +0003b050: 6720 746f 2074 6865 2066 696c 656e 616d g to the filenam │ │ │ │ +0003b060: 652e 0a0a 2020 2047 5255 4220 7769 6c6c e... GRUB will │ │ │ │ +0003b070: 206e 6f74 206d 6561 7375 7265 2069 7473 not measure its │ │ │ │ +0003b080: 206f 776e 2027 636f 7265 2e69 6d67 2720 own 'core.img' │ │ │ │ +0003b090: 2d20 6974 2069 7320 6578 7065 6374 6564 - it is expected │ │ │ │ +0003b0a0: 2074 6861 740a 6669 726d 7761 7265 2077 that.firmware w │ │ │ │ +0003b0b0: 696c 6c20 6361 7272 7920 7468 6973 206f ill carry this o │ │ │ │ +0003b0c0: 7574 2e20 2047 5255 4220 7769 6c6c 2061 ut. GRUB will a │ │ │ │ +0003b0d0: 6c73 6f20 6e6f 7420 7065 7266 6f72 6d20 lso not perform │ │ │ │ +0003b0e0: 616e 790a 6d65 6173 7572 656d 656e 7473 any.measurements │ │ │ │ +0003b0f0: 2075 6e74 696c 2074 6865 2074 706d 206d until the tpm m │ │ │ │ +0003b100: 6f64 756c 6520 6973 206c 6f61 6465 642e odule is loaded. │ │ │ │ +0003b110: 2020 4173 2073 7563 6820 6974 2069 7320 As such it is │ │ │ │ +0003b120: 7265 636f 6d6d 656e 6465 640a 7468 6174 recommended.that │ │ │ │ +0003b130: 2074 6865 2074 706d 206d 6f64 756c 6520 the tpm module │ │ │ │ +0003b140: 6265 2062 7569 6c74 2069 6e74 6f20 2763 be built into 'c │ │ │ │ +0003b150: 6f72 652e 696d 6727 2069 6e20 6f72 6465 ore.img' in orde │ │ │ │ +0003b160: 7220 746f 2061 766f 6964 2061 0a70 6f74 r to avoid a.pot │ │ │ │ +0003b170: 656e 7469 616c 2067 6170 2069 6e20 6d65 ential gap in me │ │ │ │ +0003b180: 6173 7572 656d 656e 7420 6265 7477 6565 asurement betwee │ │ │ │ +0003b190: 6e20 2763 6f72 652e 696d 6727 2062 6569 n 'core.img' bei │ │ │ │ +0003b1a0: 6e67 206c 6f61 6465 6420 616e 6420 7468 ng loaded and th │ │ │ │ +0003b1b0: 6520 7470 6d0a 6d6f 6475 6c65 2062 6569 e tpm.module bei │ │ │ │ +0003b1c0: 6e67 206c 6f61 6465 642e 0a0a 2020 204d ng loaded... M │ │ │ │ +0003b1d0: 6561 7375 7265 6420 626f 6f74 2069 7320 easured boot is │ │ │ │ +0003b1e0: 6375 7272 656e 746c 7920 6f6e 6c79 2073 currently only s │ │ │ │ +0003b1f0: 7570 706f 7274 6564 206f 6e20 4546 4920 upported on EFI │ │ │ │ +0003b200: 706c 6174 666f 726d 732e 0a0a 1f0a 4669 platforms.....Fi │ │ │ │ +0003b210: 6c65 3a20 6772 7562 2e69 6e66 6f2c 2020 le: grub.info, │ │ │ │ +0003b220: 4e6f 6465 3a20 4c6f 636b 646f 776e 2c20 Node: Lockdown, │ │ │ │ +0003b230: 2050 7265 763a 204d 6561 7375 7265 6420 Prev: Measured │ │ │ │ +0003b240: 426f 6f74 2c20 2055 703a 2053 6563 7572 Boot, Up: Secur │ │ │ │ +0003b250: 6974 790a 0a31 382e 3620 4c6f 636b 646f ity..18.6 Lockdo │ │ │ │ +0003b260: 776e 2077 6865 6e20 626f 6f74 696e 6720 wn when booting │ │ │ │ +0003b270: 6f6e 2061 2073 6563 7572 6520 7365 7475 on a secure setu │ │ │ │ +0003b280: 700a 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d p.============== │ │ │ │ 0003b290: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ -0003b2a0: 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a 5468 6520 ==========..The │ │ │ │ -0003b2b0: 4752 5542 2063 616e 2062 6520 6c6f 636b GRUB can be lock │ │ │ │ -0003b2c0: 6564 2064 6f77 6e20 7768 656e 2062 6f6f ed down when boo │ │ │ │ -0003b2d0: 7465 6420 6f6e 2061 2073 6563 7572 6520 ted on a secure │ │ │ │ -0003b2e0: 626f 6f74 2065 6e76 6972 6f6e 6d65 6e74 boot environment │ │ │ │ -0003b2f0: 2c0a 666f 7220 6578 616d 706c 6520 6966 ,.for example if │ │ │ │ -0003b300: 2074 6865 2055 4546 4920 7365 6375 7265 the UEFI secure │ │ │ │ -0003b310: 2062 6f6f 7420 6973 2065 6e61 626c 6564 boot is enabled │ │ │ │ -0003b320: 2e20 204f 6e20 6120 6c6f 636b 6564 2064 . On a locked d │ │ │ │ -0003b330: 6f77 6e0a 636f 6e66 6967 7572 6174 696f own.configuratio │ │ │ │ -0003b340: 6e2c 2074 6865 2047 5255 4220 7769 6c6c n, the GRUB will │ │ │ │ -0003b350: 2062 6520 7265 7374 7269 6374 6564 2061 be restricted a │ │ │ │ -0003b360: 6e64 2073 6f6d 6520 6f70 6572 6174 696f nd some operatio │ │ │ │ -0003b370: 6e73 2f63 6f6d 6d61 6e64 730a 6361 6e6e ns/commands.cann │ │ │ │ -0003b380: 6f74 2062 6520 6578 6563 7574 6564 2e0a ot be executed.. │ │ │ │ -0003b390: 0a20 2020 5468 6520 276c 6f63 6b64 6f77 . The 'lockdow │ │ │ │ -0003b3a0: 6e27 2076 6172 6961 626c 6520 6973 2073 n' variable is s │ │ │ │ -0003b3b0: 6574 2074 6f20 2779 2720 7768 656e 2074 et to 'y' when t │ │ │ │ -0003b3c0: 6865 2047 5255 4220 6973 206c 6f63 6b65 he GRUB is locke │ │ │ │ -0003b3d0: 6420 646f 776e 2e0a 4f74 6865 7277 6973 d down..Otherwis │ │ │ │ -0003b3e0: 6520 6974 2064 6f65 7320 6e6f 7420 6578 e it does not ex │ │ │ │ -0003b3f0: 6974 2e0a 0a1f 0a46 696c 653a 2067 7275 it.....File: gru │ │ │ │ -0003b400: 622e 696e 666f 2c20 204e 6f64 653a 2050 b.info, Node: P │ │ │ │ -0003b410: 6c61 7466 6f72 6d20 6c69 6d69 7461 7469 latform limitati │ │ │ │ -0003b420: 6f6e 732c 2020 4e65 7874 3a20 506c 6174 ons, Next: Plat │ │ │ │ -0003b430: 666f 726d 2d73 7065 6369 6669 6320 6f70 form-specific op │ │ │ │ -0003b440: 6572 6174 696f 6e73 2c20 2050 7265 763a erations, Prev: │ │ │ │ -0003b450: 2053 6563 7572 6974 792c 2020 5570 3a20 Security, Up: │ │ │ │ -0003b460: 546f 700a 0a31 3920 506c 6174 666f 726d Top..19 Platform │ │ │ │ -0003b470: 206c 696d 6974 6174 696f 6e73 0a2a 2a2a limitations.*** │ │ │ │ -0003b480: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ -0003b490: 2a2a 2a2a 0a0a 4752 5542 3220 6973 2064 ****..GRUB2 is d │ │ │ │ -0003b4a0: 6573 6967 6e65 6420 746f 2062 6520 706f esigned to be po │ │ │ │ -0003b4b0: 7274 6162 6c65 2061 6e64 2069 7320 6163 rtable and is ac │ │ │ │ -0003b4c0: 7475 616c 6c79 2070 6f72 7465 6420 6163 tually ported ac │ │ │ │ -0003b4d0: 726f 7373 0a70 6c61 7466 6f72 6d73 2e20 ross.platforms. │ │ │ │ -0003b4e0: 2057 6520 7472 7920 746f 206b 6565 7020 We try to keep │ │ │ │ -0003b4f0: 616c 6c20 706c 6174 666f 726d 7320 6174 all platforms at │ │ │ │ -0003b500: 2074 6865 206c 6576 656c 2e20 2055 6e66 the level. Unf │ │ │ │ -0003b510: 6f72 7475 6e61 7465 6c79 0a73 6f6d 6520 ortunately.some │ │ │ │ -0003b520: 706c 6174 666f 726d 7320 6172 6520 6265 platforms are be │ │ │ │ -0003b530: 7474 6572 2073 7570 706f 7274 6564 2074 tter supported t │ │ │ │ -0003b540: 6861 6e20 6f74 6865 7273 2e20 2054 6869 han others. Thi │ │ │ │ -0003b550: 7320 6973 2064 6574 6169 6c65 6420 696e s is detailed in │ │ │ │ -0003b560: 0a63 7572 7265 6e74 2061 6e64 2032 2066 .current and 2 f │ │ │ │ -0003b570: 6f6c 6c6f 7769 6e67 2073 6563 7469 6f6e ollowing section │ │ │ │ -0003b580: 732e 0a0a 2020 2041 5243 2070 6c61 7466 s... ARC platf │ │ │ │ -0003b590: 6f72 6d20 6973 2075 6e61 626c 6520 746f orm is unable to │ │ │ │ -0003b5a0: 2063 6861 6e67 6520 6461 7465 7469 6d65 change datetime │ │ │ │ -0003b5b0: 2028 6669 726d 7761 7265 2064 6f65 736e (firmware doesn │ │ │ │ -0003b5c0: 2774 2073 6565 6d20 746f 0a70 726f 7669 't seem to.provi │ │ │ │ -0003b5d0: 6465 2061 2066 756e 6374 696f 6e20 666f de a function fo │ │ │ │ -0003b5e0: 7220 6974 292e 2020 454d 5520 6861 7320 r it). EMU has │ │ │ │ -0003b5f0: 7369 6d69 6c61 7220 6c69 6d69 7461 7469 similar limitati │ │ │ │ -0003b600: 6f6e 2e0a 0a20 2020 4f6e 2045 4d55 2070 on... On EMU p │ │ │ │ -0003b610: 6c61 7466 6f72 6d20 6e6f 2073 6572 6961 latform no seria │ │ │ │ -0003b620: 6c20 706f 7274 2069 7320 6176 6169 6c61 l port is availa │ │ │ │ -0003b630: 626c 652e 0a0a 2020 2043 6f6e 736f 6c65 ble... Console │ │ │ │ -0003b640: 2063 6861 7273 6574 2072 6566 6572 7320 charset refers │ │ │ │ -0003b650: 6f6e 6c79 2074 6f20 6669 726d 7761 7265 only to firmware │ │ │ │ -0003b660: 2d61 7373 6973 7465 6420 636f 6e73 6f6c -assisted consol │ │ │ │ -0003b670: 652e 2020 6766 7874 6572 6d20 6973 0a61 e. gfxterm is.a │ │ │ │ -0003b680: 6c77 6179 7320 556e 6963 6f64 6520 2873 lways Unicode (s │ │ │ │ -0003b690: 6565 2049 6e74 6572 6e61 7469 6f6e 616c ee International │ │ │ │ -0003b6a0: 6973 6174 696f 6e20 7365 6374 696f 6e20 isation section │ │ │ │ -0003b6b0: 666f 7220 6974 7320 6c69 6d69 7461 7469 for its limitati │ │ │ │ -0003b6c0: 6f6e 7329 2e0a 5365 7269 616c 2069 7320 ons)..Serial is │ │ │ │ -0003b6d0: 636f 6e66 6967 7572 6162 6c65 2074 6f20 configurable to │ │ │ │ -0003b6e0: 5554 462d 3820 6f72 2041 5343 4949 2028 UTF-8 or ASCII ( │ │ │ │ -0003b6f0: 7365 6520 496e 7465 726e 6174 696f 6e61 see Internationa │ │ │ │ -0003b700: 6c69 7361 7469 6f6e 292e 2020 496e 0a63 lisation). In.c │ │ │ │ -0003b710: 6173 6520 6f66 2071 656d 7520 616e 6420 ase of qemu and │ │ │ │ -0003b720: 636f 7265 626f 6f74 2070 6f72 7473 2074 coreboot ports t │ │ │ │ -0003b730: 6865 2072 6566 6572 6564 2063 6f6e 736f he refered conso │ │ │ │ -0003b740: 6c65 2069 7320 7667 615f 7465 7874 2e0a le is vga_text.. │ │ │ │ -0003b750: 4c6f 6f6e 6773 6f6e 2061 6c77 6179 7320 Loongson always │ │ │ │ -0003b760: 7573 6573 2067 6678 7465 726d 2e0a 0a20 uses gfxterm... │ │ │ │ -0003b770: 2020 4d6f 7374 206c 696d 6974 6564 206f Most limited o │ │ │ │ -0003b780: 6e65 2069 7320 4153 4349 492e 2043 5034 ne is ASCII. CP4 │ │ │ │ -0003b790: 3337 2070 726f 7669 6465 7320 6164 6469 37 provides addi │ │ │ │ -0003b7a0: 7469 6f6e 616c 6c79 0a70 7365 7564 6f67 tionally.pseudog │ │ │ │ -0003b7b0: 7261 7068 6963 732e 2020 4752 5542 3220 raphics. GRUB2 │ │ │ │ -0003b7c0: 646f 6573 6e27 7420 7573 6520 616e 7920 doesn't use any │ │ │ │ -0003b7d0: 6c61 6e67 7561 6765 2063 6861 7261 6374 language charact │ │ │ │ -0003b7e0: 6572 7320 6672 6f6d 2043 5034 3337 2061 ers from CP437 a │ │ │ │ -0003b7f0: 730a 6f66 7465 6e20 4350 3433 3720 6973 s.often CP437 is │ │ │ │ -0003b800: 2072 6570 6c61 6365 6420 6279 206e 6174 replaced by nat │ │ │ │ -0003b810: 696f 6e61 6c20 656e 636f 6469 6e67 2063 ional encoding c │ │ │ │ -0003b820: 6f6d 7061 7469 626c 6520 6f6e 6c79 2069 ompatible only i │ │ │ │ -0003b830: 6e0a 7073 6575 646f 6772 6170 6869 6373 n.pseudographics │ │ │ │ -0003b840: 2e20 2055 6e69 636f 6465 2069 7320 7468 . Unicode is th │ │ │ │ -0003b850: 6520 6d6f 7374 2076 6572 7361 7469 6c65 e most versatile │ │ │ │ -0003b860: 2063 6861 7273 6574 2077 6869 6368 2073 charset which s │ │ │ │ -0003b870: 7570 706f 7274 730a 6d61 6e79 206c 616e upports.many lan │ │ │ │ -0003b880: 6775 6167 6573 2e20 2048 6f77 6576 6572 guages. However │ │ │ │ -0003b890: 2074 6865 2061 6374 7561 6c20 636f 6e73 the actual cons │ │ │ │ -0003b8a0: 6f6c 6520 6d61 7920 6265 206d 7563 6820 ole may be much │ │ │ │ -0003b8b0: 6d6f 7265 206c 696d 6974 6564 0a64 6570 more limited.dep │ │ │ │ -0003b8c0: 656e 6469 6e67 206f 6e20 6669 726d 7761 ending on firmwa │ │ │ │ -0003b8d0: 7265 0a0a 2020 204f 6e20 4249 4f53 206e re.. On BIOS n │ │ │ │ -0003b8e0: 6574 776f 726b 2069 7320 7375 7070 6f72 etwork is suppor │ │ │ │ -0003b8f0: 7465 6420 6f6e 6c79 2069 6620 7468 6520 ted only if the │ │ │ │ -0003b900: 696d 6167 6520 6973 206c 6f61 6465 6420 image is loaded │ │ │ │ -0003b910: 7468 726f 7567 680a 6e65 7477 6f72 6b2e through.network. │ │ │ │ -0003b920: 2020 4f6e 2073 7061 7263 3634 2047 5255 On sparc64 GRU │ │ │ │ -0003b930: 4220 6973 2075 6e61 626c 6520 746f 2064 B is unable to d │ │ │ │ -0003b940: 6574 6572 6d69 6e65 2077 6869 6368 2073 etermine which s │ │ │ │ -0003b950: 6572 7665 7220 6974 2077 6173 0a62 6f6f erver it was.boo │ │ │ │ -0003b960: 7465 6420 6672 6f6d 2e0a 0a20 2020 4469 ted from... Di │ │ │ │ -0003b970: 7265 6374 2041 5441 2f41 4843 4920 7375 rect ATA/AHCI su │ │ │ │ -0003b980: 7070 6f72 7420 616c 6c6f 7773 2074 6f20 pport allows to │ │ │ │ -0003b990: 6369 7263 756d 7665 6e74 2076 6172 696f circumvent vario │ │ │ │ -0003b9a0: 7573 2066 6972 6d77 6172 650a 6c69 6d69 us firmware.limi │ │ │ │ -0003b9b0: 7461 7469 6f6e 7320 6275 7420 6973 6e27 tations but isn' │ │ │ │ -0003b9c0: 7420 6e65 6564 6564 2066 6f72 206e 6f72 t needed for nor │ │ │ │ -0003b9d0: 6d61 6c20 6f70 6572 6174 696f 6e20 6578 mal operation ex │ │ │ │ -0003b9e0: 6365 7074 206f 6e20 6261 7265 6d65 7461 cept on baremeta │ │ │ │ -0003b9f0: 6c0a 706f 7274 732e 0a0a 2020 2041 5420 l.ports... AT │ │ │ │ -0003ba00: 6b65 7962 6f61 7264 2073 7570 706f 7274 keyboard support │ │ │ │ -0003ba10: 2061 6c6c 6f77 7320 6b65 7962 6f61 7264 allows keyboard │ │ │ │ -0003ba20: 206c 6179 6f75 7420 7265 6d61 7070 696e layout remappin │ │ │ │ -0003ba30: 6720 616e 6420 7375 7070 6f72 7420 666f g and support fo │ │ │ │ -0003ba40: 720a 6b65 7973 206e 6f74 2061 7661 696c r.keys not avail │ │ │ │ -0003ba50: 6162 6c65 2074 6872 6f75 6768 2066 6972 able through fir │ │ │ │ -0003ba60: 6d77 6172 652e 2020 4974 2069 736e 2774 mware. It isn't │ │ │ │ -0003ba70: 206e 6565 6465 6420 666f 7220 6e6f 726d needed for norm │ │ │ │ -0003ba80: 616c 0a6f 7065 7261 7469 6f6e 2065 7863 al.operation exc │ │ │ │ -0003ba90: 6570 7420 6261 7265 6d65 7461 6c20 706f ept baremetal po │ │ │ │ -0003baa0: 7274 732e 0a0a 2020 2053 7065 616b 6572 rts... Speaker │ │ │ │ -0003bab0: 2061 6c6c 6f77 7320 6d6f 7273 6520 616e allows morse an │ │ │ │ -0003bac0: 6420 7370 6b6d 6f64 656d 2063 6f6d 6d75 d spkmodem commu │ │ │ │ -0003bad0: 6e69 6361 7469 6f6e 2e0a 0a20 2020 5553 nication... US │ │ │ │ -0003bae0: 4220 7375 7070 6f72 7420 7072 6f76 6964 B support provid │ │ │ │ -0003baf0: 6573 2062 656e 6566 6974 7320 7369 6d69 es benefits simi │ │ │ │ -0003bb00: 6c61 7220 746f 2041 5441 2028 666f 7220 lar to ATA (for │ │ │ │ -0003bb10: 5553 4220 6469 736b 7329 206f 7220 4154 USB disks) or AT │ │ │ │ -0003bb20: 0a28 666f 7220 5553 4220 6b65 7962 6f61 .(for USB keyboa │ │ │ │ -0003bb30: 7264 7329 2e20 2049 6e20 6164 6469 7469 rds). In additi │ │ │ │ -0003bb40: 6f6e 2069 7420 616c 6c6f 7773 2055 5342 on it allows USB │ │ │ │ -0003bb50: 7365 7269 616c 2e0a 0a20 2020 4368 6169 serial... Chai │ │ │ │ -0003bb60: 6e6c 6f61 6469 6e67 2072 6566 6572 7320 nloading refers │ │ │ │ -0003bb70: 746f 2074 6865 2061 6269 6c69 7479 2074 to the ability t │ │ │ │ -0003bb80: 6f20 6c6f 6164 2061 6e6f 7468 6572 2062 o load another b │ │ │ │ -0003bb90: 6f6f 746c 6f61 6465 7220 7468 726f 7567 ootloader throug │ │ │ │ -0003bba0: 680a 7468 6520 7361 6d65 2070 726f 746f h.the same proto │ │ │ │ -0003bbb0: 636f 6c0a 0a20 2020 4869 6e74 7320 616c col.. Hints al │ │ │ │ -0003bbc0: 6c6f 7720 6661 7374 6572 2064 6973 6b20 low faster disk │ │ │ │ -0003bbd0: 6469 7363 6f76 6572 7920 6279 2061 6c72 discovery by alr │ │ │ │ -0003bbe0: 6561 6479 206b 6e6f 7769 6e67 2069 6e20 eady knowing in │ │ │ │ -0003bbf0: 6164 7661 6e63 6520 7768 6963 680a 6973 advance which.is │ │ │ │ -0003bc00: 2074 6865 2064 6973 6b20 696e 2071 7565 the disk in que │ │ │ │ -0003bc10: 7374 696f 6e2e 2020 4f6e 2073 6f6d 6520 stion. On some │ │ │ │ -0003bc20: 706c 6174 666f 726d 7320 6869 6e74 7320 platforms hints │ │ │ │ -0003bc30: 6172 6520 636f 7272 6563 7420 756e 6c65 are correct unle │ │ │ │ -0003bc40: 7373 2079 6f75 0a6d 6f76 6520 7468 6520 ss you.move the │ │ │ │ -0003bc50: 6469 736b 2062 6574 7765 656e 2062 6f6f disk between boo │ │ │ │ -0003bc60: 7473 2e20 204f 6e20 6f74 6865 7220 706c ts. On other pl │ │ │ │ -0003bc70: 6174 666f 726d 7320 6974 2773 206a 7573 atforms it's jus │ │ │ │ -0003bc80: 7420 616e 2065 6475 6361 7465 640a 6775 t an educated.gu │ │ │ │ -0003bc90: 6573 732e 2020 4e6f 7465 2074 6861 7420 ess. Note that │ │ │ │ -0003bca0: 6869 6e74 2066 6169 6c75 7265 2072 6573 hint failure res │ │ │ │ -0003bcb0: 756c 7473 2069 6e20 6a75 7374 2072 6564 ults in just red │ │ │ │ -0003bcc0: 7563 6564 2070 6572 666f 726d 616e 6365 uced performance │ │ │ │ -0003bcd0: 2c20 6e6f 740a 6120 6661 696c 7572 650a , not.a failure. │ │ │ │ -0003bce0: 0a20 2020 4261 6452 414d 2069 7320 7468 . BadRAM is th │ │ │ │ -0003bcf0: 6520 6162 696c 6974 7920 746f 206d 6172 e ability to mar │ │ │ │ -0003bd00: 6b20 736f 6d65 206f 6620 7468 6520 5241 k some of the RA │ │ │ │ -0003bd10: 4d20 6173 2022 6261 6422 2e20 204e 6f74 M as "bad". Not │ │ │ │ -0003bd20: 653a 2064 7565 2074 6f0a 7072 6f74 6f63 e: due to.protoc │ │ │ │ -0003bd30: 6f6c 206c 696d 6974 6174 696f 6e73 206d ol limitations m │ │ │ │ -0003bd40: 6970 732d 6c6f 6f6e 6773 6f6e 2028 7769 ips-loongson (wi │ │ │ │ -0003bd50: 7468 204c 696e 7578 2070 726f 746f 636f th Linux protoco │ │ │ │ -0003bd60: 6c29 2061 6e64 0a6d 6970 732d 7165 6d75 l) and.mips-qemu │ │ │ │ -0003bd70: 5f6d 6970 7320 6361 6e20 7573 6520 6f6e _mips can use on │ │ │ │ -0003bd80: 6c79 206d 656d 6f72 7920 7570 2074 6f20 ly memory up to │ │ │ │ -0003bd90: 6669 7273 7420 686f 6c65 2e0a 0a20 2020 first hole... │ │ │ │ -0003bda0: 426f 6f74 6c6f 6361 7469 6f6e 2069 7320 Bootlocation is │ │ │ │ -0003bdb0: 6162 696c 6974 7920 6f66 2047 5255 4220 ability of GRUB │ │ │ │ -0003bdc0: 746f 2061 7574 6f6d 6174 6963 616c 6c79 to automatically │ │ │ │ -0003bdd0: 2064 6574 6563 7420 7768 6572 6520 6974 detect where it │ │ │ │ -0003bde0: 0a62 6f6f 7473 2066 726f 6d2e 2020 2264 .boots from. "d │ │ │ │ -0003bdf0: 6973 6b22 206d 6561 6e73 2074 6865 2064 isk" means the d │ │ │ │ -0003be00: 6574 6563 7469 6f6e 2069 7320 6c69 6d69 etection is limi │ │ │ │ -0003be10: 7465 6420 746f 2064 6574 6563 7469 6e67 ted to detecting │ │ │ │ -0003be20: 2074 6865 2064 6973 6b0a 7769 7468 2070 the disk.with p │ │ │ │ -0003be30: 6172 7469 7469 6f6e 2062 6569 6e67 2064 artition being d │ │ │ │ -0003be40: 6973 636f 7665 7265 6420 6f6e 2069 6e73 iscovered on ins │ │ │ │ -0003be50: 7461 6c6c 2074 696d 652e 2020 2270 6172 tall time. "par │ │ │ │ -0003be60: 7469 7469 6f6e 2220 6d65 616e 7320 7468 tition" means th │ │ │ │ -0003be70: 6174 0a64 6973 6b20 616e 6420 7061 7274 at.disk and part │ │ │ │ -0003be80: 6974 6f6e 2063 616e 2062 6520 6175 746f iton can be auto │ │ │ │ -0003be90: 6d61 7469 6361 6c6c 7920 6469 7363 6f76 matically discov │ │ │ │ -0003bea0: 6572 6564 2e20 2022 6669 6c65 2220 6d65 ered. "file" me │ │ │ │ -0003beb0: 616e 7320 7468 6174 0a62 6f6f 7420 696d ans that.boot im │ │ │ │ -0003bec0: 6167 6520 6669 6c65 206e 616d 6520 6173 age file name as │ │ │ │ -0003bed0: 2077 656c 6c20 6173 2064 6973 6b20 616e well as disk an │ │ │ │ -0003bee0: 6420 7061 7274 6974 696f 6e20 6361 6e20 d partition can │ │ │ │ -0003bef0: 6265 2064 6973 636f 7665 7265 642e 0a46 be discovered..F │ │ │ │ -0003bf00: 6f72 2063 6f6e 7369 7374 656e 6379 2064 or consistency d │ │ │ │ -0003bf10: 6566 6175 6c74 2069 6e73 7461 6c6c 2069 efault install i │ │ │ │ -0003bf20: 676e 6f72 6573 2070 6172 7469 7469 6f6e gnores partition │ │ │ │ -0003bf30: 2061 6e64 2072 656c 6965 7320 736f 6c65 and relies sole │ │ │ │ -0003bf40: 6c79 206f 6e0a 6469 736b 2064 6574 6563 ly on.disk detec │ │ │ │ -0003bf50: 7469 6f6e 2e20 2049 6620 6e6f 2062 6f6f tion. If no boo │ │ │ │ -0003bf60: 746c 6f63 6174 696f 6e20 6469 7363 6f76 tlocation discov │ │ │ │ -0003bf70: 6572 7920 6973 2061 7661 696c 6162 6c65 ery is available │ │ │ │ -0003bf80: 206f 7220 626f 6f74 2061 6e64 0a67 7275 or boot and.gru │ │ │ │ -0003bf90: 622d 726f 6f74 2064 6973 6b73 2061 7265 b-root disks are │ │ │ │ -0003bfa0: 2064 6966 6665 7265 6e74 2c20 5555 4944 different, UUID │ │ │ │ -0003bfb0: 2069 7320 7573 6564 2069 6e73 7465 6164 is used instead │ │ │ │ -0003bfc0: 2e20 204f 6e20 4152 4320 6966 206e 6f0a . On ARC if no. │ │ │ │ -0003bfd0: 6465 7669 6365 2074 6f20 696e 7374 616c device to instal │ │ │ │ -0003bfe0: 6c20 746f 2069 7320 7370 6563 6966 6965 l to is specifie │ │ │ │ -0003bff0: 642c 2055 5549 4420 6973 2075 7365 6420 d, UUID is used │ │ │ │ -0003c000: 696e 7374 6561 6420 6173 2077 656c 6c2e instead as well. │ │ │ │ -0003c010: 0a0a 2020 2020 2020 2020 2020 2020 2020 .. │ │ │ │ -0003c020: 2042 494f 5320 2020 2020 2020 2020 2020 BIOS │ │ │ │ -0003c030: 436f 7265 626f 6f74 2020 2020 2020 204d Coreboot M │ │ │ │ -0003c040: 756c 7469 626f 6f74 2020 2020 2020 5165 ultiboot Qe │ │ │ │ -0003c050: 6d75 0a76 6964 656f 2020 2020 2020 2020 mu.video │ │ │ │ -0003c060: 2020 7965 7320 2020 2020 2020 2020 2020 yes │ │ │ │ -0003c070: 2079 6573 2020 2020 2020 2020 2020 2020 yes │ │ │ │ -0003c080: 7965 7320 2020 2020 2020 2020 2020 2079 yes y │ │ │ │ -0003c090: 6573 0a63 6f6e 736f 6c65 2020 2020 2020 es.console │ │ │ │ -0003c0a0: 2020 4350 3433 3720 2020 2020 2020 2020 CP437 │ │ │ │ -0003c0b0: 2043 5034 3337 2020 2020 2020 2020 2020 CP437 │ │ │ │ -0003c0c0: 4350 3433 3720 2020 2020 2020 2020 2043 CP437 C │ │ │ │ -0003c0d0: 5034 3337 0a63 6861 7273 6574 0a6e 6574 P437.charset.net │ │ │ │ -0003c0e0: 776f 726b 2020 2020 2020 2020 7965 7320 work yes │ │ │ │ -0003c0f0: 282a 2920 2020 2020 2020 206e 6f20 2020 (*) no │ │ │ │ -0003c100: 2020 2020 2020 2020 2020 6e6f 2020 2020 no │ │ │ │ -0003c110: 2020 2020 2020 2020 206e 6f0a 4154 412f no.ATA/ │ │ │ │ -0003c120: 4148 4349 2020 2020 2020 2079 6573 2020 AHCI yes │ │ │ │ -0003c130: 2020 2020 2020 2020 2020 7965 7320 2020 yes │ │ │ │ -0003c140: 2020 2020 2020 2020 2079 6573 2020 2020 yes │ │ │ │ -0003c150: 2020 2020 2020 2020 7965 730a 4154 206b yes.AT k │ │ │ │ -0003c160: 6579 626f 6172 6420 2020 2079 6573 2020 eyboard yes │ │ │ │ -0003c170: 2020 2020 2020 2020 2020 7965 7320 2020 yes │ │ │ │ -0003c180: 2020 2020 2020 2020 2079 6573 2020 2020 yes │ │ │ │ -0003c190: 2020 2020 2020 2020 7965 730a 5370 6561 yes.Spea │ │ │ │ -0003c1a0: 6b65 7220 2020 2020 2020 2079 6573 2020 ker yes │ │ │ │ -0003c1b0: 2020 2020 2020 2020 2020 7965 7320 2020 yes │ │ │ │ -0003c1c0: 2020 2020 2020 2020 2079 6573 2020 2020 yes │ │ │ │ -0003c1d0: 2020 2020 2020 2020 7965 730a 5553 4220 yes.USB │ │ │ │ -0003c1e0: 2020 2020 2020 2020 2020 2079 6573 2020 yes │ │ │ │ -0003c1f0: 2020 2020 2020 2020 2020 7965 7320 2020 yes │ │ │ │ -0003c200: 2020 2020 2020 2020 2079 6573 2020 2020 yes │ │ │ │ -0003c210: 2020 2020 2020 2020 7965 730a 6368 6169 yes.chai │ │ │ │ -0003c220: 6e6c 6f61 6465 7220 2020 206c 6f63 616c nloader local │ │ │ │ -0003c230: 2020 2020 2020 2020 2020 7965 7320 2020 yes │ │ │ │ -0003c240: 2020 2020 2020 2020 2079 6573 2020 2020 yes │ │ │ │ -0003c250: 2020 2020 2020 2020 6e6f 0a63 7075 6964 no.cpuid │ │ │ │ -0003c260: 2020 2020 2020 2020 2020 7061 7274 6961 partia │ │ │ │ -0003c270: 6c20 2020 2020 2020 2070 6172 7469 616c l partial │ │ │ │ -0003c280: 2020 2020 2020 2020 7061 7274 6961 6c20 partial │ │ │ │ -0003c290: 2020 2020 2020 2070 6172 7469 616c 0a72 partial.r │ │ │ │ -0003c2a0: 646d 7372 2020 2020 2020 2020 2020 7061 dmsr pa │ │ │ │ -0003c2b0: 7274 6961 6c20 2020 2020 2020 2070 6172 rtial par │ │ │ │ -0003c2c0: 7469 616c 2020 2020 2020 2020 7061 7274 tial part │ │ │ │ -0003c2d0: 6961 6c20 2020 2020 2020 2070 6172 7469 ial parti │ │ │ │ -0003c2e0: 616c 0a77 726d 7372 2020 2020 2020 2020 al.wrmsr │ │ │ │ -0003c2f0: 2020 7061 7274 6961 6c20 2020 2020 2020 partial │ │ │ │ -0003c300: 2070 6172 7469 616c 2020 2020 2020 2020 partial │ │ │ │ -0003c310: 7061 7274 6961 6c20 2020 2020 2020 2070 partial p │ │ │ │ -0003c320: 6172 7469 616c 0a68 696e 7473 2020 2020 artial.hints │ │ │ │ -0003c330: 2020 2020 2020 6775 6573 7320 2020 2020 guess │ │ │ │ -0003c340: 2020 2020 2067 7565 7373 2020 2020 2020 guess │ │ │ │ -0003c350: 2020 2020 6775 6573 7320 2020 2020 2020 guess │ │ │ │ -0003c360: 2020 2067 7565 7373 0a50 4349 2020 2020 guess.PCI │ │ │ │ -0003c370: 2020 2020 2020 2020 7965 7320 2020 2020 yes │ │ │ │ -0003c380: 2020 2020 2020 2079 6573 2020 2020 2020 yes │ │ │ │ -0003c390: 2020 2020 2020 7965 7320 2020 2020 2020 yes │ │ │ │ -0003c3a0: 2020 2020 2079 6573 0a62 6164 7261 6d20 yes.badram │ │ │ │ -0003c3b0: 2020 2020 2020 2020 7965 7320 2020 2020 yes │ │ │ │ -0003c3c0: 2020 2020 2020 2079 6573 2020 2020 2020 yes │ │ │ │ -0003c3d0: 2020 2020 2020 7965 7320 2020 2020 2020 yes │ │ │ │ -0003c3e0: 2020 2020 2079 6573 0a63 6f6d 7072 6573 yes.compres │ │ │ │ -0003c3f0: 7369 6f6e 2020 2020 616c 7761 7973 2020 sion always │ │ │ │ -0003c400: 2020 2020 2020 2070 6f69 6e74 6c65 7373 pointless │ │ │ │ -0003c410: 2020 2020 2020 6e6f 2020 2020 2020 2020 no │ │ │ │ -0003c420: 2020 2020 206e 6f0a 6578 6974 2020 2020 no.exit │ │ │ │ -0003c430: 2020 2020 2020 2079 6573 2020 2020 2020 yes │ │ │ │ -0003c440: 2020 2020 2020 6e6f 2020 2020 2020 2020 no │ │ │ │ -0003c450: 2020 2020 206e 6f20 2020 2020 2020 2020 no │ │ │ │ -0003c460: 2020 2020 6e6f 0a62 6f6f 746c 6f63 6174 no.bootlocat │ │ │ │ -0003c470: 696f 6e20 2020 6469 736b 2020 2020 2020 ion disk │ │ │ │ -0003c480: 2020 2020 206e 6f20 2020 2020 2020 2020 no │ │ │ │ -0003c490: 2020 2020 6e6f 2020 2020 2020 2020 2020 no │ │ │ │ -0003c4a0: 2020 206e 6f0a 0a20 2020 2020 2020 2020 no.. │ │ │ │ -0003c4b0: 2020 2020 2020 6961 3332 2045 4649 2020 ia32 EFI │ │ │ │ -0003c4c0: 2020 2020 2061 6d64 3634 2045 4649 2020 amd64 EFI │ │ │ │ -0003c4d0: 2020 2020 6961 3332 2020 2020 2020 2020 ia32 │ │ │ │ -0003c4e0: 2020 2049 7461 6e69 756d 0a20 2020 2020 Itanium. │ │ │ │ +0003b2a0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a ==============.. │ │ │ │ +0003b2b0: 5468 6520 4752 5542 2063 616e 2062 6520 The GRUB can be │ │ │ │ +0003b2c0: 6c6f 636b 6564 2064 6f77 6e20 7768 656e locked down when │ │ │ │ +0003b2d0: 2062 6f6f 7465 6420 6f6e 2061 2073 6563 booted on a sec │ │ │ │ +0003b2e0: 7572 6520 626f 6f74 2065 6e76 6972 6f6e ure boot environ │ │ │ │ +0003b2f0: 6d65 6e74 2c0a 666f 7220 6578 616d 706c ment,.for exampl │ │ │ │ +0003b300: 6520 6966 2074 6865 2055 4546 4920 7365 e if the UEFI se │ │ │ │ +0003b310: 6375 7265 2062 6f6f 7420 6973 2065 6e61 cure boot is ena │ │ │ │ +0003b320: 626c 6564 2e20 204f 6e20 6120 6c6f 636b bled. On a lock │ │ │ │ +0003b330: 6564 2064 6f77 6e0a 636f 6e66 6967 7572 ed down.configur │ │ │ │ +0003b340: 6174 696f 6e2c 2074 6865 2047 5255 4220 ation, the GRUB │ │ │ │ +0003b350: 7769 6c6c 2062 6520 7265 7374 7269 6374 will be restrict │ │ │ │ +0003b360: 6564 2061 6e64 2073 6f6d 6520 6f70 6572 ed and some oper │ │ │ │ +0003b370: 6174 696f 6e73 2f63 6f6d 6d61 6e64 730a ations/commands. │ │ │ │ +0003b380: 6361 6e6e 6f74 2062 6520 6578 6563 7574 cannot be execut │ │ │ │ +0003b390: 6564 2e0a 0a20 2020 5468 6520 276c 6f63 ed... The 'loc │ │ │ │ +0003b3a0: 6b64 6f77 6e27 2076 6172 6961 626c 6520 kdown' variable │ │ │ │ +0003b3b0: 6973 2073 6574 2074 6f20 2779 2720 7768 is set to 'y' wh │ │ │ │ +0003b3c0: 656e 2074 6865 2047 5255 4220 6973 206c en the GRUB is l │ │ │ │ +0003b3d0: 6f63 6b65 6420 646f 776e 2e0a 4f74 6865 ocked down..Othe │ │ │ │ +0003b3e0: 7277 6973 6520 6974 2064 6f65 7320 6e6f rwise it does no │ │ │ │ +0003b3f0: 7420 6578 6974 2e0a 0a1f 0a46 696c 653a t exit.....File: │ │ │ │ +0003b400: 2067 7275 622e 696e 666f 2c20 204e 6f64 grub.info, Nod │ │ │ │ +0003b410: 653a 2050 6c61 7466 6f72 6d20 6c69 6d69 e: Platform limi │ │ │ │ +0003b420: 7461 7469 6f6e 732c 2020 4e65 7874 3a20 tations, Next: │ │ │ │ +0003b430: 506c 6174 666f 726d 2d73 7065 6369 6669 Platform-specifi │ │ │ │ +0003b440: 6320 6f70 6572 6174 696f 6e73 2c20 2050 c operations, P │ │ │ │ +0003b450: 7265 763a 2053 6563 7572 6974 792c 2020 rev: Security, │ │ │ │ +0003b460: 5570 3a20 546f 700a 0a31 3920 506c 6174 Up: Top..19 Plat │ │ │ │ +0003b470: 666f 726d 206c 696d 6974 6174 696f 6e73 form limitations │ │ │ │ +0003b480: 0a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a .*************** │ │ │ │ +0003b490: 2a2a 2a2a 2a2a 2a2a 0a0a 4752 5542 3220 ********..GRUB2 │ │ │ │ +0003b4a0: 6973 2064 6573 6967 6e65 6420 746f 2062 is designed to b │ │ │ │ +0003b4b0: 6520 706f 7274 6162 6c65 2061 6e64 2069 e portable and i │ │ │ │ +0003b4c0: 7320 6163 7475 616c 6c79 2070 6f72 7465 s actually porte │ │ │ │ +0003b4d0: 6420 6163 726f 7373 0a70 6c61 7466 6f72 d across.platfor │ │ │ │ +0003b4e0: 6d73 2e20 2057 6520 7472 7920 746f 206b ms. We try to k │ │ │ │ +0003b4f0: 6565 7020 616c 6c20 706c 6174 666f 726d eep all platform │ │ │ │ +0003b500: 7320 6174 2074 6865 206c 6576 656c 2e20 s at the level. │ │ │ │ +0003b510: 2055 6e66 6f72 7475 6e61 7465 6c79 0a73 Unfortunately.s │ │ │ │ +0003b520: 6f6d 6520 706c 6174 666f 726d 7320 6172 ome platforms ar │ │ │ │ +0003b530: 6520 6265 7474 6572 2073 7570 706f 7274 e better support │ │ │ │ +0003b540: 6564 2074 6861 6e20 6f74 6865 7273 2e20 ed than others. │ │ │ │ +0003b550: 2054 6869 7320 6973 2064 6574 6169 6c65 This is detaile │ │ │ │ +0003b560: 6420 696e 0a63 7572 7265 6e74 2061 6e64 d in.current and │ │ │ │ +0003b570: 2032 2066 6f6c 6c6f 7769 6e67 2073 6563 2 following sec │ │ │ │ +0003b580: 7469 6f6e 732e 0a0a 2020 2041 5243 2070 tions... ARC p │ │ │ │ +0003b590: 6c61 7466 6f72 6d20 6973 2075 6e61 626c latform is unabl │ │ │ │ +0003b5a0: 6520 746f 2063 6861 6e67 6520 6461 7465 e to change date │ │ │ │ +0003b5b0: 7469 6d65 2028 6669 726d 7761 7265 2064 time (firmware d │ │ │ │ +0003b5c0: 6f65 736e 2774 2073 6565 6d20 746f 0a70 oesn't seem to.p │ │ │ │ +0003b5d0: 726f 7669 6465 2061 2066 756e 6374 696f rovide a functio │ │ │ │ +0003b5e0: 6e20 666f 7220 6974 292e 2020 454d 5520 n for it). EMU │ │ │ │ +0003b5f0: 6861 7320 7369 6d69 6c61 7220 6c69 6d69 has similar limi │ │ │ │ +0003b600: 7461 7469 6f6e 2e0a 0a20 2020 4f6e 2045 tation... On E │ │ │ │ +0003b610: 4d55 2070 6c61 7466 6f72 6d20 6e6f 2073 MU platform no s │ │ │ │ +0003b620: 6572 6961 6c20 706f 7274 2069 7320 6176 erial port is av │ │ │ │ +0003b630: 6169 6c61 626c 652e 0a0a 2020 2043 6f6e ailable... Con │ │ │ │ +0003b640: 736f 6c65 2063 6861 7273 6574 2072 6566 sole charset ref │ │ │ │ +0003b650: 6572 7320 6f6e 6c79 2074 6f20 6669 726d ers only to firm │ │ │ │ +0003b660: 7761 7265 2d61 7373 6973 7465 6420 636f ware-assisted co │ │ │ │ +0003b670: 6e73 6f6c 652e 2020 6766 7874 6572 6d20 nsole. gfxterm │ │ │ │ +0003b680: 6973 0a61 6c77 6179 7320 556e 6963 6f64 is.always Unicod │ │ │ │ +0003b690: 6520 2873 6565 2049 6e74 6572 6e61 7469 e (see Internati │ │ │ │ +0003b6a0: 6f6e 616c 6973 6174 696f 6e20 7365 6374 onalisation sect │ │ │ │ +0003b6b0: 696f 6e20 666f 7220 6974 7320 6c69 6d69 ion for its limi │ │ │ │ +0003b6c0: 7461 7469 6f6e 7329 2e0a 5365 7269 616c tations)..Serial │ │ │ │ +0003b6d0: 2069 7320 636f 6e66 6967 7572 6162 6c65 is configurable │ │ │ │ +0003b6e0: 2074 6f20 5554 462d 3820 6f72 2041 5343 to UTF-8 or ASC │ │ │ │ +0003b6f0: 4949 2028 7365 6520 496e 7465 726e 6174 II (see Internat │ │ │ │ +0003b700: 696f 6e61 6c69 7361 7469 6f6e 292e 2020 ionalisation). │ │ │ │ +0003b710: 496e 0a63 6173 6520 6f66 2071 656d 7520 In.case of qemu │ │ │ │ +0003b720: 616e 6420 636f 7265 626f 6f74 2070 6f72 and coreboot por │ │ │ │ +0003b730: 7473 2074 6865 2072 6566 6572 6564 2063 ts the refered c │ │ │ │ +0003b740: 6f6e 736f 6c65 2069 7320 7667 615f 7465 onsole is vga_te │ │ │ │ +0003b750: 7874 2e0a 4c6f 6f6e 6773 6f6e 2061 6c77 xt..Loongson alw │ │ │ │ +0003b760: 6179 7320 7573 6573 2067 6678 7465 726d ays uses gfxterm │ │ │ │ +0003b770: 2e0a 0a20 2020 4d6f 7374 206c 696d 6974 ... Most limit │ │ │ │ +0003b780: 6564 206f 6e65 2069 7320 4153 4349 492e ed one is ASCII. │ │ │ │ +0003b790: 2043 5034 3337 2070 726f 7669 6465 7320 CP437 provides │ │ │ │ +0003b7a0: 6164 6469 7469 6f6e 616c 6c79 0a70 7365 additionally.pse │ │ │ │ +0003b7b0: 7564 6f67 7261 7068 6963 732e 2020 4752 udographics. GR │ │ │ │ +0003b7c0: 5542 3220 646f 6573 6e27 7420 7573 6520 UB2 doesn't use │ │ │ │ +0003b7d0: 616e 7920 6c61 6e67 7561 6765 2063 6861 any language cha │ │ │ │ +0003b7e0: 7261 6374 6572 7320 6672 6f6d 2043 5034 racters from CP4 │ │ │ │ +0003b7f0: 3337 2061 730a 6f66 7465 6e20 4350 3433 37 as.often CP43 │ │ │ │ +0003b800: 3720 6973 2072 6570 6c61 6365 6420 6279 7 is replaced by │ │ │ │ +0003b810: 206e 6174 696f 6e61 6c20 656e 636f 6469 national encodi │ │ │ │ +0003b820: 6e67 2063 6f6d 7061 7469 626c 6520 6f6e ng compatible on │ │ │ │ +0003b830: 6c79 2069 6e0a 7073 6575 646f 6772 6170 ly in.pseudograp │ │ │ │ +0003b840: 6869 6373 2e20 2055 6e69 636f 6465 2069 hics. Unicode i │ │ │ │ +0003b850: 7320 7468 6520 6d6f 7374 2076 6572 7361 s the most versa │ │ │ │ +0003b860: 7469 6c65 2063 6861 7273 6574 2077 6869 tile charset whi │ │ │ │ +0003b870: 6368 2073 7570 706f 7274 730a 6d61 6e79 ch supports.many │ │ │ │ +0003b880: 206c 616e 6775 6167 6573 2e20 2048 6f77 languages. How │ │ │ │ +0003b890: 6576 6572 2074 6865 2061 6374 7561 6c20 ever the actual │ │ │ │ +0003b8a0: 636f 6e73 6f6c 6520 6d61 7920 6265 206d console may be m │ │ │ │ +0003b8b0: 7563 6820 6d6f 7265 206c 696d 6974 6564 uch more limited │ │ │ │ +0003b8c0: 0a64 6570 656e 6469 6e67 206f 6e20 6669 .depending on fi │ │ │ │ +0003b8d0: 726d 7761 7265 0a0a 2020 204f 6e20 4249 rmware.. On BI │ │ │ │ +0003b8e0: 4f53 206e 6574 776f 726b 2069 7320 7375 OS network is su │ │ │ │ +0003b8f0: 7070 6f72 7465 6420 6f6e 6c79 2069 6620 pported only if │ │ │ │ +0003b900: 7468 6520 696d 6167 6520 6973 206c 6f61 the image is loa │ │ │ │ +0003b910: 6465 6420 7468 726f 7567 680a 6e65 7477 ded through.netw │ │ │ │ +0003b920: 6f72 6b2e 2020 4f6e 2073 7061 7263 3634 ork. On sparc64 │ │ │ │ +0003b930: 2047 5255 4220 6973 2075 6e61 626c 6520 GRUB is unable │ │ │ │ +0003b940: 746f 2064 6574 6572 6d69 6e65 2077 6869 to determine whi │ │ │ │ +0003b950: 6368 2073 6572 7665 7220 6974 2077 6173 ch server it was │ │ │ │ +0003b960: 0a62 6f6f 7465 6420 6672 6f6d 2e0a 0a20 .booted from... │ │ │ │ +0003b970: 2020 4469 7265 6374 2041 5441 2f41 4843 Direct ATA/AHC │ │ │ │ +0003b980: 4920 7375 7070 6f72 7420 616c 6c6f 7773 I support allows │ │ │ │ +0003b990: 2074 6f20 6369 7263 756d 7665 6e74 2076 to circumvent v │ │ │ │ +0003b9a0: 6172 696f 7573 2066 6972 6d77 6172 650a arious firmware. │ │ │ │ +0003b9b0: 6c69 6d69 7461 7469 6f6e 7320 6275 7420 limitations but │ │ │ │ +0003b9c0: 6973 6e27 7420 6e65 6564 6564 2066 6f72 isn't needed for │ │ │ │ +0003b9d0: 206e 6f72 6d61 6c20 6f70 6572 6174 696f normal operatio │ │ │ │ +0003b9e0: 6e20 6578 6365 7074 206f 6e20 6261 7265 n except on bare │ │ │ │ +0003b9f0: 6d65 7461 6c0a 706f 7274 732e 0a0a 2020 metal.ports... │ │ │ │ +0003ba00: 2041 5420 6b65 7962 6f61 7264 2073 7570 AT keyboard sup │ │ │ │ +0003ba10: 706f 7274 2061 6c6c 6f77 7320 6b65 7962 port allows keyb │ │ │ │ +0003ba20: 6f61 7264 206c 6179 6f75 7420 7265 6d61 oard layout rema │ │ │ │ +0003ba30: 7070 696e 6720 616e 6420 7375 7070 6f72 pping and suppor │ │ │ │ +0003ba40: 7420 666f 720a 6b65 7973 206e 6f74 2061 t for.keys not a │ │ │ │ +0003ba50: 7661 696c 6162 6c65 2074 6872 6f75 6768 vailable through │ │ │ │ +0003ba60: 2066 6972 6d77 6172 652e 2020 4974 2069 firmware. It i │ │ │ │ +0003ba70: 736e 2774 206e 6565 6465 6420 666f 7220 sn't needed for │ │ │ │ +0003ba80: 6e6f 726d 616c 0a6f 7065 7261 7469 6f6e normal.operation │ │ │ │ +0003ba90: 2065 7863 6570 7420 6261 7265 6d65 7461 except baremeta │ │ │ │ +0003baa0: 6c20 706f 7274 732e 0a0a 2020 2053 7065 l ports... Spe │ │ │ │ +0003bab0: 616b 6572 2061 6c6c 6f77 7320 6d6f 7273 aker allows mors │ │ │ │ +0003bac0: 6520 616e 6420 7370 6b6d 6f64 656d 2063 e and spkmodem c │ │ │ │ +0003bad0: 6f6d 6d75 6e69 6361 7469 6f6e 2e0a 0a20 ommunication... │ │ │ │ +0003bae0: 2020 5553 4220 7375 7070 6f72 7420 7072 USB support pr │ │ │ │ +0003baf0: 6f76 6964 6573 2062 656e 6566 6974 7320 ovides benefits │ │ │ │ +0003bb00: 7369 6d69 6c61 7220 746f 2041 5441 2028 similar to ATA ( │ │ │ │ +0003bb10: 666f 7220 5553 4220 6469 736b 7329 206f for USB disks) o │ │ │ │ +0003bb20: 7220 4154 0a28 666f 7220 5553 4220 6b65 r AT.(for USB ke │ │ │ │ +0003bb30: 7962 6f61 7264 7329 2e20 2049 6e20 6164 yboards). In ad │ │ │ │ +0003bb40: 6469 7469 6f6e 2069 7420 616c 6c6f 7773 dition it allows │ │ │ │ +0003bb50: 2055 5342 7365 7269 616c 2e0a 0a20 2020 USBserial... │ │ │ │ +0003bb60: 4368 6169 6e6c 6f61 6469 6e67 2072 6566 Chainloading ref │ │ │ │ +0003bb70: 6572 7320 746f 2074 6865 2061 6269 6c69 ers to the abili │ │ │ │ +0003bb80: 7479 2074 6f20 6c6f 6164 2061 6e6f 7468 ty to load anoth │ │ │ │ +0003bb90: 6572 2062 6f6f 746c 6f61 6465 7220 7468 er bootloader th │ │ │ │ +0003bba0: 726f 7567 680a 7468 6520 7361 6d65 2070 rough.the same p │ │ │ │ +0003bbb0: 726f 746f 636f 6c0a 0a20 2020 4869 6e74 rotocol.. Hint │ │ │ │ +0003bbc0: 7320 616c 6c6f 7720 6661 7374 6572 2064 s allow faster d │ │ │ │ +0003bbd0: 6973 6b20 6469 7363 6f76 6572 7920 6279 isk discovery by │ │ │ │ +0003bbe0: 2061 6c72 6561 6479 206b 6e6f 7769 6e67 already knowing │ │ │ │ +0003bbf0: 2069 6e20 6164 7661 6e63 6520 7768 6963 in advance whic │ │ │ │ +0003bc00: 680a 6973 2074 6865 2064 6973 6b20 696e h.is the disk in │ │ │ │ +0003bc10: 2071 7565 7374 696f 6e2e 2020 4f6e 2073 question. On s │ │ │ │ +0003bc20: 6f6d 6520 706c 6174 666f 726d 7320 6869 ome platforms hi │ │ │ │ +0003bc30: 6e74 7320 6172 6520 636f 7272 6563 7420 nts are correct │ │ │ │ +0003bc40: 756e 6c65 7373 2079 6f75 0a6d 6f76 6520 unless you.move │ │ │ │ +0003bc50: 7468 6520 6469 736b 2062 6574 7765 656e the disk between │ │ │ │ +0003bc60: 2062 6f6f 7473 2e20 204f 6e20 6f74 6865 boots. On othe │ │ │ │ +0003bc70: 7220 706c 6174 666f 726d 7320 6974 2773 r platforms it's │ │ │ │ +0003bc80: 206a 7573 7420 616e 2065 6475 6361 7465 just an educate │ │ │ │ +0003bc90: 640a 6775 6573 732e 2020 4e6f 7465 2074 d.guess. Note t │ │ │ │ +0003bca0: 6861 7420 6869 6e74 2066 6169 6c75 7265 hat hint failure │ │ │ │ +0003bcb0: 2072 6573 756c 7473 2069 6e20 6a75 7374 results in just │ │ │ │ +0003bcc0: 2072 6564 7563 6564 2070 6572 666f 726d reduced perform │ │ │ │ +0003bcd0: 616e 6365 2c20 6e6f 740a 6120 6661 696c ance, not.a fail │ │ │ │ +0003bce0: 7572 650a 0a20 2020 4261 6452 414d 2069 ure.. BadRAM i │ │ │ │ +0003bcf0: 7320 7468 6520 6162 696c 6974 7920 746f s the ability to │ │ │ │ +0003bd00: 206d 6172 6b20 736f 6d65 206f 6620 7468 mark some of th │ │ │ │ +0003bd10: 6520 5241 4d20 6173 2022 6261 6422 2e20 e RAM as "bad". │ │ │ │ +0003bd20: 204e 6f74 653a 2064 7565 2074 6f0a 7072 Note: due to.pr │ │ │ │ +0003bd30: 6f74 6f63 6f6c 206c 696d 6974 6174 696f otocol limitatio │ │ │ │ +0003bd40: 6e73 206d 6970 732d 6c6f 6f6e 6773 6f6e ns mips-loongson │ │ │ │ +0003bd50: 2028 7769 7468 204c 696e 7578 2070 726f (with Linux pro │ │ │ │ +0003bd60: 746f 636f 6c29 2061 6e64 0a6d 6970 732d tocol) and.mips- │ │ │ │ +0003bd70: 7165 6d75 5f6d 6970 7320 6361 6e20 7573 qemu_mips can us │ │ │ │ +0003bd80: 6520 6f6e 6c79 206d 656d 6f72 7920 7570 e only memory up │ │ │ │ +0003bd90: 2074 6f20 6669 7273 7420 686f 6c65 2e0a to first hole.. │ │ │ │ +0003bda0: 0a20 2020 426f 6f74 6c6f 6361 7469 6f6e . Bootlocation │ │ │ │ +0003bdb0: 2069 7320 6162 696c 6974 7920 6f66 2047 is ability of G │ │ │ │ +0003bdc0: 5255 4220 746f 2061 7574 6f6d 6174 6963 RUB to automatic │ │ │ │ +0003bdd0: 616c 6c79 2064 6574 6563 7420 7768 6572 ally detect wher │ │ │ │ +0003bde0: 6520 6974 0a62 6f6f 7473 2066 726f 6d2e e it.boots from. │ │ │ │ +0003bdf0: 2020 2264 6973 6b22 206d 6561 6e73 2074 "disk" means t │ │ │ │ +0003be00: 6865 2064 6574 6563 7469 6f6e 2069 7320 he detection is │ │ │ │ +0003be10: 6c69 6d69 7465 6420 746f 2064 6574 6563 limited to detec │ │ │ │ +0003be20: 7469 6e67 2074 6865 2064 6973 6b0a 7769 ting the disk.wi │ │ │ │ +0003be30: 7468 2070 6172 7469 7469 6f6e 2062 6569 th partition bei │ │ │ │ +0003be40: 6e67 2064 6973 636f 7665 7265 6420 6f6e ng discovered on │ │ │ │ +0003be50: 2069 6e73 7461 6c6c 2074 696d 652e 2020 install time. │ │ │ │ +0003be60: 2270 6172 7469 7469 6f6e 2220 6d65 616e "partition" mean │ │ │ │ +0003be70: 7320 7468 6174 0a64 6973 6b20 616e 6420 s that.disk and │ │ │ │ +0003be80: 7061 7274 6974 6f6e 2063 616e 2062 6520 partiton can be │ │ │ │ +0003be90: 6175 746f 6d61 7469 6361 6c6c 7920 6469 automatically di │ │ │ │ +0003bea0: 7363 6f76 6572 6564 2e20 2022 6669 6c65 scovered. "file │ │ │ │ +0003beb0: 2220 6d65 616e 7320 7468 6174 0a62 6f6f " means that.boo │ │ │ │ +0003bec0: 7420 696d 6167 6520 6669 6c65 206e 616d t image file nam │ │ │ │ +0003bed0: 6520 6173 2077 656c 6c20 6173 2064 6973 e as well as dis │ │ │ │ +0003bee0: 6b20 616e 6420 7061 7274 6974 696f 6e20 k and partition │ │ │ │ +0003bef0: 6361 6e20 6265 2064 6973 636f 7665 7265 can be discovere │ │ │ │ +0003bf00: 642e 0a46 6f72 2063 6f6e 7369 7374 656e d..For consisten │ │ │ │ +0003bf10: 6379 2064 6566 6175 6c74 2069 6e73 7461 cy default insta │ │ │ │ +0003bf20: 6c6c 2069 676e 6f72 6573 2070 6172 7469 ll ignores parti │ │ │ │ +0003bf30: 7469 6f6e 2061 6e64 2072 656c 6965 7320 tion and relies │ │ │ │ +0003bf40: 736f 6c65 6c79 206f 6e0a 6469 736b 2064 solely on.disk d │ │ │ │ +0003bf50: 6574 6563 7469 6f6e 2e20 2049 6620 6e6f etection. If no │ │ │ │ +0003bf60: 2062 6f6f 746c 6f63 6174 696f 6e20 6469 bootlocation di │ │ │ │ +0003bf70: 7363 6f76 6572 7920 6973 2061 7661 696c scovery is avail │ │ │ │ +0003bf80: 6162 6c65 206f 7220 626f 6f74 2061 6e64 able or boot and │ │ │ │ +0003bf90: 0a67 7275 622d 726f 6f74 2064 6973 6b73 .grub-root disks │ │ │ │ +0003bfa0: 2061 7265 2064 6966 6665 7265 6e74 2c20 are different, │ │ │ │ +0003bfb0: 5555 4944 2069 7320 7573 6564 2069 6e73 UUID is used ins │ │ │ │ +0003bfc0: 7465 6164 2e20 204f 6e20 4152 4320 6966 tead. On ARC if │ │ │ │ +0003bfd0: 206e 6f0a 6465 7669 6365 2074 6f20 696e no.device to in │ │ │ │ +0003bfe0: 7374 616c 6c20 746f 2069 7320 7370 6563 stall to is spec │ │ │ │ +0003bff0: 6966 6965 642c 2055 5549 4420 6973 2075 ified, UUID is u │ │ │ │ +0003c000: 7365 6420 696e 7374 6561 6420 6173 2077 sed instead as w │ │ │ │ +0003c010: 656c 6c2e 0a0a 2020 2020 2020 2020 2020 ell... │ │ │ │ +0003c020: 2020 2020 2042 494f 5320 2020 2020 2020 BIOS │ │ │ │ +0003c030: 2020 2020 436f 7265 626f 6f74 2020 2020 Coreboot │ │ │ │ +0003c040: 2020 204d 756c 7469 626f 6f74 2020 2020 Multiboot │ │ │ │ +0003c050: 2020 5165 6d75 0a76 6964 656f 2020 2020 Qemu.video │ │ │ │ +0003c060: 2020 2020 2020 7965 7320 2020 2020 2020 yes │ │ │ │ +0003c070: 2020 2020 2079 6573 2020 2020 2020 2020 yes │ │ │ │ +0003c080: 2020 2020 7965 7320 2020 2020 2020 2020 yes │ │ │ │ +0003c090: 2020 2079 6573 0a63 6f6e 736f 6c65 2020 yes.console │ │ │ │ +0003c0a0: 2020 2020 2020 4350 3433 3720 2020 2020 CP437 │ │ │ │ +0003c0b0: 2020 2020 2043 5034 3337 2020 2020 2020 CP437 │ │ │ │ +0003c0c0: 2020 2020 4350 3433 3720 2020 2020 2020 CP437 │ │ │ │ +0003c0d0: 2020 2043 5034 3337 0a63 6861 7273 6574 CP437.charset │ │ │ │ +0003c0e0: 0a6e 6574 776f 726b 2020 2020 2020 2020 .network │ │ │ │ +0003c0f0: 7965 7320 282a 2920 2020 2020 2020 206e yes (*) n │ │ │ │ +0003c100: 6f20 2020 2020 2020 2020 2020 2020 6e6f o no │ │ │ │ +0003c110: 2020 2020 2020 2020 2020 2020 206e 6f0a no. │ │ │ │ +0003c120: 4154 412f 4148 4349 2020 2020 2020 2079 ATA/AHCI y │ │ │ │ +0003c130: 6573 2020 2020 2020 2020 2020 2020 7965 es ye │ │ │ │ +0003c140: 7320 2020 2020 2020 2020 2020 2079 6573 s yes │ │ │ │ +0003c150: 2020 2020 2020 2020 2020 2020 7965 730a yes. │ │ │ │ +0003c160: 4154 206b 6579 626f 6172 6420 2020 2079 AT keyboard y │ │ │ │ +0003c170: 6573 2020 2020 2020 2020 2020 2020 7965 es ye │ │ │ │ +0003c180: 7320 2020 2020 2020 2020 2020 2079 6573 s yes │ │ │ │ +0003c190: 2020 2020 2020 2020 2020 2020 7965 730a yes. │ │ │ │ +0003c1a0: 5370 6561 6b65 7220 2020 2020 2020 2079 Speaker y │ │ │ │ +0003c1b0: 6573 2020 2020 2020 2020 2020 2020 7965 es ye │ │ │ │ +0003c1c0: 7320 2020 2020 2020 2020 2020 2079 6573 s yes │ │ │ │ +0003c1d0: 2020 2020 2020 2020 2020 2020 7965 730a yes. │ │ │ │ +0003c1e0: 5553 4220 2020 2020 2020 2020 2020 2079 USB y │ │ │ │ +0003c1f0: 6573 2020 2020 2020 2020 2020 2020 7965 es ye │ │ │ │ +0003c200: 7320 2020 2020 2020 2020 2020 2079 6573 s yes │ │ │ │ +0003c210: 2020 2020 2020 2020 2020 2020 7965 730a yes. │ │ │ │ +0003c220: 6368 6169 6e6c 6f61 6465 7220 2020 206c chainloader l │ │ │ │ +0003c230: 6f63 616c 2020 2020 2020 2020 2020 7965 ocal ye │ │ │ │ +0003c240: 7320 2020 2020 2020 2020 2020 2079 6573 s yes │ │ │ │ +0003c250: 2020 2020 2020 2020 2020 2020 6e6f 0a63 no.c │ │ │ │ +0003c260: 7075 6964 2020 2020 2020 2020 2020 7061 puid pa │ │ │ │ +0003c270: 7274 6961 6c20 2020 2020 2020 2070 6172 rtial par │ │ │ │ +0003c280: 7469 616c 2020 2020 2020 2020 7061 7274 tial part │ │ │ │ +0003c290: 6961 6c20 2020 2020 2020 2070 6172 7469 ial parti │ │ │ │ +0003c2a0: 616c 0a72 646d 7372 2020 2020 2020 2020 al.rdmsr │ │ │ │ +0003c2b0: 2020 7061 7274 6961 6c20 2020 2020 2020 partial │ │ │ │ +0003c2c0: 2070 6172 7469 616c 2020 2020 2020 2020 partial │ │ │ │ +0003c2d0: 7061 7274 6961 6c20 2020 2020 2020 2070 partial p │ │ │ │ +0003c2e0: 6172 7469 616c 0a77 726d 7372 2020 2020 artial.wrmsr │ │ │ │ +0003c2f0: 2020 2020 2020 7061 7274 6961 6c20 2020 partial │ │ │ │ +0003c300: 2020 2020 2070 6172 7469 616c 2020 2020 partial │ │ │ │ +0003c310: 2020 2020 7061 7274 6961 6c20 2020 2020 partial │ │ │ │ +0003c320: 2020 2070 6172 7469 616c 0a68 696e 7473 partial.hints │ │ │ │ +0003c330: 2020 2020 2020 2020 2020 6775 6573 7320 guess │ │ │ │ +0003c340: 2020 2020 2020 2020 2067 7565 7373 2020 guess │ │ │ │ +0003c350: 2020 2020 2020 2020 6775 6573 7320 2020 guess │ │ │ │ +0003c360: 2020 2020 2020 2067 7565 7373 0a50 4349 guess.PCI │ │ │ │ +0003c370: 2020 2020 2020 2020 2020 2020 7965 7320 yes │ │ │ │ +0003c380: 2020 2020 2020 2020 2020 2079 6573 2020 yes │ │ │ │ +0003c390: 2020 2020 2020 2020 2020 7965 7320 2020 yes │ │ │ │ +0003c3a0: 2020 2020 2020 2020 2079 6573 0a62 6164 yes.bad │ │ │ │ +0003c3b0: 7261 6d20 2020 2020 2020 2020 7965 7320 ram yes │ │ │ │ +0003c3c0: 2020 2020 2020 2020 2020 2079 6573 2020 yes │ │ │ │ +0003c3d0: 2020 2020 2020 2020 2020 7965 7320 2020 yes │ │ │ │ +0003c3e0: 2020 2020 2020 2020 2079 6573 0a63 6f6d yes.com │ │ │ │ +0003c3f0: 7072 6573 7369 6f6e 2020 2020 616c 7761 pression alwa │ │ │ │ +0003c400: 7973 2020 2020 2020 2020 2070 6f69 6e74 ys point │ │ │ │ +0003c410: 6c65 7373 2020 2020 2020 6e6f 2020 2020 less no │ │ │ │ +0003c420: 2020 2020 2020 2020 206e 6f0a 6578 6974 no.exit │ │ │ │ +0003c430: 2020 2020 2020 2020 2020 2079 6573 2020 yes │ │ │ │ +0003c440: 2020 2020 2020 2020 2020 6e6f 2020 2020 no │ │ │ │ +0003c450: 2020 2020 2020 2020 206e 6f20 2020 2020 no │ │ │ │ +0003c460: 2020 2020 2020 2020 6e6f 0a62 6f6f 746c no.bootl │ │ │ │ +0003c470: 6f63 6174 696f 6e20 2020 6469 736b 2020 ocation disk │ │ │ │ +0003c480: 2020 2020 2020 2020 206e 6f20 2020 2020 no │ │ │ │ +0003c490: 2020 2020 2020 2020 6e6f 2020 2020 2020 no │ │ │ │ +0003c4a0: 2020 2020 2020 206e 6f0a 0a20 2020 2020 no.. │ │ │ │ +0003c4b0: 2020 2020 2020 2020 2020 6961 3332 2045 ia32 E │ │ │ │ +0003c4c0: 4649 2020 2020 2020 2061 6d64 3634 2045 FI amd64 E │ │ │ │ +0003c4d0: 4649 2020 2020 2020 6961 3332 2020 2020 FI ia32 │ │ │ │ +0003c4e0: 2020 2020 2020 2049 7461 6e69 756d 0a20 Itanium. │ │ │ │ 0003c4f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ 0003c500: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -0003c510: 2020 2020 2020 2020 4945 4545 3132 3735 IEEE1275 │ │ │ │ -0003c520: 0a76 6964 656f 2020 2020 2020 2020 2020 .video │ │ │ │ -0003c530: 7965 7320 2020 2020 2020 2020 2020 2079 yes y │ │ │ │ -0003c540: 6573 2020 2020 2020 2020 2020 2020 6e6f es no │ │ │ │ -0003c550: 2020 2020 2020 2020 2020 2020 206e 6f0a no. │ │ │ │ -0003c560: 636f 6e73 6f6c 6520 2020 2020 2020 2055 console U │ │ │ │ -0003c570: 6e69 636f 6465 2020 2020 2020 2020 556e nicode Un │ │ │ │ -0003c580: 6963 6f64 6520 2020 2020 2020 2041 5343 icode ASC │ │ │ │ -0003c590: 4949 2020 2020 2020 2020 2020 556e 6963 II Unic │ │ │ │ -0003c5a0: 6f64 650a 6368 6172 7365 740a 6e65 7477 ode.charset.netw │ │ │ │ -0003c5b0: 6f72 6b20 2020 2020 2020 2079 6573 2020 ork yes │ │ │ │ -0003c5c0: 2020 2020 2020 2020 2020 7965 7320 2020 yes │ │ │ │ -0003c5d0: 2020 2020 2020 2020 2079 6573 2020 2020 yes │ │ │ │ -0003c5e0: 2020 2020 2020 2020 7965 730a 4154 412f yes.ATA/ │ │ │ │ -0003c5f0: 4148 4349 2020 2020 2020 2079 6573 2020 AHCI yes │ │ │ │ -0003c600: 2020 2020 2020 2020 2020 7965 7320 2020 yes │ │ │ │ -0003c610: 2020 2020 2020 2020 2079 6573 2020 2020 yes │ │ │ │ -0003c620: 2020 2020 2020 2020 6e6f 0a41 5420 6b65 no.AT ke │ │ │ │ -0003c630: 7962 6f61 7264 2020 2020 7965 7320 2020 yboard yes │ │ │ │ -0003c640: 2020 2020 2020 2020 2079 6573 2020 2020 yes │ │ │ │ -0003c650: 2020 2020 2020 2020 7965 7320 2020 2020 yes │ │ │ │ -0003c660: 2020 2020 2020 206e 6f0a 5370 6561 6b65 no.Speake │ │ │ │ -0003c670: 7220 2020 2020 2020 2079 6573 2020 2020 r yes │ │ │ │ -0003c680: 2020 2020 2020 2020 7965 7320 2020 2020 yes │ │ │ │ -0003c690: 2020 2020 2020 2079 6573 2020 2020 2020 yes │ │ │ │ -0003c6a0: 2020 2020 2020 6e6f 0a55 5342 2020 2020 no.USB │ │ │ │ -0003c6b0: 2020 2020 2020 2020 7965 7320 2020 2020 yes │ │ │ │ -0003c6c0: 2020 2020 2020 2079 6573 2020 2020 2020 yes │ │ │ │ -0003c6d0: 2020 2020 2020 7965 7320 2020 2020 2020 yes │ │ │ │ -0003c6e0: 2020 2020 206e 6f0a 6368 6169 6e6c 6f61 no.chainloa │ │ │ │ -0003c6f0: 6465 7220 2020 206c 6f63 616c 2020 2020 der local │ │ │ │ -0003c700: 2020 2020 2020 6c6f 6361 6c20 2020 2020 local │ │ │ │ -0003c710: 2020 2020 206e 6f20 2020 2020 2020 2020 no │ │ │ │ -0003c720: 2020 2020 6c6f 6361 6c0a 6370 7569 6420 local.cpuid │ │ │ │ -0003c730: 2020 2020 2020 2020 2070 6172 7469 616c partial │ │ │ │ -0003c740: 2020 2020 2020 2020 7061 7274 6961 6c20 partial │ │ │ │ -0003c750: 2020 2020 2020 2070 6172 7469 616c 2020 partial │ │ │ │ -0003c760: 2020 2020 2020 6e6f 0a72 646d 7372 2020 no.rdmsr │ │ │ │ -0003c770: 2020 2020 2020 2020 7061 7274 6961 6c20 partial │ │ │ │ -0003c780: 2020 2020 2020 2070 6172 7469 616c 2020 partial │ │ │ │ -0003c790: 2020 2020 2020 7061 7274 6961 6c20 2020 partial │ │ │ │ -0003c7a0: 2020 2020 206e 6f0a 7772 6d73 7220 2020 no.wrmsr │ │ │ │ -0003c7b0: 2020 2020 2020 2070 6172 7469 616c 2020 partial │ │ │ │ -0003c7c0: 2020 2020 2020 7061 7274 6961 6c20 2020 partial │ │ │ │ -0003c7d0: 2020 2020 2070 6172 7469 616c 2020 2020 partial │ │ │ │ -0003c7e0: 2020 2020 6e6f 0a68 696e 7473 2020 2020 no.hints │ │ │ │ -0003c7f0: 2020 2020 2020 6775 6573 7320 2020 2020 guess │ │ │ │ -0003c800: 2020 2020 2067 7565 7373 2020 2020 2020 guess │ │ │ │ -0003c810: 2020 2020 676f 6f64 2020 2020 2020 2020 good │ │ │ │ -0003c820: 2020 2067 7565 7373 0a50 4349 2020 2020 guess.PCI │ │ │ │ -0003c830: 2020 2020 2020 2020 7965 7320 2020 2020 yes │ │ │ │ -0003c840: 2020 2020 2020 2079 6573 2020 2020 2020 yes │ │ │ │ -0003c850: 2020 2020 2020 7965 7320 2020 2020 2020 yes │ │ │ │ -0003c860: 2020 2020 206e 6f0a 6261 6472 616d 2020 no.badram │ │ │ │ -0003c870: 2020 2020 2020 2079 6573 2020 2020 2020 yes │ │ │ │ -0003c880: 2020 2020 2020 7965 7320 2020 2020 2020 yes │ │ │ │ -0003c890: 2020 2020 206e 6f20 2020 2020 2020 2020 no │ │ │ │ -0003c8a0: 2020 2020 7965 730a 636f 6d70 7265 7373 yes.compress │ │ │ │ -0003c8b0: 696f 6e20 2020 206e 6f20 2020 2020 2020 ion no │ │ │ │ -0003c8c0: 2020 2020 2020 6e6f 2020 2020 2020 2020 no │ │ │ │ -0003c8d0: 2020 2020 206e 6f20 2020 2020 2020 2020 no │ │ │ │ -0003c8e0: 2020 2020 6e6f 0a65 7869 7420 2020 2020 no.exit │ │ │ │ -0003c8f0: 2020 2020 2020 7965 7320 2020 2020 2020 yes │ │ │ │ -0003c900: 2020 2020 2079 6573 2020 2020 2020 2020 yes │ │ │ │ -0003c910: 2020 2020 7965 7320 2020 2020 2020 2020 yes │ │ │ │ -0003c920: 2020 2079 6573 0a62 6f6f 746c 6f63 6174 yes.bootlocat │ │ │ │ -0003c930: 696f 6e20 2020 6669 6c65 2020 2020 2020 ion file │ │ │ │ -0003c940: 2020 2020 2066 696c 6520 2020 2020 2020 file │ │ │ │ -0003c950: 2020 2020 6669 6c65 2c20 2020 2020 2020 file, │ │ │ │ -0003c960: 2020 2066 696c 650a 2020 2020 2020 2020 file. │ │ │ │ +0003c510: 2020 2020 2020 2020 2020 2020 4945 4545 IEEE │ │ │ │ +0003c520: 3132 3735 0a76 6964 656f 2020 2020 2020 1275.video │ │ │ │ +0003c530: 2020 2020 7965 7320 2020 2020 2020 2020 yes │ │ │ │ +0003c540: 2020 2079 6573 2020 2020 2020 2020 2020 yes │ │ │ │ +0003c550: 2020 6e6f 2020 2020 2020 2020 2020 2020 no │ │ │ │ +0003c560: 206e 6f0a 636f 6e73 6f6c 6520 2020 2020 no.console │ │ │ │ +0003c570: 2020 2055 6e69 636f 6465 2020 2020 2020 Unicode │ │ │ │ +0003c580: 2020 556e 6963 6f64 6520 2020 2020 2020 Unicode │ │ │ │ +0003c590: 2041 5343 4949 2020 2020 2020 2020 2020 ASCII │ │ │ │ +0003c5a0: 556e 6963 6f64 650a 6368 6172 7365 740a Unicode.charset. │ │ │ │ +0003c5b0: 6e65 7477 6f72 6b20 2020 2020 2020 2079 network y │ │ │ │ +0003c5c0: 6573 2020 2020 2020 2020 2020 2020 7965 es ye │ │ │ │ +0003c5d0: 7320 2020 2020 2020 2020 2020 2079 6573 s yes │ │ │ │ +0003c5e0: 2020 2020 2020 2020 2020 2020 7965 730a yes. │ │ │ │ +0003c5f0: 4154 412f 4148 4349 2020 2020 2020 2079 ATA/AHCI y │ │ │ │ +0003c600: 6573 2020 2020 2020 2020 2020 2020 7965 es ye │ │ │ │ +0003c610: 7320 2020 2020 2020 2020 2020 2079 6573 s yes │ │ │ │ +0003c620: 2020 2020 2020 2020 2020 2020 6e6f 0a41 no.A │ │ │ │ +0003c630: 5420 6b65 7962 6f61 7264 2020 2020 7965 T keyboard ye │ │ │ │ +0003c640: 7320 2020 2020 2020 2020 2020 2079 6573 s yes │ │ │ │ +0003c650: 2020 2020 2020 2020 2020 2020 7965 7320 yes │ │ │ │ +0003c660: 2020 2020 2020 2020 2020 206e 6f0a 5370 no.Sp │ │ │ │ +0003c670: 6561 6b65 7220 2020 2020 2020 2079 6573 eaker yes │ │ │ │ +0003c680: 2020 2020 2020 2020 2020 2020 7965 7320 yes │ │ │ │ +0003c690: 2020 2020 2020 2020 2020 2079 6573 2020 yes │ │ │ │ +0003c6a0: 2020 2020 2020 2020 2020 6e6f 0a55 5342 no.USB │ │ │ │ +0003c6b0: 2020 2020 2020 2020 2020 2020 7965 7320 yes │ │ │ │ +0003c6c0: 2020 2020 2020 2020 2020 2079 6573 2020 yes │ │ │ │ +0003c6d0: 2020 2020 2020 2020 2020 7965 7320 2020 yes │ │ │ │ +0003c6e0: 2020 2020 2020 2020 206e 6f0a 6368 6169 no.chai │ │ │ │ +0003c6f0: 6e6c 6f61 6465 7220 2020 206c 6f63 616c nloader local │ │ │ │ +0003c700: 2020 2020 2020 2020 2020 6c6f 6361 6c20 local │ │ │ │ +0003c710: 2020 2020 2020 2020 206e 6f20 2020 2020 no │ │ │ │ +0003c720: 2020 2020 2020 2020 6c6f 6361 6c0a 6370 local.cp │ │ │ │ +0003c730: 7569 6420 2020 2020 2020 2020 2070 6172 uid par │ │ │ │ +0003c740: 7469 616c 2020 2020 2020 2020 7061 7274 tial part │ │ │ │ +0003c750: 6961 6c20 2020 2020 2020 2070 6172 7469 ial parti │ │ │ │ +0003c760: 616c 2020 2020 2020 2020 6e6f 0a72 646d al no.rdm │ │ │ │ +0003c770: 7372 2020 2020 2020 2020 2020 7061 7274 sr part │ │ │ │ +0003c780: 6961 6c20 2020 2020 2020 2070 6172 7469 ial parti │ │ │ │ +0003c790: 616c 2020 2020 2020 2020 7061 7274 6961 al partia │ │ │ │ +0003c7a0: 6c20 2020 2020 2020 206e 6f0a 7772 6d73 l no.wrms │ │ │ │ +0003c7b0: 7220 2020 2020 2020 2020 2070 6172 7469 r parti │ │ │ │ +0003c7c0: 616c 2020 2020 2020 2020 7061 7274 6961 al partia │ │ │ │ +0003c7d0: 6c20 2020 2020 2020 2070 6172 7469 616c l partial │ │ │ │ +0003c7e0: 2020 2020 2020 2020 6e6f 0a68 696e 7473 no.hints │ │ │ │ +0003c7f0: 2020 2020 2020 2020 2020 6775 6573 7320 guess │ │ │ │ +0003c800: 2020 2020 2020 2020 2067 7565 7373 2020 guess │ │ │ │ +0003c810: 2020 2020 2020 2020 676f 6f64 2020 2020 good │ │ │ │ +0003c820: 2020 2020 2020 2067 7565 7373 0a50 4349 guess.PCI │ │ │ │ +0003c830: 2020 2020 2020 2020 2020 2020 7965 7320 yes │ │ │ │ +0003c840: 2020 2020 2020 2020 2020 2079 6573 2020 yes │ │ │ │ +0003c850: 2020 2020 2020 2020 2020 7965 7320 2020 yes │ │ │ │ +0003c860: 2020 2020 2020 2020 206e 6f0a 6261 6472 no.badr │ │ │ │ +0003c870: 616d 2020 2020 2020 2020 2079 6573 2020 am yes │ │ │ │ +0003c880: 2020 2020 2020 2020 2020 7965 7320 2020 yes │ │ │ │ +0003c890: 2020 2020 2020 2020 206e 6f20 2020 2020 no │ │ │ │ +0003c8a0: 2020 2020 2020 2020 7965 730a 636f 6d70 yes.comp │ │ │ │ +0003c8b0: 7265 7373 696f 6e20 2020 206e 6f20 2020 ression no │ │ │ │ +0003c8c0: 2020 2020 2020 2020 2020 6e6f 2020 2020 no │ │ │ │ +0003c8d0: 2020 2020 2020 2020 206e 6f20 2020 2020 no │ │ │ │ +0003c8e0: 2020 2020 2020 2020 6e6f 0a65 7869 7420 no.exit │ │ │ │ +0003c8f0: 2020 2020 2020 2020 2020 7965 7320 2020 yes │ │ │ │ +0003c900: 2020 2020 2020 2020 2079 6573 2020 2020 yes │ │ │ │ +0003c910: 2020 2020 2020 2020 7965 7320 2020 2020 yes │ │ │ │ +0003c920: 2020 2020 2020 2079 6573 0a62 6f6f 746c yes.bootl │ │ │ │ +0003c930: 6f63 6174 696f 6e20 2020 6669 6c65 2020 ocation file │ │ │ │ +0003c940: 2020 2020 2020 2020 2066 696c 6520 2020 file │ │ │ │ +0003c950: 2020 2020 2020 2020 6669 6c65 2c20 2020 file, │ │ │ │ +0003c960: 2020 2020 2020 2066 696c 650a 2020 2020 file. │ │ │ │ 0003c970: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ 0003c980: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -0003c990: 2020 2020 2069 676e 6f72 6564 0a0a 2020 ignored.. │ │ │ │ -0003c9a0: 2020 2020 2020 2020 2020 2020 204c 6f6f Loo │ │ │ │ -0003c9b0: 6e67 736f 6e20 2020 2020 2020 7370 6172 ngson spar │ │ │ │ -0003c9c0: 6336 3420 2020 2020 2020 2050 6f77 6572 c64 Power │ │ │ │ -0003c9d0: 7063 2020 2020 2020 2020 4152 430a 7669 pc ARC.vi │ │ │ │ -0003c9e0: 6465 6f20 2020 2020 2020 2020 2079 6573 deo yes │ │ │ │ -0003c9f0: 2020 2020 2020 2020 2020 2020 6e6f 2020 no │ │ │ │ -0003ca00: 2020 2020 2020 2020 2020 2079 6573 2020 yes │ │ │ │ -0003ca10: 2020 2020 2020 2020 2020 6e6f 0a63 6f6e no.con │ │ │ │ -0003ca20: 736f 6c65 2020 2020 2020 2020 4e2f 4120 sole N/A │ │ │ │ -0003ca30: 2020 2020 2020 2020 2020 2041 5343 4949 ASCII │ │ │ │ -0003ca40: 2020 2020 2020 2020 2020 4153 4349 4920 ASCII │ │ │ │ -0003ca50: 2020 2020 2020 2020 2041 5343 4949 0a63 ASCII.c │ │ │ │ -0003ca60: 6861 7273 6574 0a6e 6574 776f 726b 2020 harset.network │ │ │ │ -0003ca70: 2020 2020 2020 6e6f 2020 2020 2020 2020 no │ │ │ │ -0003ca80: 2020 2020 2079 6573 2028 2a29 2020 2020 yes (*) │ │ │ │ -0003ca90: 2020 2020 7965 7320 2020 2020 2020 2020 yes │ │ │ │ -0003caa0: 2020 206e 6f0a 4154 412f 4148 4349 2020 no.ATA/AHCI │ │ │ │ -0003cab0: 2020 2020 2079 6573 2020 2020 2020 2020 yes │ │ │ │ -0003cac0: 2020 2020 6e6f 2020 2020 2020 2020 2020 no │ │ │ │ -0003cad0: 2020 206e 6f20 2020 2020 2020 2020 2020 no │ │ │ │ -0003cae0: 2020 6e6f 0a41 5420 6b65 7962 6f61 7264 no.AT keyboard │ │ │ │ -0003caf0: 2020 2020 7965 7320 2020 2020 2020 2020 yes │ │ │ │ -0003cb00: 2020 206e 6f20 2020 2020 2020 2020 2020 no │ │ │ │ -0003cb10: 2020 6e6f 2020 2020 2020 2020 2020 2020 no │ │ │ │ -0003cb20: 206e 6f0a 5370 6561 6b65 7220 2020 2020 no.Speaker │ │ │ │ -0003cb30: 2020 206e 6f20 2020 2020 2020 2020 2020 no │ │ │ │ -0003cb40: 2020 6e6f 2020 2020 2020 2020 2020 2020 no │ │ │ │ -0003cb50: 206e 6f20 2020 2020 2020 2020 2020 2020 no │ │ │ │ -0003cb60: 6e6f 0a55 5342 2020 2020 2020 2020 2020 no.USB │ │ │ │ -0003cb70: 2020 7965 7320 2020 2020 2020 2020 2020 yes │ │ │ │ -0003cb80: 206e 6f20 2020 2020 2020 2020 2020 2020 no │ │ │ │ -0003cb90: 6e6f 2020 2020 2020 2020 2020 2020 206e no n │ │ │ │ -0003cba0: 6f0a 6368 6169 6e6c 6f61 6465 7220 2020 o.chainloader │ │ │ │ -0003cbb0: 2079 6573 2020 2020 2020 2020 2020 2020 yes │ │ │ │ -0003cbc0: 6e6f 2020 2020 2020 2020 2020 2020 206e no n │ │ │ │ -0003cbd0: 6f20 2020 2020 2020 2020 2020 2020 6e6f o no │ │ │ │ -0003cbe0: 0a63 7075 6964 2020 2020 2020 2020 2020 .cpuid │ │ │ │ -0003cbf0: 6e6f 2020 2020 2020 2020 2020 2020 206e no n │ │ │ │ -0003cc00: 6f20 2020 2020 2020 2020 2020 2020 6e6f o no │ │ │ │ -0003cc10: 2020 2020 2020 2020 2020 2020 206e 6f0a no. │ │ │ │ -0003cc20: 7264 6d73 7220 2020 2020 2020 2020 206e rdmsr n │ │ │ │ -0003cc30: 6f20 2020 2020 2020 2020 2020 2020 6e6f o no │ │ │ │ -0003cc40: 2020 2020 2020 2020 2020 2020 206e 6f20 no │ │ │ │ -0003cc50: 2020 2020 2020 2020 2020 2020 6e6f 0a77 no.w │ │ │ │ -0003cc60: 726d 7372 2020 2020 2020 2020 2020 6e6f rmsr no │ │ │ │ -0003cc70: 2020 2020 2020 2020 2020 2020 206e 6f20 no │ │ │ │ -0003cc80: 2020 2020 2020 2020 2020 2020 6e6f 2020 no │ │ │ │ -0003cc90: 2020 2020 2020 2020 2020 206e 6f0a 6869 no.hi │ │ │ │ -0003cca0: 6e74 7320 2020 2020 2020 2020 2067 6f6f nts goo │ │ │ │ -0003ccb0: 6420 2020 2020 2020 2020 2020 676f 6f64 d good │ │ │ │ -0003ccc0: 2020 2020 2020 2020 2020 2067 6f6f 6420 good │ │ │ │ -0003ccd0: 2020 2020 2020 2020 2020 6e6f 0a50 4349 no.PCI │ │ │ │ -0003cce0: 2020 2020 2020 2020 2020 2020 7965 7320 yes │ │ │ │ -0003ccf0: 2020 2020 2020 2020 2020 206e 6f20 2020 no │ │ │ │ -0003cd00: 2020 2020 2020 2020 2020 6e6f 2020 2020 no │ │ │ │ -0003cd10: 2020 2020 2020 2020 206e 6f0a 6261 6472 no.badr │ │ │ │ -0003cd20: 616d 2020 2020 2020 2020 2079 6573 2028 am yes ( │ │ │ │ -0003cd30: 2a29 2020 2020 2020 2020 6e6f 2020 2020 *) no │ │ │ │ -0003cd40: 2020 2020 2020 2020 206e 6f20 2020 2020 no │ │ │ │ -0003cd50: 2020 2020 2020 2020 6e6f 0a63 6f6d 7072 no.compr │ │ │ │ -0003cd60: 6573 7369 6f6e 2020 2020 636f 6e66 6967 ession config │ │ │ │ -0003cd70: 7572 6162 6c65 2020 206e 6f20 2020 2020 urable no │ │ │ │ -0003cd80: 2020 2020 2020 2020 6e6f 2020 2020 2020 no │ │ │ │ -0003cd90: 2020 2020 2020 2063 6f6e 6669 6775 7261 configura │ │ │ │ -0003cda0: 626c 650a 6578 6974 2020 2020 2020 2020 ble.exit │ │ │ │ -0003cdb0: 2020 206e 6f20 2020 2020 2020 2020 2020 no │ │ │ │ -0003cdc0: 2020 7965 7320 2020 2020 2020 2020 2020 yes │ │ │ │ -0003cdd0: 2079 6573 2020 2020 2020 2020 2020 2020 yes │ │ │ │ -0003cde0: 7965 730a 626f 6f74 6c6f 6361 7469 6f6e yes.bootlocation │ │ │ │ -0003cdf0: 2020 206e 6f20 2020 2020 2020 2020 2020 no │ │ │ │ -0003ce00: 2020 7061 7274 6974 696f 6e20 2020 2020 partition │ │ │ │ -0003ce10: 2066 696c 6520 2020 2020 2020 2020 2020 file │ │ │ │ -0003ce20: 6669 6c65 2028 2a29 0a0a 2020 2020 2020 file (*).. │ │ │ │ -0003ce30: 2020 2020 2020 2020 204d 4950 5320 7165 MIPS qe │ │ │ │ -0003ce40: 6d75 2020 2020 2020 656d 7520 2020 2020 mu emu │ │ │ │ -0003ce50: 2020 2020 2020 2078 656e 0a76 6964 656f xen.video │ │ │ │ -0003ce60: 2020 2020 2020 2020 2020 6e6f 2020 2020 no │ │ │ │ -0003ce70: 2020 2020 2020 2020 2079 6573 2020 2020 yes │ │ │ │ -0003ce80: 2020 2020 2020 2020 6e6f 0a63 6f6e 736f no.conso │ │ │ │ -0003ce90: 6c65 2020 2020 2020 2020 4350 3433 3720 le CP437 │ │ │ │ -0003cea0: 2020 2020 2020 2020 2055 6e69 636f 6465 Unicode │ │ │ │ -0003ceb0: 2028 2a29 2020 2020 4153 4349 490a 6368 (*) ASCII.ch │ │ │ │ -0003cec0: 6172 7365 740a 6e65 7477 6f72 6b20 2020 arset.network │ │ │ │ -0003ced0: 2020 2020 206e 6f20 2020 2020 2020 2020 no │ │ │ │ -0003cee0: 2020 2020 7965 7320 2020 2020 2020 2020 yes │ │ │ │ -0003cef0: 2020 206e 6f0a 4154 412f 4148 4349 2020 no.ATA/AHCI │ │ │ │ -0003cf00: 2020 2020 2079 6573 2020 2020 2020 2020 yes │ │ │ │ -0003cf10: 2020 2020 6e6f 2020 2020 2020 2020 2020 no │ │ │ │ -0003cf20: 2020 206e 6f0a 4154 206b 6579 626f 6172 no.AT keyboar │ │ │ │ -0003cf30: 6420 2020 2079 6573 2020 2020 2020 2020 d yes │ │ │ │ -0003cf40: 2020 2020 6e6f 2020 2020 2020 2020 2020 no │ │ │ │ -0003cf50: 2020 206e 6f0a 5370 6561 6b65 7220 2020 no.Speaker │ │ │ │ -0003cf60: 2020 2020 206e 6f20 2020 2020 2020 2020 no │ │ │ │ -0003cf70: 2020 2020 6e6f 2020 2020 2020 2020 2020 no │ │ │ │ -0003cf80: 2020 206e 6f0a 5553 4220 2020 2020 2020 no.USB │ │ │ │ -0003cf90: 2020 2020 204e 2f41 2020 2020 2020 2020 N/A │ │ │ │ -0003cfa0: 2020 2020 7965 7320 2020 2020 2020 2020 yes │ │ │ │ -0003cfb0: 2020 206e 6f0a 6368 6169 6e6c 6f61 6465 no.chainloade │ │ │ │ -0003cfc0: 7220 2020 2079 6573 2020 2020 2020 2020 r yes │ │ │ │ -0003cfd0: 2020 2020 6e6f 2020 2020 2020 2020 2020 no │ │ │ │ -0003cfe0: 2020 2079 6573 0a63 7075 6964 2020 2020 yes.cpuid │ │ │ │ -0003cff0: 2020 2020 2020 6e6f 2020 2020 2020 2020 no │ │ │ │ -0003d000: 2020 2020 206e 6f20 2020 2020 2020 2020 no │ │ │ │ -0003d010: 2020 2020 7965 730a 7264 6d73 7220 2020 yes.rdmsr │ │ │ │ -0003d020: 2020 2020 2020 206e 6f20 2020 2020 2020 no │ │ │ │ -0003d030: 2020 2020 2020 6e6f 2020 2020 2020 2020 no │ │ │ │ -0003d040: 2020 2020 2079 6573 0a77 726d 7372 2020 yes.wrmsr │ │ │ │ -0003d050: 2020 2020 2020 2020 6e6f 2020 2020 2020 no │ │ │ │ -0003d060: 2020 2020 2020 206e 6f20 2020 2020 2020 no │ │ │ │ -0003d070: 2020 2020 2020 7965 730a 6869 6e74 7320 yes.hints │ │ │ │ -0003d080: 2020 2020 2020 2020 2067 7565 7373 2020 guess │ │ │ │ -0003d090: 2020 2020 2020 2020 6e6f 2020 2020 2020 no │ │ │ │ -0003d0a0: 2020 2020 2020 206e 6f0a 5043 4920 2020 no.PCI │ │ │ │ -0003d0b0: 2020 2020 2020 2020 206e 6f20 2020 2020 no │ │ │ │ -0003d0c0: 2020 2020 2020 2020 6e6f 2020 2020 2020 no │ │ │ │ -0003d0d0: 2020 2020 2020 206e 6f0a 6261 6472 616d no.badram │ │ │ │ -0003d0e0: 2020 2020 2020 2020 2079 6573 2028 2a29 yes (*) │ │ │ │ -0003d0f0: 2020 2020 2020 2020 6e6f 2020 2020 2020 no │ │ │ │ -0003d100: 2020 2020 2020 206e 6f0a 636f 6d70 7265 no.compre │ │ │ │ -0003d110: 7373 696f 6e20 2020 2063 6f6e 6669 6775 ssion configu │ │ │ │ -0003d120: 7261 626c 6520 2020 6e6f 2020 2020 2020 rable no │ │ │ │ -0003d130: 2020 2020 2020 206e 6f0a 6578 6974 2020 no.exit │ │ │ │ -0003d140: 2020 2020 2020 2020 206e 6f20 2020 2020 no │ │ │ │ -0003d150: 2020 2020 2020 2020 7965 7320 2020 2020 yes │ │ │ │ -0003d160: 2020 2020 2020 206e 6f0a 626f 6f74 6c6f no.bootlo │ │ │ │ -0003d170: 6361 7469 6f6e 2020 206e 6f20 2020 2020 cation no │ │ │ │ -0003d180: 2020 2020 2020 2020 6669 6c65 2020 2020 file │ │ │ │ -0003d190: 2020 2020 2020 206e 6f0a 0a1f 0a46 696c no....Fil │ │ │ │ -0003d1a0: 653a 2067 7275 622e 696e 666f 2c20 204e e: grub.info, N │ │ │ │ -0003d1b0: 6f64 653a 2050 6c61 7466 6f72 6d2d 7370 ode: Platform-sp │ │ │ │ -0003d1c0: 6563 6966 6963 206f 7065 7261 7469 6f6e ecific operation │ │ │ │ -0003d1d0: 732c 2020 4e65 7874 3a20 5375 7070 6f72 s, Next: Suppor │ │ │ │ -0003d1e0: 7465 6420 6b65 726e 656c 732c 2020 5072 ted kernels, Pr │ │ │ │ -0003d1f0: 6576 3a20 506c 6174 666f 726d 206c 696d ev: Platform lim │ │ │ │ -0003d200: 6974 6174 696f 6e73 2c20 2055 703a 2054 itations, Up: T │ │ │ │ -0003d210: 6f70 0a0a 3230 204f 7574 6c69 6e65 0a2a op..20 Outline.* │ │ │ │ -0003d220: 2a2a 2a2a 2a2a 2a2a 2a0a 0a53 6f6d 6520 *********..Some │ │ │ │ -0003d230: 706c 6174 666f 726d 7320 6861 7665 2066 platforms have f │ │ │ │ -0003d240: 6561 7475 7265 7320 7768 6963 6820 616c eatures which al │ │ │ │ -0003d250: 6c6f 7773 2074 6f20 696d 706c 656d 656e lows to implemen │ │ │ │ -0003d260: 7420 736f 6d65 2063 6f6d 6d61 6e64 730a t some commands. │ │ │ │ -0003d270: 7573 656c 6573 7320 6f72 206e 6f74 2069 useless or not i │ │ │ │ -0003d280: 6d70 6c65 6d65 6e74 6162 6c65 206f 6e20 mplementable on │ │ │ │ -0003d290: 6f74 6865 7273 2e0a 0a20 2020 5175 6963 others... Quic │ │ │ │ -0003d2a0: 6b20 7375 6d6d 6172 793a 0a0a 2020 2049 k summary:.. I │ │ │ │ -0003d2b0: 6e66 6f72 6d61 7469 6f6e 2072 6574 7269 nformation retri │ │ │ │ -0003d2c0: 6576 616c 3a0a 0a20 2020 2a20 6d69 7073 eval:.. * mips │ │ │ │ -0003d2d0: 656c 2d6c 6f6f 6e67 736f 6e3a 206c 7373 el-loongson: lss │ │ │ │ -0003d2e0: 7064 0a20 2020 2a20 6d69 7073 2d61 7263 pd. * mips-arc │ │ │ │ -0003d2f0: 3a20 6c73 6465 760a 2020 202a 2065 6669 : lsdev. * efi │ │ │ │ -0003d300: 3a20 6c73 6566 6973 7973 7461 622c 206c : lsefisystab, l │ │ │ │ -0003d310: 7373 616c 2c20 6c73 6566 696d 6d61 702c ssal, lsefimmap, │ │ │ │ -0003d320: 206c 7365 6669 0a20 2020 2a20 6933 3836 lsefi. * i386 │ │ │ │ -0003d330: 2d70 633a 206c 7361 706d 0a20 2020 2a20 -pc: lsapm. * │ │ │ │ -0003d340: 6933 3836 2d63 6f72 6562 6f6f 743a 206c i386-coreboot: l │ │ │ │ -0003d350: 7363 6f72 6562 6f6f 742c 2063 6f72 6562 scoreboot, coreb │ │ │ │ -0003d360: 6f6f 745f 626f 6f74 7469 6d65 2c20 6362 oot_boottime, cb │ │ │ │ -0003d370: 6d65 6d63 0a20 2020 2a20 6163 7069 2d65 memc. * acpi-e │ │ │ │ -0003d380: 6e61 626c 6564 2028 6933 3836 2d70 632c nabled (i386-pc, │ │ │ │ -0003d390: 2069 3338 362d 636f 7265 626f 6f74 2c20 i386-coreboot, │ │ │ │ -0003d3a0: 6933 3836 2d6d 756c 7469 626f 6f74 2c20 i386-multiboot, │ │ │ │ -0003d3b0: 2a2d 6566 6929 3a0a 2020 2020 206c 7361 *-efi):. lsa │ │ │ │ -0003d3c0: 6370 690a 0a20 2020 576f 726b 6172 6f75 cpi.. Workarou │ │ │ │ -0003d3d0: 6e64 7320 666f 7220 706c 6174 666f 726d nds for platform │ │ │ │ -0003d3e0: 2d73 7065 6369 6669 6320 6973 7375 6573 -specific issues │ │ │ │ -0003d3f0: 3a0a 2020 202a 2069 3338 362d 6566 692f :. * i386-efi/ │ │ │ │ -0003d400: 7838 365f 3634 2d65 6669 3a20 6c6f 6164 x86_64-efi: load │ │ │ │ -0003d410: 6269 6f73 2c20 6661 6b65 6269 6f73 2c20 bios, fakebios, │ │ │ │ -0003d420: 6669 785f 7669 6465 6f0a 2020 202a 2061 fix_video. * a │ │ │ │ -0003d430: 6370 692d 656e 6162 6c65 6420 2869 3338 cpi-enabled (i38 │ │ │ │ -0003d440: 362d 7063 2c20 6933 3836 2d63 6f72 6562 6-pc, i386-coreb │ │ │ │ -0003d450: 6f6f 742c 2069 3338 362d 6d75 6c74 6962 oot, i386-multib │ │ │ │ -0003d460: 6f6f 742c 202a 2d65 6669 293a 2061 6370 oot, *-efi): acp │ │ │ │ -0003d470: 690a 2020 2020 2028 6f76 6572 7269 6465 i. (override │ │ │ │ -0003d480: 2041 4350 4920 7461 626c 6573 290a 2020 ACPI tables). │ │ │ │ -0003d490: 202a 2069 3338 362d 7063 3a20 6472 6976 * i386-pc: driv │ │ │ │ -0003d4a0: 656d 6170 0a20 2020 2a20 6933 3836 2d70 emap. * i386-p │ │ │ │ -0003d4b0: 633a 2073 656e 646b 6579 0a0a 2020 2041 c: sendkey.. A │ │ │ │ -0003d4c0: 6476 616e 6365 6420 6f70 6572 6174 696f dvanced operatio │ │ │ │ -0003d4d0: 6e73 2066 6f72 2070 6f77 6572 2075 7365 ns for power use │ │ │ │ -0003d4e0: 7273 3a0a 2020 202a 2078 3836 3a20 696f rs:. * x86: io │ │ │ │ -0003d4f0: 7277 2028 6469 7265 6374 2061 6363 6573 rw (direct acces │ │ │ │ -0003d500: 7320 746f 2049 2f4f 2070 6f72 7473 290a s to I/O ports). │ │ │ │ -0003d510: 0a20 2020 4d69 7363 656c 616e 656f 7573 . Miscelaneous │ │ │ │ -0003d520: 3a0a 2020 202a 2063 6d6f 7320 2878 3836 :. * cmos (x86 │ │ │ │ -0003d530: 2d2a 2c20 6965 6565 3132 3735 2c20 6d69 -*, ieee1275, mi │ │ │ │ -0003d540: 7073 2d71 656d 755f 6d69 7073 2c20 6d69 ps-qemu_mips, mi │ │ │ │ -0003d550: 7073 2d6c 6f6f 6e67 736f 6e29 3a20 636d ps-loongson): cm │ │ │ │ -0003d560: 6f73 7465 7374 0a20 2020 2020 2875 7365 ostest. (use │ │ │ │ -0003d570: 6420 6f6e 2073 6f6d 6520 6c61 7074 6f70 d on some laptop │ │ │ │ -0003d580: 7320 746f 2063 6865 636b 2066 6f72 2073 s to check for s │ │ │ │ -0003d590: 7065 6369 616c 2070 6f77 6572 2d6f 6e20 pecial power-on │ │ │ │ -0003d5a0: 6b65 7929 2c20 636d 6f73 636c 6561 6e0a key), cmosclean. │ │ │ │ -0003d5b0: 2020 202a 2069 3338 362d 7063 3a20 706c * i386-pc: pl │ │ │ │ -0003d5c0: 6179 0a0a 1f0a 4669 6c65 3a20 6772 7562 ay....File: grub │ │ │ │ -0003d5d0: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 5375 .info, Node: Su │ │ │ │ -0003d5e0: 7070 6f72 7465 6420 6b65 726e 656c 732c pported kernels, │ │ │ │ -0003d5f0: 2020 4e65 7874 3a20 5472 6f75 626c 6573 Next: Troubles │ │ │ │ -0003d600: 686f 6f74 696e 672c 2020 5072 6576 3a20 hooting, Prev: │ │ │ │ -0003d610: 506c 6174 666f 726d 2d73 7065 6369 6669 Platform-specifi │ │ │ │ -0003d620: 6320 6f70 6572 6174 696f 6e73 2c20 2055 c operations, U │ │ │ │ -0003d630: 703a 2054 6f70 0a0a 3231 2053 7570 706f p: Top..21 Suppo │ │ │ │ -0003d640: 7274 6564 2062 6f6f 7420 7461 7267 6574 rted boot target │ │ │ │ -0003d650: 730a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a s.************** │ │ │ │ -0003d660: 2a2a 2a2a 2a2a 2a2a 2a2a 2a0a 0a58 3836 ***********..X86 │ │ │ │ -0003d670: 2073 7570 706f 7274 2069 7320 7375 6d6d support is summ │ │ │ │ -0003d680: 6172 6973 6564 2069 6e20 7468 6520 666f arised in the fo │ │ │ │ -0003d690: 6c6c 6f77 696e 6720 7461 626c 652e 2020 llowing table. │ │ │ │ -0003d6a0: 2259 6573 2220 6d65 616e 7320 7468 6174 "Yes" means that │ │ │ │ -0003d6b0: 2074 6865 0a6b 6572 6e65 6c20 776f 726b the.kernel work │ │ │ │ -0003d6c0: 7320 6f6e 2074 6865 2067 6976 656e 2070 s on the given p │ │ │ │ -0003d6d0: 6c61 7466 6f72 6d2c 2022 6372 6173 6865 latform, "crashe │ │ │ │ -0003d6e0: 7322 206d 6561 6e73 2061 6e20 6561 726c s" means an earl │ │ │ │ -0003d6f0: 7920 6b65 726e 656c 0a63 7261 7368 2077 y kernel.crash w │ │ │ │ -0003d700: 6869 6368 2077 6520 686f 7065 2077 696c hich we hope wil │ │ │ │ -0003d710: 6c20 6265 2066 6978 6564 2062 7920 636f l be fixed by co │ │ │ │ -0003d720: 6e63 6572 6e65 6420 6b65 726e 656c 2064 ncerned kernel d │ │ │ │ -0003d730: 6576 656c 6f70 6572 732e 2020 226e 6f22 evelopers. "no" │ │ │ │ -0003d740: 0a6d 6561 6e73 2047 5255 4220 646f 6573 .means GRUB does │ │ │ │ -0003d750: 6e27 7420 6c6f 6164 2074 6865 2067 6976 n't load the giv │ │ │ │ -0003d760: 656e 206b 6572 6e65 6c20 6f6e 2061 2067 en kernel on a g │ │ │ │ -0003d770: 6976 656e 2070 6c61 7466 6f72 6d2e 0a22 iven platform.." │ │ │ │ -0003d780: 6865 6164 6c65 7373 2220 6d65 616e 7320 headless" means │ │ │ │ -0003d790: 7468 6174 2074 6865 206b 6572 6e65 6c20 that the kernel │ │ │ │ -0003d7a0: 776f 726b 7320 6275 7420 6c61 636b 7320 works but lacks │ │ │ │ -0003d7b0: 636f 6e73 6f6c 6520 6472 6976 6572 7320 console drivers │ │ │ │ -0003d7c0: 2879 6f75 0a63 616e 2073 7469 6c6c 2075 (you.can still u │ │ │ │ -0003d7d0: 7365 2073 6572 6961 6c20 6f72 206e 6574 se serial or net │ │ │ │ -0003d7e0: 776f 726b 2063 6f6e 736f 6c65 292e 2020 work console). │ │ │ │ -0003d7f0: 496e 2063 6173 6520 6f66 2022 6e6f 2220 In case of "no" │ │ │ │ -0003d800: 616e 6420 2263 7261 7368 6573 220a 7468 and "crashes".th │ │ │ │ -0003d810: 6520 7265 6173 6f6e 2069 7320 6769 7665 e reason is give │ │ │ │ -0003d820: 6e20 696e 2066 6f6f 746e 6f74 652e 0a20 n in footnote.. │ │ │ │ -0003d830: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +0003c990: 2020 2020 2020 2020 2069 676e 6f72 6564 ignored │ │ │ │ +0003c9a0: 0a0a 2020 2020 2020 2020 2020 2020 2020 .. │ │ │ │ +0003c9b0: 204c 6f6f 6e67 736f 6e20 2020 2020 2020 Loongson │ │ │ │ +0003c9c0: 7370 6172 6336 3420 2020 2020 2020 2050 sparc64 P │ │ │ │ +0003c9d0: 6f77 6572 7063 2020 2020 2020 2020 4152 owerpc AR │ │ │ │ +0003c9e0: 430a 7669 6465 6f20 2020 2020 2020 2020 C.video │ │ │ │ +0003c9f0: 2079 6573 2020 2020 2020 2020 2020 2020 yes │ │ │ │ +0003ca00: 6e6f 2020 2020 2020 2020 2020 2020 2079 no y │ │ │ │ +0003ca10: 6573 2020 2020 2020 2020 2020 2020 6e6f es no │ │ │ │ +0003ca20: 0a63 6f6e 736f 6c65 2020 2020 2020 2020 .console │ │ │ │ +0003ca30: 4e2f 4120 2020 2020 2020 2020 2020 2041 N/A A │ │ │ │ +0003ca40: 5343 4949 2020 2020 2020 2020 2020 4153 SCII AS │ │ │ │ +0003ca50: 4349 4920 2020 2020 2020 2020 2041 5343 CII ASC │ │ │ │ +0003ca60: 4949 0a63 6861 7273 6574 0a6e 6574 776f II.charset.netwo │ │ │ │ +0003ca70: 726b 2020 2020 2020 2020 6e6f 2020 2020 rk no │ │ │ │ +0003ca80: 2020 2020 2020 2020 2079 6573 2028 2a29 yes (*) │ │ │ │ +0003ca90: 2020 2020 2020 2020 7965 7320 2020 2020 yes │ │ │ │ +0003caa0: 2020 2020 2020 206e 6f0a 4154 412f 4148 no.ATA/AH │ │ │ │ +0003cab0: 4349 2020 2020 2020 2079 6573 2020 2020 CI yes │ │ │ │ +0003cac0: 2020 2020 2020 2020 6e6f 2020 2020 2020 no │ │ │ │ +0003cad0: 2020 2020 2020 206e 6f20 2020 2020 2020 no │ │ │ │ +0003cae0: 2020 2020 2020 6e6f 0a41 5420 6b65 7962 no.AT keyb │ │ │ │ +0003caf0: 6f61 7264 2020 2020 7965 7320 2020 2020 oard yes │ │ │ │ +0003cb00: 2020 2020 2020 206e 6f20 2020 2020 2020 no │ │ │ │ +0003cb10: 2020 2020 2020 6e6f 2020 2020 2020 2020 no │ │ │ │ +0003cb20: 2020 2020 206e 6f0a 5370 6561 6b65 7220 no.Speaker │ │ │ │ +0003cb30: 2020 2020 2020 206e 6f20 2020 2020 2020 no │ │ │ │ +0003cb40: 2020 2020 2020 6e6f 2020 2020 2020 2020 no │ │ │ │ +0003cb50: 2020 2020 206e 6f20 2020 2020 2020 2020 no │ │ │ │ +0003cb60: 2020 2020 6e6f 0a55 5342 2020 2020 2020 no.USB │ │ │ │ +0003cb70: 2020 2020 2020 7965 7320 2020 2020 2020 yes │ │ │ │ +0003cb80: 2020 2020 206e 6f20 2020 2020 2020 2020 no │ │ │ │ +0003cb90: 2020 2020 6e6f 2020 2020 2020 2020 2020 no │ │ │ │ +0003cba0: 2020 206e 6f0a 6368 6169 6e6c 6f61 6465 no.chainloade │ │ │ │ +0003cbb0: 7220 2020 2079 6573 2020 2020 2020 2020 r yes │ │ │ │ +0003cbc0: 2020 2020 6e6f 2020 2020 2020 2020 2020 no │ │ │ │ +0003cbd0: 2020 206e 6f20 2020 2020 2020 2020 2020 no │ │ │ │ +0003cbe0: 2020 6e6f 0a63 7075 6964 2020 2020 2020 no.cpuid │ │ │ │ +0003cbf0: 2020 2020 6e6f 2020 2020 2020 2020 2020 no │ │ │ │ +0003cc00: 2020 206e 6f20 2020 2020 2020 2020 2020 no │ │ │ │ +0003cc10: 2020 6e6f 2020 2020 2020 2020 2020 2020 no │ │ │ │ +0003cc20: 206e 6f0a 7264 6d73 7220 2020 2020 2020 no.rdmsr │ │ │ │ +0003cc30: 2020 206e 6f20 2020 2020 2020 2020 2020 no │ │ │ │ +0003cc40: 2020 6e6f 2020 2020 2020 2020 2020 2020 no │ │ │ │ +0003cc50: 206e 6f20 2020 2020 2020 2020 2020 2020 no │ │ │ │ +0003cc60: 6e6f 0a77 726d 7372 2020 2020 2020 2020 no.wrmsr │ │ │ │ +0003cc70: 2020 6e6f 2020 2020 2020 2020 2020 2020 no │ │ │ │ +0003cc80: 206e 6f20 2020 2020 2020 2020 2020 2020 no │ │ │ │ +0003cc90: 6e6f 2020 2020 2020 2020 2020 2020 206e no n │ │ │ │ +0003cca0: 6f0a 6869 6e74 7320 2020 2020 2020 2020 o.hints │ │ │ │ +0003ccb0: 2067 6f6f 6420 2020 2020 2020 2020 2020 good │ │ │ │ +0003ccc0: 676f 6f64 2020 2020 2020 2020 2020 2067 good g │ │ │ │ +0003ccd0: 6f6f 6420 2020 2020 2020 2020 2020 6e6f ood no │ │ │ │ +0003cce0: 0a50 4349 2020 2020 2020 2020 2020 2020 .PCI │ │ │ │ +0003ccf0: 7965 7320 2020 2020 2020 2020 2020 206e yes n │ │ │ │ +0003cd00: 6f20 2020 2020 2020 2020 2020 2020 6e6f o no │ │ │ │ +0003cd10: 2020 2020 2020 2020 2020 2020 206e 6f0a no. │ │ │ │ +0003cd20: 6261 6472 616d 2020 2020 2020 2020 2079 badram y │ │ │ │ +0003cd30: 6573 2028 2a29 2020 2020 2020 2020 6e6f es (*) no │ │ │ │ +0003cd40: 2020 2020 2020 2020 2020 2020 206e 6f20 no │ │ │ │ +0003cd50: 2020 2020 2020 2020 2020 2020 6e6f 0a63 no.c │ │ │ │ +0003cd60: 6f6d 7072 6573 7369 6f6e 2020 2020 636f ompression co │ │ │ │ +0003cd70: 6e66 6967 7572 6162 6c65 2020 206e 6f20 nfigurable no │ │ │ │ +0003cd80: 2020 2020 2020 2020 2020 2020 6e6f 2020 no │ │ │ │ +0003cd90: 2020 2020 2020 2020 2020 2063 6f6e 6669 confi │ │ │ │ +0003cda0: 6775 7261 626c 650a 6578 6974 2020 2020 gurable.exit │ │ │ │ +0003cdb0: 2020 2020 2020 206e 6f20 2020 2020 2020 no │ │ │ │ +0003cdc0: 2020 2020 2020 7965 7320 2020 2020 2020 yes │ │ │ │ +0003cdd0: 2020 2020 2079 6573 2020 2020 2020 2020 yes │ │ │ │ +0003cde0: 2020 2020 7965 730a 626f 6f74 6c6f 6361 yes.bootloca │ │ │ │ +0003cdf0: 7469 6f6e 2020 206e 6f20 2020 2020 2020 tion no │ │ │ │ +0003ce00: 2020 2020 2020 7061 7274 6974 696f 6e20 partition │ │ │ │ +0003ce10: 2020 2020 2066 696c 6520 2020 2020 2020 file │ │ │ │ +0003ce20: 2020 2020 6669 6c65 2028 2a29 0a0a 2020 file (*).. │ │ │ │ +0003ce30: 2020 2020 2020 2020 2020 2020 204d 4950 MIP │ │ │ │ +0003ce40: 5320 7165 6d75 2020 2020 2020 656d 7520 S qemu emu │ │ │ │ +0003ce50: 2020 2020 2020 2020 2020 2078 656e 0a76 xen.v │ │ │ │ +0003ce60: 6964 656f 2020 2020 2020 2020 2020 6e6f ideo no │ │ │ │ +0003ce70: 2020 2020 2020 2020 2020 2020 2079 6573 yes │ │ │ │ +0003ce80: 2020 2020 2020 2020 2020 2020 6e6f 0a63 no.c │ │ │ │ +0003ce90: 6f6e 736f 6c65 2020 2020 2020 2020 4350 onsole CP │ │ │ │ +0003cea0: 3433 3720 2020 2020 2020 2020 2055 6e69 437 Uni │ │ │ │ +0003ceb0: 636f 6465 2028 2a29 2020 2020 4153 4349 code (*) ASCI │ │ │ │ +0003cec0: 490a 6368 6172 7365 740a 6e65 7477 6f72 I.charset.networ │ │ │ │ +0003ced0: 6b20 2020 2020 2020 206e 6f20 2020 2020 k no │ │ │ │ +0003cee0: 2020 2020 2020 2020 7965 7320 2020 2020 yes │ │ │ │ +0003cef0: 2020 2020 2020 206e 6f0a 4154 412f 4148 no.ATA/AH │ │ │ │ +0003cf00: 4349 2020 2020 2020 2079 6573 2020 2020 CI yes │ │ │ │ +0003cf10: 2020 2020 2020 2020 6e6f 2020 2020 2020 no │ │ │ │ +0003cf20: 2020 2020 2020 206e 6f0a 4154 206b 6579 no.AT key │ │ │ │ +0003cf30: 626f 6172 6420 2020 2079 6573 2020 2020 board yes │ │ │ │ +0003cf40: 2020 2020 2020 2020 6e6f 2020 2020 2020 no │ │ │ │ +0003cf50: 2020 2020 2020 206e 6f0a 5370 6561 6b65 no.Speake │ │ │ │ +0003cf60: 7220 2020 2020 2020 206e 6f20 2020 2020 r no │ │ │ │ +0003cf70: 2020 2020 2020 2020 6e6f 2020 2020 2020 no │ │ │ │ +0003cf80: 2020 2020 2020 206e 6f0a 5553 4220 2020 no.USB │ │ │ │ +0003cf90: 2020 2020 2020 2020 204e 2f41 2020 2020 N/A │ │ │ │ +0003cfa0: 2020 2020 2020 2020 7965 7320 2020 2020 yes │ │ │ │ +0003cfb0: 2020 2020 2020 206e 6f0a 6368 6169 6e6c no.chainl │ │ │ │ +0003cfc0: 6f61 6465 7220 2020 2079 6573 2020 2020 oader yes │ │ │ │ +0003cfd0: 2020 2020 2020 2020 6e6f 2020 2020 2020 no │ │ │ │ +0003cfe0: 2020 2020 2020 2079 6573 0a63 7075 6964 yes.cpuid │ │ │ │ +0003cff0: 2020 2020 2020 2020 2020 6e6f 2020 2020 no │ │ │ │ +0003d000: 2020 2020 2020 2020 206e 6f20 2020 2020 no │ │ │ │ +0003d010: 2020 2020 2020 2020 7965 730a 7264 6d73 yes.rdms │ │ │ │ +0003d020: 7220 2020 2020 2020 2020 206e 6f20 2020 r no │ │ │ │ +0003d030: 2020 2020 2020 2020 2020 6e6f 2020 2020 no │ │ │ │ +0003d040: 2020 2020 2020 2020 2079 6573 0a77 726d yes.wrm │ │ │ │ +0003d050: 7372 2020 2020 2020 2020 2020 6e6f 2020 sr no │ │ │ │ +0003d060: 2020 2020 2020 2020 2020 206e 6f20 2020 no │ │ │ │ +0003d070: 2020 2020 2020 2020 2020 7965 730a 6869 yes.hi │ │ │ │ +0003d080: 6e74 7320 2020 2020 2020 2020 2067 7565 nts gue │ │ │ │ +0003d090: 7373 2020 2020 2020 2020 2020 6e6f 2020 ss no │ │ │ │ +0003d0a0: 2020 2020 2020 2020 2020 206e 6f0a 5043 no.PC │ │ │ │ +0003d0b0: 4920 2020 2020 2020 2020 2020 206e 6f20 I no │ │ │ │ +0003d0c0: 2020 2020 2020 2020 2020 2020 6e6f 2020 no │ │ │ │ +0003d0d0: 2020 2020 2020 2020 2020 206e 6f0a 6261 no.ba │ │ │ │ +0003d0e0: 6472 616d 2020 2020 2020 2020 2079 6573 dram yes │ │ │ │ +0003d0f0: 2028 2a29 2020 2020 2020 2020 6e6f 2020 (*) no │ │ │ │ +0003d100: 2020 2020 2020 2020 2020 206e 6f0a 636f no.co │ │ │ │ +0003d110: 6d70 7265 7373 696f 6e20 2020 2063 6f6e mpression con │ │ │ │ +0003d120: 6669 6775 7261 626c 6520 2020 6e6f 2020 figurable no │ │ │ │ +0003d130: 2020 2020 2020 2020 2020 206e 6f0a 6578 no.ex │ │ │ │ +0003d140: 6974 2020 2020 2020 2020 2020 206e 6f20 it no │ │ │ │ +0003d150: 2020 2020 2020 2020 2020 2020 7965 7320 yes │ │ │ │ +0003d160: 2020 2020 2020 2020 2020 206e 6f0a 626f no.bo │ │ │ │ +0003d170: 6f74 6c6f 6361 7469 6f6e 2020 206e 6f20 otlocation no │ │ │ │ +0003d180: 2020 2020 2020 2020 2020 2020 6669 6c65 file │ │ │ │ +0003d190: 2020 2020 2020 2020 2020 206e 6f0a 0a1f no... │ │ │ │ +0003d1a0: 0a46 696c 653a 2067 7275 622e 696e 666f .File: grub.info │ │ │ │ +0003d1b0: 2c20 204e 6f64 653a 2050 6c61 7466 6f72 , Node: Platfor │ │ │ │ +0003d1c0: 6d2d 7370 6563 6966 6963 206f 7065 7261 m-specific opera │ │ │ │ +0003d1d0: 7469 6f6e 732c 2020 4e65 7874 3a20 5375 tions, Next: Su │ │ │ │ +0003d1e0: 7070 6f72 7465 6420 6b65 726e 656c 732c pported kernels, │ │ │ │ +0003d1f0: 2020 5072 6576 3a20 506c 6174 666f 726d Prev: Platform │ │ │ │ +0003d200: 206c 696d 6974 6174 696f 6e73 2c20 2055 limitations, U │ │ │ │ +0003d210: 703a 2054 6f70 0a0a 3230 204f 7574 6c69 p: Top..20 Outli │ │ │ │ +0003d220: 6e65 0a2a 2a2a 2a2a 2a2a 2a2a 2a0a 0a53 ne.**********..S │ │ │ │ +0003d230: 6f6d 6520 706c 6174 666f 726d 7320 6861 ome platforms ha │ │ │ │ +0003d240: 7665 2066 6561 7475 7265 7320 7768 6963 ve features whic │ │ │ │ +0003d250: 6820 616c 6c6f 7773 2074 6f20 696d 706c h allows to impl │ │ │ │ +0003d260: 656d 656e 7420 736f 6d65 2063 6f6d 6d61 ement some comma │ │ │ │ +0003d270: 6e64 730a 7573 656c 6573 7320 6f72 206e nds.useless or n │ │ │ │ +0003d280: 6f74 2069 6d70 6c65 6d65 6e74 6162 6c65 ot implementable │ │ │ │ +0003d290: 206f 6e20 6f74 6865 7273 2e0a 0a20 2020 on others... │ │ │ │ +0003d2a0: 5175 6963 6b20 7375 6d6d 6172 793a 0a0a Quick summary:.. │ │ │ │ +0003d2b0: 2020 2049 6e66 6f72 6d61 7469 6f6e 2072 Information r │ │ │ │ +0003d2c0: 6574 7269 6576 616c 3a0a 0a20 2020 2a20 etrieval:.. * │ │ │ │ +0003d2d0: 6d69 7073 656c 2d6c 6f6f 6e67 736f 6e3a mipsel-loongson: │ │ │ │ +0003d2e0: 206c 7373 7064 0a20 2020 2a20 6d69 7073 lsspd. * mips │ │ │ │ +0003d2f0: 2d61 7263 3a20 6c73 6465 760a 2020 202a -arc: lsdev. * │ │ │ │ +0003d300: 2065 6669 3a20 6c73 6566 6973 7973 7461 efi: lsefisysta │ │ │ │ +0003d310: 622c 206c 7373 616c 2c20 6c73 6566 696d b, lssal, lsefim │ │ │ │ +0003d320: 6d61 702c 206c 7365 6669 0a20 2020 2a20 map, lsefi. * │ │ │ │ +0003d330: 6933 3836 2d70 633a 206c 7361 706d 0a20 i386-pc: lsapm. │ │ │ │ +0003d340: 2020 2a20 6933 3836 2d63 6f72 6562 6f6f * i386-coreboo │ │ │ │ +0003d350: 743a 206c 7363 6f72 6562 6f6f 742c 2063 t: lscoreboot, c │ │ │ │ +0003d360: 6f72 6562 6f6f 745f 626f 6f74 7469 6d65 oreboot_boottime │ │ │ │ +0003d370: 2c20 6362 6d65 6d63 0a20 2020 2a20 6163 , cbmemc. * ac │ │ │ │ +0003d380: 7069 2d65 6e61 626c 6564 2028 6933 3836 pi-enabled (i386 │ │ │ │ +0003d390: 2d70 632c 2069 3338 362d 636f 7265 626f -pc, i386-corebo │ │ │ │ +0003d3a0: 6f74 2c20 6933 3836 2d6d 756c 7469 626f ot, i386-multibo │ │ │ │ +0003d3b0: 6f74 2c20 2a2d 6566 6929 3a0a 2020 2020 ot, *-efi):. │ │ │ │ +0003d3c0: 206c 7361 6370 690a 0a20 2020 576f 726b lsacpi.. Work │ │ │ │ +0003d3d0: 6172 6f75 6e64 7320 666f 7220 706c 6174 arounds for plat │ │ │ │ +0003d3e0: 666f 726d 2d73 7065 6369 6669 6320 6973 form-specific is │ │ │ │ +0003d3f0: 7375 6573 3a0a 2020 202a 2069 3338 362d sues:. * i386- │ │ │ │ +0003d400: 6566 692f 7838 365f 3634 2d65 6669 3a20 efi/x86_64-efi: │ │ │ │ +0003d410: 6c6f 6164 6269 6f73 2c20 6661 6b65 6269 loadbios, fakebi │ │ │ │ +0003d420: 6f73 2c20 6669 785f 7669 6465 6f0a 2020 os, fix_video. │ │ │ │ +0003d430: 202a 2061 6370 692d 656e 6162 6c65 6420 * acpi-enabled │ │ │ │ +0003d440: 2869 3338 362d 7063 2c20 6933 3836 2d63 (i386-pc, i386-c │ │ │ │ +0003d450: 6f72 6562 6f6f 742c 2069 3338 362d 6d75 oreboot, i386-mu │ │ │ │ +0003d460: 6c74 6962 6f6f 742c 202a 2d65 6669 293a ltiboot, *-efi): │ │ │ │ +0003d470: 2061 6370 690a 2020 2020 2028 6f76 6572 acpi. (over │ │ │ │ +0003d480: 7269 6465 2041 4350 4920 7461 626c 6573 ride ACPI tables │ │ │ │ +0003d490: 290a 2020 202a 2069 3338 362d 7063 3a20 ). * i386-pc: │ │ │ │ +0003d4a0: 6472 6976 656d 6170 0a20 2020 2a20 6933 drivemap. * i3 │ │ │ │ +0003d4b0: 3836 2d70 633a 2073 656e 646b 6579 0a0a 86-pc: sendkey.. │ │ │ │ +0003d4c0: 2020 2041 6476 616e 6365 6420 6f70 6572 Advanced oper │ │ │ │ +0003d4d0: 6174 696f 6e73 2066 6f72 2070 6f77 6572 ations for power │ │ │ │ +0003d4e0: 2075 7365 7273 3a0a 2020 202a 2078 3836 users:. * x86 │ │ │ │ +0003d4f0: 3a20 696f 7277 2028 6469 7265 6374 2061 : iorw (direct a │ │ │ │ +0003d500: 6363 6573 7320 746f 2049 2f4f 2070 6f72 ccess to I/O por │ │ │ │ +0003d510: 7473 290a 0a20 2020 4d69 7363 656c 616e ts).. Miscelan │ │ │ │ +0003d520: 656f 7573 3a0a 2020 202a 2063 6d6f 7320 eous:. * cmos │ │ │ │ +0003d530: 2878 3836 2d2a 2c20 6965 6565 3132 3735 (x86-*, ieee1275 │ │ │ │ +0003d540: 2c20 6d69 7073 2d71 656d 755f 6d69 7073 , mips-qemu_mips │ │ │ │ +0003d550: 2c20 6d69 7073 2d6c 6f6f 6e67 736f 6e29 , mips-loongson) │ │ │ │ +0003d560: 3a20 636d 6f73 7465 7374 0a20 2020 2020 : cmostest. │ │ │ │ +0003d570: 2875 7365 6420 6f6e 2073 6f6d 6520 6c61 (used on some la │ │ │ │ +0003d580: 7074 6f70 7320 746f 2063 6865 636b 2066 ptops to check f │ │ │ │ +0003d590: 6f72 2073 7065 6369 616c 2070 6f77 6572 or special power │ │ │ │ +0003d5a0: 2d6f 6e20 6b65 7929 2c20 636d 6f73 636c -on key), cmoscl │ │ │ │ +0003d5b0: 6561 6e0a 2020 202a 2069 3338 362d 7063 ean. * i386-pc │ │ │ │ +0003d5c0: 3a20 706c 6179 0a0a 1f0a 4669 6c65 3a20 : play....File: │ │ │ │ +0003d5d0: 6772 7562 2e69 6e66 6f2c 2020 4e6f 6465 grub.info, Node │ │ │ │ +0003d5e0: 3a20 5375 7070 6f72 7465 6420 6b65 726e : Supported kern │ │ │ │ +0003d5f0: 656c 732c 2020 4e65 7874 3a20 5472 6f75 els, Next: Trou │ │ │ │ +0003d600: 626c 6573 686f 6f74 696e 672c 2020 5072 bleshooting, Pr │ │ │ │ +0003d610: 6576 3a20 506c 6174 666f 726d 2d73 7065 ev: Platform-spe │ │ │ │ +0003d620: 6369 6669 6320 6f70 6572 6174 696f 6e73 cific operations │ │ │ │ +0003d630: 2c20 2055 703a 2054 6f70 0a0a 3231 2053 , Up: Top..21 S │ │ │ │ +0003d640: 7570 706f 7274 6564 2062 6f6f 7420 7461 upported boot ta │ │ │ │ +0003d650: 7267 6574 730a 2a2a 2a2a 2a2a 2a2a 2a2a rgets.********** │ │ │ │ +0003d660: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a0a ***************. │ │ │ │ +0003d670: 0a58 3836 2073 7570 706f 7274 2069 7320 .X86 support is │ │ │ │ +0003d680: 7375 6d6d 6172 6973 6564 2069 6e20 7468 summarised in th │ │ │ │ +0003d690: 6520 666f 6c6c 6f77 696e 6720 7461 626c e following tabl │ │ │ │ +0003d6a0: 652e 2020 2259 6573 2220 6d65 616e 7320 e. "Yes" means │ │ │ │ +0003d6b0: 7468 6174 2074 6865 0a6b 6572 6e65 6c20 that the.kernel │ │ │ │ +0003d6c0: 776f 726b 7320 6f6e 2074 6865 2067 6976 works on the giv │ │ │ │ +0003d6d0: 656e 2070 6c61 7466 6f72 6d2c 2022 6372 en platform, "cr │ │ │ │ +0003d6e0: 6173 6865 7322 206d 6561 6e73 2061 6e20 ashes" means an │ │ │ │ +0003d6f0: 6561 726c 7920 6b65 726e 656c 0a63 7261 early kernel.cra │ │ │ │ +0003d700: 7368 2077 6869 6368 2077 6520 686f 7065 sh which we hope │ │ │ │ +0003d710: 2077 696c 6c20 6265 2066 6978 6564 2062 will be fixed b │ │ │ │ +0003d720: 7920 636f 6e63 6572 6e65 6420 6b65 726e y concerned kern │ │ │ │ +0003d730: 656c 2064 6576 656c 6f70 6572 732e 2020 el developers. │ │ │ │ +0003d740: 226e 6f22 0a6d 6561 6e73 2047 5255 4220 "no".means GRUB │ │ │ │ +0003d750: 646f 6573 6e27 7420 6c6f 6164 2074 6865 doesn't load the │ │ │ │ +0003d760: 2067 6976 656e 206b 6572 6e65 6c20 6f6e given kernel on │ │ │ │ +0003d770: 2061 2067 6976 656e 2070 6c61 7466 6f72 a given platfor │ │ │ │ +0003d780: 6d2e 0a22 6865 6164 6c65 7373 2220 6d65 m.."headless" me │ │ │ │ +0003d790: 616e 7320 7468 6174 2074 6865 206b 6572 ans that the ker │ │ │ │ +0003d7a0: 6e65 6c20 776f 726b 7320 6275 7420 6c61 nel works but la │ │ │ │ +0003d7b0: 636b 7320 636f 6e73 6f6c 6520 6472 6976 cks console driv │ │ │ │ +0003d7c0: 6572 7320 2879 6f75 0a63 616e 2073 7469 ers (you.can sti │ │ │ │ +0003d7d0: 6c6c 2075 7365 2073 6572 6961 6c20 6f72 ll use serial or │ │ │ │ +0003d7e0: 206e 6574 776f 726b 2063 6f6e 736f 6c65 network console │ │ │ │ +0003d7f0: 292e 2020 496e 2063 6173 6520 6f66 2022 ). In case of " │ │ │ │ +0003d800: 6e6f 2220 616e 6420 2263 7261 7368 6573 no" and "crashes │ │ │ │ +0003d810: 220a 7468 6520 7265 6173 6f6e 2069 7320 ".the reason is │ │ │ │ +0003d820: 6769 7665 6e20 696e 2066 6f6f 746e 6f74 given in footnot │ │ │ │ +0003d830: 652e 0a20 2020 2020 2020 2020 2020 2020 e.. │ │ │ │ 0003d840: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -0003d850: 2020 2020 4249 4f53 2020 2020 2020 2020 BIOS │ │ │ │ -0003d860: 2020 2020 2043 6f72 6562 6f6f 740a 4249 Coreboot.BI │ │ │ │ -0003d870: 4f53 2063 6861 696e 6c6f 6164 696e 6720 OS chainloading │ │ │ │ -0003d880: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -0003d890: 2020 2079 6573 2020 2020 2020 2020 2020 yes │ │ │ │ -0003d8a0: 2020 2020 6e6f 2028 3129 0a4e 544c 4452 no (1).NTLDR │ │ │ │ -0003d8b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +0003d850: 2020 2020 2020 2020 4249 4f53 2020 2020 BIOS │ │ │ │ +0003d860: 2020 2020 2020 2020 2043 6f72 6562 6f6f Coreboo │ │ │ │ +0003d870: 740a 4249 4f53 2063 6861 696e 6c6f 6164 t.BIOS chainload │ │ │ │ +0003d880: 696e 6720 2020 2020 2020 2020 2020 2020 ing │ │ │ │ +0003d890: 2020 2020 2020 2079 6573 2020 2020 2020 yes │ │ │ │ +0003d8a0: 2020 2020 2020 2020 6e6f 2028 3129 0a4e no (1).N │ │ │ │ +0003d8b0: 544c 4452 2020 2020 2020 2020 2020 2020 TLDR │ │ │ │ 0003d8c0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -0003d8d0: 7965 7320 2020 2020 2020 2020 2020 2020 yes │ │ │ │ -0003d8e0: 206e 6f20 2831 290a 506c 616e 3920 2020 no (1).Plan9 │ │ │ │ -0003d8f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -0003d900: 2020 2020 2020 2020 2020 2020 2079 6573 yes │ │ │ │ -0003d910: 2020 2020 2020 2020 2020 2020 2020 6e6f no │ │ │ │ -0003d920: 2028 3129 0a46 7265 6564 6f73 2020 2020 (1).Freedos │ │ │ │ +0003d8d0: 2020 2020 7965 7320 2020 2020 2020 2020 yes │ │ │ │ +0003d8e0: 2020 2020 206e 6f20 2831 290a 506c 616e no (1).Plan │ │ │ │ +0003d8f0: 3920 2020 2020 2020 2020 2020 2020 2020 9 │ │ │ │ +0003d900: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +0003d910: 2079 6573 2020 2020 2020 2020 2020 2020 yes │ │ │ │ +0003d920: 2020 6e6f 2028 3129 0a46 7265 6564 6f73 no (1).Freedos │ │ │ │ 0003d930: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -0003d940: 2020 2020 2020 2020 2020 7965 7320 2020 yes │ │ │ │ -0003d950: 2020 2020 2020 2020 2020 206e 6f20 2831 no (1 │ │ │ │ -0003d960: 290a 4672 6565 4253 4420 626f 6f74 6c6f ).FreeBSD bootlo │ │ │ │ -0003d970: 6164 6572 2020 2020 2020 2020 2020 2020 ader │ │ │ │ -0003d980: 2020 2020 2020 2079 6573 2020 2020 2020 yes │ │ │ │ -0003d990: 2020 2020 2020 2020 6372 6173 6865 7320 crashes │ │ │ │ -0003d9a0: 2831 290a 3332 2d62 6974 206b 4672 6565 (1).32-bit kFree │ │ │ │ -0003d9b0: 4253 4420 2020 2020 2020 2020 2020 2020 BSD │ │ │ │ -0003d9c0: 2020 2020 2020 2020 2079 6573 2020 2020 yes │ │ │ │ -0003d9d0: 2020 2020 2020 2020 2020 6372 6173 6865 crashe │ │ │ │ -0003d9e0: 7320 2835 290a 3634 2d62 6974 206b 4672 s (5).64-bit kFr │ │ │ │ -0003d9f0: 6565 4253 4420 2020 2020 2020 2020 2020 eeBSD │ │ │ │ -0003da00: 2020 2020 2020 2020 2020 2079 6573 2020 yes │ │ │ │ -0003da10: 2020 2020 2020 2020 2020 2020 6372 6173 cras │ │ │ │ -0003da20: 6865 7320 2835 290a 3332 2d62 6974 206b hes (5).32-bit k │ │ │ │ -0003da30: 4e65 7442 5344 2020 2020 2020 2020 2020 NetBSD │ │ │ │ -0003da40: 2020 2020 2020 2020 2020 2020 2079 6573 yes │ │ │ │ -0003da50: 2020 2020 2020 2020 2020 2020 2020 6372 cr │ │ │ │ -0003da60: 6173 6865 7320 2831 290a 3634 2d62 6974 ashes (1).64-bit │ │ │ │ -0003da70: 206b 4e65 7442 5344 2020 2020 2020 2020 kNetBSD │ │ │ │ -0003da80: 2020 2020 2020 2020 2020 2020 2020 2079 y │ │ │ │ -0003da90: 6573 2020 2020 2020 2020 2020 2020 2020 es │ │ │ │ -0003daa0: 6372 6173 6865 730a 3332 2d62 6974 206b crashes.32-bit k │ │ │ │ -0003dab0: 4f70 656e 4253 4420 2020 2020 2020 2020 OpenBSD │ │ │ │ -0003dac0: 2020 2020 2020 2020 2020 2020 2079 6573 yes │ │ │ │ -0003dad0: 2020 2020 2020 2020 2020 2020 2020 7965 ye │ │ │ │ -0003dae0: 730a 3634 2d62 6974 206b 4f70 656e 4253 s.64-bit kOpenBS │ │ │ │ -0003daf0: 4420 2020 2020 2020 2020 2020 2020 2020 D │ │ │ │ -0003db00: 2020 2020 2020 2079 6573 2020 2020 2020 yes │ │ │ │ -0003db10: 2020 2020 2020 2020 7965 730a 4d75 6c74 yes.Mult │ │ │ │ -0003db20: 6962 6f6f 7420 2020 2020 2020 2020 2020 iboot │ │ │ │ +0003d940: 2020 2020 2020 2020 2020 2020 2020 7965 ye │ │ │ │ +0003d950: 7320 2020 2020 2020 2020 2020 2020 206e s n │ │ │ │ +0003d960: 6f20 2831 290a 4672 6565 4253 4420 626f o (1).FreeBSD bo │ │ │ │ +0003d970: 6f74 6c6f 6164 6572 2020 2020 2020 2020 otloader │ │ │ │ +0003d980: 2020 2020 2020 2020 2020 2079 6573 2020 yes │ │ │ │ +0003d990: 2020 2020 2020 2020 2020 2020 6372 6173 cras │ │ │ │ +0003d9a0: 6865 7320 2831 290a 3332 2d62 6974 206b hes (1).32-bit k │ │ │ │ +0003d9b0: 4672 6565 4253 4420 2020 2020 2020 2020 FreeBSD │ │ │ │ +0003d9c0: 2020 2020 2020 2020 2020 2020 2079 6573 yes │ │ │ │ +0003d9d0: 2020 2020 2020 2020 2020 2020 2020 6372 cr │ │ │ │ +0003d9e0: 6173 6865 7320 2835 290a 3634 2d62 6974 ashes (5).64-bit │ │ │ │ +0003d9f0: 206b 4672 6565 4253 4420 2020 2020 2020 kFreeBSD │ │ │ │ +0003da00: 2020 2020 2020 2020 2020 2020 2020 2079 y │ │ │ │ +0003da10: 6573 2020 2020 2020 2020 2020 2020 2020 es │ │ │ │ +0003da20: 6372 6173 6865 7320 2835 290a 3332 2d62 crashes (5).32-b │ │ │ │ +0003da30: 6974 206b 4e65 7442 5344 2020 2020 2020 it kNetBSD │ │ │ │ +0003da40: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +0003da50: 2079 6573 2020 2020 2020 2020 2020 2020 yes │ │ │ │ +0003da60: 2020 6372 6173 6865 7320 2831 290a 3634 crashes (1).64 │ │ │ │ +0003da70: 2d62 6974 206b 4e65 7442 5344 2020 2020 -bit kNetBSD │ │ │ │ +0003da80: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +0003da90: 2020 2079 6573 2020 2020 2020 2020 2020 yes │ │ │ │ +0003daa0: 2020 2020 6372 6173 6865 730a 3332 2d62 crashes.32-b │ │ │ │ +0003dab0: 6974 206b 4f70 656e 4253 4420 2020 2020 it kOpenBSD │ │ │ │ +0003dac0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +0003dad0: 2079 6573 2020 2020 2020 2020 2020 2020 yes │ │ │ │ +0003dae0: 2020 7965 730a 3634 2d62 6974 206b 4f70 yes.64-bit kOp │ │ │ │ +0003daf0: 656e 4253 4420 2020 2020 2020 2020 2020 enBSD │ │ │ │ +0003db00: 2020 2020 2020 2020 2020 2079 6573 2020 yes │ │ │ │ +0003db10: 2020 2020 2020 2020 2020 2020 7965 730a yes. │ │ │ │ +0003db20: 4d75 6c74 6962 6f6f 7420 2020 2020 2020 Multiboot │ │ │ │ 0003db30: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -0003db40: 2079 6573 2020 2020 2020 2020 2020 2020 yes │ │ │ │ -0003db50: 2020 7965 730a 4d75 6c74 6962 6f6f 7432 yes.Multiboot2 │ │ │ │ -0003db60: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -0003db70: 2020 2020 2020 2020 2020 2079 6573 2020 yes │ │ │ │ -0003db80: 2020 2020 2020 2020 2020 2020 7965 730a yes. │ │ │ │ -0003db90: 3332 2d62 6974 204c 696e 7578 2028 6c65 32-bit Linux (le │ │ │ │ -0003dba0: 6761 6379 2070 726f 746f 636f 6c29 2020 gacy protocol) │ │ │ │ -0003dbb0: 2020 2020 2079 6573 2020 2020 2020 2020 yes │ │ │ │ -0003dbc0: 2020 2020 2020 6e6f 2028 3129 0a36 342d no (1).64- │ │ │ │ -0003dbd0: 6269 7420 4c69 6e75 7820 286c 6567 6163 bit Linux (legac │ │ │ │ -0003dbe0: 7920 7072 6f74 6f63 6f6c 2920 2020 2020 y protocol) │ │ │ │ -0003dbf0: 2020 7965 7320 2020 2020 2020 2020 2020 yes │ │ │ │ -0003dc00: 2020 206e 6f20 2831 290a 3332 2d62 6974 no (1).32-bit │ │ │ │ -0003dc10: 204c 696e 7578 2028 6d6f 6465 726e 2070 Linux (modern p │ │ │ │ -0003dc20: 726f 746f 636f 6c29 2020 2020 2020 2079 rotocol) y │ │ │ │ -0003dc30: 6573 2020 2020 2020 2020 2020 2020 2020 es │ │ │ │ -0003dc40: 7965 730a 3634 2d62 6974 204c 696e 7578 yes.64-bit Linux │ │ │ │ -0003dc50: 2028 6d6f 6465 726e 2070 726f 746f 636f (modern protoco │ │ │ │ -0003dc60: 6c29 2020 2020 2020 2079 6573 2020 2020 l) yes │ │ │ │ -0003dc70: 2020 2020 2020 2020 2020 7965 730a 3332 yes.32 │ │ │ │ -0003dc80: 2d62 6974 2058 4e55 2020 2020 2020 2020 -bit XNU │ │ │ │ +0003db40: 2020 2020 2079 6573 2020 2020 2020 2020 yes │ │ │ │ +0003db50: 2020 2020 2020 7965 730a 4d75 6c74 6962 yes.Multib │ │ │ │ +0003db60: 6f6f 7432 2020 2020 2020 2020 2020 2020 oot2 │ │ │ │ +0003db70: 2020 2020 2020 2020 2020 2020 2020 2079 y │ │ │ │ +0003db80: 6573 2020 2020 2020 2020 2020 2020 2020 es │ │ │ │ +0003db90: 7965 730a 3332 2d62 6974 204c 696e 7578 yes.32-bit Linux │ │ │ │ +0003dba0: 2028 6c65 6761 6379 2070 726f 746f 636f (legacy protoco │ │ │ │ +0003dbb0: 6c29 2020 2020 2020 2079 6573 2020 2020 l) yes │ │ │ │ +0003dbc0: 2020 2020 2020 2020 2020 6e6f 2028 3129 no (1) │ │ │ │ +0003dbd0: 0a36 342d 6269 7420 4c69 6e75 7820 286c .64-bit Linux (l │ │ │ │ +0003dbe0: 6567 6163 7920 7072 6f74 6f63 6f6c 2920 egacy protocol) │ │ │ │ +0003dbf0: 2020 2020 2020 7965 7320 2020 2020 2020 yes │ │ │ │ +0003dc00: 2020 2020 2020 206e 6f20 2831 290a 3332 no (1).32 │ │ │ │ +0003dc10: 2d62 6974 204c 696e 7578 2028 6d6f 6465 -bit Linux (mode │ │ │ │ +0003dc20: 726e 2070 726f 746f 636f 6c29 2020 2020 rn protocol) │ │ │ │ +0003dc30: 2020 2079 6573 2020 2020 2020 2020 2020 yes │ │ │ │ +0003dc40: 2020 2020 7965 730a 3634 2d62 6974 204c yes.64-bit L │ │ │ │ +0003dc50: 696e 7578 2028 6d6f 6465 726e 2070 726f inux (modern pro │ │ │ │ +0003dc60: 746f 636f 6c29 2020 2020 2020 2079 6573 tocol) yes │ │ │ │ +0003dc70: 2020 2020 2020 2020 2020 2020 2020 7965 ye │ │ │ │ +0003dc80: 730a 3332 2d62 6974 2058 4e55 2020 2020 s.32-bit XNU │ │ │ │ 0003dc90: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -0003dca0: 2020 2079 6573 2020 2020 2020 2020 2020 yes │ │ │ │ -0003dcb0: 2020 2020 3f0a 3634 2d62 6974 2058 4e55 ?.64-bit XNU │ │ │ │ -0003dcc0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -0003dcd0: 2020 2020 2020 2020 2020 2079 6573 2020 yes │ │ │ │ -0003dce0: 2020 2020 2020 2020 2020 2020 3f0a 3332 ?.32 │ │ │ │ -0003dcf0: 2d62 6974 2045 4649 2063 6861 696e 6c6f -bit EFI chainlo │ │ │ │ -0003dd00: 6164 6572 2020 2020 2020 2020 2020 2020 ader │ │ │ │ -0003dd10: 2020 206e 6f20 2832 2920 2020 2020 2020 no (2) │ │ │ │ -0003dd20: 2020 2020 6e6f 2028 3229 0a36 342d 6269 no (2).64-bi │ │ │ │ -0003dd30: 7420 4546 4920 6368 6169 6e6c 6f61 6465 t EFI chainloade │ │ │ │ -0003dd40: 7220 2020 2020 2020 2020 2020 2020 2020 r │ │ │ │ -0003dd50: 6e6f 2028 3229 2020 2020 2020 2020 2020 no (2) │ │ │ │ -0003dd60: 206e 6f20 2832 290a 4170 706c 656c 6f61 no (2).Appleloa │ │ │ │ -0003dd70: 6465 7220 2020 2020 2020 2020 2020 2020 der │ │ │ │ -0003dd80: 2020 2020 2020 2020 2020 2020 206e 6f20 no │ │ │ │ -0003dd90: 2832 2920 2020 2020 2020 2020 2020 6e6f (2) no │ │ │ │ -0003dda0: 2028 3229 0a0a 2020 2020 2020 2020 2020 (2).. │ │ │ │ +0003dca0: 2020 2020 2020 2079 6573 2020 2020 2020 yes │ │ │ │ +0003dcb0: 2020 2020 2020 2020 3f0a 3634 2d62 6974 ?.64-bit │ │ │ │ +0003dcc0: 2058 4e55 2020 2020 2020 2020 2020 2020 XNU │ │ │ │ +0003dcd0: 2020 2020 2020 2020 2020 2020 2020 2079 y │ │ │ │ +0003dce0: 6573 2020 2020 2020 2020 2020 2020 2020 es │ │ │ │ +0003dcf0: 3f0a 3332 2d62 6974 2045 4649 2063 6861 ?.32-bit EFI cha │ │ │ │ +0003dd00: 696e 6c6f 6164 6572 2020 2020 2020 2020 inloader │ │ │ │ +0003dd10: 2020 2020 2020 206e 6f20 2832 2920 2020 no (2) │ │ │ │ +0003dd20: 2020 2020 2020 2020 6e6f 2028 3229 0a36 no (2).6 │ │ │ │ +0003dd30: 342d 6269 7420 4546 4920 6368 6169 6e6c 4-bit EFI chainl │ │ │ │ +0003dd40: 6f61 6465 7220 2020 2020 2020 2020 2020 oader │ │ │ │ +0003dd50: 2020 2020 6e6f 2028 3229 2020 2020 2020 no (2) │ │ │ │ +0003dd60: 2020 2020 206e 6f20 2832 290a 4170 706c no (2).Appl │ │ │ │ +0003dd70: 656c 6f61 6465 7220 2020 2020 2020 2020 eloader │ │ │ │ +0003dd80: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +0003dd90: 206e 6f20 2832 2920 2020 2020 2020 2020 no (2) │ │ │ │ +0003dda0: 2020 6e6f 2028 3229 0a0a 2020 2020 2020 no (2).. │ │ │ │ 0003ddb0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -0003ddc0: 2020 2020 2020 2020 2020 204d 756c 7469 Multi │ │ │ │ -0003ddd0: 626f 6f74 2020 2020 2020 2020 5165 6d75 boot Qemu │ │ │ │ -0003dde0: 0a42 494f 5320 6368 6169 6e6c 6f61 6469 .BIOS chainloadi │ │ │ │ -0003ddf0: 6e67 2020 2020 2020 2020 2020 2020 2020 ng │ │ │ │ -0003de00: 2020 2020 2020 6e6f 2028 3129 2020 2020 no (1) │ │ │ │ -0003de10: 2020 2020 2020 206e 6f20 2831 290a 4e54 no (1).NT │ │ │ │ -0003de20: 4c44 5220 2020 2020 2020 2020 2020 2020 LDR │ │ │ │ +0003ddc0: 2020 2020 2020 2020 2020 2020 2020 204d M │ │ │ │ +0003ddd0: 756c 7469 626f 6f74 2020 2020 2020 2020 ultiboot │ │ │ │ +0003dde0: 5165 6d75 0a42 494f 5320 6368 6169 6e6c Qemu.BIOS chainl │ │ │ │ +0003ddf0: 6f61 6469 6e67 2020 2020 2020 2020 2020 oading │ │ │ │ +0003de00: 2020 2020 2020 2020 2020 6e6f 2028 3129 no (1) │ │ │ │ +0003de10: 2020 2020 2020 2020 2020 206e 6f20 2831 no (1 │ │ │ │ +0003de20: 290a 4e54 4c44 5220 2020 2020 2020 2020 ).NTLDR │ │ │ │ 0003de30: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -0003de40: 2020 206e 6f20 2831 2920 2020 2020 2020 no (1) │ │ │ │ -0003de50: 2020 2020 6e6f 2028 3129 0a50 6c61 6e39 no (1).Plan9 │ │ │ │ -0003de60: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +0003de40: 2020 2020 2020 206e 6f20 2831 2920 2020 no (1) │ │ │ │ +0003de50: 2020 2020 2020 2020 6e6f 2028 3129 0a50 no (1).P │ │ │ │ +0003de60: 6c61 6e39 2020 2020 2020 2020 2020 2020 lan9 │ │ │ │ 0003de70: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -0003de80: 6e6f 2028 3129 2020 2020 2020 2020 2020 no (1) │ │ │ │ -0003de90: 206e 6f20 2831 290a 4672 6565 444f 5320 no (1).FreeDOS │ │ │ │ -0003dea0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -0003deb0: 2020 2020 2020 2020 2020 2020 206e 6f20 no │ │ │ │ -0003dec0: 2831 2920 2020 2020 2020 2020 2020 6e6f (1) no │ │ │ │ -0003ded0: 2028 3129 0a46 7265 6542 5344 2062 6f6f (1).FreeBSD boo │ │ │ │ -0003dee0: 746c 6f61 6465 7220 2020 2020 2020 2020 tloader │ │ │ │ -0003def0: 2020 2020 2020 2020 2020 6372 6173 6865 crashe │ │ │ │ -0003df00: 7320 2831 2920 2020 2020 2063 7261 7368 s (1) crash │ │ │ │ -0003df10: 6573 2028 3129 0a33 322d 6269 7420 6b46 es (1).32-bit kF │ │ │ │ -0003df20: 7265 6542 5344 2020 2020 2020 2020 2020 reeBSD │ │ │ │ -0003df30: 2020 2020 2020 2020 2020 2020 6372 6173 cras │ │ │ │ -0003df40: 6865 7320 2835 2920 2020 2020 2063 7261 hes (5) cra │ │ │ │ -0003df50: 7368 6573 2028 3529 0a36 342d 6269 7420 shes (5).64-bit │ │ │ │ -0003df60: 6b46 7265 6542 5344 2020 2020 2020 2020 kFreeBSD │ │ │ │ -0003df70: 2020 2020 2020 2020 2020 2020 2020 6372 cr │ │ │ │ -0003df80: 6173 6865 7320 2835 2920 2020 2020 2063 ashes (5) c │ │ │ │ -0003df90: 7261 7368 6573 2028 3529 0a33 322d 6269 rashes (5).32-bi │ │ │ │ -0003dfa0: 7420 6b4e 6574 4253 4420 2020 2020 2020 t kNetBSD │ │ │ │ +0003de80: 2020 2020 6e6f 2028 3129 2020 2020 2020 no (1) │ │ │ │ +0003de90: 2020 2020 206e 6f20 2831 290a 4672 6565 no (1).Free │ │ │ │ +0003dea0: 444f 5320 2020 2020 2020 2020 2020 2020 DOS │ │ │ │ +0003deb0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +0003dec0: 206e 6f20 2831 2920 2020 2020 2020 2020 no (1) │ │ │ │ +0003ded0: 2020 6e6f 2028 3129 0a46 7265 6542 5344 no (1).FreeBSD │ │ │ │ +0003dee0: 2062 6f6f 746c 6f61 6465 7220 2020 2020 bootloader │ │ │ │ +0003def0: 2020 2020 2020 2020 2020 2020 2020 6372 cr │ │ │ │ +0003df00: 6173 6865 7320 2831 2920 2020 2020 2063 ashes (1) c │ │ │ │ +0003df10: 7261 7368 6573 2028 3129 0a33 322d 6269 rashes (1).32-bi │ │ │ │ +0003df20: 7420 6b46 7265 6542 5344 2020 2020 2020 t kFreeBSD │ │ │ │ +0003df30: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +0003df40: 6372 6173 6865 7320 2835 2920 2020 2020 crashes (5) │ │ │ │ +0003df50: 2063 7261 7368 6573 2028 3529 0a36 342d crashes (5).64- │ │ │ │ +0003df60: 6269 7420 6b46 7265 6542 5344 2020 2020 bit kFreeBSD │ │ │ │ +0003df70: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +0003df80: 2020 6372 6173 6865 7320 2835 2920 2020 crashes (5) │ │ │ │ +0003df90: 2020 2063 7261 7368 6573 2028 3529 0a33 crashes (5).3 │ │ │ │ +0003dfa0: 322d 6269 7420 6b4e 6574 4253 4420 2020 2-bit kNetBSD │ │ │ │ 0003dfb0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -0003dfc0: 6372 6173 6865 7320 2831 2920 2020 2020 crashes (1) │ │ │ │ -0003dfd0: 2063 7261 7368 6573 2028 3129 0a36 342d crashes (1).64- │ │ │ │ -0003dfe0: 6269 7420 6b4e 6574 4253 4420 2020 2020 bit kNetBSD │ │ │ │ +0003dfc0: 2020 2020 6372 6173 6865 7320 2831 2920 crashes (1) │ │ │ │ +0003dfd0: 2020 2020 2063 7261 7368 6573 2028 3129 crashes (1) │ │ │ │ +0003dfe0: 0a36 342d 6269 7420 6b4e 6574 4253 4420 .64-bit kNetBSD │ │ │ │ 0003dff0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -0003e000: 2020 7965 7320 2020 2020 2020 2020 2020 yes │ │ │ │ -0003e010: 2020 2079 6573 0a33 322d 6269 7420 6b4f yes.32-bit kO │ │ │ │ -0003e020: 7065 6e42 5344 2020 2020 2020 2020 2020 penBSD │ │ │ │ -0003e030: 2020 2020 2020 2020 2020 2020 7965 7320 yes │ │ │ │ -0003e040: 2020 2020 2020 2020 2020 2020 2079 6573 yes │ │ │ │ -0003e050: 0a36 342d 6269 7420 6b4f 7065 6e42 5344 .64-bit kOpenBSD │ │ │ │ -0003e060: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -0003e070: 2020 2020 2020 7965 7320 2020 2020 2020 yes │ │ │ │ -0003e080: 2020 2020 2020 2079 6573 0a4d 756c 7469 yes.Multi │ │ │ │ -0003e090: 626f 6f74 2020 2020 2020 2020 2020 2020 boot │ │ │ │ +0003e000: 2020 2020 2020 7965 7320 2020 2020 2020 yes │ │ │ │ +0003e010: 2020 2020 2020 2079 6573 0a33 322d 6269 yes.32-bi │ │ │ │ +0003e020: 7420 6b4f 7065 6e42 5344 2020 2020 2020 t kOpenBSD │ │ │ │ +0003e030: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +0003e040: 7965 7320 2020 2020 2020 2020 2020 2020 yes │ │ │ │ +0003e050: 2079 6573 0a36 342d 6269 7420 6b4f 7065 yes.64-bit kOpe │ │ │ │ +0003e060: 6e42 5344 2020 2020 2020 2020 2020 2020 nBSD │ │ │ │ +0003e070: 2020 2020 2020 2020 2020 7965 7320 2020 yes │ │ │ │ +0003e080: 2020 2020 2020 2020 2020 2079 6573 0a4d yes.M │ │ │ │ +0003e090: 756c 7469 626f 6f74 2020 2020 2020 2020 ultiboot │ │ │ │ 0003e0a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -0003e0b0: 7965 7320 2020 2020 2020 2020 2020 2020 yes │ │ │ │ -0003e0c0: 2079 6573 0a4d 756c 7469 626f 6f74 3220 yes.Multiboot2 │ │ │ │ -0003e0d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -0003e0e0: 2020 2020 2020 2020 2020 7965 7320 2020 yes │ │ │ │ -0003e0f0: 2020 2020 2020 2020 2020 2079 6573 0a33 yes.3 │ │ │ │ -0003e100: 322d 6269 7420 4c69 6e75 7820 286c 6567 2-bit Linux (leg │ │ │ │ -0003e110: 6163 7920 7072 6f74 6f63 6f6c 2920 2020 acy protocol) │ │ │ │ -0003e120: 2020 2020 6e6f 2028 3129 2020 2020 2020 no (1) │ │ │ │ -0003e130: 2020 2020 206e 6f20 2831 290a 3634 2d62 no (1).64-b │ │ │ │ -0003e140: 6974 204c 696e 7578 2028 6c65 6761 6379 it Linux (legacy │ │ │ │ -0003e150: 2070 726f 746f 636f 6c29 2020 2020 2020 protocol) │ │ │ │ -0003e160: 206e 6f20 2831 2920 2020 2020 2020 2020 no (1) │ │ │ │ -0003e170: 2020 6e6f 2028 3129 0a33 322d 6269 7420 no (1).32-bit │ │ │ │ -0003e180: 4c69 6e75 7820 286d 6f64 6572 6e20 7072 Linux (modern pr │ │ │ │ -0003e190: 6f74 6f63 6f6c 2920 2020 2020 2020 7965 otocol) ye │ │ │ │ -0003e1a0: 7320 2020 2020 2020 2020 2020 2020 2079 s y │ │ │ │ -0003e1b0: 6573 0a36 342d 6269 7420 4c69 6e75 7820 es.64-bit Linux │ │ │ │ -0003e1c0: 286d 6f64 6572 6e20 7072 6f74 6f63 6f6c (modern protocol │ │ │ │ -0003e1d0: 2920 2020 2020 2020 7965 7320 2020 2020 ) yes │ │ │ │ -0003e1e0: 2020 2020 2020 2020 2079 6573 0a33 322d yes.32- │ │ │ │ -0003e1f0: 6269 7420 584e 5520 2020 2020 2020 2020 bit XNU │ │ │ │ +0003e0b0: 2020 2020 7965 7320 2020 2020 2020 2020 yes │ │ │ │ +0003e0c0: 2020 2020 2079 6573 0a4d 756c 7469 626f yes.Multibo │ │ │ │ +0003e0d0: 6f74 3220 2020 2020 2020 2020 2020 2020 ot2 │ │ │ │ +0003e0e0: 2020 2020 2020 2020 2020 2020 2020 7965 ye │ │ │ │ +0003e0f0: 7320 2020 2020 2020 2020 2020 2020 2079 s y │ │ │ │ +0003e100: 6573 0a33 322d 6269 7420 4c69 6e75 7820 es.32-bit Linux │ │ │ │ +0003e110: 286c 6567 6163 7920 7072 6f74 6f63 6f6c (legacy protocol │ │ │ │ +0003e120: 2920 2020 2020 2020 6e6f 2028 3129 2020 ) no (1) │ │ │ │ +0003e130: 2020 2020 2020 2020 206e 6f20 2831 290a no (1). │ │ │ │ +0003e140: 3634 2d62 6974 204c 696e 7578 2028 6c65 64-bit Linux (le │ │ │ │ +0003e150: 6761 6379 2070 726f 746f 636f 6c29 2020 gacy protocol) │ │ │ │ +0003e160: 2020 2020 206e 6f20 2831 2920 2020 2020 no (1) │ │ │ │ +0003e170: 2020 2020 2020 6e6f 2028 3129 0a33 322d no (1).32- │ │ │ │ +0003e180: 6269 7420 4c69 6e75 7820 286d 6f64 6572 bit Linux (moder │ │ │ │ +0003e190: 6e20 7072 6f74 6f63 6f6c 2920 2020 2020 n protocol) │ │ │ │ +0003e1a0: 2020 7965 7320 2020 2020 2020 2020 2020 yes │ │ │ │ +0003e1b0: 2020 2079 6573 0a36 342d 6269 7420 4c69 yes.64-bit Li │ │ │ │ +0003e1c0: 6e75 7820 286d 6f64 6572 6e20 7072 6f74 nux (modern prot │ │ │ │ +0003e1d0: 6f63 6f6c 2920 2020 2020 2020 7965 7320 ocol) yes │ │ │ │ +0003e1e0: 2020 2020 2020 2020 2020 2020 2079 6573 yes │ │ │ │ +0003e1f0: 0a33 322d 6269 7420 584e 5520 2020 2020 .32-bit XNU │ │ │ │ 0003e200: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -0003e210: 2020 3f20 2020 2020 2020 2020 2020 2020 ? │ │ │ │ -0003e220: 2020 203f 0a36 342d 6269 7420 584e 5520 ?.64-bit XNU │ │ │ │ -0003e230: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -0003e240: 2020 2020 2020 2020 2020 3f20 2020 2020 ? │ │ │ │ -0003e250: 2020 2020 2020 2020 2020 203f 0a33 322d ?.32- │ │ │ │ -0003e260: 6269 7420 4546 4920 6368 6169 6e6c 6f61 bit EFI chainloa │ │ │ │ -0003e270: 6465 7220 2020 2020 2020 2020 2020 2020 der │ │ │ │ -0003e280: 2020 6e6f 2028 3229 2020 2020 2020 2020 no (2) │ │ │ │ -0003e290: 2020 206e 6f20 2832 290a 3634 2d62 6974 no (2).64-bit │ │ │ │ -0003e2a0: 2045 4649 2063 6861 696e 6c6f 6164 6572 EFI chainloader │ │ │ │ -0003e2b0: 2020 2020 2020 2020 2020 2020 2020 206e n │ │ │ │ -0003e2c0: 6f20 2832 2920 2020 2020 2020 2020 2020 o (2) │ │ │ │ -0003e2d0: 6e6f 2028 3229 0a41 7070 6c65 6c6f 6164 no (2).Appleload │ │ │ │ -0003e2e0: 6572 2020 2020 2020 2020 2020 2020 2020 er │ │ │ │ -0003e2f0: 2020 2020 2020 2020 2020 2020 6e6f 2028 no ( │ │ │ │ -0003e300: 3229 2020 2020 2020 2020 2020 206e 6f20 2) no │ │ │ │ -0003e310: 2832 290a 0a20 2020 2020 2020 2020 2020 (2).. │ │ │ │ +0003e210: 2020 2020 2020 3f20 2020 2020 2020 2020 ? │ │ │ │ +0003e220: 2020 2020 2020 203f 0a36 342d 6269 7420 ?.64-bit │ │ │ │ +0003e230: 584e 5520 2020 2020 2020 2020 2020 2020 XNU │ │ │ │ +0003e240: 2020 2020 2020 2020 2020 2020 2020 3f20 ? │ │ │ │ +0003e250: 2020 2020 2020 2020 2020 2020 2020 203f ? │ │ │ │ +0003e260: 0a33 322d 6269 7420 4546 4920 6368 6169 .32-bit EFI chai │ │ │ │ +0003e270: 6e6c 6f61 6465 7220 2020 2020 2020 2020 nloader │ │ │ │ +0003e280: 2020 2020 2020 6e6f 2028 3229 2020 2020 no (2) │ │ │ │ +0003e290: 2020 2020 2020 206e 6f20 2832 290a 3634 no (2).64 │ │ │ │ +0003e2a0: 2d62 6974 2045 4649 2063 6861 696e 6c6f -bit EFI chainlo │ │ │ │ +0003e2b0: 6164 6572 2020 2020 2020 2020 2020 2020 ader │ │ │ │ +0003e2c0: 2020 206e 6f20 2832 2920 2020 2020 2020 no (2) │ │ │ │ +0003e2d0: 2020 2020 6e6f 2028 3229 0a41 7070 6c65 no (2).Apple │ │ │ │ +0003e2e0: 6c6f 6164 6572 2020 2020 2020 2020 2020 loader │ │ │ │ +0003e2f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +0003e300: 6e6f 2028 3229 2020 2020 2020 2020 2020 no (2) │ │ │ │ +0003e310: 206e 6f20 2832 290a 0a20 2020 2020 2020 no (2).. │ │ │ │ 0003e320: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -0003e330: 2020 2020 2020 2020 2020 6961 3332 2045 ia32 E │ │ │ │ -0003e340: 4649 2020 2020 2020 2020 2061 6d64 3634 FI amd64 │ │ │ │ -0003e350: 2045 4649 0a42 494f 5320 6368 6169 6e6c EFI.BIOS chainl │ │ │ │ -0003e360: 6f61 6469 6e67 2020 2020 2020 2020 2020 oading │ │ │ │ -0003e370: 2020 2020 2020 2020 2020 6e6f 2028 3129 no (1) │ │ │ │ -0003e380: 2020 2020 2020 2020 2020 206e 6f20 2831 no (1 │ │ │ │ -0003e390: 290a 4e54 4c44 5220 2020 2020 2020 2020 ).NTLDR │ │ │ │ +0003e330: 2020 2020 2020 2020 2020 2020 2020 6961 ia │ │ │ │ +0003e340: 3332 2045 4649 2020 2020 2020 2020 2061 32 EFI a │ │ │ │ +0003e350: 6d64 3634 2045 4649 0a42 494f 5320 6368 md64 EFI.BIOS ch │ │ │ │ +0003e360: 6169 6e6c 6f61 6469 6e67 2020 2020 2020 ainloading │ │ │ │ +0003e370: 2020 2020 2020 2020 2020 2020 2020 6e6f no │ │ │ │ +0003e380: 2028 3129 2020 2020 2020 2020 2020 206e (1) n │ │ │ │ +0003e390: 6f20 2831 290a 4e54 4c44 5220 2020 2020 o (1).NTLDR │ │ │ │ 0003e3a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -0003e3b0: 2020 2020 2020 206e 6f20 2831 2920 2020 no (1) │ │ │ │ -0003e3c0: 2020 2020 2020 2020 6e6f 2028 3129 0a50 no (1).P │ │ │ │ -0003e3d0: 6c61 6e39 2020 2020 2020 2020 2020 2020 lan9 │ │ │ │ +0003e3b0: 2020 2020 2020 2020 2020 206e 6f20 2831 no (1 │ │ │ │ +0003e3c0: 2920 2020 2020 2020 2020 2020 6e6f 2028 ) no ( │ │ │ │ +0003e3d0: 3129 0a50 6c61 6e39 2020 2020 2020 2020 1).Plan9 │ │ │ │ 0003e3e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -0003e3f0: 2020 2020 6e6f 2028 3129 2020 2020 2020 no (1) │ │ │ │ -0003e400: 2020 2020 206e 6f20 2831 290a 4672 6565 no (1).Free │ │ │ │ -0003e410: 444f 5320 2020 2020 2020 2020 2020 2020 DOS │ │ │ │ +0003e3f0: 2020 2020 2020 2020 6e6f 2028 3129 2020 no (1) │ │ │ │ +0003e400: 2020 2020 2020 2020 206e 6f20 2831 290a no (1). │ │ │ │ +0003e410: 4672 6565 444f 5320 2020 2020 2020 2020 FreeDOS │ │ │ │ 0003e420: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -0003e430: 206e 6f20 2831 2920 2020 2020 2020 2020 no (1) │ │ │ │ -0003e440: 2020 6e6f 2028 3129 0a46 7265 6542 5344 no (1).FreeBSD │ │ │ │ -0003e450: 2062 6f6f 746c 6f61 6465 7220 2020 2020 bootloader │ │ │ │ -0003e460: 2020 2020 2020 2020 2020 2020 2020 6372 cr │ │ │ │ -0003e470: 6173 6865 7320 2831 2920 2020 2020 2063 ashes (1) c │ │ │ │ -0003e480: 7261 7368 6573 2028 3129 0a33 322d 6269 rashes (1).32-bi │ │ │ │ -0003e490: 7420 6b46 7265 6542 5344 2020 2020 2020 t kFreeBSD │ │ │ │ +0003e430: 2020 2020 206e 6f20 2831 2920 2020 2020 no (1) │ │ │ │ +0003e440: 2020 2020 2020 6e6f 2028 3129 0a46 7265 no (1).Fre │ │ │ │ +0003e450: 6542 5344 2062 6f6f 746c 6f61 6465 7220 eBSD bootloader │ │ │ │ +0003e460: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +0003e470: 2020 6372 6173 6865 7320 2831 2920 2020 crashes (1) │ │ │ │ +0003e480: 2020 2063 7261 7368 6573 2028 3129 0a33 crashes (1).3 │ │ │ │ +0003e490: 322d 6269 7420 6b46 7265 6542 5344 2020 2-bit kFreeBSD │ │ │ │ 0003e4a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -0003e4b0: 6865 6164 6c65 7373 2020 2020 2020 2020 headless │ │ │ │ -0003e4c0: 2068 6561 646c 6573 730a 3634 2d62 6974 headless.64-bit │ │ │ │ -0003e4d0: 206b 4672 6565 4253 4420 2020 2020 2020 kFreeBSD │ │ │ │ -0003e4e0: 2020 2020 2020 2020 2020 2020 2020 2068 h │ │ │ │ -0003e4f0: 6561 646c 6573 7320 2020 2020 2020 2020 eadless │ │ │ │ -0003e500: 6865 6164 6c65 7373 0a33 322d 6269 7420 headless.32-bit │ │ │ │ -0003e510: 6b4e 6574 4253 4420 2020 2020 2020 2020 kNetBSD │ │ │ │ -0003e520: 2020 2020 2020 2020 2020 2020 2020 6372 cr │ │ │ │ -0003e530: 6173 6865 7320 2831 2920 2020 2020 2063 ashes (1) c │ │ │ │ -0003e540: 7261 7368 6573 2028 3129 0a36 342d 6269 rashes (1).64-bi │ │ │ │ -0003e550: 7420 6b4e 6574 4253 4420 2020 2020 2020 t kNetBSD │ │ │ │ +0003e4b0: 2020 2020 6865 6164 6c65 7373 2020 2020 headless │ │ │ │ +0003e4c0: 2020 2020 2068 6561 646c 6573 730a 3634 headless.64 │ │ │ │ +0003e4d0: 2d62 6974 206b 4672 6565 4253 4420 2020 -bit kFreeBSD │ │ │ │ +0003e4e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +0003e4f0: 2020 2068 6561 646c 6573 7320 2020 2020 headless │ │ │ │ +0003e500: 2020 2020 6865 6164 6c65 7373 0a33 322d headless.32- │ │ │ │ +0003e510: 6269 7420 6b4e 6574 4253 4420 2020 2020 bit kNetBSD │ │ │ │ +0003e520: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +0003e530: 2020 6372 6173 6865 7320 2831 2920 2020 crashes (1) │ │ │ │ +0003e540: 2020 2063 7261 7368 6573 2028 3129 0a36 crashes (1).6 │ │ │ │ +0003e550: 342d 6269 7420 6b4e 6574 4253 4420 2020 4-bit kNetBSD │ │ │ │ 0003e560: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -0003e570: 7965 7320 2020 2020 2020 2020 2020 2020 yes │ │ │ │ -0003e580: 2079 6573 0a33 322d 6269 7420 6b4f 7065 yes.32-bit kOpe │ │ │ │ -0003e590: 6e42 5344 2020 2020 2020 2020 2020 2020 nBSD │ │ │ │ -0003e5a0: 2020 2020 2020 2020 2020 6865 6164 6c65 headle │ │ │ │ -0003e5b0: 7373 2020 2020 2020 2020 2068 6561 646c ss headl │ │ │ │ -0003e5c0: 6573 730a 3634 2d62 6974 206b 4f70 656e ess.64-bit kOpen │ │ │ │ -0003e5d0: 4253 4420 2020 2020 2020 2020 2020 2020 BSD │ │ │ │ -0003e5e0: 2020 2020 2020 2020 2068 6561 646c 6573 headles │ │ │ │ -0003e5f0: 7320 2020 2020 2020 2020 6865 6164 6c65 s headle │ │ │ │ -0003e600: 7373 0a4d 756c 7469 626f 6f74 2020 2020 ss.Multiboot │ │ │ │ +0003e570: 2020 2020 7965 7320 2020 2020 2020 2020 yes │ │ │ │ +0003e580: 2020 2020 2079 6573 0a33 322d 6269 7420 yes.32-bit │ │ │ │ +0003e590: 6b4f 7065 6e42 5344 2020 2020 2020 2020 kOpenBSD │ │ │ │ +0003e5a0: 2020 2020 2020 2020 2020 2020 2020 6865 he │ │ │ │ +0003e5b0: 6164 6c65 7373 2020 2020 2020 2020 2068 adless h │ │ │ │ +0003e5c0: 6561 646c 6573 730a 3634 2d62 6974 206b eadless.64-bit k │ │ │ │ +0003e5d0: 4f70 656e 4253 4420 2020 2020 2020 2020 OpenBSD │ │ │ │ +0003e5e0: 2020 2020 2020 2020 2020 2020 2068 6561 hea │ │ │ │ +0003e5f0: 646c 6573 7320 2020 2020 2020 2020 6865 dless he │ │ │ │ +0003e600: 6164 6c65 7373 0a4d 756c 7469 626f 6f74 adless.Multiboot │ │ │ │ 0003e610: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -0003e620: 2020 2020 2020 2020 7965 7320 2020 2020 yes │ │ │ │ -0003e630: 2020 2020 2020 2020 2079 6573 0a4d 756c yes.Mul │ │ │ │ -0003e640: 7469 626f 6f74 3220 2020 2020 2020 2020 tiboot2 │ │ │ │ +0003e620: 2020 2020 2020 2020 2020 2020 7965 7320 yes │ │ │ │ +0003e630: 2020 2020 2020 2020 2020 2020 2079 6573 yes │ │ │ │ +0003e640: 0a4d 756c 7469 626f 6f74 3220 2020 2020 .Multiboot2 │ │ │ │ 0003e650: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -0003e660: 2020 7965 7320 2020 2020 2020 2020 2020 yes │ │ │ │ -0003e670: 2020 2079 6573 0a33 322d 6269 7420 4c69 yes.32-bit Li │ │ │ │ -0003e680: 6e75 7820 286c 6567 6163 7920 7072 6f74 nux (legacy prot │ │ │ │ -0003e690: 6f63 6f6c 2920 2020 2020 2020 6e6f 2028 ocol) no ( │ │ │ │ -0003e6a0: 3129 2020 2020 2020 2020 2020 206e 6f20 1) no │ │ │ │ -0003e6b0: 2831 290a 3634 2d62 6974 204c 696e 7578 (1).64-bit Linux │ │ │ │ -0003e6c0: 2028 6c65 6761 6379 2070 726f 746f 636f (legacy protoco │ │ │ │ -0003e6d0: 6c29 2020 2020 2020 206e 6f20 2831 2920 l) no (1) │ │ │ │ -0003e6e0: 2020 2020 2020 2020 2020 6e6f 2028 3129 no (1) │ │ │ │ -0003e6f0: 0a33 322d 6269 7420 4c69 6e75 7820 286d .32-bit Linux (m │ │ │ │ -0003e700: 6f64 6572 6e20 7072 6f74 6f63 6f6c 2920 odern protocol) │ │ │ │ -0003e710: 2020 2020 2020 7965 7320 2020 2020 2020 yes │ │ │ │ -0003e720: 2020 2020 2020 2079 6573 0a36 342d 6269 yes.64-bi │ │ │ │ -0003e730: 7420 4c69 6e75 7820 286d 6f64 6572 6e20 t Linux (modern │ │ │ │ -0003e740: 7072 6f74 6f63 6f6c 2920 2020 2020 2020 protocol) │ │ │ │ -0003e750: 7965 7320 2020 2020 2020 2020 2020 2020 yes │ │ │ │ -0003e760: 2079 6573 0a33 322d 6269 7420 584e 5520 yes.32-bit XNU │ │ │ │ -0003e770: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -0003e780: 2020 2020 2020 2020 2020 7965 7320 2020 yes │ │ │ │ -0003e790: 2020 2020 2020 2020 2020 2079 6573 0a36 yes.6 │ │ │ │ -0003e7a0: 342d 6269 7420 584e 5520 2020 2020 2020 4-bit XNU │ │ │ │ +0003e660: 2020 2020 2020 7965 7320 2020 2020 2020 yes │ │ │ │ +0003e670: 2020 2020 2020 2079 6573 0a33 322d 6269 yes.32-bi │ │ │ │ +0003e680: 7420 4c69 6e75 7820 286c 6567 6163 7920 t Linux (legacy │ │ │ │ +0003e690: 7072 6f74 6f63 6f6c 2920 2020 2020 2020 protocol) │ │ │ │ +0003e6a0: 6e6f 2028 3129 2020 2020 2020 2020 2020 no (1) │ │ │ │ +0003e6b0: 206e 6f20 2831 290a 3634 2d62 6974 204c no (1).64-bit L │ │ │ │ +0003e6c0: 696e 7578 2028 6c65 6761 6379 2070 726f inux (legacy pro │ │ │ │ +0003e6d0: 746f 636f 6c29 2020 2020 2020 206e 6f20 tocol) no │ │ │ │ +0003e6e0: 2831 2920 2020 2020 2020 2020 2020 6e6f (1) no │ │ │ │ +0003e6f0: 2028 3129 0a33 322d 6269 7420 4c69 6e75 (1).32-bit Linu │ │ │ │ +0003e700: 7820 286d 6f64 6572 6e20 7072 6f74 6f63 x (modern protoc │ │ │ │ +0003e710: 6f6c 2920 2020 2020 2020 7965 7320 2020 ol) yes │ │ │ │ +0003e720: 2020 2020 2020 2020 2020 2079 6573 0a36 yes.6 │ │ │ │ +0003e730: 342d 6269 7420 4c69 6e75 7820 286d 6f64 4-bit Linux (mod │ │ │ │ +0003e740: 6572 6e20 7072 6f74 6f63 6f6c 2920 2020 ern protocol) │ │ │ │ +0003e750: 2020 2020 7965 7320 2020 2020 2020 2020 yes │ │ │ │ +0003e760: 2020 2020 2079 6573 0a33 322d 6269 7420 yes.32-bit │ │ │ │ +0003e770: 584e 5520 2020 2020 2020 2020 2020 2020 XNU │ │ │ │ +0003e780: 2020 2020 2020 2020 2020 2020 2020 7965 ye │ │ │ │ +0003e790: 7320 2020 2020 2020 2020 2020 2020 2079 s y │ │ │ │ +0003e7a0: 6573 0a36 342d 6269 7420 584e 5520 2020 es.64-bit XNU │ │ │ │ 0003e7b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -0003e7c0: 2020 2020 7965 7320 2834 2920 2020 2020 yes (4) │ │ │ │ -0003e7d0: 2020 2020 2079 6573 0a33 322d 6269 7420 yes.32-bit │ │ │ │ -0003e7e0: 4546 4920 6368 6169 6e6c 6f61 6465 7220 EFI chainloader │ │ │ │ -0003e7f0: 2020 2020 2020 2020 2020 2020 2020 7965 ye │ │ │ │ -0003e800: 7320 2020 2020 2020 2020 2020 2020 206e s n │ │ │ │ -0003e810: 6f20 2833 290a 3634 2d62 6974 2045 4649 o (3).64-bit EFI │ │ │ │ -0003e820: 2063 6861 696e 6c6f 6164 6572 2020 2020 chainloader │ │ │ │ -0003e830: 2020 2020 2020 2020 2020 206e 6f20 2833 no (3 │ │ │ │ -0003e840: 2920 2020 2020 2020 2020 2020 7965 730a ) yes. │ │ │ │ -0003e850: 4170 706c 656c 6f61 6465 7220 2020 2020 Appleloader │ │ │ │ +0003e7c0: 2020 2020 2020 2020 7965 7320 2834 2920 yes (4) │ │ │ │ +0003e7d0: 2020 2020 2020 2020 2079 6573 0a33 322d yes.32- │ │ │ │ +0003e7e0: 6269 7420 4546 4920 6368 6169 6e6c 6f61 bit EFI chainloa │ │ │ │ +0003e7f0: 6465 7220 2020 2020 2020 2020 2020 2020 der │ │ │ │ +0003e800: 2020 7965 7320 2020 2020 2020 2020 2020 yes │ │ │ │ +0003e810: 2020 206e 6f20 2833 290a 3634 2d62 6974 no (3).64-bit │ │ │ │ +0003e820: 2045 4649 2063 6861 696e 6c6f 6164 6572 EFI chainloader │ │ │ │ +0003e830: 2020 2020 2020 2020 2020 2020 2020 206e n │ │ │ │ +0003e840: 6f20 2833 2920 2020 2020 2020 2020 2020 o (3) │ │ │ │ +0003e850: 7965 730a 4170 706c 656c 6f61 6465 7220 yes.Appleloader │ │ │ │ 0003e860: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -0003e870: 2020 2020 2079 6573 2020 2020 2020 2020 yes │ │ │ │ -0003e880: 2020 2020 2020 7965 730a 0a20 2020 2020 yes.. │ │ │ │ +0003e870: 2020 2020 2020 2020 2079 6573 2020 2020 yes │ │ │ │ +0003e880: 2020 2020 2020 2020 2020 7965 730a 0a20 yes.. │ │ │ │ 0003e890: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ 0003e8a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -0003e8b0: 6961 3332 2049 4545 4531 3237 350a 4249 ia32 IEEE1275.BI │ │ │ │ -0003e8c0: 4f53 2063 6861 696e 6c6f 6164 696e 6720 OS chainloading │ │ │ │ -0003e8d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -0003e8e0: 2020 206e 6f20 2831 290a 4e54 4c44 5220 no (1).NTLDR │ │ │ │ -0003e8f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -0003e900: 2020 2020 2020 2020 2020 2020 2020 206e n │ │ │ │ -0003e910: 6f20 2831 290a 506c 616e 3920 2020 2020 o (1).Plan9 │ │ │ │ +0003e8b0: 2020 2020 6961 3332 2049 4545 4531 3237 ia32 IEEE127 │ │ │ │ +0003e8c0: 350a 4249 4f53 2063 6861 696e 6c6f 6164 5.BIOS chainload │ │ │ │ +0003e8d0: 696e 6720 2020 2020 2020 2020 2020 2020 ing │ │ │ │ +0003e8e0: 2020 2020 2020 206e 6f20 2831 290a 4e54 no (1).NT │ │ │ │ +0003e8f0: 4c44 5220 2020 2020 2020 2020 2020 2020 LDR │ │ │ │ +0003e900: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +0003e910: 2020 206e 6f20 2831 290a 506c 616e 3920 no (1).Plan9 │ │ │ │ 0003e920: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -0003e930: 2020 2020 2020 2020 2020 206e 6f20 2831 no (1 │ │ │ │ -0003e940: 290a 4672 6565 444f 5320 2020 2020 2020 ).FreeDOS │ │ │ │ +0003e930: 2020 2020 2020 2020 2020 2020 2020 206e n │ │ │ │ +0003e940: 6f20 2831 290a 4672 6565 444f 5320 2020 o (1).FreeDOS │ │ │ │ 0003e950: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -0003e960: 2020 2020 2020 206e 6f20 2831 290a 4672 no (1).Fr │ │ │ │ -0003e970: 6565 4253 4420 626f 6f74 6c6f 6164 6572 eeBSD bootloader │ │ │ │ -0003e980: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -0003e990: 2020 2063 7261 7368 6573 2028 3129 0a33 crashes (1).3 │ │ │ │ -0003e9a0: 322d 6269 7420 6b46 7265 6542 5344 2020 2-bit kFreeBSD │ │ │ │ -0003e9b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -0003e9c0: 2020 2020 6372 6173 6865 7320 2835 290a crashes (5). │ │ │ │ -0003e9d0: 3634 2d62 6974 206b 4672 6565 4253 4420 64-bit kFreeBSD │ │ │ │ -0003e9e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -0003e9f0: 2020 2020 2063 7261 7368 6573 2028 3529 crashes (5) │ │ │ │ -0003ea00: 0a33 322d 6269 7420 6b4e 6574 4253 4420 .32-bit kNetBSD │ │ │ │ -0003ea10: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -0003ea20: 2020 2020 2020 6372 6173 6865 7320 2831 crashes (1 │ │ │ │ -0003ea30: 290a 3634 2d62 6974 206b 4e65 7442 5344 ).64-bit kNetBSD │ │ │ │ -0003ea40: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -0003ea50: 2020 2020 2020 203f 0a33 322d 6269 7420 ?.32-bit │ │ │ │ -0003ea60: 6b4f 7065 6e42 5344 2020 2020 2020 2020 kOpenBSD │ │ │ │ -0003ea70: 2020 2020 2020 2020 2020 2020 2020 3f0a ?. │ │ │ │ -0003ea80: 3634 2d62 6974 206b 4f70 656e 4253 4420 64-bit kOpenBSD │ │ │ │ -0003ea90: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -0003eaa0: 2020 2020 203f 0a4d 756c 7469 626f 6f74 ?.Multiboot │ │ │ │ -0003eab0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -0003eac0: 2020 2020 2020 2020 2020 2020 3f0a 4d75 ?.Mu │ │ │ │ -0003ead0: 6c74 6962 6f6f 7432 2020 2020 2020 2020 ltiboot2 │ │ │ │ +0003e960: 2020 2020 2020 2020 2020 206e 6f20 2831 no (1 │ │ │ │ +0003e970: 290a 4672 6565 4253 4420 626f 6f74 6c6f ).FreeBSD bootlo │ │ │ │ +0003e980: 6164 6572 2020 2020 2020 2020 2020 2020 ader │ │ │ │ +0003e990: 2020 2020 2020 2063 7261 7368 6573 2028 crashes ( │ │ │ │ +0003e9a0: 3129 0a33 322d 6269 7420 6b46 7265 6542 1).32-bit kFreeB │ │ │ │ +0003e9b0: 5344 2020 2020 2020 2020 2020 2020 2020 SD │ │ │ │ +0003e9c0: 2020 2020 2020 2020 6372 6173 6865 7320 crashes │ │ │ │ +0003e9d0: 2835 290a 3634 2d62 6974 206b 4672 6565 (5).64-bit kFree │ │ │ │ +0003e9e0: 4253 4420 2020 2020 2020 2020 2020 2020 BSD │ │ │ │ +0003e9f0: 2020 2020 2020 2020 2063 7261 7368 6573 crashes │ │ │ │ +0003ea00: 2028 3529 0a33 322d 6269 7420 6b4e 6574 (5).32-bit kNet │ │ │ │ +0003ea10: 4253 4420 2020 2020 2020 2020 2020 2020 BSD │ │ │ │ +0003ea20: 2020 2020 2020 2020 2020 6372 6173 6865 crashe │ │ │ │ +0003ea30: 7320 2831 290a 3634 2d62 6974 206b 4e65 s (1).64-bit kNe │ │ │ │ +0003ea40: 7442 5344 2020 2020 2020 2020 2020 2020 tBSD │ │ │ │ +0003ea50: 2020 2020 2020 2020 2020 203f 0a33 322d ?.32- │ │ │ │ +0003ea60: 6269 7420 6b4f 7065 6e42 5344 2020 2020 bit kOpenBSD │ │ │ │ +0003ea70: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +0003ea80: 2020 3f0a 3634 2d62 6974 206b 4f70 656e ?.64-bit kOpen │ │ │ │ +0003ea90: 4253 4420 2020 2020 2020 2020 2020 2020 BSD │ │ │ │ +0003eaa0: 2020 2020 2020 2020 203f 0a4d 756c 7469 ?.Multi │ │ │ │ +0003eab0: 626f 6f74 2020 2020 2020 2020 2020 2020 boot │ │ │ │ +0003eac0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +0003ead0: 3f0a 4d75 6c74 6962 6f6f 7432 2020 2020 ?.Multiboot2 │ │ │ │ 0003eae0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -0003eaf0: 2020 203f 0a33 322d 6269 7420 4c69 6e75 ?.32-bit Linu │ │ │ │ -0003eb00: 7820 286c 6567 6163 7920 7072 6f74 6f63 x (legacy protoc │ │ │ │ -0003eb10: 6f6c 2920 2020 2020 2020 6e6f 2028 3129 ol) no (1) │ │ │ │ -0003eb20: 0a36 342d 6269 7420 4c69 6e75 7820 286c .64-bit Linux (l │ │ │ │ -0003eb30: 6567 6163 7920 7072 6f74 6f63 6f6c 2920 egacy protocol) │ │ │ │ -0003eb40: 2020 2020 2020 6e6f 2028 3129 0a33 322d no (1).32- │ │ │ │ -0003eb50: 6269 7420 4c69 6e75 7820 286d 6f64 6572 bit Linux (moder │ │ │ │ -0003eb60: 6e20 7072 6f74 6f63 6f6c 2920 2020 2020 n protocol) │ │ │ │ -0003eb70: 2020 3f0a 3634 2d62 6974 204c 696e 7578 ?.64-bit Linux │ │ │ │ -0003eb80: 2028 6d6f 6465 726e 2070 726f 746f 636f (modern protoco │ │ │ │ -0003eb90: 6c29 2020 2020 2020 203f 0a33 322d 6269 l) ?.32-bi │ │ │ │ -0003eba0: 7420 584e 5520 2020 2020 2020 2020 2020 t XNU │ │ │ │ +0003eaf0: 2020 2020 2020 203f 0a33 322d 6269 7420 ?.32-bit │ │ │ │ +0003eb00: 4c69 6e75 7820 286c 6567 6163 7920 7072 Linux (legacy pr │ │ │ │ +0003eb10: 6f74 6f63 6f6c 2920 2020 2020 2020 6e6f otocol) no │ │ │ │ +0003eb20: 2028 3129 0a36 342d 6269 7420 4c69 6e75 (1).64-bit Linu │ │ │ │ +0003eb30: 7820 286c 6567 6163 7920 7072 6f74 6f63 x (legacy protoc │ │ │ │ +0003eb40: 6f6c 2920 2020 2020 2020 6e6f 2028 3129 ol) no (1) │ │ │ │ +0003eb50: 0a33 322d 6269 7420 4c69 6e75 7820 286d .32-bit Linux (m │ │ │ │ +0003eb60: 6f64 6572 6e20 7072 6f74 6f63 6f6c 2920 odern protocol) │ │ │ │ +0003eb70: 2020 2020 2020 3f0a 3634 2d62 6974 204c ?.64-bit L │ │ │ │ +0003eb80: 696e 7578 2028 6d6f 6465 726e 2070 726f inux (modern pro │ │ │ │ +0003eb90: 746f 636f 6c29 2020 2020 2020 203f 0a33 tocol) ?.3 │ │ │ │ +0003eba0: 322d 6269 7420 584e 5520 2020 2020 2020 2-bit XNU │ │ │ │ 0003ebb0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -0003ebc0: 3f0a 3634 2d62 6974 2058 4e55 2020 2020 ?.64-bit XNU │ │ │ │ +0003ebc0: 2020 2020 3f0a 3634 2d62 6974 2058 4e55 ?.64-bit XNU │ │ │ │ 0003ebd0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -0003ebe0: 2020 2020 2020 203f 0a33 322d 6269 7420 ?.32-bit │ │ │ │ -0003ebf0: 4546 4920 6368 6169 6e6c 6f61 6465 7220 EFI chainloader │ │ │ │ -0003ec00: 2020 2020 2020 2020 2020 2020 2020 6e6f no │ │ │ │ -0003ec10: 2028 3229 0a36 342d 6269 7420 4546 4920 (2).64-bit EFI │ │ │ │ -0003ec20: 6368 6169 6e6c 6f61 6465 7220 2020 2020 chainloader │ │ │ │ -0003ec30: 2020 2020 2020 2020 2020 6e6f 2028 3229 no (2) │ │ │ │ -0003ec40: 0a41 7070 6c65 6c6f 6164 6572 2020 2020 .Appleloader │ │ │ │ +0003ebe0: 2020 2020 2020 2020 2020 203f 0a33 322d ?.32- │ │ │ │ +0003ebf0: 6269 7420 4546 4920 6368 6169 6e6c 6f61 bit EFI chainloa │ │ │ │ +0003ec00: 6465 7220 2020 2020 2020 2020 2020 2020 der │ │ │ │ +0003ec10: 2020 6e6f 2028 3229 0a36 342d 6269 7420 no (2).64-bit │ │ │ │ +0003ec20: 4546 4920 6368 6169 6e6c 6f61 6465 7220 EFI chainloader │ │ │ │ +0003ec30: 2020 2020 2020 2020 2020 2020 2020 6e6f no │ │ │ │ +0003ec40: 2028 3229 0a41 7070 6c65 6c6f 6164 6572 (2).Appleloader │ │ │ │ 0003ec50: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -0003ec60: 2020 2020 2020 6e6f 2028 3229 0a0a 2020 no (2).. │ │ │ │ -0003ec70: 312e 2052 6571 7569 7265 7320 4249 4f53 1. Requires BIOS │ │ │ │ -0003ec80: 0a20 2032 2e20 4546 4920 6f6e 6c79 0a20 . 2. EFI only. │ │ │ │ -0003ec90: 2033 2e20 3332 2d62 6974 2061 6e64 2036 3. 32-bit and 6 │ │ │ │ -0003eca0: 342d 6269 7420 4546 4920 6861 7665 2064 4-bit EFI have d │ │ │ │ -0003ecb0: 6966 6665 7265 6e74 2073 7472 7563 7475 ifferent structu │ │ │ │ -0003ecc0: 7265 7320 616e 6420 776f 726b 2069 6e0a res and work in. │ │ │ │ -0003ecd0: 2020 2020 2064 6966 6665 7265 6e74 2043 different C │ │ │ │ -0003ece0: 5055 206d 6f64 6573 2073 6f20 6974 2773 PU modes so it's │ │ │ │ -0003ecf0: 206e 6f74 2070 6f73 7369 626c 6520 746f not possible to │ │ │ │ -0003ed00: 2063 6861 696e 6c6f 6164 2033 322d 6269 chainload 32-bi │ │ │ │ -0003ed10: 740a 2020 2020 2062 6f6f 746c 6f61 6465 t. bootloade │ │ │ │ -0003ed20: 7220 6f6e 2036 342d 6269 7420 706c 6174 r on 64-bit plat │ │ │ │ -0003ed30: 666f 726d 2061 6e64 2076 6963 652d 7665 form and vice-ve │ │ │ │ -0003ed40: 7273 610a 2020 342e 2053 6f6d 6520 6d6f rsa. 4. Some mo │ │ │ │ -0003ed50: 6475 6c65 7320 6d61 7920 6e65 6564 2074 dules may need t │ │ │ │ -0003ed60: 6f20 6265 2064 6973 6162 6c65 640a 2020 o be disabled. │ │ │ │ -0003ed70: 352e 2052 6571 7569 7265 7320 4143 5049 5. Requires ACPI │ │ │ │ -0003ed80: 0a0a 2020 2050 6f77 6572 5043 2c20 4941 .. PowerPC, IA │ │ │ │ -0003ed90: 3634 2061 6e64 2053 7061 7263 3634 2070 64 and Sparc64 p │ │ │ │ -0003eda0: 6f72 7473 2073 7570 706f 7274 206f 6e6c orts support onl │ │ │ │ -0003edb0: 7920 4c69 6e75 782e 2020 4d49 5053 2070 y Linux. MIPS p │ │ │ │ -0003edc0: 6f72 740a 7375 7070 6f72 7473 204c 696e ort.supports Lin │ │ │ │ -0003edd0: 7578 2061 6e64 206d 756c 7469 626f 6f74 ux and multiboot │ │ │ │ -0003ede0: 322e 0a0a 3231 2e31 2042 6f6f 7420 7465 2...21.1 Boot te │ │ │ │ -0003edf0: 7374 730a 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d sts.============ │ │ │ │ -0003ee00: 3d3d 3d0a 0a41 7320 796f 7520 6861 7665 ===..As you have │ │ │ │ -0003ee10: 2073 6565 6e20 696e 2070 7265 7669 6f75 seen in previou │ │ │ │ -0003ee20: 7320 6368 6170 7465 7220 7468 6520 7375 s chapter the su │ │ │ │ -0003ee30: 7070 6f72 7420 6d61 7472 6978 2069 7320 pport matrix is │ │ │ │ -0003ee40: 7072 6574 7479 2062 6967 0a61 6e64 2073 pretty big.and s │ │ │ │ -0003ee50: 6f6d 6520 6f66 2074 6865 2063 6f6e 6669 ome of the confi │ │ │ │ -0003ee60: 6775 7261 7469 6f6e 7320 6172 6520 6f6e gurations are on │ │ │ │ -0003ee70: 6c79 2072 6172 656c 7920 7573 6564 2e20 ly rarely used. │ │ │ │ -0003ee80: 2054 6f20 656e 7375 7265 2074 6865 0a71 To ensure the.q │ │ │ │ -0003ee90: 7561 6c69 7479 2062 6f6f 7463 6865 636b uality bootcheck │ │ │ │ -0003eea0: 7320 6172 6520 6176 6169 6c61 626c 6520 s are available │ │ │ │ -0003eeb0: 666f 7220 616c 6c20 7838 3620 7461 7267 for all x86 targ │ │ │ │ -0003eec0: 6574 7320 6578 6365 7074 2045 4649 0a63 ets except EFI.c │ │ │ │ -0003eed0: 6861 696e 6c6f 6164 6572 2c20 4170 706c hainloader, Appl │ │ │ │ -0003eee0: 656c 6f61 6465 7220 616e 6420 584e 552e eloader and XNU. │ │ │ │ -0003eef0: 2041 6c6c 2078 3836 2070 6c61 7466 6f72 All x86 platfor │ │ │ │ -0003ef00: 6d73 2068 6176 6520 626f 6f74 6368 6563 ms have bootchec │ │ │ │ -0003ef10: 6b0a 6661 6369 6c69 7479 2065 7863 6570 k.facility excep │ │ │ │ -0003ef20: 7420 6965 6565 3132 3735 2e20 204d 756c t ieee1275. Mul │ │ │ │ -0003ef30: 7469 626f 6f74 2c20 6d75 6c74 6962 6f6f tiboot, multiboo │ │ │ │ -0003ef40: 7432 2c20 4249 4f53 2063 6861 696e 6c6f t2, BIOS chainlo │ │ │ │ -0003ef50: 6164 6572 2c0a 6e74 6c64 7220 616e 6420 ader,.ntldr and │ │ │ │ -0003ef60: 6672 6565 6273 642d 626f 6f74 6c6f 6164 freebsd-bootload │ │ │ │ -0003ef70: 6572 2062 6f6f 7420 7461 7267 6574 7320 er boot targets │ │ │ │ -0003ef80: 6172 6520 7465 7374 6564 206f 6e6c 7920 are tested only │ │ │ │ -0003ef90: 7769 7468 2061 2066 616b 650a 6b65 726e with a fake.kern │ │ │ │ -0003efa0: 656c 2069 6d61 6765 732e 2020 4f6e 6c79 el images. Only │ │ │ │ -0003efb0: 204c 696e 7578 2069 7320 7465 7374 6564 Linux is tested │ │ │ │ -0003efc0: 2061 6d6f 6e67 2074 6865 2070 6179 6c6f among the paylo │ │ │ │ -0003efd0: 6164 7320 7573 696e 6720 4c69 6e75 780a ads using Linux. │ │ │ │ -0003efe0: 7072 6f74 6f63 6f6c 732e 0a0a 2020 2046 protocols... F │ │ │ │ -0003eff0: 6f6c 6c6f 7769 6e67 2076 6172 6961 626c ollowing variabl │ │ │ │ -0003f000: 6573 206d 7573 7420 6265 2064 6566 696e es must be defin │ │ │ │ -0003f010: 6564 3a0a 0a47 5255 425f 5041 594c 4f41 ed:..GRUB_PAYLOA │ │ │ │ -0003f020: 4453 5f44 4952 2020 2020 2020 6469 7265 DS_DIR dire │ │ │ │ -0003f030: 6374 6f72 7920 636f 6e74 6169 6e69 6e67 ctory containing │ │ │ │ -0003f040: 2074 6865 2072 6571 7569 7265 6420 6b65 the required ke │ │ │ │ -0003f050: 726e 656c 730a 4752 5542 5f43 4246 5354 rnels.GRUB_CBFST │ │ │ │ -0003f060: 4f4f 4c20 2020 2020 2020 2020 2063 6266 OOL cbf │ │ │ │ -0003f070: 7374 6f6f 6c20 6672 6f6d 2043 6f72 6562 stool from Coreb │ │ │ │ -0003f080: 6f6f 7420 7061 636b 6167 6520 2866 6f72 oot package (for │ │ │ │ -0003f090: 2063 6f72 6562 6f6f 740a 2020 2020 2020 coreboot. │ │ │ │ +0003ec60: 2020 2020 2020 2020 2020 6e6f 2028 3229 no (2) │ │ │ │ +0003ec70: 0a0a 2020 312e 2052 6571 7569 7265 7320 .. 1. Requires │ │ │ │ +0003ec80: 4249 4f53 0a20 2032 2e20 4546 4920 6f6e BIOS. 2. EFI on │ │ │ │ +0003ec90: 6c79 0a20 2033 2e20 3332 2d62 6974 2061 ly. 3. 32-bit a │ │ │ │ +0003eca0: 6e64 2036 342d 6269 7420 4546 4920 6861 nd 64-bit EFI ha │ │ │ │ +0003ecb0: 7665 2064 6966 6665 7265 6e74 2073 7472 ve different str │ │ │ │ +0003ecc0: 7563 7475 7265 7320 616e 6420 776f 726b uctures and work │ │ │ │ +0003ecd0: 2069 6e0a 2020 2020 2064 6966 6665 7265 in. differe │ │ │ │ +0003ece0: 6e74 2043 5055 206d 6f64 6573 2073 6f20 nt CPU modes so │ │ │ │ +0003ecf0: 6974 2773 206e 6f74 2070 6f73 7369 626c it's not possibl │ │ │ │ +0003ed00: 6520 746f 2063 6861 696e 6c6f 6164 2033 e to chainload 3 │ │ │ │ +0003ed10: 322d 6269 740a 2020 2020 2062 6f6f 746c 2-bit. bootl │ │ │ │ +0003ed20: 6f61 6465 7220 6f6e 2036 342d 6269 7420 oader on 64-bit │ │ │ │ +0003ed30: 706c 6174 666f 726d 2061 6e64 2076 6963 platform and vic │ │ │ │ +0003ed40: 652d 7665 7273 610a 2020 342e 2053 6f6d e-versa. 4. Som │ │ │ │ +0003ed50: 6520 6d6f 6475 6c65 7320 6d61 7920 6e65 e modules may ne │ │ │ │ +0003ed60: 6564 2074 6f20 6265 2064 6973 6162 6c65 ed to be disable │ │ │ │ +0003ed70: 640a 2020 352e 2052 6571 7569 7265 7320 d. 5. Requires │ │ │ │ +0003ed80: 4143 5049 0a0a 2020 2050 6f77 6572 5043 ACPI.. PowerPC │ │ │ │ +0003ed90: 2c20 4941 3634 2061 6e64 2053 7061 7263 , IA64 and Sparc │ │ │ │ +0003eda0: 3634 2070 6f72 7473 2073 7570 706f 7274 64 ports support │ │ │ │ +0003edb0: 206f 6e6c 7920 4c69 6e75 782e 2020 4d49 only Linux. MI │ │ │ │ +0003edc0: 5053 2070 6f72 740a 7375 7070 6f72 7473 PS port.supports │ │ │ │ +0003edd0: 204c 696e 7578 2061 6e64 206d 756c 7469 Linux and multi │ │ │ │ +0003ede0: 626f 6f74 322e 0a0a 3231 2e31 2042 6f6f boot2...21.1 Boo │ │ │ │ +0003edf0: 7420 7465 7374 730a 3d3d 3d3d 3d3d 3d3d t tests.======== │ │ │ │ +0003ee00: 3d3d 3d3d 3d3d 3d0a 0a41 7320 796f 7520 =======..As you │ │ │ │ +0003ee10: 6861 7665 2073 6565 6e20 696e 2070 7265 have seen in pre │ │ │ │ +0003ee20: 7669 6f75 7320 6368 6170 7465 7220 7468 vious chapter th │ │ │ │ +0003ee30: 6520 7375 7070 6f72 7420 6d61 7472 6978 e support matrix │ │ │ │ +0003ee40: 2069 7320 7072 6574 7479 2062 6967 0a61 is pretty big.a │ │ │ │ +0003ee50: 6e64 2073 6f6d 6520 6f66 2074 6865 2063 nd some of the c │ │ │ │ +0003ee60: 6f6e 6669 6775 7261 7469 6f6e 7320 6172 onfigurations ar │ │ │ │ +0003ee70: 6520 6f6e 6c79 2072 6172 656c 7920 7573 e only rarely us │ │ │ │ +0003ee80: 6564 2e20 2054 6f20 656e 7375 7265 2074 ed. To ensure t │ │ │ │ +0003ee90: 6865 0a71 7561 6c69 7479 2062 6f6f 7463 he.quality bootc │ │ │ │ +0003eea0: 6865 636b 7320 6172 6520 6176 6169 6c61 hecks are availa │ │ │ │ +0003eeb0: 626c 6520 666f 7220 616c 6c20 7838 3620 ble for all x86 │ │ │ │ +0003eec0: 7461 7267 6574 7320 6578 6365 7074 2045 targets except E │ │ │ │ +0003eed0: 4649 0a63 6861 696e 6c6f 6164 6572 2c20 FI.chainloader, │ │ │ │ +0003eee0: 4170 706c 656c 6f61 6465 7220 616e 6420 Appleloader and │ │ │ │ +0003eef0: 584e 552e 2041 6c6c 2078 3836 2070 6c61 XNU. All x86 pla │ │ │ │ +0003ef00: 7466 6f72 6d73 2068 6176 6520 626f 6f74 tforms have boot │ │ │ │ +0003ef10: 6368 6563 6b0a 6661 6369 6c69 7479 2065 check.facility e │ │ │ │ +0003ef20: 7863 6570 7420 6965 6565 3132 3735 2e20 xcept ieee1275. │ │ │ │ +0003ef30: 204d 756c 7469 626f 6f74 2c20 6d75 6c74 Multiboot, mult │ │ │ │ +0003ef40: 6962 6f6f 7432 2c20 4249 4f53 2063 6861 iboot2, BIOS cha │ │ │ │ +0003ef50: 696e 6c6f 6164 6572 2c0a 6e74 6c64 7220 inloader,.ntldr │ │ │ │ +0003ef60: 616e 6420 6672 6565 6273 642d 626f 6f74 and freebsd-boot │ │ │ │ +0003ef70: 6c6f 6164 6572 2062 6f6f 7420 7461 7267 loader boot targ │ │ │ │ +0003ef80: 6574 7320 6172 6520 7465 7374 6564 206f ets are tested o │ │ │ │ +0003ef90: 6e6c 7920 7769 7468 2061 2066 616b 650a nly with a fake. │ │ │ │ +0003efa0: 6b65 726e 656c 2069 6d61 6765 732e 2020 kernel images. │ │ │ │ +0003efb0: 4f6e 6c79 204c 696e 7578 2069 7320 7465 Only Linux is te │ │ │ │ +0003efc0: 7374 6564 2061 6d6f 6e67 2074 6865 2070 sted among the p │ │ │ │ +0003efd0: 6179 6c6f 6164 7320 7573 696e 6720 4c69 ayloads using Li │ │ │ │ +0003efe0: 6e75 780a 7072 6f74 6f63 6f6c 732e 0a0a nux.protocols... │ │ │ │ +0003eff0: 2020 2046 6f6c 6c6f 7769 6e67 2076 6172 Following var │ │ │ │ +0003f000: 6961 626c 6573 206d 7573 7420 6265 2064 iables must be d │ │ │ │ +0003f010: 6566 696e 6564 3a0a 0a47 5255 425f 5041 efined:..GRUB_PA │ │ │ │ +0003f020: 594c 4f41 4453 5f44 4952 2020 2020 2020 YLOADS_DIR │ │ │ │ +0003f030: 6469 7265 6374 6f72 7920 636f 6e74 6169 directory contai │ │ │ │ +0003f040: 6e69 6e67 2074 6865 2072 6571 7569 7265 ning the require │ │ │ │ +0003f050: 6420 6b65 726e 656c 730a 4752 5542 5f43 d kernels.GRUB_C │ │ │ │ +0003f060: 4246 5354 4f4f 4c20 2020 2020 2020 2020 BFSTOOL │ │ │ │ +0003f070: 2063 6266 7374 6f6f 6c20 6672 6f6d 2043 cbfstool from C │ │ │ │ +0003f080: 6f72 6562 6f6f 7420 7061 636b 6167 6520 oreboot package │ │ │ │ +0003f090: 2866 6f72 2063 6f72 6562 6f6f 740a 2020 (for coreboot. │ │ │ │ 0003f0a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -0003f0b0: 2070 6c61 7466 6f72 6d20 6f6e 6c79 290a platform only). │ │ │ │ -0003f0c0: 4752 5542 5f43 4f52 4542 4f4f 545f 524f GRUB_COREBOOT_RO │ │ │ │ -0003f0d0: 4d20 2020 2020 2065 6d70 7479 2043 6f72 M empty Cor │ │ │ │ -0003f0e0: 6562 6f6f 7420 524f 4d0a 4752 5542 5f51 eboot ROM.GRUB_Q │ │ │ │ -0003f0f0: 454d 555f 4f50 5453 2020 2020 2020 2020 EMU_OPTS │ │ │ │ -0003f100: 2061 6464 6974 696f 6e61 6c20 6f70 7469 additional opti │ │ │ │ -0003f110: 6f6e 7320 746f 2062 6520 7375 7070 6c69 ons to be suppli │ │ │ │ -0003f120: 6564 2074 6f20 5145 4d55 0a0a 2020 2052 ed to QEMU.. R │ │ │ │ -0003f130: 6571 7569 7265 6420 6669 6c65 7320 6172 equired files ar │ │ │ │ -0003f140: 653a 0a0a 6b66 7265 6562 7364 5f65 6e76 e:..kfreebsd_env │ │ │ │ -0003f150: 2e69 3338 3620 2020 2020 2020 2020 2020 .i386 │ │ │ │ -0003f160: 2020 3332 2d62 6974 206b 4672 6565 4253 32-bit kFreeBS │ │ │ │ -0003f170: 4420 6465 7669 6365 2068 696e 7473 0a6b D device hints.k │ │ │ │ -0003f180: 6672 6565 6273 642e 6933 3836 2020 2020 freebsd.i386 │ │ │ │ -0003f190: 2020 2020 2020 2020 2020 2020 2033 322d 32- │ │ │ │ -0003f1a0: 6269 7420 4672 6565 4253 4420 6b65 726e bit FreeBSD kern │ │ │ │ -0003f1b0: 656c 2069 6d61 6765 0a6b 6672 6565 6273 el image.kfreebs │ │ │ │ -0003f1c0: 642e 7838 365f 3634 2c20 2020 2020 2020 d.x86_64, │ │ │ │ -0003f1d0: 2020 2020 2020 2073 616d 6520 6672 6f6d same from │ │ │ │ -0003f1e0: 2036 342d 6269 7420 6b46 7265 6542 5344 64-bit kFreeBSD │ │ │ │ -0003f1f0: 0a6b 6672 6565 6273 645f 656e 762e 7838 .kfreebsd_env.x8 │ │ │ │ -0003f200: 365f 3634 0a6b 6e65 7462 7364 2e69 3338 6_64.knetbsd.i38 │ │ │ │ -0003f210: 3620 2020 2020 2020 2020 2020 2020 2020 6 │ │ │ │ -0003f220: 2020 2033 322d 6269 7420 4e65 7442 5344 32-bit NetBSD │ │ │ │ -0003f230: 206b 6572 6e65 6c20 696d 6167 650a 6b6e kernel image.kn │ │ │ │ -0003f240: 6574 6273 642e 6d69 6e69 726f 6f74 2e69 etbsd.miniroot.i │ │ │ │ -0003f250: 3338 3620 2020 2020 2020 2020 3332 2d62 386 32-b │ │ │ │ -0003f260: 6974 206b 4e65 7442 5344 206d 696e 6972 it kNetBSD minir │ │ │ │ -0003f270: 6f6f 742e 6b6d 6f64 2e0a 6b6e 6574 6273 oot.kmod..knetbs │ │ │ │ -0003f280: 642e 7838 365f 3634 2c20 2020 2020 2020 d.x86_64, │ │ │ │ -0003f290: 2020 2020 2020 2020 7361 6d65 2066 726f same fro │ │ │ │ -0003f2a0: 6d20 3634 2d62 6974 206b 4e65 7442 5344 m 64-bit kNetBSD │ │ │ │ -0003f2b0: 0a6b 6e65 7462 7364 2e6d 696e 6972 6f6f .knetbsd.miniroo │ │ │ │ -0003f2c0: 742e 7838 365f 3634 0a6b 6f70 656e 6273 t.x86_64.kopenbs │ │ │ │ -0003f2d0: 642e 6933 3836 2020 2020 2020 2020 2020 d.i386 │ │ │ │ -0003f2e0: 2020 2020 2020 2033 322d 6269 7420 4f70 32-bit Op │ │ │ │ -0003f2f0: 656e 4253 4420 6b65 726e 656c 2062 7364 enBSD kernel bsd │ │ │ │ -0003f300: 2e72 6420 696d 6167 650a 6b6f 7065 6e62 .rd image.kopenb │ │ │ │ -0003f310: 7364 2e78 3836 5f36 3420 2020 2020 2020 sd.x86_64 │ │ │ │ -0003f320: 2020 2020 2020 2020 7361 6d65 2066 726f same fro │ │ │ │ -0003f330: 6d20 3634 2d62 6974 206b 4f70 656e 4253 m 64-bit kOpenBS │ │ │ │ -0003f340: 440a 6c69 6e75 782e 6933 3836 2020 2020 D.linux.i386 │ │ │ │ +0003f0b0: 2020 2020 2070 6c61 7466 6f72 6d20 6f6e platform on │ │ │ │ +0003f0c0: 6c79 290a 4752 5542 5f43 4f52 4542 4f4f ly).GRUB_COREBOO │ │ │ │ +0003f0d0: 545f 524f 4d20 2020 2020 2065 6d70 7479 T_ROM empty │ │ │ │ +0003f0e0: 2043 6f72 6562 6f6f 7420 524f 4d0a 4752 Coreboot ROM.GR │ │ │ │ +0003f0f0: 5542 5f51 454d 555f 4f50 5453 2020 2020 UB_QEMU_OPTS │ │ │ │ +0003f100: 2020 2020 2061 6464 6974 696f 6e61 6c20 additional │ │ │ │ +0003f110: 6f70 7469 6f6e 7320 746f 2062 6520 7375 options to be su │ │ │ │ +0003f120: 7070 6c69 6564 2074 6f20 5145 4d55 0a0a pplied to QEMU.. │ │ │ │ +0003f130: 2020 2052 6571 7569 7265 6420 6669 6c65 Required file │ │ │ │ +0003f140: 7320 6172 653a 0a0a 6b66 7265 6562 7364 s are:..kfreebsd │ │ │ │ +0003f150: 5f65 6e76 2e69 3338 3620 2020 2020 2020 _env.i386 │ │ │ │ +0003f160: 2020 2020 2020 3332 2d62 6974 206b 4672 32-bit kFr │ │ │ │ +0003f170: 6565 4253 4420 6465 7669 6365 2068 696e eeBSD device hin │ │ │ │ +0003f180: 7473 0a6b 6672 6565 6273 642e 6933 3836 ts.kfreebsd.i386 │ │ │ │ +0003f190: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +0003f1a0: 2033 322d 6269 7420 4672 6565 4253 4420 32-bit FreeBSD │ │ │ │ +0003f1b0: 6b65 726e 656c 2069 6d61 6765 0a6b 6672 kernel image.kfr │ │ │ │ +0003f1c0: 6565 6273 642e 7838 365f 3634 2c20 2020 eebsd.x86_64, │ │ │ │ +0003f1d0: 2020 2020 2020 2020 2020 2073 616d 6520 same │ │ │ │ +0003f1e0: 6672 6f6d 2036 342d 6269 7420 6b46 7265 from 64-bit kFre │ │ │ │ +0003f1f0: 6542 5344 0a6b 6672 6565 6273 645f 656e eBSD.kfreebsd_en │ │ │ │ +0003f200: 762e 7838 365f 3634 0a6b 6e65 7462 7364 v.x86_64.knetbsd │ │ │ │ +0003f210: 2e69 3338 3620 2020 2020 2020 2020 2020 .i386 │ │ │ │ +0003f220: 2020 2020 2020 2033 322d 6269 7420 4e65 32-bit Ne │ │ │ │ +0003f230: 7442 5344 206b 6572 6e65 6c20 696d 6167 tBSD kernel imag │ │ │ │ +0003f240: 650a 6b6e 6574 6273 642e 6d69 6e69 726f e.knetbsd.miniro │ │ │ │ +0003f250: 6f74 2e69 3338 3620 2020 2020 2020 2020 ot.i386 │ │ │ │ +0003f260: 3332 2d62 6974 206b 4e65 7442 5344 206d 32-bit kNetBSD m │ │ │ │ +0003f270: 696e 6972 6f6f 742e 6b6d 6f64 2e0a 6b6e iniroot.kmod..kn │ │ │ │ +0003f280: 6574 6273 642e 7838 365f 3634 2c20 2020 etbsd.x86_64, │ │ │ │ +0003f290: 2020 2020 2020 2020 2020 2020 7361 6d65 same │ │ │ │ +0003f2a0: 2066 726f 6d20 3634 2d62 6974 206b 4e65 from 64-bit kNe │ │ │ │ +0003f2b0: 7442 5344 0a6b 6e65 7462 7364 2e6d 696e tBSD.knetbsd.min │ │ │ │ +0003f2c0: 6972 6f6f 742e 7838 365f 3634 0a6b 6f70 iroot.x86_64.kop │ │ │ │ +0003f2d0: 656e 6273 642e 6933 3836 2020 2020 2020 enbsd.i386 │ │ │ │ +0003f2e0: 2020 2020 2020 2020 2020 2033 322d 6269 32-bi │ │ │ │ +0003f2f0: 7420 4f70 656e 4253 4420 6b65 726e 656c t OpenBSD kernel │ │ │ │ +0003f300: 2062 7364 2e72 6420 696d 6167 650a 6b6f bsd.rd image.ko │ │ │ │ +0003f310: 7065 6e62 7364 2e78 3836 5f36 3420 2020 penbsd.x86_64 │ │ │ │ +0003f320: 2020 2020 2020 2020 2020 2020 7361 6d65 same │ │ │ │ +0003f330: 2066 726f 6d20 3634 2d62 6974 206b 4f70 from 64-bit kOp │ │ │ │ +0003f340: 656e 4253 440a 6c69 6e75 782e 6933 3836 enBSD.linux.i386 │ │ │ │ 0003f350: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -0003f360: 3332 2d62 6974 204c 696e 7578 0a6c 696e 32-bit Linux.lin │ │ │ │ -0003f370: 7578 2e78 3836 5f36 3420 2020 2020 2020 ux.x86_64 │ │ │ │ -0003f380: 2020 2020 2020 2020 2020 2036 342d 6269 64-bi │ │ │ │ -0003f390: 7420 4c69 6e75 780a 0a1f 0a46 696c 653a t Linux....File: │ │ │ │ -0003f3a0: 2067 7275 622e 696e 666f 2c20 204e 6f64 grub.info, Nod │ │ │ │ -0003f3b0: 653a 2054 726f 7562 6c65 7368 6f6f 7469 e: Troubleshooti │ │ │ │ -0003f3c0: 6e67 2c20 204e 6578 743a 2049 6e76 6f6b ng, Next: Invok │ │ │ │ -0003f3d0: 696e 6720 6772 7562 2d69 6e73 7461 6c6c ing grub-install │ │ │ │ -0003f3e0: 2c20 2050 7265 763a 2053 7570 706f 7274 , Prev: Support │ │ │ │ -0003f3f0: 6564 206b 6572 6e65 6c73 2c20 2055 703a ed kernels, Up: │ │ │ │ -0003f400: 2054 6f70 0a0a 3232 2045 7272 6f72 206d Top..22 Error m │ │ │ │ -0003f410: 6573 7361 6765 7320 7072 6f64 7563 6564 essages produced │ │ │ │ -0003f420: 2062 7920 4752 5542 0a2a 2a2a 2a2a 2a2a by GRUB.******* │ │ │ │ +0003f360: 2020 2020 3332 2d62 6974 204c 696e 7578 32-bit Linux │ │ │ │ +0003f370: 0a6c 696e 7578 2e78 3836 5f36 3420 2020 .linux.x86_64 │ │ │ │ +0003f380: 2020 2020 2020 2020 2020 2020 2020 2036 6 │ │ │ │ +0003f390: 342d 6269 7420 4c69 6e75 780a 0a1f 0a46 4-bit Linux....F │ │ │ │ +0003f3a0: 696c 653a 2067 7275 622e 696e 666f 2c20 ile: grub.info, │ │ │ │ +0003f3b0: 204e 6f64 653a 2054 726f 7562 6c65 7368 Node: Troublesh │ │ │ │ +0003f3c0: 6f6f 7469 6e67 2c20 204e 6578 743a 2049 ooting, Next: I │ │ │ │ +0003f3d0: 6e76 6f6b 696e 6720 6772 7562 2d69 6e73 nvoking grub-ins │ │ │ │ +0003f3e0: 7461 6c6c 2c20 2050 7265 763a 2053 7570 tall, Prev: Sup │ │ │ │ +0003f3f0: 706f 7274 6564 206b 6572 6e65 6c73 2c20 ported kernels, │ │ │ │ +0003f400: 2055 703a 2054 6f70 0a0a 3232 2045 7272 Up: Top..22 Err │ │ │ │ +0003f410: 6f72 206d 6573 7361 6765 7320 7072 6f64 or messages prod │ │ │ │ +0003f420: 7563 6564 2062 7920 4752 5542 0a2a 2a2a uced by GRUB.*** │ │ │ │ 0003f430: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ -0003f440: 2a2a 2a2a 2a2a 2a2a 2a2a 2a0a 0a2a 204d ***********..* M │ │ │ │ -0003f450: 656e 753a 0a0a 2a20 4752 5542 206f 6e6c enu:..* GRUB onl │ │ │ │ -0003f460: 7920 6f66 6665 7273 2061 2072 6573 6375 y offers a rescu │ │ │ │ -0003f470: 6520 7368 656c 6c3a 3a0a 2a20 4669 726d e shell::.* Firm │ │ │ │ -0003f480: 7761 7265 2073 7461 6c6c 7320 696e 7374 ware stalls inst │ │ │ │ -0003f490: 6561 6420 6f66 2062 6f6f 7469 6e67 2047 ead of booting G │ │ │ │ -0003f4a0: 5255 423a 3a0a 0a1f 0a46 696c 653a 2067 RUB::....File: g │ │ │ │ -0003f4b0: 7275 622e 696e 666f 2c20 204e 6f64 653a rub.info, Node: │ │ │ │ -0003f4c0: 2047 5255 4220 6f6e 6c79 206f 6666 6572 GRUB only offer │ │ │ │ -0003f4d0: 7320 6120 7265 7363 7565 2073 6865 6c6c s a rescue shell │ │ │ │ -0003f4e0: 2c20 204e 6578 743a 2046 6972 6d77 6172 , Next: Firmwar │ │ │ │ -0003f4f0: 6520 7374 616c 6c73 2069 6e73 7465 6164 e stalls instead │ │ │ │ -0003f500: 206f 6620 626f 6f74 696e 6720 4752 5542 of booting GRUB │ │ │ │ -0003f510: 2c20 2055 703a 2054 726f 7562 6c65 7368 , Up: Troublesh │ │ │ │ -0003f520: 6f6f 7469 6e67 0a0a 3232 2e31 2047 5255 ooting..22.1 GRU │ │ │ │ -0003f530: 4220 6f6e 6c79 206f 6666 6572 7320 6120 B only offers a │ │ │ │ -0003f540: 7265 7363 7565 2073 6865 6c6c 0a3d 3d3d rescue shell.=== │ │ │ │ -0003f550: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ +0003f440: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a0a ***************. │ │ │ │ +0003f450: 0a2a 204d 656e 753a 0a0a 2a20 4752 5542 .* Menu:..* GRUB │ │ │ │ +0003f460: 206f 6e6c 7920 6f66 6665 7273 2061 2072 only offers a r │ │ │ │ +0003f470: 6573 6375 6520 7368 656c 6c3a 3a0a 2a20 escue shell::.* │ │ │ │ +0003f480: 4669 726d 7761 7265 2073 7461 6c6c 7320 Firmware stalls │ │ │ │ +0003f490: 696e 7374 6561 6420 6f66 2062 6f6f 7469 instead of booti │ │ │ │ +0003f4a0: 6e67 2047 5255 423a 3a0a 0a1f 0a46 696c ng GRUB::....Fil │ │ │ │ +0003f4b0: 653a 2067 7275 622e 696e 666f 2c20 204e e: grub.info, N │ │ │ │ +0003f4c0: 6f64 653a 2047 5255 4220 6f6e 6c79 206f ode: GRUB only o │ │ │ │ +0003f4d0: 6666 6572 7320 6120 7265 7363 7565 2073 ffers a rescue s │ │ │ │ +0003f4e0: 6865 6c6c 2c20 204e 6578 743a 2046 6972 hell, Next: Fir │ │ │ │ +0003f4f0: 6d77 6172 6520 7374 616c 6c73 2069 6e73 mware stalls ins │ │ │ │ +0003f500: 7465 6164 206f 6620 626f 6f74 696e 6720 tead of booting │ │ │ │ +0003f510: 4752 5542 2c20 2055 703a 2054 726f 7562 GRUB, Up: Troub │ │ │ │ +0003f520: 6c65 7368 6f6f 7469 6e67 0a0a 3232 2e31 leshooting..22.1 │ │ │ │ +0003f530: 2047 5255 4220 6f6e 6c79 206f 6666 6572 GRUB only offer │ │ │ │ +0003f540: 7320 6120 7265 7363 7565 2073 6865 6c6c s a rescue shell │ │ │ │ +0003f550: 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d .=============== │ │ │ │ 0003f560: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ -0003f570: 3d0a 0a47 5255 4227 7320 6e6f 726d 616c =..GRUB's normal │ │ │ │ -0003f580: 2073 7461 7274 2d75 7020 7072 6f63 6564 start-up proced │ │ │ │ -0003f590: 7572 6520 696e 766f 6c76 6573 2073 6574 ure involves set │ │ │ │ -0003f5a0: 7469 6e67 2074 6865 2027 7072 6566 6978 ting the 'prefix │ │ │ │ -0003f5b0: 270a 656e 7669 726f 6e6d 656e 7420 7661 '.environment va │ │ │ │ -0003f5c0: 7269 6162 6c65 2074 6f20 6120 7661 6c75 riable to a valu │ │ │ │ -0003f5d0: 6520 7365 7420 696e 2074 6865 2063 6f72 e set in the cor │ │ │ │ -0003f5e0: 6520 696d 6167 6520 6279 2027 6772 7562 e image by 'grub │ │ │ │ -0003f5f0: 2d69 6e73 7461 6c6c 272c 0a73 6574 7469 -install',.setti │ │ │ │ -0003f600: 6e67 2074 6865 2027 726f 6f74 2720 7661 ng the 'root' va │ │ │ │ -0003f610: 7269 6162 6c65 2074 6f20 6d61 7463 682c riable to match, │ │ │ │ -0003f620: 206c 6f61 6469 6e67 2074 6865 2027 6e6f loading the 'no │ │ │ │ -0003f630: 726d 616c 2720 6d6f 6475 6c65 2066 726f rmal' module fro │ │ │ │ -0003f640: 6d0a 7468 6520 7072 6566 6978 2c20 616e m.the prefix, an │ │ │ │ -0003f650: 6420 7275 6e6e 696e 6720 7468 6520 276e d running the 'n │ │ │ │ -0003f660: 6f72 6d61 6c27 2063 6f6d 6d61 6e64 2028 ormal' command ( │ │ │ │ -0003f670: 2a6e 6f74 6520 6e6f 726d 616c 3a3a 292e *note normal::). │ │ │ │ -0003f680: 2020 5468 6973 0a63 6f6d 6d61 6e64 2069 This.command i │ │ │ │ -0003f690: 7320 7265 7370 6f6e 7369 626c 6520 666f s responsible fo │ │ │ │ -0003f6a0: 7220 7265 6164 696e 6720 272f 626f 6f74 r reading '/boot │ │ │ │ -0003f6b0: 2f67 7275 622f 6772 7562 2e63 6667 272c /grub/grub.cfg', │ │ │ │ -0003f6c0: 2072 756e 6e69 6e67 2074 6865 0a6d 656e running the.men │ │ │ │ -0003f6d0: 752c 2061 6e64 2064 6f69 6e67 2061 6c6c u, and doing all │ │ │ │ -0003f6e0: 2074 6865 2075 7365 6675 6c20 7468 696e the useful thin │ │ │ │ -0003f6f0: 6773 2047 5255 4220 6973 2073 7570 706f gs GRUB is suppo │ │ │ │ -0003f700: 7365 6420 746f 2064 6f2e 0a0a 2020 2049 sed to do... I │ │ │ │ -0003f710: 662c 2069 6e73 7465 6164 2c20 796f 7520 f, instead, you │ │ │ │ -0003f720: 6f6e 6c79 2067 6574 2061 2072 6573 6375 only get a rescu │ │ │ │ -0003f730: 6520 7368 656c 6c2c 2074 6869 7320 7573 e shell, this us │ │ │ │ -0003f740: 7561 6c6c 7920 6d65 616e 7320 7468 6174 ually means that │ │ │ │ -0003f750: 0a47 5255 4220 6661 696c 6564 2074 6f20 .GRUB failed to │ │ │ │ -0003f760: 6c6f 6164 2074 6865 2027 6e6f 726d 616c load the 'normal │ │ │ │ -0003f770: 2720 6d6f 6475 6c65 2066 6f72 2073 6f6d ' module for som │ │ │ │ -0003f780: 6520 7265 6173 6f6e 2e20 2049 7420 6d61 e reason. It ma │ │ │ │ -0003f790: 7920 6265 0a70 6f73 7369 626c 6520 746f y be.possible to │ │ │ │ -0003f7a0: 2077 6f72 6b20 6172 6f75 6e64 2074 6869 work around thi │ │ │ │ -0003f7b0: 7320 7465 6d70 6f72 6172 696c 793a 2066 s temporarily: f │ │ │ │ -0003f7c0: 6f72 2069 6e73 7461 6e63 652c 2069 6620 or instance, if │ │ │ │ -0003f7d0: 7468 6520 7265 6173 6f6e 0a66 6f72 2074 the reason.for t │ │ │ │ -0003f7e0: 6865 2066 6169 6c75 7265 2069 7320 7468 he failure is th │ │ │ │ -0003f7f0: 6174 2027 7072 6566 6978 2720 6973 2077 at 'prefix' is w │ │ │ │ -0003f800: 726f 6e67 2028 7065 7268 6170 7320 6974 rong (perhaps it │ │ │ │ -0003f810: 2072 6566 6572 7320 746f 2074 6865 0a77 refers to the.w │ │ │ │ -0003f820: 726f 6e67 2064 6576 6963 652c 206f 7220 rong device, or │ │ │ │ -0003f830: 7065 7268 6170 7320 7468 6520 7061 7468 perhaps the path │ │ │ │ -0003f840: 2074 6f20 272f 626f 6f74 2f67 7275 6227 to '/boot/grub' │ │ │ │ -0003f850: 2077 6173 206e 6f74 2063 6f72 7265 6374 was not correct │ │ │ │ -0003f860: 6c79 206d 6164 650a 7265 6c61 7469 7665 ly made.relative │ │ │ │ -0003f870: 2074 6f20 7468 6520 6465 7669 6365 292c to the device), │ │ │ │ -0003f880: 2074 6865 6e20 796f 7520 6361 6e20 636f then you can co │ │ │ │ -0003f890: 7272 6563 7420 7468 6973 2061 6e64 2065 rrect this and e │ │ │ │ -0003f8a0: 6e74 6572 206e 6f72 6d61 6c20 6d6f 6465 nter normal mode │ │ │ │ -0003f8b0: 0a6d 616e 7561 6c6c 793a 0a0a 2020 2020 .manually:.. │ │ │ │ -0003f8c0: 2023 2049 6e73 7065 6374 2074 6865 2063 # Inspect the c │ │ │ │ -0003f8d0: 7572 7265 6e74 2070 7265 6669 7820 2861 urrent prefix (a │ │ │ │ -0003f8e0: 6e64 206f 7468 6572 2070 7265 7365 7420 nd other preset │ │ │ │ -0003f8f0: 7661 7269 6162 6c65 7329 3a0a 2020 2020 variables):. │ │ │ │ -0003f900: 2073 6574 0a20 2020 2020 2320 4669 6e64 set. # Find │ │ │ │ -0003f910: 206f 7574 2077 6869 6368 2064 6576 6963 out which devic │ │ │ │ -0003f920: 6573 2061 7265 2061 7661 696c 6162 6c65 es are available │ │ │ │ -0003f930: 3a0a 2020 2020 206c 730a 2020 2020 2023 :. ls. # │ │ │ │ -0003f940: 2053 6574 2074 6f20 7468 6520 636f 7272 Set to the corr │ │ │ │ -0003f950: 6563 7420 7661 6c75 652c 2077 6869 6368 ect value, which │ │ │ │ -0003f960: 206d 6967 6874 2062 6520 736f 6d65 7468 might be someth │ │ │ │ -0003f970: 696e 6720 6c69 6b65 2074 6869 733a 0a20 ing like this:. │ │ │ │ -0003f980: 2020 2020 7365 7420 7072 6566 6978 3d28 set prefix=( │ │ │ │ -0003f990: 6864 302c 3129 2f67 7275 620a 2020 2020 hd0,1)/grub. │ │ │ │ -0003f9a0: 2073 6574 2072 6f6f 743d 2868 6430 2c31 set root=(hd0,1 │ │ │ │ -0003f9b0: 290a 2020 2020 2069 6e73 6d6f 6420 6e6f ). insmod no │ │ │ │ -0003f9c0: 726d 616c 0a20 2020 2020 6e6f 726d 616c rmal. normal │ │ │ │ -0003f9d0: 0a0a 2020 2048 6f77 6576 6572 2c20 616e .. However, an │ │ │ │ -0003f9e0: 7920 7072 6f62 6c65 6d20 7468 6174 206c y problem that l │ │ │ │ -0003f9f0: 6561 7665 7320 796f 7520 696e 2074 6865 eaves you in the │ │ │ │ -0003fa00: 2072 6573 6375 6520 7368 656c 6c20 7072 rescue shell pr │ │ │ │ -0003fa10: 6f62 6162 6c79 0a6d 6561 6e73 2074 6861 obably.means tha │ │ │ │ -0003fa20: 7420 4752 5542 2077 6173 206e 6f74 2063 t GRUB was not c │ │ │ │ -0003fa30: 6f72 7265 6374 6c79 2069 6e73 7461 6c6c orrectly install │ │ │ │ -0003fa40: 6564 2e20 2049 7420 6d61 7920 6265 206d ed. It may be m │ │ │ │ -0003fa50: 6f72 6520 7573 6566 756c 2074 6f0a 7472 ore useful to.tr │ │ │ │ -0003fa60: 7920 746f 2072 6569 6e73 7461 6c6c 2069 y to reinstall i │ │ │ │ -0003fa70: 7420 7072 6f70 6572 6c79 2075 7369 6e67 t properly using │ │ │ │ -0003fa80: 2027 6772 7562 2d69 6e73 7461 6c6c 2044 'grub-install D │ │ │ │ -0003fa90: 4556 4943 4527 2028 2a6e 6f74 6520 496e EVICE' (*note In │ │ │ │ -0003faa0: 766f 6b69 6e67 0a67 7275 622d 696e 7374 voking.grub-inst │ │ │ │ -0003fab0: 616c 6c3a 3a29 2e20 2057 6865 6e20 646f all::). When do │ │ │ │ -0003fac0: 696e 6720 7468 6973 2c20 7468 6572 6520 ing this, there │ │ │ │ -0003fad0: 6172 6520 6120 6665 7720 7468 696e 6773 are a few things │ │ │ │ -0003fae0: 2074 6f20 7265 6d65 6d62 6572 3a0a 0a20 to remember:.. │ │ │ │ -0003faf0: 2020 2a20 4472 6976 6520 6f72 6465 7269 * Drive orderi │ │ │ │ -0003fb00: 6e67 2069 6e20 796f 7572 206f 7065 7261 ng in your opera │ │ │ │ -0003fb10: 7469 6e67 2073 7973 7465 6d20 6d61 7920 ting system may │ │ │ │ -0003fb20: 6e6f 7420 6265 2074 6865 2073 616d 6520 not be the same │ │ │ │ -0003fb30: 6173 2074 6865 0a20 2020 2020 626f 6f74 as the. boot │ │ │ │ -0003fb40: 2064 7269 7665 206f 7264 6572 696e 6720 drive ordering │ │ │ │ -0003fb50: 7573 6564 2062 7920 796f 7572 2066 6972 used by your fir │ │ │ │ -0003fb60: 6d77 6172 652e 2020 446f 206e 6f74 2061 mware. Do not a │ │ │ │ -0003fb70: 7373 756d 6520 7468 6174 2079 6f75 720a ssume that your. │ │ │ │ -0003fb80: 2020 2020 2066 6972 7374 2068 6172 6420 first hard │ │ │ │ -0003fb90: 6472 6976 6520 2865 2e67 2e20 2027 2f64 drive (e.g. '/d │ │ │ │ -0003fba0: 6576 2f73 6461 2729 2069 7320 7468 6520 ev/sda') is the │ │ │ │ -0003fbb0: 6f6e 6520 7468 6174 2079 6f75 7220 6669 one that your fi │ │ │ │ -0003fbc0: 726d 7761 7265 0a20 2020 2020 7769 6c6c rmware. will │ │ │ │ -0003fbd0: 2062 6f6f 7420 6672 6f6d 2e20 2027 6465 boot from. 'de │ │ │ │ -0003fbe0: 7669 6365 2e6d 6170 2720 282a 6e6f 7465 vice.map' (*note │ │ │ │ -0003fbf0: 2044 6576 6963 6520 6d61 703a 3a29 2063 Device map::) c │ │ │ │ -0003fc00: 616e 2062 6520 7573 6564 2074 6f0a 2020 an be used to. │ │ │ │ -0003fc10: 2020 206f 7665 7272 6964 6520 7468 6973 override this │ │ │ │ -0003fc20: 2c20 6275 7420 6974 2069 7320 7573 7561 , but it is usua │ │ │ │ -0003fc30: 6c6c 7920 6265 7474 6572 2074 6f20 7573 lly better to us │ │ │ │ -0003fc40: 6520 5555 4944 7320 6f72 2066 696c 6520 e UUIDs or file │ │ │ │ -0003fc50: 7379 7374 656d 0a20 2020 2020 6c61 6265 system. labe │ │ │ │ -0003fc60: 6c73 2061 6e64 2061 766f 6964 2064 6570 ls and avoid dep │ │ │ │ -0003fc70: 656e 6469 6e67 206f 6e20 6472 6976 6520 ending on drive │ │ │ │ -0003fc80: 6f72 6465 7269 6e67 2065 6e74 6972 656c ordering entirel │ │ │ │ -0003fc90: 792e 0a0a 2020 202a 2041 7420 6c65 6173 y... * At leas │ │ │ │ -0003fca0: 7420 6f6e 2042 494f 5320 7379 7374 656d t on BIOS system │ │ │ │ -0003fcb0: 732c 2069 6620 796f 7520 7465 6c6c 2027 s, if you tell ' │ │ │ │ -0003fcc0: 6772 7562 2d69 6e73 7461 6c6c 2720 746f grub-install' to │ │ │ │ -0003fcd0: 2069 6e73 7461 6c6c 0a20 2020 2020 4752 install. GR │ │ │ │ -0003fce0: 5542 2074 6f20 6120 7061 7274 6974 696f UB to a partitio │ │ │ │ -0003fcf0: 6e20 6275 7420 4752 5542 2068 6173 2061 n but GRUB has a │ │ │ │ -0003fd00: 6c72 6561 6479 2062 6565 6e20 696e 7374 lready been inst │ │ │ │ -0003fd10: 616c 6c65 6420 696e 2074 6865 0a20 2020 alled in the. │ │ │ │ -0003fd20: 2020 6d61 7374 6572 2062 6f6f 7420 7265 master boot re │ │ │ │ -0003fd30: 636f 7264 2c20 7468 656e 2074 6865 2047 cord, then the G │ │ │ │ -0003fd40: 5255 4220 696e 7374 616c 6c61 7469 6f6e RUB installation │ │ │ │ -0003fd50: 2069 6e20 7468 6520 7061 7274 6974 696f in the partitio │ │ │ │ -0003fd60: 6e0a 2020 2020 2077 696c 6c20 6265 2069 n. will be i │ │ │ │ -0003fd70: 676e 6f72 6564 2e0a 0a20 2020 2a20 4966 gnored... * If │ │ │ │ -0003fd80: 2070 6f73 7369 626c 652c 2069 7420 6973 possible, it is │ │ │ │ -0003fd90: 2067 656e 6572 616c 6c79 2062 6573 7420 generally best │ │ │ │ -0003fda0: 746f 2061 766f 6964 2069 6e73 7461 6c6c to avoid install │ │ │ │ -0003fdb0: 696e 6720 4752 5542 2074 6f20 610a 2020 ing GRUB to a. │ │ │ │ -0003fdc0: 2020 2070 6172 7469 7469 6f6e 2028 756e partition (un │ │ │ │ -0003fdd0: 6c65 7373 2069 7420 6973 2061 2073 7065 less it is a spe │ │ │ │ -0003fde0: 6369 616c 2070 6172 7469 7469 6f6e 2066 cial partition f │ │ │ │ -0003fdf0: 6f72 2074 6865 2075 7365 206f 6620 4752 or the use of GR │ │ │ │ -0003fe00: 5542 0a20 2020 2020 616c 6f6e 652c 2073 UB. alone, s │ │ │ │ -0003fe10: 7563 6820 6173 2074 6865 2042 494f 5320 uch as the BIOS │ │ │ │ -0003fe20: 426f 6f74 2050 6172 7469 7469 6f6e 2075 Boot Partition u │ │ │ │ -0003fe30: 7365 6420 6f6e 2047 5054 292e 2044 6f69 sed on GPT). Doi │ │ │ │ -0003fe40: 6e67 2074 6869 730a 2020 2020 206d 6561 ng this. mea │ │ │ │ -0003fe50: 6e73 2074 6861 7420 4752 5542 206d 6179 ns that GRUB may │ │ │ │ -0003fe60: 2073 746f 7020 6265 696e 6720 6162 6c65 stop being able │ │ │ │ -0003fe70: 2074 6f20 7265 6164 2069 7473 2063 6f72 to read its cor │ │ │ │ -0003fe80: 6520 696d 6167 6520 6475 6520 746f 2061 e image due to a │ │ │ │ -0003fe90: 0a20 2020 2020 6669 6c65 2073 7973 7465 . file syste │ │ │ │ -0003fea0: 6d20 6d6f 7669 6e67 2062 6c6f 636b 7320 m moving blocks │ │ │ │ -0003feb0: 6172 6f75 6e64 2c20 7375 6368 2061 7320 around, such as │ │ │ │ -0003fec0: 7768 696c 6520 6465 6672 6167 6d65 6e74 while defragment │ │ │ │ -0003fed0: 696e 672c 0a20 2020 2020 7275 6e6e 696e ing,. runnin │ │ │ │ -0003fee0: 6720 6368 6563 6b73 2c20 6f72 2065 7665 g checks, or eve │ │ │ │ -0003fef0: 6e20 6475 7269 6e67 206e 6f72 6d61 6c20 n during normal │ │ │ │ -0003ff00: 6f70 6572 6174 696f 6e2e 2020 496e 7374 operation. Inst │ │ │ │ -0003ff10: 616c 6c69 6e67 2074 6f20 7468 650a 2020 alling to the. │ │ │ │ -0003ff20: 2020 2077 686f 6c65 2064 6973 6b20 6465 whole disk de │ │ │ │ -0003ff30: 7669 6365 2069 7320 6e6f 726d 616c 6c79 vice is normally │ │ │ │ -0003ff40: 206d 6f72 6520 726f 6275 7374 2e0a 0a20 more robust... │ │ │ │ -0003ff50: 2020 2a20 4368 6563 6b20 7468 6174 2047 * Check that G │ │ │ │ -0003ff60: 5255 4220 6163 7475 616c 6c79 206b 6e6f RUB actually kno │ │ │ │ -0003ff70: 7773 2068 6f77 2074 6f20 7265 6164 2066 ws how to read f │ │ │ │ -0003ff80: 726f 6d20 7468 6520 6465 7669 6365 2061 rom the device a │ │ │ │ -0003ff90: 6e64 2066 696c 650a 2020 2020 2073 7973 nd file. sys │ │ │ │ -0003ffa0: 7465 6d20 636f 6e74 6169 6e69 6e67 2027 tem containing ' │ │ │ │ -0003ffb0: 2f62 6f6f 742f 6772 7562 272e 2020 4974 /boot/grub'. It │ │ │ │ -0003ffc0: 2077 696c 6c20 6e6f 7420 6265 2061 626c will not be abl │ │ │ │ -0003ffd0: 6520 746f 2072 6561 6420 6672 6f6d 0a20 e to read from. │ │ │ │ -0003ffe0: 2020 2020 656e 6372 7970 7465 6420 6465 encrypted de │ │ │ │ -0003fff0: 7669 6365 7320 7769 7468 2075 6e73 7570 vices with unsup │ │ │ │ -00040000: 706f 7274 6564 2065 6e63 7279 7074 696f ported encryptio │ │ │ │ -00040010: 6e20 7363 6865 6d65 2c20 6e6f 7220 6672 n scheme, nor fr │ │ │ │ -00040020: 6f6d 2066 696c 650a 2020 2020 2073 7973 om file. sys │ │ │ │ -00040030: 7465 6d73 2066 6f72 2077 6869 6368 2073 tems for which s │ │ │ │ -00040040: 7570 706f 7274 2068 6173 206e 6f74 2079 upport has not y │ │ │ │ -00040050: 6574 2062 6565 6e20 6164 6465 6420 746f et been added to │ │ │ │ -00040060: 2047 5255 422e 0a0a 1f0a 4669 6c65 3a20 GRUB.....File: │ │ │ │ -00040070: 6772 7562 2e69 6e66 6f2c 2020 4e6f 6465 grub.info, Node │ │ │ │ -00040080: 3a20 4669 726d 7761 7265 2073 7461 6c6c : Firmware stall │ │ │ │ -00040090: 7320 696e 7374 6561 6420 6f66 2062 6f6f s instead of boo │ │ │ │ -000400a0: 7469 6e67 2047 5255 422c 2020 5072 6576 ting GRUB, Prev │ │ │ │ -000400b0: 3a20 4752 5542 206f 6e6c 7920 6f66 6665 : GRUB only offe │ │ │ │ -000400c0: 7273 2061 2072 6573 6375 6520 7368 656c rs a rescue shel │ │ │ │ -000400d0: 6c2c 2020 5570 3a20 5472 6f75 626c 6573 l, Up: Troubles │ │ │ │ -000400e0: 686f 6f74 696e 670a 0a32 322e 3220 4669 hooting..22.2 Fi │ │ │ │ -000400f0: 726d 7761 7265 2073 7461 6c6c 7320 696e rmware stalls in │ │ │ │ -00040100: 7374 6561 6420 6f66 2062 6f6f 7469 6e67 stead of booting │ │ │ │ -00040110: 2047 5255 420a 3d3d 3d3d 3d3d 3d3d 3d3d GRUB.========== │ │ │ │ +0003f570: 3d3d 3d3d 3d0a 0a47 5255 4227 7320 6e6f =====..GRUB's no │ │ │ │ +0003f580: 726d 616c 2073 7461 7274 2d75 7020 7072 rmal start-up pr │ │ │ │ +0003f590: 6f63 6564 7572 6520 696e 766f 6c76 6573 ocedure involves │ │ │ │ +0003f5a0: 2073 6574 7469 6e67 2074 6865 2027 7072 setting the 'pr │ │ │ │ +0003f5b0: 6566 6978 270a 656e 7669 726f 6e6d 656e efix'.environmen │ │ │ │ +0003f5c0: 7420 7661 7269 6162 6c65 2074 6f20 6120 t variable to a │ │ │ │ +0003f5d0: 7661 6c75 6520 7365 7420 696e 2074 6865 value set in the │ │ │ │ +0003f5e0: 2063 6f72 6520 696d 6167 6520 6279 2027 core image by ' │ │ │ │ +0003f5f0: 6772 7562 2d69 6e73 7461 6c6c 272c 0a73 grub-install',.s │ │ │ │ +0003f600: 6574 7469 6e67 2074 6865 2027 726f 6f74 etting the 'root │ │ │ │ +0003f610: 2720 7661 7269 6162 6c65 2074 6f20 6d61 ' variable to ma │ │ │ │ +0003f620: 7463 682c 206c 6f61 6469 6e67 2074 6865 tch, loading the │ │ │ │ +0003f630: 2027 6e6f 726d 616c 2720 6d6f 6475 6c65 'normal' module │ │ │ │ +0003f640: 2066 726f 6d0a 7468 6520 7072 6566 6978 from.the prefix │ │ │ │ +0003f650: 2c20 616e 6420 7275 6e6e 696e 6720 7468 , and running th │ │ │ │ +0003f660: 6520 276e 6f72 6d61 6c27 2063 6f6d 6d61 e 'normal' comma │ │ │ │ +0003f670: 6e64 2028 2a6e 6f74 6520 6e6f 726d 616c nd (*note normal │ │ │ │ +0003f680: 3a3a 292e 2020 5468 6973 0a63 6f6d 6d61 ::). This.comma │ │ │ │ +0003f690: 6e64 2069 7320 7265 7370 6f6e 7369 626c nd is responsibl │ │ │ │ +0003f6a0: 6520 666f 7220 7265 6164 696e 6720 272f e for reading '/ │ │ │ │ +0003f6b0: 626f 6f74 2f67 7275 622f 6772 7562 2e63 boot/grub/grub.c │ │ │ │ +0003f6c0: 6667 272c 2072 756e 6e69 6e67 2074 6865 fg', running the │ │ │ │ +0003f6d0: 0a6d 656e 752c 2061 6e64 2064 6f69 6e67 .menu, and doing │ │ │ │ +0003f6e0: 2061 6c6c 2074 6865 2075 7365 6675 6c20 all the useful │ │ │ │ +0003f6f0: 7468 696e 6773 2047 5255 4220 6973 2073 things GRUB is s │ │ │ │ +0003f700: 7570 706f 7365 6420 746f 2064 6f2e 0a0a upposed to do... │ │ │ │ +0003f710: 2020 2049 662c 2069 6e73 7465 6164 2c20 If, instead, │ │ │ │ +0003f720: 796f 7520 6f6e 6c79 2067 6574 2061 2072 you only get a r │ │ │ │ +0003f730: 6573 6375 6520 7368 656c 6c2c 2074 6869 escue shell, thi │ │ │ │ +0003f740: 7320 7573 7561 6c6c 7920 6d65 616e 7320 s usually means │ │ │ │ +0003f750: 7468 6174 0a47 5255 4220 6661 696c 6564 that.GRUB failed │ │ │ │ +0003f760: 2074 6f20 6c6f 6164 2074 6865 2027 6e6f to load the 'no │ │ │ │ +0003f770: 726d 616c 2720 6d6f 6475 6c65 2066 6f72 rmal' module for │ │ │ │ +0003f780: 2073 6f6d 6520 7265 6173 6f6e 2e20 2049 some reason. I │ │ │ │ +0003f790: 7420 6d61 7920 6265 0a70 6f73 7369 626c t may be.possibl │ │ │ │ +0003f7a0: 6520 746f 2077 6f72 6b20 6172 6f75 6e64 e to work around │ │ │ │ +0003f7b0: 2074 6869 7320 7465 6d70 6f72 6172 696c this temporaril │ │ │ │ +0003f7c0: 793a 2066 6f72 2069 6e73 7461 6e63 652c y: for instance, │ │ │ │ +0003f7d0: 2069 6620 7468 6520 7265 6173 6f6e 0a66 if the reason.f │ │ │ │ +0003f7e0: 6f72 2074 6865 2066 6169 6c75 7265 2069 or the failure i │ │ │ │ +0003f7f0: 7320 7468 6174 2027 7072 6566 6978 2720 s that 'prefix' │ │ │ │ +0003f800: 6973 2077 726f 6e67 2028 7065 7268 6170 is wrong (perhap │ │ │ │ +0003f810: 7320 6974 2072 6566 6572 7320 746f 2074 s it refers to t │ │ │ │ +0003f820: 6865 0a77 726f 6e67 2064 6576 6963 652c he.wrong device, │ │ │ │ +0003f830: 206f 7220 7065 7268 6170 7320 7468 6520 or perhaps the │ │ │ │ +0003f840: 7061 7468 2074 6f20 272f 626f 6f74 2f67 path to '/boot/g │ │ │ │ +0003f850: 7275 6227 2077 6173 206e 6f74 2063 6f72 rub' was not cor │ │ │ │ +0003f860: 7265 6374 6c79 206d 6164 650a 7265 6c61 rectly made.rela │ │ │ │ +0003f870: 7469 7665 2074 6f20 7468 6520 6465 7669 tive to the devi │ │ │ │ +0003f880: 6365 292c 2074 6865 6e20 796f 7520 6361 ce), then you ca │ │ │ │ +0003f890: 6e20 636f 7272 6563 7420 7468 6973 2061 n correct this a │ │ │ │ +0003f8a0: 6e64 2065 6e74 6572 206e 6f72 6d61 6c20 nd enter normal │ │ │ │ +0003f8b0: 6d6f 6465 0a6d 616e 7561 6c6c 793a 0a0a mode.manually:.. │ │ │ │ +0003f8c0: 2020 2020 2023 2049 6e73 7065 6374 2074 # Inspect t │ │ │ │ +0003f8d0: 6865 2063 7572 7265 6e74 2070 7265 6669 he current prefi │ │ │ │ +0003f8e0: 7820 2861 6e64 206f 7468 6572 2070 7265 x (and other pre │ │ │ │ +0003f8f0: 7365 7420 7661 7269 6162 6c65 7329 3a0a set variables):. │ │ │ │ +0003f900: 2020 2020 2073 6574 0a20 2020 2020 2320 set. # │ │ │ │ +0003f910: 4669 6e64 206f 7574 2077 6869 6368 2064 Find out which d │ │ │ │ +0003f920: 6576 6963 6573 2061 7265 2061 7661 696c evices are avail │ │ │ │ +0003f930: 6162 6c65 3a0a 2020 2020 206c 730a 2020 able:. ls. │ │ │ │ +0003f940: 2020 2023 2053 6574 2074 6f20 7468 6520 # Set to the │ │ │ │ +0003f950: 636f 7272 6563 7420 7661 6c75 652c 2077 correct value, w │ │ │ │ +0003f960: 6869 6368 206d 6967 6874 2062 6520 736f hich might be so │ │ │ │ +0003f970: 6d65 7468 696e 6720 6c69 6b65 2074 6869 mething like thi │ │ │ │ +0003f980: 733a 0a20 2020 2020 7365 7420 7072 6566 s:. set pref │ │ │ │ +0003f990: 6978 3d28 6864 302c 3129 2f67 7275 620a ix=(hd0,1)/grub. │ │ │ │ +0003f9a0: 2020 2020 2073 6574 2072 6f6f 743d 2868 set root=(h │ │ │ │ +0003f9b0: 6430 2c31 290a 2020 2020 2069 6e73 6d6f d0,1). insmo │ │ │ │ +0003f9c0: 6420 6e6f 726d 616c 0a20 2020 2020 6e6f d normal. no │ │ │ │ +0003f9d0: 726d 616c 0a0a 2020 2048 6f77 6576 6572 rmal.. However │ │ │ │ +0003f9e0: 2c20 616e 7920 7072 6f62 6c65 6d20 7468 , any problem th │ │ │ │ +0003f9f0: 6174 206c 6561 7665 7320 796f 7520 696e at leaves you in │ │ │ │ +0003fa00: 2074 6865 2072 6573 6375 6520 7368 656c the rescue shel │ │ │ │ +0003fa10: 6c20 7072 6f62 6162 6c79 0a6d 6561 6e73 l probably.means │ │ │ │ +0003fa20: 2074 6861 7420 4752 5542 2077 6173 206e that GRUB was n │ │ │ │ +0003fa30: 6f74 2063 6f72 7265 6374 6c79 2069 6e73 ot correctly ins │ │ │ │ +0003fa40: 7461 6c6c 6564 2e20 2049 7420 6d61 7920 talled. It may │ │ │ │ +0003fa50: 6265 206d 6f72 6520 7573 6566 756c 2074 be more useful t │ │ │ │ +0003fa60: 6f0a 7472 7920 746f 2072 6569 6e73 7461 o.try to reinsta │ │ │ │ +0003fa70: 6c6c 2069 7420 7072 6f70 6572 6c79 2075 ll it properly u │ │ │ │ +0003fa80: 7369 6e67 2027 6772 7562 2d69 6e73 7461 sing 'grub-insta │ │ │ │ +0003fa90: 6c6c 2044 4556 4943 4527 2028 2a6e 6f74 ll DEVICE' (*not │ │ │ │ +0003faa0: 6520 496e 766f 6b69 6e67 0a67 7275 622d e Invoking.grub- │ │ │ │ +0003fab0: 696e 7374 616c 6c3a 3a29 2e20 2057 6865 install::). Whe │ │ │ │ +0003fac0: 6e20 646f 696e 6720 7468 6973 2c20 7468 n doing this, th │ │ │ │ +0003fad0: 6572 6520 6172 6520 6120 6665 7720 7468 ere are a few th │ │ │ │ +0003fae0: 696e 6773 2074 6f20 7265 6d65 6d62 6572 ings to remember │ │ │ │ +0003faf0: 3a0a 0a20 2020 2a20 4472 6976 6520 6f72 :.. * Drive or │ │ │ │ +0003fb00: 6465 7269 6e67 2069 6e20 796f 7572 206f dering in your o │ │ │ │ +0003fb10: 7065 7261 7469 6e67 2073 7973 7465 6d20 perating system │ │ │ │ +0003fb20: 6d61 7920 6e6f 7420 6265 2074 6865 2073 may not be the s │ │ │ │ +0003fb30: 616d 6520 6173 2074 6865 0a20 2020 2020 ame as the. │ │ │ │ +0003fb40: 626f 6f74 2064 7269 7665 206f 7264 6572 boot drive order │ │ │ │ +0003fb50: 696e 6720 7573 6564 2062 7920 796f 7572 ing used by your │ │ │ │ +0003fb60: 2066 6972 6d77 6172 652e 2020 446f 206e firmware. Do n │ │ │ │ +0003fb70: 6f74 2061 7373 756d 6520 7468 6174 2079 ot assume that y │ │ │ │ +0003fb80: 6f75 720a 2020 2020 2066 6972 7374 2068 our. first h │ │ │ │ +0003fb90: 6172 6420 6472 6976 6520 2865 2e67 2e20 ard drive (e.g. │ │ │ │ +0003fba0: 2027 2f64 6576 2f73 6461 2729 2069 7320 '/dev/sda') is │ │ │ │ +0003fbb0: 7468 6520 6f6e 6520 7468 6174 2079 6f75 the one that you │ │ │ │ +0003fbc0: 7220 6669 726d 7761 7265 0a20 2020 2020 r firmware. │ │ │ │ +0003fbd0: 7769 6c6c 2062 6f6f 7420 6672 6f6d 2e20 will boot from. │ │ │ │ +0003fbe0: 2027 6465 7669 6365 2e6d 6170 2720 282a 'device.map' (* │ │ │ │ +0003fbf0: 6e6f 7465 2044 6576 6963 6520 6d61 703a note Device map: │ │ │ │ +0003fc00: 3a29 2063 616e 2062 6520 7573 6564 2074 :) can be used t │ │ │ │ +0003fc10: 6f0a 2020 2020 206f 7665 7272 6964 6520 o. override │ │ │ │ +0003fc20: 7468 6973 2c20 6275 7420 6974 2069 7320 this, but it is │ │ │ │ +0003fc30: 7573 7561 6c6c 7920 6265 7474 6572 2074 usually better t │ │ │ │ +0003fc40: 6f20 7573 6520 5555 4944 7320 6f72 2066 o use UUIDs or f │ │ │ │ +0003fc50: 696c 6520 7379 7374 656d 0a20 2020 2020 ile system. │ │ │ │ +0003fc60: 6c61 6265 6c73 2061 6e64 2061 766f 6964 labels and avoid │ │ │ │ +0003fc70: 2064 6570 656e 6469 6e67 206f 6e20 6472 depending on dr │ │ │ │ +0003fc80: 6976 6520 6f72 6465 7269 6e67 2065 6e74 ive ordering ent │ │ │ │ +0003fc90: 6972 656c 792e 0a0a 2020 202a 2041 7420 irely... * At │ │ │ │ +0003fca0: 6c65 6173 7420 6f6e 2042 494f 5320 7379 least on BIOS sy │ │ │ │ +0003fcb0: 7374 656d 732c 2069 6620 796f 7520 7465 stems, if you te │ │ │ │ +0003fcc0: 6c6c 2027 6772 7562 2d69 6e73 7461 6c6c ll 'grub-install │ │ │ │ +0003fcd0: 2720 746f 2069 6e73 7461 6c6c 0a20 2020 ' to install. │ │ │ │ +0003fce0: 2020 4752 5542 2074 6f20 6120 7061 7274 GRUB to a part │ │ │ │ +0003fcf0: 6974 696f 6e20 6275 7420 4752 5542 2068 ition but GRUB h │ │ │ │ +0003fd00: 6173 2061 6c72 6561 6479 2062 6565 6e20 as already been │ │ │ │ +0003fd10: 696e 7374 616c 6c65 6420 696e 2074 6865 installed in the │ │ │ │ +0003fd20: 0a20 2020 2020 6d61 7374 6572 2062 6f6f . master boo │ │ │ │ +0003fd30: 7420 7265 636f 7264 2c20 7468 656e 2074 t record, then t │ │ │ │ +0003fd40: 6865 2047 5255 4220 696e 7374 616c 6c61 he GRUB installa │ │ │ │ +0003fd50: 7469 6f6e 2069 6e20 7468 6520 7061 7274 tion in the part │ │ │ │ +0003fd60: 6974 696f 6e0a 2020 2020 2077 696c 6c20 ition. will │ │ │ │ +0003fd70: 6265 2069 676e 6f72 6564 2e0a 0a20 2020 be ignored... │ │ │ │ +0003fd80: 2a20 4966 2070 6f73 7369 626c 652c 2069 * If possible, i │ │ │ │ +0003fd90: 7420 6973 2067 656e 6572 616c 6c79 2062 t is generally b │ │ │ │ +0003fda0: 6573 7420 746f 2061 766f 6964 2069 6e73 est to avoid ins │ │ │ │ +0003fdb0: 7461 6c6c 696e 6720 4752 5542 2074 6f20 talling GRUB to │ │ │ │ +0003fdc0: 610a 2020 2020 2070 6172 7469 7469 6f6e a. partition │ │ │ │ +0003fdd0: 2028 756e 6c65 7373 2069 7420 6973 2061 (unless it is a │ │ │ │ +0003fde0: 2073 7065 6369 616c 2070 6172 7469 7469 special partiti │ │ │ │ +0003fdf0: 6f6e 2066 6f72 2074 6865 2075 7365 206f on for the use o │ │ │ │ +0003fe00: 6620 4752 5542 0a20 2020 2020 616c 6f6e f GRUB. alon │ │ │ │ +0003fe10: 652c 2073 7563 6820 6173 2074 6865 2042 e, such as the B │ │ │ │ +0003fe20: 494f 5320 426f 6f74 2050 6172 7469 7469 IOS Boot Partiti │ │ │ │ +0003fe30: 6f6e 2075 7365 6420 6f6e 2047 5054 292e on used on GPT). │ │ │ │ +0003fe40: 2044 6f69 6e67 2074 6869 730a 2020 2020 Doing this. │ │ │ │ +0003fe50: 206d 6561 6e73 2074 6861 7420 4752 5542 means that GRUB │ │ │ │ +0003fe60: 206d 6179 2073 746f 7020 6265 696e 6720 may stop being │ │ │ │ +0003fe70: 6162 6c65 2074 6f20 7265 6164 2069 7473 able to read its │ │ │ │ +0003fe80: 2063 6f72 6520 696d 6167 6520 6475 6520 core image due │ │ │ │ +0003fe90: 746f 2061 0a20 2020 2020 6669 6c65 2073 to a. file s │ │ │ │ +0003fea0: 7973 7465 6d20 6d6f 7669 6e67 2062 6c6f ystem moving blo │ │ │ │ +0003feb0: 636b 7320 6172 6f75 6e64 2c20 7375 6368 cks around, such │ │ │ │ +0003fec0: 2061 7320 7768 696c 6520 6465 6672 6167 as while defrag │ │ │ │ +0003fed0: 6d65 6e74 696e 672c 0a20 2020 2020 7275 menting,. ru │ │ │ │ +0003fee0: 6e6e 696e 6720 6368 6563 6b73 2c20 6f72 nning checks, or │ │ │ │ +0003fef0: 2065 7665 6e20 6475 7269 6e67 206e 6f72 even during nor │ │ │ │ +0003ff00: 6d61 6c20 6f70 6572 6174 696f 6e2e 2020 mal operation. │ │ │ │ +0003ff10: 496e 7374 616c 6c69 6e67 2074 6f20 7468 Installing to th │ │ │ │ +0003ff20: 650a 2020 2020 2077 686f 6c65 2064 6973 e. whole dis │ │ │ │ +0003ff30: 6b20 6465 7669 6365 2069 7320 6e6f 726d k device is norm │ │ │ │ +0003ff40: 616c 6c79 206d 6f72 6520 726f 6275 7374 ally more robust │ │ │ │ +0003ff50: 2e0a 0a20 2020 2a20 4368 6563 6b20 7468 ... * Check th │ │ │ │ +0003ff60: 6174 2047 5255 4220 6163 7475 616c 6c79 at GRUB actually │ │ │ │ +0003ff70: 206b 6e6f 7773 2068 6f77 2074 6f20 7265 knows how to re │ │ │ │ +0003ff80: 6164 2066 726f 6d20 7468 6520 6465 7669 ad from the devi │ │ │ │ +0003ff90: 6365 2061 6e64 2066 696c 650a 2020 2020 ce and file. │ │ │ │ +0003ffa0: 2073 7973 7465 6d20 636f 6e74 6169 6e69 system containi │ │ │ │ +0003ffb0: 6e67 2027 2f62 6f6f 742f 6772 7562 272e ng '/boot/grub'. │ │ │ │ +0003ffc0: 2020 4974 2077 696c 6c20 6e6f 7420 6265 It will not be │ │ │ │ +0003ffd0: 2061 626c 6520 746f 2072 6561 6420 6672 able to read fr │ │ │ │ +0003ffe0: 6f6d 0a20 2020 2020 656e 6372 7970 7465 om. encrypte │ │ │ │ +0003fff0: 6420 6465 7669 6365 7320 7769 7468 2075 d devices with u │ │ │ │ +00040000: 6e73 7570 706f 7274 6564 2065 6e63 7279 nsupported encry │ │ │ │ +00040010: 7074 696f 6e20 7363 6865 6d65 2c20 6e6f ption scheme, no │ │ │ │ +00040020: 7220 6672 6f6d 2066 696c 650a 2020 2020 r from file. │ │ │ │ +00040030: 2073 7973 7465 6d73 2066 6f72 2077 6869 systems for whi │ │ │ │ +00040040: 6368 2073 7570 706f 7274 2068 6173 206e ch support has n │ │ │ │ +00040050: 6f74 2079 6574 2062 6565 6e20 6164 6465 ot yet been adde │ │ │ │ +00040060: 6420 746f 2047 5255 422e 0a0a 1f0a 4669 d to GRUB.....Fi │ │ │ │ +00040070: 6c65 3a20 6772 7562 2e69 6e66 6f2c 2020 le: grub.info, │ │ │ │ +00040080: 4e6f 6465 3a20 4669 726d 7761 7265 2073 Node: Firmware s │ │ │ │ +00040090: 7461 6c6c 7320 696e 7374 6561 6420 6f66 talls instead of │ │ │ │ +000400a0: 2062 6f6f 7469 6e67 2047 5255 422c 2020 booting GRUB, │ │ │ │ +000400b0: 5072 6576 3a20 4752 5542 206f 6e6c 7920 Prev: GRUB only │ │ │ │ +000400c0: 6f66 6665 7273 2061 2072 6573 6375 6520 offers a rescue │ │ │ │ +000400d0: 7368 656c 6c2c 2020 5570 3a20 5472 6f75 shell, Up: Trou │ │ │ │ +000400e0: 626c 6573 686f 6f74 696e 670a 0a32 322e bleshooting..22. │ │ │ │ +000400f0: 3220 4669 726d 7761 7265 2073 7461 6c6c 2 Firmware stall │ │ │ │ +00040100: 7320 696e 7374 6561 6420 6f66 2062 6f6f s instead of boo │ │ │ │ +00040110: 7469 6e67 2047 5255 420a 3d3d 3d3d 3d3d ting GRUB.====== │ │ │ │ 00040120: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ 00040130: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ -00040140: 3d3d 0a0a 5468 6520 4546 4920 696d 706c ==..The EFI impl │ │ │ │ -00040150: 656d 656e 7461 7469 6f6e 206f 6620 736f ementation of so │ │ │ │ -00040160: 6d65 206f 6c64 6572 204d 6163 426f 6f6b me older MacBook │ │ │ │ -00040170: 206c 6170 746f 7073 2073 7461 6c6c 7320 laptops stalls │ │ │ │ -00040180: 7768 656e 2069 7420 6765 7473 0a70 7265 when it gets.pre │ │ │ │ -00040190: 7365 6e74 6564 2061 2067 7275 622d 6d6b sented a grub-mk │ │ │ │ -000401a0: 7265 7363 7565 2049 534f 2069 6d61 6765 rescue ISO image │ │ │ │ -000401b0: 2066 6f72 2078 3836 5f36 342d 6566 6920 for x86_64-efi │ │ │ │ -000401c0: 7461 7267 6574 206f 6e20 616e 2055 5342 target on an USB │ │ │ │ -000401d0: 0a73 7469 636b 2e20 2041 6666 6563 7465 .stick. Affecte │ │ │ │ -000401e0: 6420 6172 6520 6d6f 6465 6c73 206f 6620 d are models of │ │ │ │ -000401f0: 7965 6172 2032 3031 3020 6f72 2065 6172 year 2010 or ear │ │ │ │ -00040200: 6c69 6572 2e20 2057 6f72 6b61 726f 756e lier. Workaroun │ │ │ │ -00040210: 6420 6973 2074 6f0a 7a65 726f 697a 6520 d is to.zeroize │ │ │ │ -00040220: 7468 6520 6279 7465 7320 3434 3620 746f the bytes 446 to │ │ │ │ -00040230: 2034 3631 206f 6620 7468 6520 4546 4920 461 of the EFI │ │ │ │ -00040240: 7061 7274 6974 696f 6e2c 2077 6865 7265 partition, where │ │ │ │ -00040250: 206d 666f 726d 6174 2068 6173 2070 7574 mformat has put │ │ │ │ -00040260: 0a61 2070 6172 7469 7469 6f6e 2074 6162 .a partition tab │ │ │ │ -00040270: 6c65 2065 6e74 7279 2077 6869 6368 2063 le entry which c │ │ │ │ -00040280: 6c61 696d 7320 7061 7274 6974 696f 6e20 laims partition │ │ │ │ -00040290: 7374 6172 7420 6174 2062 6c6f 636b 2030 start at block 0 │ │ │ │ -000402a0: 2e20 2054 6869 730a 6368 616e 6765 2077 . This.change w │ │ │ │ -000402b0: 696c 6c20 6e6f 7420 6861 6d70 6572 2062 ill not hamper b │ │ │ │ -000402c0: 6f6f 7461 6269 6c69 7479 206f 6e20 6f74 ootability on ot │ │ │ │ -000402d0: 6865 7220 6d61 6368 696e 6573 2e0a 0a1f her machines.... │ │ │ │ -000402e0: 0a46 696c 653a 2067 7275 622e 696e 666f .File: grub.info │ │ │ │ -000402f0: 2c20 204e 6f64 653a 2049 6e76 6f6b 696e , Node: Invokin │ │ │ │ -00040300: 6720 6772 7562 2d69 6e73 7461 6c6c 2c20 g grub-install, │ │ │ │ -00040310: 204e 6578 743a 2049 6e76 6f6b 696e 6720 Next: Invoking │ │ │ │ -00040320: 6772 7562 2d6d 6b63 6f6e 6669 672c 2020 grub-mkconfig, │ │ │ │ -00040330: 5072 6576 3a20 5472 6f75 626c 6573 686f Prev: Troublesho │ │ │ │ -00040340: 6f74 696e 672c 2020 5570 3a20 546f 700a oting, Up: Top. │ │ │ │ -00040350: 0a32 3320 496e 766f 6b69 6e67 2067 7275 .23 Invoking gru │ │ │ │ -00040360: 622d 696e 7374 616c 6c0a 2a2a 2a2a 2a2a b-install.****** │ │ │ │ +00040140: 3d3d 3d3d 3d3d 0a0a 5468 6520 4546 4920 ======..The EFI │ │ │ │ +00040150: 696d 706c 656d 656e 7461 7469 6f6e 206f implementation o │ │ │ │ +00040160: 6620 736f 6d65 206f 6c64 6572 204d 6163 f some older Mac │ │ │ │ +00040170: 426f 6f6b 206c 6170 746f 7073 2073 7461 Book laptops sta │ │ │ │ +00040180: 6c6c 7320 7768 656e 2069 7420 6765 7473 lls when it gets │ │ │ │ +00040190: 0a70 7265 7365 6e74 6564 2061 2067 7275 .presented a gru │ │ │ │ +000401a0: 622d 6d6b 7265 7363 7565 2049 534f 2069 b-mkrescue ISO i │ │ │ │ +000401b0: 6d61 6765 2066 6f72 2078 3836 5f36 342d mage for x86_64- │ │ │ │ +000401c0: 6566 6920 7461 7267 6574 206f 6e20 616e efi target on an │ │ │ │ +000401d0: 2055 5342 0a73 7469 636b 2e20 2041 6666 USB.stick. Aff │ │ │ │ +000401e0: 6563 7465 6420 6172 6520 6d6f 6465 6c73 ected are models │ │ │ │ +000401f0: 206f 6620 7965 6172 2032 3031 3020 6f72 of year 2010 or │ │ │ │ +00040200: 2065 6172 6c69 6572 2e20 2057 6f72 6b61 earlier. Worka │ │ │ │ +00040210: 726f 756e 6420 6973 2074 6f0a 7a65 726f round is to.zero │ │ │ │ +00040220: 697a 6520 7468 6520 6279 7465 7320 3434 ize the bytes 44 │ │ │ │ +00040230: 3620 746f 2034 3631 206f 6620 7468 6520 6 to 461 of the │ │ │ │ +00040240: 4546 4920 7061 7274 6974 696f 6e2c 2077 EFI partition, w │ │ │ │ +00040250: 6865 7265 206d 666f 726d 6174 2068 6173 here mformat has │ │ │ │ +00040260: 2070 7574 0a61 2070 6172 7469 7469 6f6e put.a partition │ │ │ │ +00040270: 2074 6162 6c65 2065 6e74 7279 2077 6869 table entry whi │ │ │ │ +00040280: 6368 2063 6c61 696d 7320 7061 7274 6974 ch claims partit │ │ │ │ +00040290: 696f 6e20 7374 6172 7420 6174 2062 6c6f ion start at blo │ │ │ │ +000402a0: 636b 2030 2e20 2054 6869 730a 6368 616e ck 0. This.chan │ │ │ │ +000402b0: 6765 2077 696c 6c20 6e6f 7420 6861 6d70 ge will not hamp │ │ │ │ +000402c0: 6572 2062 6f6f 7461 6269 6c69 7479 206f er bootability o │ │ │ │ +000402d0: 6e20 6f74 6865 7220 6d61 6368 696e 6573 n other machines │ │ │ │ +000402e0: 2e0a 0a1f 0a46 696c 653a 2067 7275 622e .....File: grub. │ │ │ │ +000402f0: 696e 666f 2c20 204e 6f64 653a 2049 6e76 info, Node: Inv │ │ │ │ +00040300: 6f6b 696e 6720 6772 7562 2d69 6e73 7461 oking grub-insta │ │ │ │ +00040310: 6c6c 2c20 204e 6578 743a 2049 6e76 6f6b ll, Next: Invok │ │ │ │ +00040320: 696e 6720 6772 7562 2d6d 6b63 6f6e 6669 ing grub-mkconfi │ │ │ │ +00040330: 672c 2020 5072 6576 3a20 5472 6f75 626c g, Prev: Troubl │ │ │ │ +00040340: 6573 686f 6f74 696e 672c 2020 5570 3a20 eshooting, Up: │ │ │ │ +00040350: 546f 700a 0a32 3320 496e 766f 6b69 6e67 Top..23 Invoking │ │ │ │ +00040360: 2067 7275 622d 696e 7374 616c 6c0a 2a2a grub-install.** │ │ │ │ 00040370: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ -00040380: 2a2a 0a0a 5468 6520 7072 6f67 7261 6d20 **..The program │ │ │ │ -00040390: 2767 7275 622d 696e 7374 616c 6c27 2067 'grub-install' g │ │ │ │ -000403a0: 656e 6572 6174 6573 2061 2047 5255 4220 enerates a GRUB │ │ │ │ -000403b0: 636f 7265 2069 6d61 6765 2075 7369 6e67 core image using │ │ │ │ -000403c0: 0a27 6772 7562 2d6d 6b69 6d61 6765 2720 .'grub-mkimage' │ │ │ │ -000403d0: 616e 6420 696e 7374 616c 6c73 2069 7420 and installs it │ │ │ │ -000403e0: 6f6e 2079 6f75 7220 7379 7374 656d 2e20 on your system. │ │ │ │ -000403f0: 2059 6f75 206d 7573 7420 7370 6563 6966 You must specif │ │ │ │ -00040400: 7920 7468 650a 6465 7669 6365 206e 616d y the.device nam │ │ │ │ -00040410: 6520 6f6e 2077 6869 6368 2079 6f75 2077 e on which you w │ │ │ │ -00040420: 616e 7420 746f 2069 6e73 7461 6c6c 2047 ant to install G │ │ │ │ -00040430: 5255 422c 206c 696b 6520 7468 6973 3a0a RUB, like this:. │ │ │ │ -00040440: 0a20 2020 2020 6772 7562 2d69 6e73 7461 . grub-insta │ │ │ │ -00040450: 6c6c 2049 4e53 5441 4c4c 5f44 4556 4943 ll INSTALL_DEVIC │ │ │ │ -00040460: 450a 0a20 2020 5468 6520 6465 7669 6365 E.. The device │ │ │ │ -00040470: 206e 616d 6520 494e 5354 414c 4c5f 4445 name INSTALL_DE │ │ │ │ -00040480: 5649 4345 2069 7320 616e 204f 5320 6465 VICE is an OS de │ │ │ │ -00040490: 7669 6365 206e 616d 6520 6f72 2061 2047 vice name or a G │ │ │ │ -000404a0: 5255 4220 6465 7669 6365 0a6e 616d 652e RUB device.name. │ │ │ │ -000404b0: 0a0a 2020 2027 6772 7562 2d69 6e73 7461 .. 'grub-insta │ │ │ │ -000404c0: 6c6c 2720 6163 6365 7074 7320 7468 6520 ll' accepts the │ │ │ │ -000404d0: 666f 6c6c 6f77 696e 6720 6f70 7469 6f6e following option │ │ │ │ -000404e0: 733a 0a0a 272d 2d68 656c 7027 0a20 2020 s:..'--help'. │ │ │ │ -000404f0: 2020 5072 696e 7420 6120 7375 6d6d 6172 Print a summar │ │ │ │ -00040500: 7920 6f66 2074 6865 2063 6f6d 6d61 6e64 y of the command │ │ │ │ -00040510: 2d6c 696e 6520 6f70 7469 6f6e 7320 616e -line options an │ │ │ │ -00040520: 6420 6578 6974 2e0a 0a27 2d2d 7665 7273 d exit...'--vers │ │ │ │ -00040530: 696f 6e27 0a20 2020 2020 5072 696e 7420 ion'. Print │ │ │ │ -00040540: 7468 6520 7665 7273 696f 6e20 6e75 6d62 the version numb │ │ │ │ -00040550: 6572 206f 6620 4752 5542 2061 6e64 2065 er of GRUB and e │ │ │ │ -00040560: 7869 742e 0a0a 272d 2d62 6f6f 742d 6469 xit...'--boot-di │ │ │ │ -00040570: 7265 6374 6f72 793d 4449 5227 0a20 2020 rectory=DIR'. │ │ │ │ -00040580: 2020 496e 7374 616c 6c20 4752 5542 2069 Install GRUB i │ │ │ │ -00040590: 6d61 6765 7320 756e 6465 7220 7468 6520 mages under the │ │ │ │ -000405a0: 6469 7265 6374 6f72 7920 2744 4952 2f67 directory 'DIR/g │ │ │ │ -000405b0: 7275 622f 2720 5468 6973 206f 7074 696f rub/' This optio │ │ │ │ -000405c0: 6e20 6973 0a20 2020 2020 7573 6566 756c n is. useful │ │ │ │ -000405d0: 2077 6865 6e20 796f 7520 7761 6e74 2074 when you want t │ │ │ │ -000405e0: 6f20 696e 7374 616c 6c20 4752 5542 2069 o install GRUB i │ │ │ │ -000405f0: 6e74 6f20 6120 7365 7061 7261 7465 2070 nto a separate p │ │ │ │ -00040600: 6172 7469 7469 6f6e 206f 7220 610a 2020 artition or a. │ │ │ │ -00040610: 2020 2072 656d 6f76 6162 6c65 2064 6973 removable dis │ │ │ │ -00040620: 6b2e 2020 4966 2074 6869 7320 6f70 7469 k. If this opti │ │ │ │ -00040630: 6f6e 2069 7320 6e6f 7420 7370 6563 6966 on is not specif │ │ │ │ -00040640: 6965 6420 7468 656e 2069 7420 6465 6661 ied then it defa │ │ │ │ -00040650: 756c 7473 0a20 2020 2020 746f 2027 2f62 ults. to '/b │ │ │ │ -00040660: 6f6f 7427 2c20 736f 0a0a 2020 2020 2020 oot', so.. │ │ │ │ -00040670: 2020 2020 6772 7562 2d69 6e73 7461 6c6c grub-install │ │ │ │ -00040680: 202f 6465 762f 7364 610a 0a20 2020 2020 /dev/sda.. │ │ │ │ -00040690: 6973 2065 7175 6976 616c 656e 7420 746f is equivalent to │ │ │ │ -000406a0: 0a0a 2020 2020 2020 2020 2020 6772 7562 .. grub │ │ │ │ -000406b0: 2d69 6e73 7461 6c6c 202d 2d62 6f6f 742d -install --boot- │ │ │ │ -000406c0: 6469 7265 6374 6f72 793d 2f62 6f6f 742f directory=/boot/ │ │ │ │ -000406d0: 202f 6465 762f 7364 610a 0a20 2020 2020 /dev/sda.. │ │ │ │ -000406e0: 4865 7265 2069 7320 616e 2065 7861 6d70 Here is an examp │ │ │ │ -000406f0: 6c65 2069 6e20 7768 6963 6820 796f 7520 le in which you │ │ │ │ -00040700: 6861 7665 2061 2073 6570 6172 6174 6520 have a separate │ │ │ │ -00040710: 2262 6f6f 7422 2070 6172 7469 7469 6f6e "boot" partition │ │ │ │ -00040720: 0a20 2020 2020 7768 6963 6820 6973 206d . which is m │ │ │ │ -00040730: 6f75 6e74 6564 206f 6e20 272f 6d6e 742f ounted on '/mnt/ │ │ │ │ -00040740: 626f 6f74 273a 0a0a 2020 2020 2020 2020 boot':.. │ │ │ │ -00040750: 2020 6772 7562 2d69 6e73 7461 6c6c 202d grub-install - │ │ │ │ -00040760: 2d62 6f6f 742d 6469 7265 6374 6f72 793d -boot-directory= │ │ │ │ -00040770: 2f6d 6e74 2f62 6f6f 7420 2f64 6576 2f73 /mnt/boot /dev/s │ │ │ │ -00040780: 6462 0a0a 272d 2d72 6563 6865 636b 270a db..'--recheck'. │ │ │ │ -00040790: 2020 2020 2052 6563 6865 636b 2074 6865 Recheck the │ │ │ │ -000407a0: 2064 6576 6963 6520 6d61 702c 2065 7665 device map, eve │ │ │ │ -000407b0: 6e20 6966 2027 2f62 6f6f 742f 6772 7562 n if '/boot/grub │ │ │ │ -000407c0: 2f64 6576 6963 652e 6d61 7027 2061 6c72 /device.map' alr │ │ │ │ -000407d0: 6561 6479 0a20 2020 2020 6578 6973 7473 eady. exists │ │ │ │ -000407e0: 2e20 2059 6f75 2073 686f 756c 6420 7573 . You should us │ │ │ │ -000407f0: 6520 7468 6973 206f 7074 696f 6e20 7768 e this option wh │ │ │ │ -00040800: 656e 6576 6572 2079 6f75 2061 6464 2f72 enever you add/r │ │ │ │ -00040810: 656d 6f76 6520 6120 6469 736b 0a20 2020 emove a disk. │ │ │ │ -00040820: 2020 696e 746f 2f66 726f 6d20 796f 7572 into/from your │ │ │ │ -00040830: 2063 6f6d 7075 7465 722e 0a0a 272d 2d6e computer...'--n │ │ │ │ -00040840: 6f2d 7273 2d63 6f64 6573 270a 2020 2020 o-rs-codes'. │ │ │ │ -00040850: 2042 7920 6465 6661 756c 7420 6f6e 2078 By default on x │ │ │ │ -00040860: 3836 2042 494f 5320 7379 7374 656d 732c 86 BIOS systems, │ │ │ │ -00040870: 2027 6772 7562 2d69 6e73 7461 6c6c 2720 'grub-install' │ │ │ │ -00040880: 7769 6c6c 2075 7365 2073 6f6d 6520 6578 will use some ex │ │ │ │ -00040890: 7472 610a 2020 2020 2073 7061 6365 2069 tra. space i │ │ │ │ -000408a0: 6e20 7468 6520 626f 6f74 6c6f 6164 6572 n the bootloader │ │ │ │ -000408b0: 2065 6d62 6564 6469 6e67 2061 7265 6120 embedding area │ │ │ │ -000408c0: 666f 7220 5265 6564 2d53 6f6c 6f6d 6f6e for Reed-Solomon │ │ │ │ -000408d0: 0a20 2020 2020 6572 726f 722d 636f 7272 . error-corr │ │ │ │ -000408e0: 6563 7469 6e67 2063 6f64 6573 2e20 2054 ecting codes. T │ │ │ │ -000408f0: 6869 7320 656e 6162 6c65 7320 4752 5542 his enables GRUB │ │ │ │ -00040900: 2074 6f20 7374 696c 6c20 626f 6f74 0a20 to still boot. │ │ │ │ -00040910: 2020 2020 7375 6363 6573 7366 756c 6c79 successfully │ │ │ │ -00040920: 2069 6620 736f 6d65 2062 6c6f 636b 7320 if some blocks │ │ │ │ -00040930: 6172 6520 636f 7272 7570 7465 642e 2020 are corrupted. │ │ │ │ -00040940: 5468 6520 6578 6163 7420 616d 6f75 6e74 The exact amount │ │ │ │ -00040950: 206f 660a 2020 2020 2070 726f 7465 6374 of. protect │ │ │ │ -00040960: 696f 6e20 6f66 6665 7265 6420 6973 2064 ion offered is d │ │ │ │ -00040970: 6570 656e 6465 6e74 206f 6e20 6176 6169 ependent on avai │ │ │ │ -00040980: 6c61 626c 6520 7370 6163 6520 696e 2074 lable space in t │ │ │ │ -00040990: 6865 2065 6d62 6564 6469 6e67 0a20 2020 he embedding. │ │ │ │ -000409a0: 2020 6172 6561 2e20 2052 2073 6563 746f area. R secto │ │ │ │ -000409b0: 7273 206f 6620 7265 6475 6e64 616e 6379 rs of redundancy │ │ │ │ -000409c0: 2063 616e 2074 6f6c 6572 6174 6520 7570 can tolerate up │ │ │ │ -000409d0: 2074 6f20 522f 3220 636f 7272 7570 7465 to R/2 corrupte │ │ │ │ -000409e0: 640a 2020 2020 2073 6563 746f 7273 2e20 d. sectors. │ │ │ │ -000409f0: 2054 6869 7320 7265 6475 6e64 616e 6379 This redundancy │ │ │ │ -00040a00: 206d 6179 2062 6520 6375 6d62 6572 736f may be cumberso │ │ │ │ -00040a10: 6d65 2069 6620 6174 7465 6d70 7469 6e67 me if attempting │ │ │ │ -00040a20: 2074 6f0a 2020 2020 2063 7279 7074 6f67 to. cryptog │ │ │ │ -00040a30: 7261 7068 6963 616c 6c79 2076 616c 6964 raphically valid │ │ │ │ -00040a40: 6174 6520 7468 6520 636f 6e74 656e 7473 ate the contents │ │ │ │ -00040a50: 206f 6620 7468 6520 626f 6f74 6c6f 6164 of the bootload │ │ │ │ -00040a60: 6572 2065 6d62 6564 6469 6e67 0a20 2020 er embedding. │ │ │ │ -00040a70: 2020 6172 6561 2c20 6f72 2069 6e20 6d6f area, or in mo │ │ │ │ -00040a80: 7265 206d 6f64 6572 6e20 7379 7374 656d re modern system │ │ │ │ -00040a90: 7320 7769 7468 2047 5054 2d73 7479 6c65 s with GPT-style │ │ │ │ -00040aa0: 2070 6172 7469 7469 6f6e 2074 6162 6c65 partition table │ │ │ │ -00040ab0: 730a 2020 2020 2028 2a6e 6f74 6520 4249 s. (*note BI │ │ │ │ -00040ac0: 4f53 2069 6e73 7461 6c6c 6174 696f 6e3a OS installation: │ │ │ │ -00040ad0: 3a29 2077 6865 7265 2047 5255 4220 646f :) where GRUB do │ │ │ │ -00040ae0: 6573 206e 6f74 2072 6573 6964 6520 696e es not reside in │ │ │ │ -00040af0: 2061 6e79 0a20 2020 2020 756e 7061 7274 any. unpart │ │ │ │ -00040b00: 6974 696f 6e65 6420 7370 6163 6520 6f75 itioned space ou │ │ │ │ -00040b10: 7473 6964 6520 6f66 2074 6865 204d 4252 tside of the MBR │ │ │ │ -00040b20: 2e20 4469 7361 626c 6520 7468 6520 5265 . Disable the Re │ │ │ │ -00040b30: 6564 2d53 6f6c 6f6d 6f6e 0a20 2020 2020 ed-Solomon. │ │ │ │ -00040b40: 636f 6465 7320 7769 7468 2074 6869 7320 codes with this │ │ │ │ -00040b50: 6f70 7469 6f6e 2e0a 0a1f 0a46 696c 653a option.....File: │ │ │ │ -00040b60: 2067 7275 622e 696e 666f 2c20 204e 6f64 grub.info, Nod │ │ │ │ -00040b70: 653a 2049 6e76 6f6b 696e 6720 6772 7562 e: Invoking grub │ │ │ │ -00040b80: 2d6d 6b63 6f6e 6669 672c 2020 4e65 7874 -mkconfig, Next │ │ │ │ -00040b90: 3a20 496e 766f 6b69 6e67 2067 7275 622d : Invoking grub- │ │ │ │ -00040ba0: 6d6b 7061 7373 7764 2d70 626b 6466 322c mkpasswd-pbkdf2, │ │ │ │ -00040bb0: 2020 5072 6576 3a20 496e 766f 6b69 6e67 Prev: Invoking │ │ │ │ -00040bc0: 2067 7275 622d 696e 7374 616c 6c2c 2020 grub-install, │ │ │ │ -00040bd0: 5570 3a20 546f 700a 0a32 3420 496e 766f Up: Top..24 Invo │ │ │ │ -00040be0: 6b69 6e67 2067 7275 622d 6d6b 636f 6e66 king grub-mkconf │ │ │ │ -00040bf0: 6967 0a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a ig.************* │ │ │ │ -00040c00: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 0a0a 5468 ************..Th │ │ │ │ -00040c10: 6520 7072 6f67 7261 6d20 2767 7275 622d e program 'grub- │ │ │ │ -00040c20: 6d6b 636f 6e66 6967 2720 6765 6e65 7261 mkconfig' genera │ │ │ │ -00040c30: 7465 7320 6120 636f 6e66 6967 7572 6174 tes a configurat │ │ │ │ -00040c40: 696f 6e20 6669 6c65 2066 6f72 2047 5255 ion file for GRU │ │ │ │ -00040c50: 420a 282a 6e6f 7465 2053 696d 706c 6520 B.(*note Simple │ │ │ │ -00040c60: 636f 6e66 6967 7572 6174 696f 6e3a 3a29 configuration::) │ │ │ │ -00040c70: 2e0a 0a20 2020 2020 6772 7562 2d6d 6b63 ... grub-mkc │ │ │ │ -00040c80: 6f6e 6669 6720 2d6f 202f 626f 6f74 2f67 onfig -o /boot/g │ │ │ │ -00040c90: 7275 622f 6772 7562 2e63 6667 0a0a 2020 rub/grub.cfg.. │ │ │ │ -00040ca0: 2027 6772 7562 2d6d 6b63 6f6e 6669 6727 'grub-mkconfig' │ │ │ │ -00040cb0: 2061 6363 6570 7473 2074 6865 2066 6f6c accepts the fol │ │ │ │ -00040cc0: 6c6f 7769 6e67 206f 7074 696f 6e73 3a0a lowing options:. │ │ │ │ -00040cd0: 0a27 2d2d 6865 6c70 270a 2020 2020 2050 .'--help'. P │ │ │ │ -00040ce0: 7269 6e74 2061 2073 756d 6d61 7279 206f rint a summary o │ │ │ │ -00040cf0: 6620 7468 6520 636f 6d6d 616e 642d 6c69 f the command-li │ │ │ │ -00040d00: 6e65 206f 7074 696f 6e73 2061 6e64 2065 ne options and e │ │ │ │ -00040d10: 7869 742e 0a0a 272d 2d76 6572 7369 6f6e xit...'--version │ │ │ │ -00040d20: 270a 2020 2020 2050 7269 6e74 2074 6865 '. Print the │ │ │ │ -00040d30: 2076 6572 7369 6f6e 206e 756d 6265 7220 version number │ │ │ │ -00040d40: 6f66 2047 5255 4220 616e 6420 6578 6974 of GRUB and exit │ │ │ │ -00040d50: 2e0a 0a27 2d6f 2046 494c 4527 0a27 2d2d ...'-o FILE'.'-- │ │ │ │ -00040d60: 6f75 7470 7574 3d46 494c 4527 0a20 2020 output=FILE'. │ │ │ │ -00040d70: 2020 5365 6e64 2074 6865 2067 656e 6572 Send the gener │ │ │ │ -00040d80: 6174 6564 2063 6f6e 6669 6775 7261 7469 ated configurati │ │ │ │ -00040d90: 6f6e 2066 696c 6520 746f 2046 494c 452e on file to FILE. │ │ │ │ -00040da0: 2020 5468 6520 6465 6661 756c 7420 6973 The default is │ │ │ │ -00040db0: 2074 6f0a 2020 2020 2073 656e 6420 6974 to. send it │ │ │ │ -00040dc0: 2074 6f20 7374 616e 6461 7264 206f 7574 to standard out │ │ │ │ -00040dd0: 7075 742e 0a0a 1f0a 4669 6c65 3a20 6772 put.....File: gr │ │ │ │ -00040de0: 7562 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ub.info, Node: │ │ │ │ -00040df0: 496e 766f 6b69 6e67 2067 7275 622d 6d6b Invoking grub-mk │ │ │ │ -00040e00: 7061 7373 7764 2d70 626b 6466 322c 2020 passwd-pbkdf2, │ │ │ │ -00040e10: 4e65 7874 3a20 496e 766f 6b69 6e67 2067 Next: Invoking g │ │ │ │ -00040e20: 7275 622d 6d6b 7265 6c70 6174 682c 2020 rub-mkrelpath, │ │ │ │ -00040e30: 5072 6576 3a20 496e 766f 6b69 6e67 2067 Prev: Invoking g │ │ │ │ -00040e40: 7275 622d 6d6b 636f 6e66 6967 2c20 2055 rub-mkconfig, U │ │ │ │ -00040e50: 703a 2054 6f70 0a0a 3235 2049 6e76 6f6b p: Top..25 Invok │ │ │ │ -00040e60: 696e 6720 6772 7562 2d6d 6b70 6173 7377 ing grub-mkpassw │ │ │ │ -00040e70: 642d 7062 6b64 6632 0a2a 2a2a 2a2a 2a2a d-pbkdf2.******* │ │ │ │ +00040380: 2a2a 2a2a 2a2a 0a0a 5468 6520 7072 6f67 ******..The prog │ │ │ │ +00040390: 7261 6d20 2767 7275 622d 696e 7374 616c ram 'grub-instal │ │ │ │ +000403a0: 6c27 2067 656e 6572 6174 6573 2061 2047 l' generates a G │ │ │ │ +000403b0: 5255 4220 636f 7265 2069 6d61 6765 2075 RUB core image u │ │ │ │ +000403c0: 7369 6e67 0a27 6772 7562 2d6d 6b69 6d61 sing.'grub-mkima │ │ │ │ +000403d0: 6765 2720 616e 6420 696e 7374 616c 6c73 ge' and installs │ │ │ │ +000403e0: 2069 7420 6f6e 2079 6f75 7220 7379 7374 it on your syst │ │ │ │ +000403f0: 656d 2e20 2059 6f75 206d 7573 7420 7370 em. You must sp │ │ │ │ +00040400: 6563 6966 7920 7468 650a 6465 7669 6365 ecify the.device │ │ │ │ +00040410: 206e 616d 6520 6f6e 2077 6869 6368 2079 name on which y │ │ │ │ +00040420: 6f75 2077 616e 7420 746f 2069 6e73 7461 ou want to insta │ │ │ │ +00040430: 6c6c 2047 5255 422c 206c 696b 6520 7468 ll GRUB, like th │ │ │ │ +00040440: 6973 3a0a 0a20 2020 2020 6772 7562 2d69 is:.. grub-i │ │ │ │ +00040450: 6e73 7461 6c6c 2049 4e53 5441 4c4c 5f44 nstall INSTALL_D │ │ │ │ +00040460: 4556 4943 450a 0a20 2020 5468 6520 6465 EVICE.. The de │ │ │ │ +00040470: 7669 6365 206e 616d 6520 494e 5354 414c vice name INSTAL │ │ │ │ +00040480: 4c5f 4445 5649 4345 2069 7320 616e 204f L_DEVICE is an O │ │ │ │ +00040490: 5320 6465 7669 6365 206e 616d 6520 6f72 S device name or │ │ │ │ +000404a0: 2061 2047 5255 4220 6465 7669 6365 0a6e a GRUB device.n │ │ │ │ +000404b0: 616d 652e 0a0a 2020 2027 6772 7562 2d69 ame... 'grub-i │ │ │ │ +000404c0: 6e73 7461 6c6c 2720 6163 6365 7074 7320 nstall' accepts │ │ │ │ +000404d0: 7468 6520 666f 6c6c 6f77 696e 6720 6f70 the following op │ │ │ │ +000404e0: 7469 6f6e 733a 0a0a 272d 2d68 656c 7027 tions:..'--help' │ │ │ │ +000404f0: 0a20 2020 2020 5072 696e 7420 6120 7375 . Print a su │ │ │ │ +00040500: 6d6d 6172 7920 6f66 2074 6865 2063 6f6d mmary of the com │ │ │ │ +00040510: 6d61 6e64 2d6c 696e 6520 6f70 7469 6f6e mand-line option │ │ │ │ +00040520: 7320 616e 6420 6578 6974 2e0a 0a27 2d2d s and exit...'-- │ │ │ │ +00040530: 7665 7273 696f 6e27 0a20 2020 2020 5072 version'. Pr │ │ │ │ +00040540: 696e 7420 7468 6520 7665 7273 696f 6e20 int the version │ │ │ │ +00040550: 6e75 6d62 6572 206f 6620 4752 5542 2061 number of GRUB a │ │ │ │ +00040560: 6e64 2065 7869 742e 0a0a 272d 2d62 6f6f nd exit...'--boo │ │ │ │ +00040570: 742d 6469 7265 6374 6f72 793d 4449 5227 t-directory=DIR' │ │ │ │ +00040580: 0a20 2020 2020 496e 7374 616c 6c20 4752 . Install GR │ │ │ │ +00040590: 5542 2069 6d61 6765 7320 756e 6465 7220 UB images under │ │ │ │ +000405a0: 7468 6520 6469 7265 6374 6f72 7920 2744 the directory 'D │ │ │ │ +000405b0: 4952 2f67 7275 622f 2720 5468 6973 206f IR/grub/' This o │ │ │ │ +000405c0: 7074 696f 6e20 6973 0a20 2020 2020 7573 ption is. us │ │ │ │ +000405d0: 6566 756c 2077 6865 6e20 796f 7520 7761 eful when you wa │ │ │ │ +000405e0: 6e74 2074 6f20 696e 7374 616c 6c20 4752 nt to install GR │ │ │ │ +000405f0: 5542 2069 6e74 6f20 6120 7365 7061 7261 UB into a separa │ │ │ │ +00040600: 7465 2070 6172 7469 7469 6f6e 206f 7220 te partition or │ │ │ │ +00040610: 610a 2020 2020 2072 656d 6f76 6162 6c65 a. removable │ │ │ │ +00040620: 2064 6973 6b2e 2020 4966 2074 6869 7320 disk. If this │ │ │ │ +00040630: 6f70 7469 6f6e 2069 7320 6e6f 7420 7370 option is not sp │ │ │ │ +00040640: 6563 6966 6965 6420 7468 656e 2069 7420 ecified then it │ │ │ │ +00040650: 6465 6661 756c 7473 0a20 2020 2020 746f defaults. to │ │ │ │ +00040660: 2027 2f62 6f6f 7427 2c20 736f 0a0a 2020 '/boot', so.. │ │ │ │ +00040670: 2020 2020 2020 2020 6772 7562 2d69 6e73 grub-ins │ │ │ │ +00040680: 7461 6c6c 202f 6465 762f 7364 610a 0a20 tall /dev/sda.. │ │ │ │ +00040690: 2020 2020 6973 2065 7175 6976 616c 656e is equivalen │ │ │ │ +000406a0: 7420 746f 0a0a 2020 2020 2020 2020 2020 t to.. │ │ │ │ +000406b0: 6772 7562 2d69 6e73 7461 6c6c 202d 2d62 grub-install --b │ │ │ │ +000406c0: 6f6f 742d 6469 7265 6374 6f72 793d 2f62 oot-directory=/b │ │ │ │ +000406d0: 6f6f 742f 202f 6465 762f 7364 610a 0a20 oot/ /dev/sda.. │ │ │ │ +000406e0: 2020 2020 4865 7265 2069 7320 616e 2065 Here is an e │ │ │ │ +000406f0: 7861 6d70 6c65 2069 6e20 7768 6963 6820 xample in which │ │ │ │ +00040700: 796f 7520 6861 7665 2061 2073 6570 6172 you have a separ │ │ │ │ +00040710: 6174 6520 2262 6f6f 7422 2070 6172 7469 ate "boot" parti │ │ │ │ +00040720: 7469 6f6e 0a20 2020 2020 7768 6963 6820 tion. which │ │ │ │ +00040730: 6973 206d 6f75 6e74 6564 206f 6e20 272f is mounted on '/ │ │ │ │ +00040740: 6d6e 742f 626f 6f74 273a 0a0a 2020 2020 mnt/boot':.. │ │ │ │ +00040750: 2020 2020 2020 6772 7562 2d69 6e73 7461 grub-insta │ │ │ │ +00040760: 6c6c 202d 2d62 6f6f 742d 6469 7265 6374 ll --boot-direct │ │ │ │ +00040770: 6f72 793d 2f6d 6e74 2f62 6f6f 7420 2f64 ory=/mnt/boot /d │ │ │ │ +00040780: 6576 2f73 6462 0a0a 272d 2d72 6563 6865 ev/sdb..'--reche │ │ │ │ +00040790: 636b 270a 2020 2020 2052 6563 6865 636b ck'. Recheck │ │ │ │ +000407a0: 2074 6865 2064 6576 6963 6520 6d61 702c the device map, │ │ │ │ +000407b0: 2065 7665 6e20 6966 2027 2f62 6f6f 742f even if '/boot/ │ │ │ │ +000407c0: 6772 7562 2f64 6576 6963 652e 6d61 7027 grub/device.map' │ │ │ │ +000407d0: 2061 6c72 6561 6479 0a20 2020 2020 6578 already. ex │ │ │ │ +000407e0: 6973 7473 2e20 2059 6f75 2073 686f 756c ists. You shoul │ │ │ │ +000407f0: 6420 7573 6520 7468 6973 206f 7074 696f d use this optio │ │ │ │ +00040800: 6e20 7768 656e 6576 6572 2079 6f75 2061 n whenever you a │ │ │ │ +00040810: 6464 2f72 656d 6f76 6520 6120 6469 736b dd/remove a disk │ │ │ │ +00040820: 0a20 2020 2020 696e 746f 2f66 726f 6d20 . into/from │ │ │ │ +00040830: 796f 7572 2063 6f6d 7075 7465 722e 0a0a your computer... │ │ │ │ +00040840: 272d 2d6e 6f2d 7273 2d63 6f64 6573 270a '--no-rs-codes'. │ │ │ │ +00040850: 2020 2020 2042 7920 6465 6661 756c 7420 By default │ │ │ │ +00040860: 6f6e 2078 3836 2042 494f 5320 7379 7374 on x86 BIOS syst │ │ │ │ +00040870: 656d 732c 2027 6772 7562 2d69 6e73 7461 ems, 'grub-insta │ │ │ │ +00040880: 6c6c 2720 7769 6c6c 2075 7365 2073 6f6d ll' will use som │ │ │ │ +00040890: 6520 6578 7472 610a 2020 2020 2073 7061 e extra. spa │ │ │ │ +000408a0: 6365 2069 6e20 7468 6520 626f 6f74 6c6f ce in the bootlo │ │ │ │ +000408b0: 6164 6572 2065 6d62 6564 6469 6e67 2061 ader embedding a │ │ │ │ +000408c0: 7265 6120 666f 7220 5265 6564 2d53 6f6c rea for Reed-Sol │ │ │ │ +000408d0: 6f6d 6f6e 0a20 2020 2020 6572 726f 722d omon. error- │ │ │ │ +000408e0: 636f 7272 6563 7469 6e67 2063 6f64 6573 correcting codes │ │ │ │ +000408f0: 2e20 2054 6869 7320 656e 6162 6c65 7320 . This enables │ │ │ │ +00040900: 4752 5542 2074 6f20 7374 696c 6c20 626f GRUB to still bo │ │ │ │ +00040910: 6f74 0a20 2020 2020 7375 6363 6573 7366 ot. successf │ │ │ │ +00040920: 756c 6c79 2069 6620 736f 6d65 2062 6c6f ully if some blo │ │ │ │ +00040930: 636b 7320 6172 6520 636f 7272 7570 7465 cks are corrupte │ │ │ │ +00040940: 642e 2020 5468 6520 6578 6163 7420 616d d. The exact am │ │ │ │ +00040950: 6f75 6e74 206f 660a 2020 2020 2070 726f ount of. pro │ │ │ │ +00040960: 7465 6374 696f 6e20 6f66 6665 7265 6420 tection offered │ │ │ │ +00040970: 6973 2064 6570 656e 6465 6e74 206f 6e20 is dependent on │ │ │ │ +00040980: 6176 6169 6c61 626c 6520 7370 6163 6520 available space │ │ │ │ +00040990: 696e 2074 6865 2065 6d62 6564 6469 6e67 in the embedding │ │ │ │ +000409a0: 0a20 2020 2020 6172 6561 2e20 2052 2073 . area. R s │ │ │ │ +000409b0: 6563 746f 7273 206f 6620 7265 6475 6e64 ectors of redund │ │ │ │ +000409c0: 616e 6379 2063 616e 2074 6f6c 6572 6174 ancy can tolerat │ │ │ │ +000409d0: 6520 7570 2074 6f20 522f 3220 636f 7272 e up to R/2 corr │ │ │ │ +000409e0: 7570 7465 640a 2020 2020 2073 6563 746f upted. secto │ │ │ │ +000409f0: 7273 2e20 2054 6869 7320 7265 6475 6e64 rs. This redund │ │ │ │ +00040a00: 616e 6379 206d 6179 2062 6520 6375 6d62 ancy may be cumb │ │ │ │ +00040a10: 6572 736f 6d65 2069 6620 6174 7465 6d70 ersome if attemp │ │ │ │ +00040a20: 7469 6e67 2074 6f0a 2020 2020 2063 7279 ting to. cry │ │ │ │ +00040a30: 7074 6f67 7261 7068 6963 616c 6c79 2076 ptographically v │ │ │ │ +00040a40: 616c 6964 6174 6520 7468 6520 636f 6e74 alidate the cont │ │ │ │ +00040a50: 656e 7473 206f 6620 7468 6520 626f 6f74 ents of the boot │ │ │ │ +00040a60: 6c6f 6164 6572 2065 6d62 6564 6469 6e67 loader embedding │ │ │ │ +00040a70: 0a20 2020 2020 6172 6561 2c20 6f72 2069 . area, or i │ │ │ │ +00040a80: 6e20 6d6f 7265 206d 6f64 6572 6e20 7379 n more modern sy │ │ │ │ +00040a90: 7374 656d 7320 7769 7468 2047 5054 2d73 stems with GPT-s │ │ │ │ +00040aa0: 7479 6c65 2070 6172 7469 7469 6f6e 2074 tyle partition t │ │ │ │ +00040ab0: 6162 6c65 730a 2020 2020 2028 2a6e 6f74 ables. (*not │ │ │ │ +00040ac0: 6520 4249 4f53 2069 6e73 7461 6c6c 6174 e BIOS installat │ │ │ │ +00040ad0: 696f 6e3a 3a29 2077 6865 7265 2047 5255 ion::) where GRU │ │ │ │ +00040ae0: 4220 646f 6573 206e 6f74 2072 6573 6964 B does not resid │ │ │ │ +00040af0: 6520 696e 2061 6e79 0a20 2020 2020 756e e in any. un │ │ │ │ +00040b00: 7061 7274 6974 696f 6e65 6420 7370 6163 partitioned spac │ │ │ │ +00040b10: 6520 6f75 7473 6964 6520 6f66 2074 6865 e outside of the │ │ │ │ +00040b20: 204d 4252 2e20 4469 7361 626c 6520 7468 MBR. Disable th │ │ │ │ +00040b30: 6520 5265 6564 2d53 6f6c 6f6d 6f6e 0a20 e Reed-Solomon. │ │ │ │ +00040b40: 2020 2020 636f 6465 7320 7769 7468 2074 codes with t │ │ │ │ +00040b50: 6869 7320 6f70 7469 6f6e 2e0a 0a1f 0a46 his option.....F │ │ │ │ +00040b60: 696c 653a 2067 7275 622e 696e 666f 2c20 ile: grub.info, │ │ │ │ +00040b70: 204e 6f64 653a 2049 6e76 6f6b 696e 6720 Node: Invoking │ │ │ │ +00040b80: 6772 7562 2d6d 6b63 6f6e 6669 672c 2020 grub-mkconfig, │ │ │ │ +00040b90: 4e65 7874 3a20 496e 766f 6b69 6e67 2067 Next: Invoking g │ │ │ │ +00040ba0: 7275 622d 6d6b 7061 7373 7764 2d70 626b rub-mkpasswd-pbk │ │ │ │ +00040bb0: 6466 322c 2020 5072 6576 3a20 496e 766f df2, Prev: Invo │ │ │ │ +00040bc0: 6b69 6e67 2067 7275 622d 696e 7374 616c king grub-instal │ │ │ │ +00040bd0: 6c2c 2020 5570 3a20 546f 700a 0a32 3420 l, Up: Top..24 │ │ │ │ +00040be0: 496e 766f 6b69 6e67 2067 7275 622d 6d6b Invoking grub-mk │ │ │ │ +00040bf0: 636f 6e66 6967 0a2a 2a2a 2a2a 2a2a 2a2a config.********* │ │ │ │ +00040c00: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ +00040c10: 0a0a 5468 6520 7072 6f67 7261 6d20 2767 ..The program 'g │ │ │ │ +00040c20: 7275 622d 6d6b 636f 6e66 6967 2720 6765 rub-mkconfig' ge │ │ │ │ +00040c30: 6e65 7261 7465 7320 6120 636f 6e66 6967 nerates a config │ │ │ │ +00040c40: 7572 6174 696f 6e20 6669 6c65 2066 6f72 uration file for │ │ │ │ +00040c50: 2047 5255 420a 282a 6e6f 7465 2053 696d GRUB.(*note Sim │ │ │ │ +00040c60: 706c 6520 636f 6e66 6967 7572 6174 696f ple configuratio │ │ │ │ +00040c70: 6e3a 3a29 2e0a 0a20 2020 2020 6772 7562 n::)... grub │ │ │ │ +00040c80: 2d6d 6b63 6f6e 6669 6720 2d6f 202f 626f -mkconfig -o /bo │ │ │ │ +00040c90: 6f74 2f67 7275 622f 6772 7562 2e63 6667 ot/grub/grub.cfg │ │ │ │ +00040ca0: 0a0a 2020 2027 6772 7562 2d6d 6b63 6f6e .. 'grub-mkcon │ │ │ │ +00040cb0: 6669 6727 2061 6363 6570 7473 2074 6865 fig' accepts the │ │ │ │ +00040cc0: 2066 6f6c 6c6f 7769 6e67 206f 7074 696f following optio │ │ │ │ +00040cd0: 6e73 3a0a 0a27 2d2d 6865 6c70 270a 2020 ns:..'--help'. │ │ │ │ +00040ce0: 2020 2050 7269 6e74 2061 2073 756d 6d61 Print a summa │ │ │ │ +00040cf0: 7279 206f 6620 7468 6520 636f 6d6d 616e ry of the comman │ │ │ │ +00040d00: 642d 6c69 6e65 206f 7074 696f 6e73 2061 d-line options a │ │ │ │ +00040d10: 6e64 2065 7869 742e 0a0a 272d 2d76 6572 nd exit...'--ver │ │ │ │ +00040d20: 7369 6f6e 270a 2020 2020 2050 7269 6e74 sion'. Print │ │ │ │ +00040d30: 2074 6865 2076 6572 7369 6f6e 206e 756d the version num │ │ │ │ +00040d40: 6265 7220 6f66 2047 5255 4220 616e 6420 ber of GRUB and │ │ │ │ +00040d50: 6578 6974 2e0a 0a27 2d6f 2046 494c 4527 exit...'-o FILE' │ │ │ │ +00040d60: 0a27 2d2d 6f75 7470 7574 3d46 494c 4527 .'--output=FILE' │ │ │ │ +00040d70: 0a20 2020 2020 5365 6e64 2074 6865 2067 . Send the g │ │ │ │ +00040d80: 656e 6572 6174 6564 2063 6f6e 6669 6775 enerated configu │ │ │ │ +00040d90: 7261 7469 6f6e 2066 696c 6520 746f 2046 ration file to F │ │ │ │ +00040da0: 494c 452e 2020 5468 6520 6465 6661 756c ILE. The defaul │ │ │ │ +00040db0: 7420 6973 2074 6f0a 2020 2020 2073 656e t is to. sen │ │ │ │ +00040dc0: 6420 6974 2074 6f20 7374 616e 6461 7264 d it to standard │ │ │ │ +00040dd0: 206f 7574 7075 742e 0a0a 1f0a 4669 6c65 output.....File │ │ │ │ +00040de0: 3a20 6772 7562 2e69 6e66 6f2c 2020 4e6f : grub.info, No │ │ │ │ +00040df0: 6465 3a20 496e 766f 6b69 6e67 2067 7275 de: Invoking gru │ │ │ │ +00040e00: 622d 6d6b 7061 7373 7764 2d70 626b 6466 b-mkpasswd-pbkdf │ │ │ │ +00040e10: 322c 2020 4e65 7874 3a20 496e 766f 6b69 2, Next: Invoki │ │ │ │ +00040e20: 6e67 2067 7275 622d 6d6b 7265 6c70 6174 ng grub-mkrelpat │ │ │ │ +00040e30: 682c 2020 5072 6576 3a20 496e 766f 6b69 h, Prev: Invoki │ │ │ │ +00040e40: 6e67 2067 7275 622d 6d6b 636f 6e66 6967 ng grub-mkconfig │ │ │ │ +00040e50: 2c20 2055 703a 2054 6f70 0a0a 3235 2049 , Up: Top..25 I │ │ │ │ +00040e60: 6e76 6f6b 696e 6720 6772 7562 2d6d 6b70 nvoking grub-mkp │ │ │ │ +00040e70: 6173 7377 642d 7062 6b64 6632 0a2a 2a2a asswd-pbkdf2.*** │ │ │ │ 00040e80: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ -00040e90: 2a2a 2a2a 2a2a 2a2a 2a0a 0a54 6865 2070 *********..The p │ │ │ │ -00040ea0: 726f 6772 616d 2027 6772 7562 2d6d 6b70 rogram 'grub-mkp │ │ │ │ -00040eb0: 6173 7377 642d 7062 6b64 6632 2720 6765 asswd-pbkdf2' ge │ │ │ │ -00040ec0: 6e65 7261 7465 7320 7061 7373 776f 7264 nerates password │ │ │ │ -00040ed0: 2068 6173 6865 7320 666f 7220 4752 5542 hashes for GRUB │ │ │ │ -00040ee0: 0a28 2a6e 6f74 6520 5365 6375 7269 7479 .(*note Security │ │ │ │ -00040ef0: 3a3a 292e 0a0a 2020 2020 2067 7275 622d ::)... grub- │ │ │ │ -00040f00: 6d6b 7061 7373 7764 2d70 626b 6466 320a mkpasswd-pbkdf2. │ │ │ │ -00040f10: 0a20 2020 2767 7275 622d 6d6b 7061 7373 . 'grub-mkpass │ │ │ │ -00040f20: 7764 2d70 626b 6466 3227 2061 6363 6570 wd-pbkdf2' accep │ │ │ │ -00040f30: 7473 2074 6865 2066 6f6c 6c6f 7769 6e67 ts the following │ │ │ │ -00040f40: 206f 7074 696f 6e73 3a0a 0a27 2d63 204e options:..'-c N │ │ │ │ -00040f50: 554d 4245 5227 0a27 2d2d 6974 6572 6174 UMBER'.'--iterat │ │ │ │ -00040f60: 696f 6e2d 636f 756e 743d 4e55 4d42 4552 ion-count=NUMBER │ │ │ │ -00040f70: 270a 2020 2020 204e 756d 6265 7220 6f66 '. Number of │ │ │ │ -00040f80: 2069 7465 7261 7469 6f6e 7320 6f66 2074 iterations of t │ │ │ │ -00040f90: 6865 2075 6e64 6572 6c79 696e 6720 7073 he underlying ps │ │ │ │ -00040fa0: 6575 646f 2d72 616e 646f 6d20 6675 6e63 eudo-random func │ │ │ │ -00040fb0: 7469 6f6e 2e0a 2020 2020 2044 6566 6175 tion.. Defau │ │ │ │ -00040fc0: 6c74 7320 746f 2031 3030 3030 2e0a 0a27 lts to 10000...' │ │ │ │ -00040fd0: 2d6c 204e 554d 4245 5227 0a27 2d2d 6275 -l NUMBER'.'--bu │ │ │ │ -00040fe0: 666c 656e 3d4e 554d 4245 5227 0a20 2020 flen=NUMBER'. │ │ │ │ -00040ff0: 2020 4c65 6e67 7468 206f 6620 7468 6520 Length of the │ │ │ │ -00041000: 6765 6e65 7261 7465 6420 6861 7368 2e20 generated hash. │ │ │ │ -00041010: 2044 6566 6175 6c74 7320 746f 2036 342e Defaults to 64. │ │ │ │ -00041020: 0a0a 272d 7320 4e55 4d42 4552 270a 272d ..'-s NUMBER'.'- │ │ │ │ -00041030: 2d73 616c 743d 4e55 4d42 4552 270a 2020 -salt=NUMBER'. │ │ │ │ -00041040: 2020 204c 656e 6774 6820 6f66 2074 6865 Length of the │ │ │ │ -00041050: 2073 616c 742e 2020 4465 6661 756c 7473 salt. Defaults │ │ │ │ -00041060: 2074 6f20 3634 2e0a 0a1f 0a46 696c 653a to 64.....File: │ │ │ │ -00041070: 2067 7275 622e 696e 666f 2c20 204e 6f64 grub.info, Nod │ │ │ │ -00041080: 653a 2049 6e76 6f6b 696e 6720 6772 7562 e: Invoking grub │ │ │ │ -00041090: 2d6d 6b72 656c 7061 7468 2c20 204e 6578 -mkrelpath, Nex │ │ │ │ -000410a0: 743a 2049 6e76 6f6b 696e 6720 6772 7562 t: Invoking grub │ │ │ │ -000410b0: 2d6d 6b72 6573 6375 652c 2020 5072 6576 -mkrescue, Prev │ │ │ │ -000410c0: 3a20 496e 766f 6b69 6e67 2067 7275 622d : Invoking grub- │ │ │ │ -000410d0: 6d6b 7061 7373 7764 2d70 626b 6466 322c mkpasswd-pbkdf2, │ │ │ │ -000410e0: 2020 5570 3a20 546f 700a 0a32 3620 496e Up: Top..26 In │ │ │ │ -000410f0: 766f 6b69 6e67 2067 7275 622d 6d6b 7265 voking grub-mkre │ │ │ │ -00041100: 6c70 6174 680a 2a2a 2a2a 2a2a 2a2a 2a2a lpath.********** │ │ │ │ +00040e90: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a0a 0a54 *************..T │ │ │ │ +00040ea0: 6865 2070 726f 6772 616d 2027 6772 7562 he program 'grub │ │ │ │ +00040eb0: 2d6d 6b70 6173 7377 642d 7062 6b64 6632 -mkpasswd-pbkdf2 │ │ │ │ +00040ec0: 2720 6765 6e65 7261 7465 7320 7061 7373 ' generates pass │ │ │ │ +00040ed0: 776f 7264 2068 6173 6865 7320 666f 7220 word hashes for │ │ │ │ +00040ee0: 4752 5542 0a28 2a6e 6f74 6520 5365 6375 GRUB.(*note Secu │ │ │ │ +00040ef0: 7269 7479 3a3a 292e 0a0a 2020 2020 2067 rity::)... g │ │ │ │ +00040f00: 7275 622d 6d6b 7061 7373 7764 2d70 626b rub-mkpasswd-pbk │ │ │ │ +00040f10: 6466 320a 0a20 2020 2767 7275 622d 6d6b df2.. 'grub-mk │ │ │ │ +00040f20: 7061 7373 7764 2d70 626b 6466 3227 2061 passwd-pbkdf2' a │ │ │ │ +00040f30: 6363 6570 7473 2074 6865 2066 6f6c 6c6f ccepts the follo │ │ │ │ +00040f40: 7769 6e67 206f 7074 696f 6e73 3a0a 0a27 wing options:..' │ │ │ │ +00040f50: 2d63 204e 554d 4245 5227 0a27 2d2d 6974 -c NUMBER'.'--it │ │ │ │ +00040f60: 6572 6174 696f 6e2d 636f 756e 743d 4e55 eration-count=NU │ │ │ │ +00040f70: 4d42 4552 270a 2020 2020 204e 756d 6265 MBER'. Numbe │ │ │ │ +00040f80: 7220 6f66 2069 7465 7261 7469 6f6e 7320 r of iterations │ │ │ │ +00040f90: 6f66 2074 6865 2075 6e64 6572 6c79 696e of the underlyin │ │ │ │ +00040fa0: 6720 7073 6575 646f 2d72 616e 646f 6d20 g pseudo-random │ │ │ │ +00040fb0: 6675 6e63 7469 6f6e 2e0a 2020 2020 2044 function.. D │ │ │ │ +00040fc0: 6566 6175 6c74 7320 746f 2031 3030 3030 efaults to 10000 │ │ │ │ +00040fd0: 2e0a 0a27 2d6c 204e 554d 4245 5227 0a27 ...'-l NUMBER'.' │ │ │ │ +00040fe0: 2d2d 6275 666c 656e 3d4e 554d 4245 5227 --buflen=NUMBER' │ │ │ │ +00040ff0: 0a20 2020 2020 4c65 6e67 7468 206f 6620 . Length of │ │ │ │ +00041000: 7468 6520 6765 6e65 7261 7465 6420 6861 the generated ha │ │ │ │ +00041010: 7368 2e20 2044 6566 6175 6c74 7320 746f sh. Defaults to │ │ │ │ +00041020: 2036 342e 0a0a 272d 7320 4e55 4d42 4552 64...'-s NUMBER │ │ │ │ +00041030: 270a 272d 2d73 616c 743d 4e55 4d42 4552 '.'--salt=NUMBER │ │ │ │ +00041040: 270a 2020 2020 204c 656e 6774 6820 6f66 '. Length of │ │ │ │ +00041050: 2074 6865 2073 616c 742e 2020 4465 6661 the salt. Defa │ │ │ │ +00041060: 756c 7473 2074 6f20 3634 2e0a 0a1f 0a46 ults to 64.....F │ │ │ │ +00041070: 696c 653a 2067 7275 622e 696e 666f 2c20 ile: grub.info, │ │ │ │ +00041080: 204e 6f64 653a 2049 6e76 6f6b 696e 6720 Node: Invoking │ │ │ │ +00041090: 6772 7562 2d6d 6b72 656c 7061 7468 2c20 grub-mkrelpath, │ │ │ │ +000410a0: 204e 6578 743a 2049 6e76 6f6b 696e 6720 Next: Invoking │ │ │ │ +000410b0: 6772 7562 2d6d 6b72 6573 6375 652c 2020 grub-mkrescue, │ │ │ │ +000410c0: 5072 6576 3a20 496e 766f 6b69 6e67 2067 Prev: Invoking g │ │ │ │ +000410d0: 7275 622d 6d6b 7061 7373 7764 2d70 626b rub-mkpasswd-pbk │ │ │ │ +000410e0: 6466 322c 2020 5570 3a20 546f 700a 0a32 df2, Up: Top..2 │ │ │ │ +000410f0: 3620 496e 766f 6b69 6e67 2067 7275 622d 6 Invoking grub- │ │ │ │ +00041100: 6d6b 7265 6c70 6174 680a 2a2a 2a2a 2a2a mkrelpath.****** │ │ │ │ 00041110: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ -00041120: 0a0a 5468 6520 7072 6f67 7261 6d20 2767 ..The program 'g │ │ │ │ -00041130: 7275 622d 6d6b 7265 6c70 6174 6827 206d rub-mkrelpath' m │ │ │ │ -00041140: 616b 6573 2061 2066 696c 6520 7379 7374 akes a file syst │ │ │ │ -00041150: 656d 2070 6174 6820 7265 6c61 7469 7665 em path relative │ │ │ │ -00041160: 2074 6f20 7468 650a 726f 6f74 206f 6620 to the.root of │ │ │ │ -00041170: 6974 7320 636f 6e74 6169 6e69 6e67 2066 its containing f │ │ │ │ -00041180: 696c 6520 7379 7374 656d 2e20 2046 6f72 ile system. For │ │ │ │ -00041190: 2069 6e73 7461 6e63 652c 2069 6620 272f instance, if '/ │ │ │ │ -000411a0: 7573 7227 2069 7320 6120 6d6f 756e 740a usr' is a mount. │ │ │ │ -000411b0: 706f 696e 742c 2074 6865 6e3a 0a0a 2020 point, then:.. │ │ │ │ -000411c0: 2020 2024 2067 7275 622d 6d6b 7265 6c70 $ grub-mkrelp │ │ │ │ -000411d0: 6174 6820 2f75 7372 2f73 6861 7265 2f67 ath /usr/share/g │ │ │ │ -000411e0: 7275 622f 756e 6963 6f64 652e 7066 320a rub/unicode.pf2. │ │ │ │ -000411f0: 2020 2020 2027 2f73 6861 7265 2f67 7275 '/share/gru │ │ │ │ -00041200: 622f 756e 6963 6f64 652e 7066 3227 0a0a b/unicode.pf2'.. │ │ │ │ -00041210: 2020 2054 6869 7320 6973 206d 6169 6e6c This is mainl │ │ │ │ -00041220: 7920 7573 6564 2069 6e74 6572 6e61 6c6c y used internall │ │ │ │ -00041230: 7920 6279 206f 7468 6572 2047 5255 4220 y by other GRUB │ │ │ │ -00041240: 7574 696c 6974 6965 7320 7375 6368 2061 utilities such a │ │ │ │ -00041250: 730a 2767 7275 622d 6d6b 636f 6e66 6967 s.'grub-mkconfig │ │ │ │ -00041260: 2720 282a 6e6f 7465 2049 6e76 6f6b 696e ' (*note Invokin │ │ │ │ -00041270: 6720 6772 7562 2d6d 6b63 6f6e 6669 673a g grub-mkconfig: │ │ │ │ -00041280: 3a29 2c20 6275 7420 6d61 7920 6f63 6361 :), but may occa │ │ │ │ -00041290: 7369 6f6e 616c 6c79 0a61 6c73 6f20 6265 sionally.also be │ │ │ │ -000412a0: 2075 7365 6675 6c20 666f 7220 6465 6275 useful for debu │ │ │ │ -000412b0: 6767 696e 672e 0a0a 2020 2027 6772 7562 gging... 'grub │ │ │ │ -000412c0: 2d6d 6b72 656c 7061 7468 2720 6163 6365 -mkrelpath' acce │ │ │ │ -000412d0: 7074 7320 7468 6520 666f 6c6c 6f77 696e pts the followin │ │ │ │ -000412e0: 6720 6f70 7469 6f6e 733a 0a0a 272d 2d68 g options:..'--h │ │ │ │ -000412f0: 656c 7027 0a20 2020 2020 5072 696e 7420 elp'. Print │ │ │ │ -00041300: 6120 7375 6d6d 6172 7920 6f66 2074 6865 a summary of the │ │ │ │ -00041310: 2063 6f6d 6d61 6e64 2d6c 696e 6520 6f70 command-line op │ │ │ │ -00041320: 7469 6f6e 7320 616e 6420 6578 6974 2e0a tions and exit.. │ │ │ │ -00041330: 0a27 2d2d 7665 7273 696f 6e27 0a20 2020 .'--version'. │ │ │ │ -00041340: 2020 5072 696e 7420 7468 6520 7665 7273 Print the vers │ │ │ │ -00041350: 696f 6e20 6e75 6d62 6572 206f 6620 4752 ion number of GR │ │ │ │ -00041360: 5542 2061 6e64 2065 7869 742e 0a0a 1f0a UB and exit..... │ │ │ │ -00041370: 4669 6c65 3a20 6772 7562 2e69 6e66 6f2c File: grub.info, │ │ │ │ -00041380: 2020 4e6f 6465 3a20 496e 766f 6b69 6e67 Node: Invoking │ │ │ │ -00041390: 2067 7275 622d 6d6b 7265 7363 7565 2c20 grub-mkrescue, │ │ │ │ -000413a0: 204e 6578 743a 2049 6e76 6f6b 696e 6720 Next: Invoking │ │ │ │ -000413b0: 6772 7562 2d6d 6f75 6e74 2c20 2050 7265 grub-mount, Pre │ │ │ │ -000413c0: 763a 2049 6e76 6f6b 696e 6720 6772 7562 v: Invoking grub │ │ │ │ -000413d0: 2d6d 6b72 656c 7061 7468 2c20 2055 703a -mkrelpath, Up: │ │ │ │ -000413e0: 2054 6f70 0a0a 3237 2049 6e76 6f6b 696e Top..27 Invokin │ │ │ │ -000413f0: 6720 6772 7562 2d6d 6b72 6573 6375 650a g grub-mkrescue. │ │ │ │ -00041400: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ -00041410: 2a2a 2a2a 2a2a 2a2a 2a0a 0a54 6865 2070 *********..The p │ │ │ │ -00041420: 726f 6772 616d 2027 6772 7562 2d6d 6b72 rogram 'grub-mkr │ │ │ │ -00041430: 6573 6375 6527 2067 656e 6572 6174 6573 escue' generates │ │ │ │ -00041440: 2061 2062 6f6f 7461 626c 6520 4752 5542 a bootable GRUB │ │ │ │ -00041450: 2072 6573 6375 6520 696d 6167 650a 282a rescue image.(* │ │ │ │ -00041460: 6e6f 7465 204d 616b 696e 6720 6120 4752 note Making a GR │ │ │ │ -00041470: 5542 2062 6f6f 7461 626c 6520 4344 2d52 UB bootable CD-R │ │ │ │ -00041480: 4f4d 3a3a 292e 0a0a 2020 2020 2067 7275 OM::)... gru │ │ │ │ -00041490: 622d 6d6b 7265 7363 7565 202d 6f20 6772 b-mkrescue -o gr │ │ │ │ -000414a0: 7562 2e69 736f 0a0a 2020 2041 6c6c 2061 ub.iso.. All a │ │ │ │ -000414b0: 7267 756d 656e 7473 206e 6f74 2065 7870 rguments not exp │ │ │ │ -000414c0: 6c69 6369 746c 7920 6c69 7374 6564 2061 licitly listed a │ │ │ │ -000414d0: 7320 2767 7275 622d 6d6b 7265 7363 7565 s 'grub-mkrescue │ │ │ │ -000414e0: 2720 6f70 7469 6f6e 7320 6172 650a 7061 ' options are.pa │ │ │ │ -000414f0: 7373 6564 206f 6e20 6469 7265 6374 6c79 ssed on directly │ │ │ │ -00041500: 2074 6f20 2778 6f72 7269 736f 2720 696e to 'xorriso' in │ │ │ │ -00041510: 2027 6d6b 6973 6f66 7327 2065 6d75 6c61 'mkisofs' emula │ │ │ │ -00041520: 7469 6f6e 206d 6f64 652e 2020 4f70 7469 tion mode. Opti │ │ │ │ -00041530: 6f6e 730a 7061 7373 6564 2074 6f20 2778 ons.passed to 'x │ │ │ │ -00041540: 6f72 7269 736f 2720 7769 6c6c 206e 6f72 orriso' will nor │ │ │ │ -00041550: 6d61 6c6c 7920 6265 2069 6e74 6572 7072 mally be interpr │ │ │ │ -00041560: 6574 6564 2061 7320 276d 6b69 736f 6673 eted as 'mkisofs │ │ │ │ -00041570: 2720 6f70 7469 6f6e 733b 0a69 6620 7468 ' options;.if th │ │ │ │ -00041580: 6520 6f70 7469 6f6e 2027 2d2d 2720 6973 e option '--' is │ │ │ │ -00041590: 2075 7365 642c 2074 6865 6e20 616e 7974 used, then anyt │ │ │ │ -000415a0: 6869 6e67 2061 6674 6572 2074 6861 7420 hing after that │ │ │ │ -000415b0: 7769 6c6c 2062 6520 696e 7465 7270 7265 will be interpre │ │ │ │ -000415c0: 7465 640a 6173 206e 6174 6976 6520 2778 ted.as native 'x │ │ │ │ -000415d0: 6f72 7269 736f 2720 6f70 7469 6f6e 732e orriso' options. │ │ │ │ -000415e0: 0a0a 2020 204e 6f6e 2d6f 7074 696f 6e20 .. Non-option │ │ │ │ -000415f0: 6172 6775 6d65 6e74 7320 7370 6563 6966 arguments specif │ │ │ │ -00041600: 7920 6164 6469 7469 6f6e 616c 2073 6f75 y additional sou │ │ │ │ -00041610: 7263 6520 6469 7265 6374 6f72 6965 732e rce directories. │ │ │ │ -00041620: 2020 5468 6973 2069 730a 636f 6d6d 6f6e This is.common │ │ │ │ -00041630: 6c79 2075 7365 6420 746f 2061 6464 2065 ly used to add e │ │ │ │ -00041640: 7874 7261 2066 696c 6573 2074 6f20 7468 xtra files to th │ │ │ │ -00041650: 6520 696d 6167 653a 0a0a 2020 2020 206d e image:.. m │ │ │ │ -00041660: 6b64 6972 202d 7020 6469 736b 2f62 6f6f kdir -p disk/boo │ │ │ │ -00041670: 742f 6772 7562 0a20 2020 2020 2861 6464 t/grub. (add │ │ │ │ -00041680: 2065 7874 7261 2066 696c 6573 2074 6f20 extra files to │ │ │ │ -00041690: 2764 6973 6b2f 626f 6f74 2f67 7275 6227 'disk/boot/grub' │ │ │ │ -000416a0: 290a 2020 2020 2067 7275 622d 6d6b 7265 ). grub-mkre │ │ │ │ -000416b0: 7363 7565 202d 6f20 6772 7562 2e69 736f scue -o grub.iso │ │ │ │ -000416c0: 2064 6973 6b0a 0a20 2020 2767 7275 622d disk.. 'grub- │ │ │ │ -000416d0: 6d6b 7265 7363 7565 2720 6163 6365 7074 mkrescue' accept │ │ │ │ -000416e0: 7320 7468 6520 666f 6c6c 6f77 696e 6720 s the following │ │ │ │ -000416f0: 6f70 7469 6f6e 733a 0a0a 272d 2d68 656c options:..'--hel │ │ │ │ -00041700: 7027 0a20 2020 2020 5072 696e 7420 6120 p'. Print a │ │ │ │ -00041710: 7375 6d6d 6172 7920 6f66 2074 6865 2063 summary of the c │ │ │ │ -00041720: 6f6d 6d61 6e64 2d6c 696e 6520 6f70 7469 ommand-line opti │ │ │ │ -00041730: 6f6e 7320 616e 6420 6578 6974 2e0a 0a27 ons and exit...' │ │ │ │ -00041740: 2d2d 7665 7273 696f 6e27 0a20 2020 2020 --version'. │ │ │ │ -00041750: 5072 696e 7420 7468 6520 7665 7273 696f Print the versio │ │ │ │ -00041760: 6e20 6e75 6d62 6572 206f 6620 4752 5542 n number of GRUB │ │ │ │ -00041770: 2061 6e64 2065 7869 742e 0a0a 272d 6f20 and exit...'-o │ │ │ │ -00041780: 4649 4c45 270a 272d 2d6f 7574 7075 743d FILE'.'--output= │ │ │ │ -00041790: 4649 4c45 270a 2020 2020 2053 6176 6520 FILE'. Save │ │ │ │ -000417a0: 6f75 7470 7574 2069 6e20 4649 4c45 2e20 output in FILE. │ │ │ │ -000417b0: 2054 6869 7320 226f 7074 696f 6e22 2069 This "option" i │ │ │ │ -000417c0: 7320 7265 7175 6972 6564 2e0a 0a27 2d2d s required...'-- │ │ │ │ -000417d0: 6d6f 6475 6c65 733d 4d4f 4455 4c45 5327 modules=MODULES' │ │ │ │ -000417e0: 0a20 2020 2020 5072 652d 6c6f 6164 2074 . Pre-load t │ │ │ │ -000417f0: 6865 206e 616d 6564 2047 5255 4220 6d6f he named GRUB mo │ │ │ │ -00041800: 6475 6c65 7320 696e 2074 6865 2069 6d61 dules in the ima │ │ │ │ -00041810: 6765 2e20 204d 756c 7469 706c 6520 656e ge. Multiple en │ │ │ │ -00041820: 7472 6965 7320 696e 0a20 2020 2020 4d4f tries in. MO │ │ │ │ -00041830: 4455 4c45 5320 7368 6f75 6c64 2062 6520 DULES should be │ │ │ │ -00041840: 7365 7061 7261 7465 6420 6279 2077 6869 separated by whi │ │ │ │ -00041850: 7465 7370 6163 6520 2873 6f20 796f 7520 tespace (so you │ │ │ │ -00041860: 7769 6c6c 2070 726f 6261 626c 790a 2020 will probably. │ │ │ │ -00041870: 2020 206e 6565 6420 746f 2071 756f 7465 need to quote │ │ │ │ -00041880: 2074 6869 7320 666f 7220 796f 7572 2073 this for your s │ │ │ │ -00041890: 6865 6c6c 292e 0a0a 272d 2d72 6f6d 2d64 hell)...'--rom-d │ │ │ │ -000418a0: 6972 6563 746f 7279 3d44 4952 270a 2020 irectory=DIR'. │ │ │ │ -000418b0: 2020 2049 6620 6765 6e65 7261 7469 6e67 If generating │ │ │ │ -000418c0: 2069 6d61 6765 7320 666f 7220 7468 6520 images for the │ │ │ │ -000418d0: 5145 4d55 206f 7220 436f 7265 626f 6f74 QEMU or Coreboot │ │ │ │ -000418e0: 2070 6c61 7466 6f72 6d73 2c20 636f 7079 platforms, copy │ │ │ │ -000418f0: 2074 6865 0a20 2020 2020 7265 7375 6c74 the. result │ │ │ │ -00041900: 696e 6720 2771 656d 752e 696d 6727 206f ing 'qemu.img' o │ │ │ │ -00041910: 7220 2763 6f72 6562 6f6f 742e 656c 6627 r 'coreboot.elf' │ │ │ │ -00041920: 2066 696c 6573 2072 6573 7065 6374 6976 files respectiv │ │ │ │ -00041930: 656c 7920 746f 2074 6865 0a20 2020 2020 ely to the. │ │ │ │ -00041940: 4449 5220 6469 7265 6374 6f72 7920 6173 DIR directory as │ │ │ │ -00041950: 2077 656c 6c20 6173 2069 6e63 6c75 6469 well as includi │ │ │ │ -00041960: 6e67 2074 6865 6d20 696e 2074 6865 2069 ng them in the i │ │ │ │ -00041970: 6d61 6765 2e0a 0a27 2d2d 786f 7272 6973 mage...'--xorris │ │ │ │ -00041980: 6f3d 4649 4c45 270a 2020 2020 2055 7365 o=FILE'. Use │ │ │ │ -00041990: 2046 494c 4520 6173 2074 6865 2027 786f FILE as the 'xo │ │ │ │ -000419a0: 7272 6973 6f27 2070 726f 6772 616d 2c20 rriso' program, │ │ │ │ -000419b0: 7261 7468 6572 2074 6861 6e20 7468 6520 rather than the │ │ │ │ -000419c0: 6275 696c 742d 696e 0a20 2020 2020 6465 built-in. de │ │ │ │ -000419d0: 6661 756c 742e 0a0a 272d 2d67 7275 622d fault...'--grub- │ │ │ │ -000419e0: 6d6b 696d 6167 653d 4649 4c45 270a 2020 mkimage=FILE'. │ │ │ │ -000419f0: 2020 2055 7365 2046 494c 4520 6173 2074 Use FILE as t │ │ │ │ -00041a00: 6865 2027 6772 7562 2d6d 6b69 6d61 6765 he 'grub-mkimage │ │ │ │ -00041a10: 2720 7072 6f67 7261 6d2c 2072 6174 6865 ' program, rathe │ │ │ │ -00041a20: 7220 7468 616e 2074 6865 2062 7569 6c74 r than the built │ │ │ │ -00041a30: 2d69 6e0a 2020 2020 2064 6566 6175 6c74 -in. default │ │ │ │ -00041a40: 2e0a 0a1f 0a46 696c 653a 2067 7275 622e .....File: grub. │ │ │ │ -00041a50: 696e 666f 2c20 204e 6f64 653a 2049 6e76 info, Node: Inv │ │ │ │ -00041a60: 6f6b 696e 6720 6772 7562 2d6d 6f75 6e74 oking grub-mount │ │ │ │ -00041a70: 2c20 204e 6578 743a 2049 6e76 6f6b 696e , Next: Invokin │ │ │ │ -00041a80: 6720 6772 7562 2d70 726f 6265 2c20 2050 g grub-probe, P │ │ │ │ -00041a90: 7265 763a 2049 6e76 6f6b 696e 6720 6772 rev: Invoking gr │ │ │ │ -00041aa0: 7562 2d6d 6b72 6573 6375 652c 2020 5570 ub-mkrescue, Up │ │ │ │ -00041ab0: 3a20 546f 700a 0a32 3820 496e 766f 6b69 : Top..28 Invoki │ │ │ │ -00041ac0: 6e67 2067 7275 622d 6d6f 756e 740a 2a2a ng grub-mount.** │ │ │ │ -00041ad0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ -00041ae0: 2a2a 2a2a 0a0a 5468 6520 7072 6f67 7261 ****..The progra │ │ │ │ -00041af0: 6d20 2767 7275 622d 6d6f 756e 7427 2070 m 'grub-mount' p │ │ │ │ -00041b00: 6572 666f 726d 7320 6120 7265 6164 2d6f erforms a read-o │ │ │ │ -00041b10: 6e6c 7920 6d6f 756e 7420 6f66 2061 6e79 nly mount of any │ │ │ │ -00041b20: 2066 696c 6520 7379 7374 656d 0a6f 7220 file system.or │ │ │ │ -00041b30: 6669 6c65 2073 7973 7465 6d20 696d 6167 file system imag │ │ │ │ -00041b40: 6520 7468 6174 2047 5255 4220 756e 6465 e that GRUB unde │ │ │ │ -00041b50: 7273 7461 6e64 732c 2075 7369 6e67 2047 rstands, using G │ │ │ │ -00041b60: 5255 4227 7320 6669 6c65 2073 7973 7465 RUB's file syste │ │ │ │ -00041b70: 6d0a 6472 6976 6572 7320 7669 6120 4655 m.drivers via FU │ │ │ │ -00041b80: 5345 2e20 2849 7420 6973 206f 6e6c 7920 SE. (It is only │ │ │ │ -00041b90: 6176 6169 6c61 626c 6520 6966 2046 5553 available if FUS │ │ │ │ -00041ba0: 4520 6465 7665 6c6f 706d 656e 7420 6669 E development fi │ │ │ │ -00041bb0: 6c65 7320 7765 7265 0a70 7265 7365 6e74 les were.present │ │ │ │ -00041bc0: 2077 6865 6e20 4752 5542 2077 6173 2062 when GRUB was b │ │ │ │ -00041bd0: 7569 6c74 2e29 2020 5468 6973 2068 6173 uilt.) This has │ │ │ │ -00041be0: 2061 206e 756d 6265 7220 6f66 2075 7365 a number of use │ │ │ │ -00041bf0: 733a 0a0a 2020 202a 2049 7420 7072 6f76 s:.. * It prov │ │ │ │ -00041c00: 6964 6573 2061 2063 6f6e 7665 6e69 656e ides a convenien │ │ │ │ -00041c10: 7420 7761 7920 746f 2063 6865 636b 2068 t way to check h │ │ │ │ -00041c20: 6f77 2047 5255 4220 7769 6c6c 2076 6965 ow GRUB will vie │ │ │ │ -00041c30: 7720 6120 6669 6c65 0a20 2020 2020 7379 w a file. sy │ │ │ │ -00041c40: 7374 656d 2061 7420 626f 6f74 2074 696d stem at boot tim │ │ │ │ -00041c50: 652e 2020 596f 7520 6361 6e20 7573 6520 e. You can use │ │ │ │ -00041c60: 6e6f 726d 616c 2063 6f6d 6d61 6e64 2d6c normal command-l │ │ │ │ -00041c70: 696e 6520 746f 6f6c 7320 746f 0a20 2020 ine tools to. │ │ │ │ -00041c80: 2020 636f 6d70 6172 6520 7468 6174 2076 compare that v │ │ │ │ -00041c90: 6965 7720 7769 7468 2074 6861 7420 6f66 iew with that of │ │ │ │ -00041ca0: 2079 6f75 7220 6f70 6572 6174 696e 6720 your operating │ │ │ │ -00041cb0: 7379 7374 656d 2c20 6d61 6b69 6e67 2069 system, making i │ │ │ │ -00041cc0: 740a 2020 2020 2065 6173 7920 746f 2066 t. easy to f │ │ │ │ -00041cd0: 696e 6420 6275 6773 2e0a 0a20 2020 2a20 ind bugs... * │ │ │ │ -00041ce0: 4974 206f 6666 6572 7320 7472 7565 2072 It offers true r │ │ │ │ -00041cf0: 6561 642d 6f6e 6c79 206d 6f75 6e74 732e ead-only mounts. │ │ │ │ -00041d00: 2020 4c69 6e75 7820 646f 6573 206e 6f74 Linux does not │ │ │ │ -00041d10: 2068 6176 6520 7468 6573 6520 666f 720a have these for. │ │ │ │ -00041d20: 2020 2020 206a 6f75 726e 616c 6c69 6e67 journalling │ │ │ │ -00041d30: 2066 696c 6520 7379 7374 656d 732c 2062 file systems, b │ │ │ │ -00041d40: 6563 6175 7365 2069 7420 7769 6c6c 2061 ecause it will a │ │ │ │ -00041d50: 6c77 6179 7320 6174 7465 6d70 7420 746f lways attempt to │ │ │ │ -00041d60: 2072 6570 6c61 790a 2020 2020 2074 6865 replay. the │ │ │ │ -00041d70: 206a 6f75 726e 616c 2061 7420 6d6f 756e journal at moun │ │ │ │ -00041d80: 7420 7469 6d65 3b20 7768 696c 6520 796f t time; while yo │ │ │ │ -00041d90: 7520 6361 6e20 7465 6d70 6f72 6172 696c u can temporaril │ │ │ │ -00041da0: 7920 6d61 726b 2074 6865 2062 6c6f 636b y mark the block │ │ │ │ -00041db0: 0a20 2020 2020 6465 7669 6365 2072 6561 . device rea │ │ │ │ -00041dc0: 642d 6f6e 6c79 2074 6f20 6176 6f69 6420 d-only to avoid │ │ │ │ -00041dd0: 7468 6973 2c20 7468 6174 2063 6175 7365 this, that cause │ │ │ │ -00041de0: 7320 7468 6520 6d6f 756e 7420 746f 2066 s the mount to f │ │ │ │ -00041df0: 6169 6c2e 0a20 2020 2020 5369 6e63 6520 ail.. Since │ │ │ │ -00041e00: 4752 5542 2069 6e74 656e 7469 6f6e 616c GRUB intentional │ │ │ │ -00041e10: 6c79 2063 6f6e 7461 696e 7320 6e6f 2063 ly contains no c │ │ │ │ -00041e20: 6f64 6520 666f 7220 7772 6974 696e 6720 ode for writing │ │ │ │ -00041e30: 746f 2066 696c 650a 2020 2020 2073 7973 to file. sys │ │ │ │ -00041e40: 7465 6d73 2c20 6974 2063 616e 2065 6173 tems, it can eas │ │ │ │ -00041e50: 696c 7920 7072 6f76 6964 6520 6120 6775 ily provide a gu │ │ │ │ -00041e60: 6172 616e 7465 6564 2072 6561 642d 6f6e aranteed read-on │ │ │ │ -00041e70: 6c79 206d 6f75 6e74 0a20 2020 2020 6d65 ly mount. me │ │ │ │ -00041e80: 6368 616e 6973 6d2e 0a0a 2020 202a 2049 chanism... * I │ │ │ │ -00041e90: 7420 616c 6c6f 7773 2079 6f75 2074 6f20 t allows you to │ │ │ │ -00041ea0: 6578 616d 696e 6520 616e 7920 6669 6c65 examine any file │ │ │ │ -00041eb0: 2073 7973 7465 6d20 7468 6174 2047 5255 system that GRU │ │ │ │ -00041ec0: 4220 756e 6465 7273 7461 6e64 730a 2020 B understands. │ │ │ │ -00041ed0: 2020 2077 6974 686f 7574 206e 6565 6469 without needi │ │ │ │ -00041ee0: 6e67 2074 6f20 6c6f 6164 2061 6464 6974 ng to load addit │ │ │ │ -00041ef0: 696f 6e61 6c20 6d6f 6475 6c65 7320 696e ional modules in │ │ │ │ -00041f00: 746f 2079 6f75 7220 7275 6e6e 696e 670a to your running. │ │ │ │ -00041f10: 2020 2020 206b 6572 6e65 6c2c 2077 6869 kernel, whi │ │ │ │ -00041f20: 6368 206d 6179 2062 6520 7573 6566 756c ch may be useful │ │ │ │ -00041f30: 2069 6e20 636f 6e73 7472 6169 6e65 6420 in constrained │ │ │ │ -00041f40: 656e 7669 726f 6e6d 656e 7473 2073 7563 environments suc │ │ │ │ -00041f50: 6820 6173 0a20 2020 2020 696e 7374 616c h as. instal │ │ │ │ -00041f60: 6c65 7273 2e0a 0a20 2020 2a20 5369 6e63 lers... * Sinc │ │ │ │ -00041f70: 6520 6974 2063 616e 2065 7861 6d69 6e65 e it can examine │ │ │ │ -00041f80: 2066 696c 6520 7379 7374 656d 2069 6d61 file system ima │ │ │ │ -00041f90: 6765 7320 2863 6f6e 7461 696e 6564 2069 ges (contained i │ │ │ │ -00041fa0: 6e20 7265 6775 6c61 720a 2020 2020 2066 n regular. f │ │ │ │ -00041fb0: 696c 6573 2920 6a75 7374 2061 7320 6561 iles) just as ea │ │ │ │ -00041fc0: 7369 6c79 2061 7320 6669 6c65 2073 7973 sily as file sys │ │ │ │ -00041fd0: 7465 6d73 206f 6e20 626c 6f63 6b20 6465 tems on block de │ │ │ │ -00041fe0: 7669 6365 732c 2079 6f75 2063 616e 2075 vices, you can u │ │ │ │ -00041ff0: 7365 0a20 2020 2020 6974 2074 6f20 696e se. it to in │ │ │ │ -00042000: 7370 6563 7420 616e 7920 6669 6c65 2073 spect any file s │ │ │ │ -00042010: 7973 7465 6d20 696d 6167 6520 7468 6174 ystem image that │ │ │ │ -00042020: 2047 5255 4220 756e 6465 7273 7461 6e64 GRUB understand │ │ │ │ -00042030: 7320 7769 7468 206f 6e6c 790a 2020 2020 s with only. │ │ │ │ -00042040: 2065 6e6f 7567 6820 7072 6976 696c 6567 enough privileg │ │ │ │ -00042050: 6573 2074 6f20 7573 6520 4655 5345 2c20 es to use FUSE, │ │ │ │ -00042060: 6576 656e 2069 6620 6e6f 626f 6479 2068 even if nobody h │ │ │ │ -00042070: 6173 2079 6574 2077 7269 7474 656e 2061 as yet written a │ │ │ │ -00042080: 0a20 2020 2020 4655 5345 206d 6f64 756c . FUSE modul │ │ │ │ -00042090: 6520 7370 6563 6966 6963 616c 6c79 2066 e specifically f │ │ │ │ -000420a0: 6f72 2074 6861 7420 6669 6c65 2073 7973 or that file sys │ │ │ │ -000420b0: 7465 6d20 7479 7065 2e0a 0a20 2020 5573 tem type... Us │ │ │ │ -000420c0: 696e 6720 2767 7275 622d 6d6f 756e 7427 ing 'grub-mount' │ │ │ │ -000420d0: 2069 7320 6e6f 726d 616c 6c79 2061 7320 is normally as │ │ │ │ -000420e0: 7369 6d70 6c65 2061 733a 0a0a 2020 2020 simple as:.. │ │ │ │ -000420f0: 2067 7275 622d 6d6f 756e 7420 2f64 6576 grub-mount /dev │ │ │ │ -00042100: 2f73 6461 3120 2f6d 6e74 0a0a 2020 2027 /sda1 /mnt.. ' │ │ │ │ -00042110: 6772 7562 2d6d 6f75 6e74 2720 6d75 7374 grub-mount' must │ │ │ │ -00042120: 2062 6520 6769 7665 6e20 6f6e 6520 6f72 be given one or │ │ │ │ -00042130: 206d 6f72 6520 696d 6167 6573 2061 6e64 more images and │ │ │ │ -00042140: 2061 206d 6f75 6e74 2070 6f69 6e74 2061 a mount point a │ │ │ │ -00042150: 730a 6e6f 6e2d 6f70 7469 6f6e 2061 7267 s.non-option arg │ │ │ │ -00042160: 756d 656e 7473 2028 6966 2069 7420 6973 uments (if it is │ │ │ │ -00042170: 2067 6976 656e 206d 6f72 6520 7468 616e given more than │ │ │ │ -00042180: 206f 6e65 2069 6d61 6765 2c20 6974 2077 one image, it w │ │ │ │ -00042190: 696c 6c20 7472 6561 740a 7468 656d 2061 ill treat.them a │ │ │ │ -000421a0: 7320 6120 5241 4944 2073 6574 292c 2061 s a RAID set), a │ │ │ │ -000421b0: 6e64 2061 6c73 6f20 6163 6365 7074 7320 nd also accepts │ │ │ │ -000421c0: 7468 6520 666f 6c6c 6f77 696e 6720 6f70 the following op │ │ │ │ -000421d0: 7469 6f6e 733a 0a0a 272d 2d68 656c 7027 tions:..'--help' │ │ │ │ -000421e0: 0a20 2020 2020 5072 696e 7420 6120 7375 . Print a su │ │ │ │ -000421f0: 6d6d 6172 7920 6f66 2074 6865 2063 6f6d mmary of the com │ │ │ │ -00042200: 6d61 6e64 2d6c 696e 6520 6f70 7469 6f6e mand-line option │ │ │ │ -00042210: 7320 616e 6420 6578 6974 2e0a 0a27 2d2d s and exit...'-- │ │ │ │ -00042220: 7665 7273 696f 6e27 0a20 2020 2020 5072 version'. Pr │ │ │ │ -00042230: 696e 7420 7468 6520 7665 7273 696f 6e20 int the version │ │ │ │ -00042240: 6e75 6d62 6572 206f 6620 4752 5542 2061 number of GRUB a │ │ │ │ -00042250: 6e64 2065 7869 742e 0a0a 272d 4327 0a27 nd exit...'-C'.' │ │ │ │ -00042260: 2d2d 6372 7970 746f 270a 2020 2020 204d --crypto'. M │ │ │ │ -00042270: 6f75 6e74 2065 6e63 7279 7074 6564 2064 ount encrypted d │ │ │ │ -00042280: 6576 6963 6573 2c20 7072 6f6d 7074 696e evices, promptin │ │ │ │ -00042290: 6720 666f 7220 6120 7061 7373 7068 7261 g for a passphra │ │ │ │ -000422a0: 7365 2069 6620 6e65 6365 7373 6172 792e se if necessary. │ │ │ │ -000422b0: 0a0a 272d 6420 5354 5249 4e47 270a 272d ..'-d STRING'.'- │ │ │ │ -000422c0: 2d64 6562 7567 3d53 5452 494e 4727 0a20 -debug=STRING'. │ │ │ │ -000422d0: 2020 2020 5368 6f77 2064 6562 7567 6769 Show debuggi │ │ │ │ -000422e0: 6e67 206f 7574 7075 7420 666f 7220 636f ng output for co │ │ │ │ -000422f0: 6e64 6974 696f 6e73 206d 6174 6368 696e nditions matchin │ │ │ │ -00042300: 6720 5354 5249 4e47 2e0a 0a27 2d4b 2070 g STRING...'-K p │ │ │ │ -00042310: 726f 6d70 747c 4649 4c45 270a 272d 2d7a rompt|FILE'.'--z │ │ │ │ -00042320: 6673 2d6b 6579 3d70 726f 6d70 747c 4649 fs-key=prompt|FI │ │ │ │ -00042330: 4c45 270a 2020 2020 204c 6f61 6420 6120 LE'. Load a │ │ │ │ -00042340: 5a46 5320 656e 6372 7970 7469 6f6e 206b ZFS encryption k │ │ │ │ -00042350: 6579 2e20 2049 6620 796f 7520 7573 6520 ey. If you use │ │ │ │ -00042360: 2770 726f 6d70 7427 2061 7320 7468 6520 'prompt' as the │ │ │ │ -00042370: 6172 6775 6d65 6e74 2c0a 2020 2020 2027 argument,. ' │ │ │ │ -00042380: 6772 7562 2d6d 6f75 6e74 2720 7769 6c6c grub-mount' will │ │ │ │ -00042390: 2072 6561 6420 6120 7061 7373 7068 7261 read a passphra │ │ │ │ -000423a0: 7365 2066 726f 6d20 7468 6520 7465 726d se from the term │ │ │ │ -000423b0: 696e 616c 3b20 6f74 6865 7277 6973 652c inal; otherwise, │ │ │ │ -000423c0: 0a20 2020 2020 6974 2077 696c 6c20 7265 . it will re │ │ │ │ -000423d0: 6164 206b 6579 206d 6174 6572 6961 6c20 ad key material │ │ │ │ -000423e0: 6672 6f6d 2074 6865 2073 7065 6369 6669 from the specifi │ │ │ │ -000423f0: 6564 2066 696c 652e 0a0a 272d 7220 4445 ed file...'-r DE │ │ │ │ -00042400: 5649 4345 270a 272d 2d72 6f6f 743d 4445 VICE'.'--root=DE │ │ │ │ -00042410: 5649 4345 270a 2020 2020 2053 6574 2074 VICE'. Set t │ │ │ │ -00042420: 6865 2047 5255 4220 726f 6f74 2064 6576 he GRUB root dev │ │ │ │ -00042430: 6963 6520 746f 2044 4556 4943 452e 2020 ice to DEVICE. │ │ │ │ -00042440: 596f 7520 646f 206e 6f74 206e 6f72 6d61 You do not norma │ │ │ │ -00042450: 6c6c 7920 6e65 6564 2074 6f0a 2020 2020 lly need to. │ │ │ │ -00042460: 2073 6574 2074 6869 733b 2027 6772 7562 set this; 'grub │ │ │ │ -00042470: 2d6d 6f75 6e74 2720 7769 6c6c 2061 7574 -mount' will aut │ │ │ │ -00042480: 6f6d 6174 6963 616c 6c79 2073 6574 2074 omatically set t │ │ │ │ -00042490: 6865 2072 6f6f 7420 6465 7669 6365 2074 he root device t │ │ │ │ -000424a0: 6f0a 2020 2020 2074 6865 2072 6f6f 7420 o. the root │ │ │ │ -000424b0: 6f66 2074 6865 2073 7570 706c 6965 6420 of the supplied │ │ │ │ -000424c0: 6669 6c65 2073 7973 7465 6d2e 0a0a 2020 file system... │ │ │ │ -000424d0: 2020 2049 6620 4445 5649 4345 2069 7320 If DEVICE is │ │ │ │ -000424e0: 6a75 7374 2061 206e 756d 6265 722c 2074 just a number, t │ │ │ │ -000424f0: 6865 6e20 6974 2077 696c 6c20 6265 2074 hen it will be t │ │ │ │ -00042500: 7265 6174 6564 2061 7320 6120 7061 7274 reated as a part │ │ │ │ -00042510: 6974 696f 6e0a 2020 2020 206e 756d 6265 ition. numbe │ │ │ │ -00042520: 7220 7769 7468 696e 2074 6865 2073 7570 r within the sup │ │ │ │ -00042530: 706c 6965 6420 696d 6167 652e 2020 5468 plied image. Th │ │ │ │ -00042540: 6973 206d 6561 6e73 2074 6861 742c 2069 is means that, i │ │ │ │ -00042550: 6620 796f 7520 6861 7665 2061 6e0a 2020 f you have an. │ │ │ │ -00042560: 2020 2069 6d61 6765 206f 6620 616e 2065 image of an e │ │ │ │ -00042570: 6e74 6972 6520 6469 736b 2069 6e20 2764 ntire disk in 'd │ │ │ │ -00042580: 6973 6b2e 696d 6727 2c20 7468 656e 2079 isk.img', then y │ │ │ │ -00042590: 6f75 2063 616e 2075 7365 2074 6869 730a ou can use this. │ │ │ │ -000425a0: 2020 2020 2063 6f6d 6d61 6e64 2074 6f20 command to │ │ │ │ -000425b0: 6d6f 756e 7420 6974 7320 7365 636f 6e64 mount its second │ │ │ │ -000425c0: 2070 6172 7469 7469 6f6e 3a0a 0a20 2020 partition:.. │ │ │ │ -000425d0: 2020 2020 2020 2067 7275 622d 6d6f 756e grub-moun │ │ │ │ -000425e0: 7420 2d72 2032 2064 6973 6b2e 696d 6720 t -r 2 disk.img │ │ │ │ -000425f0: 6d6f 756e 742d 706f 696e 740a 0a27 2d76 mount-point..'-v │ │ │ │ -00042600: 270a 272d 2d76 6572 626f 7365 270a 2020 '.'--verbose'. │ │ │ │ -00042610: 2020 2050 7269 6e74 2076 6572 626f 7365 Print verbose │ │ │ │ -00042620: 206d 6573 7361 6765 732e 0a0a 1f0a 4669 messages.....Fi │ │ │ │ -00042630: 6c65 3a20 6772 7562 2e69 6e66 6f2c 2020 le: grub.info, │ │ │ │ -00042640: 4e6f 6465 3a20 496e 766f 6b69 6e67 2067 Node: Invoking g │ │ │ │ -00042650: 7275 622d 7072 6f62 652c 2020 4e65 7874 rub-probe, Next │ │ │ │ -00042660: 3a20 496e 766f 6b69 6e67 2067 7275 622d : Invoking grub- │ │ │ │ -00042670: 7363 7269 7074 2d63 6865 636b 2c20 2050 script-check, P │ │ │ │ -00042680: 7265 763a 2049 6e76 6f6b 696e 6720 6772 rev: Invoking gr │ │ │ │ -00042690: 7562 2d6d 6f75 6e74 2c20 2055 703a 2054 ub-mount, Up: T │ │ │ │ -000426a0: 6f70 0a0a 3239 2049 6e76 6f6b 696e 6720 op..29 Invoking │ │ │ │ -000426b0: 6772 7562 2d70 726f 6265 0a2a 2a2a 2a2a grub-probe.***** │ │ │ │ +00041120: 2a2a 2a2a 0a0a 5468 6520 7072 6f67 7261 ****..The progra │ │ │ │ +00041130: 6d20 2767 7275 622d 6d6b 7265 6c70 6174 m 'grub-mkrelpat │ │ │ │ +00041140: 6827 206d 616b 6573 2061 2066 696c 6520 h' makes a file │ │ │ │ +00041150: 7379 7374 656d 2070 6174 6820 7265 6c61 system path rela │ │ │ │ +00041160: 7469 7665 2074 6f20 7468 650a 726f 6f74 tive to the.root │ │ │ │ +00041170: 206f 6620 6974 7320 636f 6e74 6169 6e69 of its containi │ │ │ │ +00041180: 6e67 2066 696c 6520 7379 7374 656d 2e20 ng file system. │ │ │ │ +00041190: 2046 6f72 2069 6e73 7461 6e63 652c 2069 For instance, i │ │ │ │ +000411a0: 6620 272f 7573 7227 2069 7320 6120 6d6f f '/usr' is a mo │ │ │ │ +000411b0: 756e 740a 706f 696e 742c 2074 6865 6e3a unt.point, then: │ │ │ │ +000411c0: 0a0a 2020 2020 2024 2067 7275 622d 6d6b .. $ grub-mk │ │ │ │ +000411d0: 7265 6c70 6174 6820 2f75 7372 2f73 6861 relpath /usr/sha │ │ │ │ +000411e0: 7265 2f67 7275 622f 756e 6963 6f64 652e re/grub/unicode. │ │ │ │ +000411f0: 7066 320a 2020 2020 2027 2f73 6861 7265 pf2. '/share │ │ │ │ +00041200: 2f67 7275 622f 756e 6963 6f64 652e 7066 /grub/unicode.pf │ │ │ │ +00041210: 3227 0a0a 2020 2054 6869 7320 6973 206d 2'.. This is m │ │ │ │ +00041220: 6169 6e6c 7920 7573 6564 2069 6e74 6572 ainly used inter │ │ │ │ +00041230: 6e61 6c6c 7920 6279 206f 7468 6572 2047 nally by other G │ │ │ │ +00041240: 5255 4220 7574 696c 6974 6965 7320 7375 RUB utilities su │ │ │ │ +00041250: 6368 2061 730a 2767 7275 622d 6d6b 636f ch as.'grub-mkco │ │ │ │ +00041260: 6e66 6967 2720 282a 6e6f 7465 2049 6e76 nfig' (*note Inv │ │ │ │ +00041270: 6f6b 696e 6720 6772 7562 2d6d 6b63 6f6e oking grub-mkcon │ │ │ │ +00041280: 6669 673a 3a29 2c20 6275 7420 6d61 7920 fig::), but may │ │ │ │ +00041290: 6f63 6361 7369 6f6e 616c 6c79 0a61 6c73 occasionally.als │ │ │ │ +000412a0: 6f20 6265 2075 7365 6675 6c20 666f 7220 o be useful for │ │ │ │ +000412b0: 6465 6275 6767 696e 672e 0a0a 2020 2027 debugging... ' │ │ │ │ +000412c0: 6772 7562 2d6d 6b72 656c 7061 7468 2720 grub-mkrelpath' │ │ │ │ +000412d0: 6163 6365 7074 7320 7468 6520 666f 6c6c accepts the foll │ │ │ │ +000412e0: 6f77 696e 6720 6f70 7469 6f6e 733a 0a0a owing options:.. │ │ │ │ +000412f0: 272d 2d68 656c 7027 0a20 2020 2020 5072 '--help'. Pr │ │ │ │ +00041300: 696e 7420 6120 7375 6d6d 6172 7920 6f66 int a summary of │ │ │ │ +00041310: 2074 6865 2063 6f6d 6d61 6e64 2d6c 696e the command-lin │ │ │ │ +00041320: 6520 6f70 7469 6f6e 7320 616e 6420 6578 e options and ex │ │ │ │ +00041330: 6974 2e0a 0a27 2d2d 7665 7273 696f 6e27 it...'--version' │ │ │ │ +00041340: 0a20 2020 2020 5072 696e 7420 7468 6520 . Print the │ │ │ │ +00041350: 7665 7273 696f 6e20 6e75 6d62 6572 206f version number o │ │ │ │ +00041360: 6620 4752 5542 2061 6e64 2065 7869 742e f GRUB and exit. │ │ │ │ +00041370: 0a0a 1f0a 4669 6c65 3a20 6772 7562 2e69 ....File: grub.i │ │ │ │ +00041380: 6e66 6f2c 2020 4e6f 6465 3a20 496e 766f nfo, Node: Invo │ │ │ │ +00041390: 6b69 6e67 2067 7275 622d 6d6b 7265 7363 king grub-mkresc │ │ │ │ +000413a0: 7565 2c20 204e 6578 743a 2049 6e76 6f6b ue, Next: Invok │ │ │ │ +000413b0: 696e 6720 6772 7562 2d6d 6f75 6e74 2c20 ing grub-mount, │ │ │ │ +000413c0: 2050 7265 763a 2049 6e76 6f6b 696e 6720 Prev: Invoking │ │ │ │ +000413d0: 6772 7562 2d6d 6b72 656c 7061 7468 2c20 grub-mkrelpath, │ │ │ │ +000413e0: 2055 703a 2054 6f70 0a0a 3237 2049 6e76 Up: Top..27 Inv │ │ │ │ +000413f0: 6f6b 696e 6720 6772 7562 2d6d 6b72 6573 oking grub-mkres │ │ │ │ +00041400: 6375 650a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a cue.************ │ │ │ │ +00041410: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a0a 0a54 *************..T │ │ │ │ +00041420: 6865 2070 726f 6772 616d 2027 6772 7562 he program 'grub │ │ │ │ +00041430: 2d6d 6b72 6573 6375 6527 2067 656e 6572 -mkrescue' gener │ │ │ │ +00041440: 6174 6573 2061 2062 6f6f 7461 626c 6520 ates a bootable │ │ │ │ +00041450: 4752 5542 2072 6573 6375 6520 696d 6167 GRUB rescue imag │ │ │ │ +00041460: 650a 282a 6e6f 7465 204d 616b 696e 6720 e.(*note Making │ │ │ │ +00041470: 6120 4752 5542 2062 6f6f 7461 626c 6520 a GRUB bootable │ │ │ │ +00041480: 4344 2d52 4f4d 3a3a 292e 0a0a 2020 2020 CD-ROM::)... │ │ │ │ +00041490: 2067 7275 622d 6d6b 7265 7363 7565 202d grub-mkrescue - │ │ │ │ +000414a0: 6f20 6772 7562 2e69 736f 0a0a 2020 2041 o grub.iso.. A │ │ │ │ +000414b0: 6c6c 2061 7267 756d 656e 7473 206e 6f74 ll arguments not │ │ │ │ +000414c0: 2065 7870 6c69 6369 746c 7920 6c69 7374 explicitly list │ │ │ │ +000414d0: 6564 2061 7320 2767 7275 622d 6d6b 7265 ed as 'grub-mkre │ │ │ │ +000414e0: 7363 7565 2720 6f70 7469 6f6e 7320 6172 scue' options ar │ │ │ │ +000414f0: 650a 7061 7373 6564 206f 6e20 6469 7265 e.passed on dire │ │ │ │ +00041500: 6374 6c79 2074 6f20 2778 6f72 7269 736f ctly to 'xorriso │ │ │ │ +00041510: 2720 696e 2027 6d6b 6973 6f66 7327 2065 ' in 'mkisofs' e │ │ │ │ +00041520: 6d75 6c61 7469 6f6e 206d 6f64 652e 2020 mulation mode. │ │ │ │ +00041530: 4f70 7469 6f6e 730a 7061 7373 6564 2074 Options.passed t │ │ │ │ +00041540: 6f20 2778 6f72 7269 736f 2720 7769 6c6c o 'xorriso' will │ │ │ │ +00041550: 206e 6f72 6d61 6c6c 7920 6265 2069 6e74 normally be int │ │ │ │ +00041560: 6572 7072 6574 6564 2061 7320 276d 6b69 erpreted as 'mki │ │ │ │ +00041570: 736f 6673 2720 6f70 7469 6f6e 733b 0a69 sofs' options;.i │ │ │ │ +00041580: 6620 7468 6520 6f70 7469 6f6e 2027 2d2d f the option '-- │ │ │ │ +00041590: 2720 6973 2075 7365 642c 2074 6865 6e20 ' is used, then │ │ │ │ +000415a0: 616e 7974 6869 6e67 2061 6674 6572 2074 anything after t │ │ │ │ +000415b0: 6861 7420 7769 6c6c 2062 6520 696e 7465 hat will be inte │ │ │ │ +000415c0: 7270 7265 7465 640a 6173 206e 6174 6976 rpreted.as nativ │ │ │ │ +000415d0: 6520 2778 6f72 7269 736f 2720 6f70 7469 e 'xorriso' opti │ │ │ │ +000415e0: 6f6e 732e 0a0a 2020 204e 6f6e 2d6f 7074 ons... Non-opt │ │ │ │ +000415f0: 696f 6e20 6172 6775 6d65 6e74 7320 7370 ion arguments sp │ │ │ │ +00041600: 6563 6966 7920 6164 6469 7469 6f6e 616c ecify additional │ │ │ │ +00041610: 2073 6f75 7263 6520 6469 7265 6374 6f72 source director │ │ │ │ +00041620: 6965 732e 2020 5468 6973 2069 730a 636f ies. This is.co │ │ │ │ +00041630: 6d6d 6f6e 6c79 2075 7365 6420 746f 2061 mmonly used to a │ │ │ │ +00041640: 6464 2065 7874 7261 2066 696c 6573 2074 dd extra files t │ │ │ │ +00041650: 6f20 7468 6520 696d 6167 653a 0a0a 2020 o the image:.. │ │ │ │ +00041660: 2020 206d 6b64 6972 202d 7020 6469 736b mkdir -p disk │ │ │ │ +00041670: 2f62 6f6f 742f 6772 7562 0a20 2020 2020 /boot/grub. │ │ │ │ +00041680: 2861 6464 2065 7874 7261 2066 696c 6573 (add extra files │ │ │ │ +00041690: 2074 6f20 2764 6973 6b2f 626f 6f74 2f67 to 'disk/boot/g │ │ │ │ +000416a0: 7275 6227 290a 2020 2020 2067 7275 622d rub'). grub- │ │ │ │ +000416b0: 6d6b 7265 7363 7565 202d 6f20 6772 7562 mkrescue -o grub │ │ │ │ +000416c0: 2e69 736f 2064 6973 6b0a 0a20 2020 2767 .iso disk.. 'g │ │ │ │ +000416d0: 7275 622d 6d6b 7265 7363 7565 2720 6163 rub-mkrescue' ac │ │ │ │ +000416e0: 6365 7074 7320 7468 6520 666f 6c6c 6f77 cepts the follow │ │ │ │ +000416f0: 696e 6720 6f70 7469 6f6e 733a 0a0a 272d ing options:..'- │ │ │ │ +00041700: 2d68 656c 7027 0a20 2020 2020 5072 696e -help'. Prin │ │ │ │ +00041710: 7420 6120 7375 6d6d 6172 7920 6f66 2074 t a summary of t │ │ │ │ +00041720: 6865 2063 6f6d 6d61 6e64 2d6c 696e 6520 he command-line │ │ │ │ +00041730: 6f70 7469 6f6e 7320 616e 6420 6578 6974 options and exit │ │ │ │ +00041740: 2e0a 0a27 2d2d 7665 7273 696f 6e27 0a20 ...'--version'. │ │ │ │ +00041750: 2020 2020 5072 696e 7420 7468 6520 7665 Print the ve │ │ │ │ +00041760: 7273 696f 6e20 6e75 6d62 6572 206f 6620 rsion number of │ │ │ │ +00041770: 4752 5542 2061 6e64 2065 7869 742e 0a0a GRUB and exit... │ │ │ │ +00041780: 272d 6f20 4649 4c45 270a 272d 2d6f 7574 '-o FILE'.'--out │ │ │ │ +00041790: 7075 743d 4649 4c45 270a 2020 2020 2053 put=FILE'. S │ │ │ │ +000417a0: 6176 6520 6f75 7470 7574 2069 6e20 4649 ave output in FI │ │ │ │ +000417b0: 4c45 2e20 2054 6869 7320 226f 7074 696f LE. This "optio │ │ │ │ +000417c0: 6e22 2069 7320 7265 7175 6972 6564 2e0a n" is required.. │ │ │ │ +000417d0: 0a27 2d2d 6d6f 6475 6c65 733d 4d4f 4455 .'--modules=MODU │ │ │ │ +000417e0: 4c45 5327 0a20 2020 2020 5072 652d 6c6f LES'. Pre-lo │ │ │ │ +000417f0: 6164 2074 6865 206e 616d 6564 2047 5255 ad the named GRU │ │ │ │ +00041800: 4220 6d6f 6475 6c65 7320 696e 2074 6865 B modules in the │ │ │ │ +00041810: 2069 6d61 6765 2e20 204d 756c 7469 706c image. Multipl │ │ │ │ +00041820: 6520 656e 7472 6965 7320 696e 0a20 2020 e entries in. │ │ │ │ +00041830: 2020 4d4f 4455 4c45 5320 7368 6f75 6c64 MODULES should │ │ │ │ +00041840: 2062 6520 7365 7061 7261 7465 6420 6279 be separated by │ │ │ │ +00041850: 2077 6869 7465 7370 6163 6520 2873 6f20 whitespace (so │ │ │ │ +00041860: 796f 7520 7769 6c6c 2070 726f 6261 626c you will probabl │ │ │ │ +00041870: 790a 2020 2020 206e 6565 6420 746f 2071 y. need to q │ │ │ │ +00041880: 756f 7465 2074 6869 7320 666f 7220 796f uote this for yo │ │ │ │ +00041890: 7572 2073 6865 6c6c 292e 0a0a 272d 2d72 ur shell)...'--r │ │ │ │ +000418a0: 6f6d 2d64 6972 6563 746f 7279 3d44 4952 om-directory=DIR │ │ │ │ +000418b0: 270a 2020 2020 2049 6620 6765 6e65 7261 '. If genera │ │ │ │ +000418c0: 7469 6e67 2069 6d61 6765 7320 666f 7220 ting images for │ │ │ │ +000418d0: 7468 6520 5145 4d55 206f 7220 436f 7265 the QEMU or Core │ │ │ │ +000418e0: 626f 6f74 2070 6c61 7466 6f72 6d73 2c20 boot platforms, │ │ │ │ +000418f0: 636f 7079 2074 6865 0a20 2020 2020 7265 copy the. re │ │ │ │ +00041900: 7375 6c74 696e 6720 2771 656d 752e 696d sulting 'qemu.im │ │ │ │ +00041910: 6727 206f 7220 2763 6f72 6562 6f6f 742e g' or 'coreboot. │ │ │ │ +00041920: 656c 6627 2066 696c 6573 2072 6573 7065 elf' files respe │ │ │ │ +00041930: 6374 6976 656c 7920 746f 2074 6865 0a20 ctively to the. │ │ │ │ +00041940: 2020 2020 4449 5220 6469 7265 6374 6f72 DIR director │ │ │ │ +00041950: 7920 6173 2077 656c 6c20 6173 2069 6e63 y as well as inc │ │ │ │ +00041960: 6c75 6469 6e67 2074 6865 6d20 696e 2074 luding them in t │ │ │ │ +00041970: 6865 2069 6d61 6765 2e0a 0a27 2d2d 786f he image...'--xo │ │ │ │ +00041980: 7272 6973 6f3d 4649 4c45 270a 2020 2020 rriso=FILE'. │ │ │ │ +00041990: 2055 7365 2046 494c 4520 6173 2074 6865 Use FILE as the │ │ │ │ +000419a0: 2027 786f 7272 6973 6f27 2070 726f 6772 'xorriso' progr │ │ │ │ +000419b0: 616d 2c20 7261 7468 6572 2074 6861 6e20 am, rather than │ │ │ │ +000419c0: 7468 6520 6275 696c 742d 696e 0a20 2020 the built-in. │ │ │ │ +000419d0: 2020 6465 6661 756c 742e 0a0a 272d 2d67 default...'--g │ │ │ │ +000419e0: 7275 622d 6d6b 696d 6167 653d 4649 4c45 rub-mkimage=FILE │ │ │ │ +000419f0: 270a 2020 2020 2055 7365 2046 494c 4520 '. Use FILE │ │ │ │ +00041a00: 6173 2074 6865 2027 6772 7562 2d6d 6b69 as the 'grub-mki │ │ │ │ +00041a10: 6d61 6765 2720 7072 6f67 7261 6d2c 2072 mage' program, r │ │ │ │ +00041a20: 6174 6865 7220 7468 616e 2074 6865 2062 ather than the b │ │ │ │ +00041a30: 7569 6c74 2d69 6e0a 2020 2020 2064 6566 uilt-in. def │ │ │ │ +00041a40: 6175 6c74 2e0a 0a1f 0a46 696c 653a 2067 ault.....File: g │ │ │ │ +00041a50: 7275 622e 696e 666f 2c20 204e 6f64 653a rub.info, Node: │ │ │ │ +00041a60: 2049 6e76 6f6b 696e 6720 6772 7562 2d6d Invoking grub-m │ │ │ │ +00041a70: 6f75 6e74 2c20 204e 6578 743a 2049 6e76 ount, Next: Inv │ │ │ │ +00041a80: 6f6b 696e 6720 6772 7562 2d70 726f 6265 oking grub-probe │ │ │ │ +00041a90: 2c20 2050 7265 763a 2049 6e76 6f6b 696e , Prev: Invokin │ │ │ │ +00041aa0: 6720 6772 7562 2d6d 6b72 6573 6375 652c g grub-mkrescue, │ │ │ │ +00041ab0: 2020 5570 3a20 546f 700a 0a32 3820 496e Up: Top..28 In │ │ │ │ +00041ac0: 766f 6b69 6e67 2067 7275 622d 6d6f 756e voking grub-moun │ │ │ │ +00041ad0: 740a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a t.************** │ │ │ │ +00041ae0: 2a2a 2a2a 2a2a 2a2a 0a0a 5468 6520 7072 ********..The pr │ │ │ │ +00041af0: 6f67 7261 6d20 2767 7275 622d 6d6f 756e ogram 'grub-moun │ │ │ │ +00041b00: 7427 2070 6572 666f 726d 7320 6120 7265 t' performs a re │ │ │ │ +00041b10: 6164 2d6f 6e6c 7920 6d6f 756e 7420 6f66 ad-only mount of │ │ │ │ +00041b20: 2061 6e79 2066 696c 6520 7379 7374 656d any file system │ │ │ │ +00041b30: 0a6f 7220 6669 6c65 2073 7973 7465 6d20 .or file system │ │ │ │ +00041b40: 696d 6167 6520 7468 6174 2047 5255 4220 image that GRUB │ │ │ │ +00041b50: 756e 6465 7273 7461 6e64 732c 2075 7369 understands, usi │ │ │ │ +00041b60: 6e67 2047 5255 4227 7320 6669 6c65 2073 ng GRUB's file s │ │ │ │ +00041b70: 7973 7465 6d0a 6472 6976 6572 7320 7669 ystem.drivers vi │ │ │ │ +00041b80: 6120 4655 5345 2e20 2849 7420 6973 206f a FUSE. (It is o │ │ │ │ +00041b90: 6e6c 7920 6176 6169 6c61 626c 6520 6966 nly available if │ │ │ │ +00041ba0: 2046 5553 4520 6465 7665 6c6f 706d 656e FUSE developmen │ │ │ │ +00041bb0: 7420 6669 6c65 7320 7765 7265 0a70 7265 t files were.pre │ │ │ │ +00041bc0: 7365 6e74 2077 6865 6e20 4752 5542 2077 sent when GRUB w │ │ │ │ +00041bd0: 6173 2062 7569 6c74 2e29 2020 5468 6973 as built.) This │ │ │ │ +00041be0: 2068 6173 2061 206e 756d 6265 7220 6f66 has a number of │ │ │ │ +00041bf0: 2075 7365 733a 0a0a 2020 202a 2049 7420 uses:.. * It │ │ │ │ +00041c00: 7072 6f76 6964 6573 2061 2063 6f6e 7665 provides a conve │ │ │ │ +00041c10: 6e69 656e 7420 7761 7920 746f 2063 6865 nient way to che │ │ │ │ +00041c20: 636b 2068 6f77 2047 5255 4220 7769 6c6c ck how GRUB will │ │ │ │ +00041c30: 2076 6965 7720 6120 6669 6c65 0a20 2020 view a file. │ │ │ │ +00041c40: 2020 7379 7374 656d 2061 7420 626f 6f74 system at boot │ │ │ │ +00041c50: 2074 696d 652e 2020 596f 7520 6361 6e20 time. You can │ │ │ │ +00041c60: 7573 6520 6e6f 726d 616c 2063 6f6d 6d61 use normal comma │ │ │ │ +00041c70: 6e64 2d6c 696e 6520 746f 6f6c 7320 746f nd-line tools to │ │ │ │ +00041c80: 0a20 2020 2020 636f 6d70 6172 6520 7468 . compare th │ │ │ │ +00041c90: 6174 2076 6965 7720 7769 7468 2074 6861 at view with tha │ │ │ │ +00041ca0: 7420 6f66 2079 6f75 7220 6f70 6572 6174 t of your operat │ │ │ │ +00041cb0: 696e 6720 7379 7374 656d 2c20 6d61 6b69 ing system, maki │ │ │ │ +00041cc0: 6e67 2069 740a 2020 2020 2065 6173 7920 ng it. easy │ │ │ │ +00041cd0: 746f 2066 696e 6420 6275 6773 2e0a 0a20 to find bugs... │ │ │ │ +00041ce0: 2020 2a20 4974 206f 6666 6572 7320 7472 * It offers tr │ │ │ │ +00041cf0: 7565 2072 6561 642d 6f6e 6c79 206d 6f75 ue read-only mou │ │ │ │ +00041d00: 6e74 732e 2020 4c69 6e75 7820 646f 6573 nts. Linux does │ │ │ │ +00041d10: 206e 6f74 2068 6176 6520 7468 6573 6520 not have these │ │ │ │ +00041d20: 666f 720a 2020 2020 206a 6f75 726e 616c for. journal │ │ │ │ +00041d30: 6c69 6e67 2066 696c 6520 7379 7374 656d ling file system │ │ │ │ +00041d40: 732c 2062 6563 6175 7365 2069 7420 7769 s, because it wi │ │ │ │ +00041d50: 6c6c 2061 6c77 6179 7320 6174 7465 6d70 ll always attemp │ │ │ │ +00041d60: 7420 746f 2072 6570 6c61 790a 2020 2020 t to replay. │ │ │ │ +00041d70: 2074 6865 206a 6f75 726e 616c 2061 7420 the journal at │ │ │ │ +00041d80: 6d6f 756e 7420 7469 6d65 3b20 7768 696c mount time; whil │ │ │ │ +00041d90: 6520 796f 7520 6361 6e20 7465 6d70 6f72 e you can tempor │ │ │ │ +00041da0: 6172 696c 7920 6d61 726b 2074 6865 2062 arily mark the b │ │ │ │ +00041db0: 6c6f 636b 0a20 2020 2020 6465 7669 6365 lock. device │ │ │ │ +00041dc0: 2072 6561 642d 6f6e 6c79 2074 6f20 6176 read-only to av │ │ │ │ +00041dd0: 6f69 6420 7468 6973 2c20 7468 6174 2063 oid this, that c │ │ │ │ +00041de0: 6175 7365 7320 7468 6520 6d6f 756e 7420 auses the mount │ │ │ │ +00041df0: 746f 2066 6169 6c2e 0a20 2020 2020 5369 to fail.. Si │ │ │ │ +00041e00: 6e63 6520 4752 5542 2069 6e74 656e 7469 nce GRUB intenti │ │ │ │ +00041e10: 6f6e 616c 6c79 2063 6f6e 7461 696e 7320 onally contains │ │ │ │ +00041e20: 6e6f 2063 6f64 6520 666f 7220 7772 6974 no code for writ │ │ │ │ +00041e30: 696e 6720 746f 2066 696c 650a 2020 2020 ing to file. │ │ │ │ +00041e40: 2073 7973 7465 6d73 2c20 6974 2063 616e systems, it can │ │ │ │ +00041e50: 2065 6173 696c 7920 7072 6f76 6964 6520 easily provide │ │ │ │ +00041e60: 6120 6775 6172 616e 7465 6564 2072 6561 a guaranteed rea │ │ │ │ +00041e70: 642d 6f6e 6c79 206d 6f75 6e74 0a20 2020 d-only mount. │ │ │ │ +00041e80: 2020 6d65 6368 616e 6973 6d2e 0a0a 2020 mechanism... │ │ │ │ +00041e90: 202a 2049 7420 616c 6c6f 7773 2079 6f75 * It allows you │ │ │ │ +00041ea0: 2074 6f20 6578 616d 696e 6520 616e 7920 to examine any │ │ │ │ +00041eb0: 6669 6c65 2073 7973 7465 6d20 7468 6174 file system that │ │ │ │ +00041ec0: 2047 5255 4220 756e 6465 7273 7461 6e64 GRUB understand │ │ │ │ +00041ed0: 730a 2020 2020 2077 6974 686f 7574 206e s. without n │ │ │ │ +00041ee0: 6565 6469 6e67 2074 6f20 6c6f 6164 2061 eeding to load a │ │ │ │ +00041ef0: 6464 6974 696f 6e61 6c20 6d6f 6475 6c65 dditional module │ │ │ │ +00041f00: 7320 696e 746f 2079 6f75 7220 7275 6e6e s into your runn │ │ │ │ +00041f10: 696e 670a 2020 2020 206b 6572 6e65 6c2c ing. kernel, │ │ │ │ +00041f20: 2077 6869 6368 206d 6179 2062 6520 7573 which may be us │ │ │ │ +00041f30: 6566 756c 2069 6e20 636f 6e73 7472 6169 eful in constrai │ │ │ │ +00041f40: 6e65 6420 656e 7669 726f 6e6d 656e 7473 ned environments │ │ │ │ +00041f50: 2073 7563 6820 6173 0a20 2020 2020 696e such as. in │ │ │ │ +00041f60: 7374 616c 6c65 7273 2e0a 0a20 2020 2a20 stallers... * │ │ │ │ +00041f70: 5369 6e63 6520 6974 2063 616e 2065 7861 Since it can exa │ │ │ │ +00041f80: 6d69 6e65 2066 696c 6520 7379 7374 656d mine file system │ │ │ │ +00041f90: 2069 6d61 6765 7320 2863 6f6e 7461 696e images (contain │ │ │ │ +00041fa0: 6564 2069 6e20 7265 6775 6c61 720a 2020 ed in regular. │ │ │ │ +00041fb0: 2020 2066 696c 6573 2920 6a75 7374 2061 files) just a │ │ │ │ +00041fc0: 7320 6561 7369 6c79 2061 7320 6669 6c65 s easily as file │ │ │ │ +00041fd0: 2073 7973 7465 6d73 206f 6e20 626c 6f63 systems on bloc │ │ │ │ +00041fe0: 6b20 6465 7669 6365 732c 2079 6f75 2063 k devices, you c │ │ │ │ +00041ff0: 616e 2075 7365 0a20 2020 2020 6974 2074 an use. it t │ │ │ │ +00042000: 6f20 696e 7370 6563 7420 616e 7920 6669 o inspect any fi │ │ │ │ +00042010: 6c65 2073 7973 7465 6d20 696d 6167 6520 le system image │ │ │ │ +00042020: 7468 6174 2047 5255 4220 756e 6465 7273 that GRUB unders │ │ │ │ +00042030: 7461 6e64 7320 7769 7468 206f 6e6c 790a tands with only. │ │ │ │ +00042040: 2020 2020 2065 6e6f 7567 6820 7072 6976 enough priv │ │ │ │ +00042050: 696c 6567 6573 2074 6f20 7573 6520 4655 ileges to use FU │ │ │ │ +00042060: 5345 2c20 6576 656e 2069 6620 6e6f 626f SE, even if nobo │ │ │ │ +00042070: 6479 2068 6173 2079 6574 2077 7269 7474 dy has yet writt │ │ │ │ +00042080: 656e 2061 0a20 2020 2020 4655 5345 206d en a. FUSE m │ │ │ │ +00042090: 6f64 756c 6520 7370 6563 6966 6963 616c odule specifical │ │ │ │ +000420a0: 6c79 2066 6f72 2074 6861 7420 6669 6c65 ly for that file │ │ │ │ +000420b0: 2073 7973 7465 6d20 7479 7065 2e0a 0a20 system type... │ │ │ │ +000420c0: 2020 5573 696e 6720 2767 7275 622d 6d6f Using 'grub-mo │ │ │ │ +000420d0: 756e 7427 2069 7320 6e6f 726d 616c 6c79 unt' is normally │ │ │ │ +000420e0: 2061 7320 7369 6d70 6c65 2061 733a 0a0a as simple as:.. │ │ │ │ +000420f0: 2020 2020 2067 7275 622d 6d6f 756e 7420 grub-mount │ │ │ │ +00042100: 2f64 6576 2f73 6461 3120 2f6d 6e74 0a0a /dev/sda1 /mnt.. │ │ │ │ +00042110: 2020 2027 6772 7562 2d6d 6f75 6e74 2720 'grub-mount' │ │ │ │ +00042120: 6d75 7374 2062 6520 6769 7665 6e20 6f6e must be given on │ │ │ │ +00042130: 6520 6f72 206d 6f72 6520 696d 6167 6573 e or more images │ │ │ │ +00042140: 2061 6e64 2061 206d 6f75 6e74 2070 6f69 and a mount poi │ │ │ │ +00042150: 6e74 2061 730a 6e6f 6e2d 6f70 7469 6f6e nt as.non-option │ │ │ │ +00042160: 2061 7267 756d 656e 7473 2028 6966 2069 arguments (if i │ │ │ │ +00042170: 7420 6973 2067 6976 656e 206d 6f72 6520 t is given more │ │ │ │ +00042180: 7468 616e 206f 6e65 2069 6d61 6765 2c20 than one image, │ │ │ │ +00042190: 6974 2077 696c 6c20 7472 6561 740a 7468 it will treat.th │ │ │ │ +000421a0: 656d 2061 7320 6120 5241 4944 2073 6574 em as a RAID set │ │ │ │ +000421b0: 292c 2061 6e64 2061 6c73 6f20 6163 6365 ), and also acce │ │ │ │ +000421c0: 7074 7320 7468 6520 666f 6c6c 6f77 696e pts the followin │ │ │ │ +000421d0: 6720 6f70 7469 6f6e 733a 0a0a 272d 2d68 g options:..'--h │ │ │ │ +000421e0: 656c 7027 0a20 2020 2020 5072 696e 7420 elp'. Print │ │ │ │ +000421f0: 6120 7375 6d6d 6172 7920 6f66 2074 6865 a summary of the │ │ │ │ +00042200: 2063 6f6d 6d61 6e64 2d6c 696e 6520 6f70 command-line op │ │ │ │ +00042210: 7469 6f6e 7320 616e 6420 6578 6974 2e0a tions and exit.. │ │ │ │ +00042220: 0a27 2d2d 7665 7273 696f 6e27 0a20 2020 .'--version'. │ │ │ │ +00042230: 2020 5072 696e 7420 7468 6520 7665 7273 Print the vers │ │ │ │ +00042240: 696f 6e20 6e75 6d62 6572 206f 6620 4752 ion number of GR │ │ │ │ +00042250: 5542 2061 6e64 2065 7869 742e 0a0a 272d UB and exit...'- │ │ │ │ +00042260: 4327 0a27 2d2d 6372 7970 746f 270a 2020 C'.'--crypto'. │ │ │ │ +00042270: 2020 204d 6f75 6e74 2065 6e63 7279 7074 Mount encrypt │ │ │ │ +00042280: 6564 2064 6576 6963 6573 2c20 7072 6f6d ed devices, prom │ │ │ │ +00042290: 7074 696e 6720 666f 7220 6120 7061 7373 pting for a pass │ │ │ │ +000422a0: 7068 7261 7365 2069 6620 6e65 6365 7373 phrase if necess │ │ │ │ +000422b0: 6172 792e 0a0a 272d 6420 5354 5249 4e47 ary...'-d STRING │ │ │ │ +000422c0: 270a 272d 2d64 6562 7567 3d53 5452 494e '.'--debug=STRIN │ │ │ │ +000422d0: 4727 0a20 2020 2020 5368 6f77 2064 6562 G'. Show deb │ │ │ │ +000422e0: 7567 6769 6e67 206f 7574 7075 7420 666f ugging output fo │ │ │ │ +000422f0: 7220 636f 6e64 6974 696f 6e73 206d 6174 r conditions mat │ │ │ │ +00042300: 6368 696e 6720 5354 5249 4e47 2e0a 0a27 ching STRING...' │ │ │ │ +00042310: 2d4b 2070 726f 6d70 747c 4649 4c45 270a -K prompt|FILE'. │ │ │ │ +00042320: 272d 2d7a 6673 2d6b 6579 3d70 726f 6d70 '--zfs-key=promp │ │ │ │ +00042330: 747c 4649 4c45 270a 2020 2020 204c 6f61 t|FILE'. Loa │ │ │ │ +00042340: 6420 6120 5a46 5320 656e 6372 7970 7469 d a ZFS encrypti │ │ │ │ +00042350: 6f6e 206b 6579 2e20 2049 6620 796f 7520 on key. If you │ │ │ │ +00042360: 7573 6520 2770 726f 6d70 7427 2061 7320 use 'prompt' as │ │ │ │ +00042370: 7468 6520 6172 6775 6d65 6e74 2c0a 2020 the argument,. │ │ │ │ +00042380: 2020 2027 6772 7562 2d6d 6f75 6e74 2720 'grub-mount' │ │ │ │ +00042390: 7769 6c6c 2072 6561 6420 6120 7061 7373 will read a pass │ │ │ │ +000423a0: 7068 7261 7365 2066 726f 6d20 7468 6520 phrase from the │ │ │ │ +000423b0: 7465 726d 696e 616c 3b20 6f74 6865 7277 terminal; otherw │ │ │ │ +000423c0: 6973 652c 0a20 2020 2020 6974 2077 696c ise,. it wil │ │ │ │ +000423d0: 6c20 7265 6164 206b 6579 206d 6174 6572 l read key mater │ │ │ │ +000423e0: 6961 6c20 6672 6f6d 2074 6865 2073 7065 ial from the spe │ │ │ │ +000423f0: 6369 6669 6564 2066 696c 652e 0a0a 272d cified file...'- │ │ │ │ +00042400: 7220 4445 5649 4345 270a 272d 2d72 6f6f r DEVICE'.'--roo │ │ │ │ +00042410: 743d 4445 5649 4345 270a 2020 2020 2053 t=DEVICE'. S │ │ │ │ +00042420: 6574 2074 6865 2047 5255 4220 726f 6f74 et the GRUB root │ │ │ │ +00042430: 2064 6576 6963 6520 746f 2044 4556 4943 device to DEVIC │ │ │ │ +00042440: 452e 2020 596f 7520 646f 206e 6f74 206e E. You do not n │ │ │ │ +00042450: 6f72 6d61 6c6c 7920 6e65 6564 2074 6f0a ormally need to. │ │ │ │ +00042460: 2020 2020 2073 6574 2074 6869 733b 2027 set this; ' │ │ │ │ +00042470: 6772 7562 2d6d 6f75 6e74 2720 7769 6c6c grub-mount' will │ │ │ │ +00042480: 2061 7574 6f6d 6174 6963 616c 6c79 2073 automatically s │ │ │ │ +00042490: 6574 2074 6865 2072 6f6f 7420 6465 7669 et the root devi │ │ │ │ +000424a0: 6365 2074 6f0a 2020 2020 2074 6865 2072 ce to. the r │ │ │ │ +000424b0: 6f6f 7420 6f66 2074 6865 2073 7570 706c oot of the suppl │ │ │ │ +000424c0: 6965 6420 6669 6c65 2073 7973 7465 6d2e ied file system. │ │ │ │ +000424d0: 0a0a 2020 2020 2049 6620 4445 5649 4345 .. If DEVICE │ │ │ │ +000424e0: 2069 7320 6a75 7374 2061 206e 756d 6265 is just a numbe │ │ │ │ +000424f0: 722c 2074 6865 6e20 6974 2077 696c 6c20 r, then it will │ │ │ │ +00042500: 6265 2074 7265 6174 6564 2061 7320 6120 be treated as a │ │ │ │ +00042510: 7061 7274 6974 696f 6e0a 2020 2020 206e partition. n │ │ │ │ +00042520: 756d 6265 7220 7769 7468 696e 2074 6865 umber within the │ │ │ │ +00042530: 2073 7570 706c 6965 6420 696d 6167 652e supplied image. │ │ │ │ +00042540: 2020 5468 6973 206d 6561 6e73 2074 6861 This means tha │ │ │ │ +00042550: 742c 2069 6620 796f 7520 6861 7665 2061 t, if you have a │ │ │ │ +00042560: 6e0a 2020 2020 2069 6d61 6765 206f 6620 n. image of │ │ │ │ +00042570: 616e 2065 6e74 6972 6520 6469 736b 2069 an entire disk i │ │ │ │ +00042580: 6e20 2764 6973 6b2e 696d 6727 2c20 7468 n 'disk.img', th │ │ │ │ +00042590: 656e 2079 6f75 2063 616e 2075 7365 2074 en you can use t │ │ │ │ +000425a0: 6869 730a 2020 2020 2063 6f6d 6d61 6e64 his. command │ │ │ │ +000425b0: 2074 6f20 6d6f 756e 7420 6974 7320 7365 to mount its se │ │ │ │ +000425c0: 636f 6e64 2070 6172 7469 7469 6f6e 3a0a cond partition:. │ │ │ │ +000425d0: 0a20 2020 2020 2020 2020 2067 7275 622d . grub- │ │ │ │ +000425e0: 6d6f 756e 7420 2d72 2032 2064 6973 6b2e mount -r 2 disk. │ │ │ │ +000425f0: 696d 6720 6d6f 756e 742d 706f 696e 740a img mount-point. │ │ │ │ +00042600: 0a27 2d76 270a 272d 2d76 6572 626f 7365 .'-v'.'--verbose │ │ │ │ +00042610: 270a 2020 2020 2050 7269 6e74 2076 6572 '. Print ver │ │ │ │ +00042620: 626f 7365 206d 6573 7361 6765 732e 0a0a bose messages... │ │ │ │ +00042630: 1f0a 4669 6c65 3a20 6772 7562 2e69 6e66 ..File: grub.inf │ │ │ │ +00042640: 6f2c 2020 4e6f 6465 3a20 496e 766f 6b69 o, Node: Invoki │ │ │ │ +00042650: 6e67 2067 7275 622d 7072 6f62 652c 2020 ng grub-probe, │ │ │ │ +00042660: 4e65 7874 3a20 496e 766f 6b69 6e67 2067 Next: Invoking g │ │ │ │ +00042670: 7275 622d 7363 7269 7074 2d63 6865 636b rub-script-check │ │ │ │ +00042680: 2c20 2050 7265 763a 2049 6e76 6f6b 696e , Prev: Invokin │ │ │ │ +00042690: 6720 6772 7562 2d6d 6f75 6e74 2c20 2055 g grub-mount, U │ │ │ │ +000426a0: 703a 2054 6f70 0a0a 3239 2049 6e76 6f6b p: Top..29 Invok │ │ │ │ +000426b0: 696e 6720 6772 7562 2d70 726f 6265 0a2a ing grub-probe.* │ │ │ │ 000426c0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ -000426d0: 2a0a 0a54 6865 2070 726f 6772 616d 2027 *..The program ' │ │ │ │ -000426e0: 6772 7562 2d70 726f 6265 2720 7072 6f62 grub-probe' prob │ │ │ │ -000426f0: 6573 2064 6576 6963 6520 696e 666f 726d es device inform │ │ │ │ -00042700: 6174 696f 6e20 666f 7220 6120 6769 7665 ation for a give │ │ │ │ -00042710: 6e20 7061 7468 206f 720a 6465 7669 6365 n path or.device │ │ │ │ -00042720: 2e0a 0a20 2020 2020 6772 7562 2d70 726f ... grub-pro │ │ │ │ -00042730: 6265 202d 2d74 6172 6765 743d 6673 202f be --target=fs / │ │ │ │ -00042740: 626f 6f74 2f67 7275 620a 2020 2020 2067 boot/grub. g │ │ │ │ -00042750: 7275 622d 7072 6f62 6520 2d2d 7461 7267 rub-probe --targ │ │ │ │ -00042760: 6574 3d64 7269 7665 202d 2d64 6576 6963 et=drive --devic │ │ │ │ -00042770: 6520 2f64 6576 2f73 6461 310a 0a20 2020 e /dev/sda1.. │ │ │ │ -00042780: 2767 7275 622d 7072 6f62 6527 206d 7573 'grub-probe' mus │ │ │ │ -00042790: 7420 6265 2067 6976 656e 2061 2070 6174 t be given a pat │ │ │ │ -000427a0: 6820 6f72 2064 6576 6963 6520 6173 2061 h or device as a │ │ │ │ -000427b0: 206e 6f6e 2d6f 7074 696f 6e20 6172 6775 non-option argu │ │ │ │ -000427c0: 6d65 6e74 2c0a 616e 6420 616c 736f 2061 ment,.and also a │ │ │ │ -000427d0: 6363 6570 7473 2074 6865 2066 6f6c 6c6f ccepts the follo │ │ │ │ -000427e0: 7769 6e67 206f 7074 696f 6e73 3a0a 0a27 wing options:..' │ │ │ │ -000427f0: 2d2d 6865 6c70 270a 2020 2020 2050 7269 --help'. Pri │ │ │ │ -00042800: 6e74 2061 2073 756d 6d61 7279 206f 6620 nt a summary of │ │ │ │ -00042810: 7468 6520 636f 6d6d 616e 642d 6c69 6e65 the command-line │ │ │ │ -00042820: 206f 7074 696f 6e73 2061 6e64 2065 7869 options and exi │ │ │ │ -00042830: 742e 0a0a 272d 2d76 6572 7369 6f6e 270a t...'--version'. │ │ │ │ -00042840: 2020 2020 2050 7269 6e74 2074 6865 2076 Print the v │ │ │ │ -00042850: 6572 7369 6f6e 206e 756d 6265 7220 6f66 ersion number of │ │ │ │ -00042860: 2047 5255 4220 616e 6420 6578 6974 2e0a GRUB and exit.. │ │ │ │ -00042870: 0a27 2d64 270a 272d 2d64 6576 6963 6527 .'-d'.'--device' │ │ │ │ -00042880: 0a20 2020 2020 4966 2074 6869 7320 6f70 . If this op │ │ │ │ -00042890: 7469 6f6e 2069 7320 6769 7665 6e2c 2074 tion is given, t │ │ │ │ -000428a0: 6865 6e20 7468 6520 6e6f 6e2d 6f70 7469 hen the non-opti │ │ │ │ -000428b0: 6f6e 2061 7267 756d 656e 7420 6973 2061 on argument is a │ │ │ │ -000428c0: 2073 7973 7465 6d0a 2020 2020 2064 6576 system. dev │ │ │ │ -000428d0: 6963 6520 6e61 6d65 2028 7375 6368 2061 ice name (such a │ │ │ │ -000428e0: 7320 272f 6465 762f 7364 6131 2729 2c20 s '/dev/sda1'), │ │ │ │ -000428f0: 616e 6420 2767 7275 622d 7072 6f62 6527 and 'grub-probe' │ │ │ │ -00042900: 2077 696c 6c20 7072 696e 740a 2020 2020 will print. │ │ │ │ -00042910: 2069 6e66 6f72 6d61 7469 6f6e 2061 626f information abo │ │ │ │ -00042920: 7574 2074 6861 7420 6465 7669 6365 2e20 ut that device. │ │ │ │ -00042930: 2049 6620 6974 2069 7320 6e6f 7420 6769 If it is not gi │ │ │ │ -00042940: 7665 6e2c 2074 6865 6e20 7468 650a 2020 ven, then the. │ │ │ │ -00042950: 2020 206e 6f6e 2d6f 7074 696f 6e20 6172 non-option ar │ │ │ │ -00042960: 6775 6d65 6e74 2069 7320 6120 6669 6c65 gument is a file │ │ │ │ -00042970: 7379 7374 656d 2070 6174 6820 2873 7563 system path (suc │ │ │ │ -00042980: 6820 6173 2027 2f62 6f6f 742f 6772 7562 h as '/boot/grub │ │ │ │ -00042990: 2729 2c0a 2020 2020 2061 6e64 2027 6772 '),. and 'gr │ │ │ │ -000429a0: 7562 2d70 726f 6265 2720 7769 6c6c 2070 ub-probe' will p │ │ │ │ -000429b0: 7269 6e74 2069 6e66 6f72 6d61 7469 6f6e rint information │ │ │ │ -000429c0: 2061 626f 7574 2074 6865 2064 6576 6963 about the devic │ │ │ │ -000429d0: 6520 636f 6e74 6169 6e69 6e67 0a20 2020 e containing. │ │ │ │ -000429e0: 2020 7468 6174 2070 6172 7420 6f66 2074 that part of t │ │ │ │ -000429f0: 6865 2066 696c 6573 7973 7465 6d2e 0a0a he filesystem... │ │ │ │ -00042a00: 272d 6d20 4649 4c45 270a 272d 2d64 6576 '-m FILE'.'--dev │ │ │ │ -00042a10: 6963 652d 6d61 703d 4649 4c45 270a 2020 ice-map=FILE'. │ │ │ │ -00042a20: 2020 2055 7365 2046 494c 4520 6173 2074 Use FILE as t │ │ │ │ -00042a30: 6865 2064 6576 6963 6520 6d61 7020 282a he device map (* │ │ │ │ -00042a40: 6e6f 7465 2044 6576 6963 6520 6d61 703a note Device map: │ │ │ │ -00042a50: 3a29 2072 6174 6865 7220 7468 616e 2074 :) rather than t │ │ │ │ -00042a60: 6865 0a20 2020 2020 6465 6661 756c 742c he. default, │ │ │ │ -00042a70: 2075 7375 616c 6c79 2027 2f62 6f6f 742f usually '/boot/ │ │ │ │ -00042a80: 6772 7562 2f64 6576 6963 652e 6d61 7027 grub/device.map' │ │ │ │ -00042a90: 2e0a 0a27 2d74 2054 4152 4745 5427 0a27 ...'-t TARGET'.' │ │ │ │ -00042aa0: 2d2d 7461 7267 6574 3d54 4152 4745 5427 --target=TARGET' │ │ │ │ -00042ab0: 0a20 2020 2020 5072 696e 7420 696e 666f . Print info │ │ │ │ -00042ac0: 726d 6174 696f 6e20 6162 6f75 7420 7468 rmation about th │ │ │ │ -00042ad0: 6520 6769 7665 6e20 7061 7468 206f 7220 e given path or │ │ │ │ -00042ae0: 6465 7669 6365 2061 7320 6465 6669 6e65 device as define │ │ │ │ -00042af0: 6420 6279 0a20 2020 2020 5441 5247 4554 d by. TARGET │ │ │ │ -00042b00: 2e20 2054 6865 2061 7661 696c 6162 6c65 . The available │ │ │ │ -00042b10: 2074 6172 6765 7473 2061 6e64 2074 6865 targets and the │ │ │ │ -00042b20: 6972 206d 6561 6e69 6e67 7320 6172 653a ir meanings are: │ │ │ │ -00042b30: 0a0a 2020 2020 2027 6673 270a 2020 2020 .. 'fs'. │ │ │ │ -00042b40: 2020 2020 2020 4752 5542 2066 696c 6573 GRUB files │ │ │ │ -00042b50: 7973 7465 6d20 6d6f 6475 6c65 2e0a 2020 ystem module.. │ │ │ │ -00042b60: 2020 2027 6673 5f75 7569 6427 0a20 2020 'fs_uuid'. │ │ │ │ -00042b70: 2020 2020 2020 2046 696c 6573 7973 7465 Filesyste │ │ │ │ -00042b80: 6d20 556e 6976 6572 7361 6c6c 7920 556e m Universally Un │ │ │ │ -00042b90: 6971 7565 2049 6465 6e74 6966 6965 7220 ique Identifier │ │ │ │ -00042ba0: 2855 5549 4429 2e0a 2020 2020 2027 6673 (UUID).. 'fs │ │ │ │ -00042bb0: 5f6c 6162 656c 270a 2020 2020 2020 2020 _label'. │ │ │ │ -00042bc0: 2020 4669 6c65 7379 7374 656d 206c 6162 Filesystem lab │ │ │ │ -00042bd0: 656c 2e0a 2020 2020 2027 6472 6976 6527 el.. 'drive' │ │ │ │ -00042be0: 0a20 2020 2020 2020 2020 2047 5255 4220 . GRUB │ │ │ │ -00042bf0: 6465 7669 6365 206e 616d 652e 0a20 2020 device name.. │ │ │ │ -00042c00: 2020 2764 6576 6963 6527 0a20 2020 2020 'device'. │ │ │ │ -00042c10: 2020 2020 2053 7973 7465 6d20 6465 7669 System devi │ │ │ │ -00042c20: 6365 206e 616d 652e 0a20 2020 2020 2770 ce name.. 'p │ │ │ │ -00042c30: 6172 746d 6170 270a 2020 2020 2020 2020 artmap'. │ │ │ │ -00042c40: 2020 4752 5542 2070 6172 7469 7469 6f6e GRUB partition │ │ │ │ -00042c50: 206d 6170 206d 6f64 756c 652e 0a20 2020 map module.. │ │ │ │ -00042c60: 2020 2761 6273 7472 6163 7469 6f6e 270a 'abstraction'. │ │ │ │ -00042c70: 2020 2020 2020 2020 2020 4752 5542 2061 GRUB a │ │ │ │ -00042c80: 6273 7472 6163 7469 6f6e 206d 6f64 756c bstraction modul │ │ │ │ -00042c90: 6520 2865 2e67 2e20 2027 6c76 6d27 292e e (e.g. 'lvm'). │ │ │ │ -00042ca0: 0a20 2020 2020 2763 7279 7074 6f64 6973 . 'cryptodis │ │ │ │ -00042cb0: 6b5f 7575 6964 270a 2020 2020 2020 2020 k_uuid'. │ │ │ │ -00042cc0: 2020 4372 7970 746f 2064 6576 6963 6520 Crypto device │ │ │ │ -00042cd0: 5555 4944 2e0a 2020 2020 2027 6d73 646f UUID.. 'msdo │ │ │ │ -00042ce0: 735f 7061 7274 7479 7065 270a 2020 2020 s_parttype'. │ │ │ │ -00042cf0: 2020 2020 2020 4d42 5220 7061 7274 6974 MBR partit │ │ │ │ -00042d00: 696f 6e20 7479 7065 2063 6f64 6520 2874 ion type code (t │ │ │ │ -00042d10: 776f 2068 6578 6164 6563 696d 616c 2064 wo hexadecimal d │ │ │ │ -00042d20: 6967 6974 7329 2e0a 2020 2020 2027 6869 igits).. 'hi │ │ │ │ -00042d30: 6e74 735f 7374 7269 6e67 270a 2020 2020 nts_string'. │ │ │ │ -00042d40: 2020 2020 2020 4120 7374 7269 6e67 206f A string o │ │ │ │ -00042d50: 6620 706c 6174 666f 726d 2073 6561 7263 f platform searc │ │ │ │ -00042d60: 6820 6869 6e74 7320 7375 6974 6162 6c65 h hints suitable │ │ │ │ -00042d70: 2066 6f72 2070 6173 7369 6e67 2074 6f20 for passing to │ │ │ │ -00042d80: 7468 650a 2020 2020 2020 2020 2020 2773 the. 's │ │ │ │ -00042d90: 6561 7263 6827 2063 6f6d 6d61 6e64 2028 earch' command ( │ │ │ │ -00042da0: 2a6e 6f74 6520 7365 6172 6368 3a3a 292e *note search::). │ │ │ │ -00042db0: 0a20 2020 2020 2762 696f 735f 6869 6e74 . 'bios_hint │ │ │ │ -00042dc0: 7327 0a20 2020 2020 2020 2020 2053 6561 s'. Sea │ │ │ │ -00042dd0: 7263 6820 6869 6e74 7320 666f 7220 7468 rch hints for th │ │ │ │ -00042de0: 6520 5043 2042 494f 5320 706c 6174 666f e PC BIOS platfo │ │ │ │ -00042df0: 726d 2e0a 2020 2020 2027 6965 6565 3132 rm.. 'ieee12 │ │ │ │ -00042e00: 3735 5f68 696e 7473 270a 2020 2020 2020 75_hints'. │ │ │ │ -00042e10: 2020 2020 5365 6172 6368 2068 696e 7473 Search hints │ │ │ │ -00042e20: 2066 6f72 2074 6865 2049 4545 4531 3237 for the IEEE127 │ │ │ │ -00042e30: 3520 706c 6174 666f 726d 2e0a 2020 2020 5 platform.. │ │ │ │ -00042e40: 2027 6261 7265 6d65 7461 6c5f 6869 6e74 'baremetal_hint │ │ │ │ -00042e50: 7327 0a20 2020 2020 2020 2020 2053 6561 s'. Sea │ │ │ │ -00042e60: 7263 6820 6869 6e74 7320 666f 7220 706c rch hints for pl │ │ │ │ -00042e70: 6174 666f 726d 7320 7768 6572 6520 6469 atforms where di │ │ │ │ -00042e80: 736b 7320 6172 6520 6164 6472 6573 7365 sks are addresse │ │ │ │ -00042e90: 6420 6469 7265 6374 6c79 0a20 2020 2020 d directly. │ │ │ │ -00042ea0: 2020 2020 2072 6174 6865 7220 7468 616e rather than │ │ │ │ -00042eb0: 2076 6961 2066 6972 6d77 6172 652e 0a20 via firmware.. │ │ │ │ -00042ec0: 2020 2020 2765 6669 5f68 696e 7473 270a 'efi_hints'. │ │ │ │ -00042ed0: 2020 2020 2020 2020 2020 5365 6172 6368 Search │ │ │ │ -00042ee0: 2068 696e 7473 2066 6f72 2074 6865 2045 hints for the E │ │ │ │ -00042ef0: 4649 2070 6c61 7466 6f72 6d2e 0a20 2020 FI platform.. │ │ │ │ -00042f00: 2020 2761 7263 5f68 696e 7473 270a 2020 'arc_hints'. │ │ │ │ -00042f10: 2020 2020 2020 2020 5365 6172 6368 2068 Search h │ │ │ │ -00042f20: 696e 7473 2066 6f72 2074 6865 2041 5243 ints for the ARC │ │ │ │ -00042f30: 2070 6c61 7466 6f72 6d2e 0a20 2020 2020 platform.. │ │ │ │ -00042f40: 2763 6f6d 7061 7469 6269 6c69 7479 5f68 'compatibility_h │ │ │ │ -00042f50: 696e 7427 0a20 2020 2020 2020 2020 2041 int'. A │ │ │ │ -00042f60: 2067 7565 7373 2061 7420 6120 7265 6173 guess at a reas │ │ │ │ -00042f70: 6f6e 6162 6c65 2047 5255 4220 6472 6976 onable GRUB driv │ │ │ │ -00042f80: 6520 6e61 6d65 2066 6f72 2074 6869 7320 e name for this │ │ │ │ -00042f90: 6465 7669 6365 2c20 7768 6963 680a 2020 device, which. │ │ │ │ -00042fa0: 2020 2020 2020 2020 6d61 7920 6265 2075 may be u │ │ │ │ -00042fb0: 7365 6420 6173 2061 2066 616c 6c62 6163 sed as a fallbac │ │ │ │ -00042fc0: 6b20 6966 2074 6865 2027 7365 6172 6368 k if the 'search │ │ │ │ -00042fd0: 2720 636f 6d6d 616e 6420 6661 696c 732e ' command fails. │ │ │ │ -00042fe0: 0a20 2020 2020 2764 6973 6b27 0a20 2020 . 'disk'. │ │ │ │ -00042ff0: 2020 2020 2020 2053 7973 7465 6d20 6465 System de │ │ │ │ -00043000: 7669 6365 206e 616d 6520 666f 7220 7468 vice name for th │ │ │ │ -00043010: 6520 7768 6f6c 6520 6469 736b 2e0a 0a27 e whole disk...' │ │ │ │ -00043020: 2d76 270a 272d 2d76 6572 626f 7365 270a -v'.'--verbose'. │ │ │ │ -00043030: 2020 2020 2050 7269 6e74 2076 6572 626f Print verbo │ │ │ │ -00043040: 7365 206d 6573 7361 6765 732e 0a0a 1f0a se messages..... │ │ │ │ -00043050: 4669 6c65 3a20 6772 7562 2e69 6e66 6f2c File: grub.info, │ │ │ │ -00043060: 2020 4e6f 6465 3a20 496e 766f 6b69 6e67 Node: Invoking │ │ │ │ -00043070: 2067 7275 622d 7363 7269 7074 2d63 6865 grub-script-che │ │ │ │ -00043080: 636b 2c20 204e 6578 743a 204f 6274 6169 ck, Next: Obtai │ │ │ │ -00043090: 6e69 6e67 2061 6e64 2042 7569 6c64 696e ning and Buildin │ │ │ │ -000430a0: 6720 4752 5542 2c20 2050 7265 763a 2049 g GRUB, Prev: I │ │ │ │ -000430b0: 6e76 6f6b 696e 6720 6772 7562 2d70 726f nvoking grub-pro │ │ │ │ -000430c0: 6265 2c20 2055 703a 2054 6f70 0a0a 3330 be, Up: Top..30 │ │ │ │ -000430d0: 2049 6e76 6f6b 696e 6720 6772 7562 2d73 Invoking grub-s │ │ │ │ -000430e0: 6372 6970 742d 6368 6563 6b0a 2a2a 2a2a cript-check.**** │ │ │ │ +000426d0: 2a2a 2a2a 2a0a 0a54 6865 2070 726f 6772 *****..The progr │ │ │ │ +000426e0: 616d 2027 6772 7562 2d70 726f 6265 2720 am 'grub-probe' │ │ │ │ +000426f0: 7072 6f62 6573 2064 6576 6963 6520 696e probes device in │ │ │ │ +00042700: 666f 726d 6174 696f 6e20 666f 7220 6120 formation for a │ │ │ │ +00042710: 6769 7665 6e20 7061 7468 206f 720a 6465 given path or.de │ │ │ │ +00042720: 7669 6365 2e0a 0a20 2020 2020 6772 7562 vice... grub │ │ │ │ +00042730: 2d70 726f 6265 202d 2d74 6172 6765 743d -probe --target= │ │ │ │ +00042740: 6673 202f 626f 6f74 2f67 7275 620a 2020 fs /boot/grub. │ │ │ │ +00042750: 2020 2067 7275 622d 7072 6f62 6520 2d2d grub-probe -- │ │ │ │ +00042760: 7461 7267 6574 3d64 7269 7665 202d 2d64 target=drive --d │ │ │ │ +00042770: 6576 6963 6520 2f64 6576 2f73 6461 310a evice /dev/sda1. │ │ │ │ +00042780: 0a20 2020 2767 7275 622d 7072 6f62 6527 . 'grub-probe' │ │ │ │ +00042790: 206d 7573 7420 6265 2067 6976 656e 2061 must be given a │ │ │ │ +000427a0: 2070 6174 6820 6f72 2064 6576 6963 6520 path or device │ │ │ │ +000427b0: 6173 2061 206e 6f6e 2d6f 7074 696f 6e20 as a non-option │ │ │ │ +000427c0: 6172 6775 6d65 6e74 2c0a 616e 6420 616c argument,.and al │ │ │ │ +000427d0: 736f 2061 6363 6570 7473 2074 6865 2066 so accepts the f │ │ │ │ +000427e0: 6f6c 6c6f 7769 6e67 206f 7074 696f 6e73 ollowing options │ │ │ │ +000427f0: 3a0a 0a27 2d2d 6865 6c70 270a 2020 2020 :..'--help'. │ │ │ │ +00042800: 2050 7269 6e74 2061 2073 756d 6d61 7279 Print a summary │ │ │ │ +00042810: 206f 6620 7468 6520 636f 6d6d 616e 642d of the command- │ │ │ │ +00042820: 6c69 6e65 206f 7074 696f 6e73 2061 6e64 line options and │ │ │ │ +00042830: 2065 7869 742e 0a0a 272d 2d76 6572 7369 exit...'--versi │ │ │ │ +00042840: 6f6e 270a 2020 2020 2050 7269 6e74 2074 on'. Print t │ │ │ │ +00042850: 6865 2076 6572 7369 6f6e 206e 756d 6265 he version numbe │ │ │ │ +00042860: 7220 6f66 2047 5255 4220 616e 6420 6578 r of GRUB and ex │ │ │ │ +00042870: 6974 2e0a 0a27 2d64 270a 272d 2d64 6576 it...'-d'.'--dev │ │ │ │ +00042880: 6963 6527 0a20 2020 2020 4966 2074 6869 ice'. If thi │ │ │ │ +00042890: 7320 6f70 7469 6f6e 2069 7320 6769 7665 s option is give │ │ │ │ +000428a0: 6e2c 2074 6865 6e20 7468 6520 6e6f 6e2d n, then the non- │ │ │ │ +000428b0: 6f70 7469 6f6e 2061 7267 756d 656e 7420 option argument │ │ │ │ +000428c0: 6973 2061 2073 7973 7465 6d0a 2020 2020 is a system. │ │ │ │ +000428d0: 2064 6576 6963 6520 6e61 6d65 2028 7375 device name (su │ │ │ │ +000428e0: 6368 2061 7320 272f 6465 762f 7364 6131 ch as '/dev/sda1 │ │ │ │ +000428f0: 2729 2c20 616e 6420 2767 7275 622d 7072 '), and 'grub-pr │ │ │ │ +00042900: 6f62 6527 2077 696c 6c20 7072 696e 740a obe' will print. │ │ │ │ +00042910: 2020 2020 2069 6e66 6f72 6d61 7469 6f6e information │ │ │ │ +00042920: 2061 626f 7574 2074 6861 7420 6465 7669 about that devi │ │ │ │ +00042930: 6365 2e20 2049 6620 6974 2069 7320 6e6f ce. If it is no │ │ │ │ +00042940: 7420 6769 7665 6e2c 2074 6865 6e20 7468 t given, then th │ │ │ │ +00042950: 650a 2020 2020 206e 6f6e 2d6f 7074 696f e. non-optio │ │ │ │ +00042960: 6e20 6172 6775 6d65 6e74 2069 7320 6120 n argument is a │ │ │ │ +00042970: 6669 6c65 7379 7374 656d 2070 6174 6820 filesystem path │ │ │ │ +00042980: 2873 7563 6820 6173 2027 2f62 6f6f 742f (such as '/boot/ │ │ │ │ +00042990: 6772 7562 2729 2c0a 2020 2020 2061 6e64 grub'),. and │ │ │ │ +000429a0: 2027 6772 7562 2d70 726f 6265 2720 7769 'grub-probe' wi │ │ │ │ +000429b0: 6c6c 2070 7269 6e74 2069 6e66 6f72 6d61 ll print informa │ │ │ │ +000429c0: 7469 6f6e 2061 626f 7574 2074 6865 2064 tion about the d │ │ │ │ +000429d0: 6576 6963 6520 636f 6e74 6169 6e69 6e67 evice containing │ │ │ │ +000429e0: 0a20 2020 2020 7468 6174 2070 6172 7420 . that part │ │ │ │ +000429f0: 6f66 2074 6865 2066 696c 6573 7973 7465 of the filesyste │ │ │ │ +00042a00: 6d2e 0a0a 272d 6d20 4649 4c45 270a 272d m...'-m FILE'.'- │ │ │ │ +00042a10: 2d64 6576 6963 652d 6d61 703d 4649 4c45 -device-map=FILE │ │ │ │ +00042a20: 270a 2020 2020 2055 7365 2046 494c 4520 '. Use FILE │ │ │ │ +00042a30: 6173 2074 6865 2064 6576 6963 6520 6d61 as the device ma │ │ │ │ +00042a40: 7020 282a 6e6f 7465 2044 6576 6963 6520 p (*note Device │ │ │ │ +00042a50: 6d61 703a 3a29 2072 6174 6865 7220 7468 map::) rather th │ │ │ │ +00042a60: 616e 2074 6865 0a20 2020 2020 6465 6661 an the. defa │ │ │ │ +00042a70: 756c 742c 2075 7375 616c 6c79 2027 2f62 ult, usually '/b │ │ │ │ +00042a80: 6f6f 742f 6772 7562 2f64 6576 6963 652e oot/grub/device. │ │ │ │ +00042a90: 6d61 7027 2e0a 0a27 2d74 2054 4152 4745 map'...'-t TARGE │ │ │ │ +00042aa0: 5427 0a27 2d2d 7461 7267 6574 3d54 4152 T'.'--target=TAR │ │ │ │ +00042ab0: 4745 5427 0a20 2020 2020 5072 696e 7420 GET'. Print │ │ │ │ +00042ac0: 696e 666f 726d 6174 696f 6e20 6162 6f75 information abou │ │ │ │ +00042ad0: 7420 7468 6520 6769 7665 6e20 7061 7468 t the given path │ │ │ │ +00042ae0: 206f 7220 6465 7669 6365 2061 7320 6465 or device as de │ │ │ │ +00042af0: 6669 6e65 6420 6279 0a20 2020 2020 5441 fined by. TA │ │ │ │ +00042b00: 5247 4554 2e20 2054 6865 2061 7661 696c RGET. The avail │ │ │ │ +00042b10: 6162 6c65 2074 6172 6765 7473 2061 6e64 able targets and │ │ │ │ +00042b20: 2074 6865 6972 206d 6561 6e69 6e67 7320 their meanings │ │ │ │ +00042b30: 6172 653a 0a0a 2020 2020 2027 6673 270a are:.. 'fs'. │ │ │ │ +00042b40: 2020 2020 2020 2020 2020 4752 5542 2066 GRUB f │ │ │ │ +00042b50: 696c 6573 7973 7465 6d20 6d6f 6475 6c65 ilesystem module │ │ │ │ +00042b60: 2e0a 2020 2020 2027 6673 5f75 7569 6427 .. 'fs_uuid' │ │ │ │ +00042b70: 0a20 2020 2020 2020 2020 2046 696c 6573 . Files │ │ │ │ +00042b80: 7973 7465 6d20 556e 6976 6572 7361 6c6c ystem Universall │ │ │ │ +00042b90: 7920 556e 6971 7565 2049 6465 6e74 6966 y Unique Identif │ │ │ │ +00042ba0: 6965 7220 2855 5549 4429 2e0a 2020 2020 ier (UUID).. │ │ │ │ +00042bb0: 2027 6673 5f6c 6162 656c 270a 2020 2020 'fs_label'. │ │ │ │ +00042bc0: 2020 2020 2020 4669 6c65 7379 7374 656d Filesystem │ │ │ │ +00042bd0: 206c 6162 656c 2e0a 2020 2020 2027 6472 label.. 'dr │ │ │ │ +00042be0: 6976 6527 0a20 2020 2020 2020 2020 2047 ive'. G │ │ │ │ +00042bf0: 5255 4220 6465 7669 6365 206e 616d 652e RUB device name. │ │ │ │ +00042c00: 0a20 2020 2020 2764 6576 6963 6527 0a20 . 'device'. │ │ │ │ +00042c10: 2020 2020 2020 2020 2053 7973 7465 6d20 System │ │ │ │ +00042c20: 6465 7669 6365 206e 616d 652e 0a20 2020 device name.. │ │ │ │ +00042c30: 2020 2770 6172 746d 6170 270a 2020 2020 'partmap'. │ │ │ │ +00042c40: 2020 2020 2020 4752 5542 2070 6172 7469 GRUB parti │ │ │ │ +00042c50: 7469 6f6e 206d 6170 206d 6f64 756c 652e tion map module. │ │ │ │ +00042c60: 0a20 2020 2020 2761 6273 7472 6163 7469 . 'abstracti │ │ │ │ +00042c70: 6f6e 270a 2020 2020 2020 2020 2020 4752 on'. GR │ │ │ │ +00042c80: 5542 2061 6273 7472 6163 7469 6f6e 206d UB abstraction m │ │ │ │ +00042c90: 6f64 756c 6520 2865 2e67 2e20 2027 6c76 odule (e.g. 'lv │ │ │ │ +00042ca0: 6d27 292e 0a20 2020 2020 2763 7279 7074 m').. 'crypt │ │ │ │ +00042cb0: 6f64 6973 6b5f 7575 6964 270a 2020 2020 odisk_uuid'. │ │ │ │ +00042cc0: 2020 2020 2020 4372 7970 746f 2064 6576 Crypto dev │ │ │ │ +00042cd0: 6963 6520 5555 4944 2e0a 2020 2020 2027 ice UUID.. ' │ │ │ │ +00042ce0: 6d73 646f 735f 7061 7274 7479 7065 270a msdos_parttype'. │ │ │ │ +00042cf0: 2020 2020 2020 2020 2020 4d42 5220 7061 MBR pa │ │ │ │ +00042d00: 7274 6974 696f 6e20 7479 7065 2063 6f64 rtition type cod │ │ │ │ +00042d10: 6520 2874 776f 2068 6578 6164 6563 696d e (two hexadecim │ │ │ │ +00042d20: 616c 2064 6967 6974 7329 2e0a 2020 2020 al digits).. │ │ │ │ +00042d30: 2027 6869 6e74 735f 7374 7269 6e67 270a 'hints_string'. │ │ │ │ +00042d40: 2020 2020 2020 2020 2020 4120 7374 7269 A stri │ │ │ │ +00042d50: 6e67 206f 6620 706c 6174 666f 726d 2073 ng of platform s │ │ │ │ +00042d60: 6561 7263 6820 6869 6e74 7320 7375 6974 earch hints suit │ │ │ │ +00042d70: 6162 6c65 2066 6f72 2070 6173 7369 6e67 able for passing │ │ │ │ +00042d80: 2074 6f20 7468 650a 2020 2020 2020 2020 to the. │ │ │ │ +00042d90: 2020 2773 6561 7263 6827 2063 6f6d 6d61 'search' comma │ │ │ │ +00042da0: 6e64 2028 2a6e 6f74 6520 7365 6172 6368 nd (*note search │ │ │ │ +00042db0: 3a3a 292e 0a20 2020 2020 2762 696f 735f ::).. 'bios_ │ │ │ │ +00042dc0: 6869 6e74 7327 0a20 2020 2020 2020 2020 hints'. │ │ │ │ +00042dd0: 2053 6561 7263 6820 6869 6e74 7320 666f Search hints fo │ │ │ │ +00042de0: 7220 7468 6520 5043 2042 494f 5320 706c r the PC BIOS pl │ │ │ │ +00042df0: 6174 666f 726d 2e0a 2020 2020 2027 6965 atform.. 'ie │ │ │ │ +00042e00: 6565 3132 3735 5f68 696e 7473 270a 2020 ee1275_hints'. │ │ │ │ +00042e10: 2020 2020 2020 2020 5365 6172 6368 2068 Search h │ │ │ │ +00042e20: 696e 7473 2066 6f72 2074 6865 2049 4545 ints for the IEE │ │ │ │ +00042e30: 4531 3237 3520 706c 6174 666f 726d 2e0a E1275 platform.. │ │ │ │ +00042e40: 2020 2020 2027 6261 7265 6d65 7461 6c5f 'baremetal_ │ │ │ │ +00042e50: 6869 6e74 7327 0a20 2020 2020 2020 2020 hints'. │ │ │ │ +00042e60: 2053 6561 7263 6820 6869 6e74 7320 666f Search hints fo │ │ │ │ +00042e70: 7220 706c 6174 666f 726d 7320 7768 6572 r platforms wher │ │ │ │ +00042e80: 6520 6469 736b 7320 6172 6520 6164 6472 e disks are addr │ │ │ │ +00042e90: 6573 7365 6420 6469 7265 6374 6c79 0a20 essed directly. │ │ │ │ +00042ea0: 2020 2020 2020 2020 2072 6174 6865 7220 rather │ │ │ │ +00042eb0: 7468 616e 2076 6961 2066 6972 6d77 6172 than via firmwar │ │ │ │ +00042ec0: 652e 0a20 2020 2020 2765 6669 5f68 696e e.. 'efi_hin │ │ │ │ +00042ed0: 7473 270a 2020 2020 2020 2020 2020 5365 ts'. Se │ │ │ │ +00042ee0: 6172 6368 2068 696e 7473 2066 6f72 2074 arch hints for t │ │ │ │ +00042ef0: 6865 2045 4649 2070 6c61 7466 6f72 6d2e he EFI platform. │ │ │ │ +00042f00: 0a20 2020 2020 2761 7263 5f68 696e 7473 . 'arc_hints │ │ │ │ +00042f10: 270a 2020 2020 2020 2020 2020 5365 6172 '. Sear │ │ │ │ +00042f20: 6368 2068 696e 7473 2066 6f72 2074 6865 ch hints for the │ │ │ │ +00042f30: 2041 5243 2070 6c61 7466 6f72 6d2e 0a20 ARC platform.. │ │ │ │ +00042f40: 2020 2020 2763 6f6d 7061 7469 6269 6c69 'compatibili │ │ │ │ +00042f50: 7479 5f68 696e 7427 0a20 2020 2020 2020 ty_hint'. │ │ │ │ +00042f60: 2020 2041 2067 7565 7373 2061 7420 6120 A guess at a │ │ │ │ +00042f70: 7265 6173 6f6e 6162 6c65 2047 5255 4220 reasonable GRUB │ │ │ │ +00042f80: 6472 6976 6520 6e61 6d65 2066 6f72 2074 drive name for t │ │ │ │ +00042f90: 6869 7320 6465 7669 6365 2c20 7768 6963 his device, whic │ │ │ │ +00042fa0: 680a 2020 2020 2020 2020 2020 6d61 7920 h. may │ │ │ │ +00042fb0: 6265 2075 7365 6420 6173 2061 2066 616c be used as a fal │ │ │ │ +00042fc0: 6c62 6163 6b20 6966 2074 6865 2027 7365 lback if the 'se │ │ │ │ +00042fd0: 6172 6368 2720 636f 6d6d 616e 6420 6661 arch' command fa │ │ │ │ +00042fe0: 696c 732e 0a20 2020 2020 2764 6973 6b27 ils.. 'disk' │ │ │ │ +00042ff0: 0a20 2020 2020 2020 2020 2053 7973 7465 . Syste │ │ │ │ +00043000: 6d20 6465 7669 6365 206e 616d 6520 666f m device name fo │ │ │ │ +00043010: 7220 7468 6520 7768 6f6c 6520 6469 736b r the whole disk │ │ │ │ +00043020: 2e0a 0a27 2d76 270a 272d 2d76 6572 626f ...'-v'.'--verbo │ │ │ │ +00043030: 7365 270a 2020 2020 2050 7269 6e74 2076 se'. Print v │ │ │ │ +00043040: 6572 626f 7365 206d 6573 7361 6765 732e erbose messages. │ │ │ │ +00043050: 0a0a 1f0a 4669 6c65 3a20 6772 7562 2e69 ....File: grub.i │ │ │ │ +00043060: 6e66 6f2c 2020 4e6f 6465 3a20 496e 766f nfo, Node: Invo │ │ │ │ +00043070: 6b69 6e67 2067 7275 622d 7363 7269 7074 king grub-script │ │ │ │ +00043080: 2d63 6865 636b 2c20 204e 6578 743a 204f -check, Next: O │ │ │ │ +00043090: 6274 6169 6e69 6e67 2061 6e64 2042 7569 btaining and Bui │ │ │ │ +000430a0: 6c64 696e 6720 4752 5542 2c20 2050 7265 lding GRUB, Pre │ │ │ │ +000430b0: 763a 2049 6e76 6f6b 696e 6720 6772 7562 v: Invoking grub │ │ │ │ +000430c0: 2d70 726f 6265 2c20 2055 703a 2054 6f70 -probe, Up: Top │ │ │ │ +000430d0: 0a0a 3330 2049 6e76 6f6b 696e 6720 6772 ..30 Invoking gr │ │ │ │ +000430e0: 7562 2d73 6372 6970 742d 6368 6563 6b0a ub-script-check. │ │ │ │ 000430f0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ -00043100: 2a2a 2a2a 2a2a 2a2a 2a0a 0a54 6865 2070 *********..The p │ │ │ │ -00043110: 726f 6772 616d 2027 6772 7562 2d73 6372 rogram 'grub-scr │ │ │ │ -00043120: 6970 742d 6368 6563 6b27 2074 616b 6573 ipt-check' takes │ │ │ │ -00043130: 2061 2047 5255 4220 7363 7269 7074 2066 a GRUB script f │ │ │ │ -00043140: 696c 6520 282a 6e6f 7465 0a53 6865 6c6c ile (*note.Shell │ │ │ │ -00043150: 2d6c 696b 6520 7363 7269 7074 696e 673a -like scripting: │ │ │ │ -00043160: 3a29 2061 6e64 2063 6865 636b 7320 6974 :) and checks it │ │ │ │ -00043170: 2066 6f72 2073 796e 7461 7820 6572 726f for syntax erro │ │ │ │ -00043180: 7273 2c20 7369 6d69 6c61 7220 746f 0a63 rs, similar to.c │ │ │ │ -00043190: 6f6d 6d61 6e64 7320 7375 6368 2061 7320 ommands such as │ │ │ │ -000431a0: 2773 6820 2d6e 272e 2020 4974 206d 6179 'sh -n'. It may │ │ │ │ -000431b0: 2074 616b 6520 6120 5041 5448 2061 7320 take a PATH as │ │ │ │ -000431c0: 6120 6e6f 6e2d 6f70 7469 6f6e 2061 7267 a non-option arg │ │ │ │ -000431d0: 756d 656e 743b 0a69 6620 6e6f 6e65 2069 ument;.if none i │ │ │ │ -000431e0: 7320 7375 7070 6c69 6564 2c20 6974 2077 s supplied, it w │ │ │ │ -000431f0: 696c 6c20 7265 6164 2066 726f 6d20 7374 ill read from st │ │ │ │ -00043200: 616e 6461 7264 2069 6e70 7574 2e0a 0a20 andard input... │ │ │ │ -00043210: 2020 2020 6772 7562 2d73 6372 6970 742d grub-script- │ │ │ │ -00043220: 6368 6563 6b20 2f62 6f6f 742f 6772 7562 check /boot/grub │ │ │ │ -00043230: 2f67 7275 622e 6366 670a 0a20 2020 2767 /grub.cfg.. 'g │ │ │ │ -00043240: 7275 622d 7363 7269 7074 2d63 6865 636b rub-script-check │ │ │ │ -00043250: 2720 6163 6365 7074 7320 7468 6520 666f ' accepts the fo │ │ │ │ -00043260: 6c6c 6f77 696e 6720 6f70 7469 6f6e 733a llowing options: │ │ │ │ -00043270: 0a0a 272d 2d68 656c 7027 0a20 2020 2020 ..'--help'. │ │ │ │ -00043280: 5072 696e 7420 6120 7375 6d6d 6172 7920 Print a summary │ │ │ │ -00043290: 6f66 2074 6865 2063 6f6d 6d61 6e64 2d6c of the command-l │ │ │ │ -000432a0: 696e 6520 6f70 7469 6f6e 7320 616e 6420 ine options and │ │ │ │ -000432b0: 6578 6974 2e0a 0a27 2d2d 7665 7273 696f exit...'--versio │ │ │ │ -000432c0: 6e27 0a20 2020 2020 5072 696e 7420 7468 n'. Print th │ │ │ │ -000432d0: 6520 7665 7273 696f 6e20 6e75 6d62 6572 e version number │ │ │ │ -000432e0: 206f 6620 4752 5542 2061 6e64 2065 7869 of GRUB and exi │ │ │ │ -000432f0: 742e 0a0a 272d 7627 0a27 2d2d 7665 7262 t...'-v'.'--verb │ │ │ │ -00043300: 6f73 6527 0a20 2020 2020 5072 696e 7420 ose'. Print │ │ │ │ -00043310: 6561 6368 206c 696e 6520 6f66 2069 6e70 each line of inp │ │ │ │ -00043320: 7574 2061 6674 6572 2072 6561 6469 6e67 ut after reading │ │ │ │ -00043330: 2069 742e 0a0a 1f0a 4669 6c65 3a20 6772 it.....File: gr │ │ │ │ -00043340: 7562 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ub.info, Node: │ │ │ │ -00043350: 4f62 7461 696e 696e 6720 616e 6420 4275 Obtaining and Bu │ │ │ │ -00043360: 696c 6469 6e67 2047 5255 422c 2020 4e65 ilding GRUB, Ne │ │ │ │ -00043370: 7874 3a20 5265 706f 7274 696e 6720 6275 xt: Reporting bu │ │ │ │ -00043380: 6773 2c20 2050 7265 763a 2049 6e76 6f6b gs, Prev: Invok │ │ │ │ -00043390: 696e 6720 6772 7562 2d73 6372 6970 742d ing grub-script- │ │ │ │ -000433a0: 6368 6563 6b2c 2020 5570 3a20 546f 700a check, Up: Top. │ │ │ │ -000433b0: 0a41 7070 656e 6469 7820 4120 486f 7720 .Appendix A How │ │ │ │ -000433c0: 746f 206f 6274 6169 6e20 616e 6420 6275 to obtain and bu │ │ │ │ -000433d0: 696c 6420 4752 5542 0a2a 2a2a 2a2a 2a2a ild GRUB.******* │ │ │ │ +00043100: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a0a 0a54 *************..T │ │ │ │ +00043110: 6865 2070 726f 6772 616d 2027 6772 7562 he program 'grub │ │ │ │ +00043120: 2d73 6372 6970 742d 6368 6563 6b27 2074 -script-check' t │ │ │ │ +00043130: 616b 6573 2061 2047 5255 4220 7363 7269 akes a GRUB scri │ │ │ │ +00043140: 7074 2066 696c 6520 282a 6e6f 7465 0a53 pt file (*note.S │ │ │ │ +00043150: 6865 6c6c 2d6c 696b 6520 7363 7269 7074 hell-like script │ │ │ │ +00043160: 696e 673a 3a29 2061 6e64 2063 6865 636b ing::) and check │ │ │ │ +00043170: 7320 6974 2066 6f72 2073 796e 7461 7820 s it for syntax │ │ │ │ +00043180: 6572 726f 7273 2c20 7369 6d69 6c61 7220 errors, similar │ │ │ │ +00043190: 746f 0a63 6f6d 6d61 6e64 7320 7375 6368 to.commands such │ │ │ │ +000431a0: 2061 7320 2773 6820 2d6e 272e 2020 4974 as 'sh -n'. It │ │ │ │ +000431b0: 206d 6179 2074 616b 6520 6120 5041 5448 may take a PATH │ │ │ │ +000431c0: 2061 7320 6120 6e6f 6e2d 6f70 7469 6f6e as a non-option │ │ │ │ +000431d0: 2061 7267 756d 656e 743b 0a69 6620 6e6f argument;.if no │ │ │ │ +000431e0: 6e65 2069 7320 7375 7070 6c69 6564 2c20 ne is supplied, │ │ │ │ +000431f0: 6974 2077 696c 6c20 7265 6164 2066 726f it will read fro │ │ │ │ +00043200: 6d20 7374 616e 6461 7264 2069 6e70 7574 m standard input │ │ │ │ +00043210: 2e0a 0a20 2020 2020 6772 7562 2d73 6372 ... grub-scr │ │ │ │ +00043220: 6970 742d 6368 6563 6b20 2f62 6f6f 742f ipt-check /boot/ │ │ │ │ +00043230: 6772 7562 2f67 7275 622e 6366 670a 0a20 grub/grub.cfg.. │ │ │ │ +00043240: 2020 2767 7275 622d 7363 7269 7074 2d63 'grub-script-c │ │ │ │ +00043250: 6865 636b 2720 6163 6365 7074 7320 7468 heck' accepts th │ │ │ │ +00043260: 6520 666f 6c6c 6f77 696e 6720 6f70 7469 e following opti │ │ │ │ +00043270: 6f6e 733a 0a0a 272d 2d68 656c 7027 0a20 ons:..'--help'. │ │ │ │ +00043280: 2020 2020 5072 696e 7420 6120 7375 6d6d Print a summ │ │ │ │ +00043290: 6172 7920 6f66 2074 6865 2063 6f6d 6d61 ary of the comma │ │ │ │ +000432a0: 6e64 2d6c 696e 6520 6f70 7469 6f6e 7320 nd-line options │ │ │ │ +000432b0: 616e 6420 6578 6974 2e0a 0a27 2d2d 7665 and exit...'--ve │ │ │ │ +000432c0: 7273 696f 6e27 0a20 2020 2020 5072 696e rsion'. Prin │ │ │ │ +000432d0: 7420 7468 6520 7665 7273 696f 6e20 6e75 t the version nu │ │ │ │ +000432e0: 6d62 6572 206f 6620 4752 5542 2061 6e64 mber of GRUB and │ │ │ │ +000432f0: 2065 7869 742e 0a0a 272d 7627 0a27 2d2d exit...'-v'.'-- │ │ │ │ +00043300: 7665 7262 6f73 6527 0a20 2020 2020 5072 verbose'. Pr │ │ │ │ +00043310: 696e 7420 6561 6368 206c 696e 6520 6f66 int each line of │ │ │ │ +00043320: 2069 6e70 7574 2061 6674 6572 2072 6561 input after rea │ │ │ │ +00043330: 6469 6e67 2069 742e 0a0a 1f0a 4669 6c65 ding it.....File │ │ │ │ +00043340: 3a20 6772 7562 2e69 6e66 6f2c 2020 4e6f : grub.info, No │ │ │ │ +00043350: 6465 3a20 4f62 7461 696e 696e 6720 616e de: Obtaining an │ │ │ │ +00043360: 6420 4275 696c 6469 6e67 2047 5255 422c d Building GRUB, │ │ │ │ +00043370: 2020 4e65 7874 3a20 5265 706f 7274 696e Next: Reportin │ │ │ │ +00043380: 6720 6275 6773 2c20 2050 7265 763a 2049 g bugs, Prev: I │ │ │ │ +00043390: 6e76 6f6b 696e 6720 6772 7562 2d73 6372 nvoking grub-scr │ │ │ │ +000433a0: 6970 742d 6368 6563 6b2c 2020 5570 3a20 ipt-check, Up: │ │ │ │ +000433b0: 546f 700a 0a41 7070 656e 6469 7820 4120 Top..Appendix A │ │ │ │ +000433c0: 486f 7720 746f 206f 6274 6169 6e20 616e How to obtain an │ │ │ │ +000433d0: 6420 6275 696c 6420 4752 5542 0a2a 2a2a d build GRUB.*** │ │ │ │ 000433e0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ 000433f0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ -00043400: 0a0a 2020 2020 202a 4361 7574 696f 6e3a .. *Caution: │ │ │ │ -00043410: 2a20 4752 5542 2072 6571 7569 7265 7320 * GRUB requires │ │ │ │ -00043420: 6269 6e75 7469 6c73 2d32 2e39 2e31 2e30 binutils-2.9.1.0 │ │ │ │ -00043430: 2e32 3320 6f72 206c 6174 6572 2062 6563 .23 or later bec │ │ │ │ -00043440: 6175 7365 2074 6865 0a20 2020 2020 474e ause the. GN │ │ │ │ -00043450: 5520 6173 7365 6d62 6c65 7220 6861 7320 U assembler has │ │ │ │ -00043460: 6265 656e 2063 6861 6e67 6564 2073 6f20 been changed so │ │ │ │ -00043470: 7468 6174 2069 7420 6361 6e20 7072 6f64 that it can prod │ │ │ │ -00043480: 7563 6520 7265 616c 2031 3662 6974 730a uce real 16bits. │ │ │ │ -00043490: 2020 2020 206d 6163 6869 6e65 2063 6f64 machine cod │ │ │ │ -000434a0: 6520 6265 7477 6565 6e20 322e 392e 3120 e between 2.9.1 │ │ │ │ -000434b0: 616e 6420 322e 392e 312e 302e 782e 2020 and 2.9.1.0.x. │ │ │ │ -000434c0: 5365 650a 2020 2020 203c 6874 7470 3a2f See. , │ │ │ │ -000434f0: 746f 206f 6274 6169 6e20 696e 666f 726d to obtain inform │ │ │ │ -00043500: 6174 696f 6e20 6f6e 2068 6f77 0a20 2020 ation on how. │ │ │ │ -00043510: 2020 746f 2067 6574 2074 6865 206c 6174 to get the lat │ │ │ │ -00043520: 6573 7420 7665 7273 696f 6e2e 0a0a 2020 est version... │ │ │ │ -00043530: 2047 5255 4220 6973 2061 7661 696c 6162 GRUB is availab │ │ │ │ -00043540: 6c65 2066 726f 6d20 7468 6520 474e 5520 le from the GNU │ │ │ │ -00043550: 616c 7068 6120 6172 6368 6976 6520 7369 alpha archive si │ │ │ │ -00043560: 7465 0a3c 6674 703a 2f2f 6674 702e 676e te. │ │ │ │ -00043580: 6f72 2061 6e79 206f 6620 6974 7320 6d69 or any of its mi │ │ │ │ -00043590: 7272 6f72 732e 2020 5468 6520 6669 6c65 rrors. The file │ │ │ │ -000435a0: 2077 696c 6c20 6265 0a6e 616d 6564 2067 will be.named g │ │ │ │ -000435b0: 7275 622d 7665 7273 696f 6e2e 7461 722e rub-version.tar. │ │ │ │ -000435c0: 677a 2e20 2054 6865 2063 7572 7265 6e74 gz. The current │ │ │ │ -000435d0: 2076 6572 7369 6f6e 2069 7320 322e 3034 version is 2.04 │ │ │ │ -000435e0: 2c20 736f 2074 6865 2066 696c 6520 796f , so the file yo │ │ │ │ -000435f0: 750a 7368 6f75 6c64 2067 7261 6220 6973 u.should grab is │ │ │ │ -00043600: 3a0a 0a20 2020 3c66 7470 3a2f 2f66 7470 :.. .. To unbun │ │ │ │ -00043640: 646c 6520 4752 5542 2075 7365 2074 6865 dle GRUB use the │ │ │ │ -00043650: 2069 6e73 7472 7563 7469 6f6e 3a0a 0a20 instruction:.. │ │ │ │ -00043660: 2020 2020 7a63 6174 2067 7275 622d 322e zcat grub-2. │ │ │ │ -00043670: 3034 2e74 6172 2e67 7a20 7c20 7461 7220 04.tar.gz | tar │ │ │ │ -00043680: 7876 6620 2d0a 0a20 2020 7768 6963 6820 xvf -.. which │ │ │ │ -00043690: 7769 6c6c 2063 7265 6174 6520 6120 6469 will create a di │ │ │ │ -000436a0: 7265 6374 6f72 7920 6361 6c6c 6564 2027 rectory called ' │ │ │ │ -000436b0: 6772 7562 2d32 2e30 3427 2077 6974 6820 grub-2.04' with │ │ │ │ -000436c0: 616c 6c20 7468 650a 736f 7572 6365 732e all the.sources. │ │ │ │ -000436d0: 2020 596f 7520 6361 6e20 6c6f 6f6b 2061 You can look a │ │ │ │ -000436e0: 7420 7468 6520 6669 6c65 2027 494e 5354 t the file 'INST │ │ │ │ -000436f0: 414c 4c27 2066 6f72 2064 6574 6169 6c65 ALL' for detaile │ │ │ │ -00043700: 6420 696e 7374 7275 6374 696f 6e73 0a6f d instructions.o │ │ │ │ -00043710: 6e20 686f 7720 746f 2062 7569 6c64 2061 n how to build a │ │ │ │ -00043720: 6e64 2069 6e73 7461 6c6c 2047 5255 422c nd install GRUB, │ │ │ │ -00043730: 2062 7574 2079 6f75 2073 686f 756c 6420 but you should │ │ │ │ -00043740: 6265 2061 626c 6520 746f 206a 7573 7420 be able to just │ │ │ │ -00043750: 646f 3a0a 0a20 2020 2020 6364 2067 7275 do:.. cd gru │ │ │ │ -00043760: 622d 322e 3034 0a20 2020 2020 2e2f 636f b-2.04. ./co │ │ │ │ -00043770: 6e66 6967 7572 650a 2020 2020 206d 616b nfigure. mak │ │ │ │ -00043780: 6520 696e 7374 616c 6c0a 0a20 2020 416c e install.. Al │ │ │ │ -00043790: 736f 2c20 7468 6520 6c61 7465 7374 2076 so, the latest v │ │ │ │ -000437a0: 6572 7369 6f6e 2069 7320 6176 6169 6c61 ersion is availa │ │ │ │ -000437b0: 626c 6520 7573 696e 6720 4769 742e 2020 ble using Git. │ │ │ │ -000437c0: 5365 650a 3c68 7474 703a 2f2f 7777 772e See. for mo │ │ │ │ -00043800: 7265 0a69 6e66 6f72 6d61 7469 6f6e 2e0a re.information.. │ │ │ │ -00043810: 0a1f 0a46 696c 653a 2067 7275 622e 696e ...File: grub.in │ │ │ │ -00043820: 666f 2c20 204e 6f64 653a 2052 6570 6f72 fo, Node: Repor │ │ │ │ -00043830: 7469 6e67 2062 7567 732c 2020 4e65 7874 ting bugs, Next │ │ │ │ -00043840: 3a20 4675 7475 7265 2c20 2050 7265 763a : Future, Prev: │ │ │ │ -00043850: 204f 6274 6169 6e69 6e67 2061 6e64 2042 Obtaining and B │ │ │ │ -00043860: 7569 6c64 696e 6720 4752 5542 2c20 2055 uilding GRUB, U │ │ │ │ -00043870: 703a 2054 6f70 0a0a 4170 7065 6e64 6978 p: Top..Appendix │ │ │ │ -00043880: 2042 2052 6570 6f72 7469 6e67 2062 7567 B Reporting bug │ │ │ │ -00043890: 730a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a s.************** │ │ │ │ -000438a0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a0a 0a54 6865 ***********..The │ │ │ │ -000438b0: 7365 2061 7265 2074 6865 2067 7569 6465 se are the guide │ │ │ │ -000438c0: 6c69 6e65 2066 6f72 2068 6f77 2074 6f20 line for how to │ │ │ │ -000438d0: 7265 706f 7274 2062 7567 732e 2020 5461 report bugs. Ta │ │ │ │ -000438e0: 6b65 2061 206c 6f6f 6b20 6174 2074 6869 ke a look at thi │ │ │ │ -000438f0: 730a 6c69 7374 2062 656c 6f77 2062 6566 s.list below bef │ │ │ │ -00043900: 6f72 6520 796f 7520 7375 626d 6974 2062 ore you submit b │ │ │ │ -00043910: 7567 733a 0a0a 2020 312e 2042 6566 6f72 ugs:.. 1. Befor │ │ │ │ -00043920: 6520 6765 7474 696e 6720 756e 7365 7474 e getting unsett │ │ │ │ -00043930: 6c65 642c 2072 6561 6420 7468 6973 206d led, read this m │ │ │ │ -00043940: 616e 7561 6c20 7468 726f 7567 6820 616e anual through an │ │ │ │ -00043950: 6420 7468 726f 7567 682e 0a20 2020 2020 d through.. │ │ │ │ -00043960: 416c 736f 2c20 7365 6520 7468 6520 474e Also, see the GN │ │ │ │ -00043970: 5520 4752 5542 2046 4151 0a20 2020 2020 U GRUB FAQ. │ │ │ │ -00043980: 2868 7474 703a 2f2f 7777 772e 676e 752e (http://www.gnu. │ │ │ │ -00043990: 6f72 672f 736f 6674 7761 7265 2f67 7275 org/software/gru │ │ │ │ -000439a0: 622f 6772 7562 2d66 6171 2e68 746d 6c29 b/grub-faq.html) │ │ │ │ -000439b0: 2e0a 0a20 2032 2e20 416c 7761 7973 206d ... 2. Always m │ │ │ │ -000439c0: 656e 7469 6f6e 2074 6865 2069 6e66 6f72 ention the infor │ │ │ │ -000439d0: 6d61 7469 6f6e 206f 6e20 796f 7572 2047 mation on your G │ │ │ │ -000439e0: 5255 422e 2054 6865 2076 6572 7369 6f6e RUB. The version │ │ │ │ -000439f0: 206e 756d 6265 7220 616e 640a 2020 2020 number and. │ │ │ │ -00043a00: 2074 6865 2063 6f6e 6669 6775 7261 7469 the configurati │ │ │ │ -00043a10: 6f6e 2061 7265 2071 7569 7465 2069 6d70 on are quite imp │ │ │ │ -00043a20: 6f72 7461 6e74 2e20 2049 6620 796f 7520 ortant. If you │ │ │ │ -00043a30: 6275 696c 6420 6974 2079 6f75 7273 656c build it yoursel │ │ │ │ -00043a40: 662c 0a20 2020 2020 7772 6974 6520 7468 f,. write th │ │ │ │ -00043a50: 6520 6f70 7469 6f6e 7320 7370 6563 6966 e options specif │ │ │ │ -00043a60: 6965 6420 746f 2074 6865 2063 6f6e 6669 ied to the confi │ │ │ │ -00043a70: 6775 7265 2073 6372 6970 7420 616e 6420 gure script and │ │ │ │ -00043a80: 796f 7572 0a20 2020 2020 6f70 6572 6174 your. operat │ │ │ │ -00043a90: 696e 6720 7379 7374 656d 2c20 696e 636c ing system, incl │ │ │ │ -00043aa0: 7564 696e 6720 7468 6520 7665 7273 696f uding the versio │ │ │ │ -00043ab0: 6e73 206f 6620 6763 6320 616e 6420 6269 ns of gcc and bi │ │ │ │ -00043ac0: 6e75 7469 6c73 2e0a 0a20 2033 2e20 4966 nutils... 3. If │ │ │ │ -00043ad0: 2079 6f75 2068 6176 6520 7472 6f75 626c you have troubl │ │ │ │ -00043ae0: 6520 7769 7468 2074 6865 2069 6e73 7461 e with the insta │ │ │ │ -00043af0: 6c6c 6174 696f 6e2c 2069 6e66 6f72 6d20 llation, inform │ │ │ │ -00043b00: 7573 206f 6620 686f 7720 796f 750a 2020 us of how you. │ │ │ │ -00043b10: 2020 2069 6e73 7461 6c6c 6564 2047 5255 installed GRU │ │ │ │ -00043b20: 422e 2044 6f6e 2774 206f 6d69 7420 6572 B. Don't omit er │ │ │ │ -00043b30: 726f 7220 6d65 7373 6167 6573 2c20 6966 ror messages, if │ │ │ │ -00043b40: 2061 6e79 2e20 204a 7573 7420 2747 5255 any. Just 'GRU │ │ │ │ -00043b50: 420a 2020 2020 2068 616e 6773 2075 7020 B. hangs up │ │ │ │ -00043b60: 7768 656e 2069 7420 626f 6f74 7327 2069 when it boots' i │ │ │ │ -00043b70: 7320 6e6f 7420 656e 6f75 6768 2e0a 0a20 s not enough... │ │ │ │ -00043b80: 2020 2020 5468 6520 696e 666f 726d 6174 The informat │ │ │ │ -00043b90: 696f 6e20 6f6e 2079 6f75 7220 6861 7264 ion on your hard │ │ │ │ -00043ba0: 7761 7265 2069 7320 616c 736f 2065 7373 ware is also ess │ │ │ │ -00043bb0: 656e 7469 616c 2e20 2054 6865 7365 2061 ential. These a │ │ │ │ -00043bc0: 7265 0a20 2020 2020 6573 7065 6369 616c re. especial │ │ │ │ -00043bd0: 6c79 2069 6d70 6f72 7461 6e74 3a20 7468 ly important: th │ │ │ │ -00043be0: 6520 6765 6f6d 6574 7269 6573 2061 6e64 e geometries and │ │ │ │ -00043bf0: 2074 6865 2070 6172 7469 7469 6f6e 2074 the partition t │ │ │ │ -00043c00: 6162 6c65 7320 6f66 0a20 2020 2020 796f ables of. yo │ │ │ │ -00043c10: 7572 2068 6172 6420 6469 736b 2064 7269 ur hard disk dri │ │ │ │ -00043c20: 7665 7320 616e 6420 796f 7572 2042 494f ves and your BIO │ │ │ │ -00043c30: 532e 0a0a 2020 342e 2049 6620 4752 5542 S... 4. If GRUB │ │ │ │ -00043c40: 2063 616e 6e6f 7420 626f 6f74 2079 6f75 cannot boot you │ │ │ │ -00043c50: 7220 6f70 6572 6174 696e 6720 7379 7374 r operating syst │ │ │ │ -00043c60: 656d 2c20 7772 6974 6520 646f 776e 205f em, write down _ │ │ │ │ -00043c70: 6576 6572 7974 6869 6e67 5f0a 2020 2020 everything_. │ │ │ │ -00043c80: 2079 6f75 2073 6565 206f 6e20 7468 6520 you see on the │ │ │ │ -00043c90: 7363 7265 656e 2e20 2044 6f6e 2774 2070 screen. Don't p │ │ │ │ -00043ca0: 6172 6170 6872 6173 6520 7468 656d 2c20 araphrase them, │ │ │ │ -00043cb0: 6c69 6b65 2027 5468 6520 666f 6f20 4f53 like 'The foo OS │ │ │ │ -00043cc0: 0a20 2020 2020 6372 6173 6865 7320 7769 . crashes wi │ │ │ │ -00043cd0: 7468 2047 5255 422c 2065 7665 6e20 7468 th GRUB, even th │ │ │ │ -00043ce0: 6f75 6768 2069 7420 6361 6e20 626f 6f74 ough it can boot │ │ │ │ -00043cf0: 2077 6974 6820 7468 6520 6261 7220 626f with the bar bo │ │ │ │ -00043d00: 6f74 206c 6f61 6465 720a 2020 2020 206a ot loader. j │ │ │ │ -00043d10: 7573 7420 6669 6e65 272e 2020 4d65 6e74 ust fine'. Ment │ │ │ │ -00043d20: 696f 6e20 7468 6520 636f 6d6d 616e 6473 ion the commands │ │ │ │ -00043d30: 2079 6f75 2065 7865 6375 7465 642c 2074 you executed, t │ │ │ │ -00043d40: 6865 206d 6573 7361 6765 730a 2020 2020 he messages. │ │ │ │ -00043d50: 2070 7269 6e74 6564 2062 7920 7468 656d printed by them │ │ │ │ -00043d60: 2c20 616e 6420 696e 666f 726d 6174 696f , and informatio │ │ │ │ -00043d70: 6e20 6f6e 2079 6f75 7220 6f70 6572 6174 n on your operat │ │ │ │ -00043d80: 696e 6720 7379 7374 656d 2069 6e63 6c75 ing system inclu │ │ │ │ -00043d90: 6469 6e67 0a20 2020 2020 7468 6520 7665 ding. the ve │ │ │ │ -00043da0: 7273 696f 6e20 6e75 6d62 6572 2e0a 0a20 rsion number... │ │ │ │ -00043db0: 2035 2e20 4578 706c 6169 6e20 7768 6174 5. Explain what │ │ │ │ -00043dc0: 2079 6f75 2077 616e 7465 6420 746f 2064 you wanted to d │ │ │ │ -00043dd0: 6f2e 2020 4974 2069 7320 7665 7279 2075 o. It is very u │ │ │ │ -00043de0: 7365 6675 6c20 746f 206b 6e6f 7720 796f seful to know yo │ │ │ │ -00043df0: 7572 0a20 2020 2020 7075 7270 6f73 6520 ur. purpose │ │ │ │ -00043e00: 616e 6420 796f 7572 2077 6973 682c 2061 and your wish, a │ │ │ │ -00043e10: 6e64 2068 6f77 2047 5255 4220 6469 646e nd how GRUB didn │ │ │ │ -00043e20: 2774 2073 6174 6973 6679 2079 6f75 2e0a 't satisfy you.. │ │ │ │ -00043e30: 0a20 2036 2e20 4966 2079 6f75 2063 616e . 6. If you can │ │ │ │ -00043e40: 2069 6e76 6573 7469 6761 7465 2074 6865 investigate the │ │ │ │ -00043e50: 2070 726f 626c 656d 2079 6f75 7273 656c problem yoursel │ │ │ │ -00043e60: 662c 2070 6c65 6173 6520 646f 2e20 2054 f, please do. T │ │ │ │ -00043e70: 6861 7420 7769 6c6c 0a20 2020 2020 6769 hat will. gi │ │ │ │ -00043e80: 7665 2079 6f75 2061 6e64 2075 7320 6d75 ve you and us mu │ │ │ │ -00043e90: 6368 206d 6f72 6520 696e 666f 726d 6174 ch more informat │ │ │ │ -00043ea0: 696f 6e20 6f6e 2074 6865 2070 726f 626c ion on the probl │ │ │ │ -00043eb0: 656d 2e20 2041 7474 6163 6869 6e67 2061 em. Attaching a │ │ │ │ -00043ec0: 0a20 2020 2020 7061 7463 6820 6973 2065 . patch is e │ │ │ │ -00043ed0: 7665 6e20 6265 7474 6572 2e0a 0a20 2020 ven better... │ │ │ │ -00043ee0: 2020 5768 656e 2079 6f75 2061 7474 6163 When you attac │ │ │ │ -00043ef0: 6820 6120 7061 7463 682c 206d 616b 6520 h a patch, make │ │ │ │ -00043f00: 7468 6520 7061 7463 6820 696e 2075 6e69 the patch in uni │ │ │ │ -00043f10: 6669 6564 2064 6966 6620 666f 726d 6174 fied diff format │ │ │ │ -00043f20: 2c20 616e 640a 2020 2020 2077 7269 7465 , and. write │ │ │ │ -00043f30: 2043 6861 6e67 654c 6f67 2065 6e74 7269 ChangeLog entri │ │ │ │ -00043f40: 6573 2e20 2042 7574 2c20 6576 656e 2077 es. But, even w │ │ │ │ -00043f50: 6865 6e20 796f 7520 6d61 6b65 2061 2070 hen you make a p │ │ │ │ -00043f60: 6174 6368 2c20 646f 6e27 740a 2020 2020 atch, don't. │ │ │ │ -00043f70: 2066 6f72 6765 7420 746f 2065 7870 6c61 forget to expla │ │ │ │ -00043f80: 696e 2074 6865 2070 726f 626c 656d 2c20 in the problem, │ │ │ │ -00043f90: 736f 2074 6861 7420 7765 2063 616e 2075 so that we can u │ │ │ │ -00043fa0: 6e64 6572 7374 616e 6420 7768 6174 2079 nderstand what y │ │ │ │ -00043fb0: 6f75 720a 2020 2020 2070 6174 6368 2069 our. patch i │ │ │ │ -00043fc0: 7320 666f 722e 0a0a 2020 372e 2057 7269 s for... 7. Wri │ │ │ │ -00043fd0: 7465 2064 6f77 6e20 616e 7974 6869 6e67 te down anything │ │ │ │ -00043fe0: 2074 6861 7420 796f 7520 7468 696e 6b20 that you think │ │ │ │ -00043ff0: 6d69 6768 7420 6265 2072 656c 6174 6564 might be related │ │ │ │ -00044000: 2e20 2050 6c65 6173 650a 2020 2020 2075 . Please. u │ │ │ │ -00044010: 6e64 6572 7374 616e 6420 7468 6174 2077 nderstand that w │ │ │ │ -00044020: 6520 6f66 7465 6e20 6e65 6564 2074 6f20 e often need to │ │ │ │ -00044030: 7265 7072 6f64 7563 6520 7468 6520 7361 reproduce the sa │ │ │ │ -00044040: 6d65 2070 726f 626c 656d 2079 6f75 0a20 me problem you. │ │ │ │ -00044050: 2020 2020 656e 636f 756e 7465 7265 6420 encountered │ │ │ │ -00044060: 696e 206f 7572 2065 6e76 6972 6f6e 6d65 in our environme │ │ │ │ -00044070: 6e74 2e20 2053 6f20 796f 7572 2069 6e66 nt. So your inf │ │ │ │ -00044080: 6f72 6d61 7469 6f6e 2073 686f 756c 6420 ormation should │ │ │ │ -00044090: 6265 0a20 2020 2020 7375 6666 6963 6965 be. sufficie │ │ │ │ -000440a0: 6e74 2066 6f72 2075 7320 746f 2064 6f20 nt for us to do │ │ │ │ -000440b0: 7468 6520 7361 6d65 2074 6869 6e67 2d2d the same thing-- │ │ │ │ -000440c0: 446f 6e27 7420 666f 7267 6574 2074 6861 Don't forget tha │ │ │ │ -000440d0: 7420 7765 2063 616e 6e6f 740a 2020 2020 t we cannot. │ │ │ │ -000440e0: 2073 6565 2079 6f75 7220 636f 6d70 7574 see your comput │ │ │ │ -000440f0: 6572 2064 6972 6563 746c 792e 2020 4966 er directly. If │ │ │ │ -00044100: 2079 6f75 2061 7265 206e 6f74 2073 7572 you are not sur │ │ │ │ -00044110: 6520 7768 6574 6865 7220 746f 2073 7461 e whether to sta │ │ │ │ -00044120: 7465 2061 0a20 2020 2020 6661 6374 206f te a. fact o │ │ │ │ -00044130: 7220 6c65 6176 6520 6974 206f 7574 2c20 r leave it out, │ │ │ │ -00044140: 7374 6174 6520 6974 2120 2052 6570 6f72 state it! Repor │ │ │ │ -00044150: 7469 6e67 2074 6f6f 206d 616e 7920 7468 ting too many th │ │ │ │ -00044160: 696e 6773 2069 7320 6d75 6368 0a20 2020 ings is much. │ │ │ │ -00044170: 2020 6265 7474 6572 2074 6861 6e20 6f6d better than om │ │ │ │ -00044180: 6974 7469 6e67 2073 6f6d 6574 6869 6e67 itting something │ │ │ │ -00044190: 2069 6d70 6f72 7461 6e74 2e0a 0a20 2020 important... │ │ │ │ -000441a0: 4966 2079 6f75 2066 6f6c 6c6f 7720 7468 If you follow th │ │ │ │ -000441b0: 6520 6775 6964 656c 696e 6520 6162 6f76 e guideline abov │ │ │ │ -000441c0: 652c 2073 7562 6d69 7420 6120 7265 706f e, submit a repo │ │ │ │ -000441d0: 7274 2074 6f20 7468 6520 4275 670a 5472 rt to the Bug.Tr │ │ │ │ -000441e0: 6163 6b69 6e67 2053 7973 7465 6d20 2868 acking System (h │ │ │ │ -000441f0: 7474 703a 2f2f 7361 7661 6e6e 6168 2e67 ttp://savannah.g │ │ │ │ -00044200: 6e75 2e6f 7267 2f62 7567 732f 3f67 726f nu.org/bugs/?gro │ │ │ │ -00044210: 7570 3d67 7275 6229 2e0a 416c 7465 726e up=grub)..Altern │ │ │ │ -00044220: 6174 6976 656c 792c 2079 6f75 2063 616e atively, you can │ │ │ │ -00044230: 2073 7562 6d69 7420 6120 7265 706f 7274 submit a report │ │ │ │ -00044240: 2076 6961 2065 6c65 6374 726f 6e69 6320 via electronic │ │ │ │ -00044250: 6d61 696c 2074 6f0a 3c62 7567 2d67 7275 mail to., but │ │ │ │ -00044270: 7765 2073 7472 6f6e 676c 7920 7265 636f we strongly reco │ │ │ │ -00044280: 6d6d 656e 6420 7468 6174 2079 6f75 2075 mmend that you u │ │ │ │ -00044290: 7365 2074 6865 2042 7567 0a54 7261 636b se the Bug.Track │ │ │ │ -000442a0: 696e 6720 5379 7374 656d 2c20 6265 6361 ing System, beca │ │ │ │ -000442b0: 7573 6520 652d 6d61 696c 2063 616e 2062 use e-mail can b │ │ │ │ -000442c0: 6520 7061 7373 6564 206f 7665 7220 6561 e passed over ea │ │ │ │ -000442d0: 7369 6c79 2e0a 0a20 2020 4f6e 6365 2077 sily... Once w │ │ │ │ -000442e0: 6520 6765 7420 796f 7572 2072 6570 6f72 e get your repor │ │ │ │ -000442f0: 742c 2077 6520 7769 6c6c 2074 7279 2074 t, we will try t │ │ │ │ -00044300: 6f20 6669 7820 7468 6520 6275 6773 2e0a o fix the bugs.. │ │ │ │ -00044310: 0a1f 0a46 696c 653a 2067 7275 622e 696e ...File: grub.in │ │ │ │ -00044320: 666f 2c20 204e 6f64 653a 2046 7574 7572 fo, Node: Futur │ │ │ │ -00044330: 652c 2020 4e65 7874 3a20 436f 7079 696e e, Next: Copyin │ │ │ │ -00044340: 6720 5468 6973 204d 616e 7561 6c2c 2020 g This Manual, │ │ │ │ -00044350: 5072 6576 3a20 5265 706f 7274 696e 6720 Prev: Reporting │ │ │ │ -00044360: 6275 6773 2c20 2055 703a 2054 6f70 0a0a bugs, Up: Top.. │ │ │ │ -00044370: 4170 7065 6e64 6978 2043 2057 6865 7265 Appendix C Where │ │ │ │ -00044380: 2047 5255 4220 7769 6c6c 2067 6f0a 2a2a GRUB will go.** │ │ │ │ -00044390: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ -000443a0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a0a 0a47 5255 ***********..GRU │ │ │ │ -000443b0: 4220 3220 6973 206e 6f77 2071 7569 7465 B 2 is now quite │ │ │ │ -000443c0: 2073 7461 626c 6520 616e 6420 7573 6564 stable and used │ │ │ │ -000443d0: 2069 6e20 6d61 6e79 2070 726f 6475 6374 in many product │ │ │ │ -000443e0: 696f 6e20 7379 7374 656d 732e 2020 5765 ion systems. We │ │ │ │ -000443f0: 2061 7265 0a63 7572 7265 6e74 6c79 2077 are.currently w │ │ │ │ -00044400: 6f72 6b69 6e67 2074 6f77 6172 6473 2061 orking towards a │ │ │ │ -00044410: 2032 2e30 2072 656c 6561 7365 2e0a 0a20 2.0 release... │ │ │ │ -00044420: 2020 4966 2079 6f75 2061 7265 2069 6e74 If you are int │ │ │ │ -00044430: 6572 6573 7465 6420 696e 2074 6865 2064 erested in the d │ │ │ │ -00044440: 6576 656c 6f70 6d65 6e74 206f 6620 4752 evelopment of GR │ │ │ │ -00044450: 5542 2032 2c20 7461 6b65 2061 206c 6f6f UB 2, take a loo │ │ │ │ -00044460: 6b20 6174 0a74 6865 2068 6f6d 6570 6167 k at.the homepag │ │ │ │ -00044470: 6520 2868 7474 703a 2f2f 7777 772e 676e e (http://www.gn │ │ │ │ -00044480: 752e 6f72 672f 736f 6674 7761 7265 2f67 u.org/software/g │ │ │ │ -00044490: 7275 622f 6772 7562 2e68 746d 6c29 2e0a rub/grub.html).. │ │ │ │ -000444a0: 0a1f 0a46 696c 653a 2067 7275 622e 696e ...File: grub.in │ │ │ │ -000444b0: 666f 2c20 204e 6f64 653a 2043 6f70 7969 fo, Node: Copyi │ │ │ │ -000444c0: 6e67 2054 6869 7320 4d61 6e75 616c 2c20 ng This Manual, │ │ │ │ -000444d0: 204e 6578 743a 2049 6e64 6578 2c20 2050 Next: Index, P │ │ │ │ -000444e0: 7265 763a 2046 7574 7572 652c 2020 5570 rev: Future, Up │ │ │ │ -000444f0: 3a20 546f 700a 0a41 7070 656e 6469 7820 : Top..Appendix │ │ │ │ -00044500: 4420 436f 7079 696e 6720 5468 6973 204d D Copying This M │ │ │ │ -00044510: 616e 7561 6c0a 2a2a 2a2a 2a2a 2a2a 2a2a anual.********** │ │ │ │ +00043400: 2a2a 2a2a 0a0a 2020 2020 202a 4361 7574 ****.. *Caut │ │ │ │ +00043410: 696f 6e3a 2a20 4752 5542 2072 6571 7569 ion:* GRUB requi │ │ │ │ +00043420: 7265 7320 6269 6e75 7469 6c73 2d32 2e39 res binutils-2.9 │ │ │ │ +00043430: 2e31 2e30 2e32 3320 6f72 206c 6174 6572 .1.0.23 or later │ │ │ │ +00043440: 2062 6563 6175 7365 2074 6865 0a20 2020 because the. │ │ │ │ +00043450: 2020 474e 5520 6173 7365 6d62 6c65 7220 GNU assembler │ │ │ │ +00043460: 6861 7320 6265 656e 2063 6861 6e67 6564 has been changed │ │ │ │ +00043470: 2073 6f20 7468 6174 2069 7420 6361 6e20 so that it can │ │ │ │ +00043480: 7072 6f64 7563 6520 7265 616c 2031 3662 produce real 16b │ │ │ │ +00043490: 6974 730a 2020 2020 206d 6163 6869 6e65 its. machine │ │ │ │ +000434a0: 2063 6f64 6520 6265 7477 6565 6e20 322e code between 2. │ │ │ │ +000434b0: 392e 3120 616e 6420 322e 392e 312e 302e 9.1 and 2.9.1.0. │ │ │ │ +000434c0: 782e 2020 5365 650a 2020 2020 203c 6874 x. See. , to obtain in │ │ │ │ +00043500: 666f 726d 6174 696f 6e20 6f6e 2068 6f77 formation on how │ │ │ │ +00043510: 0a20 2020 2020 746f 2067 6574 2074 6865 . to get the │ │ │ │ +00043520: 206c 6174 6573 7420 7665 7273 696f 6e2e latest version. │ │ │ │ +00043530: 0a0a 2020 2047 5255 4220 6973 2061 7661 .. GRUB is ava │ │ │ │ +00043540: 696c 6162 6c65 2066 726f 6d20 7468 6520 ilable from the │ │ │ │ +00043550: 474e 5520 616c 7068 6120 6172 6368 6976 GNU alpha archiv │ │ │ │ +00043560: 6520 7369 7465 0a3c 6674 703a 2f2f 6674 e site. or any of it │ │ │ │ +00043590: 7320 6d69 7272 6f72 732e 2020 5468 6520 s mirrors. The │ │ │ │ +000435a0: 6669 6c65 2077 696c 6c20 6265 0a6e 616d file will be.nam │ │ │ │ +000435b0: 6564 2067 7275 622d 7665 7273 696f 6e2e ed grub-version. │ │ │ │ +000435c0: 7461 722e 677a 2e20 2054 6865 2063 7572 tar.gz. The cur │ │ │ │ +000435d0: 7265 6e74 2076 6572 7369 6f6e 2069 7320 rent version is │ │ │ │ +000435e0: 322e 3034 2c20 736f 2074 6865 2066 696c 2.04, so the fil │ │ │ │ +000435f0: 6520 796f 750a 7368 6f75 6c64 2067 7261 e you.should gra │ │ │ │ +00043600: 6220 6973 3a0a 0a20 2020 3c66 7470 3a2f b is:.. .. To u │ │ │ │ +00043640: 6e62 756e 646c 6520 4752 5542 2075 7365 nbundle GRUB use │ │ │ │ +00043650: 2074 6865 2069 6e73 7472 7563 7469 6f6e the instruction │ │ │ │ +00043660: 3a0a 0a20 2020 2020 7a63 6174 2067 7275 :.. zcat gru │ │ │ │ +00043670: 622d 322e 3034 2e74 6172 2e67 7a20 7c20 b-2.04.tar.gz | │ │ │ │ +00043680: 7461 7220 7876 6620 2d0a 0a20 2020 7768 tar xvf -.. wh │ │ │ │ +00043690: 6963 6820 7769 6c6c 2063 7265 6174 6520 ich will create │ │ │ │ +000436a0: 6120 6469 7265 6374 6f72 7920 6361 6c6c a directory call │ │ │ │ +000436b0: 6564 2027 6772 7562 2d32 2e30 3427 2077 ed 'grub-2.04' w │ │ │ │ +000436c0: 6974 6820 616c 6c20 7468 650a 736f 7572 ith all the.sour │ │ │ │ +000436d0: 6365 732e 2020 596f 7520 6361 6e20 6c6f ces. You can lo │ │ │ │ +000436e0: 6f6b 2061 7420 7468 6520 6669 6c65 2027 ok at the file ' │ │ │ │ +000436f0: 494e 5354 414c 4c27 2066 6f72 2064 6574 INSTALL' for det │ │ │ │ +00043700: 6169 6c65 6420 696e 7374 7275 6374 696f ailed instructio │ │ │ │ +00043710: 6e73 0a6f 6e20 686f 7720 746f 2062 7569 ns.on how to bui │ │ │ │ +00043720: 6c64 2061 6e64 2069 6e73 7461 6c6c 2047 ld and install G │ │ │ │ +00043730: 5255 422c 2062 7574 2079 6f75 2073 686f RUB, but you sho │ │ │ │ +00043740: 756c 6420 6265 2061 626c 6520 746f 206a uld be able to j │ │ │ │ +00043750: 7573 7420 646f 3a0a 0a20 2020 2020 6364 ust do:.. cd │ │ │ │ +00043760: 2067 7275 622d 322e 3034 0a20 2020 2020 grub-2.04. │ │ │ │ +00043770: 2e2f 636f 6e66 6967 7572 650a 2020 2020 ./configure. │ │ │ │ +00043780: 206d 616b 6520 696e 7374 616c 6c0a 0a20 make install.. │ │ │ │ +00043790: 2020 416c 736f 2c20 7468 6520 6c61 7465 Also, the late │ │ │ │ +000437a0: 7374 2076 6572 7369 6f6e 2069 7320 6176 st version is av │ │ │ │ +000437b0: 6169 6c61 626c 6520 7573 696e 6720 4769 ailable using Gi │ │ │ │ +000437c0: 742e 2020 5365 650a 3c68 7474 703a 2f2f t. See. fo │ │ │ │ +00043800: 7220 6d6f 7265 0a69 6e66 6f72 6d61 7469 r more.informati │ │ │ │ +00043810: 6f6e 2e0a 0a1f 0a46 696c 653a 2067 7275 on.....File: gru │ │ │ │ +00043820: 622e 696e 666f 2c20 204e 6f64 653a 2052 b.info, Node: R │ │ │ │ +00043830: 6570 6f72 7469 6e67 2062 7567 732c 2020 eporting bugs, │ │ │ │ +00043840: 4e65 7874 3a20 4675 7475 7265 2c20 2050 Next: Future, P │ │ │ │ +00043850: 7265 763a 204f 6274 6169 6e69 6e67 2061 rev: Obtaining a │ │ │ │ +00043860: 6e64 2042 7569 6c64 696e 6720 4752 5542 nd Building GRUB │ │ │ │ +00043870: 2c20 2055 703a 2054 6f70 0a0a 4170 7065 , Up: Top..Appe │ │ │ │ +00043880: 6e64 6978 2042 2052 6570 6f72 7469 6e67 ndix B Reporting │ │ │ │ +00043890: 2062 7567 730a 2a2a 2a2a 2a2a 2a2a 2a2a bugs.********** │ │ │ │ +000438a0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a0a ***************. │ │ │ │ +000438b0: 0a54 6865 7365 2061 7265 2074 6865 2067 .These are the g │ │ │ │ +000438c0: 7569 6465 6c69 6e65 2066 6f72 2068 6f77 uideline for how │ │ │ │ +000438d0: 2074 6f20 7265 706f 7274 2062 7567 732e to report bugs. │ │ │ │ +000438e0: 2020 5461 6b65 2061 206c 6f6f 6b20 6174 Take a look at │ │ │ │ +000438f0: 2074 6869 730a 6c69 7374 2062 656c 6f77 this.list below │ │ │ │ +00043900: 2062 6566 6f72 6520 796f 7520 7375 626d before you subm │ │ │ │ +00043910: 6974 2062 7567 733a 0a0a 2020 312e 2042 it bugs:.. 1. B │ │ │ │ +00043920: 6566 6f72 6520 6765 7474 696e 6720 756e efore getting un │ │ │ │ +00043930: 7365 7474 6c65 642c 2072 6561 6420 7468 settled, read th │ │ │ │ +00043940: 6973 206d 616e 7561 6c20 7468 726f 7567 is manual throug │ │ │ │ +00043950: 6820 616e 6420 7468 726f 7567 682e 0a20 h and through.. │ │ │ │ +00043960: 2020 2020 416c 736f 2c20 7365 6520 7468 Also, see th │ │ │ │ +00043970: 6520 474e 5520 4752 5542 2046 4151 0a20 e GNU GRUB FAQ. │ │ │ │ +00043980: 2020 2020 2868 7474 703a 2f2f 7777 772e (http://www. │ │ │ │ +00043990: 676e 752e 6f72 672f 736f 6674 7761 7265 gnu.org/software │ │ │ │ +000439a0: 2f67 7275 622f 6772 7562 2d66 6171 2e68 /grub/grub-faq.h │ │ │ │ +000439b0: 746d 6c29 2e0a 0a20 2032 2e20 416c 7761 tml)... 2. Alwa │ │ │ │ +000439c0: 7973 206d 656e 7469 6f6e 2074 6865 2069 ys mention the i │ │ │ │ +000439d0: 6e66 6f72 6d61 7469 6f6e 206f 6e20 796f nformation on yo │ │ │ │ +000439e0: 7572 2047 5255 422e 2054 6865 2076 6572 ur GRUB. The ver │ │ │ │ +000439f0: 7369 6f6e 206e 756d 6265 7220 616e 640a sion number and. │ │ │ │ +00043a00: 2020 2020 2074 6865 2063 6f6e 6669 6775 the configu │ │ │ │ +00043a10: 7261 7469 6f6e 2061 7265 2071 7569 7465 ration are quite │ │ │ │ +00043a20: 2069 6d70 6f72 7461 6e74 2e20 2049 6620 important. If │ │ │ │ +00043a30: 796f 7520 6275 696c 6420 6974 2079 6f75 you build it you │ │ │ │ +00043a40: 7273 656c 662c 0a20 2020 2020 7772 6974 rself,. writ │ │ │ │ +00043a50: 6520 7468 6520 6f70 7469 6f6e 7320 7370 e the options sp │ │ │ │ +00043a60: 6563 6966 6965 6420 746f 2074 6865 2063 ecified to the c │ │ │ │ +00043a70: 6f6e 6669 6775 7265 2073 6372 6970 7420 onfigure script │ │ │ │ +00043a80: 616e 6420 796f 7572 0a20 2020 2020 6f70 and your. op │ │ │ │ +00043a90: 6572 6174 696e 6720 7379 7374 656d 2c20 erating system, │ │ │ │ +00043aa0: 696e 636c 7564 696e 6720 7468 6520 7665 including the ve │ │ │ │ +00043ab0: 7273 696f 6e73 206f 6620 6763 6320 616e rsions of gcc an │ │ │ │ +00043ac0: 6420 6269 6e75 7469 6c73 2e0a 0a20 2033 d binutils... 3 │ │ │ │ +00043ad0: 2e20 4966 2079 6f75 2068 6176 6520 7472 . If you have tr │ │ │ │ +00043ae0: 6f75 626c 6520 7769 7468 2074 6865 2069 ouble with the i │ │ │ │ +00043af0: 6e73 7461 6c6c 6174 696f 6e2c 2069 6e66 nstallation, inf │ │ │ │ +00043b00: 6f72 6d20 7573 206f 6620 686f 7720 796f orm us of how yo │ │ │ │ +00043b10: 750a 2020 2020 2069 6e73 7461 6c6c 6564 u. installed │ │ │ │ +00043b20: 2047 5255 422e 2044 6f6e 2774 206f 6d69 GRUB. Don't omi │ │ │ │ +00043b30: 7420 6572 726f 7220 6d65 7373 6167 6573 t error messages │ │ │ │ +00043b40: 2c20 6966 2061 6e79 2e20 204a 7573 7420 , if any. Just │ │ │ │ +00043b50: 2747 5255 420a 2020 2020 2068 616e 6773 'GRUB. hangs │ │ │ │ +00043b60: 2075 7020 7768 656e 2069 7420 626f 6f74 up when it boot │ │ │ │ +00043b70: 7327 2069 7320 6e6f 7420 656e 6f75 6768 s' is not enough │ │ │ │ +00043b80: 2e0a 0a20 2020 2020 5468 6520 696e 666f ... The info │ │ │ │ +00043b90: 726d 6174 696f 6e20 6f6e 2079 6f75 7220 rmation on your │ │ │ │ +00043ba0: 6861 7264 7761 7265 2069 7320 616c 736f hardware is also │ │ │ │ +00043bb0: 2065 7373 656e 7469 616c 2e20 2054 6865 essential. The │ │ │ │ +00043bc0: 7365 2061 7265 0a20 2020 2020 6573 7065 se are. espe │ │ │ │ +00043bd0: 6369 616c 6c79 2069 6d70 6f72 7461 6e74 cially important │ │ │ │ +00043be0: 3a20 7468 6520 6765 6f6d 6574 7269 6573 : the geometries │ │ │ │ +00043bf0: 2061 6e64 2074 6865 2070 6172 7469 7469 and the partiti │ │ │ │ +00043c00: 6f6e 2074 6162 6c65 7320 6f66 0a20 2020 on tables of. │ │ │ │ +00043c10: 2020 796f 7572 2068 6172 6420 6469 736b your hard disk │ │ │ │ +00043c20: 2064 7269 7665 7320 616e 6420 796f 7572 drives and your │ │ │ │ +00043c30: 2042 494f 532e 0a0a 2020 342e 2049 6620 BIOS... 4. If │ │ │ │ +00043c40: 4752 5542 2063 616e 6e6f 7420 626f 6f74 GRUB cannot boot │ │ │ │ +00043c50: 2079 6f75 7220 6f70 6572 6174 696e 6720 your operating │ │ │ │ +00043c60: 7379 7374 656d 2c20 7772 6974 6520 646f system, write do │ │ │ │ +00043c70: 776e 205f 6576 6572 7974 6869 6e67 5f0a wn _everything_. │ │ │ │ +00043c80: 2020 2020 2079 6f75 2073 6565 206f 6e20 you see on │ │ │ │ +00043c90: 7468 6520 7363 7265 656e 2e20 2044 6f6e the screen. Don │ │ │ │ +00043ca0: 2774 2070 6172 6170 6872 6173 6520 7468 't paraphrase th │ │ │ │ +00043cb0: 656d 2c20 6c69 6b65 2027 5468 6520 666f em, like 'The fo │ │ │ │ +00043cc0: 6f20 4f53 0a20 2020 2020 6372 6173 6865 o OS. crashe │ │ │ │ +00043cd0: 7320 7769 7468 2047 5255 422c 2065 7665 s with GRUB, eve │ │ │ │ +00043ce0: 6e20 7468 6f75 6768 2069 7420 6361 6e20 n though it can │ │ │ │ +00043cf0: 626f 6f74 2077 6974 6820 7468 6520 6261 boot with the ba │ │ │ │ +00043d00: 7220 626f 6f74 206c 6f61 6465 720a 2020 r boot loader. │ │ │ │ +00043d10: 2020 206a 7573 7420 6669 6e65 272e 2020 just fine'. │ │ │ │ +00043d20: 4d65 6e74 696f 6e20 7468 6520 636f 6d6d Mention the comm │ │ │ │ +00043d30: 616e 6473 2079 6f75 2065 7865 6375 7465 ands you execute │ │ │ │ +00043d40: 642c 2074 6865 206d 6573 7361 6765 730a d, the messages. │ │ │ │ +00043d50: 2020 2020 2070 7269 6e74 6564 2062 7920 printed by │ │ │ │ +00043d60: 7468 656d 2c20 616e 6420 696e 666f 726d them, and inform │ │ │ │ +00043d70: 6174 696f 6e20 6f6e 2079 6f75 7220 6f70 ation on your op │ │ │ │ +00043d80: 6572 6174 696e 6720 7379 7374 656d 2069 erating system i │ │ │ │ +00043d90: 6e63 6c75 6469 6e67 0a20 2020 2020 7468 ncluding. th │ │ │ │ +00043da0: 6520 7665 7273 696f 6e20 6e75 6d62 6572 e version number │ │ │ │ +00043db0: 2e0a 0a20 2035 2e20 4578 706c 6169 6e20 ... 5. Explain │ │ │ │ +00043dc0: 7768 6174 2079 6f75 2077 616e 7465 6420 what you wanted │ │ │ │ +00043dd0: 746f 2064 6f2e 2020 4974 2069 7320 7665 to do. It is ve │ │ │ │ +00043de0: 7279 2075 7365 6675 6c20 746f 206b 6e6f ry useful to kno │ │ │ │ +00043df0: 7720 796f 7572 0a20 2020 2020 7075 7270 w your. purp │ │ │ │ +00043e00: 6f73 6520 616e 6420 796f 7572 2077 6973 ose and your wis │ │ │ │ +00043e10: 682c 2061 6e64 2068 6f77 2047 5255 4220 h, and how GRUB │ │ │ │ +00043e20: 6469 646e 2774 2073 6174 6973 6679 2079 didn't satisfy y │ │ │ │ +00043e30: 6f75 2e0a 0a20 2036 2e20 4966 2079 6f75 ou... 6. If you │ │ │ │ +00043e40: 2063 616e 2069 6e76 6573 7469 6761 7465 can investigate │ │ │ │ +00043e50: 2074 6865 2070 726f 626c 656d 2079 6f75 the problem you │ │ │ │ +00043e60: 7273 656c 662c 2070 6c65 6173 6520 646f rself, please do │ │ │ │ +00043e70: 2e20 2054 6861 7420 7769 6c6c 0a20 2020 . That will. │ │ │ │ +00043e80: 2020 6769 7665 2079 6f75 2061 6e64 2075 give you and u │ │ │ │ +00043e90: 7320 6d75 6368 206d 6f72 6520 696e 666f s much more info │ │ │ │ +00043ea0: 726d 6174 696f 6e20 6f6e 2074 6865 2070 rmation on the p │ │ │ │ +00043eb0: 726f 626c 656d 2e20 2041 7474 6163 6869 roblem. Attachi │ │ │ │ +00043ec0: 6e67 2061 0a20 2020 2020 7061 7463 6820 ng a. patch │ │ │ │ +00043ed0: 6973 2065 7665 6e20 6265 7474 6572 2e0a is even better.. │ │ │ │ +00043ee0: 0a20 2020 2020 5768 656e 2079 6f75 2061 . When you a │ │ │ │ +00043ef0: 7474 6163 6820 6120 7061 7463 682c 206d ttach a patch, m │ │ │ │ +00043f00: 616b 6520 7468 6520 7061 7463 6820 696e ake the patch in │ │ │ │ +00043f10: 2075 6e69 6669 6564 2064 6966 6620 666f unified diff fo │ │ │ │ +00043f20: 726d 6174 2c20 616e 640a 2020 2020 2077 rmat, and. w │ │ │ │ +00043f30: 7269 7465 2043 6861 6e67 654c 6f67 2065 rite ChangeLog e │ │ │ │ +00043f40: 6e74 7269 6573 2e20 2042 7574 2c20 6576 ntries. But, ev │ │ │ │ +00043f50: 656e 2077 6865 6e20 796f 7520 6d61 6b65 en when you make │ │ │ │ +00043f60: 2061 2070 6174 6368 2c20 646f 6e27 740a a patch, don't. │ │ │ │ +00043f70: 2020 2020 2066 6f72 6765 7420 746f 2065 forget to e │ │ │ │ +00043f80: 7870 6c61 696e 2074 6865 2070 726f 626c xplain the probl │ │ │ │ +00043f90: 656d 2c20 736f 2074 6861 7420 7765 2063 em, so that we c │ │ │ │ +00043fa0: 616e 2075 6e64 6572 7374 616e 6420 7768 an understand wh │ │ │ │ +00043fb0: 6174 2079 6f75 720a 2020 2020 2070 6174 at your. pat │ │ │ │ +00043fc0: 6368 2069 7320 666f 722e 0a0a 2020 372e ch is for... 7. │ │ │ │ +00043fd0: 2057 7269 7465 2064 6f77 6e20 616e 7974 Write down anyt │ │ │ │ +00043fe0: 6869 6e67 2074 6861 7420 796f 7520 7468 hing that you th │ │ │ │ +00043ff0: 696e 6b20 6d69 6768 7420 6265 2072 656c ink might be rel │ │ │ │ +00044000: 6174 6564 2e20 2050 6c65 6173 650a 2020 ated. Please. │ │ │ │ +00044010: 2020 2075 6e64 6572 7374 616e 6420 7468 understand th │ │ │ │ +00044020: 6174 2077 6520 6f66 7465 6e20 6e65 6564 at we often need │ │ │ │ +00044030: 2074 6f20 7265 7072 6f64 7563 6520 7468 to reproduce th │ │ │ │ +00044040: 6520 7361 6d65 2070 726f 626c 656d 2079 e same problem y │ │ │ │ +00044050: 6f75 0a20 2020 2020 656e 636f 756e 7465 ou. encounte │ │ │ │ +00044060: 7265 6420 696e 206f 7572 2065 6e76 6972 red in our envir │ │ │ │ +00044070: 6f6e 6d65 6e74 2e20 2053 6f20 796f 7572 onment. So your │ │ │ │ +00044080: 2069 6e66 6f72 6d61 7469 6f6e 2073 686f information sho │ │ │ │ +00044090: 756c 6420 6265 0a20 2020 2020 7375 6666 uld be. suff │ │ │ │ +000440a0: 6963 6965 6e74 2066 6f72 2075 7320 746f icient for us to │ │ │ │ +000440b0: 2064 6f20 7468 6520 7361 6d65 2074 6869 do the same thi │ │ │ │ +000440c0: 6e67 2d2d 446f 6e27 7420 666f 7267 6574 ng--Don't forget │ │ │ │ +000440d0: 2074 6861 7420 7765 2063 616e 6e6f 740a that we cannot. │ │ │ │ +000440e0: 2020 2020 2073 6565 2079 6f75 7220 636f see your co │ │ │ │ +000440f0: 6d70 7574 6572 2064 6972 6563 746c 792e mputer directly. │ │ │ │ +00044100: 2020 4966 2079 6f75 2061 7265 206e 6f74 If you are not │ │ │ │ +00044110: 2073 7572 6520 7768 6574 6865 7220 746f sure whether to │ │ │ │ +00044120: 2073 7461 7465 2061 0a20 2020 2020 6661 state a. fa │ │ │ │ +00044130: 6374 206f 7220 6c65 6176 6520 6974 206f ct or leave it o │ │ │ │ +00044140: 7574 2c20 7374 6174 6520 6974 2120 2052 ut, state it! R │ │ │ │ +00044150: 6570 6f72 7469 6e67 2074 6f6f 206d 616e eporting too man │ │ │ │ +00044160: 7920 7468 696e 6773 2069 7320 6d75 6368 y things is much │ │ │ │ +00044170: 0a20 2020 2020 6265 7474 6572 2074 6861 . better tha │ │ │ │ +00044180: 6e20 6f6d 6974 7469 6e67 2073 6f6d 6574 n omitting somet │ │ │ │ +00044190: 6869 6e67 2069 6d70 6f72 7461 6e74 2e0a hing important.. │ │ │ │ +000441a0: 0a20 2020 4966 2079 6f75 2066 6f6c 6c6f . If you follo │ │ │ │ +000441b0: 7720 7468 6520 6775 6964 656c 696e 6520 w the guideline │ │ │ │ +000441c0: 6162 6f76 652c 2073 7562 6d69 7420 6120 above, submit a │ │ │ │ +000441d0: 7265 706f 7274 2074 6f20 7468 6520 4275 report to the Bu │ │ │ │ +000441e0: 670a 5472 6163 6b69 6e67 2053 7973 7465 g.Tracking Syste │ │ │ │ +000441f0: 6d20 2868 7474 703a 2f2f 7361 7661 6e6e m (http://savann │ │ │ │ +00044200: 6168 2e67 6e75 2e6f 7267 2f62 7567 732f ah.gnu.org/bugs/ │ │ │ │ +00044210: 3f67 726f 7570 3d67 7275 6229 2e0a 416c ?group=grub)..Al │ │ │ │ +00044220: 7465 726e 6174 6976 656c 792c 2079 6f75 ternatively, you │ │ │ │ +00044230: 2063 616e 2073 7562 6d69 7420 6120 7265 can submit a re │ │ │ │ +00044240: 706f 7274 2076 6961 2065 6c65 6374 726f port via electro │ │ │ │ +00044250: 6e69 6320 6d61 696c 2074 6f0a 3c62 7567 nic mail to., │ │ │ │ +00044270: 6275 7420 7765 2073 7472 6f6e 676c 7920 but we strongly │ │ │ │ +00044280: 7265 636f 6d6d 656e 6420 7468 6174 2079 recommend that y │ │ │ │ +00044290: 6f75 2075 7365 2074 6865 2042 7567 0a54 ou use the Bug.T │ │ │ │ +000442a0: 7261 636b 696e 6720 5379 7374 656d 2c20 racking System, │ │ │ │ +000442b0: 6265 6361 7573 6520 652d 6d61 696c 2063 because e-mail c │ │ │ │ +000442c0: 616e 2062 6520 7061 7373 6564 206f 7665 an be passed ove │ │ │ │ +000442d0: 7220 6561 7369 6c79 2e0a 0a20 2020 4f6e r easily... On │ │ │ │ +000442e0: 6365 2077 6520 6765 7420 796f 7572 2072 ce we get your r │ │ │ │ +000442f0: 6570 6f72 742c 2077 6520 7769 6c6c 2074 eport, we will t │ │ │ │ +00044300: 7279 2074 6f20 6669 7820 7468 6520 6275 ry to fix the bu │ │ │ │ +00044310: 6773 2e0a 0a1f 0a46 696c 653a 2067 7275 gs.....File: gru │ │ │ │ +00044320: 622e 696e 666f 2c20 204e 6f64 653a 2046 b.info, Node: F │ │ │ │ +00044330: 7574 7572 652c 2020 4e65 7874 3a20 436f uture, Next: Co │ │ │ │ +00044340: 7079 696e 6720 5468 6973 204d 616e 7561 pying This Manua │ │ │ │ +00044350: 6c2c 2020 5072 6576 3a20 5265 706f 7274 l, Prev: Report │ │ │ │ +00044360: 696e 6720 6275 6773 2c20 2055 703a 2054 ing bugs, Up: T │ │ │ │ +00044370: 6f70 0a0a 4170 7065 6e64 6978 2043 2057 op..Appendix C W │ │ │ │ +00044380: 6865 7265 2047 5255 4220 7769 6c6c 2067 here GRUB will g │ │ │ │ +00044390: 6f0a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a o.************** │ │ │ │ +000443a0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a0a ***************. │ │ │ │ +000443b0: 0a47 5255 4220 3220 6973 206e 6f77 2071 .GRUB 2 is now q │ │ │ │ +000443c0: 7569 7465 2073 7461 626c 6520 616e 6420 uite stable and │ │ │ │ +000443d0: 7573 6564 2069 6e20 6d61 6e79 2070 726f used in many pro │ │ │ │ +000443e0: 6475 6374 696f 6e20 7379 7374 656d 732e duction systems. │ │ │ │ +000443f0: 2020 5765 2061 7265 0a63 7572 7265 6e74 We are.current │ │ │ │ +00044400: 6c79 2077 6f72 6b69 6e67 2074 6f77 6172 ly working towar │ │ │ │ +00044410: 6473 2061 2032 2e30 2072 656c 6561 7365 ds a 2.0 release │ │ │ │ +00044420: 2e0a 0a20 2020 4966 2079 6f75 2061 7265 ... If you are │ │ │ │ +00044430: 2069 6e74 6572 6573 7465 6420 696e 2074 interested in t │ │ │ │ +00044440: 6865 2064 6576 656c 6f70 6d65 6e74 206f he development o │ │ │ │ +00044450: 6620 4752 5542 2032 2c20 7461 6b65 2061 f GRUB 2, take a │ │ │ │ +00044460: 206c 6f6f 6b20 6174 0a74 6865 2068 6f6d look at.the hom │ │ │ │ +00044470: 6570 6167 6520 2868 7474 703a 2f2f 7777 epage (http://ww │ │ │ │ +00044480: 772e 676e 752e 6f72 672f 736f 6674 7761 w.gnu.org/softwa │ │ │ │ +00044490: 7265 2f67 7275 622f 6772 7562 2e68 746d re/grub/grub.htm │ │ │ │ +000444a0: 6c29 2e0a 0a1f 0a46 696c 653a 2067 7275 l).....File: gru │ │ │ │ +000444b0: 622e 696e 666f 2c20 204e 6f64 653a 2043 b.info, Node: C │ │ │ │ +000444c0: 6f70 7969 6e67 2054 6869 7320 4d61 6e75 opying This Manu │ │ │ │ +000444d0: 616c 2c20 204e 6578 743a 2049 6e64 6578 al, Next: Index │ │ │ │ +000444e0: 2c20 2050 7265 763a 2046 7574 7572 652c , Prev: Future, │ │ │ │ +000444f0: 2020 5570 3a20 546f 700a 0a41 7070 656e Up: Top..Appen │ │ │ │ +00044500: 6469 7820 4420 436f 7079 696e 6720 5468 dix D Copying Th │ │ │ │ +00044510: 6973 204d 616e 7561 6c0a 2a2a 2a2a 2a2a is Manual.****** │ │ │ │ 00044520: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ -00044530: 2a2a 2a2a 0a0a 2a20 4d65 6e75 3a0a 0a2a ****..* Menu:..* │ │ │ │ -00044540: 2047 4e55 2046 7265 6520 446f 6375 6d65 GNU Free Docume │ │ │ │ -00044550: 6e74 6174 696f 6e20 4c69 6365 6e73 653a ntation License: │ │ │ │ -00044560: 3a20 204c 6963 656e 7365 2066 6f72 2063 : License for c │ │ │ │ -00044570: 6f70 7969 6e67 2074 6869 7320 6d61 6e75 opying this manu │ │ │ │ -00044580: 616c 2e0a 0a1f 0a46 696c 653a 2067 7275 al.....File: gru │ │ │ │ -00044590: 622e 696e 666f 2c20 204e 6f64 653a 2047 b.info, Node: G │ │ │ │ -000445a0: 4e55 2046 7265 6520 446f 6375 6d65 6e74 NU Free Document │ │ │ │ -000445b0: 6174 696f 6e20 4c69 6365 6e73 652c 2020 ation License, │ │ │ │ -000445c0: 5570 3a20 436f 7079 696e 6720 5468 6973 Up: Copying This │ │ │ │ -000445d0: 204d 616e 7561 6c0a 0a44 2e31 2047 4e55 Manual..D.1 GNU │ │ │ │ -000445e0: 2046 7265 6520 446f 6375 6d65 6e74 6174 Free Documentat │ │ │ │ -000445f0: 696f 6e20 4c69 6365 6e73 650a 3d3d 3d3d ion License.==== │ │ │ │ +00044530: 2a2a 2a2a 2a2a 2a2a 0a0a 2a20 4d65 6e75 ********..* Menu │ │ │ │ +00044540: 3a0a 0a2a 2047 4e55 2046 7265 6520 446f :..* GNU Free Do │ │ │ │ +00044550: 6375 6d65 6e74 6174 696f 6e20 4c69 6365 cumentation Lice │ │ │ │ +00044560: 6e73 653a 3a20 204c 6963 656e 7365 2066 nse:: License f │ │ │ │ +00044570: 6f72 2063 6f70 7969 6e67 2074 6869 7320 or copying this │ │ │ │ +00044580: 6d61 6e75 616c 2e0a 0a1f 0a46 696c 653a manual.....File: │ │ │ │ +00044590: 2067 7275 622e 696e 666f 2c20 204e 6f64 grub.info, Nod │ │ │ │ +000445a0: 653a 2047 4e55 2046 7265 6520 446f 6375 e: GNU Free Docu │ │ │ │ +000445b0: 6d65 6e74 6174 696f 6e20 4c69 6365 6e73 mentation Licens │ │ │ │ +000445c0: 652c 2020 5570 3a20 436f 7079 696e 6720 e, Up: Copying │ │ │ │ +000445d0: 5468 6973 204d 616e 7561 6c0a 0a44 2e31 This Manual..D.1 │ │ │ │ +000445e0: 2047 4e55 2046 7265 6520 446f 6375 6d65 GNU Free Docume │ │ │ │ +000445f0: 6e74 6174 696f 6e20 4c69 6365 6e73 650a ntation License. │ │ │ │ 00044600: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ -00044610: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a ==============.. │ │ │ │ -00044620: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00044630: 2020 2020 2020 5665 7273 696f 6e20 312e Version 1. │ │ │ │ -00044640: 322c 204e 6f76 656d 6265 7220 3230 3032 2, November 2002 │ │ │ │ -00044650: 0a0a 2020 2020 2043 6f70 7972 6967 6874 .. Copyright │ │ │ │ -00044660: 2028 4329 2032 3030 302c 3230 3031 2c32 (C) 2000,2001,2 │ │ │ │ -00044670: 3030 3220 4672 6565 2053 6f66 7477 6172 002 Free Softwar │ │ │ │ -00044680: 6520 466f 756e 6461 7469 6f6e 2c20 496e e Foundation, In │ │ │ │ -00044690: 632e 0a20 2020 2020 3531 2046 7261 6e6b c.. 51 Frank │ │ │ │ -000446a0: 6c69 6e20 5374 2c20 4669 6674 6820 466c lin St, Fifth Fl │ │ │ │ -000446b0: 6f6f 722c 2042 6f73 746f 6e2c 204d 4120 oor, Boston, MA │ │ │ │ -000446c0: 2030 3231 3130 2d31 3330 312c 2055 5341 02110-1301, USA │ │ │ │ -000446d0: 0a0a 2020 2020 2045 7665 7279 6f6e 6520 .. Everyone │ │ │ │ -000446e0: 6973 2070 6572 6d69 7474 6564 2074 6f20 is permitted to │ │ │ │ -000446f0: 636f 7079 2061 6e64 2064 6973 7472 6962 copy and distrib │ │ │ │ -00044700: 7574 6520 7665 7262 6174 696d 2063 6f70 ute verbatim cop │ │ │ │ -00044710: 6965 730a 2020 2020 206f 6620 7468 6973 ies. of this │ │ │ │ -00044720: 206c 6963 656e 7365 2064 6f63 756d 656e license documen │ │ │ │ -00044730: 742c 2062 7574 2063 6861 6e67 696e 6720 t, but changing │ │ │ │ -00044740: 6974 2069 7320 6e6f 7420 616c 6c6f 7765 it is not allowe │ │ │ │ -00044750: 642e 0a0a 2020 302e 2050 5245 414d 424c d... 0. PREAMBL │ │ │ │ -00044760: 450a 0a20 2020 2020 5468 6520 7075 7270 E.. The purp │ │ │ │ -00044770: 6f73 6520 6f66 2074 6869 7320 4c69 6365 ose of this Lice │ │ │ │ -00044780: 6e73 6520 6973 2074 6f20 6d61 6b65 2061 nse is to make a │ │ │ │ -00044790: 206d 616e 7561 6c2c 2074 6578 7462 6f6f manual, textboo │ │ │ │ -000447a0: 6b2c 206f 7220 6f74 6865 720a 2020 2020 k, or other. │ │ │ │ -000447b0: 2066 756e 6374 696f 6e61 6c20 616e 6420 functional and │ │ │ │ -000447c0: 7573 6566 756c 2064 6f63 756d 656e 7420 useful document │ │ │ │ -000447d0: 2266 7265 6522 2069 6e20 7468 6520 7365 "free" in the se │ │ │ │ -000447e0: 6e73 6520 6f66 2066 7265 6564 6f6d 3a20 nse of freedom: │ │ │ │ -000447f0: 746f 0a20 2020 2020 6173 7375 7265 2065 to. assure e │ │ │ │ -00044800: 7665 7279 6f6e 6520 7468 6520 6566 6665 veryone the effe │ │ │ │ -00044810: 6374 6976 6520 6672 6565 646f 6d20 746f ctive freedom to │ │ │ │ -00044820: 2063 6f70 7920 616e 6420 7265 6469 7374 copy and redist │ │ │ │ -00044830: 7269 6275 7465 2069 742c 0a20 2020 2020 ribute it,. │ │ │ │ -00044840: 7769 7468 206f 7220 7769 7468 6f75 7420 with or without │ │ │ │ -00044850: 6d6f 6469 6679 696e 6720 6974 2c20 6569 modifying it, ei │ │ │ │ -00044860: 7468 6572 2063 6f6d 6d65 7263 6961 6c6c ther commerciall │ │ │ │ -00044870: 7920 6f72 0a20 2020 2020 6e6f 6e63 6f6d y or. noncom │ │ │ │ -00044880: 6d65 7263 6961 6c6c 792e 2020 5365 636f mercially. Seco │ │ │ │ -00044890: 6e64 6172 696c 792c 2074 6869 7320 4c69 ndarily, this Li │ │ │ │ -000448a0: 6365 6e73 6520 7072 6573 6572 7665 7320 cense preserves │ │ │ │ -000448b0: 666f 7220 7468 650a 2020 2020 2061 7574 for the. aut │ │ │ │ -000448c0: 686f 7220 616e 6420 7075 626c 6973 6865 hor and publishe │ │ │ │ -000448d0: 7220 6120 7761 7920 746f 2067 6574 2063 r a way to get c │ │ │ │ -000448e0: 7265 6469 7420 666f 7220 7468 6569 7220 redit for their │ │ │ │ -000448f0: 776f 726b 2c20 7768 696c 6520 6e6f 740a work, while not. │ │ │ │ -00044900: 2020 2020 2062 6569 6e67 2063 6f6e 7369 being consi │ │ │ │ -00044910: 6465 7265 6420 7265 7370 6f6e 7369 626c dered responsibl │ │ │ │ -00044920: 6520 666f 7220 6d6f 6469 6669 6361 7469 e for modificati │ │ │ │ -00044930: 6f6e 7320 6d61 6465 2062 7920 6f74 6865 ons made by othe │ │ │ │ -00044940: 7273 2e0a 0a20 2020 2020 5468 6973 204c rs... This L │ │ │ │ -00044950: 6963 656e 7365 2069 7320 6120 6b69 6e64 icense is a kind │ │ │ │ -00044960: 206f 6620 2263 6f70 796c 6566 7422 2c20 of "copyleft", │ │ │ │ -00044970: 7768 6963 6820 6d65 616e 7320 7468 6174 which means that │ │ │ │ -00044980: 2064 6572 6976 6174 6976 650a 2020 2020 derivative. │ │ │ │ -00044990: 2077 6f72 6b73 206f 6620 7468 6520 646f works of the do │ │ │ │ -000449a0: 6375 6d65 6e74 206d 7573 7420 7468 656d cument must them │ │ │ │ -000449b0: 7365 6c76 6573 2062 6520 6672 6565 2069 selves be free i │ │ │ │ -000449c0: 6e20 7468 6520 7361 6d65 2073 656e 7365 n the same sense │ │ │ │ -000449d0: 2e0a 2020 2020 2049 7420 636f 6d70 6c65 .. It comple │ │ │ │ -000449e0: 6d65 6e74 7320 7468 6520 474e 5520 4765 ments the GNU Ge │ │ │ │ -000449f0: 6e65 7261 6c20 5075 626c 6963 204c 6963 neral Public Lic │ │ │ │ -00044a00: 656e 7365 2c20 7768 6963 6820 6973 2061 ense, which is a │ │ │ │ -00044a10: 2063 6f70 796c 6566 740a 2020 2020 206c copyleft. l │ │ │ │ -00044a20: 6963 656e 7365 2064 6573 6967 6e65 6420 icense designed │ │ │ │ -00044a30: 666f 7220 6672 6565 2073 6f66 7477 6172 for free softwar │ │ │ │ -00044a40: 652e 0a0a 2020 2020 2057 6520 6861 7665 e... We have │ │ │ │ -00044a50: 2064 6573 6967 6e65 6420 7468 6973 204c designed this L │ │ │ │ -00044a60: 6963 656e 7365 2069 6e20 6f72 6465 7220 icense in order │ │ │ │ -00044a70: 746f 2075 7365 2069 7420 666f 7220 6d61 to use it for ma │ │ │ │ -00044a80: 6e75 616c 7320 666f 720a 2020 2020 2066 nuals for. f │ │ │ │ -00044a90: 7265 6520 736f 6674 7761 7265 2c20 6265 ree software, be │ │ │ │ -00044aa0: 6361 7573 6520 6672 6565 2073 6f66 7477 cause free softw │ │ │ │ -00044ab0: 6172 6520 6e65 6564 7320 6672 6565 2064 are needs free d │ │ │ │ -00044ac0: 6f63 756d 656e 7461 7469 6f6e 3a20 610a ocumentation: a. │ │ │ │ -00044ad0: 2020 2020 2066 7265 6520 7072 6f67 7261 free progra │ │ │ │ -00044ae0: 6d20 7368 6f75 6c64 2063 6f6d 6520 7769 m should come wi │ │ │ │ -00044af0: 7468 206d 616e 7561 6c73 2070 726f 7669 th manuals provi │ │ │ │ -00044b00: 6469 6e67 2074 6865 2073 616d 6520 6672 ding the same fr │ │ │ │ -00044b10: 6565 646f 6d73 0a20 2020 2020 7468 6174 eedoms. that │ │ │ │ -00044b20: 2074 6865 2073 6f66 7477 6172 6520 646f the software do │ │ │ │ -00044b30: 6573 2e20 2042 7574 2074 6869 7320 4c69 es. But this Li │ │ │ │ -00044b40: 6365 6e73 6520 6973 206e 6f74 206c 696d cense is not lim │ │ │ │ -00044b50: 6974 6564 2074 6f0a 2020 2020 2073 6f66 ited to. sof │ │ │ │ -00044b60: 7477 6172 6520 6d61 6e75 616c 733b 2069 tware manuals; i │ │ │ │ -00044b70: 7420 6361 6e20 6265 2075 7365 6420 666f t can be used fo │ │ │ │ -00044b80: 7220 616e 7920 7465 7874 7561 6c20 776f r any textual wo │ │ │ │ -00044b90: 726b 2c20 7265 6761 7264 6c65 7373 0a20 rk, regardless. │ │ │ │ -00044ba0: 2020 2020 6f66 2073 7562 6a65 6374 206d of subject m │ │ │ │ -00044bb0: 6174 7465 7220 6f72 2077 6865 7468 6572 atter or whether │ │ │ │ -00044bc0: 2069 7420 6973 2070 7562 6c69 7368 6564 it is published │ │ │ │ -00044bd0: 2061 7320 6120 7072 696e 7465 6420 626f as a printed bo │ │ │ │ -00044be0: 6f6b 2e20 2057 650a 2020 2020 2072 6563 ok. We. rec │ │ │ │ -00044bf0: 6f6d 6d65 6e64 2074 6869 7320 4c69 6365 ommend this Lice │ │ │ │ -00044c00: 6e73 6520 7072 696e 6369 7061 6c6c 7920 nse principally │ │ │ │ -00044c10: 666f 7220 776f 726b 7320 7768 6f73 6520 for works whose │ │ │ │ -00044c20: 7075 7270 6f73 6520 6973 0a20 2020 2020 purpose is. │ │ │ │ -00044c30: 696e 7374 7275 6374 696f 6e20 6f72 2072 instruction or r │ │ │ │ -00044c40: 6566 6572 656e 6365 2e0a 0a20 2031 2e20 eference... 1. │ │ │ │ -00044c50: 4150 504c 4943 4142 494c 4954 5920 414e APPLICABILITY AN │ │ │ │ -00044c60: 4420 4445 4649 4e49 5449 4f4e 530a 0a20 D DEFINITIONS.. │ │ │ │ -00044c70: 2020 2020 5468 6973 204c 6963 656e 7365 This License │ │ │ │ -00044c80: 2061 7070 6c69 6573 2074 6f20 616e 7920 applies to any │ │ │ │ -00044c90: 6d61 6e75 616c 206f 7220 6f74 6865 7220 manual or other │ │ │ │ -00044ca0: 776f 726b 2c20 696e 2061 6e79 206d 6564 work, in any med │ │ │ │ -00044cb0: 6975 6d2c 0a20 2020 2020 7468 6174 2063 ium,. that c │ │ │ │ -00044cc0: 6f6e 7461 696e 7320 6120 6e6f 7469 6365 ontains a notice │ │ │ │ -00044cd0: 2070 6c61 6365 6420 6279 2074 6865 2063 placed by the c │ │ │ │ -00044ce0: 6f70 7972 6967 6874 2068 6f6c 6465 7220 opyright holder │ │ │ │ -00044cf0: 7361 7969 6e67 2069 7420 6361 6e0a 2020 saying it can. │ │ │ │ -00044d00: 2020 2062 6520 6469 7374 7269 6275 7465 be distribute │ │ │ │ -00044d10: 6420 756e 6465 7220 7468 6520 7465 726d d under the term │ │ │ │ -00044d20: 7320 6f66 2074 6869 7320 4c69 6365 6e73 s of this Licens │ │ │ │ -00044d30: 652e 2020 5375 6368 2061 206e 6f74 6963 e. Such a notic │ │ │ │ -00044d40: 650a 2020 2020 2067 7261 6e74 7320 6120 e. grants a │ │ │ │ -00044d50: 776f 726c 642d 7769 6465 2c20 726f 7961 world-wide, roya │ │ │ │ -00044d60: 6c74 792d 6672 6565 206c 6963 656e 7365 lty-free license │ │ │ │ -00044d70: 2c20 756e 6c69 6d69 7465 6420 696e 2064 , unlimited in d │ │ │ │ -00044d80: 7572 6174 696f 6e2c 0a20 2020 2020 746f uration,. to │ │ │ │ -00044d90: 2075 7365 2074 6861 7420 776f 726b 2075 use that work u │ │ │ │ -00044da0: 6e64 6572 2074 6865 2063 6f6e 6469 7469 nder the conditi │ │ │ │ -00044db0: 6f6e 7320 7374 6174 6564 2068 6572 6569 ons stated herei │ │ │ │ -00044dc0: 6e2e 2020 5468 650a 2020 2020 2022 446f n. The. "Do │ │ │ │ -00044dd0: 6375 6d65 6e74 222c 2062 656c 6f77 2c20 cument", below, │ │ │ │ -00044de0: 7265 6665 7273 2074 6f20 616e 7920 7375 refers to any su │ │ │ │ -00044df0: 6368 206d 616e 7561 6c20 6f72 2077 6f72 ch manual or wor │ │ │ │ -00044e00: 6b2e 2020 416e 7920 6d65 6d62 6572 0a20 k. Any member. │ │ │ │ -00044e10: 2020 2020 6f66 2074 6865 2070 7562 6c69 of the publi │ │ │ │ -00044e20: 6320 6973 2061 206c 6963 656e 7365 652c c is a licensee, │ │ │ │ -00044e30: 2061 6e64 2069 7320 6164 6472 6573 7365 and is addresse │ │ │ │ -00044e40: 6420 6173 2022 796f 7522 2e20 2059 6f75 d as "you". You │ │ │ │ -00044e50: 2061 6363 6570 740a 2020 2020 2074 6865 accept. the │ │ │ │ -00044e60: 206c 6963 656e 7365 2069 6620 796f 7520 license if you │ │ │ │ -00044e70: 636f 7079 2c20 6d6f 6469 6679 206f 7220 copy, modify or │ │ │ │ -00044e80: 6469 7374 7269 6275 7465 2074 6865 2077 distribute the w │ │ │ │ -00044e90: 6f72 6b20 696e 2061 2077 6179 0a20 2020 ork in a way. │ │ │ │ -00044ea0: 2020 7265 7175 6972 696e 6720 7065 726d requiring perm │ │ │ │ -00044eb0: 6973 7369 6f6e 2075 6e64 6572 2063 6f70 ission under cop │ │ │ │ -00044ec0: 7972 6967 6874 206c 6177 2e0a 0a20 2020 yright law... │ │ │ │ -00044ed0: 2020 4120 224d 6f64 6966 6965 6420 5665 A "Modified Ve │ │ │ │ -00044ee0: 7273 696f 6e22 206f 6620 7468 6520 446f rsion" of the Do │ │ │ │ -00044ef0: 6375 6d65 6e74 206d 6561 6e73 2061 6e79 cument means any │ │ │ │ -00044f00: 2077 6f72 6b20 636f 6e74 6169 6e69 6e67 work containing │ │ │ │ -00044f10: 2074 6865 0a20 2020 2020 446f 6375 6d65 the. Docume │ │ │ │ -00044f20: 6e74 206f 7220 6120 706f 7274 696f 6e20 nt or a portion │ │ │ │ -00044f30: 6f66 2069 742c 2065 6974 6865 7220 636f of it, either co │ │ │ │ -00044f40: 7069 6564 2076 6572 6261 7469 6d2c 206f pied verbatim, o │ │ │ │ -00044f50: 7220 7769 7468 0a20 2020 2020 6d6f 6469 r with. modi │ │ │ │ -00044f60: 6669 6361 7469 6f6e 7320 616e 642f 6f72 fications and/or │ │ │ │ -00044f70: 2074 7261 6e73 6c61 7465 6420 696e 746f translated into │ │ │ │ -00044f80: 2061 6e6f 7468 6572 206c 616e 6775 6167 another languag │ │ │ │ -00044f90: 652e 0a0a 2020 2020 2041 2022 5365 636f e... A "Seco │ │ │ │ -00044fa0: 6e64 6172 7920 5365 6374 696f 6e22 2069 ndary Section" i │ │ │ │ -00044fb0: 7320 6120 6e61 6d65 6420 6170 7065 6e64 s a named append │ │ │ │ -00044fc0: 6978 206f 7220 6120 6672 6f6e 742d 6d61 ix or a front-ma │ │ │ │ -00044fd0: 7474 6572 2073 6563 7469 6f6e 0a20 2020 tter section. │ │ │ │ -00044fe0: 2020 6f66 2074 6865 2044 6f63 756d 656e of the Documen │ │ │ │ -00044ff0: 7420 7468 6174 2064 6561 6c73 2065 7863 t that deals exc │ │ │ │ -00045000: 6c75 7369 7665 6c79 2077 6974 6820 7468 lusively with th │ │ │ │ -00045010: 6520 7265 6c61 7469 6f6e 7368 6970 206f e relationship o │ │ │ │ -00045020: 6620 7468 650a 2020 2020 2070 7562 6c69 f the. publi │ │ │ │ -00045030: 7368 6572 7320 6f72 2061 7574 686f 7273 shers or authors │ │ │ │ -00045040: 206f 6620 7468 6520 446f 6375 6d65 6e74 of the Document │ │ │ │ -00045050: 2074 6f20 7468 6520 446f 6375 6d65 6e74 to the Document │ │ │ │ -00045060: 2773 206f 7665 7261 6c6c 0a20 2020 2020 's overall. │ │ │ │ -00045070: 7375 626a 6563 7420 286f 7220 746f 2072 subject (or to r │ │ │ │ -00045080: 656c 6174 6564 206d 6174 7465 7273 2920 elated matters) │ │ │ │ -00045090: 616e 6420 636f 6e74 6169 6e73 206e 6f74 and contains not │ │ │ │ -000450a0: 6869 6e67 2074 6861 7420 636f 756c 640a hing that could. │ │ │ │ -000450b0: 2020 2020 2066 616c 6c20 6469 7265 6374 fall direct │ │ │ │ -000450c0: 6c79 2077 6974 6869 6e20 7468 6174 206f ly within that o │ │ │ │ -000450d0: 7665 7261 6c6c 2073 7562 6a65 6374 2e20 verall subject. │ │ │ │ -000450e0: 2028 5468 7573 2c20 6966 2074 6865 2044 (Thus, if the D │ │ │ │ -000450f0: 6f63 756d 656e 740a 2020 2020 2069 7320 ocument. is │ │ │ │ -00045100: 696e 2070 6172 7420 6120 7465 7874 626f in part a textbo │ │ │ │ -00045110: 6f6b 206f 6620 6d61 7468 656d 6174 6963 ok of mathematic │ │ │ │ -00045120: 732c 2061 2053 6563 6f6e 6461 7279 2053 s, a Secondary S │ │ │ │ -00045130: 6563 7469 6f6e 206d 6179 206e 6f74 0a20 ection may not. │ │ │ │ -00045140: 2020 2020 6578 706c 6169 6e20 616e 7920 explain any │ │ │ │ -00045150: 6d61 7468 656d 6174 6963 732e 2920 2054 mathematics.) T │ │ │ │ -00045160: 6865 2072 656c 6174 696f 6e73 6869 7020 he relationship │ │ │ │ -00045170: 636f 756c 6420 6265 2061 206d 6174 7465 could be a matte │ │ │ │ -00045180: 7220 6f66 0a20 2020 2020 6869 7374 6f72 r of. histor │ │ │ │ -00045190: 6963 616c 2063 6f6e 6e65 6374 696f 6e20 ical connection │ │ │ │ -000451a0: 7769 7468 2074 6865 2073 7562 6a65 6374 with the subject │ │ │ │ -000451b0: 206f 7220 7769 7468 2072 656c 6174 6564 or with related │ │ │ │ -000451c0: 206d 6174 7465 7273 2c20 6f72 0a20 2020 matters, or. │ │ │ │ -000451d0: 2020 6f66 206c 6567 616c 2c20 636f 6d6d of legal, comm │ │ │ │ -000451e0: 6572 6369 616c 2c20 7068 696c 6f73 6f70 ercial, philosop │ │ │ │ -000451f0: 6869 6361 6c2c 2065 7468 6963 616c 206f hical, ethical o │ │ │ │ -00045200: 7220 706f 6c69 7469 6361 6c20 706f 7369 r political posi │ │ │ │ -00045210: 7469 6f6e 0a20 2020 2020 7265 6761 7264 tion. regard │ │ │ │ -00045220: 696e 6720 7468 656d 2e0a 0a20 2020 2020 ing them... │ │ │ │ -00045230: 5468 6520 2249 6e76 6172 6961 6e74 2053 The "Invariant S │ │ │ │ -00045240: 6563 7469 6f6e 7322 2061 7265 2063 6572 ections" are cer │ │ │ │ -00045250: 7461 696e 2053 6563 6f6e 6461 7279 2053 tain Secondary S │ │ │ │ -00045260: 6563 7469 6f6e 7320 7768 6f73 650a 2020 ections whose. │ │ │ │ -00045270: 2020 2074 6974 6c65 7320 6172 6520 6465 titles are de │ │ │ │ -00045280: 7369 676e 6174 6564 2c20 6173 2062 6569 signated, as bei │ │ │ │ -00045290: 6e67 2074 686f 7365 206f 6620 496e 7661 ng those of Inva │ │ │ │ -000452a0: 7269 616e 7420 5365 6374 696f 6e73 2c20 riant Sections, │ │ │ │ -000452b0: 696e 2074 6865 0a20 2020 2020 6e6f 7469 in the. noti │ │ │ │ -000452c0: 6365 2074 6861 7420 7361 7973 2074 6861 ce that says tha │ │ │ │ -000452d0: 7420 7468 6520 446f 6375 6d65 6e74 2069 t the Document i │ │ │ │ -000452e0: 7320 7265 6c65 6173 6564 2075 6e64 6572 s released under │ │ │ │ -000452f0: 2074 6869 7320 4c69 6365 6e73 652e 0a20 this License.. │ │ │ │ -00045300: 2020 2020 4966 2061 2073 6563 7469 6f6e If a section │ │ │ │ -00045310: 2064 6f65 7320 6e6f 7420 6669 7420 7468 does not fit th │ │ │ │ -00045320: 6520 6162 6f76 6520 6465 6669 6e69 7469 e above definiti │ │ │ │ -00045330: 6f6e 206f 6620 5365 636f 6e64 6172 7920 on of Secondary │ │ │ │ -00045340: 7468 656e 2069 740a 2020 2020 2069 7320 then it. is │ │ │ │ -00045350: 6e6f 7420 616c 6c6f 7765 6420 746f 2062 not allowed to b │ │ │ │ -00045360: 6520 6465 7369 676e 6174 6564 2061 7320 e designated as │ │ │ │ -00045370: 496e 7661 7269 616e 742e 2020 5468 6520 Invariant. The │ │ │ │ -00045380: 446f 6375 6d65 6e74 206d 6179 0a20 2020 Document may. │ │ │ │ -00045390: 2020 636f 6e74 6169 6e20 7a65 726f 2049 contain zero I │ │ │ │ -000453a0: 6e76 6172 6961 6e74 2053 6563 7469 6f6e nvariant Section │ │ │ │ -000453b0: 732e 2020 4966 2074 6865 2044 6f63 756d s. If the Docum │ │ │ │ -000453c0: 656e 7420 646f 6573 206e 6f74 2069 6465 ent does not ide │ │ │ │ -000453d0: 6e74 6966 790a 2020 2020 2061 6e79 2049 ntify. any I │ │ │ │ -000453e0: 6e76 6172 6961 6e74 2053 6563 7469 6f6e nvariant Section │ │ │ │ -000453f0: 7320 7468 656e 2074 6865 7265 2061 7265 s then there are │ │ │ │ -00045400: 206e 6f6e 652e 0a0a 2020 2020 2054 6865 none... The │ │ │ │ -00045410: 2022 436f 7665 7220 5465 7874 7322 2061 "Cover Texts" a │ │ │ │ -00045420: 7265 2063 6572 7461 696e 2073 686f 7274 re certain short │ │ │ │ -00045430: 2070 6173 7361 6765 7320 6f66 2074 6578 passages of tex │ │ │ │ -00045440: 7420 7468 6174 2061 7265 0a20 2020 2020 t that are. │ │ │ │ -00045450: 6c69 7374 6564 2c20 6173 2046 726f 6e74 listed, as Front │ │ │ │ -00045460: 2d43 6f76 6572 2054 6578 7473 206f 7220 -Cover Texts or │ │ │ │ -00045470: 4261 636b 2d43 6f76 6572 2054 6578 7473 Back-Cover Texts │ │ │ │ -00045480: 2c20 696e 2074 6865 206e 6f74 6963 650a , in the notice. │ │ │ │ -00045490: 2020 2020 2074 6861 7420 7361 7973 2074 that says t │ │ │ │ -000454a0: 6861 7420 7468 6520 446f 6375 6d65 6e74 hat the Document │ │ │ │ -000454b0: 2069 7320 7265 6c65 6173 6564 2075 6e64 is released und │ │ │ │ -000454c0: 6572 2074 6869 7320 4c69 6365 6e73 652e er this License. │ │ │ │ -000454d0: 2020 410a 2020 2020 2046 726f 6e74 2d43 A. Front-C │ │ │ │ -000454e0: 6f76 6572 2054 6578 7420 6d61 7920 6265 over Text may be │ │ │ │ -000454f0: 2061 7420 6d6f 7374 2035 2077 6f72 6473 at most 5 words │ │ │ │ -00045500: 2c20 616e 6420 6120 4261 636b 2d43 6f76 , and a Back-Cov │ │ │ │ -00045510: 6572 2054 6578 7420 6d61 790a 2020 2020 er Text may. │ │ │ │ -00045520: 2062 6520 6174 206d 6f73 7420 3235 2077 be at most 25 w │ │ │ │ -00045530: 6f72 6473 2e0a 0a20 2020 2020 4120 2254 ords... A "T │ │ │ │ -00045540: 7261 6e73 7061 7265 6e74 2220 636f 7079 ransparent" copy │ │ │ │ -00045550: 206f 6620 7468 6520 446f 6375 6d65 6e74 of the Document │ │ │ │ -00045560: 206d 6561 6e73 2061 206d 6163 6869 6e65 means a machine │ │ │ │ -00045570: 2d72 6561 6461 626c 6520 636f 7079 2c0a -readable copy,. │ │ │ │ -00045580: 2020 2020 2072 6570 7265 7365 6e74 6564 represented │ │ │ │ -00045590: 2069 6e20 6120 666f 726d 6174 2077 686f in a format who │ │ │ │ -000455a0: 7365 2073 7065 6369 6669 6361 7469 6f6e se specification │ │ │ │ -000455b0: 2069 7320 6176 6169 6c61 626c 6520 746f is available to │ │ │ │ -000455c0: 2074 6865 0a20 2020 2020 6765 6e65 7261 the. genera │ │ │ │ -000455d0: 6c20 7075 626c 6963 2c20 7468 6174 2069 l public, that i │ │ │ │ -000455e0: 7320 7375 6974 6162 6c65 2066 6f72 2072 s suitable for r │ │ │ │ -000455f0: 6576 6973 696e 6720 7468 6520 646f 6375 evising the docu │ │ │ │ -00045600: 6d65 6e74 0a20 2020 2020 7374 7261 6967 ment. straig │ │ │ │ -00045610: 6874 666f 7277 6172 646c 7920 7769 7468 htforwardly with │ │ │ │ -00045620: 2067 656e 6572 6963 2074 6578 7420 6564 generic text ed │ │ │ │ -00045630: 6974 6f72 7320 6f72 2028 666f 7220 696d itors or (for im │ │ │ │ -00045640: 6167 6573 2063 6f6d 706f 7365 640a 2020 ages composed. │ │ │ │ -00045650: 2020 206f 6620 7069 7865 6c73 2920 6765 of pixels) ge │ │ │ │ -00045660: 6e65 7269 6320 7061 696e 7420 7072 6f67 neric paint prog │ │ │ │ -00045670: 7261 6d73 206f 7220 2866 6f72 2064 7261 rams or (for dra │ │ │ │ -00045680: 7769 6e67 7329 2073 6f6d 6520 7769 6465 wings) some wide │ │ │ │ -00045690: 6c79 0a20 2020 2020 6176 6169 6c61 626c ly. availabl │ │ │ │ -000456a0: 6520 6472 6177 696e 6720 6564 6974 6f72 e drawing editor │ │ │ │ -000456b0: 2c20 616e 6420 7468 6174 2069 7320 7375 , and that is su │ │ │ │ -000456c0: 6974 6162 6c65 2066 6f72 2069 6e70 7574 itable for input │ │ │ │ -000456d0: 2074 6f20 7465 7874 0a20 2020 2020 666f to text. fo │ │ │ │ -000456e0: 726d 6174 7465 7273 206f 7220 666f 7220 rmatters or for │ │ │ │ -000456f0: 6175 746f 6d61 7469 6320 7472 616e 736c automatic transl │ │ │ │ -00045700: 6174 696f 6e20 746f 2061 2076 6172 6965 ation to a varie │ │ │ │ -00045710: 7479 206f 6620 666f 726d 6174 730a 2020 ty of formats. │ │ │ │ -00045720: 2020 2073 7569 7461 626c 6520 666f 7220 suitable for │ │ │ │ -00045730: 696e 7075 7420 746f 2074 6578 7420 666f input to text fo │ │ │ │ -00045740: 726d 6174 7465 7273 2e20 2041 2063 6f70 rmatters. A cop │ │ │ │ -00045750: 7920 6d61 6465 2069 6e20 616e 206f 7468 y made in an oth │ │ │ │ -00045760: 6572 7769 7365 0a20 2020 2020 5472 616e erwise. Tran │ │ │ │ -00045770: 7370 6172 656e 7420 6669 6c65 2066 6f72 sparent file for │ │ │ │ -00045780: 6d61 7420 7768 6f73 6520 6d61 726b 7570 mat whose markup │ │ │ │ -00045790: 2c20 6f72 2061 6273 656e 6365 206f 6620 , or absence of │ │ │ │ -000457a0: 6d61 726b 7570 2c20 6861 730a 2020 2020 markup, has. │ │ │ │ -000457b0: 2062 6565 6e20 6172 7261 6e67 6564 2074 been arranged t │ │ │ │ -000457c0: 6f20 7468 7761 7274 206f 7220 6469 7363 o thwart or disc │ │ │ │ -000457d0: 6f75 7261 6765 2073 7562 7365 7175 656e ourage subsequen │ │ │ │ -000457e0: 7420 6d6f 6469 6669 6361 7469 6f6e 2062 t modification b │ │ │ │ -000457f0: 790a 2020 2020 2072 6561 6465 7273 2069 y. readers i │ │ │ │ -00045800: 7320 6e6f 7420 5472 616e 7370 6172 656e s not Transparen │ │ │ │ -00045810: 742e 2020 416e 2069 6d61 6765 2066 6f72 t. An image for │ │ │ │ -00045820: 6d61 7420 6973 206e 6f74 2054 7261 6e73 mat is not Trans │ │ │ │ -00045830: 7061 7265 6e74 2069 660a 2020 2020 2075 parent if. u │ │ │ │ -00045840: 7365 6420 666f 7220 616e 7920 7375 6273 sed for any subs │ │ │ │ -00045850: 7461 6e74 6961 6c20 616d 6f75 6e74 206f tantial amount o │ │ │ │ -00045860: 6620 7465 7874 2e20 2041 2063 6f70 7920 f text. A copy │ │ │ │ -00045870: 7468 6174 2069 7320 6e6f 740a 2020 2020 that is not. │ │ │ │ -00045880: 2022 5472 616e 7370 6172 656e 7422 2069 "Transparent" i │ │ │ │ -00045890: 7320 6361 6c6c 6564 2022 4f70 6171 7565 s called "Opaque │ │ │ │ -000458a0: 222e 0a0a 2020 2020 2045 7861 6d70 6c65 "... Example │ │ │ │ -000458b0: 7320 6f66 2073 7569 7461 626c 6520 666f s of suitable fo │ │ │ │ -000458c0: 726d 6174 7320 666f 7220 5472 616e 7370 rmats for Transp │ │ │ │ -000458d0: 6172 656e 7420 636f 7069 6573 2069 6e63 arent copies inc │ │ │ │ -000458e0: 6c75 6465 2070 6c61 696e 0a20 2020 2020 lude plain. │ │ │ │ -000458f0: 4153 4349 4920 7769 7468 6f75 7420 6d61 ASCII without ma │ │ │ │ -00045900: 726b 7570 2c20 5465 7869 6e66 6f20 696e rkup, Texinfo in │ │ │ │ -00045910: 7075 7420 666f 726d 6174 2c20 4c61 5465 put format, LaTe │ │ │ │ -00045920: 5820 696e 7075 7420 666f 726d 6174 2c0a X input format,. │ │ │ │ -00045930: 2020 2020 2053 474d 4c20 6f72 2058 4d4c SGML or XML │ │ │ │ -00045940: 2075 7369 6e67 2061 2070 7562 6c69 636c using a publicl │ │ │ │ -00045950: 7920 6176 6169 6c61 626c 6520 4454 442c y available DTD, │ │ │ │ -00045960: 2061 6e64 2073 7461 6e64 6172 642d 636f and standard-co │ │ │ │ -00045970: 6e66 6f72 6d69 6e67 0a20 2020 2020 7369 nforming. si │ │ │ │ -00045980: 6d70 6c65 2048 544d 4c2c 2050 6f73 7453 mple HTML, PostS │ │ │ │ -00045990: 6372 6970 7420 6f72 2050 4446 2064 6573 cript or PDF des │ │ │ │ -000459a0: 6967 6e65 6420 666f 7220 6875 6d61 6e20 igned for human │ │ │ │ -000459b0: 6d6f 6469 6669 6361 7469 6f6e 2e0a 2020 modification.. │ │ │ │ -000459c0: 2020 2045 7861 6d70 6c65 7320 6f66 2074 Examples of t │ │ │ │ -000459d0: 7261 6e73 7061 7265 6e74 2069 6d61 6765 ransparent image │ │ │ │ -000459e0: 2066 6f72 6d61 7473 2069 6e63 6c75 6465 formats include │ │ │ │ -000459f0: 2050 4e47 2c20 5843 4620 616e 6420 4a50 PNG, XCF and JP │ │ │ │ -00045a00: 472e 0a20 2020 2020 4f70 6171 7565 2066 G.. Opaque f │ │ │ │ -00045a10: 6f72 6d61 7473 2069 6e63 6c75 6465 2070 ormats include p │ │ │ │ -00045a20: 726f 7072 6965 7461 7279 2066 6f72 6d61 roprietary forma │ │ │ │ -00045a30: 7473 2074 6861 7420 6361 6e20 6265 2072 ts that can be r │ │ │ │ -00045a40: 6561 6420 616e 640a 2020 2020 2065 6469 ead and. edi │ │ │ │ -00045a50: 7465 6420 6f6e 6c79 2062 7920 7072 6f70 ted only by prop │ │ │ │ -00045a60: 7269 6574 6172 7920 776f 7264 2070 726f rietary word pro │ │ │ │ -00045a70: 6365 7373 6f72 732c 2053 474d 4c20 6f72 cessors, SGML or │ │ │ │ -00045a80: 2058 4d4c 2066 6f72 2077 6869 6368 0a20 XML for which. │ │ │ │ -00045a90: 2020 2020 7468 6520 4454 4420 616e 642f the DTD and/ │ │ │ │ -00045aa0: 6f72 2070 726f 6365 7373 696e 6720 746f or processing to │ │ │ │ -00045ab0: 6f6c 7320 6172 6520 6e6f 7420 6765 6e65 ols are not gene │ │ │ │ -00045ac0: 7261 6c6c 7920 6176 6169 6c61 626c 652c rally available, │ │ │ │ -00045ad0: 2061 6e64 0a20 2020 2020 7468 6520 6d61 and. the ma │ │ │ │ -00045ae0: 6368 696e 652d 6765 6e65 7261 7465 6420 chine-generated │ │ │ │ -00045af0: 4854 4d4c 2c20 506f 7374 5363 7269 7074 HTML, PostScript │ │ │ │ -00045b00: 206f 7220 5044 4620 7072 6f64 7563 6564 or PDF produced │ │ │ │ -00045b10: 2062 7920 736f 6d65 2077 6f72 640a 2020 by some word. │ │ │ │ -00045b20: 2020 2070 726f 6365 7373 6f72 7320 666f processors fo │ │ │ │ -00045b30: 7220 6f75 7470 7574 2070 7572 706f 7365 r output purpose │ │ │ │ -00045b40: 7320 6f6e 6c79 2e0a 0a20 2020 2020 5468 s only... Th │ │ │ │ -00045b50: 6520 2254 6974 6c65 2050 6167 6522 206d e "Title Page" m │ │ │ │ -00045b60: 6561 6e73 2c20 666f 7220 6120 7072 696e eans, for a prin │ │ │ │ -00045b70: 7465 6420 626f 6f6b 2c20 7468 6520 7469 ted book, the ti │ │ │ │ -00045b80: 746c 6520 7061 6765 2069 7473 656c 662c tle page itself, │ │ │ │ -00045b90: 0a20 2020 2020 706c 7573 2073 7563 6820 . plus such │ │ │ │ -00045ba0: 666f 6c6c 6f77 696e 6720 7061 6765 7320 following pages │ │ │ │ -00045bb0: 6173 2061 7265 206e 6565 6465 6420 746f as are needed to │ │ │ │ -00045bc0: 2068 6f6c 642c 206c 6567 6962 6c79 2c20 hold, legibly, │ │ │ │ -00045bd0: 7468 650a 2020 2020 206d 6174 6572 6961 the. materia │ │ │ │ -00045be0: 6c20 7468 6973 204c 6963 656e 7365 2072 l this License r │ │ │ │ -00045bf0: 6571 7569 7265 7320 746f 2061 7070 6561 equires to appea │ │ │ │ -00045c00: 7220 696e 2074 6865 2074 6974 6c65 2070 r in the title p │ │ │ │ -00045c10: 6167 652e 2020 466f 720a 2020 2020 2077 age. For. w │ │ │ │ -00045c20: 6f72 6b73 2069 6e20 666f 726d 6174 7320 orks in formats │ │ │ │ -00045c30: 7768 6963 6820 646f 206e 6f74 2068 6176 which do not hav │ │ │ │ -00045c40: 6520 616e 7920 7469 746c 6520 7061 6765 e any title page │ │ │ │ -00045c50: 2061 7320 7375 6368 2c20 2254 6974 6c65 as such, "Title │ │ │ │ -00045c60: 0a20 2020 2020 5061 6765 2220 6d65 616e . Page" mean │ │ │ │ -00045c70: 7320 7468 6520 7465 7874 206e 6561 7220 s the text near │ │ │ │ -00045c80: 7468 6520 6d6f 7374 2070 726f 6d69 6e65 the most promine │ │ │ │ -00045c90: 6e74 2061 7070 6561 7261 6e63 6520 6f66 nt appearance of │ │ │ │ -00045ca0: 2074 6865 0a20 2020 2020 776f 726b 2773 the. work's │ │ │ │ -00045cb0: 2074 6974 6c65 2c20 7072 6563 6564 696e title, precedin │ │ │ │ -00045cc0: 6720 7468 6520 6265 6769 6e6e 696e 6720 g the beginning │ │ │ │ -00045cd0: 6f66 2074 6865 2062 6f64 7920 6f66 2074 of the body of t │ │ │ │ -00045ce0: 6865 2074 6578 742e 0a0a 2020 2020 2041 he text... A │ │ │ │ -00045cf0: 2073 6563 7469 6f6e 2022 456e 7469 746c section "Entitl │ │ │ │ -00045d00: 6564 2058 595a 2220 6d65 616e 7320 6120 ed XYZ" means a │ │ │ │ -00045d10: 6e61 6d65 6420 7375 6275 6e69 7420 6f66 named subunit of │ │ │ │ -00045d20: 2074 6865 2044 6f63 756d 656e 740a 2020 the Document. │ │ │ │ -00045d30: 2020 2077 686f 7365 2074 6974 6c65 2065 whose title e │ │ │ │ -00045d40: 6974 6865 7220 6973 2070 7265 6369 7365 ither is precise │ │ │ │ -00045d50: 6c79 2058 595a 206f 7220 636f 6e74 6169 ly XYZ or contai │ │ │ │ -00045d60: 6e73 2058 595a 2069 6e20 7061 7265 6e74 ns XYZ in parent │ │ │ │ -00045d70: 6865 7365 730a 2020 2020 2066 6f6c 6c6f heses. follo │ │ │ │ -00045d80: 7769 6e67 2074 6578 7420 7468 6174 2074 wing text that t │ │ │ │ -00045d90: 7261 6e73 6c61 7465 7320 5859 5a20 696e ranslates XYZ in │ │ │ │ -00045da0: 2061 6e6f 7468 6572 206c 616e 6775 6167 another languag │ │ │ │ -00045db0: 652e 2020 2848 6572 6520 5859 5a0a 2020 e. (Here XYZ. │ │ │ │ -00045dc0: 2020 2073 7461 6e64 7320 666f 7220 6120 stands for a │ │ │ │ -00045dd0: 7370 6563 6966 6963 2073 6563 7469 6f6e specific section │ │ │ │ -00045de0: 206e 616d 6520 6d65 6e74 696f 6e65 6420 name mentioned │ │ │ │ -00045df0: 6265 6c6f 772c 2073 7563 6820 6173 0a20 below, such as. │ │ │ │ -00045e00: 2020 2020 2241 636b 6e6f 776c 6564 6765 "Acknowledge │ │ │ │ -00045e10: 6d65 6e74 7322 2c20 2244 6564 6963 6174 ments", "Dedicat │ │ │ │ -00045e20: 696f 6e73 222c 2022 456e 646f 7273 656d ions", "Endorsem │ │ │ │ -00045e30: 656e 7473 222c 206f 7220 2248 6973 746f ents", or "Histo │ │ │ │ -00045e40: 7279 222e 290a 2020 2020 2054 6f20 2250 ry".). To "P │ │ │ │ -00045e50: 7265 7365 7276 6520 7468 6520 5469 746c reserve the Titl │ │ │ │ -00045e60: 6522 206f 6620 7375 6368 2061 2073 6563 e" of such a sec │ │ │ │ -00045e70: 7469 6f6e 2077 6865 6e20 796f 7520 6d6f tion when you mo │ │ │ │ -00045e80: 6469 6679 2074 6865 0a20 2020 2020 446f dify the. Do │ │ │ │ -00045e90: 6375 6d65 6e74 206d 6561 6e73 2074 6861 cument means tha │ │ │ │ -00045ea0: 7420 6974 2072 656d 6169 6e73 2061 2073 t it remains a s │ │ │ │ -00045eb0: 6563 7469 6f6e 2022 456e 7469 746c 6564 ection "Entitled │ │ │ │ -00045ec0: 2058 595a 2220 6163 636f 7264 696e 670a XYZ" according. │ │ │ │ -00045ed0: 2020 2020 2074 6f20 7468 6973 2064 6566 to this def │ │ │ │ -00045ee0: 696e 6974 696f 6e2e 0a0a 2020 2020 2054 inition... T │ │ │ │ -00045ef0: 6865 2044 6f63 756d 656e 7420 6d61 7920 he Document may │ │ │ │ -00045f00: 696e 636c 7564 6520 5761 7272 616e 7479 include Warranty │ │ │ │ -00045f10: 2044 6973 636c 6169 6d65 7273 206e 6578 Disclaimers nex │ │ │ │ -00045f20: 7420 746f 2074 6865 206e 6f74 6963 650a t to the notice. │ │ │ │ -00045f30: 2020 2020 2077 6869 6368 2073 7461 7465 which state │ │ │ │ -00045f40: 7320 7468 6174 2074 6869 7320 4c69 6365 s that this Lice │ │ │ │ -00045f50: 6e73 6520 6170 706c 6965 7320 746f 2074 nse applies to t │ │ │ │ -00045f60: 6865 2044 6f63 756d 656e 742e 2020 5468 he Document. Th │ │ │ │ -00045f70: 6573 650a 2020 2020 2057 6172 7261 6e74 ese. Warrant │ │ │ │ -00045f80: 7920 4469 7363 6c61 696d 6572 7320 6172 y Disclaimers ar │ │ │ │ -00045f90: 6520 636f 6e73 6964 6572 6564 2074 6f20 e considered to │ │ │ │ -00045fa0: 6265 2069 6e63 6c75 6465 6420 6279 2072 be included by r │ │ │ │ -00045fb0: 6566 6572 656e 6365 2069 6e0a 2020 2020 eference in. │ │ │ │ -00045fc0: 2074 6869 7320 4c69 6365 6e73 652c 2062 this License, b │ │ │ │ -00045fd0: 7574 206f 6e6c 7920 6173 2072 6567 6172 ut only as regar │ │ │ │ -00045fe0: 6473 2064 6973 636c 6169 6d69 6e67 2077 ds disclaiming w │ │ │ │ -00045ff0: 6172 7261 6e74 6965 733a 2061 6e79 206f arranties: any o │ │ │ │ -00046000: 7468 6572 0a20 2020 2020 696d 706c 6963 ther. implic │ │ │ │ -00046010: 6174 696f 6e20 7468 6174 2074 6865 7365 ation that these │ │ │ │ -00046020: 2057 6172 7261 6e74 7920 4469 7363 6c61 Warranty Discla │ │ │ │ -00046030: 696d 6572 7320 6d61 7920 6861 7665 2069 imers may have i │ │ │ │ -00046040: 7320 766f 6964 2061 6e64 0a20 2020 2020 s void and. │ │ │ │ -00046050: 6861 7320 6e6f 2065 6666 6563 7420 6f6e has no effect on │ │ │ │ -00046060: 2074 6865 206d 6561 6e69 6e67 206f 6620 the meaning of │ │ │ │ -00046070: 7468 6973 204c 6963 656e 7365 2e0a 0a20 this License... │ │ │ │ -00046080: 2032 2e20 5645 5242 4154 494d 2043 4f50 2. VERBATIM COP │ │ │ │ -00046090: 5949 4e47 0a0a 2020 2020 2059 6f75 206d YING.. You m │ │ │ │ -000460a0: 6179 2063 6f70 7920 616e 6420 6469 7374 ay copy and dist │ │ │ │ -000460b0: 7269 6275 7465 2074 6865 2044 6f63 756d ribute the Docum │ │ │ │ -000460c0: 656e 7420 696e 2061 6e79 206d 6564 6975 ent in any mediu │ │ │ │ -000460d0: 6d2c 2065 6974 6865 720a 2020 2020 2063 m, either. c │ │ │ │ -000460e0: 6f6d 6d65 7263 6961 6c6c 7920 6f72 206e ommercially or n │ │ │ │ -000460f0: 6f6e 636f 6d6d 6572 6369 616c 6c79 2c20 oncommercially, │ │ │ │ -00046100: 7072 6f76 6964 6564 2074 6861 7420 7468 provided that th │ │ │ │ -00046110: 6973 204c 6963 656e 7365 2c20 7468 650a is License, the. │ │ │ │ -00046120: 2020 2020 2063 6f70 7972 6967 6874 206e copyright n │ │ │ │ -00046130: 6f74 6963 6573 2c20 616e 6420 7468 6520 otices, and the │ │ │ │ -00046140: 6c69 6365 6e73 6520 6e6f 7469 6365 2073 license notice s │ │ │ │ -00046150: 6179 696e 6720 7468 6973 204c 6963 656e aying this Licen │ │ │ │ -00046160: 7365 0a20 2020 2020 6170 706c 6965 7320 se. applies │ │ │ │ -00046170: 746f 2074 6865 2044 6f63 756d 656e 7420 to the Document │ │ │ │ -00046180: 6172 6520 7265 7072 6f64 7563 6564 2069 are reproduced i │ │ │ │ -00046190: 6e20 616c 6c20 636f 7069 6573 2c20 616e n all copies, an │ │ │ │ -000461a0: 6420 7468 6174 2079 6f75 0a20 2020 2020 d that you. │ │ │ │ -000461b0: 6164 6420 6e6f 206f 7468 6572 2063 6f6e add no other con │ │ │ │ -000461c0: 6469 7469 6f6e 7320 7768 6174 736f 6576 ditions whatsoev │ │ │ │ -000461d0: 6572 2074 6f20 7468 6f73 6520 6f66 2074 er to those of t │ │ │ │ -000461e0: 6869 7320 4c69 6365 6e73 652e 2020 596f his License. Yo │ │ │ │ -000461f0: 750a 2020 2020 206d 6179 206e 6f74 2075 u. may not u │ │ │ │ -00046200: 7365 2074 6563 686e 6963 616c 206d 6561 se technical mea │ │ │ │ -00046210: 7375 7265 7320 746f 206f 6273 7472 7563 sures to obstruc │ │ │ │ -00046220: 7420 6f72 2063 6f6e 7472 6f6c 2074 6865 t or control the │ │ │ │ -00046230: 2072 6561 6469 6e67 0a20 2020 2020 6f72 reading. or │ │ │ │ -00046240: 2066 7572 7468 6572 2063 6f70 7969 6e67 further copying │ │ │ │ -00046250: 206f 6620 7468 6520 636f 7069 6573 2079 of the copies y │ │ │ │ -00046260: 6f75 206d 616b 6520 6f72 2064 6973 7472 ou make or distr │ │ │ │ -00046270: 6962 7574 652e 2020 486f 7765 7665 722c ibute. However, │ │ │ │ -00046280: 0a20 2020 2020 796f 7520 6d61 7920 6163 . you may ac │ │ │ │ -00046290: 6365 7074 2063 6f6d 7065 6e73 6174 696f cept compensatio │ │ │ │ -000462a0: 6e20 696e 2065 7863 6861 6e67 6520 666f n in exchange fo │ │ │ │ -000462b0: 7220 636f 7069 6573 2e20 2049 6620 796f r copies. If yo │ │ │ │ -000462c0: 750a 2020 2020 2064 6973 7472 6962 7574 u. distribut │ │ │ │ -000462d0: 6520 6120 6c61 7267 6520 656e 6f75 6768 e a large enough │ │ │ │ -000462e0: 206e 756d 6265 7220 6f66 2063 6f70 6965 number of copie │ │ │ │ -000462f0: 7320 796f 7520 6d75 7374 2061 6c73 6f20 s you must also │ │ │ │ -00046300: 666f 6c6c 6f77 2074 6865 0a20 2020 2020 follow the. │ │ │ │ -00046310: 636f 6e64 6974 696f 6e73 2069 6e20 7365 conditions in se │ │ │ │ -00046320: 6374 696f 6e20 332e 0a0a 2020 2020 2059 ction 3... Y │ │ │ │ -00046330: 6f75 206d 6179 2061 6c73 6f20 6c65 6e64 ou may also lend │ │ │ │ -00046340: 2063 6f70 6965 732c 2075 6e64 6572 2074 copies, under t │ │ │ │ -00046350: 6865 2073 616d 6520 636f 6e64 6974 696f he same conditio │ │ │ │ -00046360: 6e73 2073 7461 7465 6420 6162 6f76 652c ns stated above, │ │ │ │ -00046370: 0a20 2020 2020 616e 6420 796f 7520 6d61 . and you ma │ │ │ │ -00046380: 7920 7075 626c 6963 6c79 2064 6973 706c y publicly displ │ │ │ │ -00046390: 6179 2063 6f70 6965 732e 0a0a 2020 332e ay copies... 3. │ │ │ │ -000463a0: 2043 4f50 5949 4e47 2049 4e20 5155 414e COPYING IN QUAN │ │ │ │ -000463b0: 5449 5459 0a0a 2020 2020 2049 6620 796f TITY.. If yo │ │ │ │ -000463c0: 7520 7075 626c 6973 6820 7072 696e 7465 u publish printe │ │ │ │ -000463d0: 6420 636f 7069 6573 2028 6f72 2063 6f70 d copies (or cop │ │ │ │ -000463e0: 6965 7320 696e 206d 6564 6961 2074 6861 ies in media tha │ │ │ │ -000463f0: 7420 636f 6d6d 6f6e 6c79 0a20 2020 2020 t commonly. │ │ │ │ -00046400: 6861 7665 2070 7269 6e74 6564 2063 6f76 have printed cov │ │ │ │ -00046410: 6572 7329 206f 6620 7468 6520 446f 6375 ers) of the Docu │ │ │ │ -00046420: 6d65 6e74 2c20 6e75 6d62 6572 696e 6720 ment, numbering │ │ │ │ -00046430: 6d6f 7265 2074 6861 6e20 3130 302c 2061 more than 100, a │ │ │ │ -00046440: 6e64 0a20 2020 2020 7468 6520 446f 6375 nd. the Docu │ │ │ │ -00046450: 6d65 6e74 2773 206c 6963 656e 7365 206e ment's license n │ │ │ │ -00046460: 6f74 6963 6520 7265 7175 6972 6573 2043 otice requires C │ │ │ │ -00046470: 6f76 6572 2054 6578 7473 2c20 796f 7520 over Texts, you │ │ │ │ -00046480: 6d75 7374 0a20 2020 2020 656e 636c 6f73 must. enclos │ │ │ │ -00046490: 6520 7468 6520 636f 7069 6573 2069 6e20 e the copies in │ │ │ │ -000464a0: 636f 7665 7273 2074 6861 7420 6361 7272 covers that carr │ │ │ │ -000464b0: 792c 2063 6c65 6172 6c79 2061 6e64 206c y, clearly and l │ │ │ │ -000464c0: 6567 6962 6c79 2c20 616c 6c0a 2020 2020 egibly, all. │ │ │ │ -000464d0: 2074 6865 7365 2043 6f76 6572 2054 6578 these Cover Tex │ │ │ │ -000464e0: 7473 3a20 4672 6f6e 742d 436f 7665 7220 ts: Front-Cover │ │ │ │ -000464f0: 5465 7874 7320 6f6e 2074 6865 2066 726f Texts on the fro │ │ │ │ -00046500: 6e74 2063 6f76 6572 2c20 616e 640a 2020 nt cover, and. │ │ │ │ -00046510: 2020 2042 6163 6b2d 436f 7665 7220 5465 Back-Cover Te │ │ │ │ -00046520: 7874 7320 6f6e 2074 6865 2062 6163 6b20 xts on the back │ │ │ │ -00046530: 636f 7665 722e 2020 426f 7468 2063 6f76 cover. Both cov │ │ │ │ -00046540: 6572 7320 6d75 7374 2061 6c73 6f20 636c ers must also cl │ │ │ │ -00046550: 6561 726c 790a 2020 2020 2061 6e64 206c early. and l │ │ │ │ -00046560: 6567 6962 6c79 2069 6465 6e74 6966 7920 egibly identify │ │ │ │ -00046570: 796f 7520 6173 2074 6865 2070 7562 6c69 you as the publi │ │ │ │ -00046580: 7368 6572 206f 6620 7468 6573 6520 636f sher of these co │ │ │ │ -00046590: 7069 6573 2e20 2054 6865 0a20 2020 2020 pies. The. │ │ │ │ -000465a0: 6672 6f6e 7420 636f 7665 7220 6d75 7374 front cover must │ │ │ │ -000465b0: 2070 7265 7365 6e74 2074 6865 2066 756c present the ful │ │ │ │ -000465c0: 6c20 7469 746c 6520 7769 7468 2061 6c6c l title with all │ │ │ │ -000465d0: 2077 6f72 6473 206f 6620 7468 6520 7469 words of the ti │ │ │ │ -000465e0: 746c 650a 2020 2020 2065 7175 616c 6c79 tle. equally │ │ │ │ -000465f0: 2070 726f 6d69 6e65 6e74 2061 6e64 2076 prominent and v │ │ │ │ -00046600: 6973 6962 6c65 2e20 2059 6f75 206d 6179 isible. You may │ │ │ │ -00046610: 2061 6464 206f 7468 6572 206d 6174 6572 add other mater │ │ │ │ -00046620: 6961 6c20 6f6e 2074 6865 0a20 2020 2020 ial on the. │ │ │ │ -00046630: 636f 7665 7273 2069 6e20 6164 6469 7469 covers in additi │ │ │ │ -00046640: 6f6e 2e20 2043 6f70 7969 6e67 2077 6974 on. Copying wit │ │ │ │ -00046650: 6820 6368 616e 6765 7320 6c69 6d69 7465 h changes limite │ │ │ │ -00046660: 6420 746f 2074 6865 2063 6f76 6572 732c d to the covers, │ │ │ │ -00046670: 2061 730a 2020 2020 206c 6f6e 6720 6173 as. long as │ │ │ │ -00046680: 2074 6865 7920 7072 6573 6572 7665 2074 they preserve t │ │ │ │ -00046690: 6865 2074 6974 6c65 206f 6620 7468 6520 he title of the │ │ │ │ -000466a0: 446f 6375 6d65 6e74 2061 6e64 2073 6174 Document and sat │ │ │ │ -000466b0: 6973 6679 2074 6865 7365 0a20 2020 2020 isfy these. │ │ │ │ -000466c0: 636f 6e64 6974 696f 6e73 2c20 6361 6e20 conditions, can │ │ │ │ -000466d0: 6265 2074 7265 6174 6564 2061 7320 7665 be treated as ve │ │ │ │ -000466e0: 7262 6174 696d 2063 6f70 7969 6e67 2069 rbatim copying i │ │ │ │ -000466f0: 6e20 6f74 6865 7220 7265 7370 6563 7473 n other respects │ │ │ │ -00046700: 2e0a 0a20 2020 2020 4966 2074 6865 2072 ... If the r │ │ │ │ -00046710: 6571 7569 7265 6420 7465 7874 7320 666f equired texts fo │ │ │ │ -00046720: 7220 6569 7468 6572 2063 6f76 6572 2061 r either cover a │ │ │ │ -00046730: 7265 2074 6f6f 2076 6f6c 756d 696e 6f75 re too voluminou │ │ │ │ -00046740: 7320 746f 2066 6974 0a20 2020 2020 6c65 s to fit. le │ │ │ │ -00046750: 6769 626c 792c 2079 6f75 2073 686f 756c gibly, you shoul │ │ │ │ -00046760: 6420 7075 7420 7468 6520 6669 7273 7420 d put the first │ │ │ │ -00046770: 6f6e 6573 206c 6973 7465 6420 2861 7320 ones listed (as │ │ │ │ -00046780: 6d61 6e79 2061 7320 6669 740a 2020 2020 many as fit. │ │ │ │ -00046790: 2072 6561 736f 6e61 626c 7929 206f 6e20 reasonably) on │ │ │ │ -000467a0: 7468 6520 6163 7475 616c 2063 6f76 6572 the actual cover │ │ │ │ -000467b0: 2c20 616e 6420 636f 6e74 696e 7565 2074 , and continue t │ │ │ │ -000467c0: 6865 2072 6573 7420 6f6e 746f 0a20 2020 he rest onto. │ │ │ │ -000467d0: 2020 6164 6a61 6365 6e74 2070 6167 6573 adjacent pages │ │ │ │ -000467e0: 2e0a 0a20 2020 2020 4966 2079 6f75 2070 ... If you p │ │ │ │ -000467f0: 7562 6c69 7368 206f 7220 6469 7374 7269 ublish or distri │ │ │ │ -00046800: 6275 7465 204f 7061 7175 6520 636f 7069 bute Opaque copi │ │ │ │ -00046810: 6573 206f 6620 7468 6520 446f 6375 6d65 es of the Docume │ │ │ │ -00046820: 6e74 0a20 2020 2020 6e75 6d62 6572 696e nt. numberin │ │ │ │ -00046830: 6720 6d6f 7265 2074 6861 6e20 3130 302c g more than 100, │ │ │ │ -00046840: 2079 6f75 206d 7573 7420 6569 7468 6572 you must either │ │ │ │ -00046850: 2069 6e63 6c75 6465 2061 206d 6163 6869 include a machi │ │ │ │ -00046860: 6e65 2d72 6561 6461 626c 650a 2020 2020 ne-readable. │ │ │ │ -00046870: 2054 7261 6e73 7061 7265 6e74 2063 6f70 Transparent cop │ │ │ │ -00046880: 7920 616c 6f6e 6720 7769 7468 2065 6163 y along with eac │ │ │ │ -00046890: 6820 4f70 6171 7565 2063 6f70 792c 206f h Opaque copy, o │ │ │ │ -000468a0: 7220 7374 6174 6520 696e 206f 7220 7769 r state in or wi │ │ │ │ -000468b0: 7468 0a20 2020 2020 6561 6368 204f 7061 th. each Opa │ │ │ │ -000468c0: 7175 6520 636f 7079 2061 2063 6f6d 7075 que copy a compu │ │ │ │ -000468d0: 7465 722d 6e65 7477 6f72 6b20 6c6f 6361 ter-network loca │ │ │ │ -000468e0: 7469 6f6e 2066 726f 6d20 7768 6963 6820 tion from which │ │ │ │ -000468f0: 7468 6520 6765 6e65 7261 6c0a 2020 2020 the general. │ │ │ │ -00046900: 206e 6574 776f 726b 2d75 7369 6e67 2070 network-using p │ │ │ │ -00046910: 7562 6c69 6320 6861 7320 6163 6365 7373 ublic has access │ │ │ │ -00046920: 2074 6f20 646f 776e 6c6f 6164 2075 7369 to download usi │ │ │ │ -00046930: 6e67 2070 7562 6c69 632d 7374 616e 6461 ng public-standa │ │ │ │ -00046940: 7264 0a20 2020 2020 6e65 7477 6f72 6b20 rd. network │ │ │ │ -00046950: 7072 6f74 6f63 6f6c 7320 6120 636f 6d70 protocols a comp │ │ │ │ -00046960: 6c65 7465 2054 7261 6e73 7061 7265 6e74 lete Transparent │ │ │ │ -00046970: 2063 6f70 7920 6f66 2074 6865 2044 6f63 copy of the Doc │ │ │ │ -00046980: 756d 656e 742c 2066 7265 650a 2020 2020 ument, free. │ │ │ │ -00046990: 206f 6620 6164 6465 6420 6d61 7465 7269 of added materi │ │ │ │ -000469a0: 616c 2e20 2049 6620 796f 7520 7573 6520 al. If you use │ │ │ │ -000469b0: 7468 6520 6c61 7474 6572 206f 7074 696f the latter optio │ │ │ │ -000469c0: 6e2c 2079 6f75 206d 7573 7420 7461 6b65 n, you must take │ │ │ │ -000469d0: 0a20 2020 2020 7265 6173 6f6e 6162 6c79 . reasonably │ │ │ │ -000469e0: 2070 7275 6465 6e74 2073 7465 7073 2c20 prudent steps, │ │ │ │ -000469f0: 7768 656e 2079 6f75 2062 6567 696e 2064 when you begin d │ │ │ │ -00046a00: 6973 7472 6962 7574 696f 6e20 6f66 204f istribution of O │ │ │ │ -00046a10: 7061 7175 650a 2020 2020 2063 6f70 6965 paque. copie │ │ │ │ -00046a20: 7320 696e 2071 7561 6e74 6974 792c 2074 s in quantity, t │ │ │ │ -00046a30: 6f20 656e 7375 7265 2074 6861 7420 7468 o ensure that th │ │ │ │ -00046a40: 6973 2054 7261 6e73 7061 7265 6e74 2063 is Transparent c │ │ │ │ -00046a50: 6f70 7920 7769 6c6c 0a20 2020 2020 7265 opy will. re │ │ │ │ -00046a60: 6d61 696e 2074 6875 7320 6163 6365 7373 main thus access │ │ │ │ -00046a70: 6962 6c65 2061 7420 7468 6520 7374 6174 ible at the stat │ │ │ │ -00046a80: 6564 206c 6f63 6174 696f 6e20 756e 7469 ed location unti │ │ │ │ -00046a90: 6c20 6174 206c 6561 7374 206f 6e65 0a20 l at least one. │ │ │ │ -00046aa0: 2020 2020 7965 6172 2061 6674 6572 2074 year after t │ │ │ │ -00046ab0: 6865 206c 6173 7420 7469 6d65 2079 6f75 he last time you │ │ │ │ -00046ac0: 2064 6973 7472 6962 7574 6520 616e 204f distribute an O │ │ │ │ -00046ad0: 7061 7175 6520 636f 7079 2028 6469 7265 paque copy (dire │ │ │ │ -00046ae0: 6374 6c79 206f 720a 2020 2020 2074 6872 ctly or. thr │ │ │ │ -00046af0: 6f75 6768 2079 6f75 7220 6167 656e 7473 ough your agents │ │ │ │ -00046b00: 206f 7220 7265 7461 696c 6572 7329 206f or retailers) o │ │ │ │ -00046b10: 6620 7468 6174 2065 6469 7469 6f6e 2074 f that edition t │ │ │ │ -00046b20: 6f20 7468 6520 7075 626c 6963 2e0a 0a20 o the public... │ │ │ │ -00046b30: 2020 2020 4974 2069 7320 7265 7175 6573 It is reques │ │ │ │ -00046b40: 7465 642c 2062 7574 206e 6f74 2072 6571 ted, but not req │ │ │ │ -00046b50: 7569 7265 642c 2074 6861 7420 796f 7520 uired, that you │ │ │ │ -00046b60: 636f 6e74 6163 7420 7468 6520 6175 7468 contact the auth │ │ │ │ -00046b70: 6f72 7320 6f66 0a20 2020 2020 7468 6520 ors of. the │ │ │ │ -00046b80: 446f 6375 6d65 6e74 2077 656c 6c20 6265 Document well be │ │ │ │ -00046b90: 666f 7265 2072 6564 6973 7472 6962 7574 fore redistribut │ │ │ │ -00046ba0: 696e 6720 616e 7920 6c61 7267 6520 6e75 ing any large nu │ │ │ │ -00046bb0: 6d62 6572 206f 6620 636f 7069 6573 2c0a mber of copies,. │ │ │ │ -00046bc0: 2020 2020 2074 6f20 6769 7665 2074 6865 to give the │ │ │ │ -00046bd0: 6d20 6120 6368 616e 6365 2074 6f20 7072 m a chance to pr │ │ │ │ -00046be0: 6f76 6964 6520 796f 7520 7769 7468 2061 ovide you with a │ │ │ │ -00046bf0: 6e20 7570 6461 7465 6420 7665 7273 696f n updated versio │ │ │ │ -00046c00: 6e20 6f66 2074 6865 0a20 2020 2020 446f n of the. Do │ │ │ │ -00046c10: 6375 6d65 6e74 2e0a 0a20 2034 2e20 4d4f cument... 4. MO │ │ │ │ -00046c20: 4449 4649 4341 5449 4f4e 530a 0a20 2020 DIFICATIONS.. │ │ │ │ -00046c30: 2020 596f 7520 6d61 7920 636f 7079 2061 You may copy a │ │ │ │ -00046c40: 6e64 2064 6973 7472 6962 7574 6520 6120 nd distribute a │ │ │ │ -00046c50: 4d6f 6469 6669 6564 2056 6572 7369 6f6e Modified Version │ │ │ │ -00046c60: 206f 6620 7468 6520 446f 6375 6d65 6e74 of the Document │ │ │ │ -00046c70: 0a20 2020 2020 756e 6465 7220 7468 6520 . under the │ │ │ │ -00046c80: 636f 6e64 6974 696f 6e73 206f 6620 7365 conditions of se │ │ │ │ -00046c90: 6374 696f 6e73 2032 2061 6e64 2033 2061 ctions 2 and 3 a │ │ │ │ -00046ca0: 626f 7665 2c20 7072 6f76 6964 6564 2074 bove, provided t │ │ │ │ -00046cb0: 6861 7420 796f 750a 2020 2020 2072 656c hat you. rel │ │ │ │ -00046cc0: 6561 7365 2074 6865 204d 6f64 6966 6965 ease the Modifie │ │ │ │ -00046cd0: 6420 5665 7273 696f 6e20 756e 6465 7220 d Version under │ │ │ │ -00046ce0: 7072 6563 6973 656c 7920 7468 6973 204c precisely this L │ │ │ │ -00046cf0: 6963 656e 7365 2c20 7769 7468 2074 6865 icense, with the │ │ │ │ -00046d00: 0a20 2020 2020 4d6f 6469 6669 6564 2056 . Modified V │ │ │ │ -00046d10: 6572 7369 6f6e 2066 696c 6c69 6e67 2074 ersion filling t │ │ │ │ -00046d20: 6865 2072 6f6c 6520 6f66 2074 6865 2044 he role of the D │ │ │ │ -00046d30: 6f63 756d 656e 742c 2074 6875 7320 6c69 ocument, thus li │ │ │ │ -00046d40: 6365 6e73 696e 670a 2020 2020 2064 6973 censing. dis │ │ │ │ -00046d50: 7472 6962 7574 696f 6e20 616e 6420 6d6f tribution and mo │ │ │ │ -00046d60: 6469 6669 6361 7469 6f6e 206f 6620 7468 dification of th │ │ │ │ -00046d70: 6520 4d6f 6469 6669 6564 2056 6572 7369 e Modified Versi │ │ │ │ -00046d80: 6f6e 2074 6f20 7768 6f65 7665 720a 2020 on to whoever. │ │ │ │ -00046d90: 2020 2070 6f73 7365 7373 6573 2061 2063 possesses a c │ │ │ │ -00046da0: 6f70 7920 6f66 2069 742e 2020 496e 2061 opy of it. In a │ │ │ │ -00046db0: 6464 6974 696f 6e2c 2079 6f75 206d 7573 ddition, you mus │ │ │ │ -00046dc0: 7420 646f 2074 6865 7365 2074 6869 6e67 t do these thing │ │ │ │ -00046dd0: 7320 696e 0a20 2020 2020 7468 6520 4d6f s in. the Mo │ │ │ │ -00046de0: 6469 6669 6564 2056 6572 7369 6f6e 3a0a dified Version:. │ │ │ │ -00046df0: 0a20 2020 2020 2020 412e 2055 7365 2069 . A. Use i │ │ │ │ -00046e00: 6e20 7468 6520 5469 746c 6520 5061 6765 n the Title Page │ │ │ │ -00046e10: 2028 616e 6420 6f6e 2074 6865 2063 6f76 (and on the cov │ │ │ │ -00046e20: 6572 732c 2069 6620 616e 7929 2061 2074 ers, if any) a t │ │ │ │ -00046e30: 6974 6c65 0a20 2020 2020 2020 2020 2064 itle. d │ │ │ │ -00046e40: 6973 7469 6e63 7420 6672 6f6d 2074 6861 istinct from tha │ │ │ │ -00046e50: 7420 6f66 2074 6865 2044 6f63 756d 656e t of the Documen │ │ │ │ -00046e60: 742c 2061 6e64 2066 726f 6d20 7468 6f73 t, and from thos │ │ │ │ -00046e70: 6520 6f66 2070 7265 7669 6f75 730a 2020 e of previous. │ │ │ │ -00046e80: 2020 2020 2020 2020 7665 7273 696f 6e73 versions │ │ │ │ -00046e90: 2028 7768 6963 6820 7368 6f75 6c64 2c20 (which should, │ │ │ │ -00046ea0: 6966 2074 6865 7265 2077 6572 6520 616e if there were an │ │ │ │ -00046eb0: 792c 2062 6520 6c69 7374 6564 2069 6e20 y, be listed in │ │ │ │ -00046ec0: 7468 650a 2020 2020 2020 2020 2020 4869 the. Hi │ │ │ │ -00046ed0: 7374 6f72 7920 7365 6374 696f 6e20 6f66 story section of │ │ │ │ -00046ee0: 2074 6865 2044 6f63 756d 656e 7429 2e20 the Document). │ │ │ │ -00046ef0: 2059 6f75 206d 6179 2075 7365 2074 6865 You may use the │ │ │ │ -00046f00: 2073 616d 6520 7469 746c 650a 2020 2020 same title. │ │ │ │ -00046f10: 2020 2020 2020 6173 2061 2070 7265 7669 as a previ │ │ │ │ -00046f20: 6f75 7320 7665 7273 696f 6e20 6966 2074 ous version if t │ │ │ │ -00046f30: 6865 206f 7269 6769 6e61 6c20 7075 626c he original publ │ │ │ │ -00046f40: 6973 6865 7220 6f66 2074 6861 740a 2020 isher of that. │ │ │ │ -00046f50: 2020 2020 2020 2020 7665 7273 696f 6e20 version │ │ │ │ -00046f60: 6769 7665 7320 7065 726d 6973 7369 6f6e gives permission │ │ │ │ -00046f70: 2e0a 0a20 2020 2020 2020 422e 204c 6973 ... B. Lis │ │ │ │ -00046f80: 7420 6f6e 2074 6865 2054 6974 6c65 2050 t on the Title P │ │ │ │ -00046f90: 6167 652c 2061 7320 6175 7468 6f72 732c age, as authors, │ │ │ │ -00046fa0: 206f 6e65 206f 7220 6d6f 7265 2070 6572 one or more per │ │ │ │ -00046fb0: 736f 6e73 206f 720a 2020 2020 2020 2020 sons or. │ │ │ │ -00046fc0: 2020 656e 7469 7469 6573 2072 6573 706f entities respo │ │ │ │ -00046fd0: 6e73 6962 6c65 2066 6f72 2061 7574 686f nsible for autho │ │ │ │ -00046fe0: 7273 6869 7020 6f66 2074 6865 206d 6f64 rship of the mod │ │ │ │ -00046ff0: 6966 6963 6174 696f 6e73 2069 6e0a 2020 ifications in. │ │ │ │ -00047000: 2020 2020 2020 2020 7468 6520 4d6f 6469 the Modi │ │ │ │ -00047010: 6669 6564 2056 6572 7369 6f6e 2c20 746f fied Version, to │ │ │ │ -00047020: 6765 7468 6572 2077 6974 6820 6174 206c gether with at l │ │ │ │ -00047030: 6561 7374 2066 6976 6520 6f66 2074 6865 east five of the │ │ │ │ -00047040: 0a20 2020 2020 2020 2020 2070 7269 6e63 . princ │ │ │ │ -00047050: 6970 616c 2061 7574 686f 7273 206f 6620 ipal authors of │ │ │ │ -00047060: 7468 6520 446f 6375 6d65 6e74 2028 616c the Document (al │ │ │ │ -00047070: 6c20 6f66 2069 7473 2070 7269 6e63 6970 l of its princip │ │ │ │ -00047080: 616c 0a20 2020 2020 2020 2020 2061 7574 al. aut │ │ │ │ -00047090: 686f 7273 2c20 6966 2069 7420 6861 7320 hors, if it has │ │ │ │ -000470a0: 6665 7765 7220 7468 616e 2066 6976 6529 fewer than five) │ │ │ │ -000470b0: 2c20 756e 6c65 7373 2074 6865 7920 7265 , unless they re │ │ │ │ -000470c0: 6c65 6173 6520 796f 750a 2020 2020 2020 lease you. │ │ │ │ -000470d0: 2020 2020 6672 6f6d 2074 6869 7320 7265 from this re │ │ │ │ -000470e0: 7175 6972 656d 656e 742e 0a0a 2020 2020 quirement... │ │ │ │ -000470f0: 2020 2043 2e20 5374 6174 6520 6f6e 2074 C. State on t │ │ │ │ -00047100: 6865 2054 6974 6c65 2070 6167 6520 7468 he Title page th │ │ │ │ -00047110: 6520 6e61 6d65 206f 6620 7468 6520 7075 e name of the pu │ │ │ │ -00047120: 626c 6973 6865 7220 6f66 2074 6865 0a20 blisher of the. │ │ │ │ -00047130: 2020 2020 2020 2020 204d 6f64 6966 6965 Modifie │ │ │ │ -00047140: 6420 5665 7273 696f 6e2c 2061 7320 7468 d Version, as th │ │ │ │ -00047150: 6520 7075 626c 6973 6865 722e 0a0a 2020 e publisher... │ │ │ │ -00047160: 2020 2020 2044 2e20 5072 6573 6572 7665 D. Preserve │ │ │ │ -00047170: 2061 6c6c 2074 6865 2063 6f70 7972 6967 all the copyrig │ │ │ │ -00047180: 6874 206e 6f74 6963 6573 206f 6620 7468 ht notices of th │ │ │ │ -00047190: 6520 446f 6375 6d65 6e74 2e0a 0a20 2020 e Document... │ │ │ │ -000471a0: 2020 2020 452e 2041 6464 2061 6e20 6170 E. Add an ap │ │ │ │ -000471b0: 7072 6f70 7269 6174 6520 636f 7079 7269 propriate copyri │ │ │ │ -000471c0: 6768 7420 6e6f 7469 6365 2066 6f72 2079 ght notice for y │ │ │ │ -000471d0: 6f75 7220 6d6f 6469 6669 6361 7469 6f6e our modification │ │ │ │ -000471e0: 730a 2020 2020 2020 2020 2020 6164 6a61 s. adja │ │ │ │ -000471f0: 6365 6e74 2074 6f20 7468 6520 6f74 6865 cent to the othe │ │ │ │ -00047200: 7220 636f 7079 7269 6768 7420 6e6f 7469 r copyright noti │ │ │ │ -00047210: 6365 732e 0a0a 2020 2020 2020 2046 2e20 ces... F. │ │ │ │ -00047220: 496e 636c 7564 652c 2069 6d6d 6564 6961 Include, immedia │ │ │ │ -00047230: 7465 6c79 2061 6674 6572 2074 6865 2063 tely after the c │ │ │ │ -00047240: 6f70 7972 6967 6874 206e 6f74 6963 6573 opyright notices │ │ │ │ -00047250: 2c20 6120 6c69 6365 6e73 650a 2020 2020 , a license. │ │ │ │ -00047260: 2020 2020 2020 6e6f 7469 6365 2067 6976 notice giv │ │ │ │ -00047270: 696e 6720 7468 6520 7075 626c 6963 2070 ing the public p │ │ │ │ -00047280: 6572 6d69 7373 696f 6e20 746f 2075 7365 ermission to use │ │ │ │ -00047290: 2074 6865 204d 6f64 6966 6965 640a 2020 the Modified. │ │ │ │ -000472a0: 2020 2020 2020 2020 5665 7273 696f 6e20 Version │ │ │ │ -000472b0: 756e 6465 7220 7468 6520 7465 726d 7320 under the terms │ │ │ │ -000472c0: 6f66 2074 6869 7320 4c69 6365 6e73 652c of this License, │ │ │ │ -000472d0: 2069 6e20 7468 6520 666f 726d 2073 686f in the form sho │ │ │ │ -000472e0: 776e 2069 6e0a 2020 2020 2020 2020 2020 wn in. │ │ │ │ -000472f0: 7468 6520 4164 6465 6e64 756d 2062 656c the Addendum bel │ │ │ │ -00047300: 6f77 2e0a 0a20 2020 2020 2020 472e 2050 ow... G. P │ │ │ │ -00047310: 7265 7365 7276 6520 696e 2074 6861 7420 reserve in that │ │ │ │ -00047320: 6c69 6365 6e73 6520 6e6f 7469 6365 2074 license notice t │ │ │ │ -00047330: 6865 2066 756c 6c20 6c69 7374 7320 6f66 he full lists of │ │ │ │ -00047340: 2049 6e76 6172 6961 6e74 0a20 2020 2020 Invariant. │ │ │ │ -00047350: 2020 2020 2053 6563 7469 6f6e 7320 616e Sections an │ │ │ │ -00047360: 6420 7265 7175 6972 6564 2043 6f76 6572 d required Cover │ │ │ │ -00047370: 2054 6578 7473 2067 6976 656e 2069 6e20 Texts given in │ │ │ │ -00047380: 7468 6520 446f 6375 6d65 6e74 2773 0a20 the Document's. │ │ │ │ -00047390: 2020 2020 2020 2020 206c 6963 656e 7365 license │ │ │ │ -000473a0: 206e 6f74 6963 652e 0a0a 2020 2020 2020 notice... │ │ │ │ -000473b0: 2048 2e20 496e 636c 7564 6520 616e 2075 H. Include an u │ │ │ │ -000473c0: 6e61 6c74 6572 6564 2063 6f70 7920 6f66 naltered copy of │ │ │ │ -000473d0: 2074 6869 7320 4c69 6365 6e73 652e 0a0a this License... │ │ │ │ -000473e0: 2020 2020 2020 2049 2e20 5072 6573 6572 I. Preser │ │ │ │ -000473f0: 7665 2074 6865 2073 6563 7469 6f6e 2045 ve the section E │ │ │ │ -00047400: 6e74 6974 6c65 6420 2248 6973 746f 7279 ntitled "History │ │ │ │ -00047410: 222c 2050 7265 7365 7276 6520 6974 7320 ", Preserve its │ │ │ │ -00047420: 5469 746c 652c 0a20 2020 2020 2020 2020 Title,. │ │ │ │ -00047430: 2061 6e64 2061 6464 2074 6f20 6974 2061 and add to it a │ │ │ │ -00047440: 6e20 6974 656d 2073 7461 7469 6e67 2061 n item stating a │ │ │ │ -00047450: 7420 6c65 6173 7420 7468 6520 7469 746c t least the titl │ │ │ │ -00047460: 652c 2079 6561 722c 206e 6577 0a20 2020 e, year, new. │ │ │ │ -00047470: 2020 2020 2020 2061 7574 686f 7273 2c20 authors, │ │ │ │ -00047480: 616e 6420 7075 626c 6973 6865 7220 6f66 and publisher of │ │ │ │ -00047490: 2074 6865 204d 6f64 6966 6965 6420 5665 the Modified Ve │ │ │ │ -000474a0: 7273 696f 6e20 6173 2067 6976 656e 206f rsion as given o │ │ │ │ -000474b0: 6e20 7468 650a 2020 2020 2020 2020 2020 n the. │ │ │ │ -000474c0: 5469 746c 6520 5061 6765 2e20 2049 6620 Title Page. If │ │ │ │ -000474d0: 7468 6572 6520 6973 206e 6f20 7365 6374 there is no sect │ │ │ │ -000474e0: 696f 6e20 456e 7469 746c 6564 2022 4869 ion Entitled "Hi │ │ │ │ -000474f0: 7374 6f72 7922 2069 6e20 7468 650a 2020 story" in the. │ │ │ │ -00047500: 2020 2020 2020 2020 446f 6375 6d65 6e74 Document │ │ │ │ -00047510: 2c20 6372 6561 7465 206f 6e65 2073 7461 , create one sta │ │ │ │ -00047520: 7469 6e67 2074 6865 2074 6974 6c65 2c20 ting the title, │ │ │ │ -00047530: 7965 6172 2c20 6175 7468 6f72 732c 2061 year, authors, a │ │ │ │ -00047540: 6e64 0a20 2020 2020 2020 2020 2070 7562 nd. pub │ │ │ │ -00047550: 6c69 7368 6572 206f 6620 7468 6520 446f lisher of the Do │ │ │ │ -00047560: 6375 6d65 6e74 2061 7320 6769 7665 6e20 cument as given │ │ │ │ -00047570: 6f6e 2069 7473 2054 6974 6c65 2050 6167 on its Title Pag │ │ │ │ -00047580: 652c 2074 6865 6e20 6164 640a 2020 2020 e, then add. │ │ │ │ -00047590: 2020 2020 2020 616e 2069 7465 6d20 6465 an item de │ │ │ │ -000475a0: 7363 7269 6269 6e67 2074 6865 204d 6f64 scribing the Mod │ │ │ │ -000475b0: 6966 6965 6420 5665 7273 696f 6e20 6173 ified Version as │ │ │ │ -000475c0: 2073 7461 7465 6420 696e 2074 6865 0a20 stated in the. │ │ │ │ -000475d0: 2020 2020 2020 2020 2070 7265 7669 6f75 previou │ │ │ │ -000475e0: 7320 7365 6e74 656e 6365 2e0a 0a20 2020 s sentence... │ │ │ │ -000475f0: 2020 2020 4a2e 2050 7265 7365 7276 6520 J. Preserve │ │ │ │ -00047600: 7468 6520 6e65 7477 6f72 6b20 6c6f 6361 the network loca │ │ │ │ -00047610: 7469 6f6e 2c20 6966 2061 6e79 2c20 6769 tion, if any, gi │ │ │ │ -00047620: 7665 6e20 696e 2074 6865 2044 6f63 756d ven in the Docum │ │ │ │ -00047630: 656e 740a 2020 2020 2020 2020 2020 666f ent. fo │ │ │ │ -00047640: 7220 7075 626c 6963 2061 6363 6573 7320 r public access │ │ │ │ -00047650: 746f 2061 2054 7261 6e73 7061 7265 6e74 to a Transparent │ │ │ │ -00047660: 2063 6f70 7920 6f66 2074 6865 2044 6f63 copy of the Doc │ │ │ │ -00047670: 756d 656e 742c 2061 6e64 0a20 2020 2020 ument, and. │ │ │ │ -00047680: 2020 2020 206c 696b 6577 6973 6520 7468 likewise th │ │ │ │ -00047690: 6520 6e65 7477 6f72 6b20 6c6f 6361 7469 e network locati │ │ │ │ -000476a0: 6f6e 7320 6769 7665 6e20 696e 2074 6865 ons given in the │ │ │ │ -000476b0: 2044 6f63 756d 656e 7420 666f 720a 2020 Document for. │ │ │ │ -000476c0: 2020 2020 2020 2020 7072 6576 696f 7573 previous │ │ │ │ -000476d0: 2076 6572 7369 6f6e 7320 6974 2077 6173 versions it was │ │ │ │ -000476e0: 2062 6173 6564 206f 6e2e 2020 5468 6573 based on. Thes │ │ │ │ -000476f0: 6520 6d61 7920 6265 2070 6c61 6365 6420 e may be placed │ │ │ │ -00047700: 696e 2074 6865 0a20 2020 2020 2020 2020 in the. │ │ │ │ -00047710: 2022 4869 7374 6f72 7922 2073 6563 7469 "History" secti │ │ │ │ -00047720: 6f6e 2e20 2059 6f75 206d 6179 206f 6d69 on. You may omi │ │ │ │ -00047730: 7420 6120 6e65 7477 6f72 6b20 6c6f 6361 t a network loca │ │ │ │ -00047740: 7469 6f6e 2066 6f72 2061 2077 6f72 6b0a tion for a work. │ │ │ │ -00047750: 2020 2020 2020 2020 2020 7468 6174 2077 that w │ │ │ │ -00047760: 6173 2070 7562 6c69 7368 6564 2061 7420 as published at │ │ │ │ -00047770: 6c65 6173 7420 666f 7572 2079 6561 7273 least four years │ │ │ │ -00047780: 2062 6566 6f72 6520 7468 6520 446f 6375 before the Docu │ │ │ │ -00047790: 6d65 6e74 0a20 2020 2020 2020 2020 2069 ment. i │ │ │ │ -000477a0: 7473 656c 662c 206f 7220 6966 2074 6865 tself, or if the │ │ │ │ -000477b0: 206f 7269 6769 6e61 6c20 7075 626c 6973 original publis │ │ │ │ -000477c0: 6865 7220 6f66 2074 6865 2076 6572 7369 her of the versi │ │ │ │ -000477d0: 6f6e 2069 7420 7265 6665 7273 0a20 2020 on it refers. │ │ │ │ -000477e0: 2020 2020 2020 2074 6f20 6769 7665 7320 to gives │ │ │ │ -000477f0: 7065 726d 6973 7369 6f6e 2e0a 0a20 2020 permission... │ │ │ │ -00047800: 2020 2020 4b2e 2046 6f72 2061 6e79 2073 K. For any s │ │ │ │ -00047810: 6563 7469 6f6e 2045 6e74 6974 6c65 6420 ection Entitled │ │ │ │ -00047820: 2241 636b 6e6f 776c 6564 6765 6d65 6e74 "Acknowledgement │ │ │ │ -00047830: 7322 206f 7220 2244 6564 6963 6174 696f s" or "Dedicatio │ │ │ │ -00047840: 6e73 222c 0a20 2020 2020 2020 2020 2050 ns",. P │ │ │ │ -00047850: 7265 7365 7276 6520 7468 6520 5469 746c reserve the Titl │ │ │ │ -00047860: 6520 6f66 2074 6865 2073 6563 7469 6f6e e of the section │ │ │ │ -00047870: 2c20 616e 6420 7072 6573 6572 7665 2069 , and preserve i │ │ │ │ -00047880: 6e20 7468 6520 7365 6374 696f 6e0a 2020 n the section. │ │ │ │ -00047890: 2020 2020 2020 2020 616c 6c20 7468 6520 all the │ │ │ │ -000478a0: 7375 6273 7461 6e63 6520 616e 6420 746f substance and to │ │ │ │ -000478b0: 6e65 206f 6620 6561 6368 206f 6620 7468 ne of each of th │ │ │ │ -000478c0: 6520 636f 6e74 7269 6275 746f 720a 2020 e contributor. │ │ │ │ -000478d0: 2020 2020 2020 2020 6163 6b6e 6f77 6c65 acknowle │ │ │ │ -000478e0: 6467 656d 656e 7473 2061 6e64 2f6f 7220 dgements and/or │ │ │ │ -000478f0: 6465 6469 6361 7469 6f6e 7320 6769 7665 dedications give │ │ │ │ -00047900: 6e20 7468 6572 6569 6e2e 0a0a 2020 2020 n therein... │ │ │ │ -00047910: 2020 204c 2e20 5072 6573 6572 7665 2061 L. Preserve a │ │ │ │ -00047920: 6c6c 2074 6865 2049 6e76 6172 6961 6e74 ll the Invariant │ │ │ │ -00047930: 2053 6563 7469 6f6e 7320 6f66 2074 6865 Sections of the │ │ │ │ -00047940: 2044 6f63 756d 656e 742c 2075 6e61 6c74 Document, unalt │ │ │ │ -00047950: 6572 6564 0a20 2020 2020 2020 2020 2069 ered. i │ │ │ │ -00047960: 6e20 7468 6569 7220 7465 7874 2061 6e64 n their text and │ │ │ │ -00047970: 2069 6e20 7468 6569 7220 7469 746c 6573 in their titles │ │ │ │ -00047980: 2e20 2053 6563 7469 6f6e 206e 756d 6265 . Section numbe │ │ │ │ -00047990: 7273 206f 7220 7468 650a 2020 2020 2020 rs or the. │ │ │ │ -000479a0: 2020 2020 6571 7569 7661 6c65 6e74 2061 equivalent a │ │ │ │ -000479b0: 7265 206e 6f74 2063 6f6e 7369 6465 7265 re not considere │ │ │ │ -000479c0: 6420 7061 7274 206f 6620 7468 6520 7365 d part of the se │ │ │ │ -000479d0: 6374 696f 6e20 7469 746c 6573 2e0a 0a20 ction titles... │ │ │ │ -000479e0: 2020 2020 2020 4d2e 2044 656c 6574 6520 M. Delete │ │ │ │ -000479f0: 616e 7920 7365 6374 696f 6e20 456e 7469 any section Enti │ │ │ │ -00047a00: 746c 6564 2022 456e 646f 7273 656d 656e tled "Endorsemen │ │ │ │ -00047a10: 7473 222e 2020 5375 6368 2061 2073 6563 ts". Such a sec │ │ │ │ -00047a20: 7469 6f6e 0a20 2020 2020 2020 2020 206d tion. m │ │ │ │ -00047a30: 6179 206e 6f74 2062 6520 696e 636c 7564 ay not be includ │ │ │ │ -00047a40: 6564 2069 6e20 7468 6520 4d6f 6469 6669 ed in the Modifi │ │ │ │ -00047a50: 6564 2056 6572 7369 6f6e 2e0a 0a20 2020 ed Version... │ │ │ │ -00047a60: 2020 2020 4e2e 2044 6f20 6e6f 7420 7265 N. Do not re │ │ │ │ -00047a70: 7469 746c 6520 616e 7920 6578 6973 7469 title any existi │ │ │ │ -00047a80: 6e67 2073 6563 7469 6f6e 2074 6f20 6265 ng section to be │ │ │ │ -00047a90: 2045 6e74 6974 6c65 640a 2020 2020 2020 Entitled. │ │ │ │ -00047aa0: 2020 2020 2245 6e64 6f72 7365 6d65 6e74 "Endorsement │ │ │ │ -00047ab0: 7322 206f 7220 746f 2063 6f6e 666c 6963 s" or to conflic │ │ │ │ -00047ac0: 7420 696e 2074 6974 6c65 2077 6974 6820 t in title with │ │ │ │ -00047ad0: 616e 7920 496e 7661 7269 616e 740a 2020 any Invariant. │ │ │ │ -00047ae0: 2020 2020 2020 2020 5365 6374 696f 6e2e Section. │ │ │ │ -00047af0: 0a0a 2020 2020 2020 204f 2e20 5072 6573 .. O. Pres │ │ │ │ -00047b00: 6572 7665 2061 6e79 2057 6172 7261 6e74 erve any Warrant │ │ │ │ -00047b10: 7920 4469 7363 6c61 696d 6572 732e 0a0a y Disclaimers... │ │ │ │ -00047b20: 2020 2020 2049 6620 7468 6520 4d6f 6469 If the Modi │ │ │ │ -00047b30: 6669 6564 2056 6572 7369 6f6e 2069 6e63 fied Version inc │ │ │ │ -00047b40: 6c75 6465 7320 6e65 7720 6672 6f6e 742d ludes new front- │ │ │ │ -00047b50: 6d61 7474 6572 2073 6563 7469 6f6e 7320 matter sections │ │ │ │ -00047b60: 6f72 0a20 2020 2020 6170 7065 6e64 6963 or. appendic │ │ │ │ -00047b70: 6573 2074 6861 7420 7175 616c 6966 7920 es that qualify │ │ │ │ -00047b80: 6173 2053 6563 6f6e 6461 7279 2053 6563 as Secondary Sec │ │ │ │ -00047b90: 7469 6f6e 7320 616e 6420 636f 6e74 6169 tions and contai │ │ │ │ -00047ba0: 6e20 6e6f 0a20 2020 2020 6d61 7465 7269 n no. materi │ │ │ │ -00047bb0: 616c 2063 6f70 6965 6420 6672 6f6d 2074 al copied from t │ │ │ │ -00047bc0: 6865 2044 6f63 756d 656e 742c 2079 6f75 he Document, you │ │ │ │ -00047bd0: 206d 6179 2061 7420 796f 7572 206f 7074 may at your opt │ │ │ │ -00047be0: 696f 6e20 6465 7369 676e 6174 650a 2020 ion designate. │ │ │ │ -00047bf0: 2020 2073 6f6d 6520 6f72 2061 6c6c 206f some or all o │ │ │ │ -00047c00: 6620 7468 6573 6520 7365 6374 696f 6e73 f these sections │ │ │ │ -00047c10: 2061 7320 696e 7661 7269 616e 742e 2020 as invariant. │ │ │ │ -00047c20: 546f 2064 6f20 7468 6973 2c20 6164 6420 To do this, add │ │ │ │ -00047c30: 7468 6569 720a 2020 2020 2074 6974 6c65 their. title │ │ │ │ -00047c40: 7320 746f 2074 6865 206c 6973 7420 6f66 s to the list of │ │ │ │ -00047c50: 2049 6e76 6172 6961 6e74 2053 6563 7469 Invariant Secti │ │ │ │ -00047c60: 6f6e 7320 696e 2074 6865 204d 6f64 6966 ons in the Modif │ │ │ │ -00047c70: 6965 6420 5665 7273 696f 6e27 730a 2020 ied Version's. │ │ │ │ -00047c80: 2020 206c 6963 656e 7365 206e 6f74 6963 license notic │ │ │ │ -00047c90: 652e 2020 5468 6573 6520 7469 746c 6573 e. These titles │ │ │ │ -00047ca0: 206d 7573 7420 6265 2064 6973 7469 6e63 must be distinc │ │ │ │ -00047cb0: 7420 6672 6f6d 2061 6e79 206f 7468 6572 t from any other │ │ │ │ -00047cc0: 0a20 2020 2020 7365 6374 696f 6e20 7469 . section ti │ │ │ │ -00047cd0: 746c 6573 2e0a 0a20 2020 2020 596f 7520 tles... You │ │ │ │ -00047ce0: 6d61 7920 6164 6420 6120 7365 6374 696f may add a sectio │ │ │ │ -00047cf0: 6e20 456e 7469 746c 6564 2022 456e 646f n Entitled "Endo │ │ │ │ -00047d00: 7273 656d 656e 7473 222c 2070 726f 7669 rsements", provi │ │ │ │ -00047d10: 6465 6420 6974 2063 6f6e 7461 696e 730a ded it contains. │ │ │ │ -00047d20: 2020 2020 206e 6f74 6869 6e67 2062 7574 nothing but │ │ │ │ -00047d30: 2065 6e64 6f72 7365 6d65 6e74 7320 6f66 endorsements of │ │ │ │ -00047d40: 2079 6f75 7220 4d6f 6469 6669 6564 2056 your Modified V │ │ │ │ -00047d50: 6572 7369 6f6e 2062 7920 7661 7269 6f75 ersion by variou │ │ │ │ -00047d60: 730a 2020 2020 2070 6172 7469 6573 2d2d s. parties-- │ │ │ │ -00047d70: 666f 7220 6578 616d 706c 652c 2073 7461 for example, sta │ │ │ │ -00047d80: 7465 6d65 6e74 7320 6f66 2070 6565 7220 tements of peer │ │ │ │ -00047d90: 7265 7669 6577 206f 7220 7468 6174 2074 review or that t │ │ │ │ -00047da0: 6865 2074 6578 740a 2020 2020 2068 6173 he text. has │ │ │ │ -00047db0: 2062 6565 6e20 6170 7072 6f76 6564 2062 been approved b │ │ │ │ -00047dc0: 7920 616e 206f 7267 616e 697a 6174 696f y an organizatio │ │ │ │ -00047dd0: 6e20 6173 2074 6865 2061 7574 686f 7269 n as the authori │ │ │ │ -00047de0: 7461 7469 7665 0a20 2020 2020 6465 6669 tative. defi │ │ │ │ -00047df0: 6e69 7469 6f6e 206f 6620 6120 7374 616e nition of a stan │ │ │ │ -00047e00: 6461 7264 2e0a 0a20 2020 2020 596f 7520 dard... You │ │ │ │ -00047e10: 6d61 7920 6164 6420 6120 7061 7373 6167 may add a passag │ │ │ │ -00047e20: 6520 6f66 2075 7020 746f 2066 6976 6520 e of up to five │ │ │ │ -00047e30: 776f 7264 7320 6173 2061 2046 726f 6e74 words as a Front │ │ │ │ -00047e40: 2d43 6f76 6572 2054 6578 742c 0a20 2020 -Cover Text,. │ │ │ │ -00047e50: 2020 616e 6420 6120 7061 7373 6167 6520 and a passage │ │ │ │ -00047e60: 6f66 2075 7020 746f 2032 3520 776f 7264 of up to 25 word │ │ │ │ -00047e70: 7320 6173 2061 2042 6163 6b2d 436f 7665 s as a Back-Cove │ │ │ │ -00047e80: 7220 5465 7874 2c20 746f 2074 6865 2065 r Text, to the e │ │ │ │ -00047e90: 6e64 206f 660a 2020 2020 2074 6865 206c nd of. the l │ │ │ │ -00047ea0: 6973 7420 6f66 2043 6f76 6572 2054 6578 ist of Cover Tex │ │ │ │ -00047eb0: 7473 2069 6e20 7468 6520 4d6f 6469 6669 ts in the Modifi │ │ │ │ -00047ec0: 6564 2056 6572 7369 6f6e 2e20 204f 6e6c ed Version. Onl │ │ │ │ -00047ed0: 7920 6f6e 6520 7061 7373 6167 650a 2020 y one passage. │ │ │ │ -00047ee0: 2020 206f 6620 4672 6f6e 742d 436f 7665 of Front-Cove │ │ │ │ -00047ef0: 7220 5465 7874 2061 6e64 206f 6e65 206f r Text and one o │ │ │ │ -00047f00: 6620 4261 636b 2d43 6f76 6572 2054 6578 f Back-Cover Tex │ │ │ │ -00047f10: 7420 6d61 7920 6265 2061 6464 6564 2062 t may be added b │ │ │ │ -00047f20: 7920 286f 720a 2020 2020 2074 6872 6f75 y (or. throu │ │ │ │ -00047f30: 6768 2061 7272 616e 6765 6d65 6e74 7320 gh arrangements │ │ │ │ -00047f40: 6d61 6465 2062 7929 2061 6e79 206f 6e65 made by) any one │ │ │ │ -00047f50: 2065 6e74 6974 792e 2020 4966 2074 6865 entity. If the │ │ │ │ -00047f60: 2044 6f63 756d 656e 740a 2020 2020 2061 Document. a │ │ │ │ -00047f70: 6c72 6561 6479 2069 6e63 6c75 6465 7320 lready includes │ │ │ │ -00047f80: 6120 636f 7665 7220 7465 7874 2066 6f72 a cover text for │ │ │ │ -00047f90: 2074 6865 2073 616d 6520 636f 7665 722c the same cover, │ │ │ │ -00047fa0: 2070 7265 7669 6f75 736c 7920 6164 6465 previously adde │ │ │ │ -00047fb0: 640a 2020 2020 2062 7920 796f 7520 6f72 d. by you or │ │ │ │ -00047fc0: 2062 7920 6172 7261 6e67 656d 656e 7420 by arrangement │ │ │ │ -00047fd0: 6d61 6465 2062 7920 7468 6520 7361 6d65 made by the same │ │ │ │ -00047fe0: 2065 6e74 6974 7920 796f 7520 6172 6520 entity you are │ │ │ │ -00047ff0: 6163 7469 6e67 206f 6e0a 2020 2020 2062 acting on. b │ │ │ │ -00048000: 6568 616c 6620 6f66 2c20 796f 7520 6d61 ehalf of, you ma │ │ │ │ -00048010: 7920 6e6f 7420 6164 6420 616e 6f74 6865 y not add anothe │ │ │ │ -00048020: 723b 2062 7574 2079 6f75 206d 6179 2072 r; but you may r │ │ │ │ -00048030: 6570 6c61 6365 2074 6865 206f 6c64 0a20 eplace the old. │ │ │ │ -00048040: 2020 2020 6f6e 652c 206f 6e20 6578 706c one, on expl │ │ │ │ -00048050: 6963 6974 2070 6572 6d69 7373 696f 6e20 icit permission │ │ │ │ -00048060: 6672 6f6d 2074 6865 2070 7265 7669 6f75 from the previou │ │ │ │ -00048070: 7320 7075 626c 6973 6865 7220 7468 6174 s publisher that │ │ │ │ -00048080: 2061 6464 6564 0a20 2020 2020 7468 6520 added. the │ │ │ │ -00048090: 6f6c 6420 6f6e 652e 0a0a 2020 2020 2054 old one... T │ │ │ │ -000480a0: 6865 2061 7574 686f 7228 7329 2061 6e64 he author(s) and │ │ │ │ -000480b0: 2070 7562 6c69 7368 6572 2873 2920 6f66 publisher(s) of │ │ │ │ -000480c0: 2074 6865 2044 6f63 756d 656e 7420 646f the Document do │ │ │ │ -000480d0: 206e 6f74 2062 7920 7468 6973 0a20 2020 not by this. │ │ │ │ -000480e0: 2020 4c69 6365 6e73 6520 6769 7665 2070 License give p │ │ │ │ -000480f0: 6572 6d69 7373 696f 6e20 746f 2075 7365 ermission to use │ │ │ │ -00048100: 2074 6865 6972 206e 616d 6573 2066 6f72 their names for │ │ │ │ -00048110: 2070 7562 6c69 6369 7479 2066 6f72 206f publicity for o │ │ │ │ -00048120: 7220 746f 0a20 2020 2020 6173 7365 7274 r to. assert │ │ │ │ -00048130: 206f 7220 696d 706c 7920 656e 646f 7273 or imply endors │ │ │ │ -00048140: 656d 656e 7420 6f66 2061 6e79 204d 6f64 ement of any Mod │ │ │ │ -00048150: 6966 6965 6420 5665 7273 696f 6e2e 0a0a ified Version... │ │ │ │ -00048160: 2020 352e 2043 4f4d 4249 4e49 4e47 2044 5. COMBINING D │ │ │ │ -00048170: 4f43 554d 454e 5453 0a0a 2020 2020 2059 OCUMENTS.. Y │ │ │ │ -00048180: 6f75 206d 6179 2063 6f6d 6269 6e65 2074 ou may combine t │ │ │ │ -00048190: 6865 2044 6f63 756d 656e 7420 7769 7468 he Document with │ │ │ │ -000481a0: 206f 7468 6572 2064 6f63 756d 656e 7473 other documents │ │ │ │ -000481b0: 2072 656c 6561 7365 6420 756e 6465 720a released under. │ │ │ │ -000481c0: 2020 2020 2074 6869 7320 4c69 6365 6e73 this Licens │ │ │ │ -000481d0: 652c 2075 6e64 6572 2074 6865 2074 6572 e, under the ter │ │ │ │ -000481e0: 6d73 2064 6566 696e 6564 2069 6e20 7365 ms defined in se │ │ │ │ -000481f0: 6374 696f 6e20 3420 6162 6f76 6520 666f ction 4 above fo │ │ │ │ -00048200: 720a 2020 2020 206d 6f64 6966 6965 6420 r. modified │ │ │ │ -00048210: 7665 7273 696f 6e73 2c20 7072 6f76 6964 versions, provid │ │ │ │ -00048220: 6564 2074 6861 7420 796f 7520 696e 636c ed that you incl │ │ │ │ -00048230: 7564 6520 696e 2074 6865 2063 6f6d 6269 ude in the combi │ │ │ │ -00048240: 6e61 7469 6f6e 2061 6c6c 0a20 2020 2020 nation all. │ │ │ │ -00048250: 6f66 2074 6865 2049 6e76 6172 6961 6e74 of the Invariant │ │ │ │ -00048260: 2053 6563 7469 6f6e 7320 6f66 2061 6c6c Sections of all │ │ │ │ -00048270: 206f 6620 7468 6520 6f72 6967 696e 616c of the original │ │ │ │ -00048280: 2064 6f63 756d 656e 7473 2c0a 2020 2020 documents,. │ │ │ │ -00048290: 2075 6e6d 6f64 6966 6965 642c 2061 6e64 unmodified, and │ │ │ │ -000482a0: 206c 6973 7420 7468 656d 2061 6c6c 2061 list them all a │ │ │ │ -000482b0: 7320 496e 7661 7269 616e 7420 5365 6374 s Invariant Sect │ │ │ │ -000482c0: 696f 6e73 206f 6620 796f 7572 0a20 2020 ions of your. │ │ │ │ -000482d0: 2020 636f 6d62 696e 6564 2077 6f72 6b20 combined work │ │ │ │ -000482e0: 696e 2069 7473 206c 6963 656e 7365 206e in its license n │ │ │ │ -000482f0: 6f74 6963 652c 2061 6e64 2074 6861 7420 otice, and that │ │ │ │ -00048300: 796f 7520 7072 6573 6572 7665 2061 6c6c you preserve all │ │ │ │ -00048310: 0a20 2020 2020 7468 6569 7220 5761 7272 . their Warr │ │ │ │ -00048320: 616e 7479 2044 6973 636c 6169 6d65 7273 anty Disclaimers │ │ │ │ -00048330: 2e0a 0a20 2020 2020 5468 6520 636f 6d62 ... The comb │ │ │ │ -00048340: 696e 6564 2077 6f72 6b20 6e65 6564 206f ined work need o │ │ │ │ -00048350: 6e6c 7920 636f 6e74 6169 6e20 6f6e 6520 nly contain one │ │ │ │ -00048360: 636f 7079 206f 6620 7468 6973 204c 6963 copy of this Lic │ │ │ │ -00048370: 656e 7365 2c20 616e 640a 2020 2020 206d ense, and. m │ │ │ │ -00048380: 756c 7469 706c 6520 6964 656e 7469 6361 ultiple identica │ │ │ │ -00048390: 6c20 496e 7661 7269 616e 7420 5365 6374 l Invariant Sect │ │ │ │ -000483a0: 696f 6e73 206d 6179 2062 6520 7265 706c ions may be repl │ │ │ │ -000483b0: 6163 6564 2077 6974 6820 6120 7369 6e67 aced with a sing │ │ │ │ -000483c0: 6c65 0a20 2020 2020 636f 7079 2e20 2049 le. copy. I │ │ │ │ -000483d0: 6620 7468 6572 6520 6172 6520 6d75 6c74 f there are mult │ │ │ │ -000483e0: 6970 6c65 2049 6e76 6172 6961 6e74 2053 iple Invariant S │ │ │ │ -000483f0: 6563 7469 6f6e 7320 7769 7468 2074 6865 ections with the │ │ │ │ -00048400: 2073 616d 6520 6e61 6d65 0a20 2020 2020 same name. │ │ │ │ -00048410: 6275 7420 6469 6666 6572 656e 7420 636f but different co │ │ │ │ -00048420: 6e74 656e 7473 2c20 6d61 6b65 2074 6865 ntents, make the │ │ │ │ -00048430: 2074 6974 6c65 206f 6620 6561 6368 2073 title of each s │ │ │ │ -00048440: 7563 6820 7365 6374 696f 6e20 756e 6971 uch section uniq │ │ │ │ -00048450: 7565 0a20 2020 2020 6279 2061 6464 696e ue. by addin │ │ │ │ -00048460: 6720 6174 2074 6865 2065 6e64 206f 6620 g at the end of │ │ │ │ -00048470: 6974 2c20 696e 2070 6172 656e 7468 6573 it, in parenthes │ │ │ │ -00048480: 6573 2c20 7468 6520 6e61 6d65 206f 6620 es, the name of │ │ │ │ -00048490: 7468 650a 2020 2020 206f 7269 6769 6e61 the. origina │ │ │ │ -000484a0: 6c20 6175 7468 6f72 206f 7220 7075 626c l author or publ │ │ │ │ -000484b0: 6973 6865 7220 6f66 2074 6861 7420 7365 isher of that se │ │ │ │ -000484c0: 6374 696f 6e20 6966 206b 6e6f 776e 2c20 ction if known, │ │ │ │ -000484d0: 6f72 2065 6c73 6520 610a 2020 2020 2075 or else a. u │ │ │ │ -000484e0: 6e69 7175 6520 6e75 6d62 6572 2e20 204d nique number. M │ │ │ │ -000484f0: 616b 6520 7468 6520 7361 6d65 2061 646a ake the same adj │ │ │ │ -00048500: 7573 746d 656e 7420 746f 2074 6865 2073 ustment to the s │ │ │ │ -00048510: 6563 7469 6f6e 2074 6974 6c65 7320 696e ection titles in │ │ │ │ -00048520: 0a20 2020 2020 7468 6520 6c69 7374 206f . the list o │ │ │ │ -00048530: 6620 496e 7661 7269 616e 7420 5365 6374 f Invariant Sect │ │ │ │ -00048540: 696f 6e73 2069 6e20 7468 6520 6c69 6365 ions in the lice │ │ │ │ -00048550: 6e73 6520 6e6f 7469 6365 206f 6620 7468 nse notice of th │ │ │ │ -00048560: 650a 2020 2020 2063 6f6d 6269 6e65 6420 e. combined │ │ │ │ -00048570: 776f 726b 2e0a 0a20 2020 2020 496e 2074 work... In t │ │ │ │ -00048580: 6865 2063 6f6d 6269 6e61 7469 6f6e 2c20 he combination, │ │ │ │ -00048590: 796f 7520 6d75 7374 2063 6f6d 6269 6e65 you must combine │ │ │ │ -000485a0: 2061 6e79 2073 6563 7469 6f6e 7320 456e any sections En │ │ │ │ -000485b0: 7469 746c 6564 0a20 2020 2020 2248 6973 titled. "His │ │ │ │ -000485c0: 746f 7279 2220 696e 2074 6865 2076 6172 tory" in the var │ │ │ │ -000485d0: 696f 7573 206f 7269 6769 6e61 6c20 646f ious original do │ │ │ │ -000485e0: 6375 6d65 6e74 732c 2066 6f72 6d69 6e67 cuments, forming │ │ │ │ -000485f0: 206f 6e65 2073 6563 7469 6f6e 0a20 2020 one section. │ │ │ │ -00048600: 2020 456e 7469 746c 6564 2022 4869 7374 Entitled "Hist │ │ │ │ -00048610: 6f72 7922 3b20 6c69 6b65 7769 7365 2063 ory"; likewise c │ │ │ │ -00048620: 6f6d 6269 6e65 2061 6e79 2073 6563 7469 ombine any secti │ │ │ │ -00048630: 6f6e 7320 456e 7469 746c 6564 0a20 2020 ons Entitled. │ │ │ │ -00048640: 2020 2241 636b 6e6f 776c 6564 6765 6d65 "Acknowledgeme │ │ │ │ -00048650: 6e74 7322 2c20 616e 6420 616e 7920 7365 nts", and any se │ │ │ │ -00048660: 6374 696f 6e73 2045 6e74 6974 6c65 6420 ctions Entitled │ │ │ │ -00048670: 2244 6564 6963 6174 696f 6e73 222e 2020 "Dedications". │ │ │ │ -00048680: 596f 750a 2020 2020 206d 7573 7420 6465 You. must de │ │ │ │ -00048690: 6c65 7465 2061 6c6c 2073 6563 7469 6f6e lete all section │ │ │ │ -000486a0: 7320 456e 7469 746c 6564 2022 456e 646f s Entitled "Endo │ │ │ │ -000486b0: 7273 656d 656e 7473 2e22 0a0a 2020 362e rsements.".. 6. │ │ │ │ -000486c0: 2043 4f4c 4c45 4354 494f 4e53 204f 4620 COLLECTIONS OF │ │ │ │ -000486d0: 444f 4355 4d45 4e54 530a 0a20 2020 2020 DOCUMENTS.. │ │ │ │ -000486e0: 596f 7520 6d61 7920 6d61 6b65 2061 2063 You may make a c │ │ │ │ -000486f0: 6f6c 6c65 6374 696f 6e20 636f 6e73 6973 ollection consis │ │ │ │ -00048700: 7469 6e67 206f 6620 7468 6520 446f 6375 ting of the Docu │ │ │ │ -00048710: 6d65 6e74 2061 6e64 206f 7468 6572 0a20 ment and other. │ │ │ │ -00048720: 2020 2020 646f 6375 6d65 6e74 7320 7265 documents re │ │ │ │ -00048730: 6c65 6173 6564 2075 6e64 6572 2074 6869 leased under thi │ │ │ │ -00048740: 7320 4c69 6365 6e73 652c 2061 6e64 2072 s License, and r │ │ │ │ -00048750: 6570 6c61 6365 2074 6865 2069 6e64 6976 eplace the indiv │ │ │ │ -00048760: 6964 7561 6c0a 2020 2020 2063 6f70 6965 idual. copie │ │ │ │ -00048770: 7320 6f66 2074 6869 7320 4c69 6365 6e73 s of this Licens │ │ │ │ -00048780: 6520 696e 2074 6865 2076 6172 696f 7573 e in the various │ │ │ │ -00048790: 2064 6f63 756d 656e 7473 2077 6974 6820 documents with │ │ │ │ -000487a0: 6120 7369 6e67 6c65 2063 6f70 790a 2020 a single copy. │ │ │ │ -000487b0: 2020 2074 6861 7420 6973 2069 6e63 6c75 that is inclu │ │ │ │ -000487c0: 6465 6420 696e 2074 6865 2063 6f6c 6c65 ded in the colle │ │ │ │ -000487d0: 6374 696f 6e2c 2070 726f 7669 6465 6420 ction, provided │ │ │ │ -000487e0: 7468 6174 2079 6f75 2066 6f6c 6c6f 7720 that you follow │ │ │ │ -000487f0: 7468 650a 2020 2020 2072 756c 6573 206f the. rules o │ │ │ │ -00048800: 6620 7468 6973 204c 6963 656e 7365 2066 f this License f │ │ │ │ -00048810: 6f72 2076 6572 6261 7469 6d20 636f 7079 or verbatim copy │ │ │ │ -00048820: 696e 6720 6f66 2065 6163 6820 6f66 2074 ing of each of t │ │ │ │ -00048830: 6865 2064 6f63 756d 656e 7473 0a20 2020 he documents. │ │ │ │ -00048840: 2020 696e 2061 6c6c 206f 7468 6572 2072 in all other r │ │ │ │ -00048850: 6573 7065 6374 732e 0a0a 2020 2020 2059 espects... Y │ │ │ │ -00048860: 6f75 206d 6179 2065 7874 7261 6374 2061 ou may extract a │ │ │ │ -00048870: 2073 696e 676c 6520 646f 6375 6d65 6e74 single document │ │ │ │ -00048880: 2066 726f 6d20 7375 6368 2061 2063 6f6c from such a col │ │ │ │ -00048890: 6c65 6374 696f 6e2c 2061 6e64 0a20 2020 lection, and. │ │ │ │ -000488a0: 2020 6469 7374 7269 6275 7465 2069 7420 distribute it │ │ │ │ -000488b0: 696e 6469 7669 6475 616c 6c79 2075 6e64 individually und │ │ │ │ -000488c0: 6572 2074 6869 7320 4c69 6365 6e73 652c er this License, │ │ │ │ -000488d0: 2070 726f 7669 6465 6420 796f 7520 696e provided you in │ │ │ │ -000488e0: 7365 7274 0a20 2020 2020 6120 636f 7079 sert. a copy │ │ │ │ -000488f0: 206f 6620 7468 6973 204c 6963 656e 7365 of this License │ │ │ │ -00048900: 2069 6e74 6f20 7468 6520 6578 7472 6163 into the extrac │ │ │ │ -00048910: 7465 6420 646f 6375 6d65 6e74 2c20 616e ted document, an │ │ │ │ -00048920: 6420 666f 6c6c 6f77 2074 6869 730a 2020 d follow this. │ │ │ │ -00048930: 2020 204c 6963 656e 7365 2069 6e20 616c License in al │ │ │ │ -00048940: 6c20 6f74 6865 7220 7265 7370 6563 7473 l other respects │ │ │ │ -00048950: 2072 6567 6172 6469 6e67 2076 6572 6261 regarding verba │ │ │ │ -00048960: 7469 6d20 636f 7079 696e 6720 6f66 2074 tim copying of t │ │ │ │ -00048970: 6861 740a 2020 2020 2064 6f63 756d 656e hat. documen │ │ │ │ -00048980: 742e 0a0a 2020 372e 2041 4747 5245 4741 t... 7. AGGREGA │ │ │ │ -00048990: 5449 4f4e 2057 4954 4820 494e 4445 5045 TION WITH INDEPE │ │ │ │ -000489a0: 4e44 454e 5420 574f 524b 530a 0a20 2020 NDENT WORKS.. │ │ │ │ -000489b0: 2020 4120 636f 6d70 696c 6174 696f 6e20 A compilation │ │ │ │ -000489c0: 6f66 2074 6865 2044 6f63 756d 656e 7420 of the Document │ │ │ │ -000489d0: 6f72 2069 7473 2064 6572 6976 6174 6976 or its derivativ │ │ │ │ -000489e0: 6573 2077 6974 6820 6f74 6865 720a 2020 es with other. │ │ │ │ -000489f0: 2020 2073 6570 6172 6174 6520 616e 6420 separate and │ │ │ │ -00048a00: 696e 6465 7065 6e64 656e 7420 646f 6375 independent docu │ │ │ │ -00048a10: 6d65 6e74 7320 6f72 2077 6f72 6b73 2c20 ments or works, │ │ │ │ -00048a20: 696e 206f 7220 6f6e 2061 2076 6f6c 756d in or on a volum │ │ │ │ -00048a30: 6520 6f66 2061 0a20 2020 2020 7374 6f72 e of a. stor │ │ │ │ -00048a40: 6167 6520 6f72 2064 6973 7472 6962 7574 age or distribut │ │ │ │ -00048a50: 696f 6e20 6d65 6469 756d 2c20 6973 2063 ion medium, is c │ │ │ │ -00048a60: 616c 6c65 6420 616e 2022 6167 6772 6567 alled an "aggreg │ │ │ │ -00048a70: 6174 6522 2069 6620 7468 650a 2020 2020 ate" if the. │ │ │ │ -00048a80: 2063 6f70 7972 6967 6874 2072 6573 756c copyright resul │ │ │ │ -00048a90: 7469 6e67 2066 726f 6d20 7468 6520 636f ting from the co │ │ │ │ -00048aa0: 6d70 696c 6174 696f 6e20 6973 206e 6f74 mpilation is not │ │ │ │ -00048ab0: 2075 7365 6420 746f 206c 696d 6974 2074 used to limit t │ │ │ │ -00048ac0: 6865 0a20 2020 2020 6c65 6761 6c20 7269 he. legal ri │ │ │ │ -00048ad0: 6768 7473 206f 6620 7468 6520 636f 6d70 ghts of the comp │ │ │ │ -00048ae0: 696c 6174 696f 6e27 7320 7573 6572 7320 ilation's users │ │ │ │ -00048af0: 6265 796f 6e64 2077 6861 7420 7468 6520 beyond what the │ │ │ │ -00048b00: 696e 6469 7669 6475 616c 0a20 2020 2020 individual. │ │ │ │ -00048b10: 776f 726b 7320 7065 726d 6974 2e20 2057 works permit. W │ │ │ │ -00048b20: 6865 6e20 7468 6520 446f 6375 6d65 6e74 hen the Document │ │ │ │ -00048b30: 2069 7320 696e 636c 7564 6564 2069 6e20 is included in │ │ │ │ -00048b40: 616e 2061 6767 7265 6761 7465 2c20 7468 an aggregate, th │ │ │ │ -00048b50: 6973 0a20 2020 2020 4c69 6365 6e73 6520 is. License │ │ │ │ -00048b60: 646f 6573 206e 6f74 2061 7070 6c79 2074 does not apply t │ │ │ │ -00048b70: 6f20 7468 6520 6f74 6865 7220 776f 726b o the other work │ │ │ │ -00048b80: 7320 696e 2074 6865 2061 6767 7265 6761 s in the aggrega │ │ │ │ -00048b90: 7465 2077 6869 6368 0a20 2020 2020 6172 te which. ar │ │ │ │ -00048ba0: 6520 6e6f 7420 7468 656d 7365 6c76 6573 e not themselves │ │ │ │ -00048bb0: 2064 6572 6976 6174 6976 6520 776f 726b derivative work │ │ │ │ -00048bc0: 7320 6f66 2074 6865 2044 6f63 756d 656e s of the Documen │ │ │ │ -00048bd0: 742e 0a0a 2020 2020 2049 6620 7468 6520 t... If the │ │ │ │ -00048be0: 436f 7665 7220 5465 7874 2072 6571 7569 Cover Text requi │ │ │ │ -00048bf0: 7265 6d65 6e74 206f 6620 7365 6374 696f rement of sectio │ │ │ │ -00048c00: 6e20 3320 6973 2061 7070 6c69 6361 626c n 3 is applicabl │ │ │ │ -00048c10: 6520 746f 2074 6865 7365 0a20 2020 2020 e to these. │ │ │ │ -00048c20: 636f 7069 6573 206f 6620 7468 6520 446f copies of the Do │ │ │ │ -00048c30: 6375 6d65 6e74 2c20 7468 656e 2069 6620 cument, then if │ │ │ │ -00048c40: 7468 6520 446f 6375 6d65 6e74 2069 7320 the Document is │ │ │ │ -00048c50: 6c65 7373 2074 6861 6e20 6f6e 6520 6861 less than one ha │ │ │ │ -00048c60: 6c66 0a20 2020 2020 6f66 2074 6865 2065 lf. of the e │ │ │ │ -00048c70: 6e74 6972 6520 6167 6772 6567 6174 652c ntire aggregate, │ │ │ │ -00048c80: 2074 6865 2044 6f63 756d 656e 7427 7320 the Document's │ │ │ │ -00048c90: 436f 7665 7220 5465 7874 7320 6d61 7920 Cover Texts may │ │ │ │ -00048ca0: 6265 2070 6c61 6365 640a 2020 2020 206f be placed. o │ │ │ │ -00048cb0: 6e20 636f 7665 7273 2074 6861 7420 6272 n covers that br │ │ │ │ -00048cc0: 6163 6b65 7420 7468 6520 446f 6375 6d65 acket the Docume │ │ │ │ -00048cd0: 6e74 2077 6974 6869 6e20 7468 6520 6167 nt within the ag │ │ │ │ -00048ce0: 6772 6567 6174 652c 206f 7220 7468 650a gregate, or the. │ │ │ │ -00048cf0: 2020 2020 2065 6c65 6374 726f 6e69 6320 electronic │ │ │ │ -00048d00: 6571 7569 7661 6c65 6e74 206f 6620 636f equivalent of co │ │ │ │ -00048d10: 7665 7273 2069 6620 7468 6520 446f 6375 vers if the Docu │ │ │ │ -00048d20: 6d65 6e74 2069 7320 696e 2065 6c65 6374 ment is in elect │ │ │ │ -00048d30: 726f 6e69 630a 2020 2020 2066 6f72 6d2e ronic. form. │ │ │ │ -00048d40: 2020 4f74 6865 7277 6973 6520 7468 6579 Otherwise they │ │ │ │ -00048d50: 206d 7573 7420 6170 7065 6172 206f 6e20 must appear on │ │ │ │ -00048d60: 7072 696e 7465 6420 636f 7665 7273 2074 printed covers t │ │ │ │ -00048d70: 6861 7420 6272 6163 6b65 740a 2020 2020 hat bracket. │ │ │ │ -00048d80: 2074 6865 2077 686f 6c65 2061 6767 7265 the whole aggre │ │ │ │ -00048d90: 6761 7465 2e0a 0a20 2038 2e20 5452 414e gate... 8. TRAN │ │ │ │ -00048da0: 534c 4154 494f 4e0a 0a20 2020 2020 5472 SLATION.. Tr │ │ │ │ -00048db0: 616e 736c 6174 696f 6e20 6973 2063 6f6e anslation is con │ │ │ │ -00048dc0: 7369 6465 7265 6420 6120 6b69 6e64 206f sidered a kind o │ │ │ │ -00048dd0: 6620 6d6f 6469 6669 6361 7469 6f6e 2c20 f modification, │ │ │ │ -00048de0: 736f 2079 6f75 206d 6179 0a20 2020 2020 so you may. │ │ │ │ -00048df0: 6469 7374 7269 6275 7465 2074 7261 6e73 distribute trans │ │ │ │ -00048e00: 6c61 7469 6f6e 7320 6f66 2074 6865 2044 lations of the D │ │ │ │ -00048e10: 6f63 756d 656e 7420 756e 6465 7220 7468 ocument under th │ │ │ │ -00048e20: 6520 7465 726d 7320 6f66 2073 6563 7469 e terms of secti │ │ │ │ -00048e30: 6f6e 0a20 2020 2020 342e 2020 5265 706c on. 4. Repl │ │ │ │ -00048e40: 6163 696e 6720 496e 7661 7269 616e 7420 acing Invariant │ │ │ │ -00048e50: 5365 6374 696f 6e73 2077 6974 6820 7472 Sections with tr │ │ │ │ -00048e60: 616e 736c 6174 696f 6e73 2072 6571 7569 anslations requi │ │ │ │ -00048e70: 7265 7320 7370 6563 6961 6c0a 2020 2020 res special. │ │ │ │ -00048e80: 2070 6572 6d69 7373 696f 6e20 6672 6f6d permission from │ │ │ │ -00048e90: 2074 6865 6972 2063 6f70 7972 6967 6874 their copyright │ │ │ │ -00048ea0: 2068 6f6c 6465 7273 2c20 6275 7420 796f holders, but yo │ │ │ │ -00048eb0: 7520 6d61 7920 696e 636c 7564 650a 2020 u may include. │ │ │ │ -00048ec0: 2020 2074 7261 6e73 6c61 7469 6f6e 7320 translations │ │ │ │ -00048ed0: 6f66 2073 6f6d 6520 6f72 2061 6c6c 2049 of some or all I │ │ │ │ -00048ee0: 6e76 6172 6961 6e74 2053 6563 7469 6f6e nvariant Section │ │ │ │ -00048ef0: 7320 696e 2061 6464 6974 696f 6e20 746f s in addition to │ │ │ │ -00048f00: 2074 6865 0a20 2020 2020 6f72 6967 696e the. origin │ │ │ │ -00048f10: 616c 2076 6572 7369 6f6e 7320 6f66 2074 al versions of t │ │ │ │ -00048f20: 6865 7365 2049 6e76 6172 6961 6e74 2053 hese Invariant S │ │ │ │ -00048f30: 6563 7469 6f6e 732e 2020 596f 7520 6d61 ections. You ma │ │ │ │ -00048f40: 7920 696e 636c 7564 6520 610a 2020 2020 y include a. │ │ │ │ -00048f50: 2074 7261 6e73 6c61 7469 6f6e 206f 6620 translation of │ │ │ │ -00048f60: 7468 6973 204c 6963 656e 7365 2c20 616e this License, an │ │ │ │ -00048f70: 6420 616c 6c20 7468 6520 6c69 6365 6e73 d all the licens │ │ │ │ -00048f80: 6520 6e6f 7469 6365 7320 696e 2074 6865 e notices in the │ │ │ │ -00048f90: 0a20 2020 2020 446f 6375 6d65 6e74 2c20 . Document, │ │ │ │ -00048fa0: 616e 6420 616e 7920 5761 7272 616e 7479 and any Warranty │ │ │ │ -00048fb0: 2044 6973 636c 6169 6d65 7273 2c20 7072 Disclaimers, pr │ │ │ │ -00048fc0: 6f76 6964 6564 2074 6861 7420 796f 7520 ovided that you │ │ │ │ -00048fd0: 616c 736f 0a20 2020 2020 696e 636c 7564 also. includ │ │ │ │ -00048fe0: 6520 7468 6520 6f72 6967 696e 616c 2045 e the original E │ │ │ │ -00048ff0: 6e67 6c69 7368 2076 6572 7369 6f6e 206f nglish version o │ │ │ │ -00049000: 6620 7468 6973 204c 6963 656e 7365 2061 f this License a │ │ │ │ -00049010: 6e64 2074 6865 0a20 2020 2020 6f72 6967 nd the. orig │ │ │ │ -00049020: 696e 616c 2076 6572 7369 6f6e 7320 6f66 inal versions of │ │ │ │ -00049030: 2074 686f 7365 206e 6f74 6963 6573 2061 those notices a │ │ │ │ -00049040: 6e64 2064 6973 636c 6169 6d65 7273 2e20 nd disclaimers. │ │ │ │ -00049050: 2049 6e20 6361 7365 206f 6620 610a 2020 In case of a. │ │ │ │ -00049060: 2020 2064 6973 6167 7265 656d 656e 7420 disagreement │ │ │ │ -00049070: 6265 7477 6565 6e20 7468 6520 7472 616e between the tran │ │ │ │ -00049080: 736c 6174 696f 6e20 616e 6420 7468 6520 slation and the │ │ │ │ -00049090: 6f72 6967 696e 616c 2076 6572 7369 6f6e original version │ │ │ │ -000490a0: 206f 660a 2020 2020 2074 6869 7320 4c69 of. this Li │ │ │ │ -000490b0: 6365 6e73 6520 6f72 2061 206e 6f74 6963 cense or a notic │ │ │ │ -000490c0: 6520 6f72 2064 6973 636c 6169 6d65 722c e or disclaimer, │ │ │ │ -000490d0: 2074 6865 206f 7269 6769 6e61 6c20 7665 the original ve │ │ │ │ -000490e0: 7273 696f 6e20 7769 6c6c 0a20 2020 2020 rsion will. │ │ │ │ -000490f0: 7072 6576 6169 6c2e 0a0a 2020 2020 2049 prevail... I │ │ │ │ -00049100: 6620 6120 7365 6374 696f 6e20 696e 2074 f a section in t │ │ │ │ -00049110: 6865 2044 6f63 756d 656e 7420 6973 2045 he Document is E │ │ │ │ -00049120: 6e74 6974 6c65 6420 2241 636b 6e6f 776c ntitled "Acknowl │ │ │ │ -00049130: 6564 6765 6d65 6e74 7322 2c0a 2020 2020 edgements",. │ │ │ │ -00049140: 2022 4465 6469 6361 7469 6f6e 7322 2c20 "Dedications", │ │ │ │ -00049150: 6f72 2022 4869 7374 6f72 7922 2c20 7468 or "History", th │ │ │ │ -00049160: 6520 7265 7175 6972 656d 656e 7420 2873 e requirement (s │ │ │ │ -00049170: 6563 7469 6f6e 2034 2920 746f 0a20 2020 ection 4) to. │ │ │ │ -00049180: 2020 5072 6573 6572 7665 2069 7473 2054 Preserve its T │ │ │ │ -00049190: 6974 6c65 2028 7365 6374 696f 6e20 3129 itle (section 1) │ │ │ │ -000491a0: 2077 696c 6c20 7479 7069 6361 6c6c 7920 will typically │ │ │ │ -000491b0: 7265 7175 6972 6520 6368 616e 6769 6e67 require changing │ │ │ │ -000491c0: 2074 6865 0a20 2020 2020 6163 7475 616c the. actual │ │ │ │ -000491d0: 2074 6974 6c65 2e0a 0a20 2039 2e20 5445 title... 9. TE │ │ │ │ -000491e0: 524d 494e 4154 494f 4e0a 0a20 2020 2020 RMINATION.. │ │ │ │ -000491f0: 596f 7520 6d61 7920 6e6f 7420 636f 7079 You may not copy │ │ │ │ -00049200: 2c20 6d6f 6469 6679 2c20 7375 626c 6963 , modify, sublic │ │ │ │ -00049210: 656e 7365 2c20 6f72 2064 6973 7472 6962 ense, or distrib │ │ │ │ -00049220: 7574 6520 7468 6520 446f 6375 6d65 6e74 ute the Document │ │ │ │ -00049230: 0a20 2020 2020 6578 6365 7074 2061 7320 . except as │ │ │ │ -00049240: 6578 7072 6573 736c 7920 7072 6f76 6964 expressly provid │ │ │ │ -00049250: 6564 2066 6f72 2075 6e64 6572 2074 6869 ed for under thi │ │ │ │ -00049260: 7320 4c69 6365 6e73 652e 2020 416e 7920 s License. Any │ │ │ │ -00049270: 6f74 6865 720a 2020 2020 2061 7474 656d other. attem │ │ │ │ -00049280: 7074 2074 6f20 636f 7079 2c20 6d6f 6469 pt to copy, modi │ │ │ │ -00049290: 6679 2c20 7375 626c 6963 656e 7365 206f fy, sublicense o │ │ │ │ -000492a0: 7220 6469 7374 7269 6275 7465 2074 6865 r distribute the │ │ │ │ -000492b0: 2044 6f63 756d 656e 7420 6973 0a20 2020 Document is. │ │ │ │ -000492c0: 2020 766f 6964 2c20 616e 6420 7769 6c6c void, and will │ │ │ │ -000492d0: 2061 7574 6f6d 6174 6963 616c 6c79 2074 automatically t │ │ │ │ -000492e0: 6572 6d69 6e61 7465 2079 6f75 7220 7269 erminate your ri │ │ │ │ -000492f0: 6768 7473 2075 6e64 6572 2074 6869 730a ghts under this. │ │ │ │ -00049300: 2020 2020 204c 6963 656e 7365 2e20 2048 License. H │ │ │ │ -00049310: 6f77 6576 6572 2c20 7061 7274 6965 7320 owever, parties │ │ │ │ -00049320: 7768 6f20 6861 7665 2072 6563 6569 7665 who have receive │ │ │ │ -00049330: 6420 636f 7069 6573 2c20 6f72 2072 6967 d copies, or rig │ │ │ │ -00049340: 6874 732c 0a20 2020 2020 6672 6f6d 2079 hts,. from y │ │ │ │ -00049350: 6f75 2075 6e64 6572 2074 6869 7320 4c69 ou under this Li │ │ │ │ -00049360: 6365 6e73 6520 7769 6c6c 206e 6f74 2068 cense will not h │ │ │ │ -00049370: 6176 6520 7468 6569 7220 6c69 6365 6e73 ave their licens │ │ │ │ -00049380: 6573 2074 6572 6d69 6e61 7465 640a 2020 es terminated. │ │ │ │ -00049390: 2020 2073 6f20 6c6f 6e67 2061 7320 7375 so long as su │ │ │ │ -000493a0: 6368 2070 6172 7469 6573 2072 656d 6169 ch parties remai │ │ │ │ -000493b0: 6e20 696e 2066 756c 6c20 636f 6d70 6c69 n in full compli │ │ │ │ -000493c0: 616e 6365 2e0a 0a20 2031 302e 2046 5554 ance... 10. FUT │ │ │ │ -000493d0: 5552 4520 5245 5649 5349 4f4e 5320 4f46 URE REVISIONS OF │ │ │ │ -000493e0: 2054 4849 5320 4c49 4345 4e53 450a 0a20 THIS LICENSE.. │ │ │ │ -000493f0: 2020 2020 5468 6520 4672 6565 2053 6f66 The Free Sof │ │ │ │ -00049400: 7477 6172 6520 466f 756e 6461 7469 6f6e tware Foundation │ │ │ │ -00049410: 206d 6179 2070 7562 6c69 7368 206e 6577 may publish new │ │ │ │ -00049420: 2c20 7265 7669 7365 6420 7665 7273 696f , revised versio │ │ │ │ -00049430: 6e73 206f 660a 2020 2020 2074 6865 2047 ns of. the G │ │ │ │ -00049440: 4e55 2046 7265 6520 446f 6375 6d65 6e74 NU Free Document │ │ │ │ -00049450: 6174 696f 6e20 4c69 6365 6e73 6520 6672 ation License fr │ │ │ │ -00049460: 6f6d 2074 696d 6520 746f 2074 696d 652e om time to time. │ │ │ │ -00049470: 2020 5375 6368 206e 6577 0a20 2020 2020 Such new. │ │ │ │ -00049480: 7665 7273 696f 6e73 2077 696c 6c20 6265 versions will be │ │ │ │ -00049490: 2073 696d 696c 6172 2069 6e20 7370 6972 similar in spir │ │ │ │ -000494a0: 6974 2074 6f20 7468 6520 7072 6573 656e it to the presen │ │ │ │ -000494b0: 7420 7665 7273 696f 6e2c 2062 7574 206d t version, but m │ │ │ │ -000494c0: 6179 0a20 2020 2020 6469 6666 6572 2069 ay. differ i │ │ │ │ -000494d0: 6e20 6465 7461 696c 2074 6f20 6164 6472 n detail to addr │ │ │ │ -000494e0: 6573 7320 6e65 7720 7072 6f62 6c65 6d73 ess new problems │ │ │ │ -000494f0: 206f 7220 636f 6e63 6572 6e73 2e20 2053 or concerns. S │ │ │ │ -00049500: 6565 0a20 2020 2020 3c68 7474 703a 2f2f ee. ... Ea │ │ │ │ -00049530: 6368 2076 6572 7369 6f6e 206f 6620 7468 ch version of th │ │ │ │ -00049540: 6520 4c69 6365 6e73 6520 6973 2067 6976 e License is giv │ │ │ │ -00049550: 656e 2061 2064 6973 7469 6e67 7569 7368 en a distinguish │ │ │ │ -00049560: 696e 6720 7665 7273 696f 6e0a 2020 2020 ing version. │ │ │ │ -00049570: 206e 756d 6265 722e 2020 4966 2074 6865 number. If the │ │ │ │ -00049580: 2044 6f63 756d 656e 7420 7370 6563 6966 Document specif │ │ │ │ -00049590: 6965 7320 7468 6174 2061 2070 6172 7469 ies that a parti │ │ │ │ -000495a0: 6375 6c61 7220 6e75 6d62 6572 6564 0a20 cular numbered. │ │ │ │ -000495b0: 2020 2020 7665 7273 696f 6e20 6f66 2074 version of t │ │ │ │ -000495c0: 6869 7320 4c69 6365 6e73 6520 226f 7220 his License "or │ │ │ │ -000495d0: 616e 7920 6c61 7465 7220 7665 7273 696f any later versio │ │ │ │ -000495e0: 6e22 2061 7070 6c69 6573 2074 6f20 6974 n" applies to it │ │ │ │ -000495f0: 2c20 796f 750a 2020 2020 2068 6176 6520 , you. have │ │ │ │ -00049600: 7468 6520 6f70 7469 6f6e 206f 6620 666f the option of fo │ │ │ │ -00049610: 6c6c 6f77 696e 6720 7468 6520 7465 726d llowing the term │ │ │ │ -00049620: 7320 616e 6420 636f 6e64 6974 696f 6e73 s and conditions │ │ │ │ -00049630: 2065 6974 6865 7220 6f66 0a20 2020 2020 either of. │ │ │ │ -00049640: 7468 6174 2073 7065 6369 6669 6564 2076 that specified v │ │ │ │ -00049650: 6572 7369 6f6e 206f 7220 6f66 2061 6e79 ersion or of any │ │ │ │ -00049660: 206c 6174 6572 2076 6572 7369 6f6e 2074 later version t │ │ │ │ -00049670: 6861 7420 6861 7320 6265 656e 0a20 2020 hat has been. │ │ │ │ -00049680: 2020 7075 626c 6973 6865 6420 286e 6f74 published (not │ │ │ │ -00049690: 2061 7320 6120 6472 6166 7429 2062 7920 as a draft) by │ │ │ │ -000496a0: 7468 6520 4672 6565 2053 6f66 7477 6172 the Free Softwar │ │ │ │ -000496b0: 6520 466f 756e 6461 7469 6f6e 2e20 2049 e Foundation. I │ │ │ │ -000496c0: 6620 7468 650a 2020 2020 2044 6f63 756d f the. Docum │ │ │ │ -000496d0: 656e 7420 646f 6573 206e 6f74 2073 7065 ent does not spe │ │ │ │ -000496e0: 6369 6679 2061 2076 6572 7369 6f6e 206e cify a version n │ │ │ │ -000496f0: 756d 6265 7220 6f66 2074 6869 7320 4c69 umber of this Li │ │ │ │ -00049700: 6365 6e73 652c 2079 6f75 206d 6179 0a20 cense, you may. │ │ │ │ -00049710: 2020 2020 6368 6f6f 7365 2061 6e79 2076 choose any v │ │ │ │ -00049720: 6572 7369 6f6e 2065 7665 7220 7075 626c ersion ever publ │ │ │ │ -00049730: 6973 6865 6420 286e 6f74 2061 7320 6120 ished (not as a │ │ │ │ -00049740: 6472 6166 7429 2062 7920 7468 6520 4672 draft) by the Fr │ │ │ │ -00049750: 6565 0a20 2020 2020 536f 6674 7761 7265 ee. Software │ │ │ │ -00049760: 2046 6f75 6e64 6174 696f 6e2e 0a0a 442e Foundation...D. │ │ │ │ -00049770: 312e 3120 4144 4445 4e44 554d 3a20 486f 1.1 ADDENDUM: Ho │ │ │ │ -00049780: 7720 746f 2075 7365 2074 6869 7320 4c69 w to use this Li │ │ │ │ -00049790: 6365 6e73 6520 666f 7220 796f 7572 2064 cense for your d │ │ │ │ -000497a0: 6f63 756d 656e 7473 0a2d 2d2d 2d2d 2d2d ocuments.------- │ │ │ │ +00044610: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ +00044620: 3d3d 0a0a 2020 2020 2020 2020 2020 2020 ==.. │ │ │ │ +00044630: 2020 2020 2020 2020 2020 5665 7273 696f Versio │ │ │ │ +00044640: 6e20 312e 322c 204e 6f76 656d 6265 7220 n 1.2, November │ │ │ │ +00044650: 3230 3032 0a0a 2020 2020 2043 6f70 7972 2002.. Copyr │ │ │ │ +00044660: 6967 6874 2028 4329 2032 3030 302c 3230 ight (C) 2000,20 │ │ │ │ +00044670: 3031 2c32 3030 3220 4672 6565 2053 6f66 01,2002 Free Sof │ │ │ │ +00044680: 7477 6172 6520 466f 756e 6461 7469 6f6e tware Foundation │ │ │ │ +00044690: 2c20 496e 632e 0a20 2020 2020 3531 2046 , Inc.. 51 F │ │ │ │ +000446a0: 7261 6e6b 6c69 6e20 5374 2c20 4669 6674 ranklin St, Fift │ │ │ │ +000446b0: 6820 466c 6f6f 722c 2042 6f73 746f 6e2c h Floor, Boston, │ │ │ │ +000446c0: 204d 4120 2030 3231 3130 2d31 3330 312c MA 02110-1301, │ │ │ │ +000446d0: 2055 5341 0a0a 2020 2020 2045 7665 7279 USA.. Every │ │ │ │ +000446e0: 6f6e 6520 6973 2070 6572 6d69 7474 6564 one is permitted │ │ │ │ +000446f0: 2074 6f20 636f 7079 2061 6e64 2064 6973 to copy and dis │ │ │ │ +00044700: 7472 6962 7574 6520 7665 7262 6174 696d tribute verbatim │ │ │ │ +00044710: 2063 6f70 6965 730a 2020 2020 206f 6620 copies. of │ │ │ │ +00044720: 7468 6973 206c 6963 656e 7365 2064 6f63 this license doc │ │ │ │ +00044730: 756d 656e 742c 2062 7574 2063 6861 6e67 ument, but chang │ │ │ │ +00044740: 696e 6720 6974 2069 7320 6e6f 7420 616c ing it is not al │ │ │ │ +00044750: 6c6f 7765 642e 0a0a 2020 302e 2050 5245 lowed... 0. PRE │ │ │ │ +00044760: 414d 424c 450a 0a20 2020 2020 5468 6520 AMBLE.. The │ │ │ │ +00044770: 7075 7270 6f73 6520 6f66 2074 6869 7320 purpose of this │ │ │ │ +00044780: 4c69 6365 6e73 6520 6973 2074 6f20 6d61 License is to ma │ │ │ │ +00044790: 6b65 2061 206d 616e 7561 6c2c 2074 6578 ke a manual, tex │ │ │ │ +000447a0: 7462 6f6f 6b2c 206f 7220 6f74 6865 720a tbook, or other. │ │ │ │ +000447b0: 2020 2020 2066 756e 6374 696f 6e61 6c20 functional │ │ │ │ +000447c0: 616e 6420 7573 6566 756c 2064 6f63 756d and useful docum │ │ │ │ +000447d0: 656e 7420 2266 7265 6522 2069 6e20 7468 ent "free" in th │ │ │ │ +000447e0: 6520 7365 6e73 6520 6f66 2066 7265 6564 e sense of freed │ │ │ │ +000447f0: 6f6d 3a20 746f 0a20 2020 2020 6173 7375 om: to. assu │ │ │ │ +00044800: 7265 2065 7665 7279 6f6e 6520 7468 6520 re everyone the │ │ │ │ +00044810: 6566 6665 6374 6976 6520 6672 6565 646f effective freedo │ │ │ │ +00044820: 6d20 746f 2063 6f70 7920 616e 6420 7265 m to copy and re │ │ │ │ +00044830: 6469 7374 7269 6275 7465 2069 742c 0a20 distribute it,. │ │ │ │ +00044840: 2020 2020 7769 7468 206f 7220 7769 7468 with or with │ │ │ │ +00044850: 6f75 7420 6d6f 6469 6679 696e 6720 6974 out modifying it │ │ │ │ +00044860: 2c20 6569 7468 6572 2063 6f6d 6d65 7263 , either commerc │ │ │ │ +00044870: 6961 6c6c 7920 6f72 0a20 2020 2020 6e6f ially or. no │ │ │ │ +00044880: 6e63 6f6d 6d65 7263 6961 6c6c 792e 2020 ncommercially. │ │ │ │ +00044890: 5365 636f 6e64 6172 696c 792c 2074 6869 Secondarily, thi │ │ │ │ +000448a0: 7320 4c69 6365 6e73 6520 7072 6573 6572 s License preser │ │ │ │ +000448b0: 7665 7320 666f 7220 7468 650a 2020 2020 ves for the. │ │ │ │ +000448c0: 2061 7574 686f 7220 616e 6420 7075 626c author and publ │ │ │ │ +000448d0: 6973 6865 7220 6120 7761 7920 746f 2067 isher a way to g │ │ │ │ +000448e0: 6574 2063 7265 6469 7420 666f 7220 7468 et credit for th │ │ │ │ +000448f0: 6569 7220 776f 726b 2c20 7768 696c 6520 eir work, while │ │ │ │ +00044900: 6e6f 740a 2020 2020 2062 6569 6e67 2063 not. being c │ │ │ │ +00044910: 6f6e 7369 6465 7265 6420 7265 7370 6f6e onsidered respon │ │ │ │ +00044920: 7369 626c 6520 666f 7220 6d6f 6469 6669 sible for modifi │ │ │ │ +00044930: 6361 7469 6f6e 7320 6d61 6465 2062 7920 cations made by │ │ │ │ +00044940: 6f74 6865 7273 2e0a 0a20 2020 2020 5468 others... Th │ │ │ │ +00044950: 6973 204c 6963 656e 7365 2069 7320 6120 is License is a │ │ │ │ +00044960: 6b69 6e64 206f 6620 2263 6f70 796c 6566 kind of "copylef │ │ │ │ +00044970: 7422 2c20 7768 6963 6820 6d65 616e 7320 t", which means │ │ │ │ +00044980: 7468 6174 2064 6572 6976 6174 6976 650a that derivative. │ │ │ │ +00044990: 2020 2020 2077 6f72 6b73 206f 6620 7468 works of th │ │ │ │ +000449a0: 6520 646f 6375 6d65 6e74 206d 7573 7420 e document must │ │ │ │ +000449b0: 7468 656d 7365 6c76 6573 2062 6520 6672 themselves be fr │ │ │ │ +000449c0: 6565 2069 6e20 7468 6520 7361 6d65 2073 ee in the same s │ │ │ │ +000449d0: 656e 7365 2e0a 2020 2020 2049 7420 636f ense.. It co │ │ │ │ +000449e0: 6d70 6c65 6d65 6e74 7320 7468 6520 474e mplements the GN │ │ │ │ +000449f0: 5520 4765 6e65 7261 6c20 5075 626c 6963 U General Public │ │ │ │ +00044a00: 204c 6963 656e 7365 2c20 7768 6963 6820 License, which │ │ │ │ +00044a10: 6973 2061 2063 6f70 796c 6566 740a 2020 is a copyleft. │ │ │ │ +00044a20: 2020 206c 6963 656e 7365 2064 6573 6967 license desig │ │ │ │ +00044a30: 6e65 6420 666f 7220 6672 6565 2073 6f66 ned for free sof │ │ │ │ +00044a40: 7477 6172 652e 0a0a 2020 2020 2057 6520 tware... We │ │ │ │ +00044a50: 6861 7665 2064 6573 6967 6e65 6420 7468 have designed th │ │ │ │ +00044a60: 6973 204c 6963 656e 7365 2069 6e20 6f72 is License in or │ │ │ │ +00044a70: 6465 7220 746f 2075 7365 2069 7420 666f der to use it fo │ │ │ │ +00044a80: 7220 6d61 6e75 616c 7320 666f 720a 2020 r manuals for. │ │ │ │ +00044a90: 2020 2066 7265 6520 736f 6674 7761 7265 free software │ │ │ │ +00044aa0: 2c20 6265 6361 7573 6520 6672 6565 2073 , because free s │ │ │ │ +00044ab0: 6f66 7477 6172 6520 6e65 6564 7320 6672 oftware needs fr │ │ │ │ +00044ac0: 6565 2064 6f63 756d 656e 7461 7469 6f6e ee documentation │ │ │ │ +00044ad0: 3a20 610a 2020 2020 2066 7265 6520 7072 : a. free pr │ │ │ │ +00044ae0: 6f67 7261 6d20 7368 6f75 6c64 2063 6f6d ogram should com │ │ │ │ +00044af0: 6520 7769 7468 206d 616e 7561 6c73 2070 e with manuals p │ │ │ │ +00044b00: 726f 7669 6469 6e67 2074 6865 2073 616d roviding the sam │ │ │ │ +00044b10: 6520 6672 6565 646f 6d73 0a20 2020 2020 e freedoms. │ │ │ │ +00044b20: 7468 6174 2074 6865 2073 6f66 7477 6172 that the softwar │ │ │ │ +00044b30: 6520 646f 6573 2e20 2042 7574 2074 6869 e does. But thi │ │ │ │ +00044b40: 7320 4c69 6365 6e73 6520 6973 206e 6f74 s License is not │ │ │ │ +00044b50: 206c 696d 6974 6564 2074 6f0a 2020 2020 limited to. │ │ │ │ +00044b60: 2073 6f66 7477 6172 6520 6d61 6e75 616c software manual │ │ │ │ +00044b70: 733b 2069 7420 6361 6e20 6265 2075 7365 s; it can be use │ │ │ │ +00044b80: 6420 666f 7220 616e 7920 7465 7874 7561 d for any textua │ │ │ │ +00044b90: 6c20 776f 726b 2c20 7265 6761 7264 6c65 l work, regardle │ │ │ │ +00044ba0: 7373 0a20 2020 2020 6f66 2073 7562 6a65 ss. of subje │ │ │ │ +00044bb0: 6374 206d 6174 7465 7220 6f72 2077 6865 ct matter or whe │ │ │ │ +00044bc0: 7468 6572 2069 7420 6973 2070 7562 6c69 ther it is publi │ │ │ │ +00044bd0: 7368 6564 2061 7320 6120 7072 696e 7465 shed as a printe │ │ │ │ +00044be0: 6420 626f 6f6b 2e20 2057 650a 2020 2020 d book. We. │ │ │ │ +00044bf0: 2072 6563 6f6d 6d65 6e64 2074 6869 7320 recommend this │ │ │ │ +00044c00: 4c69 6365 6e73 6520 7072 696e 6369 7061 License principa │ │ │ │ +00044c10: 6c6c 7920 666f 7220 776f 726b 7320 7768 lly for works wh │ │ │ │ +00044c20: 6f73 6520 7075 7270 6f73 6520 6973 0a20 ose purpose is. │ │ │ │ +00044c30: 2020 2020 696e 7374 7275 6374 696f 6e20 instruction │ │ │ │ +00044c40: 6f72 2072 6566 6572 656e 6365 2e0a 0a20 or reference... │ │ │ │ +00044c50: 2031 2e20 4150 504c 4943 4142 494c 4954 1. APPLICABILIT │ │ │ │ +00044c60: 5920 414e 4420 4445 4649 4e49 5449 4f4e Y AND DEFINITION │ │ │ │ +00044c70: 530a 0a20 2020 2020 5468 6973 204c 6963 S.. This Lic │ │ │ │ +00044c80: 656e 7365 2061 7070 6c69 6573 2074 6f20 ense applies to │ │ │ │ +00044c90: 616e 7920 6d61 6e75 616c 206f 7220 6f74 any manual or ot │ │ │ │ +00044ca0: 6865 7220 776f 726b 2c20 696e 2061 6e79 her work, in any │ │ │ │ +00044cb0: 206d 6564 6975 6d2c 0a20 2020 2020 7468 medium,. th │ │ │ │ +00044cc0: 6174 2063 6f6e 7461 696e 7320 6120 6e6f at contains a no │ │ │ │ +00044cd0: 7469 6365 2070 6c61 6365 6420 6279 2074 tice placed by t │ │ │ │ +00044ce0: 6865 2063 6f70 7972 6967 6874 2068 6f6c he copyright hol │ │ │ │ +00044cf0: 6465 7220 7361 7969 6e67 2069 7420 6361 der saying it ca │ │ │ │ +00044d00: 6e0a 2020 2020 2062 6520 6469 7374 7269 n. be distri │ │ │ │ +00044d10: 6275 7465 6420 756e 6465 7220 7468 6520 buted under the │ │ │ │ +00044d20: 7465 726d 7320 6f66 2074 6869 7320 4c69 terms of this Li │ │ │ │ +00044d30: 6365 6e73 652e 2020 5375 6368 2061 206e cense. Such a n │ │ │ │ +00044d40: 6f74 6963 650a 2020 2020 2067 7261 6e74 otice. grant │ │ │ │ +00044d50: 7320 6120 776f 726c 642d 7769 6465 2c20 s a world-wide, │ │ │ │ +00044d60: 726f 7961 6c74 792d 6672 6565 206c 6963 royalty-free lic │ │ │ │ +00044d70: 656e 7365 2c20 756e 6c69 6d69 7465 6420 ense, unlimited │ │ │ │ +00044d80: 696e 2064 7572 6174 696f 6e2c 0a20 2020 in duration,. │ │ │ │ +00044d90: 2020 746f 2075 7365 2074 6861 7420 776f to use that wo │ │ │ │ +00044da0: 726b 2075 6e64 6572 2074 6865 2063 6f6e rk under the con │ │ │ │ +00044db0: 6469 7469 6f6e 7320 7374 6174 6564 2068 ditions stated h │ │ │ │ +00044dc0: 6572 6569 6e2e 2020 5468 650a 2020 2020 erein. The. │ │ │ │ +00044dd0: 2022 446f 6375 6d65 6e74 222c 2062 656c "Document", bel │ │ │ │ +00044de0: 6f77 2c20 7265 6665 7273 2074 6f20 616e ow, refers to an │ │ │ │ +00044df0: 7920 7375 6368 206d 616e 7561 6c20 6f72 y such manual or │ │ │ │ +00044e00: 2077 6f72 6b2e 2020 416e 7920 6d65 6d62 work. Any memb │ │ │ │ +00044e10: 6572 0a20 2020 2020 6f66 2074 6865 2070 er. of the p │ │ │ │ +00044e20: 7562 6c69 6320 6973 2061 206c 6963 656e ublic is a licen │ │ │ │ +00044e30: 7365 652c 2061 6e64 2069 7320 6164 6472 see, and is addr │ │ │ │ +00044e40: 6573 7365 6420 6173 2022 796f 7522 2e20 essed as "you". │ │ │ │ +00044e50: 2059 6f75 2061 6363 6570 740a 2020 2020 You accept. │ │ │ │ +00044e60: 2074 6865 206c 6963 656e 7365 2069 6620 the license if │ │ │ │ +00044e70: 796f 7520 636f 7079 2c20 6d6f 6469 6679 you copy, modify │ │ │ │ +00044e80: 206f 7220 6469 7374 7269 6275 7465 2074 or distribute t │ │ │ │ +00044e90: 6865 2077 6f72 6b20 696e 2061 2077 6179 he work in a way │ │ │ │ +00044ea0: 0a20 2020 2020 7265 7175 6972 696e 6720 . requiring │ │ │ │ +00044eb0: 7065 726d 6973 7369 6f6e 2075 6e64 6572 permission under │ │ │ │ +00044ec0: 2063 6f70 7972 6967 6874 206c 6177 2e0a copyright law.. │ │ │ │ +00044ed0: 0a20 2020 2020 4120 224d 6f64 6966 6965 . A "Modifie │ │ │ │ +00044ee0: 6420 5665 7273 696f 6e22 206f 6620 7468 d Version" of th │ │ │ │ +00044ef0: 6520 446f 6375 6d65 6e74 206d 6561 6e73 e Document means │ │ │ │ +00044f00: 2061 6e79 2077 6f72 6b20 636f 6e74 6169 any work contai │ │ │ │ +00044f10: 6e69 6e67 2074 6865 0a20 2020 2020 446f ning the. Do │ │ │ │ +00044f20: 6375 6d65 6e74 206f 7220 6120 706f 7274 cument or a port │ │ │ │ +00044f30: 696f 6e20 6f66 2069 742c 2065 6974 6865 ion of it, eithe │ │ │ │ +00044f40: 7220 636f 7069 6564 2076 6572 6261 7469 r copied verbati │ │ │ │ +00044f50: 6d2c 206f 7220 7769 7468 0a20 2020 2020 m, or with. │ │ │ │ +00044f60: 6d6f 6469 6669 6361 7469 6f6e 7320 616e modifications an │ │ │ │ +00044f70: 642f 6f72 2074 7261 6e73 6c61 7465 6420 d/or translated │ │ │ │ +00044f80: 696e 746f 2061 6e6f 7468 6572 206c 616e into another lan │ │ │ │ +00044f90: 6775 6167 652e 0a0a 2020 2020 2041 2022 guage... A " │ │ │ │ +00044fa0: 5365 636f 6e64 6172 7920 5365 6374 696f Secondary Sectio │ │ │ │ +00044fb0: 6e22 2069 7320 6120 6e61 6d65 6420 6170 n" is a named ap │ │ │ │ +00044fc0: 7065 6e64 6978 206f 7220 6120 6672 6f6e pendix or a fron │ │ │ │ +00044fd0: 742d 6d61 7474 6572 2073 6563 7469 6f6e t-matter section │ │ │ │ +00044fe0: 0a20 2020 2020 6f66 2074 6865 2044 6f63 . of the Doc │ │ │ │ +00044ff0: 756d 656e 7420 7468 6174 2064 6561 6c73 ument that deals │ │ │ │ +00045000: 2065 7863 6c75 7369 7665 6c79 2077 6974 exclusively wit │ │ │ │ +00045010: 6820 7468 6520 7265 6c61 7469 6f6e 7368 h the relationsh │ │ │ │ +00045020: 6970 206f 6620 7468 650a 2020 2020 2070 ip of the. p │ │ │ │ +00045030: 7562 6c69 7368 6572 7320 6f72 2061 7574 ublishers or aut │ │ │ │ +00045040: 686f 7273 206f 6620 7468 6520 446f 6375 hors of the Docu │ │ │ │ +00045050: 6d65 6e74 2074 6f20 7468 6520 446f 6375 ment to the Docu │ │ │ │ +00045060: 6d65 6e74 2773 206f 7665 7261 6c6c 0a20 ment's overall. │ │ │ │ +00045070: 2020 2020 7375 626a 6563 7420 286f 7220 subject (or │ │ │ │ +00045080: 746f 2072 656c 6174 6564 206d 6174 7465 to related matte │ │ │ │ +00045090: 7273 2920 616e 6420 636f 6e74 6169 6e73 rs) and contains │ │ │ │ +000450a0: 206e 6f74 6869 6e67 2074 6861 7420 636f nothing that co │ │ │ │ +000450b0: 756c 640a 2020 2020 2066 616c 6c20 6469 uld. fall di │ │ │ │ +000450c0: 7265 6374 6c79 2077 6974 6869 6e20 7468 rectly within th │ │ │ │ +000450d0: 6174 206f 7665 7261 6c6c 2073 7562 6a65 at overall subje │ │ │ │ +000450e0: 6374 2e20 2028 5468 7573 2c20 6966 2074 ct. (Thus, if t │ │ │ │ +000450f0: 6865 2044 6f63 756d 656e 740a 2020 2020 he Document. │ │ │ │ +00045100: 2069 7320 696e 2070 6172 7420 6120 7465 is in part a te │ │ │ │ +00045110: 7874 626f 6f6b 206f 6620 6d61 7468 656d xtbook of mathem │ │ │ │ +00045120: 6174 6963 732c 2061 2053 6563 6f6e 6461 atics, a Seconda │ │ │ │ +00045130: 7279 2053 6563 7469 6f6e 206d 6179 206e ry Section may n │ │ │ │ +00045140: 6f74 0a20 2020 2020 6578 706c 6169 6e20 ot. explain │ │ │ │ +00045150: 616e 7920 6d61 7468 656d 6174 6963 732e any mathematics. │ │ │ │ +00045160: 2920 2054 6865 2072 656c 6174 696f 6e73 ) The relations │ │ │ │ +00045170: 6869 7020 636f 756c 6420 6265 2061 206d hip could be a m │ │ │ │ +00045180: 6174 7465 7220 6f66 0a20 2020 2020 6869 atter of. hi │ │ │ │ +00045190: 7374 6f72 6963 616c 2063 6f6e 6e65 6374 storical connect │ │ │ │ +000451a0: 696f 6e20 7769 7468 2074 6865 2073 7562 ion with the sub │ │ │ │ +000451b0: 6a65 6374 206f 7220 7769 7468 2072 656c ject or with rel │ │ │ │ +000451c0: 6174 6564 206d 6174 7465 7273 2c20 6f72 ated matters, or │ │ │ │ +000451d0: 0a20 2020 2020 6f66 206c 6567 616c 2c20 . of legal, │ │ │ │ +000451e0: 636f 6d6d 6572 6369 616c 2c20 7068 696c commercial, phil │ │ │ │ +000451f0: 6f73 6f70 6869 6361 6c2c 2065 7468 6963 osophical, ethic │ │ │ │ +00045200: 616c 206f 7220 706f 6c69 7469 6361 6c20 al or political │ │ │ │ +00045210: 706f 7369 7469 6f6e 0a20 2020 2020 7265 position. re │ │ │ │ +00045220: 6761 7264 696e 6720 7468 656d 2e0a 0a20 garding them... │ │ │ │ +00045230: 2020 2020 5468 6520 2249 6e76 6172 6961 The "Invaria │ │ │ │ +00045240: 6e74 2053 6563 7469 6f6e 7322 2061 7265 nt Sections" are │ │ │ │ +00045250: 2063 6572 7461 696e 2053 6563 6f6e 6461 certain Seconda │ │ │ │ +00045260: 7279 2053 6563 7469 6f6e 7320 7768 6f73 ry Sections whos │ │ │ │ +00045270: 650a 2020 2020 2074 6974 6c65 7320 6172 e. titles ar │ │ │ │ +00045280: 6520 6465 7369 676e 6174 6564 2c20 6173 e designated, as │ │ │ │ +00045290: 2062 6569 6e67 2074 686f 7365 206f 6620 being those of │ │ │ │ +000452a0: 496e 7661 7269 616e 7420 5365 6374 696f Invariant Sectio │ │ │ │ +000452b0: 6e73 2c20 696e 2074 6865 0a20 2020 2020 ns, in the. │ │ │ │ +000452c0: 6e6f 7469 6365 2074 6861 7420 7361 7973 notice that says │ │ │ │ +000452d0: 2074 6861 7420 7468 6520 446f 6375 6d65 that the Docume │ │ │ │ +000452e0: 6e74 2069 7320 7265 6c65 6173 6564 2075 nt is released u │ │ │ │ +000452f0: 6e64 6572 2074 6869 7320 4c69 6365 6e73 nder this Licens │ │ │ │ +00045300: 652e 0a20 2020 2020 4966 2061 2073 6563 e.. If a sec │ │ │ │ +00045310: 7469 6f6e 2064 6f65 7320 6e6f 7420 6669 tion does not fi │ │ │ │ +00045320: 7420 7468 6520 6162 6f76 6520 6465 6669 t the above defi │ │ │ │ +00045330: 6e69 7469 6f6e 206f 6620 5365 636f 6e64 nition of Second │ │ │ │ +00045340: 6172 7920 7468 656e 2069 740a 2020 2020 ary then it. │ │ │ │ +00045350: 2069 7320 6e6f 7420 616c 6c6f 7765 6420 is not allowed │ │ │ │ +00045360: 746f 2062 6520 6465 7369 676e 6174 6564 to be designated │ │ │ │ +00045370: 2061 7320 496e 7661 7269 616e 742e 2020 as Invariant. │ │ │ │ +00045380: 5468 6520 446f 6375 6d65 6e74 206d 6179 The Document may │ │ │ │ +00045390: 0a20 2020 2020 636f 6e74 6169 6e20 7a65 . contain ze │ │ │ │ +000453a0: 726f 2049 6e76 6172 6961 6e74 2053 6563 ro Invariant Sec │ │ │ │ +000453b0: 7469 6f6e 732e 2020 4966 2074 6865 2044 tions. If the D │ │ │ │ +000453c0: 6f63 756d 656e 7420 646f 6573 206e 6f74 ocument does not │ │ │ │ +000453d0: 2069 6465 6e74 6966 790a 2020 2020 2061 identify. a │ │ │ │ +000453e0: 6e79 2049 6e76 6172 6961 6e74 2053 6563 ny Invariant Sec │ │ │ │ +000453f0: 7469 6f6e 7320 7468 656e 2074 6865 7265 tions then there │ │ │ │ +00045400: 2061 7265 206e 6f6e 652e 0a0a 2020 2020 are none... │ │ │ │ +00045410: 2054 6865 2022 436f 7665 7220 5465 7874 The "Cover Text │ │ │ │ +00045420: 7322 2061 7265 2063 6572 7461 696e 2073 s" are certain s │ │ │ │ +00045430: 686f 7274 2070 6173 7361 6765 7320 6f66 hort passages of │ │ │ │ +00045440: 2074 6578 7420 7468 6174 2061 7265 0a20 text that are. │ │ │ │ +00045450: 2020 2020 6c69 7374 6564 2c20 6173 2046 listed, as F │ │ │ │ +00045460: 726f 6e74 2d43 6f76 6572 2054 6578 7473 ront-Cover Texts │ │ │ │ +00045470: 206f 7220 4261 636b 2d43 6f76 6572 2054 or Back-Cover T │ │ │ │ +00045480: 6578 7473 2c20 696e 2074 6865 206e 6f74 exts, in the not │ │ │ │ +00045490: 6963 650a 2020 2020 2074 6861 7420 7361 ice. that sa │ │ │ │ +000454a0: 7973 2074 6861 7420 7468 6520 446f 6375 ys that the Docu │ │ │ │ +000454b0: 6d65 6e74 2069 7320 7265 6c65 6173 6564 ment is released │ │ │ │ +000454c0: 2075 6e64 6572 2074 6869 7320 4c69 6365 under this Lice │ │ │ │ +000454d0: 6e73 652e 2020 410a 2020 2020 2046 726f nse. A. Fro │ │ │ │ +000454e0: 6e74 2d43 6f76 6572 2054 6578 7420 6d61 nt-Cover Text ma │ │ │ │ +000454f0: 7920 6265 2061 7420 6d6f 7374 2035 2077 y be at most 5 w │ │ │ │ +00045500: 6f72 6473 2c20 616e 6420 6120 4261 636b ords, and a Back │ │ │ │ +00045510: 2d43 6f76 6572 2054 6578 7420 6d61 790a -Cover Text may. │ │ │ │ +00045520: 2020 2020 2062 6520 6174 206d 6f73 7420 be at most │ │ │ │ +00045530: 3235 2077 6f72 6473 2e0a 0a20 2020 2020 25 words... │ │ │ │ +00045540: 4120 2254 7261 6e73 7061 7265 6e74 2220 A "Transparent" │ │ │ │ +00045550: 636f 7079 206f 6620 7468 6520 446f 6375 copy of the Docu │ │ │ │ +00045560: 6d65 6e74 206d 6561 6e73 2061 206d 6163 ment means a mac │ │ │ │ +00045570: 6869 6e65 2d72 6561 6461 626c 6520 636f hine-readable co │ │ │ │ +00045580: 7079 2c0a 2020 2020 2072 6570 7265 7365 py,. represe │ │ │ │ +00045590: 6e74 6564 2069 6e20 6120 666f 726d 6174 nted in a format │ │ │ │ +000455a0: 2077 686f 7365 2073 7065 6369 6669 6361 whose specifica │ │ │ │ +000455b0: 7469 6f6e 2069 7320 6176 6169 6c61 626c tion is availabl │ │ │ │ +000455c0: 6520 746f 2074 6865 0a20 2020 2020 6765 e to the. ge │ │ │ │ +000455d0: 6e65 7261 6c20 7075 626c 6963 2c20 7468 neral public, th │ │ │ │ +000455e0: 6174 2069 7320 7375 6974 6162 6c65 2066 at is suitable f │ │ │ │ +000455f0: 6f72 2072 6576 6973 696e 6720 7468 6520 or revising the │ │ │ │ +00045600: 646f 6375 6d65 6e74 0a20 2020 2020 7374 document. st │ │ │ │ +00045610: 7261 6967 6874 666f 7277 6172 646c 7920 raightforwardly │ │ │ │ +00045620: 7769 7468 2067 656e 6572 6963 2074 6578 with generic tex │ │ │ │ +00045630: 7420 6564 6974 6f72 7320 6f72 2028 666f t editors or (fo │ │ │ │ +00045640: 7220 696d 6167 6573 2063 6f6d 706f 7365 r images compose │ │ │ │ +00045650: 640a 2020 2020 206f 6620 7069 7865 6c73 d. of pixels │ │ │ │ +00045660: 2920 6765 6e65 7269 6320 7061 696e 7420 ) generic paint │ │ │ │ +00045670: 7072 6f67 7261 6d73 206f 7220 2866 6f72 programs or (for │ │ │ │ +00045680: 2064 7261 7769 6e67 7329 2073 6f6d 6520 drawings) some │ │ │ │ +00045690: 7769 6465 6c79 0a20 2020 2020 6176 6169 widely. avai │ │ │ │ +000456a0: 6c61 626c 6520 6472 6177 696e 6720 6564 lable drawing ed │ │ │ │ +000456b0: 6974 6f72 2c20 616e 6420 7468 6174 2069 itor, and that i │ │ │ │ +000456c0: 7320 7375 6974 6162 6c65 2066 6f72 2069 s suitable for i │ │ │ │ +000456d0: 6e70 7574 2074 6f20 7465 7874 0a20 2020 nput to text. │ │ │ │ +000456e0: 2020 666f 726d 6174 7465 7273 206f 7220 formatters or │ │ │ │ +000456f0: 666f 7220 6175 746f 6d61 7469 6320 7472 for automatic tr │ │ │ │ +00045700: 616e 736c 6174 696f 6e20 746f 2061 2076 anslation to a v │ │ │ │ +00045710: 6172 6965 7479 206f 6620 666f 726d 6174 ariety of format │ │ │ │ +00045720: 730a 2020 2020 2073 7569 7461 626c 6520 s. suitable │ │ │ │ +00045730: 666f 7220 696e 7075 7420 746f 2074 6578 for input to tex │ │ │ │ +00045740: 7420 666f 726d 6174 7465 7273 2e20 2041 t formatters. A │ │ │ │ +00045750: 2063 6f70 7920 6d61 6465 2069 6e20 616e copy made in an │ │ │ │ +00045760: 206f 7468 6572 7769 7365 0a20 2020 2020 otherwise. │ │ │ │ +00045770: 5472 616e 7370 6172 656e 7420 6669 6c65 Transparent file │ │ │ │ +00045780: 2066 6f72 6d61 7420 7768 6f73 6520 6d61 format whose ma │ │ │ │ +00045790: 726b 7570 2c20 6f72 2061 6273 656e 6365 rkup, or absence │ │ │ │ +000457a0: 206f 6620 6d61 726b 7570 2c20 6861 730a of markup, has. │ │ │ │ +000457b0: 2020 2020 2062 6565 6e20 6172 7261 6e67 been arrang │ │ │ │ +000457c0: 6564 2074 6f20 7468 7761 7274 206f 7220 ed to thwart or │ │ │ │ +000457d0: 6469 7363 6f75 7261 6765 2073 7562 7365 discourage subse │ │ │ │ +000457e0: 7175 656e 7420 6d6f 6469 6669 6361 7469 quent modificati │ │ │ │ +000457f0: 6f6e 2062 790a 2020 2020 2072 6561 6465 on by. reade │ │ │ │ +00045800: 7273 2069 7320 6e6f 7420 5472 616e 7370 rs is not Transp │ │ │ │ +00045810: 6172 656e 742e 2020 416e 2069 6d61 6765 arent. An image │ │ │ │ +00045820: 2066 6f72 6d61 7420 6973 206e 6f74 2054 format is not T │ │ │ │ +00045830: 7261 6e73 7061 7265 6e74 2069 660a 2020 ransparent if. │ │ │ │ +00045840: 2020 2075 7365 6420 666f 7220 616e 7920 used for any │ │ │ │ +00045850: 7375 6273 7461 6e74 6961 6c20 616d 6f75 substantial amou │ │ │ │ +00045860: 6e74 206f 6620 7465 7874 2e20 2041 2063 nt of text. A c │ │ │ │ +00045870: 6f70 7920 7468 6174 2069 7320 6e6f 740a opy that is not. │ │ │ │ +00045880: 2020 2020 2022 5472 616e 7370 6172 656e "Transparen │ │ │ │ +00045890: 7422 2069 7320 6361 6c6c 6564 2022 4f70 t" is called "Op │ │ │ │ +000458a0: 6171 7565 222e 0a0a 2020 2020 2045 7861 aque"... Exa │ │ │ │ +000458b0: 6d70 6c65 7320 6f66 2073 7569 7461 626c mples of suitabl │ │ │ │ +000458c0: 6520 666f 726d 6174 7320 666f 7220 5472 e formats for Tr │ │ │ │ +000458d0: 616e 7370 6172 656e 7420 636f 7069 6573 ansparent copies │ │ │ │ +000458e0: 2069 6e63 6c75 6465 2070 6c61 696e 0a20 include plain. │ │ │ │ +000458f0: 2020 2020 4153 4349 4920 7769 7468 6f75 ASCII withou │ │ │ │ +00045900: 7420 6d61 726b 7570 2c20 5465 7869 6e66 t markup, Texinf │ │ │ │ +00045910: 6f20 696e 7075 7420 666f 726d 6174 2c20 o input format, │ │ │ │ +00045920: 4c61 5465 5820 696e 7075 7420 666f 726d LaTeX input form │ │ │ │ +00045930: 6174 2c0a 2020 2020 2053 474d 4c20 6f72 at,. SGML or │ │ │ │ +00045940: 2058 4d4c 2075 7369 6e67 2061 2070 7562 XML using a pub │ │ │ │ +00045950: 6c69 636c 7920 6176 6169 6c61 626c 6520 licly available │ │ │ │ +00045960: 4454 442c 2061 6e64 2073 7461 6e64 6172 DTD, and standar │ │ │ │ +00045970: 642d 636f 6e66 6f72 6d69 6e67 0a20 2020 d-conforming. │ │ │ │ +00045980: 2020 7369 6d70 6c65 2048 544d 4c2c 2050 simple HTML, P │ │ │ │ +00045990: 6f73 7453 6372 6970 7420 6f72 2050 4446 ostScript or PDF │ │ │ │ +000459a0: 2064 6573 6967 6e65 6420 666f 7220 6875 designed for hu │ │ │ │ +000459b0: 6d61 6e20 6d6f 6469 6669 6361 7469 6f6e man modification │ │ │ │ +000459c0: 2e0a 2020 2020 2045 7861 6d70 6c65 7320 .. Examples │ │ │ │ +000459d0: 6f66 2074 7261 6e73 7061 7265 6e74 2069 of transparent i │ │ │ │ +000459e0: 6d61 6765 2066 6f72 6d61 7473 2069 6e63 mage formats inc │ │ │ │ +000459f0: 6c75 6465 2050 4e47 2c20 5843 4620 616e lude PNG, XCF an │ │ │ │ +00045a00: 6420 4a50 472e 0a20 2020 2020 4f70 6171 d JPG.. Opaq │ │ │ │ +00045a10: 7565 2066 6f72 6d61 7473 2069 6e63 6c75 ue formats inclu │ │ │ │ +00045a20: 6465 2070 726f 7072 6965 7461 7279 2066 de proprietary f │ │ │ │ +00045a30: 6f72 6d61 7473 2074 6861 7420 6361 6e20 ormats that can │ │ │ │ +00045a40: 6265 2072 6561 6420 616e 640a 2020 2020 be read and. │ │ │ │ +00045a50: 2065 6469 7465 6420 6f6e 6c79 2062 7920 edited only by │ │ │ │ +00045a60: 7072 6f70 7269 6574 6172 7920 776f 7264 proprietary word │ │ │ │ +00045a70: 2070 726f 6365 7373 6f72 732c 2053 474d processors, SGM │ │ │ │ +00045a80: 4c20 6f72 2058 4d4c 2066 6f72 2077 6869 L or XML for whi │ │ │ │ +00045a90: 6368 0a20 2020 2020 7468 6520 4454 4420 ch. the DTD │ │ │ │ +00045aa0: 616e 642f 6f72 2070 726f 6365 7373 696e and/or processin │ │ │ │ +00045ab0: 6720 746f 6f6c 7320 6172 6520 6e6f 7420 g tools are not │ │ │ │ +00045ac0: 6765 6e65 7261 6c6c 7920 6176 6169 6c61 generally availa │ │ │ │ +00045ad0: 626c 652c 2061 6e64 0a20 2020 2020 7468 ble, and. th │ │ │ │ +00045ae0: 6520 6d61 6368 696e 652d 6765 6e65 7261 e machine-genera │ │ │ │ +00045af0: 7465 6420 4854 4d4c 2c20 506f 7374 5363 ted HTML, PostSc │ │ │ │ +00045b00: 7269 7074 206f 7220 5044 4620 7072 6f64 ript or PDF prod │ │ │ │ +00045b10: 7563 6564 2062 7920 736f 6d65 2077 6f72 uced by some wor │ │ │ │ +00045b20: 640a 2020 2020 2070 726f 6365 7373 6f72 d. processor │ │ │ │ +00045b30: 7320 666f 7220 6f75 7470 7574 2070 7572 s for output pur │ │ │ │ +00045b40: 706f 7365 7320 6f6e 6c79 2e0a 0a20 2020 poses only... │ │ │ │ +00045b50: 2020 5468 6520 2254 6974 6c65 2050 6167 The "Title Pag │ │ │ │ +00045b60: 6522 206d 6561 6e73 2c20 666f 7220 6120 e" means, for a │ │ │ │ +00045b70: 7072 696e 7465 6420 626f 6f6b 2c20 7468 printed book, th │ │ │ │ +00045b80: 6520 7469 746c 6520 7061 6765 2069 7473 e title page its │ │ │ │ +00045b90: 656c 662c 0a20 2020 2020 706c 7573 2073 elf,. plus s │ │ │ │ +00045ba0: 7563 6820 666f 6c6c 6f77 696e 6720 7061 uch following pa │ │ │ │ +00045bb0: 6765 7320 6173 2061 7265 206e 6565 6465 ges as are neede │ │ │ │ +00045bc0: 6420 746f 2068 6f6c 642c 206c 6567 6962 d to hold, legib │ │ │ │ +00045bd0: 6c79 2c20 7468 650a 2020 2020 206d 6174 ly, the. mat │ │ │ │ +00045be0: 6572 6961 6c20 7468 6973 204c 6963 656e erial this Licen │ │ │ │ +00045bf0: 7365 2072 6571 7569 7265 7320 746f 2061 se requires to a │ │ │ │ +00045c00: 7070 6561 7220 696e 2074 6865 2074 6974 ppear in the tit │ │ │ │ +00045c10: 6c65 2070 6167 652e 2020 466f 720a 2020 le page. For. │ │ │ │ +00045c20: 2020 2077 6f72 6b73 2069 6e20 666f 726d works in form │ │ │ │ +00045c30: 6174 7320 7768 6963 6820 646f 206e 6f74 ats which do not │ │ │ │ +00045c40: 2068 6176 6520 616e 7920 7469 746c 6520 have any title │ │ │ │ +00045c50: 7061 6765 2061 7320 7375 6368 2c20 2254 page as such, "T │ │ │ │ +00045c60: 6974 6c65 0a20 2020 2020 5061 6765 2220 itle. Page" │ │ │ │ +00045c70: 6d65 616e 7320 7468 6520 7465 7874 206e means the text n │ │ │ │ +00045c80: 6561 7220 7468 6520 6d6f 7374 2070 726f ear the most pro │ │ │ │ +00045c90: 6d69 6e65 6e74 2061 7070 6561 7261 6e63 minent appearanc │ │ │ │ +00045ca0: 6520 6f66 2074 6865 0a20 2020 2020 776f e of the. wo │ │ │ │ +00045cb0: 726b 2773 2074 6974 6c65 2c20 7072 6563 rk's title, prec │ │ │ │ +00045cc0: 6564 696e 6720 7468 6520 6265 6769 6e6e eding the beginn │ │ │ │ +00045cd0: 696e 6720 6f66 2074 6865 2062 6f64 7920 ing of the body │ │ │ │ +00045ce0: 6f66 2074 6865 2074 6578 742e 0a0a 2020 of the text... │ │ │ │ +00045cf0: 2020 2041 2073 6563 7469 6f6e 2022 456e A section "En │ │ │ │ +00045d00: 7469 746c 6564 2058 595a 2220 6d65 616e titled XYZ" mean │ │ │ │ +00045d10: 7320 6120 6e61 6d65 6420 7375 6275 6e69 s a named subuni │ │ │ │ +00045d20: 7420 6f66 2074 6865 2044 6f63 756d 656e t of the Documen │ │ │ │ +00045d30: 740a 2020 2020 2077 686f 7365 2074 6974 t. whose tit │ │ │ │ +00045d40: 6c65 2065 6974 6865 7220 6973 2070 7265 le either is pre │ │ │ │ +00045d50: 6369 7365 6c79 2058 595a 206f 7220 636f cisely XYZ or co │ │ │ │ +00045d60: 6e74 6169 6e73 2058 595a 2069 6e20 7061 ntains XYZ in pa │ │ │ │ +00045d70: 7265 6e74 6865 7365 730a 2020 2020 2066 rentheses. f │ │ │ │ +00045d80: 6f6c 6c6f 7769 6e67 2074 6578 7420 7468 ollowing text th │ │ │ │ +00045d90: 6174 2074 7261 6e73 6c61 7465 7320 5859 at translates XY │ │ │ │ +00045da0: 5a20 696e 2061 6e6f 7468 6572 206c 616e Z in another lan │ │ │ │ +00045db0: 6775 6167 652e 2020 2848 6572 6520 5859 guage. (Here XY │ │ │ │ +00045dc0: 5a0a 2020 2020 2073 7461 6e64 7320 666f Z. stands fo │ │ │ │ +00045dd0: 7220 6120 7370 6563 6966 6963 2073 6563 r a specific sec │ │ │ │ +00045de0: 7469 6f6e 206e 616d 6520 6d65 6e74 696f tion name mentio │ │ │ │ +00045df0: 6e65 6420 6265 6c6f 772c 2073 7563 6820 ned below, such │ │ │ │ +00045e00: 6173 0a20 2020 2020 2241 636b 6e6f 776c as. "Acknowl │ │ │ │ +00045e10: 6564 6765 6d65 6e74 7322 2c20 2244 6564 edgements", "Ded │ │ │ │ +00045e20: 6963 6174 696f 6e73 222c 2022 456e 646f ications", "Endo │ │ │ │ +00045e30: 7273 656d 656e 7473 222c 206f 7220 2248 rsements", or "H │ │ │ │ +00045e40: 6973 746f 7279 222e 290a 2020 2020 2054 istory".). T │ │ │ │ +00045e50: 6f20 2250 7265 7365 7276 6520 7468 6520 o "Preserve the │ │ │ │ +00045e60: 5469 746c 6522 206f 6620 7375 6368 2061 Title" of such a │ │ │ │ +00045e70: 2073 6563 7469 6f6e 2077 6865 6e20 796f section when yo │ │ │ │ +00045e80: 7520 6d6f 6469 6679 2074 6865 0a20 2020 u modify the. │ │ │ │ +00045e90: 2020 446f 6375 6d65 6e74 206d 6561 6e73 Document means │ │ │ │ +00045ea0: 2074 6861 7420 6974 2072 656d 6169 6e73 that it remains │ │ │ │ +00045eb0: 2061 2073 6563 7469 6f6e 2022 456e 7469 a section "Enti │ │ │ │ +00045ec0: 746c 6564 2058 595a 2220 6163 636f 7264 tled XYZ" accord │ │ │ │ +00045ed0: 696e 670a 2020 2020 2074 6f20 7468 6973 ing. to this │ │ │ │ +00045ee0: 2064 6566 696e 6974 696f 6e2e 0a0a 2020 definition... │ │ │ │ +00045ef0: 2020 2054 6865 2044 6f63 756d 656e 7420 The Document │ │ │ │ +00045f00: 6d61 7920 696e 636c 7564 6520 5761 7272 may include Warr │ │ │ │ +00045f10: 616e 7479 2044 6973 636c 6169 6d65 7273 anty Disclaimers │ │ │ │ +00045f20: 206e 6578 7420 746f 2074 6865 206e 6f74 next to the not │ │ │ │ +00045f30: 6963 650a 2020 2020 2077 6869 6368 2073 ice. which s │ │ │ │ +00045f40: 7461 7465 7320 7468 6174 2074 6869 7320 tates that this │ │ │ │ +00045f50: 4c69 6365 6e73 6520 6170 706c 6965 7320 License applies │ │ │ │ +00045f60: 746f 2074 6865 2044 6f63 756d 656e 742e to the Document. │ │ │ │ +00045f70: 2020 5468 6573 650a 2020 2020 2057 6172 These. War │ │ │ │ +00045f80: 7261 6e74 7920 4469 7363 6c61 696d 6572 ranty Disclaimer │ │ │ │ +00045f90: 7320 6172 6520 636f 6e73 6964 6572 6564 s are considered │ │ │ │ +00045fa0: 2074 6f20 6265 2069 6e63 6c75 6465 6420 to be included │ │ │ │ +00045fb0: 6279 2072 6566 6572 656e 6365 2069 6e0a by reference in. │ │ │ │ +00045fc0: 2020 2020 2074 6869 7320 4c69 6365 6e73 this Licens │ │ │ │ +00045fd0: 652c 2062 7574 206f 6e6c 7920 6173 2072 e, but only as r │ │ │ │ +00045fe0: 6567 6172 6473 2064 6973 636c 6169 6d69 egards disclaimi │ │ │ │ +00045ff0: 6e67 2077 6172 7261 6e74 6965 733a 2061 ng warranties: a │ │ │ │ +00046000: 6e79 206f 7468 6572 0a20 2020 2020 696d ny other. im │ │ │ │ +00046010: 706c 6963 6174 696f 6e20 7468 6174 2074 plication that t │ │ │ │ +00046020: 6865 7365 2057 6172 7261 6e74 7920 4469 hese Warranty Di │ │ │ │ +00046030: 7363 6c61 696d 6572 7320 6d61 7920 6861 sclaimers may ha │ │ │ │ +00046040: 7665 2069 7320 766f 6964 2061 6e64 0a20 ve is void and. │ │ │ │ +00046050: 2020 2020 6861 7320 6e6f 2065 6666 6563 has no effec │ │ │ │ +00046060: 7420 6f6e 2074 6865 206d 6561 6e69 6e67 t on the meaning │ │ │ │ +00046070: 206f 6620 7468 6973 204c 6963 656e 7365 of this License │ │ │ │ +00046080: 2e0a 0a20 2032 2e20 5645 5242 4154 494d ... 2. VERBATIM │ │ │ │ +00046090: 2043 4f50 5949 4e47 0a0a 2020 2020 2059 COPYING.. Y │ │ │ │ +000460a0: 6f75 206d 6179 2063 6f70 7920 616e 6420 ou may copy and │ │ │ │ +000460b0: 6469 7374 7269 6275 7465 2074 6865 2044 distribute the D │ │ │ │ +000460c0: 6f63 756d 656e 7420 696e 2061 6e79 206d ocument in any m │ │ │ │ +000460d0: 6564 6975 6d2c 2065 6974 6865 720a 2020 edium, either. │ │ │ │ +000460e0: 2020 2063 6f6d 6d65 7263 6961 6c6c 7920 commercially │ │ │ │ +000460f0: 6f72 206e 6f6e 636f 6d6d 6572 6369 616c or noncommercial │ │ │ │ +00046100: 6c79 2c20 7072 6f76 6964 6564 2074 6861 ly, provided tha │ │ │ │ +00046110: 7420 7468 6973 204c 6963 656e 7365 2c20 t this License, │ │ │ │ +00046120: 7468 650a 2020 2020 2063 6f70 7972 6967 the. copyrig │ │ │ │ +00046130: 6874 206e 6f74 6963 6573 2c20 616e 6420 ht notices, and │ │ │ │ +00046140: 7468 6520 6c69 6365 6e73 6520 6e6f 7469 the license noti │ │ │ │ +00046150: 6365 2073 6179 696e 6720 7468 6973 204c ce saying this L │ │ │ │ +00046160: 6963 656e 7365 0a20 2020 2020 6170 706c icense. appl │ │ │ │ +00046170: 6965 7320 746f 2074 6865 2044 6f63 756d ies to the Docum │ │ │ │ +00046180: 656e 7420 6172 6520 7265 7072 6f64 7563 ent are reproduc │ │ │ │ +00046190: 6564 2069 6e20 616c 6c20 636f 7069 6573 ed in all copies │ │ │ │ +000461a0: 2c20 616e 6420 7468 6174 2079 6f75 0a20 , and that you. │ │ │ │ +000461b0: 2020 2020 6164 6420 6e6f 206f 7468 6572 add no other │ │ │ │ +000461c0: 2063 6f6e 6469 7469 6f6e 7320 7768 6174 conditions what │ │ │ │ +000461d0: 736f 6576 6572 2074 6f20 7468 6f73 6520 soever to those │ │ │ │ +000461e0: 6f66 2074 6869 7320 4c69 6365 6e73 652e of this License. │ │ │ │ +000461f0: 2020 596f 750a 2020 2020 206d 6179 206e You. may n │ │ │ │ +00046200: 6f74 2075 7365 2074 6563 686e 6963 616c ot use technical │ │ │ │ +00046210: 206d 6561 7375 7265 7320 746f 206f 6273 measures to obs │ │ │ │ +00046220: 7472 7563 7420 6f72 2063 6f6e 7472 6f6c truct or control │ │ │ │ +00046230: 2074 6865 2072 6561 6469 6e67 0a20 2020 the reading. │ │ │ │ +00046240: 2020 6f72 2066 7572 7468 6572 2063 6f70 or further cop │ │ │ │ +00046250: 7969 6e67 206f 6620 7468 6520 636f 7069 ying of the copi │ │ │ │ +00046260: 6573 2079 6f75 206d 616b 6520 6f72 2064 es you make or d │ │ │ │ +00046270: 6973 7472 6962 7574 652e 2020 486f 7765 istribute. Howe │ │ │ │ +00046280: 7665 722c 0a20 2020 2020 796f 7520 6d61 ver,. you ma │ │ │ │ +00046290: 7920 6163 6365 7074 2063 6f6d 7065 6e73 y accept compens │ │ │ │ +000462a0: 6174 696f 6e20 696e 2065 7863 6861 6e67 ation in exchang │ │ │ │ +000462b0: 6520 666f 7220 636f 7069 6573 2e20 2049 e for copies. I │ │ │ │ +000462c0: 6620 796f 750a 2020 2020 2064 6973 7472 f you. distr │ │ │ │ +000462d0: 6962 7574 6520 6120 6c61 7267 6520 656e ibute a large en │ │ │ │ +000462e0: 6f75 6768 206e 756d 6265 7220 6f66 2063 ough number of c │ │ │ │ +000462f0: 6f70 6965 7320 796f 7520 6d75 7374 2061 opies you must a │ │ │ │ +00046300: 6c73 6f20 666f 6c6c 6f77 2074 6865 0a20 lso follow the. │ │ │ │ +00046310: 2020 2020 636f 6e64 6974 696f 6e73 2069 conditions i │ │ │ │ +00046320: 6e20 7365 6374 696f 6e20 332e 0a0a 2020 n section 3... │ │ │ │ +00046330: 2020 2059 6f75 206d 6179 2061 6c73 6f20 You may also │ │ │ │ +00046340: 6c65 6e64 2063 6f70 6965 732c 2075 6e64 lend copies, und │ │ │ │ +00046350: 6572 2074 6865 2073 616d 6520 636f 6e64 er the same cond │ │ │ │ +00046360: 6974 696f 6e73 2073 7461 7465 6420 6162 itions stated ab │ │ │ │ +00046370: 6f76 652c 0a20 2020 2020 616e 6420 796f ove,. and yo │ │ │ │ +00046380: 7520 6d61 7920 7075 626c 6963 6c79 2064 u may publicly d │ │ │ │ +00046390: 6973 706c 6179 2063 6f70 6965 732e 0a0a isplay copies... │ │ │ │ +000463a0: 2020 332e 2043 4f50 5949 4e47 2049 4e20 3. COPYING IN │ │ │ │ +000463b0: 5155 414e 5449 5459 0a0a 2020 2020 2049 QUANTITY.. I │ │ │ │ +000463c0: 6620 796f 7520 7075 626c 6973 6820 7072 f you publish pr │ │ │ │ +000463d0: 696e 7465 6420 636f 7069 6573 2028 6f72 inted copies (or │ │ │ │ +000463e0: 2063 6f70 6965 7320 696e 206d 6564 6961 copies in media │ │ │ │ +000463f0: 2074 6861 7420 636f 6d6d 6f6e 6c79 0a20 that commonly. │ │ │ │ +00046400: 2020 2020 6861 7665 2070 7269 6e74 6564 have printed │ │ │ │ +00046410: 2063 6f76 6572 7329 206f 6620 7468 6520 covers) of the │ │ │ │ +00046420: 446f 6375 6d65 6e74 2c20 6e75 6d62 6572 Document, number │ │ │ │ +00046430: 696e 6720 6d6f 7265 2074 6861 6e20 3130 ing more than 10 │ │ │ │ +00046440: 302c 2061 6e64 0a20 2020 2020 7468 6520 0, and. the │ │ │ │ +00046450: 446f 6375 6d65 6e74 2773 206c 6963 656e Document's licen │ │ │ │ +00046460: 7365 206e 6f74 6963 6520 7265 7175 6972 se notice requir │ │ │ │ +00046470: 6573 2043 6f76 6572 2054 6578 7473 2c20 es Cover Texts, │ │ │ │ +00046480: 796f 7520 6d75 7374 0a20 2020 2020 656e you must. en │ │ │ │ +00046490: 636c 6f73 6520 7468 6520 636f 7069 6573 close the copies │ │ │ │ +000464a0: 2069 6e20 636f 7665 7273 2074 6861 7420 in covers that │ │ │ │ +000464b0: 6361 7272 792c 2063 6c65 6172 6c79 2061 carry, clearly a │ │ │ │ +000464c0: 6e64 206c 6567 6962 6c79 2c20 616c 6c0a nd legibly, all. │ │ │ │ +000464d0: 2020 2020 2074 6865 7365 2043 6f76 6572 these Cover │ │ │ │ +000464e0: 2054 6578 7473 3a20 4672 6f6e 742d 436f Texts: Front-Co │ │ │ │ +000464f0: 7665 7220 5465 7874 7320 6f6e 2074 6865 ver Texts on the │ │ │ │ +00046500: 2066 726f 6e74 2063 6f76 6572 2c20 616e front cover, an │ │ │ │ +00046510: 640a 2020 2020 2042 6163 6b2d 436f 7665 d. Back-Cove │ │ │ │ +00046520: 7220 5465 7874 7320 6f6e 2074 6865 2062 r Texts on the b │ │ │ │ +00046530: 6163 6b20 636f 7665 722e 2020 426f 7468 ack cover. Both │ │ │ │ +00046540: 2063 6f76 6572 7320 6d75 7374 2061 6c73 covers must als │ │ │ │ +00046550: 6f20 636c 6561 726c 790a 2020 2020 2061 o clearly. a │ │ │ │ +00046560: 6e64 206c 6567 6962 6c79 2069 6465 6e74 nd legibly ident │ │ │ │ +00046570: 6966 7920 796f 7520 6173 2074 6865 2070 ify you as the p │ │ │ │ +00046580: 7562 6c69 7368 6572 206f 6620 7468 6573 ublisher of thes │ │ │ │ +00046590: 6520 636f 7069 6573 2e20 2054 6865 0a20 e copies. The. │ │ │ │ +000465a0: 2020 2020 6672 6f6e 7420 636f 7665 7220 front cover │ │ │ │ +000465b0: 6d75 7374 2070 7265 7365 6e74 2074 6865 must present the │ │ │ │ +000465c0: 2066 756c 6c20 7469 746c 6520 7769 7468 full title with │ │ │ │ +000465d0: 2061 6c6c 2077 6f72 6473 206f 6620 7468 all words of th │ │ │ │ +000465e0: 6520 7469 746c 650a 2020 2020 2065 7175 e title. equ │ │ │ │ +000465f0: 616c 6c79 2070 726f 6d69 6e65 6e74 2061 ally prominent a │ │ │ │ +00046600: 6e64 2076 6973 6962 6c65 2e20 2059 6f75 nd visible. You │ │ │ │ +00046610: 206d 6179 2061 6464 206f 7468 6572 206d may add other m │ │ │ │ +00046620: 6174 6572 6961 6c20 6f6e 2074 6865 0a20 aterial on the. │ │ │ │ +00046630: 2020 2020 636f 7665 7273 2069 6e20 6164 covers in ad │ │ │ │ +00046640: 6469 7469 6f6e 2e20 2043 6f70 7969 6e67 dition. Copying │ │ │ │ +00046650: 2077 6974 6820 6368 616e 6765 7320 6c69 with changes li │ │ │ │ +00046660: 6d69 7465 6420 746f 2074 6865 2063 6f76 mited to the cov │ │ │ │ +00046670: 6572 732c 2061 730a 2020 2020 206c 6f6e ers, as. lon │ │ │ │ +00046680: 6720 6173 2074 6865 7920 7072 6573 6572 g as they preser │ │ │ │ +00046690: 7665 2074 6865 2074 6974 6c65 206f 6620 ve the title of │ │ │ │ +000466a0: 7468 6520 446f 6375 6d65 6e74 2061 6e64 the Document and │ │ │ │ +000466b0: 2073 6174 6973 6679 2074 6865 7365 0a20 satisfy these. │ │ │ │ +000466c0: 2020 2020 636f 6e64 6974 696f 6e73 2c20 conditions, │ │ │ │ +000466d0: 6361 6e20 6265 2074 7265 6174 6564 2061 can be treated a │ │ │ │ +000466e0: 7320 7665 7262 6174 696d 2063 6f70 7969 s verbatim copyi │ │ │ │ +000466f0: 6e67 2069 6e20 6f74 6865 7220 7265 7370 ng in other resp │ │ │ │ +00046700: 6563 7473 2e0a 0a20 2020 2020 4966 2074 ects... If t │ │ │ │ +00046710: 6865 2072 6571 7569 7265 6420 7465 7874 he required text │ │ │ │ +00046720: 7320 666f 7220 6569 7468 6572 2063 6f76 s for either cov │ │ │ │ +00046730: 6572 2061 7265 2074 6f6f 2076 6f6c 756d er are too volum │ │ │ │ +00046740: 696e 6f75 7320 746f 2066 6974 0a20 2020 inous to fit. │ │ │ │ +00046750: 2020 6c65 6769 626c 792c 2079 6f75 2073 legibly, you s │ │ │ │ +00046760: 686f 756c 6420 7075 7420 7468 6520 6669 hould put the fi │ │ │ │ +00046770: 7273 7420 6f6e 6573 206c 6973 7465 6420 rst ones listed │ │ │ │ +00046780: 2861 7320 6d61 6e79 2061 7320 6669 740a (as many as fit. │ │ │ │ +00046790: 2020 2020 2072 6561 736f 6e61 626c 7929 reasonably) │ │ │ │ +000467a0: 206f 6e20 7468 6520 6163 7475 616c 2063 on the actual c │ │ │ │ +000467b0: 6f76 6572 2c20 616e 6420 636f 6e74 696e over, and contin │ │ │ │ +000467c0: 7565 2074 6865 2072 6573 7420 6f6e 746f ue the rest onto │ │ │ │ +000467d0: 0a20 2020 2020 6164 6a61 6365 6e74 2070 . adjacent p │ │ │ │ +000467e0: 6167 6573 2e0a 0a20 2020 2020 4966 2079 ages... If y │ │ │ │ +000467f0: 6f75 2070 7562 6c69 7368 206f 7220 6469 ou publish or di │ │ │ │ +00046800: 7374 7269 6275 7465 204f 7061 7175 6520 stribute Opaque │ │ │ │ +00046810: 636f 7069 6573 206f 6620 7468 6520 446f copies of the Do │ │ │ │ +00046820: 6375 6d65 6e74 0a20 2020 2020 6e75 6d62 cument. numb │ │ │ │ +00046830: 6572 696e 6720 6d6f 7265 2074 6861 6e20 ering more than │ │ │ │ +00046840: 3130 302c 2079 6f75 206d 7573 7420 6569 100, you must ei │ │ │ │ +00046850: 7468 6572 2069 6e63 6c75 6465 2061 206d ther include a m │ │ │ │ +00046860: 6163 6869 6e65 2d72 6561 6461 626c 650a achine-readable. │ │ │ │ +00046870: 2020 2020 2054 7261 6e73 7061 7265 6e74 Transparent │ │ │ │ +00046880: 2063 6f70 7920 616c 6f6e 6720 7769 7468 copy along with │ │ │ │ +00046890: 2065 6163 6820 4f70 6171 7565 2063 6f70 each Opaque cop │ │ │ │ +000468a0: 792c 206f 7220 7374 6174 6520 696e 206f y, or state in o │ │ │ │ +000468b0: 7220 7769 7468 0a20 2020 2020 6561 6368 r with. each │ │ │ │ +000468c0: 204f 7061 7175 6520 636f 7079 2061 2063 Opaque copy a c │ │ │ │ +000468d0: 6f6d 7075 7465 722d 6e65 7477 6f72 6b20 omputer-network │ │ │ │ +000468e0: 6c6f 6361 7469 6f6e 2066 726f 6d20 7768 location from wh │ │ │ │ +000468f0: 6963 6820 7468 6520 6765 6e65 7261 6c0a ich the general. │ │ │ │ +00046900: 2020 2020 206e 6574 776f 726b 2d75 7369 network-usi │ │ │ │ +00046910: 6e67 2070 7562 6c69 6320 6861 7320 6163 ng public has ac │ │ │ │ +00046920: 6365 7373 2074 6f20 646f 776e 6c6f 6164 cess to download │ │ │ │ +00046930: 2075 7369 6e67 2070 7562 6c69 632d 7374 using public-st │ │ │ │ +00046940: 616e 6461 7264 0a20 2020 2020 6e65 7477 andard. netw │ │ │ │ +00046950: 6f72 6b20 7072 6f74 6f63 6f6c 7320 6120 ork protocols a │ │ │ │ +00046960: 636f 6d70 6c65 7465 2054 7261 6e73 7061 complete Transpa │ │ │ │ +00046970: 7265 6e74 2063 6f70 7920 6f66 2074 6865 rent copy of the │ │ │ │ +00046980: 2044 6f63 756d 656e 742c 2066 7265 650a Document, free. │ │ │ │ +00046990: 2020 2020 206f 6620 6164 6465 6420 6d61 of added ma │ │ │ │ +000469a0: 7465 7269 616c 2e20 2049 6620 796f 7520 terial. If you │ │ │ │ +000469b0: 7573 6520 7468 6520 6c61 7474 6572 206f use the latter o │ │ │ │ +000469c0: 7074 696f 6e2c 2079 6f75 206d 7573 7420 ption, you must │ │ │ │ +000469d0: 7461 6b65 0a20 2020 2020 7265 6173 6f6e take. reason │ │ │ │ +000469e0: 6162 6c79 2070 7275 6465 6e74 2073 7465 ably prudent ste │ │ │ │ +000469f0: 7073 2c20 7768 656e 2079 6f75 2062 6567 ps, when you beg │ │ │ │ +00046a00: 696e 2064 6973 7472 6962 7574 696f 6e20 in distribution │ │ │ │ +00046a10: 6f66 204f 7061 7175 650a 2020 2020 2063 of Opaque. c │ │ │ │ +00046a20: 6f70 6965 7320 696e 2071 7561 6e74 6974 opies in quantit │ │ │ │ +00046a30: 792c 2074 6f20 656e 7375 7265 2074 6861 y, to ensure tha │ │ │ │ +00046a40: 7420 7468 6973 2054 7261 6e73 7061 7265 t this Transpare │ │ │ │ +00046a50: 6e74 2063 6f70 7920 7769 6c6c 0a20 2020 nt copy will. │ │ │ │ +00046a60: 2020 7265 6d61 696e 2074 6875 7320 6163 remain thus ac │ │ │ │ +00046a70: 6365 7373 6962 6c65 2061 7420 7468 6520 cessible at the │ │ │ │ +00046a80: 7374 6174 6564 206c 6f63 6174 696f 6e20 stated location │ │ │ │ +00046a90: 756e 7469 6c20 6174 206c 6561 7374 206f until at least o │ │ │ │ +00046aa0: 6e65 0a20 2020 2020 7965 6172 2061 6674 ne. year aft │ │ │ │ +00046ab0: 6572 2074 6865 206c 6173 7420 7469 6d65 er the last time │ │ │ │ +00046ac0: 2079 6f75 2064 6973 7472 6962 7574 6520 you distribute │ │ │ │ +00046ad0: 616e 204f 7061 7175 6520 636f 7079 2028 an Opaque copy ( │ │ │ │ +00046ae0: 6469 7265 6374 6c79 206f 720a 2020 2020 directly or. │ │ │ │ +00046af0: 2074 6872 6f75 6768 2079 6f75 7220 6167 through your ag │ │ │ │ +00046b00: 656e 7473 206f 7220 7265 7461 696c 6572 ents or retailer │ │ │ │ +00046b10: 7329 206f 6620 7468 6174 2065 6469 7469 s) of that editi │ │ │ │ +00046b20: 6f6e 2074 6f20 7468 6520 7075 626c 6963 on to the public │ │ │ │ +00046b30: 2e0a 0a20 2020 2020 4974 2069 7320 7265 ... It is re │ │ │ │ +00046b40: 7175 6573 7465 642c 2062 7574 206e 6f74 quested, but not │ │ │ │ +00046b50: 2072 6571 7569 7265 642c 2074 6861 7420 required, that │ │ │ │ +00046b60: 796f 7520 636f 6e74 6163 7420 7468 6520 you contact the │ │ │ │ +00046b70: 6175 7468 6f72 7320 6f66 0a20 2020 2020 authors of. │ │ │ │ +00046b80: 7468 6520 446f 6375 6d65 6e74 2077 656c the Document wel │ │ │ │ +00046b90: 6c20 6265 666f 7265 2072 6564 6973 7472 l before redistr │ │ │ │ +00046ba0: 6962 7574 696e 6720 616e 7920 6c61 7267 ibuting any larg │ │ │ │ +00046bb0: 6520 6e75 6d62 6572 206f 6620 636f 7069 e number of copi │ │ │ │ +00046bc0: 6573 2c0a 2020 2020 2074 6f20 6769 7665 es,. to give │ │ │ │ +00046bd0: 2074 6865 6d20 6120 6368 616e 6365 2074 them a chance t │ │ │ │ +00046be0: 6f20 7072 6f76 6964 6520 796f 7520 7769 o provide you wi │ │ │ │ +00046bf0: 7468 2061 6e20 7570 6461 7465 6420 7665 th an updated ve │ │ │ │ +00046c00: 7273 696f 6e20 6f66 2074 6865 0a20 2020 rsion of the. │ │ │ │ +00046c10: 2020 446f 6375 6d65 6e74 2e0a 0a20 2034 Document... 4 │ │ │ │ +00046c20: 2e20 4d4f 4449 4649 4341 5449 4f4e 530a . MODIFICATIONS. │ │ │ │ +00046c30: 0a20 2020 2020 596f 7520 6d61 7920 636f . You may co │ │ │ │ +00046c40: 7079 2061 6e64 2064 6973 7472 6962 7574 py and distribut │ │ │ │ +00046c50: 6520 6120 4d6f 6469 6669 6564 2056 6572 e a Modified Ver │ │ │ │ +00046c60: 7369 6f6e 206f 6620 7468 6520 446f 6375 sion of the Docu │ │ │ │ +00046c70: 6d65 6e74 0a20 2020 2020 756e 6465 7220 ment. under │ │ │ │ +00046c80: 7468 6520 636f 6e64 6974 696f 6e73 206f the conditions o │ │ │ │ +00046c90: 6620 7365 6374 696f 6e73 2032 2061 6e64 f sections 2 and │ │ │ │ +00046ca0: 2033 2061 626f 7665 2c20 7072 6f76 6964 3 above, provid │ │ │ │ +00046cb0: 6564 2074 6861 7420 796f 750a 2020 2020 ed that you. │ │ │ │ +00046cc0: 2072 656c 6561 7365 2074 6865 204d 6f64 release the Mod │ │ │ │ +00046cd0: 6966 6965 6420 5665 7273 696f 6e20 756e ified Version un │ │ │ │ +00046ce0: 6465 7220 7072 6563 6973 656c 7920 7468 der precisely th │ │ │ │ +00046cf0: 6973 204c 6963 656e 7365 2c20 7769 7468 is License, with │ │ │ │ +00046d00: 2074 6865 0a20 2020 2020 4d6f 6469 6669 the. Modifi │ │ │ │ +00046d10: 6564 2056 6572 7369 6f6e 2066 696c 6c69 ed Version filli │ │ │ │ +00046d20: 6e67 2074 6865 2072 6f6c 6520 6f66 2074 ng the role of t │ │ │ │ +00046d30: 6865 2044 6f63 756d 656e 742c 2074 6875 he Document, thu │ │ │ │ +00046d40: 7320 6c69 6365 6e73 696e 670a 2020 2020 s licensing. │ │ │ │ +00046d50: 2064 6973 7472 6962 7574 696f 6e20 616e distribution an │ │ │ │ +00046d60: 6420 6d6f 6469 6669 6361 7469 6f6e 206f d modification o │ │ │ │ +00046d70: 6620 7468 6520 4d6f 6469 6669 6564 2056 f the Modified V │ │ │ │ +00046d80: 6572 7369 6f6e 2074 6f20 7768 6f65 7665 ersion to whoeve │ │ │ │ +00046d90: 720a 2020 2020 2070 6f73 7365 7373 6573 r. possesses │ │ │ │ +00046da0: 2061 2063 6f70 7920 6f66 2069 742e 2020 a copy of it. │ │ │ │ +00046db0: 496e 2061 6464 6974 696f 6e2c 2079 6f75 In addition, you │ │ │ │ +00046dc0: 206d 7573 7420 646f 2074 6865 7365 2074 must do these t │ │ │ │ +00046dd0: 6869 6e67 7320 696e 0a20 2020 2020 7468 hings in. th │ │ │ │ +00046de0: 6520 4d6f 6469 6669 6564 2056 6572 7369 e Modified Versi │ │ │ │ +00046df0: 6f6e 3a0a 0a20 2020 2020 2020 412e 2055 on:.. A. U │ │ │ │ +00046e00: 7365 2069 6e20 7468 6520 5469 746c 6520 se in the Title │ │ │ │ +00046e10: 5061 6765 2028 616e 6420 6f6e 2074 6865 Page (and on the │ │ │ │ +00046e20: 2063 6f76 6572 732c 2069 6620 616e 7929 covers, if any) │ │ │ │ +00046e30: 2061 2074 6974 6c65 0a20 2020 2020 2020 a title. │ │ │ │ +00046e40: 2020 2064 6973 7469 6e63 7420 6672 6f6d distinct from │ │ │ │ +00046e50: 2074 6861 7420 6f66 2074 6865 2044 6f63 that of the Doc │ │ │ │ +00046e60: 756d 656e 742c 2061 6e64 2066 726f 6d20 ument, and from │ │ │ │ +00046e70: 7468 6f73 6520 6f66 2070 7265 7669 6f75 those of previou │ │ │ │ +00046e80: 730a 2020 2020 2020 2020 2020 7665 7273 s. vers │ │ │ │ +00046e90: 696f 6e73 2028 7768 6963 6820 7368 6f75 ions (which shou │ │ │ │ +00046ea0: 6c64 2c20 6966 2074 6865 7265 2077 6572 ld, if there wer │ │ │ │ +00046eb0: 6520 616e 792c 2062 6520 6c69 7374 6564 e any, be listed │ │ │ │ +00046ec0: 2069 6e20 7468 650a 2020 2020 2020 2020 in the. │ │ │ │ +00046ed0: 2020 4869 7374 6f72 7920 7365 6374 696f History sectio │ │ │ │ +00046ee0: 6e20 6f66 2074 6865 2044 6f63 756d 656e n of the Documen │ │ │ │ +00046ef0: 7429 2e20 2059 6f75 206d 6179 2075 7365 t). You may use │ │ │ │ +00046f00: 2074 6865 2073 616d 6520 7469 746c 650a the same title. │ │ │ │ +00046f10: 2020 2020 2020 2020 2020 6173 2061 2070 as a p │ │ │ │ +00046f20: 7265 7669 6f75 7320 7665 7273 696f 6e20 revious version │ │ │ │ +00046f30: 6966 2074 6865 206f 7269 6769 6e61 6c20 if the original │ │ │ │ +00046f40: 7075 626c 6973 6865 7220 6f66 2074 6861 publisher of tha │ │ │ │ +00046f50: 740a 2020 2020 2020 2020 2020 7665 7273 t. vers │ │ │ │ +00046f60: 696f 6e20 6769 7665 7320 7065 726d 6973 ion gives permis │ │ │ │ +00046f70: 7369 6f6e 2e0a 0a20 2020 2020 2020 422e sion... B. │ │ │ │ +00046f80: 204c 6973 7420 6f6e 2074 6865 2054 6974 List on the Tit │ │ │ │ +00046f90: 6c65 2050 6167 652c 2061 7320 6175 7468 le Page, as auth │ │ │ │ +00046fa0: 6f72 732c 206f 6e65 206f 7220 6d6f 7265 ors, one or more │ │ │ │ +00046fb0: 2070 6572 736f 6e73 206f 720a 2020 2020 persons or. │ │ │ │ +00046fc0: 2020 2020 2020 656e 7469 7469 6573 2072 entities r │ │ │ │ +00046fd0: 6573 706f 6e73 6962 6c65 2066 6f72 2061 esponsible for a │ │ │ │ +00046fe0: 7574 686f 7273 6869 7020 6f66 2074 6865 uthorship of the │ │ │ │ +00046ff0: 206d 6f64 6966 6963 6174 696f 6e73 2069 modifications i │ │ │ │ +00047000: 6e0a 2020 2020 2020 2020 2020 7468 6520 n. the │ │ │ │ +00047010: 4d6f 6469 6669 6564 2056 6572 7369 6f6e Modified Version │ │ │ │ +00047020: 2c20 746f 6765 7468 6572 2077 6974 6820 , together with │ │ │ │ +00047030: 6174 206c 6561 7374 2066 6976 6520 6f66 at least five of │ │ │ │ +00047040: 2074 6865 0a20 2020 2020 2020 2020 2070 the. p │ │ │ │ +00047050: 7269 6e63 6970 616c 2061 7574 686f 7273 rincipal authors │ │ │ │ +00047060: 206f 6620 7468 6520 446f 6375 6d65 6e74 of the Document │ │ │ │ +00047070: 2028 616c 6c20 6f66 2069 7473 2070 7269 (all of its pri │ │ │ │ +00047080: 6e63 6970 616c 0a20 2020 2020 2020 2020 ncipal. │ │ │ │ +00047090: 2061 7574 686f 7273 2c20 6966 2069 7420 authors, if it │ │ │ │ +000470a0: 6861 7320 6665 7765 7220 7468 616e 2066 has fewer than f │ │ │ │ +000470b0: 6976 6529 2c20 756e 6c65 7373 2074 6865 ive), unless the │ │ │ │ +000470c0: 7920 7265 6c65 6173 6520 796f 750a 2020 y release you. │ │ │ │ +000470d0: 2020 2020 2020 2020 6672 6f6d 2074 6869 from thi │ │ │ │ +000470e0: 7320 7265 7175 6972 656d 656e 742e 0a0a s requirement... │ │ │ │ +000470f0: 2020 2020 2020 2043 2e20 5374 6174 6520 C. State │ │ │ │ +00047100: 6f6e 2074 6865 2054 6974 6c65 2070 6167 on the Title pag │ │ │ │ +00047110: 6520 7468 6520 6e61 6d65 206f 6620 7468 e the name of th │ │ │ │ +00047120: 6520 7075 626c 6973 6865 7220 6f66 2074 e publisher of t │ │ │ │ +00047130: 6865 0a20 2020 2020 2020 2020 204d 6f64 he. Mod │ │ │ │ +00047140: 6966 6965 6420 5665 7273 696f 6e2c 2061 ified Version, a │ │ │ │ +00047150: 7320 7468 6520 7075 626c 6973 6865 722e s the publisher. │ │ │ │ +00047160: 0a0a 2020 2020 2020 2044 2e20 5072 6573 .. D. Pres │ │ │ │ +00047170: 6572 7665 2061 6c6c 2074 6865 2063 6f70 erve all the cop │ │ │ │ +00047180: 7972 6967 6874 206e 6f74 6963 6573 206f yright notices o │ │ │ │ +00047190: 6620 7468 6520 446f 6375 6d65 6e74 2e0a f the Document.. │ │ │ │ +000471a0: 0a20 2020 2020 2020 452e 2041 6464 2061 . E. Add a │ │ │ │ +000471b0: 6e20 6170 7072 6f70 7269 6174 6520 636f n appropriate co │ │ │ │ +000471c0: 7079 7269 6768 7420 6e6f 7469 6365 2066 pyright notice f │ │ │ │ +000471d0: 6f72 2079 6f75 7220 6d6f 6469 6669 6361 or your modifica │ │ │ │ +000471e0: 7469 6f6e 730a 2020 2020 2020 2020 2020 tions. │ │ │ │ +000471f0: 6164 6a61 6365 6e74 2074 6f20 7468 6520 adjacent to the │ │ │ │ +00047200: 6f74 6865 7220 636f 7079 7269 6768 7420 other copyright │ │ │ │ +00047210: 6e6f 7469 6365 732e 0a0a 2020 2020 2020 notices... │ │ │ │ +00047220: 2046 2e20 496e 636c 7564 652c 2069 6d6d F. Include, imm │ │ │ │ +00047230: 6564 6961 7465 6c79 2061 6674 6572 2074 ediately after t │ │ │ │ +00047240: 6865 2063 6f70 7972 6967 6874 206e 6f74 he copyright not │ │ │ │ +00047250: 6963 6573 2c20 6120 6c69 6365 6e73 650a ices, a license. │ │ │ │ +00047260: 2020 2020 2020 2020 2020 6e6f 7469 6365 notice │ │ │ │ +00047270: 2067 6976 696e 6720 7468 6520 7075 626c giving the publ │ │ │ │ +00047280: 6963 2070 6572 6d69 7373 696f 6e20 746f ic permission to │ │ │ │ +00047290: 2075 7365 2074 6865 204d 6f64 6966 6965 use the Modifie │ │ │ │ +000472a0: 640a 2020 2020 2020 2020 2020 5665 7273 d. Vers │ │ │ │ +000472b0: 696f 6e20 756e 6465 7220 7468 6520 7465 ion under the te │ │ │ │ +000472c0: 726d 7320 6f66 2074 6869 7320 4c69 6365 rms of this Lice │ │ │ │ +000472d0: 6e73 652c 2069 6e20 7468 6520 666f 726d nse, in the form │ │ │ │ +000472e0: 2073 686f 776e 2069 6e0a 2020 2020 2020 shown in. │ │ │ │ +000472f0: 2020 2020 7468 6520 4164 6465 6e64 756d the Addendum │ │ │ │ +00047300: 2062 656c 6f77 2e0a 0a20 2020 2020 2020 below... │ │ │ │ +00047310: 472e 2050 7265 7365 7276 6520 696e 2074 G. Preserve in t │ │ │ │ +00047320: 6861 7420 6c69 6365 6e73 6520 6e6f 7469 hat license noti │ │ │ │ +00047330: 6365 2074 6865 2066 756c 6c20 6c69 7374 ce the full list │ │ │ │ +00047340: 7320 6f66 2049 6e76 6172 6961 6e74 0a20 s of Invariant. │ │ │ │ +00047350: 2020 2020 2020 2020 2053 6563 7469 6f6e Section │ │ │ │ +00047360: 7320 616e 6420 7265 7175 6972 6564 2043 s and required C │ │ │ │ +00047370: 6f76 6572 2054 6578 7473 2067 6976 656e over Texts given │ │ │ │ +00047380: 2069 6e20 7468 6520 446f 6375 6d65 6e74 in the Document │ │ │ │ +00047390: 2773 0a20 2020 2020 2020 2020 206c 6963 's. lic │ │ │ │ +000473a0: 656e 7365 206e 6f74 6963 652e 0a0a 2020 ense notice... │ │ │ │ +000473b0: 2020 2020 2048 2e20 496e 636c 7564 6520 H. Include │ │ │ │ +000473c0: 616e 2075 6e61 6c74 6572 6564 2063 6f70 an unaltered cop │ │ │ │ +000473d0: 7920 6f66 2074 6869 7320 4c69 6365 6e73 y of this Licens │ │ │ │ +000473e0: 652e 0a0a 2020 2020 2020 2049 2e20 5072 e... I. Pr │ │ │ │ +000473f0: 6573 6572 7665 2074 6865 2073 6563 7469 eserve the secti │ │ │ │ +00047400: 6f6e 2045 6e74 6974 6c65 6420 2248 6973 on Entitled "His │ │ │ │ +00047410: 746f 7279 222c 2050 7265 7365 7276 6520 tory", Preserve │ │ │ │ +00047420: 6974 7320 5469 746c 652c 0a20 2020 2020 its Title,. │ │ │ │ +00047430: 2020 2020 2061 6e64 2061 6464 2074 6f20 and add to │ │ │ │ +00047440: 6974 2061 6e20 6974 656d 2073 7461 7469 it an item stati │ │ │ │ +00047450: 6e67 2061 7420 6c65 6173 7420 7468 6520 ng at least the │ │ │ │ +00047460: 7469 746c 652c 2079 6561 722c 206e 6577 title, year, new │ │ │ │ +00047470: 0a20 2020 2020 2020 2020 2061 7574 686f . autho │ │ │ │ +00047480: 7273 2c20 616e 6420 7075 626c 6973 6865 rs, and publishe │ │ │ │ +00047490: 7220 6f66 2074 6865 204d 6f64 6966 6965 r of the Modifie │ │ │ │ +000474a0: 6420 5665 7273 696f 6e20 6173 2067 6976 d Version as giv │ │ │ │ +000474b0: 656e 206f 6e20 7468 650a 2020 2020 2020 en on the. │ │ │ │ +000474c0: 2020 2020 5469 746c 6520 5061 6765 2e20 Title Page. │ │ │ │ +000474d0: 2049 6620 7468 6572 6520 6973 206e 6f20 If there is no │ │ │ │ +000474e0: 7365 6374 696f 6e20 456e 7469 746c 6564 section Entitled │ │ │ │ +000474f0: 2022 4869 7374 6f72 7922 2069 6e20 7468 "History" in th │ │ │ │ +00047500: 650a 2020 2020 2020 2020 2020 446f 6375 e. Docu │ │ │ │ +00047510: 6d65 6e74 2c20 6372 6561 7465 206f 6e65 ment, create one │ │ │ │ +00047520: 2073 7461 7469 6e67 2074 6865 2074 6974 stating the tit │ │ │ │ +00047530: 6c65 2c20 7965 6172 2c20 6175 7468 6f72 le, year, author │ │ │ │ +00047540: 732c 2061 6e64 0a20 2020 2020 2020 2020 s, and. │ │ │ │ +00047550: 2070 7562 6c69 7368 6572 206f 6620 7468 publisher of th │ │ │ │ +00047560: 6520 446f 6375 6d65 6e74 2061 7320 6769 e Document as gi │ │ │ │ +00047570: 7665 6e20 6f6e 2069 7473 2054 6974 6c65 ven on its Title │ │ │ │ +00047580: 2050 6167 652c 2074 6865 6e20 6164 640a Page, then add. │ │ │ │ +00047590: 2020 2020 2020 2020 2020 616e 2069 7465 an ite │ │ │ │ +000475a0: 6d20 6465 7363 7269 6269 6e67 2074 6865 m describing the │ │ │ │ +000475b0: 204d 6f64 6966 6965 6420 5665 7273 696f Modified Versio │ │ │ │ +000475c0: 6e20 6173 2073 7461 7465 6420 696e 2074 n as stated in t │ │ │ │ +000475d0: 6865 0a20 2020 2020 2020 2020 2070 7265 he. pre │ │ │ │ +000475e0: 7669 6f75 7320 7365 6e74 656e 6365 2e0a vious sentence.. │ │ │ │ +000475f0: 0a20 2020 2020 2020 4a2e 2050 7265 7365 . J. Prese │ │ │ │ +00047600: 7276 6520 7468 6520 6e65 7477 6f72 6b20 rve the network │ │ │ │ +00047610: 6c6f 6361 7469 6f6e 2c20 6966 2061 6e79 location, if any │ │ │ │ +00047620: 2c20 6769 7665 6e20 696e 2074 6865 2044 , given in the D │ │ │ │ +00047630: 6f63 756d 656e 740a 2020 2020 2020 2020 ocument. │ │ │ │ +00047640: 2020 666f 7220 7075 626c 6963 2061 6363 for public acc │ │ │ │ +00047650: 6573 7320 746f 2061 2054 7261 6e73 7061 ess to a Transpa │ │ │ │ +00047660: 7265 6e74 2063 6f70 7920 6f66 2074 6865 rent copy of the │ │ │ │ +00047670: 2044 6f63 756d 656e 742c 2061 6e64 0a20 Document, and. │ │ │ │ +00047680: 2020 2020 2020 2020 206c 696b 6577 6973 likewis │ │ │ │ +00047690: 6520 7468 6520 6e65 7477 6f72 6b20 6c6f e the network lo │ │ │ │ +000476a0: 6361 7469 6f6e 7320 6769 7665 6e20 696e cations given in │ │ │ │ +000476b0: 2074 6865 2044 6f63 756d 656e 7420 666f the Document fo │ │ │ │ +000476c0: 720a 2020 2020 2020 2020 2020 7072 6576 r. prev │ │ │ │ +000476d0: 696f 7573 2076 6572 7369 6f6e 7320 6974 ious versions it │ │ │ │ +000476e0: 2077 6173 2062 6173 6564 206f 6e2e 2020 was based on. │ │ │ │ +000476f0: 5468 6573 6520 6d61 7920 6265 2070 6c61 These may be pla │ │ │ │ +00047700: 6365 6420 696e 2074 6865 0a20 2020 2020 ced in the. │ │ │ │ +00047710: 2020 2020 2022 4869 7374 6f72 7922 2073 "History" s │ │ │ │ +00047720: 6563 7469 6f6e 2e20 2059 6f75 206d 6179 ection. You may │ │ │ │ +00047730: 206f 6d69 7420 6120 6e65 7477 6f72 6b20 omit a network │ │ │ │ +00047740: 6c6f 6361 7469 6f6e 2066 6f72 2061 2077 location for a w │ │ │ │ +00047750: 6f72 6b0a 2020 2020 2020 2020 2020 7468 ork. th │ │ │ │ +00047760: 6174 2077 6173 2070 7562 6c69 7368 6564 at was published │ │ │ │ +00047770: 2061 7420 6c65 6173 7420 666f 7572 2079 at least four y │ │ │ │ +00047780: 6561 7273 2062 6566 6f72 6520 7468 6520 ears before the │ │ │ │ +00047790: 446f 6375 6d65 6e74 0a20 2020 2020 2020 Document. │ │ │ │ +000477a0: 2020 2069 7473 656c 662c 206f 7220 6966 itself, or if │ │ │ │ +000477b0: 2074 6865 206f 7269 6769 6e61 6c20 7075 the original pu │ │ │ │ +000477c0: 626c 6973 6865 7220 6f66 2074 6865 2076 blisher of the v │ │ │ │ +000477d0: 6572 7369 6f6e 2069 7420 7265 6665 7273 ersion it refers │ │ │ │ +000477e0: 0a20 2020 2020 2020 2020 2074 6f20 6769 . to gi │ │ │ │ +000477f0: 7665 7320 7065 726d 6973 7369 6f6e 2e0a ves permission.. │ │ │ │ +00047800: 0a20 2020 2020 2020 4b2e 2046 6f72 2061 . K. For a │ │ │ │ +00047810: 6e79 2073 6563 7469 6f6e 2045 6e74 6974 ny section Entit │ │ │ │ +00047820: 6c65 6420 2241 636b 6e6f 776c 6564 6765 led "Acknowledge │ │ │ │ +00047830: 6d65 6e74 7322 206f 7220 2244 6564 6963 ments" or "Dedic │ │ │ │ +00047840: 6174 696f 6e73 222c 0a20 2020 2020 2020 ations",. │ │ │ │ +00047850: 2020 2050 7265 7365 7276 6520 7468 6520 Preserve the │ │ │ │ +00047860: 5469 746c 6520 6f66 2074 6865 2073 6563 Title of the sec │ │ │ │ +00047870: 7469 6f6e 2c20 616e 6420 7072 6573 6572 tion, and preser │ │ │ │ +00047880: 7665 2069 6e20 7468 6520 7365 6374 696f ve in the sectio │ │ │ │ +00047890: 6e0a 2020 2020 2020 2020 2020 616c 6c20 n. all │ │ │ │ +000478a0: 7468 6520 7375 6273 7461 6e63 6520 616e the substance an │ │ │ │ +000478b0: 6420 746f 6e65 206f 6620 6561 6368 206f d tone of each o │ │ │ │ +000478c0: 6620 7468 6520 636f 6e74 7269 6275 746f f the contributo │ │ │ │ +000478d0: 720a 2020 2020 2020 2020 2020 6163 6b6e r. ackn │ │ │ │ +000478e0: 6f77 6c65 6467 656d 656e 7473 2061 6e64 owledgements and │ │ │ │ +000478f0: 2f6f 7220 6465 6469 6361 7469 6f6e 7320 /or dedications │ │ │ │ +00047900: 6769 7665 6e20 7468 6572 6569 6e2e 0a0a given therein... │ │ │ │ +00047910: 2020 2020 2020 204c 2e20 5072 6573 6572 L. Preser │ │ │ │ +00047920: 7665 2061 6c6c 2074 6865 2049 6e76 6172 ve all the Invar │ │ │ │ +00047930: 6961 6e74 2053 6563 7469 6f6e 7320 6f66 iant Sections of │ │ │ │ +00047940: 2074 6865 2044 6f63 756d 656e 742c 2075 the Document, u │ │ │ │ +00047950: 6e61 6c74 6572 6564 0a20 2020 2020 2020 naltered. │ │ │ │ +00047960: 2020 2069 6e20 7468 6569 7220 7465 7874 in their text │ │ │ │ +00047970: 2061 6e64 2069 6e20 7468 6569 7220 7469 and in their ti │ │ │ │ +00047980: 746c 6573 2e20 2053 6563 7469 6f6e 206e tles. Section n │ │ │ │ +00047990: 756d 6265 7273 206f 7220 7468 650a 2020 umbers or the. │ │ │ │ +000479a0: 2020 2020 2020 2020 6571 7569 7661 6c65 equivale │ │ │ │ +000479b0: 6e74 2061 7265 206e 6f74 2063 6f6e 7369 nt are not consi │ │ │ │ +000479c0: 6465 7265 6420 7061 7274 206f 6620 7468 dered part of th │ │ │ │ +000479d0: 6520 7365 6374 696f 6e20 7469 746c 6573 e section titles │ │ │ │ +000479e0: 2e0a 0a20 2020 2020 2020 4d2e 2044 656c ... M. Del │ │ │ │ +000479f0: 6574 6520 616e 7920 7365 6374 696f 6e20 ete any section │ │ │ │ +00047a00: 456e 7469 746c 6564 2022 456e 646f 7273 Entitled "Endors │ │ │ │ +00047a10: 656d 656e 7473 222e 2020 5375 6368 2061 ements". Such a │ │ │ │ +00047a20: 2073 6563 7469 6f6e 0a20 2020 2020 2020 section. │ │ │ │ +00047a30: 2020 206d 6179 206e 6f74 2062 6520 696e may not be in │ │ │ │ +00047a40: 636c 7564 6564 2069 6e20 7468 6520 4d6f cluded in the Mo │ │ │ │ +00047a50: 6469 6669 6564 2056 6572 7369 6f6e 2e0a dified Version.. │ │ │ │ +00047a60: 0a20 2020 2020 2020 4e2e 2044 6f20 6e6f . N. Do no │ │ │ │ +00047a70: 7420 7265 7469 746c 6520 616e 7920 6578 t retitle any ex │ │ │ │ +00047a80: 6973 7469 6e67 2073 6563 7469 6f6e 2074 isting section t │ │ │ │ +00047a90: 6f20 6265 2045 6e74 6974 6c65 640a 2020 o be Entitled. │ │ │ │ +00047aa0: 2020 2020 2020 2020 2245 6e64 6f72 7365 "Endorse │ │ │ │ +00047ab0: 6d65 6e74 7322 206f 7220 746f 2063 6f6e ments" or to con │ │ │ │ +00047ac0: 666c 6963 7420 696e 2074 6974 6c65 2077 flict in title w │ │ │ │ +00047ad0: 6974 6820 616e 7920 496e 7661 7269 616e ith any Invarian │ │ │ │ +00047ae0: 740a 2020 2020 2020 2020 2020 5365 6374 t. Sect │ │ │ │ +00047af0: 696f 6e2e 0a0a 2020 2020 2020 204f 2e20 ion... O. │ │ │ │ +00047b00: 5072 6573 6572 7665 2061 6e79 2057 6172 Preserve any War │ │ │ │ +00047b10: 7261 6e74 7920 4469 7363 6c61 696d 6572 ranty Disclaimer │ │ │ │ +00047b20: 732e 0a0a 2020 2020 2049 6620 7468 6520 s... If the │ │ │ │ +00047b30: 4d6f 6469 6669 6564 2056 6572 7369 6f6e Modified Version │ │ │ │ +00047b40: 2069 6e63 6c75 6465 7320 6e65 7720 6672 includes new fr │ │ │ │ +00047b50: 6f6e 742d 6d61 7474 6572 2073 6563 7469 ont-matter secti │ │ │ │ +00047b60: 6f6e 7320 6f72 0a20 2020 2020 6170 7065 ons or. appe │ │ │ │ +00047b70: 6e64 6963 6573 2074 6861 7420 7175 616c ndices that qual │ │ │ │ +00047b80: 6966 7920 6173 2053 6563 6f6e 6461 7279 ify as Secondary │ │ │ │ +00047b90: 2053 6563 7469 6f6e 7320 616e 6420 636f Sections and co │ │ │ │ +00047ba0: 6e74 6169 6e20 6e6f 0a20 2020 2020 6d61 ntain no. ma │ │ │ │ +00047bb0: 7465 7269 616c 2063 6f70 6965 6420 6672 terial copied fr │ │ │ │ +00047bc0: 6f6d 2074 6865 2044 6f63 756d 656e 742c om the Document, │ │ │ │ +00047bd0: 2079 6f75 206d 6179 2061 7420 796f 7572 you may at your │ │ │ │ +00047be0: 206f 7074 696f 6e20 6465 7369 676e 6174 option designat │ │ │ │ +00047bf0: 650a 2020 2020 2073 6f6d 6520 6f72 2061 e. some or a │ │ │ │ +00047c00: 6c6c 206f 6620 7468 6573 6520 7365 6374 ll of these sect │ │ │ │ +00047c10: 696f 6e73 2061 7320 696e 7661 7269 616e ions as invarian │ │ │ │ +00047c20: 742e 2020 546f 2064 6f20 7468 6973 2c20 t. To do this, │ │ │ │ +00047c30: 6164 6420 7468 6569 720a 2020 2020 2074 add their. t │ │ │ │ +00047c40: 6974 6c65 7320 746f 2074 6865 206c 6973 itles to the lis │ │ │ │ +00047c50: 7420 6f66 2049 6e76 6172 6961 6e74 2053 t of Invariant S │ │ │ │ +00047c60: 6563 7469 6f6e 7320 696e 2074 6865 204d ections in the M │ │ │ │ +00047c70: 6f64 6966 6965 6420 5665 7273 696f 6e27 odified Version' │ │ │ │ +00047c80: 730a 2020 2020 206c 6963 656e 7365 206e s. license n │ │ │ │ +00047c90: 6f74 6963 652e 2020 5468 6573 6520 7469 otice. These ti │ │ │ │ +00047ca0: 746c 6573 206d 7573 7420 6265 2064 6973 tles must be dis │ │ │ │ +00047cb0: 7469 6e63 7420 6672 6f6d 2061 6e79 206f tinct from any o │ │ │ │ +00047cc0: 7468 6572 0a20 2020 2020 7365 6374 696f ther. sectio │ │ │ │ +00047cd0: 6e20 7469 746c 6573 2e0a 0a20 2020 2020 n titles... │ │ │ │ +00047ce0: 596f 7520 6d61 7920 6164 6420 6120 7365 You may add a se │ │ │ │ +00047cf0: 6374 696f 6e20 456e 7469 746c 6564 2022 ction Entitled " │ │ │ │ +00047d00: 456e 646f 7273 656d 656e 7473 222c 2070 Endorsements", p │ │ │ │ +00047d10: 726f 7669 6465 6420 6974 2063 6f6e 7461 rovided it conta │ │ │ │ +00047d20: 696e 730a 2020 2020 206e 6f74 6869 6e67 ins. nothing │ │ │ │ +00047d30: 2062 7574 2065 6e64 6f72 7365 6d65 6e74 but endorsement │ │ │ │ +00047d40: 7320 6f66 2079 6f75 7220 4d6f 6469 6669 s of your Modifi │ │ │ │ +00047d50: 6564 2056 6572 7369 6f6e 2062 7920 7661 ed Version by va │ │ │ │ +00047d60: 7269 6f75 730a 2020 2020 2070 6172 7469 rious. parti │ │ │ │ +00047d70: 6573 2d2d 666f 7220 6578 616d 706c 652c es--for example, │ │ │ │ +00047d80: 2073 7461 7465 6d65 6e74 7320 6f66 2070 statements of p │ │ │ │ +00047d90: 6565 7220 7265 7669 6577 206f 7220 7468 eer review or th │ │ │ │ +00047da0: 6174 2074 6865 2074 6578 740a 2020 2020 at the text. │ │ │ │ +00047db0: 2068 6173 2062 6565 6e20 6170 7072 6f76 has been approv │ │ │ │ +00047dc0: 6564 2062 7920 616e 206f 7267 616e 697a ed by an organiz │ │ │ │ +00047dd0: 6174 696f 6e20 6173 2074 6865 2061 7574 ation as the aut │ │ │ │ +00047de0: 686f 7269 7461 7469 7665 0a20 2020 2020 horitative. │ │ │ │ +00047df0: 6465 6669 6e69 7469 6f6e 206f 6620 6120 definition of a │ │ │ │ +00047e00: 7374 616e 6461 7264 2e0a 0a20 2020 2020 standard... │ │ │ │ +00047e10: 596f 7520 6d61 7920 6164 6420 6120 7061 You may add a pa │ │ │ │ +00047e20: 7373 6167 6520 6f66 2075 7020 746f 2066 ssage of up to f │ │ │ │ +00047e30: 6976 6520 776f 7264 7320 6173 2061 2046 ive words as a F │ │ │ │ +00047e40: 726f 6e74 2d43 6f76 6572 2054 6578 742c ront-Cover Text, │ │ │ │ +00047e50: 0a20 2020 2020 616e 6420 6120 7061 7373 . and a pass │ │ │ │ +00047e60: 6167 6520 6f66 2075 7020 746f 2032 3520 age of up to 25 │ │ │ │ +00047e70: 776f 7264 7320 6173 2061 2042 6163 6b2d words as a Back- │ │ │ │ +00047e80: 436f 7665 7220 5465 7874 2c20 746f 2074 Cover Text, to t │ │ │ │ +00047e90: 6865 2065 6e64 206f 660a 2020 2020 2074 he end of. t │ │ │ │ +00047ea0: 6865 206c 6973 7420 6f66 2043 6f76 6572 he list of Cover │ │ │ │ +00047eb0: 2054 6578 7473 2069 6e20 7468 6520 4d6f Texts in the Mo │ │ │ │ +00047ec0: 6469 6669 6564 2056 6572 7369 6f6e 2e20 dified Version. │ │ │ │ +00047ed0: 204f 6e6c 7920 6f6e 6520 7061 7373 6167 Only one passag │ │ │ │ +00047ee0: 650a 2020 2020 206f 6620 4672 6f6e 742d e. of Front- │ │ │ │ +00047ef0: 436f 7665 7220 5465 7874 2061 6e64 206f Cover Text and o │ │ │ │ +00047f00: 6e65 206f 6620 4261 636b 2d43 6f76 6572 ne of Back-Cover │ │ │ │ +00047f10: 2054 6578 7420 6d61 7920 6265 2061 6464 Text may be add │ │ │ │ +00047f20: 6564 2062 7920 286f 720a 2020 2020 2074 ed by (or. t │ │ │ │ +00047f30: 6872 6f75 6768 2061 7272 616e 6765 6d65 hrough arrangeme │ │ │ │ +00047f40: 6e74 7320 6d61 6465 2062 7929 2061 6e79 nts made by) any │ │ │ │ +00047f50: 206f 6e65 2065 6e74 6974 792e 2020 4966 one entity. If │ │ │ │ +00047f60: 2074 6865 2044 6f63 756d 656e 740a 2020 the Document. │ │ │ │ +00047f70: 2020 2061 6c72 6561 6479 2069 6e63 6c75 already inclu │ │ │ │ +00047f80: 6465 7320 6120 636f 7665 7220 7465 7874 des a cover text │ │ │ │ +00047f90: 2066 6f72 2074 6865 2073 616d 6520 636f for the same co │ │ │ │ +00047fa0: 7665 722c 2070 7265 7669 6f75 736c 7920 ver, previously │ │ │ │ +00047fb0: 6164 6465 640a 2020 2020 2062 7920 796f added. by yo │ │ │ │ +00047fc0: 7520 6f72 2062 7920 6172 7261 6e67 656d u or by arrangem │ │ │ │ +00047fd0: 656e 7420 6d61 6465 2062 7920 7468 6520 ent made by the │ │ │ │ +00047fe0: 7361 6d65 2065 6e74 6974 7920 796f 7520 same entity you │ │ │ │ +00047ff0: 6172 6520 6163 7469 6e67 206f 6e0a 2020 are acting on. │ │ │ │ +00048000: 2020 2062 6568 616c 6620 6f66 2c20 796f behalf of, yo │ │ │ │ +00048010: 7520 6d61 7920 6e6f 7420 6164 6420 616e u may not add an │ │ │ │ +00048020: 6f74 6865 723b 2062 7574 2079 6f75 206d other; but you m │ │ │ │ +00048030: 6179 2072 6570 6c61 6365 2074 6865 206f ay replace the o │ │ │ │ +00048040: 6c64 0a20 2020 2020 6f6e 652c 206f 6e20 ld. one, on │ │ │ │ +00048050: 6578 706c 6963 6974 2070 6572 6d69 7373 explicit permiss │ │ │ │ +00048060: 696f 6e20 6672 6f6d 2074 6865 2070 7265 ion from the pre │ │ │ │ +00048070: 7669 6f75 7320 7075 626c 6973 6865 7220 vious publisher │ │ │ │ +00048080: 7468 6174 2061 6464 6564 0a20 2020 2020 that added. │ │ │ │ +00048090: 7468 6520 6f6c 6420 6f6e 652e 0a0a 2020 the old one... │ │ │ │ +000480a0: 2020 2054 6865 2061 7574 686f 7228 7329 The author(s) │ │ │ │ +000480b0: 2061 6e64 2070 7562 6c69 7368 6572 2873 and publisher(s │ │ │ │ +000480c0: 2920 6f66 2074 6865 2044 6f63 756d 656e ) of the Documen │ │ │ │ +000480d0: 7420 646f 206e 6f74 2062 7920 7468 6973 t do not by this │ │ │ │ +000480e0: 0a20 2020 2020 4c69 6365 6e73 6520 6769 . License gi │ │ │ │ +000480f0: 7665 2070 6572 6d69 7373 696f 6e20 746f ve permission to │ │ │ │ +00048100: 2075 7365 2074 6865 6972 206e 616d 6573 use their names │ │ │ │ +00048110: 2066 6f72 2070 7562 6c69 6369 7479 2066 for publicity f │ │ │ │ +00048120: 6f72 206f 7220 746f 0a20 2020 2020 6173 or or to. as │ │ │ │ +00048130: 7365 7274 206f 7220 696d 706c 7920 656e sert or imply en │ │ │ │ +00048140: 646f 7273 656d 656e 7420 6f66 2061 6e79 dorsement of any │ │ │ │ +00048150: 204d 6f64 6966 6965 6420 5665 7273 696f Modified Versio │ │ │ │ +00048160: 6e2e 0a0a 2020 352e 2043 4f4d 4249 4e49 n... 5. COMBINI │ │ │ │ +00048170: 4e47 2044 4f43 554d 454e 5453 0a0a 2020 NG DOCUMENTS.. │ │ │ │ +00048180: 2020 2059 6f75 206d 6179 2063 6f6d 6269 You may combi │ │ │ │ +00048190: 6e65 2074 6865 2044 6f63 756d 656e 7420 ne the Document │ │ │ │ +000481a0: 7769 7468 206f 7468 6572 2064 6f63 756d with other docum │ │ │ │ +000481b0: 656e 7473 2072 656c 6561 7365 6420 756e ents released un │ │ │ │ +000481c0: 6465 720a 2020 2020 2074 6869 7320 4c69 der. this Li │ │ │ │ +000481d0: 6365 6e73 652c 2075 6e64 6572 2074 6865 cense, under the │ │ │ │ +000481e0: 2074 6572 6d73 2064 6566 696e 6564 2069 terms defined i │ │ │ │ +000481f0: 6e20 7365 6374 696f 6e20 3420 6162 6f76 n section 4 abov │ │ │ │ +00048200: 6520 666f 720a 2020 2020 206d 6f64 6966 e for. modif │ │ │ │ +00048210: 6965 6420 7665 7273 696f 6e73 2c20 7072 ied versions, pr │ │ │ │ +00048220: 6f76 6964 6564 2074 6861 7420 796f 7520 ovided that you │ │ │ │ +00048230: 696e 636c 7564 6520 696e 2074 6865 2063 include in the c │ │ │ │ +00048240: 6f6d 6269 6e61 7469 6f6e 2061 6c6c 0a20 ombination all. │ │ │ │ +00048250: 2020 2020 6f66 2074 6865 2049 6e76 6172 of the Invar │ │ │ │ +00048260: 6961 6e74 2053 6563 7469 6f6e 7320 6f66 iant Sections of │ │ │ │ +00048270: 2061 6c6c 206f 6620 7468 6520 6f72 6967 all of the orig │ │ │ │ +00048280: 696e 616c 2064 6f63 756d 656e 7473 2c0a inal documents,. │ │ │ │ +00048290: 2020 2020 2075 6e6d 6f64 6966 6965 642c unmodified, │ │ │ │ +000482a0: 2061 6e64 206c 6973 7420 7468 656d 2061 and list them a │ │ │ │ +000482b0: 6c6c 2061 7320 496e 7661 7269 616e 7420 ll as Invariant │ │ │ │ +000482c0: 5365 6374 696f 6e73 206f 6620 796f 7572 Sections of your │ │ │ │ +000482d0: 0a20 2020 2020 636f 6d62 696e 6564 2077 . combined w │ │ │ │ +000482e0: 6f72 6b20 696e 2069 7473 206c 6963 656e ork in its licen │ │ │ │ +000482f0: 7365 206e 6f74 6963 652c 2061 6e64 2074 se notice, and t │ │ │ │ +00048300: 6861 7420 796f 7520 7072 6573 6572 7665 hat you preserve │ │ │ │ +00048310: 2061 6c6c 0a20 2020 2020 7468 6569 7220 all. their │ │ │ │ +00048320: 5761 7272 616e 7479 2044 6973 636c 6169 Warranty Disclai │ │ │ │ +00048330: 6d65 7273 2e0a 0a20 2020 2020 5468 6520 mers... The │ │ │ │ +00048340: 636f 6d62 696e 6564 2077 6f72 6b20 6e65 combined work ne │ │ │ │ +00048350: 6564 206f 6e6c 7920 636f 6e74 6169 6e20 ed only contain │ │ │ │ +00048360: 6f6e 6520 636f 7079 206f 6620 7468 6973 one copy of this │ │ │ │ +00048370: 204c 6963 656e 7365 2c20 616e 640a 2020 License, and. │ │ │ │ +00048380: 2020 206d 756c 7469 706c 6520 6964 656e multiple iden │ │ │ │ +00048390: 7469 6361 6c20 496e 7661 7269 616e 7420 tical Invariant │ │ │ │ +000483a0: 5365 6374 696f 6e73 206d 6179 2062 6520 Sections may be │ │ │ │ +000483b0: 7265 706c 6163 6564 2077 6974 6820 6120 replaced with a │ │ │ │ +000483c0: 7369 6e67 6c65 0a20 2020 2020 636f 7079 single. copy │ │ │ │ +000483d0: 2e20 2049 6620 7468 6572 6520 6172 6520 . If there are │ │ │ │ +000483e0: 6d75 6c74 6970 6c65 2049 6e76 6172 6961 multiple Invaria │ │ │ │ +000483f0: 6e74 2053 6563 7469 6f6e 7320 7769 7468 nt Sections with │ │ │ │ +00048400: 2074 6865 2073 616d 6520 6e61 6d65 0a20 the same name. │ │ │ │ +00048410: 2020 2020 6275 7420 6469 6666 6572 656e but differen │ │ │ │ +00048420: 7420 636f 6e74 656e 7473 2c20 6d61 6b65 t contents, make │ │ │ │ +00048430: 2074 6865 2074 6974 6c65 206f 6620 6561 the title of ea │ │ │ │ +00048440: 6368 2073 7563 6820 7365 6374 696f 6e20 ch such section │ │ │ │ +00048450: 756e 6971 7565 0a20 2020 2020 6279 2061 unique. by a │ │ │ │ +00048460: 6464 696e 6720 6174 2074 6865 2065 6e64 dding at the end │ │ │ │ +00048470: 206f 6620 6974 2c20 696e 2070 6172 656e of it, in paren │ │ │ │ +00048480: 7468 6573 6573 2c20 7468 6520 6e61 6d65 theses, the name │ │ │ │ +00048490: 206f 6620 7468 650a 2020 2020 206f 7269 of the. ori │ │ │ │ +000484a0: 6769 6e61 6c20 6175 7468 6f72 206f 7220 ginal author or │ │ │ │ +000484b0: 7075 626c 6973 6865 7220 6f66 2074 6861 publisher of tha │ │ │ │ +000484c0: 7420 7365 6374 696f 6e20 6966 206b 6e6f t section if kno │ │ │ │ +000484d0: 776e 2c20 6f72 2065 6c73 6520 610a 2020 wn, or else a. │ │ │ │ +000484e0: 2020 2075 6e69 7175 6520 6e75 6d62 6572 unique number │ │ │ │ +000484f0: 2e20 204d 616b 6520 7468 6520 7361 6d65 . Make the same │ │ │ │ +00048500: 2061 646a 7573 746d 656e 7420 746f 2074 adjustment to t │ │ │ │ +00048510: 6865 2073 6563 7469 6f6e 2074 6974 6c65 he section title │ │ │ │ +00048520: 7320 696e 0a20 2020 2020 7468 6520 6c69 s in. the li │ │ │ │ +00048530: 7374 206f 6620 496e 7661 7269 616e 7420 st of Invariant │ │ │ │ +00048540: 5365 6374 696f 6e73 2069 6e20 7468 6520 Sections in the │ │ │ │ +00048550: 6c69 6365 6e73 6520 6e6f 7469 6365 206f license notice o │ │ │ │ +00048560: 6620 7468 650a 2020 2020 2063 6f6d 6269 f the. combi │ │ │ │ +00048570: 6e65 6420 776f 726b 2e0a 0a20 2020 2020 ned work... │ │ │ │ +00048580: 496e 2074 6865 2063 6f6d 6269 6e61 7469 In the combinati │ │ │ │ +00048590: 6f6e 2c20 796f 7520 6d75 7374 2063 6f6d on, you must com │ │ │ │ +000485a0: 6269 6e65 2061 6e79 2073 6563 7469 6f6e bine any section │ │ │ │ +000485b0: 7320 456e 7469 746c 6564 0a20 2020 2020 s Entitled. │ │ │ │ +000485c0: 2248 6973 746f 7279 2220 696e 2074 6865 "History" in the │ │ │ │ +000485d0: 2076 6172 696f 7573 206f 7269 6769 6e61 various origina │ │ │ │ +000485e0: 6c20 646f 6375 6d65 6e74 732c 2066 6f72 l documents, for │ │ │ │ +000485f0: 6d69 6e67 206f 6e65 2073 6563 7469 6f6e ming one section │ │ │ │ +00048600: 0a20 2020 2020 456e 7469 746c 6564 2022 . Entitled " │ │ │ │ +00048610: 4869 7374 6f72 7922 3b20 6c69 6b65 7769 History"; likewi │ │ │ │ +00048620: 7365 2063 6f6d 6269 6e65 2061 6e79 2073 se combine any s │ │ │ │ +00048630: 6563 7469 6f6e 7320 456e 7469 746c 6564 ections Entitled │ │ │ │ +00048640: 0a20 2020 2020 2241 636b 6e6f 776c 6564 . "Acknowled │ │ │ │ +00048650: 6765 6d65 6e74 7322 2c20 616e 6420 616e gements", and an │ │ │ │ +00048660: 7920 7365 6374 696f 6e73 2045 6e74 6974 y sections Entit │ │ │ │ +00048670: 6c65 6420 2244 6564 6963 6174 696f 6e73 led "Dedications │ │ │ │ +00048680: 222e 2020 596f 750a 2020 2020 206d 7573 ". You. mus │ │ │ │ +00048690: 7420 6465 6c65 7465 2061 6c6c 2073 6563 t delete all sec │ │ │ │ +000486a0: 7469 6f6e 7320 456e 7469 746c 6564 2022 tions Entitled " │ │ │ │ +000486b0: 456e 646f 7273 656d 656e 7473 2e22 0a0a Endorsements.".. │ │ │ │ +000486c0: 2020 362e 2043 4f4c 4c45 4354 494f 4e53 6. COLLECTIONS │ │ │ │ +000486d0: 204f 4620 444f 4355 4d45 4e54 530a 0a20 OF DOCUMENTS.. │ │ │ │ +000486e0: 2020 2020 596f 7520 6d61 7920 6d61 6b65 You may make │ │ │ │ +000486f0: 2061 2063 6f6c 6c65 6374 696f 6e20 636f a collection co │ │ │ │ +00048700: 6e73 6973 7469 6e67 206f 6620 7468 6520 nsisting of the │ │ │ │ +00048710: 446f 6375 6d65 6e74 2061 6e64 206f 7468 Document and oth │ │ │ │ +00048720: 6572 0a20 2020 2020 646f 6375 6d65 6e74 er. document │ │ │ │ +00048730: 7320 7265 6c65 6173 6564 2075 6e64 6572 s released under │ │ │ │ +00048740: 2074 6869 7320 4c69 6365 6e73 652c 2061 this License, a │ │ │ │ +00048750: 6e64 2072 6570 6c61 6365 2074 6865 2069 nd replace the i │ │ │ │ +00048760: 6e64 6976 6964 7561 6c0a 2020 2020 2063 ndividual. c │ │ │ │ +00048770: 6f70 6965 7320 6f66 2074 6869 7320 4c69 opies of this Li │ │ │ │ +00048780: 6365 6e73 6520 696e 2074 6865 2076 6172 cense in the var │ │ │ │ +00048790: 696f 7573 2064 6f63 756d 656e 7473 2077 ious documents w │ │ │ │ +000487a0: 6974 6820 6120 7369 6e67 6c65 2063 6f70 ith a single cop │ │ │ │ +000487b0: 790a 2020 2020 2074 6861 7420 6973 2069 y. that is i │ │ │ │ +000487c0: 6e63 6c75 6465 6420 696e 2074 6865 2063 ncluded in the c │ │ │ │ +000487d0: 6f6c 6c65 6374 696f 6e2c 2070 726f 7669 ollection, provi │ │ │ │ +000487e0: 6465 6420 7468 6174 2079 6f75 2066 6f6c ded that you fol │ │ │ │ +000487f0: 6c6f 7720 7468 650a 2020 2020 2072 756c low the. rul │ │ │ │ +00048800: 6573 206f 6620 7468 6973 204c 6963 656e es of this Licen │ │ │ │ +00048810: 7365 2066 6f72 2076 6572 6261 7469 6d20 se for verbatim │ │ │ │ +00048820: 636f 7079 696e 6720 6f66 2065 6163 6820 copying of each │ │ │ │ +00048830: 6f66 2074 6865 2064 6f63 756d 656e 7473 of the documents │ │ │ │ +00048840: 0a20 2020 2020 696e 2061 6c6c 206f 7468 . in all oth │ │ │ │ +00048850: 6572 2072 6573 7065 6374 732e 0a0a 2020 er respects... │ │ │ │ +00048860: 2020 2059 6f75 206d 6179 2065 7874 7261 You may extra │ │ │ │ +00048870: 6374 2061 2073 696e 676c 6520 646f 6375 ct a single docu │ │ │ │ +00048880: 6d65 6e74 2066 726f 6d20 7375 6368 2061 ment from such a │ │ │ │ +00048890: 2063 6f6c 6c65 6374 696f 6e2c 2061 6e64 collection, and │ │ │ │ +000488a0: 0a20 2020 2020 6469 7374 7269 6275 7465 . distribute │ │ │ │ +000488b0: 2069 7420 696e 6469 7669 6475 616c 6c79 it individually │ │ │ │ +000488c0: 2075 6e64 6572 2074 6869 7320 4c69 6365 under this Lice │ │ │ │ +000488d0: 6e73 652c 2070 726f 7669 6465 6420 796f nse, provided yo │ │ │ │ +000488e0: 7520 696e 7365 7274 0a20 2020 2020 6120 u insert. a │ │ │ │ +000488f0: 636f 7079 206f 6620 7468 6973 204c 6963 copy of this Lic │ │ │ │ +00048900: 656e 7365 2069 6e74 6f20 7468 6520 6578 ense into the ex │ │ │ │ +00048910: 7472 6163 7465 6420 646f 6375 6d65 6e74 tracted document │ │ │ │ +00048920: 2c20 616e 6420 666f 6c6c 6f77 2074 6869 , and follow thi │ │ │ │ +00048930: 730a 2020 2020 204c 6963 656e 7365 2069 s. License i │ │ │ │ +00048940: 6e20 616c 6c20 6f74 6865 7220 7265 7370 n all other resp │ │ │ │ +00048950: 6563 7473 2072 6567 6172 6469 6e67 2076 ects regarding v │ │ │ │ +00048960: 6572 6261 7469 6d20 636f 7079 696e 6720 erbatim copying │ │ │ │ +00048970: 6f66 2074 6861 740a 2020 2020 2064 6f63 of that. doc │ │ │ │ +00048980: 756d 656e 742e 0a0a 2020 372e 2041 4747 ument... 7. AGG │ │ │ │ +00048990: 5245 4741 5449 4f4e 2057 4954 4820 494e REGATION WITH IN │ │ │ │ +000489a0: 4445 5045 4e44 454e 5420 574f 524b 530a DEPENDENT WORKS. │ │ │ │ +000489b0: 0a20 2020 2020 4120 636f 6d70 696c 6174 . A compilat │ │ │ │ +000489c0: 696f 6e20 6f66 2074 6865 2044 6f63 756d ion of the Docum │ │ │ │ +000489d0: 656e 7420 6f72 2069 7473 2064 6572 6976 ent or its deriv │ │ │ │ +000489e0: 6174 6976 6573 2077 6974 6820 6f74 6865 atives with othe │ │ │ │ +000489f0: 720a 2020 2020 2073 6570 6172 6174 6520 r. separate │ │ │ │ +00048a00: 616e 6420 696e 6465 7065 6e64 656e 7420 and independent │ │ │ │ +00048a10: 646f 6375 6d65 6e74 7320 6f72 2077 6f72 documents or wor │ │ │ │ +00048a20: 6b73 2c20 696e 206f 7220 6f6e 2061 2076 ks, in or on a v │ │ │ │ +00048a30: 6f6c 756d 6520 6f66 2061 0a20 2020 2020 olume of a. │ │ │ │ +00048a40: 7374 6f72 6167 6520 6f72 2064 6973 7472 storage or distr │ │ │ │ +00048a50: 6962 7574 696f 6e20 6d65 6469 756d 2c20 ibution medium, │ │ │ │ +00048a60: 6973 2063 616c 6c65 6420 616e 2022 6167 is called an "ag │ │ │ │ +00048a70: 6772 6567 6174 6522 2069 6620 7468 650a gregate" if the. │ │ │ │ +00048a80: 2020 2020 2063 6f70 7972 6967 6874 2072 copyright r │ │ │ │ +00048a90: 6573 756c 7469 6e67 2066 726f 6d20 7468 esulting from th │ │ │ │ +00048aa0: 6520 636f 6d70 696c 6174 696f 6e20 6973 e compilation is │ │ │ │ +00048ab0: 206e 6f74 2075 7365 6420 746f 206c 696d not used to lim │ │ │ │ +00048ac0: 6974 2074 6865 0a20 2020 2020 6c65 6761 it the. lega │ │ │ │ +00048ad0: 6c20 7269 6768 7473 206f 6620 7468 6520 l rights of the │ │ │ │ +00048ae0: 636f 6d70 696c 6174 696f 6e27 7320 7573 compilation's us │ │ │ │ +00048af0: 6572 7320 6265 796f 6e64 2077 6861 7420 ers beyond what │ │ │ │ +00048b00: 7468 6520 696e 6469 7669 6475 616c 0a20 the individual. │ │ │ │ +00048b10: 2020 2020 776f 726b 7320 7065 726d 6974 works permit │ │ │ │ +00048b20: 2e20 2057 6865 6e20 7468 6520 446f 6375 . When the Docu │ │ │ │ +00048b30: 6d65 6e74 2069 7320 696e 636c 7564 6564 ment is included │ │ │ │ +00048b40: 2069 6e20 616e 2061 6767 7265 6761 7465 in an aggregate │ │ │ │ +00048b50: 2c20 7468 6973 0a20 2020 2020 4c69 6365 , this. Lice │ │ │ │ +00048b60: 6e73 6520 646f 6573 206e 6f74 2061 7070 nse does not app │ │ │ │ +00048b70: 6c79 2074 6f20 7468 6520 6f74 6865 7220 ly to the other │ │ │ │ +00048b80: 776f 726b 7320 696e 2074 6865 2061 6767 works in the agg │ │ │ │ +00048b90: 7265 6761 7465 2077 6869 6368 0a20 2020 regate which. │ │ │ │ +00048ba0: 2020 6172 6520 6e6f 7420 7468 656d 7365 are not themse │ │ │ │ +00048bb0: 6c76 6573 2064 6572 6976 6174 6976 6520 lves derivative │ │ │ │ +00048bc0: 776f 726b 7320 6f66 2074 6865 2044 6f63 works of the Doc │ │ │ │ +00048bd0: 756d 656e 742e 0a0a 2020 2020 2049 6620 ument... If │ │ │ │ +00048be0: 7468 6520 436f 7665 7220 5465 7874 2072 the Cover Text r │ │ │ │ +00048bf0: 6571 7569 7265 6d65 6e74 206f 6620 7365 equirement of se │ │ │ │ +00048c00: 6374 696f 6e20 3320 6973 2061 7070 6c69 ction 3 is appli │ │ │ │ +00048c10: 6361 626c 6520 746f 2074 6865 7365 0a20 cable to these. │ │ │ │ +00048c20: 2020 2020 636f 7069 6573 206f 6620 7468 copies of th │ │ │ │ +00048c30: 6520 446f 6375 6d65 6e74 2c20 7468 656e e Document, then │ │ │ │ +00048c40: 2069 6620 7468 6520 446f 6375 6d65 6e74 if the Document │ │ │ │ +00048c50: 2069 7320 6c65 7373 2074 6861 6e20 6f6e is less than on │ │ │ │ +00048c60: 6520 6861 6c66 0a20 2020 2020 6f66 2074 e half. of t │ │ │ │ +00048c70: 6865 2065 6e74 6972 6520 6167 6772 6567 he entire aggreg │ │ │ │ +00048c80: 6174 652c 2074 6865 2044 6f63 756d 656e ate, the Documen │ │ │ │ +00048c90: 7427 7320 436f 7665 7220 5465 7874 7320 t's Cover Texts │ │ │ │ +00048ca0: 6d61 7920 6265 2070 6c61 6365 640a 2020 may be placed. │ │ │ │ +00048cb0: 2020 206f 6e20 636f 7665 7273 2074 6861 on covers tha │ │ │ │ +00048cc0: 7420 6272 6163 6b65 7420 7468 6520 446f t bracket the Do │ │ │ │ +00048cd0: 6375 6d65 6e74 2077 6974 6869 6e20 7468 cument within th │ │ │ │ +00048ce0: 6520 6167 6772 6567 6174 652c 206f 7220 e aggregate, or │ │ │ │ +00048cf0: 7468 650a 2020 2020 2065 6c65 6374 726f the. electro │ │ │ │ +00048d00: 6e69 6320 6571 7569 7661 6c65 6e74 206f nic equivalent o │ │ │ │ +00048d10: 6620 636f 7665 7273 2069 6620 7468 6520 f covers if the │ │ │ │ +00048d20: 446f 6375 6d65 6e74 2069 7320 696e 2065 Document is in e │ │ │ │ +00048d30: 6c65 6374 726f 6e69 630a 2020 2020 2066 lectronic. f │ │ │ │ +00048d40: 6f72 6d2e 2020 4f74 6865 7277 6973 6520 orm. Otherwise │ │ │ │ +00048d50: 7468 6579 206d 7573 7420 6170 7065 6172 they must appear │ │ │ │ +00048d60: 206f 6e20 7072 696e 7465 6420 636f 7665 on printed cove │ │ │ │ +00048d70: 7273 2074 6861 7420 6272 6163 6b65 740a rs that bracket. │ │ │ │ +00048d80: 2020 2020 2074 6865 2077 686f 6c65 2061 the whole a │ │ │ │ +00048d90: 6767 7265 6761 7465 2e0a 0a20 2038 2e20 ggregate... 8. │ │ │ │ +00048da0: 5452 414e 534c 4154 494f 4e0a 0a20 2020 TRANSLATION.. │ │ │ │ +00048db0: 2020 5472 616e 736c 6174 696f 6e20 6973 Translation is │ │ │ │ +00048dc0: 2063 6f6e 7369 6465 7265 6420 6120 6b69 considered a ki │ │ │ │ +00048dd0: 6e64 206f 6620 6d6f 6469 6669 6361 7469 nd of modificati │ │ │ │ +00048de0: 6f6e 2c20 736f 2079 6f75 206d 6179 0a20 on, so you may. │ │ │ │ +00048df0: 2020 2020 6469 7374 7269 6275 7465 2074 distribute t │ │ │ │ +00048e00: 7261 6e73 6c61 7469 6f6e 7320 6f66 2074 ranslations of t │ │ │ │ +00048e10: 6865 2044 6f63 756d 656e 7420 756e 6465 he Document unde │ │ │ │ +00048e20: 7220 7468 6520 7465 726d 7320 6f66 2073 r the terms of s │ │ │ │ +00048e30: 6563 7469 6f6e 0a20 2020 2020 342e 2020 ection. 4. │ │ │ │ +00048e40: 5265 706c 6163 696e 6720 496e 7661 7269 Replacing Invari │ │ │ │ +00048e50: 616e 7420 5365 6374 696f 6e73 2077 6974 ant Sections wit │ │ │ │ +00048e60: 6820 7472 616e 736c 6174 696f 6e73 2072 h translations r │ │ │ │ +00048e70: 6571 7569 7265 7320 7370 6563 6961 6c0a equires special. │ │ │ │ +00048e80: 2020 2020 2070 6572 6d69 7373 696f 6e20 permission │ │ │ │ +00048e90: 6672 6f6d 2074 6865 6972 2063 6f70 7972 from their copyr │ │ │ │ +00048ea0: 6967 6874 2068 6f6c 6465 7273 2c20 6275 ight holders, bu │ │ │ │ +00048eb0: 7420 796f 7520 6d61 7920 696e 636c 7564 t you may includ │ │ │ │ +00048ec0: 650a 2020 2020 2074 7261 6e73 6c61 7469 e. translati │ │ │ │ +00048ed0: 6f6e 7320 6f66 2073 6f6d 6520 6f72 2061 ons of some or a │ │ │ │ +00048ee0: 6c6c 2049 6e76 6172 6961 6e74 2053 6563 ll Invariant Sec │ │ │ │ +00048ef0: 7469 6f6e 7320 696e 2061 6464 6974 696f tions in additio │ │ │ │ +00048f00: 6e20 746f 2074 6865 0a20 2020 2020 6f72 n to the. or │ │ │ │ +00048f10: 6967 696e 616c 2076 6572 7369 6f6e 7320 iginal versions │ │ │ │ +00048f20: 6f66 2074 6865 7365 2049 6e76 6172 6961 of these Invaria │ │ │ │ +00048f30: 6e74 2053 6563 7469 6f6e 732e 2020 596f nt Sections. Yo │ │ │ │ +00048f40: 7520 6d61 7920 696e 636c 7564 6520 610a u may include a. │ │ │ │ +00048f50: 2020 2020 2074 7261 6e73 6c61 7469 6f6e translation │ │ │ │ +00048f60: 206f 6620 7468 6973 204c 6963 656e 7365 of this License │ │ │ │ +00048f70: 2c20 616e 6420 616c 6c20 7468 6520 6c69 , and all the li │ │ │ │ +00048f80: 6365 6e73 6520 6e6f 7469 6365 7320 696e cense notices in │ │ │ │ +00048f90: 2074 6865 0a20 2020 2020 446f 6375 6d65 the. Docume │ │ │ │ +00048fa0: 6e74 2c20 616e 6420 616e 7920 5761 7272 nt, and any Warr │ │ │ │ +00048fb0: 616e 7479 2044 6973 636c 6169 6d65 7273 anty Disclaimers │ │ │ │ +00048fc0: 2c20 7072 6f76 6964 6564 2074 6861 7420 , provided that │ │ │ │ +00048fd0: 796f 7520 616c 736f 0a20 2020 2020 696e you also. in │ │ │ │ +00048fe0: 636c 7564 6520 7468 6520 6f72 6967 696e clude the origin │ │ │ │ +00048ff0: 616c 2045 6e67 6c69 7368 2076 6572 7369 al English versi │ │ │ │ +00049000: 6f6e 206f 6620 7468 6973 204c 6963 656e on of this Licen │ │ │ │ +00049010: 7365 2061 6e64 2074 6865 0a20 2020 2020 se and the. │ │ │ │ +00049020: 6f72 6967 696e 616c 2076 6572 7369 6f6e original version │ │ │ │ +00049030: 7320 6f66 2074 686f 7365 206e 6f74 6963 s of those notic │ │ │ │ +00049040: 6573 2061 6e64 2064 6973 636c 6169 6d65 es and disclaime │ │ │ │ +00049050: 7273 2e20 2049 6e20 6361 7365 206f 6620 rs. In case of │ │ │ │ +00049060: 610a 2020 2020 2064 6973 6167 7265 656d a. disagreem │ │ │ │ +00049070: 656e 7420 6265 7477 6565 6e20 7468 6520 ent between the │ │ │ │ +00049080: 7472 616e 736c 6174 696f 6e20 616e 6420 translation and │ │ │ │ +00049090: 7468 6520 6f72 6967 696e 616c 2076 6572 the original ver │ │ │ │ +000490a0: 7369 6f6e 206f 660a 2020 2020 2074 6869 sion of. thi │ │ │ │ +000490b0: 7320 4c69 6365 6e73 6520 6f72 2061 206e s License or a n │ │ │ │ +000490c0: 6f74 6963 6520 6f72 2064 6973 636c 6169 otice or disclai │ │ │ │ +000490d0: 6d65 722c 2074 6865 206f 7269 6769 6e61 mer, the origina │ │ │ │ +000490e0: 6c20 7665 7273 696f 6e20 7769 6c6c 0a20 l version will. │ │ │ │ +000490f0: 2020 2020 7072 6576 6169 6c2e 0a0a 2020 prevail... │ │ │ │ +00049100: 2020 2049 6620 6120 7365 6374 696f 6e20 If a section │ │ │ │ +00049110: 696e 2074 6865 2044 6f63 756d 656e 7420 in the Document │ │ │ │ +00049120: 6973 2045 6e74 6974 6c65 6420 2241 636b is Entitled "Ack │ │ │ │ +00049130: 6e6f 776c 6564 6765 6d65 6e74 7322 2c0a nowledgements",. │ │ │ │ +00049140: 2020 2020 2022 4465 6469 6361 7469 6f6e "Dedication │ │ │ │ +00049150: 7322 2c20 6f72 2022 4869 7374 6f72 7922 s", or "History" │ │ │ │ +00049160: 2c20 7468 6520 7265 7175 6972 656d 656e , the requiremen │ │ │ │ +00049170: 7420 2873 6563 7469 6f6e 2034 2920 746f t (section 4) to │ │ │ │ +00049180: 0a20 2020 2020 5072 6573 6572 7665 2069 . Preserve i │ │ │ │ +00049190: 7473 2054 6974 6c65 2028 7365 6374 696f ts Title (sectio │ │ │ │ +000491a0: 6e20 3129 2077 696c 6c20 7479 7069 6361 n 1) will typica │ │ │ │ +000491b0: 6c6c 7920 7265 7175 6972 6520 6368 616e lly require chan │ │ │ │ +000491c0: 6769 6e67 2074 6865 0a20 2020 2020 6163 ging the. ac │ │ │ │ +000491d0: 7475 616c 2074 6974 6c65 2e0a 0a20 2039 tual title... 9 │ │ │ │ +000491e0: 2e20 5445 524d 494e 4154 494f 4e0a 0a20 . TERMINATION.. │ │ │ │ +000491f0: 2020 2020 596f 7520 6d61 7920 6e6f 7420 You may not │ │ │ │ +00049200: 636f 7079 2c20 6d6f 6469 6679 2c20 7375 copy, modify, su │ │ │ │ +00049210: 626c 6963 656e 7365 2c20 6f72 2064 6973 blicense, or dis │ │ │ │ +00049220: 7472 6962 7574 6520 7468 6520 446f 6375 tribute the Docu │ │ │ │ +00049230: 6d65 6e74 0a20 2020 2020 6578 6365 7074 ment. except │ │ │ │ +00049240: 2061 7320 6578 7072 6573 736c 7920 7072 as expressly pr │ │ │ │ +00049250: 6f76 6964 6564 2066 6f72 2075 6e64 6572 ovided for under │ │ │ │ +00049260: 2074 6869 7320 4c69 6365 6e73 652e 2020 this License. │ │ │ │ +00049270: 416e 7920 6f74 6865 720a 2020 2020 2061 Any other. a │ │ │ │ +00049280: 7474 656d 7074 2074 6f20 636f 7079 2c20 ttempt to copy, │ │ │ │ +00049290: 6d6f 6469 6679 2c20 7375 626c 6963 656e modify, sublicen │ │ │ │ +000492a0: 7365 206f 7220 6469 7374 7269 6275 7465 se or distribute │ │ │ │ +000492b0: 2074 6865 2044 6f63 756d 656e 7420 6973 the Document is │ │ │ │ +000492c0: 0a20 2020 2020 766f 6964 2c20 616e 6420 . void, and │ │ │ │ +000492d0: 7769 6c6c 2061 7574 6f6d 6174 6963 616c will automatical │ │ │ │ +000492e0: 6c79 2074 6572 6d69 6e61 7465 2079 6f75 ly terminate you │ │ │ │ +000492f0: 7220 7269 6768 7473 2075 6e64 6572 2074 r rights under t │ │ │ │ +00049300: 6869 730a 2020 2020 204c 6963 656e 7365 his. License │ │ │ │ +00049310: 2e20 2048 6f77 6576 6572 2c20 7061 7274 . However, part │ │ │ │ +00049320: 6965 7320 7768 6f20 6861 7665 2072 6563 ies who have rec │ │ │ │ +00049330: 6569 7665 6420 636f 7069 6573 2c20 6f72 eived copies, or │ │ │ │ +00049340: 2072 6967 6874 732c 0a20 2020 2020 6672 rights,. fr │ │ │ │ +00049350: 6f6d 2079 6f75 2075 6e64 6572 2074 6869 om you under thi │ │ │ │ +00049360: 7320 4c69 6365 6e73 6520 7769 6c6c 206e s License will n │ │ │ │ +00049370: 6f74 2068 6176 6520 7468 6569 7220 6c69 ot have their li │ │ │ │ +00049380: 6365 6e73 6573 2074 6572 6d69 6e61 7465 censes terminate │ │ │ │ +00049390: 640a 2020 2020 2073 6f20 6c6f 6e67 2061 d. so long a │ │ │ │ +000493a0: 7320 7375 6368 2070 6172 7469 6573 2072 s such parties r │ │ │ │ +000493b0: 656d 6169 6e20 696e 2066 756c 6c20 636f emain in full co │ │ │ │ +000493c0: 6d70 6c69 616e 6365 2e0a 0a20 2031 302e mpliance... 10. │ │ │ │ +000493d0: 2046 5554 5552 4520 5245 5649 5349 4f4e FUTURE REVISION │ │ │ │ +000493e0: 5320 4f46 2054 4849 5320 4c49 4345 4e53 S OF THIS LICENS │ │ │ │ +000493f0: 450a 0a20 2020 2020 5468 6520 4672 6565 E.. The Free │ │ │ │ +00049400: 2053 6f66 7477 6172 6520 466f 756e 6461 Software Founda │ │ │ │ +00049410: 7469 6f6e 206d 6179 2070 7562 6c69 7368 tion may publish │ │ │ │ +00049420: 206e 6577 2c20 7265 7669 7365 6420 7665 new, revised ve │ │ │ │ +00049430: 7273 696f 6e73 206f 660a 2020 2020 2074 rsions of. t │ │ │ │ +00049440: 6865 2047 4e55 2046 7265 6520 446f 6375 he GNU Free Docu │ │ │ │ +00049450: 6d65 6e74 6174 696f 6e20 4c69 6365 6e73 mentation Licens │ │ │ │ +00049460: 6520 6672 6f6d 2074 696d 6520 746f 2074 e from time to t │ │ │ │ +00049470: 696d 652e 2020 5375 6368 206e 6577 0a20 ime. Such new. │ │ │ │ +00049480: 2020 2020 7665 7273 696f 6e73 2077 696c versions wil │ │ │ │ +00049490: 6c20 6265 2073 696d 696c 6172 2069 6e20 l be similar in │ │ │ │ +000494a0: 7370 6972 6974 2074 6f20 7468 6520 7072 spirit to the pr │ │ │ │ +000494b0: 6573 656e 7420 7665 7273 696f 6e2c 2062 esent version, b │ │ │ │ +000494c0: 7574 206d 6179 0a20 2020 2020 6469 6666 ut may. diff │ │ │ │ +000494d0: 6572 2069 6e20 6465 7461 696c 2074 6f20 er in detail to │ │ │ │ +000494e0: 6164 6472 6573 7320 6e65 7720 7072 6f62 address new prob │ │ │ │ +000494f0: 6c65 6d73 206f 7220 636f 6e63 6572 6e73 lems or concerns │ │ │ │ +00049500: 2e20 2053 6565 0a20 2020 2020 3c68 7474 . See. ... │ │ │ │ +00049530: 2020 4561 6368 2076 6572 7369 6f6e 206f Each version o │ │ │ │ +00049540: 6620 7468 6520 4c69 6365 6e73 6520 6973 f the License is │ │ │ │ +00049550: 2067 6976 656e 2061 2064 6973 7469 6e67 given a disting │ │ │ │ +00049560: 7569 7368 696e 6720 7665 7273 696f 6e0a uishing version. │ │ │ │ +00049570: 2020 2020 206e 756d 6265 722e 2020 4966 number. If │ │ │ │ +00049580: 2074 6865 2044 6f63 756d 656e 7420 7370 the Document sp │ │ │ │ +00049590: 6563 6966 6965 7320 7468 6174 2061 2070 ecifies that a p │ │ │ │ +000495a0: 6172 7469 6375 6c61 7220 6e75 6d62 6572 articular number │ │ │ │ +000495b0: 6564 0a20 2020 2020 7665 7273 696f 6e20 ed. version │ │ │ │ +000495c0: 6f66 2074 6869 7320 4c69 6365 6e73 6520 of this License │ │ │ │ +000495d0: 226f 7220 616e 7920 6c61 7465 7220 7665 "or any later ve │ │ │ │ +000495e0: 7273 696f 6e22 2061 7070 6c69 6573 2074 rsion" applies t │ │ │ │ +000495f0: 6f20 6974 2c20 796f 750a 2020 2020 2068 o it, you. h │ │ │ │ +00049600: 6176 6520 7468 6520 6f70 7469 6f6e 206f ave the option o │ │ │ │ +00049610: 6620 666f 6c6c 6f77 696e 6720 7468 6520 f following the │ │ │ │ +00049620: 7465 726d 7320 616e 6420 636f 6e64 6974 terms and condit │ │ │ │ +00049630: 696f 6e73 2065 6974 6865 7220 6f66 0a20 ions either of. │ │ │ │ +00049640: 2020 2020 7468 6174 2073 7065 6369 6669 that specifi │ │ │ │ +00049650: 6564 2076 6572 7369 6f6e 206f 7220 6f66 ed version or of │ │ │ │ +00049660: 2061 6e79 206c 6174 6572 2076 6572 7369 any later versi │ │ │ │ +00049670: 6f6e 2074 6861 7420 6861 7320 6265 656e on that has been │ │ │ │ +00049680: 0a20 2020 2020 7075 626c 6973 6865 6420 . published │ │ │ │ +00049690: 286e 6f74 2061 7320 6120 6472 6166 7429 (not as a draft) │ │ │ │ +000496a0: 2062 7920 7468 6520 4672 6565 2053 6f66 by the Free Sof │ │ │ │ +000496b0: 7477 6172 6520 466f 756e 6461 7469 6f6e tware Foundation │ │ │ │ +000496c0: 2e20 2049 6620 7468 650a 2020 2020 2044 . If the. D │ │ │ │ +000496d0: 6f63 756d 656e 7420 646f 6573 206e 6f74 ocument does not │ │ │ │ +000496e0: 2073 7065 6369 6679 2061 2076 6572 7369 specify a versi │ │ │ │ +000496f0: 6f6e 206e 756d 6265 7220 6f66 2074 6869 on number of thi │ │ │ │ +00049700: 7320 4c69 6365 6e73 652c 2079 6f75 206d s License, you m │ │ │ │ +00049710: 6179 0a20 2020 2020 6368 6f6f 7365 2061 ay. choose a │ │ │ │ +00049720: 6e79 2076 6572 7369 6f6e 2065 7665 7220 ny version ever │ │ │ │ +00049730: 7075 626c 6973 6865 6420 286e 6f74 2061 published (not a │ │ │ │ +00049740: 7320 6120 6472 6166 7429 2062 7920 7468 s a draft) by th │ │ │ │ +00049750: 6520 4672 6565 0a20 2020 2020 536f 6674 e Free. Soft │ │ │ │ +00049760: 7761 7265 2046 6f75 6e64 6174 696f 6e2e ware Foundation. │ │ │ │ +00049770: 0a0a 442e 312e 3120 4144 4445 4e44 554d ..D.1.1 ADDENDUM │ │ │ │ +00049780: 3a20 486f 7720 746f 2075 7365 2074 6869 : How to use thi │ │ │ │ +00049790: 7320 4c69 6365 6e73 6520 666f 7220 796f s License for yo │ │ │ │ +000497a0: 7572 2064 6f63 756d 656e 7473 0a2d 2d2d ur documents.--- │ │ │ │ 000497b0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ 000497c0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ 000497d0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ -000497e0: 2d2d 2d0a 0a54 6f20 7573 6520 7468 6973 ---..To use this │ │ │ │ -000497f0: 204c 6963 656e 7365 2069 6e20 6120 646f License in a do │ │ │ │ -00049800: 6375 6d65 6e74 2079 6f75 2068 6176 6520 cument you have │ │ │ │ -00049810: 7772 6974 7465 6e2c 2069 6e63 6c75 6465 written, include │ │ │ │ -00049820: 2061 2063 6f70 7920 6f66 0a74 6865 204c a copy of.the L │ │ │ │ -00049830: 6963 656e 7365 2069 6e20 7468 6520 646f icense in the do │ │ │ │ -00049840: 6375 6d65 6e74 2061 6e64 2070 7574 2074 cument and put t │ │ │ │ -00049850: 6865 2066 6f6c 6c6f 7769 6e67 2063 6f70 he following cop │ │ │ │ -00049860: 7972 6967 6874 2061 6e64 206c 6963 656e yright and licen │ │ │ │ -00049870: 7365 0a6e 6f74 6963 6573 206a 7573 7420 se.notices just │ │ │ │ -00049880: 6166 7465 7220 7468 6520 7469 746c 6520 after the title │ │ │ │ -00049890: 7061 6765 3a0a 0a20 2020 2020 2020 436f page:.. Co │ │ │ │ -000498a0: 7079 7269 6768 7420 2843 2920 2059 4541 pyright (C) YEA │ │ │ │ -000498b0: 5220 2059 4f55 5220 4e41 4d45 2e0a 2020 R YOUR NAME.. │ │ │ │ -000498c0: 2020 2020 2050 6572 6d69 7373 696f 6e20 Permission │ │ │ │ -000498d0: 6973 2067 7261 6e74 6564 2074 6f20 636f is granted to co │ │ │ │ -000498e0: 7079 2c20 6469 7374 7269 6275 7465 2061 py, distribute a │ │ │ │ -000498f0: 6e64 2f6f 7220 6d6f 6469 6679 2074 6869 nd/or modify thi │ │ │ │ -00049900: 7320 646f 6375 6d65 6e74 0a20 2020 2020 s document. │ │ │ │ -00049910: 2020 756e 6465 7220 7468 6520 7465 726d under the term │ │ │ │ -00049920: 7320 6f66 2074 6865 2047 4e55 2046 7265 s of the GNU Fre │ │ │ │ -00049930: 6520 446f 6375 6d65 6e74 6174 696f 6e20 e Documentation │ │ │ │ -00049940: 4c69 6365 6e73 652c 2056 6572 7369 6f6e License, Version │ │ │ │ -00049950: 2031 2e32 0a20 2020 2020 2020 6f72 2061 1.2. or a │ │ │ │ -00049960: 6e79 206c 6174 6572 2076 6572 7369 6f6e ny later version │ │ │ │ -00049970: 2070 7562 6c69 7368 6564 2062 7920 7468 published by th │ │ │ │ -00049980: 6520 4672 6565 2053 6f66 7477 6172 6520 e Free Software │ │ │ │ -00049990: 466f 756e 6461 7469 6f6e 3b0a 2020 2020 Foundation;. │ │ │ │ -000499a0: 2020 2077 6974 6820 6e6f 2049 6e76 6172 with no Invar │ │ │ │ -000499b0: 6961 6e74 2053 6563 7469 6f6e 732c 206e iant Sections, n │ │ │ │ -000499c0: 6f20 4672 6f6e 742d 436f 7665 7220 5465 o Front-Cover Te │ │ │ │ -000499d0: 7874 732c 2061 6e64 206e 6f20 4261 636b xts, and no Back │ │ │ │ -000499e0: 2d43 6f76 6572 0a20 2020 2020 2020 5465 -Cover. Te │ │ │ │ -000499f0: 7874 732e 2020 4120 636f 7079 206f 6620 xts. A copy of │ │ │ │ -00049a00: 7468 6520 6c69 6365 6e73 6520 6973 2069 the license is i │ │ │ │ -00049a10: 6e63 6c75 6465 6420 696e 2074 6865 2073 ncluded in the s │ │ │ │ -00049a20: 6563 7469 6f6e 2065 6e74 6974 6c65 6420 ection entitled │ │ │ │ -00049a30: 6060 474e 550a 2020 2020 2020 2046 7265 ``GNU. Fre │ │ │ │ -00049a40: 6520 446f 6375 6d65 6e74 6174 696f 6e20 e Documentation │ │ │ │ -00049a50: 4c69 6365 6e73 6527 272e 0a0a 2020 2049 License''... I │ │ │ │ -00049a60: 6620 796f 7520 6861 7665 2049 6e76 6172 f you have Invar │ │ │ │ -00049a70: 6961 6e74 2053 6563 7469 6f6e 732c 2046 iant Sections, F │ │ │ │ -00049a80: 726f 6e74 2d43 6f76 6572 2054 6578 7473 ront-Cover Texts │ │ │ │ -00049a90: 2061 6e64 2042 6163 6b2d 436f 7665 720a and Back-Cover. │ │ │ │ -00049aa0: 5465 7874 732c 2072 6570 6c61 6365 2074 Texts, replace t │ │ │ │ -00049ab0: 6865 2022 7769 7468 2e2e 2e54 6578 7473 he "with...Texts │ │ │ │ -00049ac0: 2e22 2020 6c69 6e65 2077 6974 6820 7468 ." line with th │ │ │ │ -00049ad0: 6973 3a0a 0a20 2020 2020 2020 2020 7769 is:.. wi │ │ │ │ -00049ae0: 7468 2074 6865 2049 6e76 6172 6961 6e74 th the Invariant │ │ │ │ -00049af0: 2053 6563 7469 6f6e 7320 6265 696e 6720 Sections being │ │ │ │ -00049b00: 4c49 5354 2054 4845 4952 2054 4954 4c45 LIST THEIR TITLE │ │ │ │ -00049b10: 532c 2077 6974 680a 2020 2020 2020 2020 S, with. │ │ │ │ -00049b20: 2074 6865 2046 726f 6e74 2d43 6f76 6572 the Front-Cover │ │ │ │ -00049b30: 2054 6578 7473 2062 6569 6e67 204c 4953 Texts being LIS │ │ │ │ -00049b40: 542c 2061 6e64 2077 6974 6820 7468 6520 T, and with the │ │ │ │ -00049b50: 4261 636b 2d43 6f76 6572 2054 6578 7473 Back-Cover Texts │ │ │ │ -00049b60: 0a20 2020 2020 2020 2020 6265 696e 6720 . being │ │ │ │ -00049b70: 4c49 5354 2e0a 0a20 2020 4966 2079 6f75 LIST... If you │ │ │ │ -00049b80: 2068 6176 6520 496e 7661 7269 616e 7420 have Invariant │ │ │ │ -00049b90: 5365 6374 696f 6e73 2077 6974 686f 7574 Sections without │ │ │ │ -00049ba0: 2043 6f76 6572 2054 6578 7473 2c20 6f72 Cover Texts, or │ │ │ │ -00049bb0: 2073 6f6d 6520 6f74 6865 720a 636f 6d62 some other.comb │ │ │ │ -00049bc0: 696e 6174 696f 6e20 6f66 2074 6865 2074 ination of the t │ │ │ │ -00049bd0: 6872 6565 2c20 6d65 7267 6520 7468 6f73 hree, merge thos │ │ │ │ -00049be0: 6520 7477 6f20 616c 7465 726e 6174 6976 e two alternativ │ │ │ │ -00049bf0: 6573 2074 6f20 7375 6974 2074 6865 0a73 es to suit the.s │ │ │ │ -00049c00: 6974 7561 7469 6f6e 2e0a 0a20 2020 4966 ituation... If │ │ │ │ -00049c10: 2079 6f75 7220 646f 6375 6d65 6e74 2063 your document c │ │ │ │ -00049c20: 6f6e 7461 696e 7320 6e6f 6e74 7269 7669 ontains nontrivi │ │ │ │ -00049c30: 616c 2065 7861 6d70 6c65 7320 6f66 2070 al examples of p │ │ │ │ -00049c40: 726f 6772 616d 2063 6f64 652c 2077 650a rogram code, we. │ │ │ │ -00049c50: 7265 636f 6d6d 656e 6420 7265 6c65 6173 recommend releas │ │ │ │ -00049c60: 696e 6720 7468 6573 6520 6578 616d 706c ing these exampl │ │ │ │ -00049c70: 6573 2069 6e20 7061 7261 6c6c 656c 2075 es in parallel u │ │ │ │ -00049c80: 6e64 6572 2079 6f75 7220 6368 6f69 6365 nder your choice │ │ │ │ -00049c90: 206f 6620 6672 6565 0a73 6f66 7477 6172 of free.softwar │ │ │ │ -00049ca0: 6520 6c69 6365 6e73 652c 2073 7563 6820 e license, such │ │ │ │ -00049cb0: 6173 2074 6865 2047 4e55 2047 656e 6572 as the GNU Gener │ │ │ │ -00049cc0: 616c 2050 7562 6c69 6320 4c69 6365 6e73 al Public Licens │ │ │ │ -00049cd0: 652c 2074 6f20 7065 726d 6974 0a74 6865 e, to permit.the │ │ │ │ -00049ce0: 6972 2075 7365 2069 6e20 6672 6565 2073 ir use in free s │ │ │ │ -00049cf0: 6f66 7477 6172 652e 0a0a oftware... │ │ │ │ +000497e0: 2d2d 2d2d 2d2d 2d0a 0a54 6f20 7573 6520 -------..To use │ │ │ │ +000497f0: 7468 6973 204c 6963 656e 7365 2069 6e20 this License in │ │ │ │ +00049800: 6120 646f 6375 6d65 6e74 2079 6f75 2068 a document you h │ │ │ │ +00049810: 6176 6520 7772 6974 7465 6e2c 2069 6e63 ave written, inc │ │ │ │ +00049820: 6c75 6465 2061 2063 6f70 7920 6f66 0a74 lude a copy of.t │ │ │ │ +00049830: 6865 204c 6963 656e 7365 2069 6e20 7468 he License in th │ │ │ │ +00049840: 6520 646f 6375 6d65 6e74 2061 6e64 2070 e document and p │ │ │ │ +00049850: 7574 2074 6865 2066 6f6c 6c6f 7769 6e67 ut the following │ │ │ │ +00049860: 2063 6f70 7972 6967 6874 2061 6e64 206c copyright and l │ │ │ │ +00049870: 6963 656e 7365 0a6e 6f74 6963 6573 206a icense.notices j │ │ │ │ +00049880: 7573 7420 6166 7465 7220 7468 6520 7469 ust after the ti │ │ │ │ +00049890: 746c 6520 7061 6765 3a0a 0a20 2020 2020 tle page:.. │ │ │ │ +000498a0: 2020 436f 7079 7269 6768 7420 2843 2920 Copyright (C) │ │ │ │ +000498b0: 2059 4541 5220 2059 4f55 5220 4e41 4d45 YEAR YOUR NAME │ │ │ │ +000498c0: 2e0a 2020 2020 2020 2050 6572 6d69 7373 .. Permiss │ │ │ │ +000498d0: 696f 6e20 6973 2067 7261 6e74 6564 2074 ion is granted t │ │ │ │ +000498e0: 6f20 636f 7079 2c20 6469 7374 7269 6275 o copy, distribu │ │ │ │ +000498f0: 7465 2061 6e64 2f6f 7220 6d6f 6469 6679 te and/or modify │ │ │ │ +00049900: 2074 6869 7320 646f 6375 6d65 6e74 0a20 this document. │ │ │ │ +00049910: 2020 2020 2020 756e 6465 7220 7468 6520 under the │ │ │ │ +00049920: 7465 726d 7320 6f66 2074 6865 2047 4e55 terms of the GNU │ │ │ │ +00049930: 2046 7265 6520 446f 6375 6d65 6e74 6174 Free Documentat │ │ │ │ +00049940: 696f 6e20 4c69 6365 6e73 652c 2056 6572 ion License, Ver │ │ │ │ +00049950: 7369 6f6e 2031 2e32 0a20 2020 2020 2020 sion 1.2. │ │ │ │ +00049960: 6f72 2061 6e79 206c 6174 6572 2076 6572 or any later ver │ │ │ │ +00049970: 7369 6f6e 2070 7562 6c69 7368 6564 2062 sion published b │ │ │ │ +00049980: 7920 7468 6520 4672 6565 2053 6f66 7477 y the Free Softw │ │ │ │ +00049990: 6172 6520 466f 756e 6461 7469 6f6e 3b0a are Foundation;. │ │ │ │ +000499a0: 2020 2020 2020 2077 6974 6820 6e6f 2049 with no I │ │ │ │ +000499b0: 6e76 6172 6961 6e74 2053 6563 7469 6f6e nvariant Section │ │ │ │ +000499c0: 732c 206e 6f20 4672 6f6e 742d 436f 7665 s, no Front-Cove │ │ │ │ +000499d0: 7220 5465 7874 732c 2061 6e64 206e 6f20 r Texts, and no │ │ │ │ +000499e0: 4261 636b 2d43 6f76 6572 0a20 2020 2020 Back-Cover. │ │ │ │ +000499f0: 2020 5465 7874 732e 2020 4120 636f 7079 Texts. A copy │ │ │ │ +00049a00: 206f 6620 7468 6520 6c69 6365 6e73 6520 of the license │ │ │ │ +00049a10: 6973 2069 6e63 6c75 6465 6420 696e 2074 is included in t │ │ │ │ +00049a20: 6865 2073 6563 7469 6f6e 2065 6e74 6974 he section entit │ │ │ │ +00049a30: 6c65 6420 6060 474e 550a 2020 2020 2020 led ``GNU. │ │ │ │ +00049a40: 2046 7265 6520 446f 6375 6d65 6e74 6174 Free Documentat │ │ │ │ +00049a50: 696f 6e20 4c69 6365 6e73 6527 272e 0a0a ion License''... │ │ │ │ +00049a60: 2020 2049 6620 796f 7520 6861 7665 2049 If you have I │ │ │ │ +00049a70: 6e76 6172 6961 6e74 2053 6563 7469 6f6e nvariant Section │ │ │ │ +00049a80: 732c 2046 726f 6e74 2d43 6f76 6572 2054 s, Front-Cover T │ │ │ │ +00049a90: 6578 7473 2061 6e64 2042 6163 6b2d 436f exts and Back-Co │ │ │ │ +00049aa0: 7665 720a 5465 7874 732c 2072 6570 6c61 ver.Texts, repla │ │ │ │ +00049ab0: 6365 2074 6865 2022 7769 7468 2e2e 2e54 ce the "with...T │ │ │ │ +00049ac0: 6578 7473 2e22 2020 6c69 6e65 2077 6974 exts." line wit │ │ │ │ +00049ad0: 6820 7468 6973 3a0a 0a20 2020 2020 2020 h this:.. │ │ │ │ +00049ae0: 2020 7769 7468 2074 6865 2049 6e76 6172 with the Invar │ │ │ │ +00049af0: 6961 6e74 2053 6563 7469 6f6e 7320 6265 iant Sections be │ │ │ │ +00049b00: 696e 6720 4c49 5354 2054 4845 4952 2054 ing LIST THEIR T │ │ │ │ +00049b10: 4954 4c45 532c 2077 6974 680a 2020 2020 ITLES, with. │ │ │ │ +00049b20: 2020 2020 2074 6865 2046 726f 6e74 2d43 the Front-C │ │ │ │ +00049b30: 6f76 6572 2054 6578 7473 2062 6569 6e67 over Texts being │ │ │ │ +00049b40: 204c 4953 542c 2061 6e64 2077 6974 6820 LIST, and with │ │ │ │ +00049b50: 7468 6520 4261 636b 2d43 6f76 6572 2054 the Back-Cover T │ │ │ │ +00049b60: 6578 7473 0a20 2020 2020 2020 2020 6265 exts. be │ │ │ │ +00049b70: 696e 6720 4c49 5354 2e0a 0a20 2020 4966 ing LIST... If │ │ │ │ +00049b80: 2079 6f75 2068 6176 6520 496e 7661 7269 you have Invari │ │ │ │ +00049b90: 616e 7420 5365 6374 696f 6e73 2077 6974 ant Sections wit │ │ │ │ +00049ba0: 686f 7574 2043 6f76 6572 2054 6578 7473 hout Cover Texts │ │ │ │ +00049bb0: 2c20 6f72 2073 6f6d 6520 6f74 6865 720a , or some other. │ │ │ │ +00049bc0: 636f 6d62 696e 6174 696f 6e20 6f66 2074 combination of t │ │ │ │ +00049bd0: 6865 2074 6872 6565 2c20 6d65 7267 6520 he three, merge │ │ │ │ +00049be0: 7468 6f73 6520 7477 6f20 616c 7465 726e those two altern │ │ │ │ +00049bf0: 6174 6976 6573 2074 6f20 7375 6974 2074 atives to suit t │ │ │ │ +00049c00: 6865 0a73 6974 7561 7469 6f6e 2e0a 0a20 he.situation... │ │ │ │ +00049c10: 2020 4966 2079 6f75 7220 646f 6375 6d65 If your docume │ │ │ │ +00049c20: 6e74 2063 6f6e 7461 696e 7320 6e6f 6e74 nt contains nont │ │ │ │ +00049c30: 7269 7669 616c 2065 7861 6d70 6c65 7320 rivial examples │ │ │ │ +00049c40: 6f66 2070 726f 6772 616d 2063 6f64 652c of program code, │ │ │ │ +00049c50: 2077 650a 7265 636f 6d6d 656e 6420 7265 we.recommend re │ │ │ │ +00049c60: 6c65 6173 696e 6720 7468 6573 6520 6578 leasing these ex │ │ │ │ +00049c70: 616d 706c 6573 2069 6e20 7061 7261 6c6c amples in parall │ │ │ │ +00049c80: 656c 2075 6e64 6572 2079 6f75 7220 6368 el under your ch │ │ │ │ +00049c90: 6f69 6365 206f 6620 6672 6565 0a73 6f66 oice of free.sof │ │ │ │ +00049ca0: 7477 6172 6520 6c69 6365 6e73 652c 2073 tware license, s │ │ │ │ +00049cb0: 7563 6820 6173 2074 6865 2047 4e55 2047 uch as the GNU G │ │ │ │ +00049cc0: 656e 6572 616c 2050 7562 6c69 6320 4c69 eneral Public Li │ │ │ │ +00049cd0: 6365 6e73 652c 2074 6f20 7065 726d 6974 cense, to permit │ │ │ │ +00049ce0: 0a74 6865 6972 2075 7365 2069 6e20 6672 .their use in fr │ │ │ │ +00049cf0: 6565 2073 6f66 7477 6172 652e 0a0a ee software... │ │ ├── ./usr/share/info/grub.info-2.gz │ │ │ ├── grub.info-2 │ │ │ │ @@ -1,554 +1,554 @@ │ │ │ │ 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 3720 6672 6f6d 2067 7275 622e 7465 6.7 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 3034 2c20 (version 2.04, │ │ │ │ -00000070: 3130 204a 756c 7920 3230 3231 292e 0a0a 10 July 2021)... │ │ │ │ -00000080: 2020 2043 6f70 7972 6967 6874 2028 4329 Copyright (C) │ │ │ │ -00000090: 0a31 3939 392c 3230 3030 2c32 3030 312c .1999,2000,2001, │ │ │ │ -000000a0: 3230 3032 2c32 3030 342c 3230 3036 2c32 2002,2004,2006,2 │ │ │ │ -000000b0: 3030 382c 3230 3039 2c32 3031 302c 3230 008,2009,2010,20 │ │ │ │ -000000c0: 3131 2c32 3031 322c 3230 3133 2046 7265 11,2012,2013 Fre │ │ │ │ -000000d0: 650a 536f 6674 7761 7265 2046 6f75 6e64 e.Software Found │ │ │ │ -000000e0: 6174 696f 6e2c 2049 6e63 2e0a 0a20 2020 ation, Inc... │ │ │ │ -000000f0: 2020 5065 726d 6973 7369 6f6e 2069 7320 Permission is │ │ │ │ -00000100: 6772 616e 7465 6420 746f 2063 6f70 792c granted to copy, │ │ │ │ -00000110: 2064 6973 7472 6962 7574 6520 616e 642f distribute and/ │ │ │ │ -00000120: 6f72 206d 6f64 6966 7920 7468 6973 0a20 or modify this. │ │ │ │ -00000130: 2020 2020 646f 6375 6d65 6e74 2075 6e64 document und │ │ │ │ -00000140: 6572 2074 6865 2074 6572 6d73 206f 6620 er the terms of │ │ │ │ -00000150: 7468 6520 474e 5520 4672 6565 2044 6f63 the GNU Free Doc │ │ │ │ -00000160: 756d 656e 7461 7469 6f6e 204c 6963 656e umentation Licen │ │ │ │ -00000170: 7365 2c0a 2020 2020 2056 6572 7369 6f6e se,. Version │ │ │ │ -00000180: 2031 2e32 206f 7220 616e 7920 6c61 7465 1.2 or any late │ │ │ │ -00000190: 7220 7665 7273 696f 6e20 7075 626c 6973 r version publis │ │ │ │ -000001a0: 6865 6420 6279 2074 6865 2046 7265 6520 hed by the Free │ │ │ │ -000001b0: 536f 6674 7761 7265 0a20 2020 2020 466f Software. Fo │ │ │ │ -000001c0: 756e 6461 7469 6f6e 3b20 7769 7468 206e undation; with n │ │ │ │ -000001d0: 6f20 496e 7661 7269 616e 7420 5365 6374 o Invariant Sect │ │ │ │ -000001e0: 696f 6e73 2e0a 494e 464f 2d44 4952 2d53 ions..INFO-DIR-S │ │ │ │ -000001f0: 4543 5449 4f4e 204b 6572 6e65 6c0a 5354 ECTION Kernel.ST │ │ │ │ -00000200: 4152 542d 494e 464f 2d44 4952 2d45 4e54 ART-INFO-DIR-ENT │ │ │ │ -00000210: 5259 0a2a 2047 5255 423a 2028 6772 7562 RY.* GRUB: (grub │ │ │ │ -00000220: 292e 2020 2020 2020 2020 2020 2020 2020 ). │ │ │ │ -00000230: 2020 2054 6865 2047 5261 6e64 2055 6e69 The GRand Uni │ │ │ │ -00000240: 6669 6564 2042 6f6f 746c 6f61 6465 720a fied Bootloader. │ │ │ │ -00000250: 2a20 6772 7562 2d69 6e73 7461 6c6c 3a20 * grub-install: │ │ │ │ -00000260: 2867 7275 6229 496e 766f 6b69 6e67 2067 (grub)Invoking g │ │ │ │ -00000270: 7275 622d 696e 7374 616c 6c2e 2020 2020 rub-install. │ │ │ │ -00000280: 496e 7374 616c 6c20 4752 5542 206f 6e20 Install GRUB on │ │ │ │ -00000290: 796f 7572 2064 7269 7665 0a2a 2067 7275 your drive.* gru │ │ │ │ -000002a0: 622d 6d6b 636f 6e66 6967 3a20 2867 7275 b-mkconfig: (gru │ │ │ │ -000002b0: 6229 496e 766f 6b69 6e67 2067 7275 622d b)Invoking grub- │ │ │ │ -000002c0: 6d6b 636f 6e66 6967 2e20 2047 656e 6572 mkconfig. Gener │ │ │ │ -000002d0: 6174 6520 4752 5542 2063 6f6e 6669 6775 ate GRUB configu │ │ │ │ -000002e0: 7261 7469 6f6e 0a2a 2067 7275 622d 6d6b ration.* grub-mk │ │ │ │ -000002f0: 7061 7373 7764 2d70 626b 6466 323a 2028 passwd-pbkdf2: ( │ │ │ │ -00000300: 6772 7562 2949 6e76 6f6b 696e 6720 6772 grub)Invoking gr │ │ │ │ -00000310: 7562 2d6d 6b70 6173 7377 642d 7062 6b64 ub-mkpasswd-pbkd │ │ │ │ -00000320: 6632 2e0a 2a20 6772 7562 2d6d 6b72 656c f2..* grub-mkrel │ │ │ │ -00000330: 7061 7468 3a20 2867 7275 6229 496e 766f path: (grub)Invo │ │ │ │ -00000340: 6b69 6e67 2067 7275 622d 6d6b 7265 6c70 king grub-mkrelp │ │ │ │ -00000350: 6174 682e 0a2a 2067 7275 622d 6d6b 7265 ath..* grub-mkre │ │ │ │ -00000360: 7363 7565 3a20 2867 7275 6229 496e 766f scue: (grub)Invo │ │ │ │ -00000370: 6b69 6e67 2067 7275 622d 6d6b 7265 7363 king grub-mkresc │ │ │ │ -00000380: 7565 2e20 204d 616b 6520 6120 4752 5542 ue. Make a GRUB │ │ │ │ -00000390: 2072 6573 6375 6520 696d 6167 650a 2a20 rescue image.* │ │ │ │ -000003a0: 6772 7562 2d6d 6f75 6e74 3a20 2867 7275 grub-mount: (gru │ │ │ │ -000003b0: 6229 496e 766f 6b69 6e67 2067 7275 622d b)Invoking grub- │ │ │ │ -000003c0: 6d6f 756e 742e 2020 2020 2020 2020 4d6f mount. Mo │ │ │ │ -000003d0: 756e 7420 6120 6669 6c65 2073 7973 7465 unt a file syste │ │ │ │ -000003e0: 6d20 7573 696e 6720 4752 5542 0a2a 2067 m using GRUB.* g │ │ │ │ -000003f0: 7275 622d 7072 6f62 653a 2028 6772 7562 rub-probe: (grub │ │ │ │ -00000400: 2949 6e76 6f6b 696e 6720 6772 7562 2d70 )Invoking grub-p │ │ │ │ -00000410: 726f 6265 2e20 2020 2020 2020 2050 726f robe. Pro │ │ │ │ -00000420: 6265 2064 6576 6963 6520 696e 666f 726d be device inform │ │ │ │ -00000430: 6174 696f 6e0a 2a20 6772 7562 2d73 6372 ation.* grub-scr │ │ │ │ -00000440: 6970 742d 6368 6563 6b3a 2028 6772 7562 ipt-check: (grub │ │ │ │ -00000450: 2949 6e76 6f6b 696e 6720 6772 7562 2d73 )Invoking grub-s │ │ │ │ -00000460: 6372 6970 742d 6368 6563 6b2e 0a45 4e44 cript-check..END │ │ │ │ -00000470: 2d49 4e46 4f2d 4449 522d 454e 5452 590a -INFO-DIR-ENTRY. │ │ │ │ -00000480: 0a1f 0a46 696c 653a 2067 7275 622e 696e ...File: grub.in │ │ │ │ -00000490: 666f 2c20 204e 6f64 653a 2049 6e64 6578 fo, Node: Index │ │ │ │ -000004a0: 2c20 2050 7265 763a 2043 6f70 7969 6e67 , Prev: Copying │ │ │ │ -000004b0: 2054 6869 7320 4d61 6e75 616c 2c20 2055 This Manual, U │ │ │ │ -000004c0: 703a 2054 6f70 0a0a 496e 6465 780a 2a2a p: Top..Index.** │ │ │ │ -000004d0: 2a2a 2a0a 0a00 085b 696e 6465 7800 085d ***....[index..] │ │ │ │ -000004e0: 0a2a 204d 656e 753a 0a0a 2a20 5b3a 2020 .* Menu:..* [: │ │ │ │ +00000070: 3320 4f63 746f 6265 7220 3230 3231 292e 3 October 2021). │ │ │ │ +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 │ │ │ │ 00000500: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00000510: 2020 205b 2e20 2020 2020 2020 2020 2020 [. │ │ │ │ -00000520: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ -00000530: 3629 0a2a 2061 6370 693a 2020 2020 2020 6).* acpi: │ │ │ │ +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: │ │ │ │ 00000540: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00000550: 2020 2020 2020 2020 2020 2020 6163 7069 acpi │ │ │ │ -00000560: 2e20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ -00000570: 2020 2028 6c69 6e65 2036 290a 2a20 6175 (line 6).* au │ │ │ │ -00000580: 7468 656e 7469 6361 7465 3a20 2020 2020 thenticate: │ │ │ │ +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: │ │ │ │ 00000590: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -000005a0: 2020 2020 2061 7574 6865 6e74 6963 6174 authenticat │ │ │ │ -000005b0: 652e 2020 2020 2020 2020 2020 286c 696e e. (lin │ │ │ │ -000005c0: 6520 3629 0a2a 2062 6163 6b67 726f 756e e 6).* backgroun │ │ │ │ -000005d0: 645f 636f 6c6f 723a 2020 2020 2020 2020 d_color: │ │ │ │ -000005e0: 2020 2020 2020 2020 2020 2020 2020 6261 ba │ │ │ │ -000005f0: 636b 6772 6f75 6e64 5f63 6f6c 6f72 2e20 ckground_color. │ │ │ │ -00000600: 2020 2020 2028 6c69 6e65 2036 290a 2a20 (line 6).* │ │ │ │ -00000610: 6261 636b 6772 6f75 6e64 5f69 6d61 6765 background_image │ │ │ │ -00000620: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ -00000630: 2020 2020 2020 2062 6163 6b67 726f 756e backgroun │ │ │ │ -00000640: 645f 696d 6167 652e 2020 2020 2020 286c d_image. (l │ │ │ │ -00000650: 696e 6520 3629 0a2a 2062 6164 7261 6d3a ine 6).* badram: │ │ │ │ -00000660: 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: │ │ │ │ +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: │ │ │ │ 00000670: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00000680: 6261 6472 616d 2e20 2020 2020 2020 2020 badram. │ │ │ │ -00000690: 2020 2020 2020 2028 6c69 6e65 2036 290a (line 6). │ │ │ │ -000006a0: 2a20 626c 6f63 6b6c 6973 743a 2020 2020 * blocklist: │ │ │ │ +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: │ │ │ │ 000006b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -000006c0: 2020 2020 2020 2020 2062 6c6f 636b 6c69 blockli │ │ │ │ -000006d0: 7374 2e20 2020 2020 2020 2020 2020 2020 st. │ │ │ │ -000006e0: 286c 696e 6520 3629 0a2a 2062 6f6f 743a (line 6).* boot: │ │ │ │ -000006f0: 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: │ │ │ │ 00000700: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00000710: 2020 626f 6f74 2e20 2020 2020 2020 2020 boot. │ │ │ │ -00000720: 2020 2020 2020 2020 2028 6c69 6e65 2036 (line 6 │ │ │ │ -00000730: 290a 2a20 6361 743a 2020 2020 2020 2020 ).* cat: │ │ │ │ +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: │ │ │ │ 00000740: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00000750: 2020 2020 2020 2020 2020 2063 6174 2e20 cat. │ │ │ │ -00000760: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00000770: 2020 286c 696e 6520 3629 0a2a 2063 6861 (line 6).* cha │ │ │ │ -00000780: 696e 6c6f 6164 6572 3a20 2020 2020 2020 inloader: │ │ │ │ +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: │ │ │ │ 00000790: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -000007a0: 2020 2020 6368 6169 6e6c 6f61 6465 722e chainloader. │ │ │ │ -000007b0: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ -000007c0: 2036 290a 2a20 636c 6561 723a 2020 2020 6).* clear: │ │ │ │ +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: │ │ │ │ 000007d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -000007e0: 2020 2020 2020 2020 2020 2020 2063 6c65 cle │ │ │ │ -000007f0: 6172 2e20 2020 2020 2020 2020 2020 2020 ar. │ │ │ │ -00000800: 2020 2020 286c 696e 6520 3629 0a2a 2043 (line 6).* C │ │ │ │ -00000810: 4d4f 533a 2020 2020 2020 2020 2020 2020 MOS: │ │ │ │ +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: │ │ │ │ 00000820: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00000830: 2020 2020 2020 636d 6f73 6475 6d70 2e20 cmosdump. │ │ │ │ -00000840: 2020 2020 2020 2020 2020 2020 2028 6c69 (li │ │ │ │ -00000850: 6e65 2036 290a 2a20 636d 6f73 636c 6561 ne 6).* cmosclea │ │ │ │ -00000860: 6e3a 2020 2020 2020 2020 2020 2020 2020 n: │ │ │ │ -00000870: 2020 2020 2020 2020 2020 2020 2020 2063 c │ │ │ │ -00000880: 6d6f 7363 6c65 616e 2e20 2020 2020 2020 mosclean. │ │ │ │ -00000890: 2020 2020 2020 286c 696e 6520 3629 0a2a (line 6).* │ │ │ │ -000008a0: 2063 6d6f 7374 6573 743a 2020 2020 2020 cmostest: │ │ │ │ +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: │ │ │ │ +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: │ │ │ │ 000008b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -000008c0: 2020 2020 2020 2020 636d 6f73 7465 7374 cmostest │ │ │ │ -000008d0: 2e20 2020 2020 2020 2020 2020 2020 2028 . ( │ │ │ │ -000008e0: 6c69 6e65 2036 290a 2a20 636d 703a 2020 line 6).* cmp: │ │ │ │ +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 │ │ │ │ 00000900: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00000910: 2063 6d70 2e20 2020 2020 2020 2020 2020 cmp. │ │ │ │ -00000920: 2020 2020 2020 2020 286c 696e 6520 3629 (line 6) │ │ │ │ -00000930: 0a2a 2063 6f6e 6669 6766 696c 653a 2020 .* configfile: │ │ │ │ +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 636f 6e66 6967 config │ │ │ │ -00000960: 6669 6c65 2e20 2020 2020 2020 2020 2020 file. │ │ │ │ -00000970: 2028 6c69 6e65 2036 290a 2a20 6370 7569 (line 6).* cpui │ │ │ │ -00000980: 643a 2020 2020 2020 2020 2020 2020 2020 d: │ │ │ │ +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: │ │ │ │ 00000990: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -000009a0: 2020 2063 7075 6964 2e20 2020 2020 2020 cpuid. │ │ │ │ -000009b0: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ -000009c0: 3629 0a2a 2063 7263 3a20 2020 2020 2020 6).* crc: │ │ │ │ +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: │ │ │ │ 000009d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -000009e0: 2020 2020 2020 2020 2020 2020 6372 632e crc. │ │ │ │ -000009f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00000a00: 2020 2028 6c69 6e65 2036 290a 2a20 6372 (line 6).* cr │ │ │ │ -00000a10: 7970 746f 6d6f 756e 743a 2020 2020 2020 yptomount: │ │ │ │ +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: │ │ │ │ 00000a20: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00000a30: 2020 2020 2063 7279 7074 6f6d 6f75 6e74 cryptomount │ │ │ │ -00000a40: 2e20 2020 2020 2020 2020 2020 286c 696e . (lin │ │ │ │ -00000a50: 6520 3629 0a2a 2063 7574 6d65 6d3a 2020 e 6).* cutmem: │ │ │ │ +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 │ │ │ │ -00000a70: 2020 2020 2020 2020 2020 2020 2020 6375 cu │ │ │ │ -00000a80: 746d 656d 2e20 2020 2020 2020 2020 2020 tmem. │ │ │ │ -00000a90: 2020 2020 2028 6c69 6e65 2036 290a 2a20 (line 6).* │ │ │ │ -00000aa0: 6461 7465 3a20 2020 2020 2020 2020 2020 date: │ │ │ │ +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: │ │ │ │ 00000ab0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00000ac0: 2020 2020 2020 2064 6174 652e 2020 2020 date. │ │ │ │ -00000ad0: 2020 2020 2020 2020 2020 2020 2020 286c (l │ │ │ │ -00000ae0: 696e 6520 3629 0a2a 2064 6576 6963 6574 ine 6).* devicet │ │ │ │ -00000af0: 7265 653a 2020 2020 2020 2020 2020 2020 ree: │ │ │ │ +00000ac0: 2020 2020 2020 2020 2064 6174 652e 2020 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: │ │ │ │ 00000b00: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00000b10: 6465 7669 6365 7472 6565 2e20 2020 2020 devicetree. │ │ │ │ -00000b20: 2020 2020 2020 2028 6c69 6e65 2036 290a (line 6). │ │ │ │ -00000b30: 2a20 6469 7374 7275 7374 3a20 2020 2020 * distrust: │ │ │ │ +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: │ │ │ │ 00000b40: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00000b50: 2020 2020 2020 2020 2064 6973 7472 7573 distrus │ │ │ │ -00000b60: 742e 2020 2020 2020 2020 2020 2020 2020 t. │ │ │ │ -00000b70: 286c 696e 6520 3629 0a2a 2064 7269 7665 (line 6).* drive │ │ │ │ -00000b80: 6d61 703a 2020 2020 2020 2020 2020 2020 map: │ │ │ │ +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: │ │ │ │ 00000b90: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00000ba0: 2020 6472 6976 656d 6170 2e20 2020 2020 drivemap. │ │ │ │ -00000bb0: 2020 2020 2020 2020 2028 6c69 6e65 2036 (line 6 │ │ │ │ -00000bc0: 290a 2a20 6563 686f 3a20 2020 2020 2020 ).* echo: │ │ │ │ +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: │ │ │ │ 00000bd0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00000be0: 2020 2020 2020 2020 2020 2065 6368 6f2e echo. │ │ │ │ -00000bf0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00000c00: 2020 286c 696e 6520 3629 0a2a 2065 7661 (line 6).* eva │ │ │ │ -00000c10: 6c3a 2020 2020 2020 2020 2020 2020 2020 l: │ │ │ │ +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: │ │ │ │ 00000c20: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00000c30: 2020 2020 6576 616c 2e20 2020 2020 2020 eval. │ │ │ │ -00000c40: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ -00000c50: 2036 290a 2a20 6578 706f 7274 3a20 2020 6).* export: │ │ │ │ +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: │ │ │ │ 00000c60: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00000c70: 2020 2020 2020 2020 2020 2020 2065 7870 exp │ │ │ │ -00000c80: 6f72 742e 2020 2020 2020 2020 2020 2020 ort. │ │ │ │ -00000c90: 2020 2020 286c 696e 6520 3629 0a2a 2066 (line 6).* f │ │ │ │ -00000ca0: 616c 7365 3a20 2020 2020 2020 2020 2020 alse: │ │ │ │ +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: │ │ │ │ 00000cb0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00000cc0: 2020 2020 2020 6661 6c73 652e 2020 2020 false. │ │ │ │ -00000cd0: 2020 2020 2020 2020 2020 2020 2028 6c69 (li │ │ │ │ -00000ce0: 6e65 2036 290a 2a20 4644 4c2c 2047 4e55 ne 6).* FDL, GNU │ │ │ │ -00000cf0: 2046 7265 6520 446f 6375 6d65 6e74 6174 Free Documentat │ │ │ │ -00000d00: 696f 6e20 4c69 6365 6e73 653a 2020 2047 ion License: G │ │ │ │ -00000d10: 4e55 2046 7265 6520 446f 6375 6d65 6e74 NU Free Document │ │ │ │ -00000d20: 6174 696f 6e20 4c69 6365 6e73 652e 0a20 ation License.. │ │ │ │ -00000d30: 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 . │ │ │ │ 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 2028 ( │ │ │ │ -00000d70: 6c69 6e65 2036 290a 2a20 6765 7474 6578 line 6).* gettex │ │ │ │ -00000d80: 743a 2020 2020 2020 2020 2020 2020 2020 t: │ │ │ │ +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: │ │ │ │ 00000d90: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00000da0: 2067 6574 7465 7874 2e20 2020 2020 2020 gettext. │ │ │ │ -00000db0: 2020 2020 2020 2020 286c 696e 6520 3629 (line 6) │ │ │ │ -00000dc0: 0a2a 2067 7074 7379 6e63 3a20 2020 2020 .* gptsync: │ │ │ │ +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: │ │ │ │ 00000dd0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00000de0: 2020 2020 2020 2020 2020 6770 7473 796e gptsyn │ │ │ │ -00000df0: 632e 2020 2020 2020 2020 2020 2020 2020 c. │ │ │ │ -00000e00: 2028 6c69 6e65 2036 290a 2a20 6861 6c74 (line 6).* halt │ │ │ │ -00000e10: 3a20 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: │ │ │ │ 00000e20: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00000e30: 2020 2068 616c 742e 2020 2020 2020 2020 halt. │ │ │ │ -00000e40: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ -00000e50: 3629 0a2a 2068 6173 6873 756d 3a20 2020 6).* hashsum: │ │ │ │ +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: │ │ │ │ 00000e60: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00000e70: 2020 2020 2020 2020 2020 2020 6861 7368 hash │ │ │ │ -00000e80: 7375 6d2e 2020 2020 2020 2020 2020 2020 sum. │ │ │ │ -00000e90: 2020 2028 6c69 6e65 2036 290a 2a20 6865 (line 6).* he │ │ │ │ -00000ea0: 6c70 3a20 2020 2020 2020 2020 2020 2020 lp: │ │ │ │ +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: │ │ │ │ 00000eb0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00000ec0: 2020 2020 2068 656c 702e 2020 2020 2020 help. │ │ │ │ -00000ed0: 2020 2020 2020 2020 2020 2020 286c 696e (lin │ │ │ │ -00000ee0: 6520 3629 0a2a 2069 6e69 7472 643a 2020 e 6).* initrd: │ │ │ │ +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 │ │ │ │ -00000f00: 2020 2020 2020 2020 2020 2020 2020 696e in │ │ │ │ -00000f10: 6974 7264 2e20 2020 2020 2020 2020 2020 itrd. │ │ │ │ -00000f20: 2020 2020 2028 6c69 6e65 2036 290a 2a20 (line 6).* │ │ │ │ -00000f30: 696e 6974 7264 3136 3a20 2020 2020 2020 initrd16: │ │ │ │ +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: │ │ │ │ 00000f40: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00000f50: 2020 2020 2020 2069 6e69 7472 6431 362e initrd16. │ │ │ │ -00000f60: 2020 2020 2020 2020 2020 2020 2020 286c (l │ │ │ │ -00000f70: 696e 6520 3629 0a2a 2069 6e73 6d6f 643a ine 6).* insmod: │ │ │ │ -00000f80: 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: │ │ │ │ 00000f90: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00000fa0: 696e 736d 6f64 2e20 2020 2020 2020 2020 insmod. │ │ │ │ -00000fb0: 2020 2020 2020 2028 6c69 6e65 2036 290a (line 6). │ │ │ │ -00000fc0: 2a20 6b65 7973 7461 7475 733a 2020 2020 * keystatus: │ │ │ │ +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: │ │ │ │ 00000fd0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00000fe0: 2020 2020 2020 2020 206b 6579 7374 6174 keystat │ │ │ │ -00000ff0: 7573 2e20 2020 2020 2020 2020 2020 2020 us. │ │ │ │ -00001000: 286c 696e 6520 3629 0a2a 206c 696e 7578 (line 6).* linux │ │ │ │ -00001010: 3a20 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: │ │ │ │ 00001020: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00001030: 2020 6c69 6e75 782e 2020 2020 2020 2020 linux. │ │ │ │ -00001040: 2020 2020 2020 2020 2028 6c69 6e65 2036 (line 6 │ │ │ │ -00001050: 290a 2a20 6c69 6e75 7831 363a 2020 2020 ).* linux16: │ │ │ │ +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: │ │ │ │ 00001060: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00001070: 2020 2020 2020 2020 2020 206c 696e 7578 linux │ │ │ │ -00001080: 3136 2e20 2020 2020 2020 2020 2020 2020 16. │ │ │ │ -00001090: 2020 286c 696e 6520 3629 0a2a 206c 6973 (line 6).* lis │ │ │ │ -000010a0: 745f 656e 763a 2020 2020 2020 2020 2020 t_env: │ │ │ │ +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: │ │ │ │ 000010b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -000010c0: 2020 2020 6c69 7374 5f65 6e76 2e20 2020 list_env. │ │ │ │ -000010d0: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ -000010e0: 2036 290a 2a20 6c69 7374 5f74 7275 7374 6).* list_trust │ │ │ │ -000010f0: 6564 3a20 2020 2020 2020 2020 2020 2020 ed: │ │ │ │ -00001100: 2020 2020 2020 2020 2020 2020 206c 6973 lis │ │ │ │ -00001110: 745f 7472 7573 7465 642e 2020 2020 2020 t_trusted. │ │ │ │ -00001120: 2020 2020 286c 696e 6520 3629 0a2a 206c (line 6).* l │ │ │ │ -00001130: 6f61 6466 6f6e 743a 2020 2020 2020 2020 oadfont: │ │ │ │ +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: │ │ │ │ 00001140: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00001150: 2020 2020 2020 6c6f 6164 666f 6e74 2e20 loadfont. │ │ │ │ -00001160: 2020 2020 2020 2020 2020 2020 2028 6c69 (li │ │ │ │ -00001170: 6e65 2036 290a 2a20 6c6f 6164 5f65 6e76 ne 6).* load_env │ │ │ │ -00001180: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ -00001190: 2020 2020 2020 2020 2020 2020 2020 206c l │ │ │ │ -000011a0: 6f61 645f 656e 762e 2020 2020 2020 2020 oad_env. │ │ │ │ -000011b0: 2020 2020 2020 286c 696e 6520 3629 0a2a (line 6).* │ │ │ │ -000011c0: 206c 6f6f 7062 6163 6b3a 2020 2020 2020 loopback: │ │ │ │ +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: │ │ │ │ +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: │ │ │ │ 000011d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -000011e0: 2020 2020 2020 2020 6c6f 6f70 6261 636b loopback │ │ │ │ -000011f0: 2e20 2020 2020 2020 2020 2020 2020 2028 . ( │ │ │ │ -00001200: 6c69 6e65 2036 290a 2a20 6c73 3a20 2020 line 6).* ls: │ │ │ │ +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: │ │ │ │ 00001210: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ 00001220: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00001230: 206c 732e 2020 2020 2020 2020 2020 2020 ls. │ │ │ │ -00001240: 2020 2020 2020 2020 286c 696e 6520 3629 (line 6) │ │ │ │ -00001250: 0a2a 206c 7366 6f6e 7473 3a20 2020 2020 .* lsfonts: │ │ │ │ +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: │ │ │ │ 00001260: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00001270: 2020 2020 2020 2020 2020 6c73 666f 6e74 lsfont │ │ │ │ -00001280: 732e 2020 2020 2020 2020 2020 2020 2020 s. │ │ │ │ -00001290: 2028 6c69 6e65 2036 290a 2a20 6c73 6d6f (line 6).* lsmo │ │ │ │ -000012a0: 643a 2020 2020 2020 2020 2020 2020 2020 d: │ │ │ │ +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: │ │ │ │ 000012b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -000012c0: 2020 206c 736d 6f64 2e20 2020 2020 2020 lsmod. │ │ │ │ -000012d0: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ -000012e0: 3629 0a2a 206d 6435 7375 6d3a 2020 2020 6).* md5sum: │ │ │ │ +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: │ │ │ │ 000012f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00001300: 2020 2020 2020 2020 2020 2020 6d64 3573 md5s │ │ │ │ -00001310: 756d 2e20 2020 2020 2020 2020 2020 2020 um. │ │ │ │ -00001320: 2020 2028 6c69 6e65 2036 290a 2a20 6d65 (line 6).* me │ │ │ │ -00001330: 6e75 656e 7472 793a 2020 2020 2020 2020 nuentry: │ │ │ │ +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: │ │ │ │ 00001340: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00001350: 2020 2020 206d 656e 7565 6e74 7279 2e20 menuentry. │ │ │ │ -00001360: 2020 2020 2020 2020 2020 2020 286c 696e (lin │ │ │ │ -00001370: 6520 3629 0a2a 206d 6f64 756c 653a 2020 e 6).* module: │ │ │ │ +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 │ │ │ │ -00001390: 2020 2020 2020 2020 2020 2020 2020 6d6f mo │ │ │ │ -000013a0: 6475 6c65 2e20 2020 2020 2020 2020 2020 dule. │ │ │ │ -000013b0: 2020 2020 2028 6c69 6e65 2036 290a 2a20 (line 6).* │ │ │ │ -000013c0: 6d75 6c74 6962 6f6f 743a 2020 2020 2020 multiboot: │ │ │ │ +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: │ │ │ │ 000013d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -000013e0: 2020 2020 2020 206d 756c 7469 626f 6f74 multiboot │ │ │ │ -000013f0: 2e20 2020 2020 2020 2020 2020 2020 286c . (l │ │ │ │ -00001400: 696e 6520 3629 0a2a 206e 6174 6976 6564 ine 6).* natived │ │ │ │ -00001410: 6973 6b3a 2020 2020 2020 2020 2020 2020 isk: │ │ │ │ +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: │ │ │ │ 00001420: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00001430: 6e61 7469 7665 6469 736b 2e20 2020 2020 nativedisk. │ │ │ │ -00001440: 2020 2020 2020 2028 6c69 6e65 2036 290a (line 6). │ │ │ │ -00001450: 2a20 6e65 745f 6164 645f 6164 6472 3a20 * net_add_addr: │ │ │ │ -00001460: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00001470: 2020 2020 2020 2020 206e 6574 5f61 6464 net_add │ │ │ │ -00001480: 5f61 6464 722e 2020 2020 2020 2020 2020 _addr. │ │ │ │ -00001490: 286c 696e 6520 3629 0a2a 206e 6574 5f61 (line 6).* net_a │ │ │ │ -000014a0: 6464 5f64 6e73 3a20 2020 2020 2020 2020 dd_dns: │ │ │ │ +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: │ │ │ │ 000014b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -000014c0: 2020 6e65 745f 6164 645f 646e 732e 2020 net_add_dns. │ │ │ │ -000014d0: 2020 2020 2020 2020 2028 6c69 6e65 2036 (line 6 │ │ │ │ -000014e0: 290a 2a20 6e65 745f 6164 645f 726f 7574 ).* net_add_rout │ │ │ │ -000014f0: 653a 2020 2020 2020 2020 2020 2020 2020 e: │ │ │ │ -00001500: 2020 2020 2020 2020 2020 206e 6574 5f61 net_a │ │ │ │ -00001510: 6464 5f72 6f75 7465 2e20 2020 2020 2020 dd_route. │ │ │ │ -00001520: 2020 286c 696e 6520 3629 0a2a 206e 6574 (line 6).* net │ │ │ │ -00001530: 5f62 6f6f 7470 3a20 2020 2020 2020 2020 _bootp: │ │ │ │ +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: │ │ │ │ 00001540: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00001550: 2020 2020 6e65 745f 626f 6f74 702e 2020 net_bootp. │ │ │ │ -00001560: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ -00001570: 2036 290a 2a20 6e65 745f 6465 6c5f 6164 6).* net_del_ad │ │ │ │ -00001580: 6472 3a20 2020 2020 2020 2020 2020 2020 dr: │ │ │ │ -00001590: 2020 2020 2020 2020 2020 2020 206e 6574 net │ │ │ │ -000015a0: 5f64 656c 5f61 6464 722e 2020 2020 2020 _del_addr. │ │ │ │ -000015b0: 2020 2020 286c 696e 6520 3629 0a2a 206e (line 6).* n │ │ │ │ -000015c0: 6574 5f64 656c 5f64 6e73 3a20 2020 2020 et_del_dns: │ │ │ │ +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: │ │ │ │ 000015d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -000015e0: 2020 2020 2020 6e65 745f 6465 6c5f 646e net_del_dn │ │ │ │ -000015f0: 732e 2020 2020 2020 2020 2020 2028 6c69 s. (li │ │ │ │ -00001600: 6e65 2036 290a 2a20 6e65 745f 6465 6c5f ne 6).* net_del_ │ │ │ │ -00001610: 726f 7574 653a 2020 2020 2020 2020 2020 route: │ │ │ │ -00001620: 2020 2020 2020 2020 2020 2020 2020 206e n │ │ │ │ -00001630: 6574 5f64 656c 5f72 6f75 7465 2e20 2020 et_del_route. │ │ │ │ -00001640: 2020 2020 2020 286c 696e 6520 3629 0a2a (line 6).* │ │ │ │ -00001650: 206e 6574 5f67 6574 5f64 6863 705f 6f70 net_get_dhcp_op │ │ │ │ -00001660: 7469 6f6e 3a20 2020 2020 2020 2020 2020 tion: │ │ │ │ -00001670: 2020 2020 2020 2020 6e65 745f 6765 745f net_get_ │ │ │ │ -00001680: 6468 6370 5f6f 7074 696f 6e2e 2020 2028 dhcp_option. ( │ │ │ │ -00001690: 6c69 6e65 2036 290a 2a20 6e65 745f 6970 line 6).* net_ip │ │ │ │ -000016a0: 7636 5f61 7574 6f63 6f6e 663a 2020 2020 v6_autoconf: │ │ │ │ +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: │ │ │ │ +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 5f67 6574 5f64 6863 705f .* net_get_dhcp_ │ │ │ │ +00001660: 6f70 7469 6f6e 3a20 2020 2020 2020 2020 option: │ │ │ │ +00001670: 2020 2020 2020 2020 2020 6e65 745f 6765 net_ge │ │ │ │ +00001680: 745f 6468 6370 5f6f 7074 696f 6e2e 2020 t_dhcp_option. │ │ │ │ +00001690: 2028 6c69 6e65 2036 290a 2a20 6e65 745f (line 6).* net_ │ │ │ │ +000016a0: 6970 7636 5f61 7574 6f63 6f6e 663a 2020 ipv6_autoconf: │ │ │ │ 000016b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -000016c0: 206e 6574 5f69 7076 365f 6175 746f 636f net_ipv6_autoco │ │ │ │ -000016d0: 6e66 2e20 2020 2020 286c 696e 6520 3629 nf. (line 6) │ │ │ │ -000016e0: 0a2a 206e 6574 5f6c 735f 6164 6472 3a20 .* net_ls_addr: │ │ │ │ -000016f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00001700: 2020 2020 2020 2020 2020 6e65 745f 6c73 net_ls │ │ │ │ -00001710: 5f61 6464 722e 2020 2020 2020 2020 2020 _addr. │ │ │ │ -00001720: 2028 6c69 6e65 2036 290a 2a20 6e65 745f (line 6).* net_ │ │ │ │ -00001730: 6c73 5f63 6172 6473 3a20 2020 2020 2020 ls_cards: │ │ │ │ +000016c0: 2020 206e 6574 5f69 7076 365f 6175 746f net_ipv6_auto │ │ │ │ +000016d0: 636f 6e66 2e20 2020 2020 286c 696e 6520 conf. (line │ │ │ │ +000016e0: 3629 0a2a 206e 6574 5f6c 735f 6164 6472 6).* net_ls_addr │ │ │ │ +000016f0: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ +00001700: 2020 2020 2020 2020 2020 2020 6e65 745f net_ │ │ │ │ +00001710: 6c73 5f61 6464 722e 2020 2020 2020 2020 ls_addr. │ │ │ │ +00001720: 2020 2028 6c69 6e65 2036 290a 2a20 6e65 (line 6).* ne │ │ │ │ +00001730: 745f 6c73 5f63 6172 6473 3a20 2020 2020 t_ls_cards: │ │ │ │ 00001740: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00001750: 2020 206e 6574 5f6c 735f 6361 7264 732e net_ls_cards. │ │ │ │ -00001760: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ -00001770: 3629 0a2a 206e 6574 5f6c 735f 646e 733a 6).* net_ls_dns: │ │ │ │ -00001780: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00001790: 2020 2020 2020 2020 2020 2020 6e65 745f net_ │ │ │ │ -000017a0: 6c73 5f64 6e73 2e20 2020 2020 2020 2020 ls_dns. │ │ │ │ -000017b0: 2020 2028 6c69 6e65 2036 290a 2a20 6e65 (line 6).* ne │ │ │ │ -000017c0: 745f 6c73 5f72 6f75 7465 733a 2020 2020 t_ls_routes: │ │ │ │ +00001750: 2020 2020 206e 6574 5f6c 735f 6361 7264 net_ls_card │ │ │ │ +00001760: 732e 2020 2020 2020 2020 2020 286c 696e s. (lin │ │ │ │ +00001770: 6520 3629 0a2a 206e 6574 5f6c 735f 646e e 6).* net_ls_dn │ │ │ │ +00001780: 733a 2020 2020 2020 2020 2020 2020 2020 s: │ │ │ │ +00001790: 2020 2020 2020 2020 2020 2020 2020 6e65 ne │ │ │ │ +000017a0: 745f 6c73 5f64 6e73 2e20 2020 2020 2020 t_ls_dns. │ │ │ │ +000017b0: 2020 2020 2028 6c69 6e65 2036 290a 2a20 (line 6).* │ │ │ │ +000017c0: 6e65 745f 6c73 5f72 6f75 7465 733a 2020 net_ls_routes: │ │ │ │ 000017d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -000017e0: 2020 2020 206e 6574 5f6c 735f 726f 7574 net_ls_rout │ │ │ │ -000017f0: 6573 2e20 2020 2020 2020 2020 286c 696e es. (lin │ │ │ │ -00001800: 6520 3629 0a2a 206e 6574 5f6e 736c 6f6f e 6).* net_nsloo │ │ │ │ -00001810: 6b75 703a 2020 2020 2020 2020 2020 2020 kup: │ │ │ │ -00001820: 2020 2020 2020 2020 2020 2020 2020 6e65 ne │ │ │ │ -00001830: 745f 6e73 6c6f 6f6b 7570 2e20 2020 2020 t_nslookup. │ │ │ │ -00001840: 2020 2020 2028 6c69 6e65 2036 290a 2a20 (line 6).* │ │ │ │ -00001850: 6e6f 726d 616c 3a20 2020 2020 2020 2020 normal: │ │ │ │ +000017e0: 2020 2020 2020 206e 6574 5f6c 735f 726f net_ls_ro │ │ │ │ +000017f0: 7574 6573 2e20 2020 2020 2020 2020 286c utes. (l │ │ │ │ +00001800: 696e 6520 3629 0a2a 206e 6574 5f6e 736c ine 6).* net_nsl │ │ │ │ +00001810: 6f6f 6b75 703a 2020 2020 2020 2020 2020 ookup: │ │ │ │ +00001820: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00001830: 6e65 745f 6e73 6c6f 6f6b 7570 2e20 2020 net_nslookup. │ │ │ │ +00001840: 2020 2020 2020 2028 6c69 6e65 2036 290a (line 6). │ │ │ │ +00001850: 2a20 6e6f 726d 616c 3a20 2020 2020 2020 * normal: │ │ │ │ 00001860: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00001870: 2020 2020 2020 206e 6f72 6d61 6c2e 2020 normal. │ │ │ │ -00001880: 2020 2020 2020 2020 2020 2020 2020 286c (l │ │ │ │ -00001890: 696e 6520 3629 0a2a 206e 6f72 6d61 6c5f ine 6).* normal_ │ │ │ │ -000018a0: 6578 6974 3a20 2020 2020 2020 2020 2020 exit: │ │ │ │ +00001870: 2020 2020 2020 2020 206e 6f72 6d61 6c2e normal. │ │ │ │ +00001880: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00001890: 286c 696e 6520 3629 0a2a 206e 6f72 6d61 (line 6).* norma │ │ │ │ +000018a0: 6c5f 6578 6974 3a20 2020 2020 2020 2020 l_exit: │ │ │ │ 000018b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -000018c0: 6e6f 726d 616c 5f65 7869 742e 2020 2020 normal_exit. │ │ │ │ -000018d0: 2020 2020 2020 2028 6c69 6e65 2036 290a (line 6). │ │ │ │ -000018e0: 2a20 7061 7274 746f 6f6c 3a20 2020 2020 * parttool: │ │ │ │ +000018c0: 2020 6e6f 726d 616c 5f65 7869 742e 2020 normal_exit. │ │ │ │ +000018d0: 2020 2020 2020 2020 2028 6c69 6e65 2036 (line 6 │ │ │ │ +000018e0: 290a 2a20 7061 7274 746f 6f6c 3a20 2020 ).* parttool: │ │ │ │ 000018f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00001900: 2020 2020 2020 2020 2070 6172 7474 6f6f parttoo │ │ │ │ -00001910: 6c2e 2020 2020 2020 2020 2020 2020 2020 l. │ │ │ │ -00001920: 286c 696e 6520 3629 0a2a 2070 6173 7377 (line 6).* passw │ │ │ │ -00001930: 6f72 643a 2020 2020 2020 2020 2020 2020 ord: │ │ │ │ +00001900: 2020 2020 2020 2020 2020 2070 6172 7474 partt │ │ │ │ +00001910: 6f6f 6c2e 2020 2020 2020 2020 2020 2020 ool. │ │ │ │ +00001920: 2020 286c 696e 6520 3629 0a2a 2070 6173 (line 6).* pas │ │ │ │ +00001930: 7377 6f72 643a 2020 2020 2020 2020 2020 sword: │ │ │ │ 00001940: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00001950: 2020 7061 7373 776f 7264 2e20 2020 2020 password. │ │ │ │ -00001960: 2020 2020 2020 2020 2028 6c69 6e65 2036 (line 6 │ │ │ │ -00001970: 290a 2a20 7061 7373 776f 7264 5f70 626b ).* password_pbk │ │ │ │ -00001980: 6466 323a 2020 2020 2020 2020 2020 2020 df2: │ │ │ │ -00001990: 2020 2020 2020 2020 2020 2070 6173 7377 passw │ │ │ │ -000019a0: 6f72 645f 7062 6b64 6632 2e20 2020 2020 ord_pbkdf2. │ │ │ │ -000019b0: 2020 286c 696e 6520 3629 0a2a 2070 6c61 (line 6).* pla │ │ │ │ -000019c0: 793a 2020 2020 2020 2020 2020 2020 2020 y: │ │ │ │ +00001950: 2020 2020 7061 7373 776f 7264 2e20 2020 password. │ │ │ │ +00001960: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ +00001970: 2036 290a 2a20 7061 7373 776f 7264 5f70 6).* password_p │ │ │ │ +00001980: 626b 6466 323a 2020 2020 2020 2020 2020 bkdf2: │ │ │ │ +00001990: 2020 2020 2020 2020 2020 2020 2070 6173 pas │ │ │ │ +000019a0: 7377 6f72 645f 7062 6b64 6632 2e20 2020 sword_pbkdf2. │ │ │ │ +000019b0: 2020 2020 286c 696e 6520 3629 0a2a 2070 (line 6).* p │ │ │ │ +000019c0: 6c61 793a 2020 2020 2020 2020 2020 2020 lay: │ │ │ │ 000019d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -000019e0: 2020 2020 706c 6179 2e20 2020 2020 2020 play. │ │ │ │ -000019f0: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ -00001a00: 2036 290a 2a20 7072 6f62 653a 2020 2020 6).* probe: │ │ │ │ +000019e0: 2020 2020 2020 706c 6179 2e20 2020 2020 play. │ │ │ │ +000019f0: 2020 2020 2020 2020 2020 2020 2028 6c69 (li │ │ │ │ +00001a00: 6e65 2036 290a 2a20 7072 6f62 653a 2020 ne 6).* probe: │ │ │ │ 00001a10: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00001a20: 2020 2020 2020 2020 2020 2020 2070 726f pro │ │ │ │ -00001a30: 6265 2e20 2020 2020 2020 2020 2020 2020 be. │ │ │ │ -00001a40: 2020 2020 286c 696e 6520 3629 0a2a 2070 (line 6).* p │ │ │ │ -00001a50: 7865 5f75 6e6c 6f61 643a 2020 2020 2020 xe_unload: │ │ │ │ +00001a20: 2020 2020 2020 2020 2020 2020 2020 2070 p │ │ │ │ +00001a30: 726f 6265 2e20 2020 2020 2020 2020 2020 robe. │ │ │ │ +00001a40: 2020 2020 2020 286c 696e 6520 3629 0a2a (line 6).* │ │ │ │ +00001a50: 2070 7865 5f75 6e6c 6f61 643a 2020 2020 pxe_unload: │ │ │ │ 00001a60: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00001a70: 2020 2020 2020 7078 655f 756e 6c6f 6164 pxe_unload │ │ │ │ -00001a80: 2e20 2020 2020 2020 2020 2020 2028 6c69 . (li │ │ │ │ -00001a90: 6e65 2036 290a 2a20 7264 6d73 723a 2020 ne 6).* rdmsr: │ │ │ │ +00001a70: 2020 2020 2020 2020 7078 655f 756e 6c6f pxe_unlo │ │ │ │ +00001a80: 6164 2e20 2020 2020 2020 2020 2020 2028 ad. ( │ │ │ │ +00001a90: 6c69 6e65 2036 290a 2a20 7264 6d73 723a line 6).* rdmsr: │ │ │ │ 00001aa0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00001ab0: 2020 2020 2020 2020 2020 2020 2020 2072 r │ │ │ │ -00001ac0: 646d 7372 2e20 2020 2020 2020 2020 2020 dmsr. │ │ │ │ -00001ad0: 2020 2020 2020 286c 696e 6520 3629 0a2a (line 6).* │ │ │ │ -00001ae0: 2072 6561 643a 2020 2020 2020 2020 2020 read: │ │ │ │ +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: │ │ │ │ 00001af0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00001b00: 2020 2020 2020 2020 7265 6164 2e20 2020 read. │ │ │ │ -00001b10: 2020 2020 2020 2020 2020 2020 2020 2028 ( │ │ │ │ -00001b20: 6c69 6e65 2036 290a 2a20 7265 626f 6f74 line 6).* reboot │ │ │ │ -00001b30: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ +00001b00: 2020 2020 2020 2020 2020 7265 6164 2e20 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: │ │ │ │ 00001b40: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00001b50: 2072 6562 6f6f 742e 2020 2020 2020 2020 reboot. │ │ │ │ -00001b60: 2020 2020 2020 2020 286c 696e 6520 3629 (line 6) │ │ │ │ -00001b70: 0a2a 2072 6567 6578 703a 2020 2020 2020 .* regexp: │ │ │ │ +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: │ │ │ │ 00001b80: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00001b90: 2020 2020 2020 2020 2020 7265 6765 7870 regexp │ │ │ │ -00001ba0: 2e20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ -00001bb0: 2028 6c69 6e65 2036 290a 2a20 726d 6d6f (line 6).* rmmo │ │ │ │ -00001bc0: 643a 2020 2020 2020 2020 2020 2020 2020 d: │ │ │ │ +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: │ │ │ │ 00001bd0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00001be0: 2020 2072 6d6d 6f64 2e20 2020 2020 2020 rmmod. │ │ │ │ -00001bf0: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ -00001c00: 3629 0a2a 2073 6176 655f 656e 763a 2020 6).* save_env: │ │ │ │ +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 7361 7665 save │ │ │ │ -00001c30: 5f65 6e76 2e20 2020 2020 2020 2020 2020 _env. │ │ │ │ -00001c40: 2020 2028 6c69 6e65 2036 290a 2a20 7365 (line 6).* se │ │ │ │ -00001c50: 6172 6368 3a20 2020 2020 2020 2020 2020 arch: │ │ │ │ +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: │ │ │ │ 00001c60: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00001c70: 2020 2020 2073 6561 7263 682e 2020 2020 search. │ │ │ │ -00001c80: 2020 2020 2020 2020 2020 2020 286c 696e (lin │ │ │ │ -00001c90: 6520 3629 0a2a 2073 656e 646b 6579 3a20 e 6).* sendkey: │ │ │ │ -00001ca0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00001cb0: 2020 2020 2020 2020 2020 2020 2020 7365 se │ │ │ │ -00001cc0: 6e64 6b65 792e 2020 2020 2020 2020 2020 ndkey. │ │ │ │ -00001cd0: 2020 2020 2028 6c69 6e65 2036 290a 2a20 (line 6).* │ │ │ │ -00001ce0: 7365 7269 616c 3a20 2020 2020 2020 2020 serial: │ │ │ │ +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 : │ │ │ │ +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: │ │ │ │ 00001cf0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00001d00: 2020 2020 2020 2073 6572 6961 6c2e 2020 serial. │ │ │ │ -00001d10: 2020 2020 2020 2020 2020 2020 2020 286c (l │ │ │ │ -00001d20: 696e 6520 3629 0a2a 2073 6574 3a20 2020 ine 6).* set: │ │ │ │ +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: │ │ │ │ 00001d30: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ 00001d40: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00001d50: 7365 742e 2020 2020 2020 2020 2020 2020 set. │ │ │ │ -00001d60: 2020 2020 2020 2028 6c69 6e65 2036 290a (line 6). │ │ │ │ -00001d70: 2a20 7368 6131 7375 6d3a 2020 2020 2020 * sha1sum: │ │ │ │ +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: │ │ │ │ 00001d80: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00001d90: 2020 2020 2020 2020 2073 6861 3173 756d sha1sum │ │ │ │ -00001da0: 2e20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ -00001db0: 286c 696e 6520 3629 0a2a 2073 6861 3235 (line 6).* sha25 │ │ │ │ -00001dc0: 3673 756d 3a20 2020 2020 2020 2020 2020 6sum: │ │ │ │ +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: │ │ │ │ 00001dd0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00001de0: 2020 7368 6132 3536 7375 6d2e 2020 2020 sha256sum. │ │ │ │ -00001df0: 2020 2020 2020 2020 2028 6c69 6e65 2036 (line 6 │ │ │ │ -00001e00: 290a 2a20 7368 6135 3132 7375 6d3a 2020 ).* sha512sum: │ │ │ │ +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 2073 6861 3531 sha51 │ │ │ │ -00001e30: 3273 756d 2e20 2020 2020 2020 2020 2020 2sum. │ │ │ │ -00001e40: 2020 286c 696e 6520 3629 0a2a 2073 6c65 (line 6).* sle │ │ │ │ -00001e50: 6570 3a20 2020 2020 2020 2020 2020 2020 ep: │ │ │ │ +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: │ │ │ │ 00001e60: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00001e70: 2020 2020 736c 6565 702e 2020 2020 2020 sleep. │ │ │ │ -00001e80: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ -00001e90: 2036 290a 2a20 736f 7572 6365 3a20 2020 6).* source: │ │ │ │ +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 736f 7572 6365 3a20 ne 6).* source: │ │ │ │ 00001ea0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00001eb0: 2020 2020 2020 2020 2020 2020 2073 6f75 sou │ │ │ │ -00001ec0: 7263 652e 2020 2020 2020 2020 2020 2020 rce. │ │ │ │ -00001ed0: 2020 2020 286c 696e 6520 3629 0a2a 2073 (line 6).* s │ │ │ │ -00001ee0: 7562 6d65 6e75 3a20 2020 2020 2020 2020 ubmenu: │ │ │ │ +00001eb0: 2020 2020 2020 2020 2020 2020 2020 2073 s │ │ │ │ +00001ec0: 6f75 7263 652e 2020 2020 2020 2020 2020 ource. │ │ │ │ +00001ed0: 2020 2020 2020 286c 696e 6520 3629 0a2a (line 6).* │ │ │ │ +00001ee0: 2073 7562 6d65 6e75 3a20 2020 2020 2020 submenu: │ │ │ │ 00001ef0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00001f00: 2020 2020 2020 7375 626d 656e 752e 2020 submenu. │ │ │ │ -00001f10: 2020 2020 2020 2020 2020 2020 2028 6c69 (li │ │ │ │ -00001f20: 6e65 2036 290a 2a20 7465 726d 696e 616c ne 6).* terminal │ │ │ │ -00001f30: 5f69 6e70 7574 3a20 2020 2020 2020 2020 _input: │ │ │ │ -00001f40: 2020 2020 2020 2020 2020 2020 2020 2074 t │ │ │ │ -00001f50: 6572 6d69 6e61 6c5f 696e 7075 742e 2020 erminal_input. │ │ │ │ -00001f60: 2020 2020 2020 286c 696e 6520 3629 0a2a (line 6).* │ │ │ │ -00001f70: 2074 6572 6d69 6e61 6c5f 6f75 7470 7574 terminal_output │ │ │ │ -00001f80: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ -00001f90: 2020 2020 2020 2020 7465 726d 696e 616c terminal │ │ │ │ -00001fa0: 5f6f 7574 7075 742e 2020 2020 2020 2028 _output. ( │ │ │ │ -00001fb0: 6c69 6e65 2036 290a 2a20 7465 726d 696e line 6).* termin │ │ │ │ -00001fc0: 666f 3a20 2020 2020 2020 2020 2020 2020 fo: │ │ │ │ +00001f00: 2020 2020 2020 2020 7375 626d 656e 752e submenu. │ │ │ │ +00001f10: 2020 2020 2020 2020 2020 2020 2020 2028 ( │ │ │ │ +00001f20: 6c69 6e65 2036 290a 2a20 7465 726d 696e line 6).* termin │ │ │ │ +00001f30: 616c 5f69 6e70 7574 3a20 2020 2020 2020 al_input: │ │ │ │ +00001f40: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00001f50: 2074 6572 6d69 6e61 6c5f 696e 7075 742e terminal_input. │ │ │ │ +00001f60: 2020 2020 2020 2020 286c 696e 6520 3629 (line 6) │ │ │ │ +00001f70: 0a2a 2074 6572 6d69 6e61 6c5f 6f75 7470 .* terminal_outp │ │ │ │ +00001f80: 7574 3a20 2020 2020 2020 2020 2020 2020 ut: │ │ │ │ +00001f90: 2020 2020 2020 2020 2020 7465 726d 696e termin │ │ │ │ +00001fa0: 616c 5f6f 7574 7075 742e 2020 2020 2020 al_output. │ │ │ │ +00001fb0: 2028 6c69 6e65 2036 290a 2a20 7465 726d (line 6).* term │ │ │ │ +00001fc0: 696e 666f 3a20 2020 2020 2020 2020 2020 info: │ │ │ │ 00001fd0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00001fe0: 2074 6572 6d69 6e66 6f2e 2020 2020 2020 terminfo. │ │ │ │ -00001ff0: 2020 2020 2020 2020 286c 696e 6520 3629 (line 6) │ │ │ │ -00002000: 0a2a 2074 6573 743a 2020 2020 2020 2020 .* test: │ │ │ │ +00001fe0: 2020 2074 6572 6d69 6e66 6f2e 2020 2020 terminfo. │ │ │ │ +00001ff0: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ +00002000: 3629 0a2a 2074 6573 743a 2020 2020 2020 6).* test: │ │ │ │ 00002010: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00002020: 2020 2020 2020 2020 2020 7465 7374 2e20 test. │ │ │ │ -00002030: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00002040: 2028 6c69 6e65 2036 290a 2a20 7472 7565 (line 6).* true │ │ │ │ -00002050: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ +00002020: 2020 2020 2020 2020 2020 2020 7465 7374 test │ │ │ │ +00002030: 2e20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ +00002040: 2020 2028 6c69 6e65 2036 290a 2a20 7472 (line 6).* tr │ │ │ │ +00002050: 7565 3a20 2020 2020 2020 2020 2020 2020 ue: │ │ │ │ 00002060: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00002070: 2020 2074 7275 652e 2020 2020 2020 2020 true. │ │ │ │ -00002080: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ -00002090: 3629 0a2a 2074 7275 7374 3a20 2020 2020 6).* trust: │ │ │ │ +00002070: 2020 2020 2074 7275 652e 2020 2020 2020 true. │ │ │ │ +00002080: 2020 2020 2020 2020 2020 2020 286c 696e (lin │ │ │ │ +00002090: 6520 3629 0a2a 2074 7275 7374 3a20 2020 e 6).* trust: │ │ │ │ 000020a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -000020b0: 2020 2020 2020 2020 2020 2020 7472 7573 trus │ │ │ │ -000020c0: 742e 2020 2020 2020 2020 2020 2020 2020 t. │ │ │ │ -000020d0: 2020 2028 6c69 6e65 2036 290a 2a20 756e (line 6).* un │ │ │ │ -000020e0: 7365 743a 2020 2020 2020 2020 2020 2020 set: │ │ │ │ +000020b0: 2020 2020 2020 2020 2020 2020 2020 7472 tr │ │ │ │ +000020c0: 7573 742e 2020 2020 2020 2020 2020 2020 ust. │ │ │ │ +000020d0: 2020 2020 2028 6c69 6e65 2036 290a 2a20 (line 6).* │ │ │ │ +000020e0: 756e 7365 743a 2020 2020 2020 2020 2020 unset: │ │ │ │ 000020f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00002100: 2020 2020 2075 6e73 6574 2e20 2020 2020 unset. │ │ │ │ -00002110: 2020 2020 2020 2020 2020 2020 286c 696e (lin │ │ │ │ -00002120: 6520 3629 0a2a 2076 6572 6966 795f 6465 e 6).* verify_de │ │ │ │ -00002130: 7461 6368 6564 3a20 2020 2020 2020 2020 tached: │ │ │ │ -00002140: 2020 2020 2020 2020 2020 2020 2020 7665 ve │ │ │ │ -00002150: 7269 6679 5f64 6574 6163 6865 642e 2020 rify_detached. │ │ │ │ -00002160: 2020 2020 2028 6c69 6e65 2036 290a 2a20 (line 6).* │ │ │ │ -00002170: 7669 6465 6f69 6e66 6f3a 2020 2020 2020 videoinfo: │ │ │ │ +00002100: 2020 2020 2020 2075 6e73 6574 2e20 2020 unset. │ │ │ │ +00002110: 2020 2020 2020 2020 2020 2020 2020 286c (l │ │ │ │ +00002120: 696e 6520 3629 0a2a 2076 6572 6966 795f ine 6).* verify_ │ │ │ │ +00002130: 6465 7461 6368 6564 3a20 2020 2020 2020 detached: │ │ │ │ +00002140: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00002150: 7665 7269 6679 5f64 6574 6163 6865 642e verify_detached. │ │ │ │ +00002160: 2020 2020 2020 2028 6c69 6e65 2036 290a (line 6). │ │ │ │ +00002170: 2a20 7669 6465 6f69 6e66 6f3a 2020 2020 * videoinfo: │ │ │ │ 00002180: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00002190: 2020 2020 2020 2076 6964 656f 696e 666f videoinfo │ │ │ │ -000021a0: 2e20 2020 2020 2020 2020 2020 2020 286c . (l │ │ │ │ -000021b0: 696e 6520 3629 0a2a 2077 726d 7372 3a20 ine 6).* wrmsr: │ │ │ │ -000021c0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ +00002190: 2020 2020 2020 2020 2076 6964 656f 696e videoin │ │ │ │ +000021a0: 666f 2e20 2020 2020 2020 2020 2020 2020 fo. │ │ │ │ +000021b0: 286c 696e 6520 3629 0a2a 2077 726d 7372 (line 6).* wrmsr │ │ │ │ +000021c0: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ 000021d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -000021e0: 7772 6d73 722e 2020 2020 2020 2020 2020 wrmsr. │ │ │ │ -000021f0: 2020 2020 2020 2028 6c69 6e65 2036 290a (line 6). │ │ │ │ -00002200: 2a20 7865 6e5f 6879 7065 7276 6973 6f72 * xen_hypervisor │ │ │ │ -00002210: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ -00002220: 2020 2020 2020 2020 2078 656e 5f68 7970 xen_hyp │ │ │ │ -00002230: 6572 7669 736f 722e 2020 2020 2020 2020 ervisor. │ │ │ │ -00002240: 286c 696e 6520 3629 0a2a 2078 656e 5f6d (line 6).* xen_m │ │ │ │ -00002250: 6f64 756c 653a 2020 2020 2020 2020 2020 odule: │ │ │ │ +000021e0: 2020 7772 6d73 722e 2020 2020 2020 2020 wrmsr. │ │ │ │ +000021f0: 2020 2020 2020 2020 2028 6c69 6e65 2036 (line 6 │ │ │ │ +00002200: 290a 2a20 7865 6e5f 6879 7065 7276 6973 ).* xen_hypervis │ │ │ │ +00002210: 6f72 3a20 2020 2020 2020 2020 2020 2020 or: │ │ │ │ +00002220: 2020 2020 2020 2020 2020 2078 656e 5f68 xen_h │ │ │ │ +00002230: 7970 6572 7669 736f 722e 2020 2020 2020 ypervisor. │ │ │ │ +00002240: 2020 286c 696e 6520 3629 0a2a 2078 656e (line 6).* xen │ │ │ │ +00002250: 5f6d 6f64 756c 653a 2020 2020 2020 2020 _module: │ │ │ │ 00002260: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ -00002270: 2020 7865 6e5f 6d6f 6475 6c65 2e20 2020 xen_module. │ │ │ │ -00002280: 2020 2020 2020 2020 2028 6c69 6e65 2036 (line 6 │ │ │ │ -00002290: 290a 0a ).. │ │ │ │ +00002270: 2020 2020 7865 6e5f 6d6f 6475 6c65 2e20 xen_module. │ │ │ │ +00002280: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ +00002290: 2036 290a 0a 6).. │ │ ├── ./usr/share/info/grub.info.gz │ │ │ ├── grub.info │ │ │ │ @@ -1,508 +1,508 @@ │ │ │ │ 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 3720 6672 6f6d 2067 7275 622e 7465 6.7 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 3034 2c20 (version 2.04, │ │ │ │ -00000070: 3130 204a 756c 7920 3230 3231 292e 0a0a 10 July 2021)... │ │ │ │ -00000080: 2020 2043 6f70 7972 6967 6874 2028 4329 Copyright (C) │ │ │ │ -00000090: 0a31 3939 392c 3230 3030 2c32 3030 312c .1999,2000,2001, │ │ │ │ -000000a0: 3230 3032 2c32 3030 342c 3230 3036 2c32 2002,2004,2006,2 │ │ │ │ -000000b0: 3030 382c 3230 3039 2c32 3031 302c 3230 008,2009,2010,20 │ │ │ │ -000000c0: 3131 2c32 3031 322c 3230 3133 2046 7265 11,2012,2013 Fre │ │ │ │ -000000d0: 650a 536f 6674 7761 7265 2046 6f75 6e64 e.Software Found │ │ │ │ -000000e0: 6174 696f 6e2c 2049 6e63 2e0a 0a20 2020 ation, Inc... │ │ │ │ -000000f0: 2020 5065 726d 6973 7369 6f6e 2069 7320 Permission is │ │ │ │ -00000100: 6772 616e 7465 6420 746f 2063 6f70 792c granted to copy, │ │ │ │ -00000110: 2064 6973 7472 6962 7574 6520 616e 642f distribute and/ │ │ │ │ -00000120: 6f72 206d 6f64 6966 7920 7468 6973 0a20 or modify this. │ │ │ │ -00000130: 2020 2020 646f 6375 6d65 6e74 2075 6e64 document und │ │ │ │ -00000140: 6572 2074 6865 2074 6572 6d73 206f 6620 er the terms of │ │ │ │ -00000150: 7468 6520 474e 5520 4672 6565 2044 6f63 the GNU Free Doc │ │ │ │ -00000160: 756d 656e 7461 7469 6f6e 204c 6963 656e umentation Licen │ │ │ │ -00000170: 7365 2c0a 2020 2020 2056 6572 7369 6f6e se,. Version │ │ │ │ -00000180: 2031 2e32 206f 7220 616e 7920 6c61 7465 1.2 or any late │ │ │ │ -00000190: 7220 7665 7273 696f 6e20 7075 626c 6973 r version publis │ │ │ │ -000001a0: 6865 6420 6279 2074 6865 2046 7265 6520 hed by the Free │ │ │ │ -000001b0: 536f 6674 7761 7265 0a20 2020 2020 466f Software. Fo │ │ │ │ -000001c0: 756e 6461 7469 6f6e 3b20 7769 7468 206e undation; with n │ │ │ │ -000001d0: 6f20 496e 7661 7269 616e 7420 5365 6374 o Invariant Sect │ │ │ │ -000001e0: 696f 6e73 2e0a 494e 464f 2d44 4952 2d53 ions..INFO-DIR-S │ │ │ │ -000001f0: 4543 5449 4f4e 204b 6572 6e65 6c0a 5354 ECTION Kernel.ST │ │ │ │ -00000200: 4152 542d 494e 464f 2d44 4952 2d45 4e54 ART-INFO-DIR-ENT │ │ │ │ -00000210: 5259 0a2a 2047 5255 423a 2028 6772 7562 RY.* GRUB: (grub │ │ │ │ -00000220: 292e 2020 2020 2020 2020 2020 2020 2020 ). │ │ │ │ -00000230: 2020 2054 6865 2047 5261 6e64 2055 6e69 The GRand Uni │ │ │ │ -00000240: 6669 6564 2042 6f6f 746c 6f61 6465 720a fied Bootloader. │ │ │ │ -00000250: 2a20 6772 7562 2d69 6e73 7461 6c6c 3a20 * grub-install: │ │ │ │ -00000260: 2867 7275 6229 496e 766f 6b69 6e67 2067 (grub)Invoking g │ │ │ │ -00000270: 7275 622d 696e 7374 616c 6c2e 2020 2020 rub-install. │ │ │ │ -00000280: 496e 7374 616c 6c20 4752 5542 206f 6e20 Install GRUB on │ │ │ │ -00000290: 796f 7572 2064 7269 7665 0a2a 2067 7275 your drive.* gru │ │ │ │ -000002a0: 622d 6d6b 636f 6e66 6967 3a20 2867 7275 b-mkconfig: (gru │ │ │ │ -000002b0: 6229 496e 766f 6b69 6e67 2067 7275 622d b)Invoking grub- │ │ │ │ -000002c0: 6d6b 636f 6e66 6967 2e20 2047 656e 6572 mkconfig. Gener │ │ │ │ -000002d0: 6174 6520 4752 5542 2063 6f6e 6669 6775 ate GRUB configu │ │ │ │ -000002e0: 7261 7469 6f6e 0a2a 2067 7275 622d 6d6b ration.* grub-mk │ │ │ │ -000002f0: 7061 7373 7764 2d70 626b 6466 323a 2028 passwd-pbkdf2: ( │ │ │ │ -00000300: 6772 7562 2949 6e76 6f6b 696e 6720 6772 grub)Invoking gr │ │ │ │ -00000310: 7562 2d6d 6b70 6173 7377 642d 7062 6b64 ub-mkpasswd-pbkd │ │ │ │ -00000320: 6632 2e0a 2a20 6772 7562 2d6d 6b72 656c f2..* grub-mkrel │ │ │ │ -00000330: 7061 7468 3a20 2867 7275 6229 496e 766f path: (grub)Invo │ │ │ │ -00000340: 6b69 6e67 2067 7275 622d 6d6b 7265 6c70 king grub-mkrelp │ │ │ │ -00000350: 6174 682e 0a2a 2067 7275 622d 6d6b 7265 ath..* grub-mkre │ │ │ │ -00000360: 7363 7565 3a20 2867 7275 6229 496e 766f scue: (grub)Invo │ │ │ │ -00000370: 6b69 6e67 2067 7275 622d 6d6b 7265 7363 king grub-mkresc │ │ │ │ -00000380: 7565 2e20 204d 616b 6520 6120 4752 5542 ue. Make a GRUB │ │ │ │ -00000390: 2072 6573 6375 6520 696d 6167 650a 2a20 rescue image.* │ │ │ │ -000003a0: 6772 7562 2d6d 6f75 6e74 3a20 2867 7275 grub-mount: (gru │ │ │ │ -000003b0: 6229 496e 766f 6b69 6e67 2067 7275 622d b)Invoking grub- │ │ │ │ -000003c0: 6d6f 756e 742e 2020 2020 2020 2020 4d6f mount. Mo │ │ │ │ -000003d0: 756e 7420 6120 6669 6c65 2073 7973 7465 unt a file syste │ │ │ │ -000003e0: 6d20 7573 696e 6720 4752 5542 0a2a 2067 m using GRUB.* g │ │ │ │ -000003f0: 7275 622d 7072 6f62 653a 2028 6772 7562 rub-probe: (grub │ │ │ │ -00000400: 2949 6e76 6f6b 696e 6720 6772 7562 2d70 )Invoking grub-p │ │ │ │ -00000410: 726f 6265 2e20 2020 2020 2020 2050 726f robe. Pro │ │ │ │ -00000420: 6265 2064 6576 6963 6520 696e 666f 726d be device inform │ │ │ │ -00000430: 6174 696f 6e0a 2a20 6772 7562 2d73 6372 ation.* grub-scr │ │ │ │ -00000440: 6970 742d 6368 6563 6b3a 2028 6772 7562 ipt-check: (grub │ │ │ │ -00000450: 2949 6e76 6f6b 696e 6720 6772 7562 2d73 )Invoking grub-s │ │ │ │ -00000460: 6372 6970 742d 6368 6563 6b2e 0a45 4e44 cript-check..END │ │ │ │ -00000470: 2d49 4e46 4f2d 4449 522d 454e 5452 590a -INFO-DIR-ENTRY. │ │ │ │ -00000480: 0a1f 0a49 6e64 6972 6563 743a 0a67 7275 ...Indirect:.gru │ │ │ │ -00000490: 622e 696e 666f 2d31 3a20 3131 3533 0a67 b.info-1: 1153.g │ │ │ │ -000004a0: 7275 622e 696e 666f 2d32 3a20 3330 3334 rub.info-2: 3034 │ │ │ │ -000004b0: 3833 0a1f 0a54 6167 2054 6162 6c65 3a0a 83...Tag Table:. │ │ │ │ -000004c0: 2849 6e64 6972 6563 7429 0a4e 6f64 653a (Indirect).Node: │ │ │ │ -000004d0: 2054 6f70 7f31 3135 330a 4e6f 6465 3a20 Top.1153.Node: │ │ │ │ -000004e0: 496e 7472 6f64 7563 7469 6f6e 7f34 3230 Introduction.420 │ │ │ │ -000004f0: 310a 4e6f 6465 3a20 4f76 6572 7669 6577 1.Node: Overview │ │ │ │ -00000500: 7f34 3634 350a 4e6f 6465 3a20 4f76 6572 .4645.Node: Over │ │ │ │ -00000510: 7669 6577 2d46 6f6f 746e 6f74 6573 7f36 view-Footnotes.6 │ │ │ │ -00000520: 3633 350a 5265 663a 204f 7665 7276 6965 635.Ref: Overvie │ │ │ │ -00000530: 772d 466f 6f74 6e6f 7465 2d31 7f36 3639 w-Footnote-1.669 │ │ │ │ -00000540: 360a 4e6f 6465 3a20 4869 7374 6f72 797f 6.Node: History. │ │ │ │ -00000550: 3638 3538 0a4e 6f64 653a 2043 6861 6e67 6858.Node: Chang │ │ │ │ -00000560: 6573 2066 726f 6d20 4752 5542 204c 6567 es from GRUB Leg │ │ │ │ -00000570: 6163 797f 3839 3438 0a4e 6f64 653a 2046 acy.8948.Node: F │ │ │ │ -00000580: 6561 7475 7265 737f 3131 3432 340a 4e6f eatures.11424.No │ │ │ │ -00000590: 6465 3a20 4665 6174 7572 6573 2d46 6f6f de: Features-Foo │ │ │ │ -000005a0: 746e 6f74 6573 7f31 3738 3531 0a52 6566 tnotes.17851.Ref │ │ │ │ -000005b0: 3a20 4665 6174 7572 6573 2d46 6f6f 746e : Features-Footn │ │ │ │ -000005c0: 6f74 652d 317f 3137 3931 320a 5265 663a ote-1.17912.Ref: │ │ │ │ -000005d0: 2046 6561 7475 7265 732d 466f 6f74 6e6f Features-Footno │ │ │ │ -000005e0: 7465 2d32 7f31 3830 3038 0a52 6566 3a20 te-2.18008.Ref: │ │ │ │ -000005f0: 4665 6174 7572 6573 2d46 6f6f 746e 6f74 Features-Footnot │ │ │ │ -00000600: 652d 337f 3138 3135 350a 4e6f 6465 3a20 e-3.18155.Node: │ │ │ │ -00000610: 526f 6c65 206f 6620 6120 626f 6f74 206c Role of a boot l │ │ │ │ -00000620: 6f61 6465 727f 3138 3330 300a 4e6f 6465 oader.18300.Node │ │ │ │ -00000630: 3a20 526f 6c65 206f 6620 6120 626f 6f74 : Role of a boot │ │ │ │ -00000640: 206c 6f61 6465 722d 466f 6f74 6e6f 7465 loader-Footnote │ │ │ │ -00000650: 737f 3139 3633 390a 5265 663a 2052 6f6c s.19639.Ref: Rol │ │ │ │ -00000660: 6520 6f66 2061 2062 6f6f 7420 6c6f 6164 e of a boot load │ │ │ │ -00000670: 6572 2d46 6f6f 746e 6f74 652d 317f 3139 er-Footnote-1.19 │ │ │ │ -00000680: 3732 360a 4e6f 6465 3a20 4e61 6d69 6e67 726.Node: Naming │ │ │ │ -00000690: 2063 6f6e 7665 6e74 696f 6e7f 3139 3830 convention.1980 │ │ │ │ -000006a0: 350a 4e6f 6465 3a20 4f53 2d73 7065 6369 5.Node: OS-speci │ │ │ │ -000006b0: 6669 6320 6e6f 7465 7320 6162 6f75 7420 fic notes about │ │ │ │ -000006c0: 6772 7562 2074 6f6f 6c73 7f32 3237 3136 grub tools.22716 │ │ │ │ -000006d0: 0a4e 6f64 653a 2049 6e73 7461 6c6c 6174 .Node: Installat │ │ │ │ -000006e0: 696f 6e7f 3233 3735 320a 4e6f 6465 3a20 ion.23752.Node: │ │ │ │ -000006f0: 496e 7374 616c 6c69 6e67 2047 5255 4220 Installing GRUB │ │ │ │ -00000700: 7573 696e 6720 6772 7562 2d69 6e73 7461 using grub-insta │ │ │ │ -00000710: 6c6c 7f32 3438 3734 0a4e 6f64 653a 204d ll.24874.Node: M │ │ │ │ -00000720: 616b 696e 6720 6120 4752 5542 2062 6f6f aking a GRUB boo │ │ │ │ -00000730: 7461 626c 6520 4344 2d52 4f4d 7f32 3735 table CD-ROM.275 │ │ │ │ -00000740: 3631 0a4e 6f64 653a 204d 616b 696e 6720 61.Node: Making │ │ │ │ -00000750: 6120 4752 5542 2062 6f6f 7461 626c 6520 a GRUB bootable │ │ │ │ -00000760: 4344 2d52 4f4d 2d46 6f6f 746e 6f74 6573 CD-ROM-Footnotes │ │ │ │ -00000770: 7f32 3934 3230 0a52 6566 3a20 4d61 6b69 .29420.Ref: Maki │ │ │ │ -00000780: 6e67 2061 2047 5255 4220 626f 6f74 6162 ng a GRUB bootab │ │ │ │ -00000790: 6c65 2043 442d 524f 4d2d 466f 6f74 6e6f le CD-ROM-Footno │ │ │ │ -000007a0: 7465 2d31 7f32 3935 3233 0a4e 6f64 653a te-1.29523.Node: │ │ │ │ -000007b0: 2044 6576 6963 6520 6d61 707f 3239 3539 Device map.2959 │ │ │ │ -000007c0: 380a 4e6f 6465 3a20 4249 4f53 2069 6e73 8.Node: BIOS ins │ │ │ │ -000007d0: 7461 6c6c 6174 696f 6e7f 3331 3536 350a tallation.31565. │ │ │ │ -000007e0: 4e6f 6465 3a20 426f 6f74 696e 677f 3334 Node: Booting.34 │ │ │ │ -000007f0: 3934 310a 4e6f 6465 3a20 4765 6e65 7261 941.Node: Genera │ │ │ │ -00000800: 6c20 626f 6f74 206d 6574 686f 6473 7f33 l boot methods.3 │ │ │ │ -00000810: 3533 3937 0a4e 6f64 653a 204c 6f61 6469 5397.Node: Loadi │ │ │ │ -00000820: 6e67 2061 6e20 6f70 6572 6174 696e 6720 ng an operating │ │ │ │ -00000830: 7379 7374 656d 2064 6972 6563 746c 797f system directly. │ │ │ │ -00000840: 3336 3134 300a 4e6f 6465 3a20 4368 6169 36140.Node: Chai │ │ │ │ -00000850: 6e2d 6c6f 6164 696e 677f 3336 3837 310a n-loading.36871. │ │ │ │ -00000860: 4e6f 6465 3a20 4c6f 6f70 6261 636b 2062 Node: Loopback b │ │ │ │ -00000870: 6f6f 7469 6e67 7f33 3738 3432 0a4e 6f64 ooting.37842.Nod │ │ │ │ -00000880: 653a 204f 532d 7370 6563 6966 6963 206e e: OS-specific n │ │ │ │ -00000890: 6f74 6573 7f33 3935 3136 0a4e 6f64 653a otes.39516.Node: │ │ │ │ -000008a0: 2047 4e55 2f48 7572 647f 3339 3830 350a GNU/Hurd.39805. │ │ │ │ -000008b0: 4e6f 6465 3a20 474e 552f 4c69 6e75 787f Node: GNU/Linux. │ │ │ │ -000008c0: 3430 3932 380a 4e6f 6465 3a20 4e65 7442 40928.Node: NetB │ │ │ │ -000008d0: 5344 7f34 3235 3534 0a4e 6f64 653a 2044 SD.42554.Node: D │ │ │ │ -000008e0: 4f53 2f57 696e 646f 7773 7f34 3430 3238 OS/Windows.44028 │ │ │ │ -000008f0: 0a4e 6f64 653a 2043 6f6e 6669 6775 7261 .Node: Configura │ │ │ │ -00000900: 7469 6f6e 7f34 3538 3036 0a4e 6f64 653a tion.45806.Node: │ │ │ │ -00000910: 2053 696d 706c 6520 636f 6e66 6967 7572 Simple configur │ │ │ │ -00000920: 6174 696f 6e7f 3436 3531 380a 4e6f 6465 ation.46518.Node │ │ │ │ -00000930: 3a20 526f 6f74 2049 6465 6e74 6966 6361 : Root Identifca │ │ │ │ -00000940: 7469 6f6e 2048 6575 7269 7374 6963 737f tion Heuristics. │ │ │ │ -00000950: 3633 3035 300a 4e6f 6465 3a20 5368 656c 63050.Node: Shel │ │ │ │ -00000960: 6c2d 6c69 6b65 2073 6372 6970 7469 6e67 l-like scripting │ │ │ │ -00000970: 7f36 3630 3634 0a4e 6f64 653a 2053 6865 .66064.Node: She │ │ │ │ -00000980: 6c6c 2d6c 696b 6520 7363 7269 7074 696e ll-like scriptin │ │ │ │ -00000990: 672d 466f 6f74 6e6f 7465 737f 3734 3132 g-Footnotes.7412 │ │ │ │ -000009a0: 370a 5265 663a 2053 6865 6c6c 2d6c 696b 7.Ref: Shell-lik │ │ │ │ -000009b0: 6520 7363 7269 7074 696e 672d 466f 6f74 e scripting-Foot │ │ │ │ -000009c0: 6e6f 7465 2d31 7f37 3432 3132 0a4e 6f64 note-1.74212.Nod │ │ │ │ -000009d0: 653a 204d 756c 7469 2d62 6f6f 7420 6d61 e: Multi-boot ma │ │ │ │ -000009e0: 6e75 616c 2063 6f6e 6669 677f 3734 3333 nual config.7433 │ │ │ │ -000009f0: 390a 4e6f 6465 3a20 456d 6265 6464 6564 9.Node: Embedded │ │ │ │ -00000a00: 2063 6f6e 6669 6775 7261 7469 6f6e 7f37 configuration.7 │ │ │ │ -00000a10: 3739 3638 0a4e 6f64 653a 2054 6865 6d65 7968.Node: Theme │ │ │ │ -00000a20: 2066 696c 6520 666f 726d 6174 7f38 3038 file format.808 │ │ │ │ -00000a30: 3034 0a52 6566 3a20 5069 786d 6170 2d73 04.Ref: Pixmap-s │ │ │ │ -00000a40: 7479 6c65 6420 7072 6f67 7265 7373 2062 tyled progress b │ │ │ │ -00000a50: 6172 7f38 3232 3633 0a52 6566 3a20 506c ar.82263.Ref: Pl │ │ │ │ -00000a60: 6169 6e20 7072 6f67 7265 7373 2062 6172 ain progress bar │ │ │ │ -00000a70: 2c20 6472 6177 6e20 7769 7468 2073 6f6c , drawn with sol │ │ │ │ -00000a80: 6964 2063 6f6c 6f72 2e7f 3832 3237 350a id color..82275. │ │ │ │ -00000a90: 5265 663a 2041 6e20 6578 616d 706c 6520 Ref: An example │ │ │ │ -00000aa0: 6f66 2074 6865 2073 6c69 6365 7320 2869 of the slices (i │ │ │ │ -00000ab0: 6e20 7265 6429 2075 7365 6420 666f 7220 n red) used for │ │ │ │ -00000ac0: 6120 7465 726d 696e 616c 2077 696e 646f a terminal windo │ │ │ │ -00000ad0: 772e 2054 6869 7320 6472 6177 696e 6720 w. This drawing │ │ │ │ -00000ae0: 7761 7320 6372 6561 7465 6420 616e 6420 was created and │ │ │ │ -00000af0: 736c 6963 6564 2069 6e20 496e 6b73 6361 sliced in Inksca │ │ │ │ -00000b00: 7065 5f2c 2061 7320 7468 6520 6e65 7874 pe_, as the next │ │ │ │ -00000b10: 2073 6563 7469 6f6e 2065 7870 6c61 696e section explain │ │ │ │ -00000b20: 732e 7f38 3537 3637 0a4e 6f64 653a 204e s..85767.Node: N │ │ │ │ -00000b30: 6574 776f 726b 7f31 3036 3137 390a 4e6f etwork.106179.No │ │ │ │ -00000b40: 6465 3a20 5365 7269 616c 2074 6572 6d69 de: Serial termi │ │ │ │ -00000b50: 6e61 6c7f 3130 3839 3036 0a4e 6f64 653a nal.108906.Node: │ │ │ │ -00000b60: 2056 656e 646f 7220 706f 7765 722d 6f6e Vendor power-on │ │ │ │ -00000b70: 206b 6579 737f 3131 3131 3433 0a4e 6f64 keys.111143.Nod │ │ │ │ -00000b80: 653a 2049 6d61 6765 737f 3131 3330 3738 e: Images.113078 │ │ │ │ -00000b90: 0a4e 6f64 653a 2043 6f72 6520 696d 6167 .Node: Core imag │ │ │ │ -00000ba0: 6520 7369 7a65 206c 696d 6974 6174 696f e size limitatio │ │ │ │ -00000bb0: 6e7f 3131 3830 3533 0a4e 6f64 653a 2046 n.118053.Node: F │ │ │ │ -00000bc0: 696c 6573 7973 7465 6d7f 3132 3036 3137 ilesystem.120617 │ │ │ │ -00000bd0: 0a4e 6f64 653a 2044 6576 6963 6520 7379 .Node: Device sy │ │ │ │ -00000be0: 6e74 6178 7f31 3231 3332 360a 4e6f 6465 ntax.121326.Node │ │ │ │ -00000bf0: 3a20 4669 6c65 206e 616d 6520 7379 6e74 : File name synt │ │ │ │ -00000c00: 6178 7f31 3234 3032 370a 4e6f 6465 3a20 ax.124027.Node: │ │ │ │ -00000c10: 426c 6f63 6b20 6c69 7374 2073 796e 7461 Block list synta │ │ │ │ -00000c20: 787f 3132 3530 3733 0a4e 6f64 653a 2049 x.125073.Node: I │ │ │ │ -00000c30: 6e74 6572 6661 6365 7f31 3235 3830 370a nterface.125807. │ │ │ │ -00000c40: 4e6f 6465 3a20 436f 6d6d 616e 642d 6c69 Node: Command-li │ │ │ │ -00000c50: 6e65 2069 6e74 6572 6661 6365 7f31 3236 ne interface.126 │ │ │ │ -00000c60: 3633 310a 4e6f 6465 3a20 436f 6d6d 616e 631.Node: Comman │ │ │ │ -00000c70: 642d 6c69 6e65 2069 6e74 6572 6661 6365 d-line interface │ │ │ │ -00000c80: 2d46 6f6f 746e 6f74 6573 7f31 3238 3537 -Footnotes.12857 │ │ │ │ -00000c90: 350a 5265 663a 2043 6f6d 6d61 6e64 2d6c 5.Ref: Command-l │ │ │ │ -00000ca0: 696e 6520 696e 7465 7266 6163 652d 466f ine interface-Fo │ │ │ │ -00000cb0: 6f74 6e6f 7465 2d31 7f31 3238 3636 340a otnote-1.128664. │ │ │ │ -00000cc0: 4e6f 6465 3a20 4d65 6e75 2069 6e74 6572 Node: Menu inter │ │ │ │ -00000cd0: 6661 6365 7f31 3238 3735 390a 4e6f 6465 face.128759.Node │ │ │ │ -00000ce0: 3a20 4d65 6e75 2065 6e74 7279 2065 6469 : Menu entry edi │ │ │ │ -00000cf0: 746f 727f 3132 3937 3731 0a4e 6f64 653a tor.129771.Node: │ │ │ │ -00000d00: 2045 6e76 6972 6f6e 6d65 6e74 7f31 3330 Environment.130 │ │ │ │ -00000d10: 3530 390a 4e6f 6465 3a20 5370 6563 6961 509.Node: Specia │ │ │ │ -00000d20: 6c20 656e 7669 726f 6e6d 656e 7420 7661 l environment va │ │ │ │ -00000d30: 7269 6162 6c65 737f 3133 3132 3132 0a4e riables.131212.N │ │ │ │ -00000d40: 6f64 653a 2062 696f 736e 756d 7f31 3332 ode: biosnum.132 │ │ │ │ -00000d50: 3236 360a 4e6f 6465 3a20 6368 6563 6b5f 266.Node: check_ │ │ │ │ -00000d60: 7369 676e 6174 7572 6573 7f31 3332 3739 signatures.13279 │ │ │ │ -00000d70: 300a 4e6f 6465 3a20 6368 6f73 656e 7f31 0.Node: chosen.1 │ │ │ │ -00000d80: 3333 3037 370a 4e6f 6465 3a20 636d 6470 33077.Node: cmdp │ │ │ │ -00000d90: 6174 687f 3133 3335 3230 0a4e 6f64 653a ath.133520.Node: │ │ │ │ -00000da0: 2063 6f6c 6f72 5f68 6967 686c 6967 6874 color_highlight │ │ │ │ -00000db0: 7f31 3333 3934 370a 4e6f 6465 3a20 636f .133947.Node: co │ │ │ │ -00000dc0: 6c6f 725f 6e6f 726d 616c 7f31 3334 3335 lor_normal.13435 │ │ │ │ -00000dd0: 390a 4e6f 6465 3a20 636f 6e66 6967 5f64 9.Node: config_d │ │ │ │ -00000de0: 6972 6563 746f 7279 7f31 3336 3032 320a irectory.136022. │ │ │ │ -00000df0: 4e6f 6465 3a20 636f 6e66 6967 5f66 696c Node: config_fil │ │ │ │ -00000e00: 657f 3133 3633 3136 0a4e 6f64 653a 2064 e.136316.Node: d │ │ │ │ -00000e10: 6562 7567 7f31 3336 3730 390a 4e6f 6465 ebug.136709.Node │ │ │ │ -00000e20: 3a20 6465 6661 756c 747f 3133 3731 3438 : default.137148 │ │ │ │ -00000e30: 0a4e 6f64 653a 2066 616c 6c62 6163 6b7f .Node: fallback. │ │ │ │ -00000e40: 3133 3835 3736 0a4e 6f64 653a 2067 6678 138576.Node: gfx │ │ │ │ -00000e50: 6d6f 6465 7f31 3338 3930 390a 4e6f 6465 mode.138909.Node │ │ │ │ -00000e60: 3a20 6766 7870 6179 6c6f 6164 7f31 3339 : gfxpayload.139 │ │ │ │ -00000e70: 3730 370a 4e6f 6465 3a20 6766 7874 6572 707.Node: gfxter │ │ │ │ -00000e80: 6d5f 666f 6e74 7f31 3430 3836 310a 4e6f m_font.140861.No │ │ │ │ -00000e90: 6465 3a20 6772 7562 5f63 7075 7f31 3431 de: grub_cpu.141 │ │ │ │ -00000ea0: 3136 310a 4e6f 6465 3a20 6772 7562 5f70 161.Node: grub_p │ │ │ │ -00000eb0: 6c61 7466 6f72 6d7f 3134 3134 3439 0a4e latform.141449.N │ │ │ │ -00000ec0: 6f64 653a 2069 636f 6e64 6972 7f31 3431 ode: icondir.141 │ │ │ │ -00000ed0: 3734 310a 4e6f 6465 3a20 6c61 6e67 7f31 741.Node: lang.1 │ │ │ │ -00000ee0: 3432 3035 380a 4e6f 6465 3a20 6c6f 6361 42058.Node: loca │ │ │ │ -00000ef0: 6c65 5f64 6972 7f31 3432 3532 370a 4e6f le_dir.142527.No │ │ │ │ -00000f00: 6465 3a20 6d65 6e75 5f63 6f6c 6f72 5f68 de: menu_color_h │ │ │ │ -00000f10: 6967 686c 6967 6874 7f31 3433 3033 360a ighlight.143036. │ │ │ │ -00000f20: 4e6f 6465 3a20 6d65 6e75 5f63 6f6c 6f72 Node: menu_color │ │ │ │ -00000f30: 5f6e 6f72 6d61 6c7f 3134 3335 3332 0a4e _normal.143532.N │ │ │ │ -00000f40: 6f64 653a 206e 6574 5f3c 494e 5445 5246 ode: net__boot_file.1 │ │ │ │ -00000f60: 3434 3033 330a 4e6f 6465 3a20 6e65 745f 44033.Node: net_ │ │ │ │ -00000f70: 3c49 4e54 4552 4641 4345 3e5f 6468 6370 _dhcp │ │ │ │ -00000f80: 5f73 6572 7665 725f 6e61 6d65 7f31 3434 _server_name.144 │ │ │ │ -00000f90: 3237 360a 4e6f 6465 3a20 6e65 745f 3c49 276.Node: net__domain │ │ │ │ -00000fb0: 7f31 3434 3533 380a 4e6f 6465 3a20 6e65 .144538.Node: ne │ │ │ │ -00000fc0: 745f 3c49 4e54 4552 4641 4345 3e5f 6578 t__ex │ │ │ │ -00000fd0: 7465 6e73 696f 6e73 7061 7468 7f31 3434 tensionspath.144 │ │ │ │ -00000fe0: 3738 350a 4e6f 6465 3a20 6e65 745f 3c49 785.Node: net__hostna │ │ │ │ -00001000: 6d65 7f31 3435 3034 300a 4e6f 6465 3a20 me.145040.Node: │ │ │ │ -00001010: 6e65 745f 3c49 4e54 4552 4641 4345 3e5f net__ │ │ │ │ -00001020: 6970 7f31 3435 3237 390a 4e6f 6465 3a20 ip.145279.Node: │ │ │ │ -00001030: 6e65 745f 3c49 4e54 4552 4641 4345 3e5f net__ │ │ │ │ -00001040: 6d61 637f 3134 3534 3935 0a4e 6f64 653a mac.145495.Node: │ │ │ │ -00001050: 206e 6574 5f3c 494e 5445 5246 4143 453e net_ │ │ │ │ -00001060: 5f6e 6578 745f 7365 7276 6572 7f31 3435 _next_server.145 │ │ │ │ -00001070: 3731 360a 4e6f 6465 3a20 6e65 745f 3c49 716.Node: net__rootpa │ │ │ │ -00001090: 7468 7f31 3435 3935 390a 4e6f 6465 3a20 th.145959.Node: │ │ │ │ -000010a0: 6e65 745f 6465 6661 756c 745f 696e 7465 net_default_inte │ │ │ │ -000010b0: 7266 6163 657f 3134 3631 3938 0a4e 6f64 rface.146198.Nod │ │ │ │ -000010c0: 653a 206e 6574 5f64 6566 6175 6c74 5f69 e: net_default_i │ │ │ │ -000010d0: 707f 3134 3634 3138 0a4e 6f64 653a 206e p.146418.Node: n │ │ │ │ -000010e0: 6574 5f64 6566 6175 6c74 5f6d 6163 7f31 et_default_mac.1 │ │ │ │ -000010f0: 3436 3631 350a 4e6f 6465 3a20 6e65 745f 46615.Node: net_ │ │ │ │ -00001100: 6465 6661 756c 745f 7365 7276 6572 7f31 default_server.1 │ │ │ │ -00001110: 3436 3831 310a 4e6f 6465 3a20 7061 6765 46811.Node: page │ │ │ │ -00001120: 727f 3134 3730 3034 0a4e 6f64 653a 2070 r.147004.Node: p │ │ │ │ -00001130: 7265 6669 787f 3134 3732 3630 0a4e 6f64 refix.147260.Nod │ │ │ │ -00001140: 653a 2070 7865 5f62 6c6b 7369 7a65 7f31 e: pxe_blksize.1 │ │ │ │ -00001150: 3437 3730 390a 4e6f 6465 3a20 7078 655f 47709.Node: pxe_ │ │ │ │ -00001160: 6465 6661 756c 745f 6761 7465 7761 797f default_gateway. │ │ │ │ -00001170: 3134 3738 3836 0a4e 6f64 653a 2070 7865 147886.Node: pxe │ │ │ │ -00001180: 5f64 6566 6175 6c74 5f73 6572 7665 727f _default_server. │ │ │ │ -00001190: 3134 3830 3931 0a4e 6f64 653a 2072 6f6f 148091.Node: roo │ │ │ │ -000011a0: 747f 3134 3832 3837 0a4e 6f64 653a 2073 t.148287.Node: s │ │ │ │ -000011b0: 7570 6572 7573 6572 737f 3134 3838 3238 uperusers.148828 │ │ │ │ -000011c0: 0a4e 6f64 653a 2074 6865 6d65 7f31 3439 .Node: theme.149 │ │ │ │ -000011d0: 3037 360a 4e6f 6465 3a20 7469 6d65 6f75 076.Node: timeou │ │ │ │ -000011e0: 747f 3134 3933 3937 0a4e 6f64 653a 2074 t.149397.Node: t │ │ │ │ -000011f0: 696d 656f 7574 5f73 7479 6c65 7f31 3530 imeout_style.150 │ │ │ │ -00001200: 3033 340a 4e6f 6465 3a20 456e 7669 726f 034.Node: Enviro │ │ │ │ -00001210: 6e6d 656e 7420 626c 6f63 6b7f 3135 3034 nment block.1504 │ │ │ │ -00001220: 3139 0a4e 6f64 653a 2043 6f6d 6d61 6e64 19.Node: Command │ │ │ │ -00001230: 737f 3135 3138 3531 0a4e 6f64 653a 204d s.151851.Node: M │ │ │ │ -00001240: 656e 752d 7370 6563 6966 6963 2063 6f6d enu-specific com │ │ │ │ -00001250: 6d61 6e64 737f 3135 3237 3231 0a4e 6f64 mands.152721.Nod │ │ │ │ -00001260: 653a 206d 656e 7565 6e74 7279 7f31 3533 e: menuentry.153 │ │ │ │ -00001270: 3434 390a 4e6f 6465 3a20 7375 626d 656e 449.Node: submen │ │ │ │ -00001280: 757f 3135 3530 3030 0a4e 6f64 653a 2047 u.155000.Node: G │ │ │ │ -00001290: 656e 6572 616c 2063 6f6d 6d61 6e64 737f eneral commands. │ │ │ │ -000012a0: 3135 3535 3439 0a4e 6f64 653a 2073 6572 155549.Node: ser │ │ │ │ -000012b0: 6961 6c7f 3135 3630 3435 0a4e 6f64 653a ial.156045.Node: │ │ │ │ -000012c0: 2074 6572 6d69 6e61 6c5f 696e 7075 747f terminal_input. │ │ │ │ -000012d0: 3135 3730 3936 0a4e 6f64 653a 2074 6572 157096.Node: ter │ │ │ │ -000012e0: 6d69 6e61 6c5f 6f75 7470 7574 7f31 3537 minal_output.157 │ │ │ │ -000012f0: 3736 320a 4e6f 6465 3a20 7465 726d 696e 762.Node: termin │ │ │ │ -00001300: 666f 7f31 3538 3432 390a 4e6f 6465 3a20 fo.158429.Node: │ │ │ │ -00001310: 436f 6d6d 616e 642d 6c69 6e65 2061 6e64 Command-line and │ │ │ │ -00001320: 206d 656e 7520 656e 7472 7920 636f 6d6d menu entry comm │ │ │ │ -00001330: 616e 6473 7f31 3539 3536 340a 4e6f 6465 ands.159564.Node │ │ │ │ -00001340: 3a20 5b7f 3136 3439 3433 0a4e 6f64 653a : [.164943.Node: │ │ │ │ -00001350: 2061 6370 697f 3136 3531 3239 0a4e 6f64 acpi.165129.Nod │ │ │ │ -00001360: 653a 2061 7574 6865 6e74 6963 6174 657f e: authenticate. │ │ │ │ -00001370: 3136 3634 3432 0a4e 6f64 653a 2062 6163 166442.Node: bac │ │ │ │ -00001380: 6b67 726f 756e 645f 636f 6c6f 727f 3136 kground_color.16 │ │ │ │ -00001390: 3638 3639 0a4e 6f64 653a 2062 6163 6b67 6869.Node: backg │ │ │ │ -000013a0: 726f 756e 645f 696d 6167 657f 3136 3735 round_image.1675 │ │ │ │ -000013b0: 3432 0a4e 6f64 653a 2062 6164 7261 6d7f 42.Node: badram. │ │ │ │ -000013c0: 3136 3830 3932 0a4e 6f64 653a 2062 6c6f 168092.Node: blo │ │ │ │ -000013d0: 636b 6c69 7374 7f31 3639 3430 300a 4e6f cklist.169400.No │ │ │ │ -000013e0: 6465 3a20 626f 6f74 7f31 3639 3633 340a de: boot.169634. │ │ │ │ -000013f0: 4e6f 6465 3a20 6361 747f 3136 3939 3536 Node: cat.169956 │ │ │ │ -00001400: 0a4e 6f64 653a 2063 6861 696e 6c6f 6164 .Node: chainload │ │ │ │ -00001410: 6572 7f31 3730 3539 320a 4e6f 6465 3a20 er.170592.Node: │ │ │ │ -00001420: 636c 6561 727f 3137 3132 3230 0a4e 6f64 clear.171220.Nod │ │ │ │ -00001430: 653a 2063 6d6f 7363 6c65 616e 7f31 3731 e: cmosclean.171 │ │ │ │ -00001440: 3430 360a 4e6f 6465 3a20 636d 6f73 6475 406.Node: cmosdu │ │ │ │ -00001450: 6d70 7f31 3731 3731 300a 4e6f 6465 3a20 mp.171710.Node: │ │ │ │ -00001460: 636d 6f73 7465 7374 7f31 3732 3030 350a cmostest.172005. │ │ │ │ -00001470: 4e6f 6465 3a20 636d 707f 3137 3233 3633 Node: cmp.172363 │ │ │ │ -00001480: 0a4e 6f64 653a 2063 6f6e 6669 6766 696c .Node: configfil │ │ │ │ -00001490: 657f 3137 3239 3134 0a4e 6f64 653a 2063 e.172914.Node: c │ │ │ │ -000014a0: 7075 6964 7f31 3733 3333 390a 4e6f 6465 puid.173339.Node │ │ │ │ -000014b0: 3a20 6372 637f 3137 3339 3130 0a4e 6f64 : crc.173910.Nod │ │ │ │ -000014c0: 653a 2063 7279 7074 6f6d 6f75 6e74 7f31 e: cryptomount.1 │ │ │ │ -000014d0: 3734 3138 340a 4e6f 6465 3a20 6375 746d 74184.Node: cutm │ │ │ │ -000014e0: 656d 7f31 3734 3933 330a 4e6f 6465 3a20 em.174933.Node: │ │ │ │ -000014f0: 6461 7465 7f31 3735 3736 360a 4e6f 6465 date.175766.Node │ │ │ │ -00001500: 3a20 6465 7669 6365 7472 6565 7f31 3736 : devicetree.176 │ │ │ │ -00001510: 3331 300a 4e6f 6465 3a20 6469 7374 7275 310.Node: distru │ │ │ │ -00001520: 7374 7f31 3736 3836 370a 4e6f 6465 3a20 st.176867.Node: │ │ │ │ -00001530: 6472 6976 656d 6170 7f31 3737 3634 380a drivemap.177648. │ │ │ │ -00001540: 4e6f 6465 3a20 6563 686f 7f31 3738 3435 Node: echo.17845 │ │ │ │ -00001550: 350a 4e6f 6465 3a20 6576 616c 7f31 3739 5.Node: eval.179 │ │ │ │ -00001560: 3339 380a 4e6f 6465 3a20 6578 706f 7274 398.Node: export │ │ │ │ -00001570: 7f31 3739 3638 310a 4e6f 6465 3a20 6661 .179681.Node: fa │ │ │ │ -00001580: 6c73 657f 3137 3939 3932 0a4e 6f64 653a lse.179992.Node: │ │ │ │ -00001590: 2067 6574 7465 7874 7f31 3830 3238 380a gettext.180288. │ │ │ │ -000015a0: 4e6f 6465 3a20 6770 7473 796e 637f 3138 Node: gptsync.18 │ │ │ │ -000015b0: 3037 3335 0a4e 6f64 653a 2068 616c 747f 0735.Node: halt. │ │ │ │ -000015c0: 3138 3136 3830 0a4e 6f64 653a 2068 6173 181680.Node: has │ │ │ │ -000015d0: 6873 756d 7f31 3832 3031 310a 4e6f 6465 hsum.182011.Node │ │ │ │ -000015e0: 3a20 6865 6c70 7f31 3833 3233 370a 4e6f : help.183237.No │ │ │ │ -000015f0: 6465 3a20 696e 6974 7264 7f31 3833 3730 de: initrd.18370 │ │ │ │ -00001600: 340a 4e6f 6465 3a20 696e 6974 7264 3136 4.Node: initrd16 │ │ │ │ -00001610: 7f31 3834 3131 360a 4e6f 6465 3a20 696e .184116.Node: in │ │ │ │ -00001620: 736d 6f64 7f31 3834 3632 310a 4e6f 6465 smod.184621.Node │ │ │ │ -00001630: 3a20 6b65 7973 7461 7475 737f 3138 3438 : keystatus.1848 │ │ │ │ -00001640: 3433 0a4e 6f64 653a 206c 696e 7578 7f31 43.Node: linux.1 │ │ │ │ -00001650: 3835 3438 320a 4e6f 6465 3a20 6c69 6e75 85482.Node: linu │ │ │ │ -00001660: 7831 367f 3138 3633 3835 0a4e 6f64 653a x16.186385.Node: │ │ │ │ -00001670: 206c 6973 745f 656e 767f 3138 3730 3939 list_env.187099 │ │ │ │ -00001680: 0a4e 6f64 653a 206c 6973 745f 7472 7573 .Node: list_trus │ │ │ │ -00001690: 7465 647f 3138 3734 3635 0a4e 6f64 653a ted.187465.Node: │ │ │ │ -000016a0: 206c 6f61 645f 656e 767f 3138 3830 3438 load_env.188048 │ │ │ │ -000016b0: 0a4e 6f64 653a 206c 6f61 6466 6f6e 747f .Node: loadfont. │ │ │ │ -000016c0: 3138 3937 3231 0a4e 6f64 653a 206c 6f6f 189721.Node: loo │ │ │ │ -000016d0: 7062 6163 6b7f 3139 3030 3932 0a4e 6f64 pback.190092.Nod │ │ │ │ -000016e0: 653a 206c 737f 3139 3035 3430 0a4e 6f64 e: ls.190540.Nod │ │ │ │ -000016f0: 653a 206c 7366 6f6e 7473 7f31 3931 3038 e: lsfonts.19108 │ │ │ │ -00001700: 320a 4e6f 6465 3a20 6c73 6d6f 647f 3139 2.Node: lsmod.19 │ │ │ │ -00001710: 3132 3634 0a4e 6f64 653a 206d 6435 7375 1264.Node: md5su │ │ │ │ -00001720: 6d7f 3139 3134 3534 0a4e 6f64 653a 206d m.191454.Node: m │ │ │ │ -00001730: 6f64 756c 657f 3139 3137 3333 0a4e 6f64 odule.191733.Nod │ │ │ │ -00001740: 653a 206d 756c 7469 626f 6f74 7f31 3932 e: multiboot.192 │ │ │ │ -00001750: 3034 350a 4e6f 6465 3a20 6e61 7469 7665 045.Node: native │ │ │ │ -00001760: 6469 736b 7f31 3933 3135 330a 4e6f 6465 disk.193153.Node │ │ │ │ -00001770: 3a20 6e6f 726d 616c 7f31 3933 3535 320a : normal.193552. │ │ │ │ -00001780: 4e6f 6465 3a20 6e6f 726d 616c 5f65 7869 Node: normal_exi │ │ │ │ -00001790: 747f 3139 3433 3139 0a4e 6f64 653a 2070 t.194319.Node: p │ │ │ │ -000017a0: 6172 7474 6f6f 6c7f 3139 3436 3431 0a4e arttool.194641.N │ │ │ │ -000017b0: 6f64 653a 2070 6173 7377 6f72 647f 3139 ode: password.19 │ │ │ │ -000017c0: 3631 3437 0a4e 6f64 653a 2070 6173 7377 6147.Node: passw │ │ │ │ -000017d0: 6f72 645f 7062 6b64 6632 7f31 3936 3432 ord_pbkdf2.19642 │ │ │ │ -000017e0: 390a 4e6f 6465 3a20 706c 6179 7f31 3936 9.Node: play.196 │ │ │ │ -000017f0: 3833 370a 4e6f 6465 3a20 7072 6f62 657f 837.Node: probe. │ │ │ │ -00001800: 3139 3735 3835 0a4e 6f64 653a 2070 7865 197585.Node: pxe │ │ │ │ -00001810: 5f75 6e6c 6f61 647f 3139 3739 3637 0a4e _unload.197967.N │ │ │ │ -00001820: 6f64 653a 2072 646d 7372 7f31 3938 3234 ode: rdmsr.19824 │ │ │ │ -00001830: 380a 4e6f 6465 3a20 7265 6164 7f31 3939 8.Node: read.199 │ │ │ │ -00001840: 3033 360a 4e6f 6465 3a20 7265 626f 6f74 036.Node: reboot │ │ │ │ -00001850: 7f31 3939 3338 300a 4e6f 6465 3a20 7265 .199380.Node: re │ │ │ │ -00001860: 6765 7870 7f31 3939 3536 330a 4e6f 6465 gexp.199563.Node │ │ │ │ -00001870: 3a20 726d 6d6f 647f 3230 3031 3030 0a4e : rmmod.200100.N │ │ │ │ -00001880: 6f64 653a 2073 6176 655f 656e 767f 3230 ode: save_env.20 │ │ │ │ -00001890: 3032 3933 0a4e 6f64 653a 2073 6561 7263 0293.Node: searc │ │ │ │ -000018a0: 687f 3230 3133 3135 0a4e 6f64 653a 2073 h.201315.Node: s │ │ │ │ -000018b0: 656e 646b 6579 7f32 3032 3039 330a 4e6f endkey.202093.No │ │ │ │ -000018c0: 6465 3a20 7365 747f 3230 3835 3139 0a4e de: set.208519.N │ │ │ │ -000018d0: 6f64 653a 2073 6861 3173 756d 7f32 3038 ode: sha1sum.208 │ │ │ │ -000018e0: 3832 310a 4e6f 6465 3a20 7368 6132 3536 821.Node: sha256 │ │ │ │ -000018f0: 7375 6d7f 3230 3931 3036 0a4e 6f64 653a sum.209106.Node: │ │ │ │ -00001900: 2073 6861 3531 3273 756d 7f32 3039 3430 sha512sum.20940 │ │ │ │ -00001910: 350a 4e6f 6465 3a20 736c 6565 707f 3230 5.Node: sleep.20 │ │ │ │ -00001920: 3937 3032 0a4e 6f64 653a 2073 6f75 7263 9702.Node: sourc │ │ │ │ -00001930: 657f 3231 3031 3539 0a4e 6f64 653a 2074 e.210159.Node: t │ │ │ │ -00001940: 6573 747f 3231 3037 3131 0a4e 6f64 653a est.210711.Node: │ │ │ │ -00001950: 2074 7275 657f 3231 3334 3830 0a4e 6f64 true.213480.Nod │ │ │ │ -00001960: 653a 2074 7275 7374 7f32 3133 3736 360a e: trust.213766. │ │ │ │ -00001970: 4e6f 6465 3a20 756e 7365 747f 3231 3435 Node: unset.2145 │ │ │ │ -00001980: 3538 0a4e 6f64 653a 2075 7070 6572 6d65 58.Node: upperme │ │ │ │ -00001990: 6d7f 3231 3437 3635 0a4e 6f64 653a 2076 m.214765.Node: v │ │ │ │ -000019a0: 6572 6966 795f 6465 7461 6368 6564 7f32 erify_detached.2 │ │ │ │ -000019b0: 3134 3939 300a 4e6f 6465 3a20 7669 6465 14990.Node: vide │ │ │ │ -000019c0: 6f69 6e66 6f7f 3231 3630 3338 0a4e 6f64 oinfo.216038.Nod │ │ │ │ -000019d0: 653a 2077 726d 7372 7f32 3136 3331 360a e: wrmsr.216316. │ │ │ │ -000019e0: 4e6f 6465 3a20 7865 6e5f 6879 7065 7276 Node: xen_hyperv │ │ │ │ -000019f0: 6973 6f72 7f32 3137 3133 300a 4e6f 6465 isor.217130.Node │ │ │ │ -00001a00: 3a20 7865 6e5f 6d6f 6475 6c65 7f32 3137 : xen_module.217 │ │ │ │ -00001a10: 3539 310a 4e6f 6465 3a20 4e65 7477 6f72 591.Node: Networ │ │ │ │ -00001a20: 6b69 6e67 2063 6f6d 6d61 6e64 737f 3231 king commands.21 │ │ │ │ -00001a30: 3831 3135 0a4e 6f64 653a 206e 6574 5f61 8115.Node: net_a │ │ │ │ -00001a40: 6464 5f61 6464 727f 3231 3930 3637 0a4e dd_addr.219067.N │ │ │ │ -00001a50: 6f64 653a 206e 6574 5f61 6464 5f64 6e73 ode: net_add_dns │ │ │ │ -00001a60: 7f32 3139 3538 370a 4e6f 6465 3a20 6e65 .219587.Node: ne │ │ │ │ -00001a70: 745f 6164 645f 726f 7574 657f 3231 3938 t_add_route.2198 │ │ │ │ -00001a80: 3633 0a4e 6f64 653a 206e 6574 5f62 6f6f 63.Node: net_boo │ │ │ │ -00001a90: 7470 7f32 3230 3339 330a 4e6f 6465 3a20 tp.220393.Node: │ │ │ │ -00001aa0: 6e65 745f 6465 6c5f 6164 6472 7f32 3231 net_del_addr.221 │ │ │ │ -00001ab0: 3938 320a 4e6f 6465 3a20 6e65 745f 6465 982.Node: net_de │ │ │ │ -00001ac0: 6c5f 646e 737f 3232 3232 3232 0a4e 6f64 l_dns.222222.Nod │ │ │ │ -00001ad0: 653a 206e 6574 5f64 656c 5f72 6f75 7465 e: net_del_route │ │ │ │ -00001ae0: 7f32 3232 3436 390a 4e6f 6465 3a20 6e65 .222469.Node: ne │ │ │ │ -00001af0: 745f 6765 745f 6468 6370 5f6f 7074 696f t_get_dhcp_optio │ │ │ │ -00001b00: 6e7f 3232 3237 3134 0a4e 6f64 653a 206e n.222714.Node: n │ │ │ │ -00001b10: 6574 5f69 7076 365f 6175 746f 636f 6e66 et_ipv6_autoconf │ │ │ │ -00001b20: 7f32 3233 3230 300a 4e6f 6465 3a20 6e65 .223200.Node: ne │ │ │ │ -00001b30: 745f 6c73 5f61 6464 727f 3232 3336 3139 t_ls_addr.223619 │ │ │ │ -00001b40: 0a4e 6f64 653a 206e 6574 5f6c 735f 6361 .Node: net_ls_ca │ │ │ │ -00001b50: 7264 737f 3232 3338 3637 0a4e 6f64 653a rds.223867.Node: │ │ │ │ -00001b60: 206e 6574 5f6c 735f 646e 737f 3232 3431 net_ls_dns.2241 │ │ │ │ -00001b70: 3033 0a4e 6f64 653a 206e 6574 5f6c 735f 03.Node: net_ls_ │ │ │ │ -00001b80: 726f 7574 6573 7f32 3234 3333 340a 4e6f routes.224334.No │ │ │ │ -00001b90: 6465 3a20 6e65 745f 6e73 6c6f 6f6b 7570 de: net_nslookup │ │ │ │ -00001ba0: 7f32 3234 3534 310a 4e6f 6465 3a20 496e .224541.Node: In │ │ │ │ -00001bb0: 7465 726e 6174 696f 6e61 6c69 7361 7469 ternationalisati │ │ │ │ -00001bc0: 6f6e 7f32 3234 3832 350a 4e6f 6465 3a20 on.224825.Node: │ │ │ │ -00001bd0: 5365 6375 7269 7479 7f32 3331 3635 370a Security.231657. │ │ │ │ -00001be0: 4e6f 6465 3a20 4175 7468 656e 7469 6361 Node: Authentica │ │ │ │ -00001bf0: 7469 6f6e 2061 6e64 2061 7574 686f 7269 tion and authori │ │ │ │ -00001c00: 7361 7469 6f6e 7f32 3332 3233 330a 4e6f sation.232233.No │ │ │ │ -00001c10: 6465 3a20 5573 696e 6720 6469 6769 7461 de: Using digita │ │ │ │ -00001c20: 6c20 7369 676e 6174 7572 6573 7f32 3335 l signatures.235 │ │ │ │ -00001c30: 3231 370a 4e6f 6465 3a20 5545 4649 2073 217.Node: UEFI s │ │ │ │ -00001c40: 6563 7572 6520 626f 6f74 2061 6e64 2073 ecure boot and s │ │ │ │ -00001c50: 6869 6d7f 3233 3833 3331 0a4e 6f64 653a him.238331.Node: │ │ │ │ -00001c60: 2053 6563 7572 6520 426f 6f74 2041 6476 Secure Boot Adv │ │ │ │ -00001c70: 616e 6365 6420 5461 7267 6574 696e 677f anced Targeting. │ │ │ │ -00001c80: 3233 3931 3838 0a4e 6f64 653a 204d 6561 239188.Node: Mea │ │ │ │ -00001c90: 7375 7265 6420 426f 6f74 7f32 3430 3231 sured Boot.24021 │ │ │ │ -00001ca0: 390a 4e6f 6465 3a20 4c6f 636b 646f 776e 9.Node: Lockdown │ │ │ │ -00001cb0: 7f32 3432 3138 340a 4e6f 6465 3a20 506c .242184.Node: Pl │ │ │ │ -00001cc0: 6174 666f 726d 206c 696d 6974 6174 696f atform limitatio │ │ │ │ -00001cd0: 6e73 7f32 3432 3637 370a 4e6f 6465 3a20 ns.242677.Node: │ │ │ │ -00001ce0: 506c 6174 666f 726d 2d73 7065 6369 6669 Platform-specifi │ │ │ │ -00001cf0: 6320 6f70 6572 6174 696f 6e73 7f32 3530 c operations.250 │ │ │ │ -00001d00: 3236 370a 4e6f 6465 3a20 5375 7070 6f72 267.Node: Suppor │ │ │ │ -00001d10: 7465 6420 6b65 726e 656c 737f 3235 3133 ted kernels.2513 │ │ │ │ -00001d20: 3332 0a4e 6f64 653a 2054 726f 7562 6c65 32.Node: Trouble │ │ │ │ -00001d30: 7368 6f6f 7469 6e67 7f32 3538 3936 390a shooting.258969. │ │ │ │ -00001d40: 4e6f 6465 3a20 4752 5542 206f 6e6c 7920 Node: GRUB only │ │ │ │ -00001d50: 6f66 6665 7273 2061 2072 6573 6375 6520 offers a rescue │ │ │ │ -00001d60: 7368 656c 6c7f 3235 3932 3339 0a4e 6f64 shell.259239.Nod │ │ │ │ -00001d70: 653a 2046 6972 6d77 6172 6520 7374 616c e: Firmware stal │ │ │ │ -00001d80: 6c73 2069 6e73 7465 6164 206f 6620 626f ls instead of bo │ │ │ │ -00001d90: 6f74 696e 6720 4752 5542 7f32 3632 3234 oting GRUB.26224 │ │ │ │ -00001da0: 380a 4e6f 6465 3a20 496e 766f 6b69 6e67 8.Node: Invoking │ │ │ │ -00001db0: 2067 7275 622d 696e 7374 616c 6c7f 3236 grub-install.26 │ │ │ │ -00001dc0: 3238 3739 0a4e 6f64 653a 2049 6e76 6f6b 2879.Node: Invok │ │ │ │ -00001dd0: 696e 6720 6772 7562 2d6d 6b63 6f6e 6669 ing grub-mkconfi │ │ │ │ -00001de0: 677f 3236 3530 3439 0a4e 6f64 653a 2049 g.265049.Node: I │ │ │ │ -00001df0: 6e76 6f6b 696e 6720 6772 7562 2d6d 6b70 nvoking grub-mkp │ │ │ │ -00001e00: 6173 7377 642d 7062 6b64 6632 7f32 3635 asswd-pbkdf2.265 │ │ │ │ -00001e10: 3638 360a 4e6f 6465 3a20 496e 766f 6b69 686.Node: Invoki │ │ │ │ -00001e20: 6e67 2067 7275 622d 6d6b 7265 6c70 6174 ng grub-mkrelpat │ │ │ │ -00001e30: 687f 3236 3633 3435 0a4e 6f64 653a 2049 h.266345.Node: I │ │ │ │ -00001e40: 6e76 6f6b 696e 6720 6772 7562 2d6d 6b72 nvoking grub-mkr │ │ │ │ -00001e50: 6573 6375 657f 3236 3731 3138 0a4e 6f64 escue.267118.Nod │ │ │ │ -00001e60: 653a 2049 6e76 6f6b 696e 6720 6772 7562 e: Invoking grub │ │ │ │ -00001e70: 2d6d 6f75 6e74 7f32 3638 3836 370a 4e6f -mount.268867.No │ │ │ │ -00001e80: 6465 3a20 496e 766f 6b69 6e67 2067 7275 de: Invoking gru │ │ │ │ -00001e90: 622d 7072 6f62 657f 3237 3139 3136 0a4e b-probe.271916.N │ │ │ │ -00001ea0: 6f64 653a 2049 6e76 6f6b 696e 6720 6772 ode: Invoking gr │ │ │ │ -00001eb0: 7562 2d73 6372 6970 742d 6368 6563 6b7f ub-script-check. │ │ │ │ -00001ec0: 3237 3435 3130 0a4e 6f64 653a 204f 6274 274510.Node: Obt │ │ │ │ -00001ed0: 6169 6e69 6e67 2061 6e64 2042 7569 6c64 aining and Build │ │ │ │ -00001ee0: 696e 6720 4752 5542 7f32 3735 3235 340a ing GRUB.275254. │ │ │ │ -00001ef0: 4e6f 6465 3a20 5265 706f 7274 696e 6720 Node: Reporting │ │ │ │ -00001f00: 6275 6773 7f32 3736 3439 370a 4e6f 6465 bugs.276497.Node │ │ │ │ -00001f10: 3a20 4675 7475 7265 7f32 3739 3331 330a : Future.279313. │ │ │ │ -00001f20: 4e6f 6465 3a20 436f 7079 696e 6720 5468 Node: Copying Th │ │ │ │ -00001f30: 6973 204d 616e 7561 6c7f 3237 3937 3133 is Manual.279713 │ │ │ │ -00001f40: 0a4e 6f64 653a 2047 4e55 2046 7265 6520 .Node: GNU Free │ │ │ │ -00001f50: 446f 6375 6d65 6e74 6174 696f 6e20 4c69 Documentation Li │ │ │ │ -00001f60: 6365 6e73 657f 3237 3939 3431 0a4e 6f64 cense.279941.Nod │ │ │ │ -00001f70: 653a 2049 6e64 6578 7f33 3033 3438 330a e: Index.303483. │ │ │ │ -00001f80: 1f0a 456e 6420 5461 6720 5461 626c 650a ..End Tag Table. │ │ │ │ -00001f90: 0a1f 0a4c 6f63 616c 2056 6172 6961 626c ...Local Variabl │ │ │ │ -00001fa0: 6573 3a0a 636f 6469 6e67 3a20 7574 662d es:.coding: utf- │ │ │ │ -00001fb0: 380a 456e 643a 0a 8.End:. │ │ │ │ +00000070: 3320 4f63 746f 6265 7220 3230 3231 292e 3 October 2021). │ │ │ │ +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 3330 .grub.info-2: 30 │ │ │ │ +000004b0: 3334 3839 0a1f 0a54 6167 2054 6162 6c65 3489...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: 3735 3635 0a4e 6f64 653a 204d 616b 696e 7565.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 3934 3234 0a52 6566 3a20 4d61 es.29424.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 3935 3237 0a4e 6f64 note-1.29527.Nod │ │ │ │ +000007b0: 653a 2044 6576 6963 6520 6d61 707f 3239 e: Device map.29 │ │ │ │ +000007c0: 3630 320a 4e6f 6465 3a20 4249 4f53 2069 602.Node: BIOS i │ │ │ │ +000007d0: 6e73 7461 6c6c 6174 696f 6e7f 3331 3536 nstallation.3156 │ │ │ │ +000007e0: 390a 4e6f 6465 3a20 426f 6f74 696e 677f 9.Node: Booting. │ │ │ │ +000007f0: 3334 3934 350a 4e6f 6465 3a20 4765 6e65 34945.Node: Gene │ │ │ │ +00000800: 7261 6c20 626f 6f74 206d 6574 686f 6473 ral boot methods │ │ │ │ +00000810: 7f33 3534 3031 0a4e 6f64 653a 204c 6f61 .35401.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 3134 340a 4e6f 6465 3a20 4368 y.36144.Node: Ch │ │ │ │ +00000850: 6169 6e2d 6c6f 6164 696e 677f 3336 3837 ain-loading.3687 │ │ │ │ +00000860: 350a 4e6f 6465 3a20 4c6f 6f70 6261 636b 5.Node: Loopback │ │ │ │ +00000870: 2062 6f6f 7469 6e67 7f33 3738 3436 0a4e booting.37846.N │ │ │ │ +00000880: 6f64 653a 204f 532d 7370 6563 6966 6963 ode: OS-specific │ │ │ │ +00000890: 206e 6f74 6573 7f33 3935 3230 0a4e 6f64 notes.39520.Nod │ │ │ │ +000008a0: 653a 2047 4e55 2f48 7572 647f 3339 3830 e: GNU/Hurd.3980 │ │ │ │ +000008b0: 390a 4e6f 6465 3a20 474e 552f 4c69 6e75 9.Node: GNU/Linu │ │ │ │ +000008c0: 787f 3430 3933 320a 4e6f 6465 3a20 4e65 x.40932.Node: Ne │ │ │ │ +000008d0: 7442 5344 7f34 3235 3538 0a4e 6f64 653a tBSD.42558.Node: │ │ │ │ +000008e0: 2044 4f53 2f57 696e 646f 7773 7f34 3430 DOS/Windows.440 │ │ │ │ +000008f0: 3332 0a4e 6f64 653a 2043 6f6e 6669 6775 32.Node: Configu │ │ │ │ +00000900: 7261 7469 6f6e 7f34 3538 3130 0a4e 6f64 ration.45810.Nod │ │ │ │ +00000910: 653a 2053 696d 706c 6520 636f 6e66 6967 e: Simple config │ │ │ │ +00000920: 7572 6174 696f 6e7f 3436 3532 320a 4e6f uration.46522.No │ │ │ │ +00000930: 6465 3a20 526f 6f74 2049 6465 6e74 6966 de: Root Identif │ │ │ │ +00000940: 6361 7469 6f6e 2048 6575 7269 7374 6963 cation Heuristic │ │ │ │ +00000950: 737f 3633 3035 340a 4e6f 6465 3a20 5368 s.63054.Node: Sh │ │ │ │ +00000960: 656c 6c2d 6c69 6b65 2073 6372 6970 7469 ell-like scripti │ │ │ │ +00000970: 6e67 7f36 3630 3638 0a4e 6f64 653a 2053 ng.66068.Node: S │ │ │ │ +00000980: 6865 6c6c 2d6c 696b 6520 7363 7269 7074 hell-like script │ │ │ │ +00000990: 696e 672d 466f 6f74 6e6f 7465 737f 3734 ing-Footnotes.74 │ │ │ │ +000009a0: 3133 310a 5265 663a 2053 6865 6c6c 2d6c 131.Ref: Shell-l │ │ │ │ +000009b0: 696b 6520 7363 7269 7074 696e 672d 466f ike scripting-Fo │ │ │ │ +000009c0: 6f74 6e6f 7465 2d31 7f37 3432 3136 0a4e otnote-1.74216.N │ │ │ │ +000009d0: 6f64 653a 204d 756c 7469 2d62 6f6f 7420 ode: Multi-boot │ │ │ │ +000009e0: 6d61 6e75 616c 2063 6f6e 6669 677f 3734 manual config.74 │ │ │ │ +000009f0: 3334 330a 4e6f 6465 3a20 456d 6265 6464 343.Node: Embedd │ │ │ │ +00000a00: 6564 2063 6f6e 6669 6775 7261 7469 6f6e ed configuration │ │ │ │ +00000a10: 7f37 3739 3732 0a4e 6f64 653a 2054 6865 .77972.Node: The │ │ │ │ +00000a20: 6d65 2066 696c 6520 666f 726d 6174 7f38 me file format.8 │ │ │ │ +00000a30: 3038 3038 0a52 6566 3a20 5069 786d 6170 0808.Ref: Pixmap │ │ │ │ +00000a40: 2d73 7479 6c65 6420 7072 6f67 7265 7373 -styled progress │ │ │ │ +00000a50: 2062 6172 7f38 3232 3637 0a52 6566 3a20 bar.82267.Ref: │ │ │ │ +00000a60: 506c 6169 6e20 7072 6f67 7265 7373 2062 Plain progress b │ │ │ │ +00000a70: 6172 2c20 6472 6177 6e20 7769 7468 2073 ar, drawn with s │ │ │ │ +00000a80: 6f6c 6964 2063 6f6c 6f72 2e7f 3832 3237 olid color..8227 │ │ │ │ +00000a90: 390a 5265 663a 2041 6e20 6578 616d 706c 9.Ref: An exampl │ │ │ │ +00000aa0: 6520 6f66 2074 6865 2073 6c69 6365 7320 e of the slices │ │ │ │ +00000ab0: 2869 6e20 7265 6429 2075 7365 6420 666f (in red) used fo │ │ │ │ +00000ac0: 7220 6120 7465 726d 696e 616c 2077 696e r a terminal win │ │ │ │ +00000ad0: 646f 772e 2054 6869 7320 6472 6177 696e dow. This drawin │ │ │ │ +00000ae0: 6720 7761 7320 6372 6561 7465 6420 616e g was created an │ │ │ │ +00000af0: 6420 736c 6963 6564 2069 6e20 496e 6b73 d sliced in Inks │ │ │ │ +00000b00: 6361 7065 5f2c 2061 7320 7468 6520 6e65 cape_, as the ne │ │ │ │ +00000b10: 7874 2073 6563 7469 6f6e 2065 7870 6c61 xt section expla │ │ │ │ +00000b20: 696e 732e 7f38 3537 3731 0a4e 6f64 653a ins..85771.Node: │ │ │ │ +00000b30: 204e 6574 776f 726b 7f31 3036 3138 330a Network.106183. │ │ │ │ +00000b40: 4e6f 6465 3a20 5365 7269 616c 2074 6572 Node: Serial ter │ │ │ │ +00000b50: 6d69 6e61 6c7f 3130 3839 3130 0a4e 6f64 minal.108910.Nod │ │ │ │ +00000b60: 653a 2056 656e 646f 7220 706f 7765 722d e: Vendor power- │ │ │ │ +00000b70: 6f6e 206b 6579 737f 3131 3131 3437 0a4e on keys.111147.N │ │ │ │ +00000b80: 6f64 653a 2049 6d61 6765 737f 3131 3330 ode: Images.1130 │ │ │ │ +00000b90: 3832 0a4e 6f64 653a 2043 6f72 6520 696d 82.Node: Core im │ │ │ │ +00000ba0: 6167 6520 7369 7a65 206c 696d 6974 6174 age size limitat │ │ │ │ +00000bb0: 696f 6e7f 3131 3830 3537 0a4e 6f64 653a ion.118057.Node: │ │ │ │ +00000bc0: 2046 696c 6573 7973 7465 6d7f 3132 3036 Filesystem.1206 │ │ │ │ +00000bd0: 3231 0a4e 6f64 653a 2044 6576 6963 6520 21.Node: Device │ │ │ │ +00000be0: 7379 6e74 6178 7f31 3231 3333 300a 4e6f syntax.121330.No │ │ │ │ +00000bf0: 6465 3a20 4669 6c65 206e 616d 6520 7379 de: File name sy │ │ │ │ +00000c00: 6e74 6178 7f31 3234 3033 310a 4e6f 6465 ntax.124031.Node │ │ │ │ +00000c10: 3a20 426c 6f63 6b20 6c69 7374 2073 796e : Block list syn │ │ │ │ +00000c20: 7461 787f 3132 3530 3737 0a4e 6f64 653a tax.125077.Node: │ │ │ │ +00000c30: 2049 6e74 6572 6661 6365 7f31 3235 3831 Interface.12581 │ │ │ │ +00000c40: 310a 4e6f 6465 3a20 436f 6d6d 616e 642d 1.Node: Command- │ │ │ │ +00000c50: 6c69 6e65 2069 6e74 6572 6661 6365 7f31 line interface.1 │ │ │ │ +00000c60: 3236 3633 350a 4e6f 6465 3a20 436f 6d6d 26635.Node: Comm │ │ │ │ +00000c70: 616e 642d 6c69 6e65 2069 6e74 6572 6661 and-line interfa │ │ │ │ +00000c80: 6365 2d46 6f6f 746e 6f74 6573 7f31 3238 ce-Footnotes.128 │ │ │ │ +00000c90: 3537 390a 5265 663a 2043 6f6d 6d61 6e64 579.Ref: Command │ │ │ │ +00000ca0: 2d6c 696e 6520 696e 7465 7266 6163 652d -line interface- │ │ │ │ +00000cb0: 466f 6f74 6e6f 7465 2d31 7f31 3238 3636 Footnote-1.12866 │ │ │ │ +00000cc0: 380a 4e6f 6465 3a20 4d65 6e75 2069 6e74 8.Node: Menu int │ │ │ │ +00000cd0: 6572 6661 6365 7f31 3238 3736 330a 4e6f erface.128763.No │ │ │ │ +00000ce0: 6465 3a20 4d65 6e75 2065 6e74 7279 2065 de: Menu entry e │ │ │ │ +00000cf0: 6469 746f 727f 3132 3937 3735 0a4e 6f64 ditor.129775.Nod │ │ │ │ +00000d00: 653a 2045 6e76 6972 6f6e 6d65 6e74 7f31 e: Environment.1 │ │ │ │ +00000d10: 3330 3531 330a 4e6f 6465 3a20 5370 6563 30513.Node: Spec │ │ │ │ +00000d20: 6961 6c20 656e 7669 726f 6e6d 656e 7420 ial environment │ │ │ │ +00000d30: 7661 7269 6162 6c65 737f 3133 3132 3136 variables.131216 │ │ │ │ +00000d40: 0a4e 6f64 653a 2062 696f 736e 756d 7f31 .Node: biosnum.1 │ │ │ │ +00000d50: 3332 3237 300a 4e6f 6465 3a20 6368 6563 32270.Node: chec │ │ │ │ +00000d60: 6b5f 7369 676e 6174 7572 6573 7f31 3332 k_signatures.132 │ │ │ │ +00000d70: 3739 340a 4e6f 6465 3a20 6368 6f73 656e 794.Node: chosen │ │ │ │ +00000d80: 7f31 3333 3038 310a 4e6f 6465 3a20 636d .133081.Node: cm │ │ │ │ +00000d90: 6470 6174 687f 3133 3335 3234 0a4e 6f64 dpath.133524.Nod │ │ │ │ +00000da0: 653a 2063 6f6c 6f72 5f68 6967 686c 6967 e: color_highlig │ │ │ │ +00000db0: 6874 7f31 3333 3935 310a 4e6f 6465 3a20 ht.133951.Node: │ │ │ │ +00000dc0: 636f 6c6f 725f 6e6f 726d 616c 7f31 3334 color_normal.134 │ │ │ │ +00000dd0: 3336 330a 4e6f 6465 3a20 636f 6e66 6967 363.Node: config │ │ │ │ +00000de0: 5f64 6972 6563 746f 7279 7f31 3336 3032 _directory.13602 │ │ │ │ +00000df0: 360a 4e6f 6465 3a20 636f 6e66 6967 5f66 6.Node: config_f │ │ │ │ +00000e00: 696c 657f 3133 3633 3230 0a4e 6f64 653a ile.136320.Node: │ │ │ │ +00000e10: 2064 6562 7567 7f31 3336 3731 330a 4e6f debug.136713.No │ │ │ │ +00000e20: 6465 3a20 6465 6661 756c 747f 3133 3731 de: default.1371 │ │ │ │ +00000e30: 3532 0a4e 6f64 653a 2066 616c 6c62 6163 52.Node: fallbac │ │ │ │ +00000e40: 6b7f 3133 3835 3830 0a4e 6f64 653a 2067 k.138580.Node: g │ │ │ │ +00000e50: 6678 6d6f 6465 7f31 3338 3931 330a 4e6f fxmode.138913.No │ │ │ │ +00000e60: 6465 3a20 6766 7870 6179 6c6f 6164 7f31 de: gfxpayload.1 │ │ │ │ +00000e70: 3339 3731 310a 4e6f 6465 3a20 6766 7874 39711.Node: gfxt │ │ │ │ +00000e80: 6572 6d5f 666f 6e74 7f31 3430 3836 350a erm_font.140865. │ │ │ │ +00000e90: 4e6f 6465 3a20 6772 7562 5f63 7075 7f31 Node: grub_cpu.1 │ │ │ │ +00000ea0: 3431 3136 350a 4e6f 6465 3a20 6772 7562 41165.Node: grub │ │ │ │ +00000eb0: 5f70 6c61 7466 6f72 6d7f 3134 3134 3533 _platform.141453 │ │ │ │ +00000ec0: 0a4e 6f64 653a 2069 636f 6e64 6972 7f31 .Node: icondir.1 │ │ │ │ +00000ed0: 3431 3734 350a 4e6f 6465 3a20 6c61 6e67 41745.Node: lang │ │ │ │ +00000ee0: 7f31 3432 3036 320a 4e6f 6465 3a20 6c6f .142062.Node: lo │ │ │ │ +00000ef0: 6361 6c65 5f64 6972 7f31 3432 3533 310a cale_dir.142531. │ │ │ │ +00000f00: 4e6f 6465 3a20 6d65 6e75 5f63 6f6c 6f72 Node: menu_color │ │ │ │ +00000f10: 5f68 6967 686c 6967 6874 7f31 3433 3034 _highlight.14304 │ │ │ │ +00000f20: 300a 4e6f 6465 3a20 6d65 6e75 5f63 6f6c 0.Node: menu_col │ │ │ │ +00000f30: 6f72 5f6e 6f72 6d61 6c7f 3134 3335 3336 or_normal.143536 │ │ │ │ +00000f40: 0a4e 6f64 653a 206e 6574 5f3c 494e 5445 .Node: net__boot_file │ │ │ │ +00000f60: 7f31 3434 3033 370a 4e6f 6465 3a20 6e65 .144037.Node: ne │ │ │ │ +00000f70: 745f 3c49 4e54 4552 4641 4345 3e5f 6468 t__dh │ │ │ │ +00000f80: 6370 5f73 6572 7665 725f 6e61 6d65 7f31 cp_server_name.1 │ │ │ │ +00000f90: 3434 3238 300a 4e6f 6465 3a20 6e65 745f 44280.Node: net_ │ │ │ │ +00000fa0: 3c49 4e54 4552 4641 4345 3e5f 646f 6d61 _doma │ │ │ │ +00000fb0: 696e 7f31 3434 3534 320a 4e6f 6465 3a20 in.144542.Node: │ │ │ │ +00000fc0: 6e65 745f 3c49 4e54 4552 4641 4345 3e5f net__ │ │ │ │ +00000fd0: 6578 7465 6e73 696f 6e73 7061 7468 7f31 extensionspath.1 │ │ │ │ +00000fe0: 3434 3738 390a 4e6f 6465 3a20 6e65 745f 44789.Node: net_ │ │ │ │ +00000ff0: 3c49 4e54 4552 4641 4345 3e5f 686f 7374 _host │ │ │ │ +00001000: 6e61 6d65 7f31 3435 3034 340a 4e6f 6465 name.145044.Node │ │ │ │ +00001010: 3a20 6e65 745f 3c49 4e54 4552 4641 4345 : net__ip.145283.Node │ │ │ │ +00001030: 3a20 6e65 745f 3c49 4e54 4552 4641 4345 : net__mac.145499.Nod │ │ │ │ +00001050: 653a 206e 6574 5f3c 494e 5445 5246 4143 e: net__next_server.1 │ │ │ │ +00001070: 3435 3732 300a 4e6f 6465 3a20 6e65 745f 45720.Node: net_ │ │ │ │ +00001080: 3c49 4e54 4552 4641 4345 3e5f 726f 6f74 _root │ │ │ │ +00001090: 7061 7468 7f31 3435 3936 330a 4e6f 6465 path.145963.Node │ │ │ │ +000010a0: 3a20 6e65 745f 6465 6661 756c 745f 696e : net_default_in │ │ │ │ +000010b0: 7465 7266 6163 657f 3134 3632 3032 0a4e terface.146202.N │ │ │ │ +000010c0: 6f64 653a 206e 6574 5f64 6566 6175 6c74 ode: net_default │ │ │ │ +000010d0: 5f69 707f 3134 3634 3232 0a4e 6f64 653a _ip.146422.Node: │ │ │ │ +000010e0: 206e 6574 5f64 6566 6175 6c74 5f6d 6163 net_default_mac │ │ │ │ +000010f0: 7f31 3436 3631 390a 4e6f 6465 3a20 6e65 .146619.Node: ne │ │ │ │ +00001100: 745f 6465 6661 756c 745f 7365 7276 6572 t_default_server │ │ │ │ +00001110: 7f31 3436 3831 350a 4e6f 6465 3a20 7061 .146815.Node: pa │ │ │ │ +00001120: 6765 727f 3134 3730 3038 0a4e 6f64 653a ger.147008.Node: │ │ │ │ +00001130: 2070 7265 6669 787f 3134 3732 3634 0a4e prefix.147264.N │ │ │ │ +00001140: 6f64 653a 2070 7865 5f62 6c6b 7369 7a65 ode: pxe_blksize │ │ │ │ +00001150: 7f31 3437 3731 330a 4e6f 6465 3a20 7078 .147713.Node: px │ │ │ │ +00001160: 655f 6465 6661 756c 745f 6761 7465 7761 e_default_gatewa │ │ │ │ +00001170: 797f 3134 3738 3930 0a4e 6f64 653a 2070 y.147890.Node: p │ │ │ │ +00001180: 7865 5f64 6566 6175 6c74 5f73 6572 7665 xe_default_serve │ │ │ │ +00001190: 727f 3134 3830 3935 0a4e 6f64 653a 2072 r.148095.Node: r │ │ │ │ +000011a0: 6f6f 747f 3134 3832 3931 0a4e 6f64 653a oot.148291.Node: │ │ │ │ +000011b0: 2073 7570 6572 7573 6572 737f 3134 3838 superusers.1488 │ │ │ │ +000011c0: 3332 0a4e 6f64 653a 2074 6865 6d65 7f31 32.Node: theme.1 │ │ │ │ +000011d0: 3439 3038 300a 4e6f 6465 3a20 7469 6d65 49080.Node: time │ │ │ │ +000011e0: 6f75 747f 3134 3934 3031 0a4e 6f64 653a out.149401.Node: │ │ │ │ +000011f0: 2074 696d 656f 7574 5f73 7479 6c65 7f31 timeout_style.1 │ │ │ │ +00001200: 3530 3033 380a 4e6f 6465 3a20 456e 7669 50038.Node: Envi │ │ │ │ +00001210: 726f 6e6d 656e 7420 626c 6f63 6b7f 3135 ronment block.15 │ │ │ │ +00001220: 3034 3233 0a4e 6f64 653a 2043 6f6d 6d61 0423.Node: Comma │ │ │ │ +00001230: 6e64 737f 3135 3138 3535 0a4e 6f64 653a nds.151855.Node: │ │ │ │ +00001240: 204d 656e 752d 7370 6563 6966 6963 2063 Menu-specific c │ │ │ │ +00001250: 6f6d 6d61 6e64 737f 3135 3237 3235 0a4e ommands.152725.N │ │ │ │ +00001260: 6f64 653a 206d 656e 7565 6e74 7279 7f31 ode: menuentry.1 │ │ │ │ +00001270: 3533 3435 330a 4e6f 6465 3a20 7375 626d 53453.Node: subm │ │ │ │ +00001280: 656e 757f 3135 3530 3034 0a4e 6f64 653a enu.155004.Node: │ │ │ │ +00001290: 2047 656e 6572 616c 2063 6f6d 6d61 6e64 General command │ │ │ │ +000012a0: 737f 3135 3535 3533 0a4e 6f64 653a 2073 s.155553.Node: s │ │ │ │ +000012b0: 6572 6961 6c7f 3135 3630 3439 0a4e 6f64 erial.156049.Nod │ │ │ │ +000012c0: 653a 2074 6572 6d69 6e61 6c5f 696e 7075 e: terminal_inpu │ │ │ │ +000012d0: 747f 3135 3731 3030 0a4e 6f64 653a 2074 t.157100.Node: t │ │ │ │ +000012e0: 6572 6d69 6e61 6c5f 6f75 7470 7574 7f31 erminal_output.1 │ │ │ │ +000012f0: 3537 3736 360a 4e6f 6465 3a20 7465 726d 57766.Node: term │ │ │ │ +00001300: 696e 666f 7f31 3538 3433 330a 4e6f 6465 info.158433.Node │ │ │ │ +00001310: 3a20 436f 6d6d 616e 642d 6c69 6e65 2061 : Command-line a │ │ │ │ +00001320: 6e64 206d 656e 7520 656e 7472 7920 636f nd menu entry co │ │ │ │ +00001330: 6d6d 616e 6473 7f31 3539 3536 380a 4e6f mmands.159568.No │ │ │ │ +00001340: 6465 3a20 5b7f 3136 3439 3437 0a4e 6f64 de: [.164947.Nod │ │ │ │ +00001350: 653a 2061 6370 697f 3136 3531 3333 0a4e e: acpi.165133.N │ │ │ │ +00001360: 6f64 653a 2061 7574 6865 6e74 6963 6174 ode: authenticat │ │ │ │ +00001370: 657f 3136 3634 3436 0a4e 6f64 653a 2062 e.166446.Node: b │ │ │ │ +00001380: 6163 6b67 726f 756e 645f 636f 6c6f 727f ackground_color. │ │ │ │ +00001390: 3136 3638 3733 0a4e 6f64 653a 2062 6163 166873.Node: bac │ │ │ │ +000013a0: 6b67 726f 756e 645f 696d 6167 657f 3136 kground_image.16 │ │ │ │ +000013b0: 3735 3436 0a4e 6f64 653a 2062 6164 7261 7546.Node: badra │ │ │ │ +000013c0: 6d7f 3136 3830 3936 0a4e 6f64 653a 2062 m.168096.Node: b │ │ │ │ +000013d0: 6c6f 636b 6c69 7374 7f31 3639 3430 340a locklist.169404. │ │ │ │ +000013e0: 4e6f 6465 3a20 626f 6f74 7f31 3639 3633 Node: boot.16963 │ │ │ │ +000013f0: 380a 4e6f 6465 3a20 6361 747f 3136 3939 8.Node: cat.1699 │ │ │ │ +00001400: 3630 0a4e 6f64 653a 2063 6861 696e 6c6f 60.Node: chainlo │ │ │ │ +00001410: 6164 6572 7f31 3730 3539 360a 4e6f 6465 ader.170596.Node │ │ │ │ +00001420: 3a20 636c 6561 727f 3137 3132 3234 0a4e : clear.171224.N │ │ │ │ +00001430: 6f64 653a 2063 6d6f 7363 6c65 616e 7f31 ode: cmosclean.1 │ │ │ │ +00001440: 3731 3431 300a 4e6f 6465 3a20 636d 6f73 71410.Node: cmos │ │ │ │ +00001450: 6475 6d70 7f31 3731 3731 340a 4e6f 6465 dump.171714.Node │ │ │ │ +00001460: 3a20 636d 6f73 7465 7374 7f31 3732 3030 : cmostest.17200 │ │ │ │ +00001470: 390a 4e6f 6465 3a20 636d 707f 3137 3233 9.Node: cmp.1723 │ │ │ │ +00001480: 3637 0a4e 6f64 653a 2063 6f6e 6669 6766 67.Node: configf │ │ │ │ +00001490: 696c 657f 3137 3239 3138 0a4e 6f64 653a ile.172918.Node: │ │ │ │ +000014a0: 2063 7075 6964 7f31 3733 3334 330a 4e6f cpuid.173343.No │ │ │ │ +000014b0: 6465 3a20 6372 637f 3137 3339 3134 0a4e de: crc.173914.N │ │ │ │ +000014c0: 6f64 653a 2063 7279 7074 6f6d 6f75 6e74 ode: cryptomount │ │ │ │ +000014d0: 7f31 3734 3138 380a 4e6f 6465 3a20 6375 .174188.Node: cu │ │ │ │ +000014e0: 746d 656d 7f31 3734 3933 370a 4e6f 6465 tmem.174937.Node │ │ │ │ +000014f0: 3a20 6461 7465 7f31 3735 3737 300a 4e6f : date.175770.No │ │ │ │ +00001500: 6465 3a20 6465 7669 6365 7472 6565 7f31 de: devicetree.1 │ │ │ │ +00001510: 3736 3331 340a 4e6f 6465 3a20 6469 7374 76314.Node: dist │ │ │ │ +00001520: 7275 7374 7f31 3736 3837 310a 4e6f 6465 rust.176871.Node │ │ │ │ +00001530: 3a20 6472 6976 656d 6170 7f31 3737 3635 : drivemap.17765 │ │ │ │ +00001540: 320a 4e6f 6465 3a20 6563 686f 7f31 3738 2.Node: echo.178 │ │ │ │ +00001550: 3435 390a 4e6f 6465 3a20 6576 616c 7f31 459.Node: eval.1 │ │ │ │ +00001560: 3739 3430 320a 4e6f 6465 3a20 6578 706f 79402.Node: expo │ │ │ │ +00001570: 7274 7f31 3739 3638 350a 4e6f 6465 3a20 rt.179685.Node: │ │ │ │ +00001580: 6661 6c73 657f 3137 3939 3936 0a4e 6f64 false.179996.Nod │ │ │ │ +00001590: 653a 2067 6574 7465 7874 7f31 3830 3239 e: gettext.18029 │ │ │ │ +000015a0: 320a 4e6f 6465 3a20 6770 7473 796e 637f 2.Node: gptsync. │ │ │ │ +000015b0: 3138 3037 3339 0a4e 6f64 653a 2068 616c 180739.Node: hal │ │ │ │ +000015c0: 747f 3138 3136 3834 0a4e 6f64 653a 2068 t.181684.Node: h │ │ │ │ +000015d0: 6173 6873 756d 7f31 3832 3031 350a 4e6f ashsum.182015.No │ │ │ │ +000015e0: 6465 3a20 6865 6c70 7f31 3833 3234 310a de: help.183241. │ │ │ │ +000015f0: 4e6f 6465 3a20 696e 6974 7264 7f31 3833 Node: initrd.183 │ │ │ │ +00001600: 3730 380a 4e6f 6465 3a20 696e 6974 7264 708.Node: initrd │ │ │ │ +00001610: 3136 7f31 3834 3132 300a 4e6f 6465 3a20 16.184120.Node: │ │ │ │ +00001620: 696e 736d 6f64 7f31 3834 3632 350a 4e6f insmod.184625.No │ │ │ │ +00001630: 6465 3a20 6b65 7973 7461 7475 737f 3138 de: keystatus.18 │ │ │ │ +00001640: 3438 3437 0a4e 6f64 653a 206c 696e 7578 4847.Node: linux │ │ │ │ +00001650: 7f31 3835 3438 360a 4e6f 6465 3a20 6c69 .185486.Node: li │ │ │ │ +00001660: 6e75 7831 367f 3138 3633 3839 0a4e 6f64 nux16.186389.Nod │ │ │ │ +00001670: 653a 206c 6973 745f 656e 767f 3138 3731 e: list_env.1871 │ │ │ │ +00001680: 3033 0a4e 6f64 653a 206c 6973 745f 7472 03.Node: list_tr │ │ │ │ +00001690: 7573 7465 647f 3138 3734 3639 0a4e 6f64 usted.187469.Nod │ │ │ │ +000016a0: 653a 206c 6f61 645f 656e 767f 3138 3830 e: load_env.1880 │ │ │ │ +000016b0: 3532 0a4e 6f64 653a 206c 6f61 6466 6f6e 52.Node: loadfon │ │ │ │ +000016c0: 747f 3138 3937 3235 0a4e 6f64 653a 206c t.189725.Node: l │ │ │ │ +000016d0: 6f6f 7062 6163 6b7f 3139 3030 3936 0a4e oopback.190096.N │ │ │ │ +000016e0: 6f64 653a 206c 737f 3139 3035 3434 0a4e ode: ls.190544.N │ │ │ │ +000016f0: 6f64 653a 206c 7366 6f6e 7473 7f31 3931 ode: lsfonts.191 │ │ │ │ +00001700: 3038 360a 4e6f 6465 3a20 6c73 6d6f 647f 086.Node: lsmod. │ │ │ │ +00001710: 3139 3132 3638 0a4e 6f64 653a 206d 6435 191268.Node: md5 │ │ │ │ +00001720: 7375 6d7f 3139 3134 3538 0a4e 6f64 653a sum.191458.Node: │ │ │ │ +00001730: 206d 6f64 756c 657f 3139 3137 3337 0a4e module.191737.N │ │ │ │ +00001740: 6f64 653a 206d 756c 7469 626f 6f74 7f31 ode: multiboot.1 │ │ │ │ +00001750: 3932 3034 390a 4e6f 6465 3a20 6e61 7469 92049.Node: nati │ │ │ │ +00001760: 7665 6469 736b 7f31 3933 3135 370a 4e6f vedisk.193157.No │ │ │ │ +00001770: 6465 3a20 6e6f 726d 616c 7f31 3933 3535 de: normal.19355 │ │ │ │ +00001780: 360a 4e6f 6465 3a20 6e6f 726d 616c 5f65 6.Node: normal_e │ │ │ │ +00001790: 7869 747f 3139 3433 3233 0a4e 6f64 653a xit.194323.Node: │ │ │ │ +000017a0: 2070 6172 7474 6f6f 6c7f 3139 3436 3435 parttool.194645 │ │ │ │ +000017b0: 0a4e 6f64 653a 2070 6173 7377 6f72 647f .Node: password. │ │ │ │ +000017c0: 3139 3631 3531 0a4e 6f64 653a 2070 6173 196151.Node: pas │ │ │ │ +000017d0: 7377 6f72 645f 7062 6b64 6632 7f31 3936 sword_pbkdf2.196 │ │ │ │ +000017e0: 3433 330a 4e6f 6465 3a20 706c 6179 7f31 433.Node: play.1 │ │ │ │ +000017f0: 3936 3834 310a 4e6f 6465 3a20 7072 6f62 96841.Node: prob │ │ │ │ +00001800: 657f 3139 3735 3839 0a4e 6f64 653a 2070 e.197589.Node: p │ │ │ │ +00001810: 7865 5f75 6e6c 6f61 647f 3139 3739 3731 xe_unload.197971 │ │ │ │ +00001820: 0a4e 6f64 653a 2072 646d 7372 7f31 3938 .Node: rdmsr.198 │ │ │ │ +00001830: 3235 320a 4e6f 6465 3a20 7265 6164 7f31 252.Node: read.1 │ │ │ │ +00001840: 3939 3034 300a 4e6f 6465 3a20 7265 626f 99040.Node: rebo │ │ │ │ +00001850: 6f74 7f31 3939 3338 340a 4e6f 6465 3a20 ot.199384.Node: │ │ │ │ +00001860: 7265 6765 7870 7f31 3939 3536 370a 4e6f regexp.199567.No │ │ │ │ +00001870: 6465 3a20 726d 6d6f 647f 3230 3031 3034 de: rmmod.200104 │ │ │ │ +00001880: 0a4e 6f64 653a 2073 6176 655f 656e 767f .Node: save_env. │ │ │ │ +00001890: 3230 3032 3937 0a4e 6f64 653a 2073 6561 200297.Node: sea │ │ │ │ +000018a0: 7263 687f 3230 3133 3139 0a4e 6f64 653a rch.201319.Node: │ │ │ │ +000018b0: 2073 656e 646b 6579 7f32 3032 3039 370a sendkey.202097. │ │ │ │ +000018c0: 4e6f 6465 3a20 7365 747f 3230 3835 3233 Node: set.208523 │ │ │ │ +000018d0: 0a4e 6f64 653a 2073 6861 3173 756d 7f32 .Node: sha1sum.2 │ │ │ │ +000018e0: 3038 3832 350a 4e6f 6465 3a20 7368 6132 08825.Node: sha2 │ │ │ │ +000018f0: 3536 7375 6d7f 3230 3931 3130 0a4e 6f64 56sum.209110.Nod │ │ │ │ +00001900: 653a 2073 6861 3531 3273 756d 7f32 3039 e: sha512sum.209 │ │ │ │ +00001910: 3430 390a 4e6f 6465 3a20 736c 6565 707f 409.Node: sleep. │ │ │ │ +00001920: 3230 3937 3036 0a4e 6f64 653a 2073 6f75 209706.Node: sou │ │ │ │ +00001930: 7263 657f 3231 3031 3633 0a4e 6f64 653a rce.210163.Node: │ │ │ │ +00001940: 2074 6573 747f 3231 3037 3135 0a4e 6f64 test.210715.Nod │ │ │ │ +00001950: 653a 2074 7275 657f 3231 3334 3834 0a4e e: true.213484.N │ │ │ │ +00001960: 6f64 653a 2074 7275 7374 7f32 3133 3737 ode: trust.21377 │ │ │ │ +00001970: 300a 4e6f 6465 3a20 756e 7365 747f 3231 0.Node: unset.21 │ │ │ │ +00001980: 3435 3632 0a4e 6f64 653a 2075 7070 6572 4562.Node: upper │ │ │ │ +00001990: 6d65 6d7f 3231 3437 3639 0a4e 6f64 653a mem.214769.Node: │ │ │ │ +000019a0: 2076 6572 6966 795f 6465 7461 6368 6564 verify_detached │ │ │ │ +000019b0: 7f32 3134 3939 340a 4e6f 6465 3a20 7669 .214994.Node: vi │ │ │ │ +000019c0: 6465 6f69 6e66 6f7f 3231 3630 3432 0a4e deoinfo.216042.N │ │ │ │ +000019d0: 6f64 653a 2077 726d 7372 7f32 3136 3332 ode: wrmsr.21632 │ │ │ │ +000019e0: 300a 4e6f 6465 3a20 7865 6e5f 6879 7065 0.Node: xen_hype │ │ │ │ +000019f0: 7276 6973 6f72 7f32 3137 3133 340a 4e6f rvisor.217134.No │ │ │ │ +00001a00: 6465 3a20 7865 6e5f 6d6f 6475 6c65 7f32 de: xen_module.2 │ │ │ │ +00001a10: 3137 3539 350a 4e6f 6465 3a20 4e65 7477 17595.Node: Netw │ │ │ │ +00001a20: 6f72 6b69 6e67 2063 6f6d 6d61 6e64 737f orking commands. │ │ │ │ +00001a30: 3231 3831 3139 0a4e 6f64 653a 206e 6574 218119.Node: net │ │ │ │ +00001a40: 5f61 6464 5f61 6464 727f 3231 3930 3731 _add_addr.219071 │ │ │ │ +00001a50: 0a4e 6f64 653a 206e 6574 5f61 6464 5f64 .Node: net_add_d │ │ │ │ +00001a60: 6e73 7f32 3139 3539 310a 4e6f 6465 3a20 ns.219591.Node: │ │ │ │ +00001a70: 6e65 745f 6164 645f 726f 7574 657f 3231 net_add_route.21 │ │ │ │ +00001a80: 3938 3637 0a4e 6f64 653a 206e 6574 5f62 9867.Node: net_b │ │ │ │ +00001a90: 6f6f 7470 7f32 3230 3339 370a 4e6f 6465 ootp.220397.Node │ │ │ │ +00001aa0: 3a20 6e65 745f 6465 6c5f 6164 6472 7f32 : net_del_addr.2 │ │ │ │ +00001ab0: 3231 3938 360a 4e6f 6465 3a20 6e65 745f 21986.Node: net_ │ │ │ │ +00001ac0: 6465 6c5f 646e 737f 3232 3232 3236 0a4e del_dns.222226.N │ │ │ │ +00001ad0: 6f64 653a 206e 6574 5f64 656c 5f72 6f75 ode: net_del_rou │ │ │ │ +00001ae0: 7465 7f32 3232 3437 330a 4e6f 6465 3a20 te.222473.Node: │ │ │ │ +00001af0: 6e65 745f 6765 745f 6468 6370 5f6f 7074 net_get_dhcp_opt │ │ │ │ +00001b00: 696f 6e7f 3232 3237 3138 0a4e 6f64 653a ion.222718.Node: │ │ │ │ +00001b10: 206e 6574 5f69 7076 365f 6175 746f 636f net_ipv6_autoco │ │ │ │ +00001b20: 6e66 7f32 3233 3230 340a 4e6f 6465 3a20 nf.223204.Node: │ │ │ │ +00001b30: 6e65 745f 6c73 5f61 6464 727f 3232 3336 net_ls_addr.2236 │ │ │ │ +00001b40: 3233 0a4e 6f64 653a 206e 6574 5f6c 735f 23.Node: net_ls_ │ │ │ │ +00001b50: 6361 7264 737f 3232 3338 3731 0a4e 6f64 cards.223871.Nod │ │ │ │ +00001b60: 653a 206e 6574 5f6c 735f 646e 737f 3232 e: net_ls_dns.22 │ │ │ │ +00001b70: 3431 3037 0a4e 6f64 653a 206e 6574 5f6c 4107.Node: net_l │ │ │ │ +00001b80: 735f 726f 7574 6573 7f32 3234 3333 380a s_routes.224338. │ │ │ │ +00001b90: 4e6f 6465 3a20 6e65 745f 6e73 6c6f 6f6b Node: net_nslook │ │ │ │ +00001ba0: 7570 7f32 3234 3534 350a 4e6f 6465 3a20 up.224545.Node: │ │ │ │ +00001bb0: 496e 7465 726e 6174 696f 6e61 6c69 7361 Internationalisa │ │ │ │ +00001bc0: 7469 6f6e 7f32 3234 3832 390a 4e6f 6465 tion.224829.Node │ │ │ │ +00001bd0: 3a20 5365 6375 7269 7479 7f32 3331 3636 : Security.23166 │ │ │ │ +00001be0: 310a 4e6f 6465 3a20 4175 7468 656e 7469 1.Node: Authenti │ │ │ │ +00001bf0: 6361 7469 6f6e 2061 6e64 2061 7574 686f cation and autho │ │ │ │ +00001c00: 7269 7361 7469 6f6e 7f32 3332 3233 370a risation.232237. │ │ │ │ +00001c10: 4e6f 6465 3a20 5573 696e 6720 6469 6769 Node: Using digi │ │ │ │ +00001c20: 7461 6c20 7369 676e 6174 7572 6573 7f32 tal signatures.2 │ │ │ │ +00001c30: 3335 3232 310a 4e6f 6465 3a20 5545 4649 35221.Node: UEFI │ │ │ │ +00001c40: 2073 6563 7572 6520 626f 6f74 2061 6e64 secure boot and │ │ │ │ +00001c50: 2073 6869 6d7f 3233 3833 3335 0a4e 6f64 shim.238335.Nod │ │ │ │ +00001c60: 653a 2053 6563 7572 6520 426f 6f74 2041 e: Secure Boot A │ │ │ │ +00001c70: 6476 616e 6365 6420 5461 7267 6574 696e dvanced Targetin │ │ │ │ +00001c80: 677f 3233 3931 3932 0a4e 6f64 653a 204d g.239192.Node: M │ │ │ │ +00001c90: 6561 7375 7265 6420 426f 6f74 7f32 3430 easured Boot.240 │ │ │ │ +00001ca0: 3232 330a 4e6f 6465 3a20 4c6f 636b 646f 223.Node: Lockdo │ │ │ │ +00001cb0: 776e 7f32 3432 3138 380a 4e6f 6465 3a20 wn.242188.Node: │ │ │ │ +00001cc0: 506c 6174 666f 726d 206c 696d 6974 6174 Platform limitat │ │ │ │ +00001cd0: 696f 6e73 7f32 3432 3638 310a 4e6f 6465 ions.242681.Node │ │ │ │ +00001ce0: 3a20 506c 6174 666f 726d 2d73 7065 6369 : Platform-speci │ │ │ │ +00001cf0: 6669 6320 6f70 6572 6174 696f 6e73 7f32 fic operations.2 │ │ │ │ +00001d00: 3530 3237 310a 4e6f 6465 3a20 5375 7070 50271.Node: Supp │ │ │ │ +00001d10: 6f72 7465 6420 6b65 726e 656c 737f 3235 orted kernels.25 │ │ │ │ +00001d20: 3133 3336 0a4e 6f64 653a 2054 726f 7562 1336.Node: Troub │ │ │ │ +00001d30: 6c65 7368 6f6f 7469 6e67 7f32 3538 3937 leshooting.25897 │ │ │ │ +00001d40: 330a 4e6f 6465 3a20 4752 5542 206f 6e6c 3.Node: GRUB onl │ │ │ │ +00001d50: 7920 6f66 6665 7273 2061 2072 6573 6375 y offers a rescu │ │ │ │ +00001d60: 6520 7368 656c 6c7f 3235 3932 3433 0a4e e shell.259243.N │ │ │ │ +00001d70: 6f64 653a 2046 6972 6d77 6172 6520 7374 ode: Firmware st │ │ │ │ +00001d80: 616c 6c73 2069 6e73 7465 6164 206f 6620 alls instead of │ │ │ │ +00001d90: 626f 6f74 696e 6720 4752 5542 7f32 3632 booting GRUB.262 │ │ │ │ +00001da0: 3235 320a 4e6f 6465 3a20 496e 766f 6b69 252.Node: Invoki │ │ │ │ +00001db0: 6e67 2067 7275 622d 696e 7374 616c 6c7f ng grub-install. │ │ │ │ +00001dc0: 3236 3238 3833 0a4e 6f64 653a 2049 6e76 262883.Node: Inv │ │ │ │ +00001dd0: 6f6b 696e 6720 6772 7562 2d6d 6b63 6f6e oking grub-mkcon │ │ │ │ +00001de0: 6669 677f 3236 3530 3533 0a4e 6f64 653a fig.265053.Node: │ │ │ │ +00001df0: 2049 6e76 6f6b 696e 6720 6772 7562 2d6d Invoking grub-m │ │ │ │ +00001e00: 6b70 6173 7377 642d 7062 6b64 6632 7f32 kpasswd-pbkdf2.2 │ │ │ │ +00001e10: 3635 3639 300a 4e6f 6465 3a20 496e 766f 65690.Node: Invo │ │ │ │ +00001e20: 6b69 6e67 2067 7275 622d 6d6b 7265 6c70 king grub-mkrelp │ │ │ │ +00001e30: 6174 687f 3236 3633 3439 0a4e 6f64 653a ath.266349.Node: │ │ │ │ +00001e40: 2049 6e76 6f6b 696e 6720 6772 7562 2d6d Invoking grub-m │ │ │ │ +00001e50: 6b72 6573 6375 657f 3236 3731 3232 0a4e krescue.267122.N │ │ │ │ +00001e60: 6f64 653a 2049 6e76 6f6b 696e 6720 6772 ode: Invoking gr │ │ │ │ +00001e70: 7562 2d6d 6f75 6e74 7f32 3638 3837 310a ub-mount.268871. │ │ │ │ +00001e80: 4e6f 6465 3a20 496e 766f 6b69 6e67 2067 Node: Invoking g │ │ │ │ +00001e90: 7275 622d 7072 6f62 657f 3237 3139 3230 rub-probe.271920 │ │ │ │ +00001ea0: 0a4e 6f64 653a 2049 6e76 6f6b 696e 6720 .Node: Invoking │ │ │ │ +00001eb0: 6772 7562 2d73 6372 6970 742d 6368 6563 grub-script-chec │ │ │ │ +00001ec0: 6b7f 3237 3435 3134 0a4e 6f64 653a 204f k.274514.Node: O │ │ │ │ +00001ed0: 6274 6169 6e69 6e67 2061 6e64 2042 7569 btaining and Bui │ │ │ │ +00001ee0: 6c64 696e 6720 4752 5542 7f32 3735 3235 lding GRUB.27525 │ │ │ │ +00001ef0: 380a 4e6f 6465 3a20 5265 706f 7274 696e 8.Node: Reportin │ │ │ │ +00001f00: 6720 6275 6773 7f32 3736 3530 310a 4e6f g bugs.276501.No │ │ │ │ +00001f10: 6465 3a20 4675 7475 7265 7f32 3739 3331 de: Future.27931 │ │ │ │ +00001f20: 370a 4e6f 6465 3a20 436f 7079 696e 6720 7.Node: Copying │ │ │ │ +00001f30: 5468 6973 204d 616e 7561 6c7f 3237 3937 This Manual.2797 │ │ │ │ +00001f40: 3137 0a4e 6f64 653a 2047 4e55 2046 7265 17.Node: GNU Fre │ │ │ │ +00001f50: 6520 446f 6375 6d65 6e74 6174 696f 6e20 e Documentation │ │ │ │ +00001f60: 4c69 6365 6e73 657f 3237 3939 3435 0a4e License.279945.N │ │ │ │ +00001f70: 6f64 653a 2049 6e64 6578 7f33 3033 3438 ode: Index.30348 │ │ │ │ +00001f80: 390a 1f0a 456e 6420 5461 6720 5461 626c 9...End Tag Tabl │ │ │ │ +00001f90: 650a 0a1f 0a4c 6f63 616c 2056 6172 6961 e....Local Varia │ │ │ │ +00001fa0: 626c 6573 3a0a 636f 6469 6e67 3a20 7574 bles:.coding: ut │ │ │ │ +00001fb0: 662d 380a 456e 643a 0a f-8.End:.